Skip to content
Registry

iii-directory

v0.4.1

Engine introspection, workers registry proxy, filesystem-backed skills, system prompts, and agent profiles, kit install and update with reviewed plans, plus function search ranked by the judge worker (falling back to local hybrid/lexical) with a conditional pre-generate hint.

Used in 1 kitagentsdirectoryfunctionsintrospectkitsregistrysearchskills

Install

bash
iii trigger compose::add worker=iii-directory@0.4.1

Run in your project with the iii engine running. Exact versions are immutable and digest-pinned.

Functions16

directory::registered-trigger-list

Function

List registered trigger instances (the link rows between trigger types and target functions). Filter by trigger_type, function_id, worker, or free-text search.

Request
  • function_idstring
  • searchstring
  • trigger_typestring
  • workerstring
Response
  • registered_triggersobject[]required
    • config_summarystringrequired

      Truncated (~80 chars) JSON preview of `config` so listings stay scannable. Use `directory::registered-trigger-info` for the full payload.

    • function_idstringrequired
    • idstringrequired
    • trigger_typestringrequired
    • worker_namestring

skills::download

Function

Download skills + prompts into skills_folder. Pass {repo, skill} to clone a single skill folder from a GitHub repo (git clone --depth 1), or {worker, version|tag} to pull from the workers registry. Files in the destination namespace are overwritten file-by-file.

Request
  • repostring

    Source A: GitHub repo URL. Pair with `skill`.

  • skillstring

    Source A: subfolder under `skills/` inside the repo. Doubles as the destination namespace inside `skills_folder`.

  • tagstring

    Source B: registry tag to pull (e.g. `latest`). Mutually exclusive with `version`.

  • versionstring

    Source B: explicit semver to pull. Mutually exclusive with `tag`.

  • workerstring

    Source B: workers registry name. Pair with exactly one of `version` / `tag`.

Response
  • namespacestringrequired
  • prompts_writtenstring[]required
  • skills_writtenstring[]required
  • sourceunknownrequired

skill::fetch

Function

Fetches the content of one or more skill resources identified by iii:// URIs. When you encounter iii:// links in skill instructions, use this tool to retrieve their contents (batch with `uris` when helpful).

Request
  • uristring

    A single iii:// URI to read. Must start with "iii://".

  • urisstring[]

    One or more iii:// URIs to read in order. When both `uri` and `uris` are provided, `uris` wins (matches the TS reference implementation).

Response
valuestring

skills::fetch_skill

Function

Fetches the content of one or more skill resources identified by iii:// URIs. When you encounter iii:// links in skill instructions, use this tool to retrieve their contents (batch with `uris` when helpful).

Request
  • uristring

    A single iii:// URI to read. Must start with "iii://".

  • urisstring[]

    One or more iii:// URIs to read in order. When both `uri` and `uris` are provided, `uris` wins (matches the TS reference implementation).

Response
valuestring

directory::worker-info

Function

Worker envelope plus the lists of functions, trigger types, and registered triggers it owns. The `worker` field has the same shape as registry::worker-info so callers can switch between local + registry surfaces with the same parser.

Request
  • namestringrequired
Response
  • functionsobject[]required
    • descriptionstring
    • function_idstringrequired
    • namestringrequired
  • registered_triggersobject[]required
    • function_idstringrequired
    • idstringrequired
    • trigger_typestringrequired
  • trigger_typesobject[]required
    • descriptionstringrequired
    • idstringrequired
    • namestringrequired
  • workerall ofrequired

    Same shape as `worker-list` rows (and `registry::worker-info.worker`).

    all of (1)
    Variant 1
    • active_invocationsinteger· uintrequiredmin 0
    • connected_at_msinteger· uint64requiredmin 0
    • descriptionstring

      Engine-side workers carry no description; field present for shape parity with `registry::Worker.description`. Always `None`.

    • function_countinteger· uintrequiredmin 0
    • idstringrequired

      Engine-assigned connection id (directory-specific).

    • ip_addressstring
    • isolationstring
    • namestring

      Worker name as registered with the engine.

    • osstring
    • runtimestring
    • statusstringrequired

      Connection state (e.g. `"connected"`, `"disconnected"`).

    • versionstring

      Worker version string from the worker's published manifest.

prompts::get

Function

Fetch one filesystem-backed prompt by name. Returns the raw markdown body plus name, description, and modified_at — no envelope, no templating.

Request
  • namestringrequired
Response
  • bodystringrequired

    Raw markdown body (post-frontmatter) from disk.

  • descriptionstringrequired
  • modified_atstringrequired

    File mtime as RFC 3339.

  • namestringrequired

directory::function-info

Function

Full detail for one function: schemas, owning worker, registered triggers that target it, and any matching how-to skill from skills_folder.

Request
  • function_idstringrequired
Response
  • descriptionstring
  • function_idstringrequired
  • how_guideany of
    any of (2)
    Variant 1
    • abs_pathstringrequired
    • bodystringrequired
    • frontmatterobjectrequired

      Subset of frontmatter fields the scanner cares about. Anything else in the YAML block is preserved verbatim by `split_frontmatter` but ignored here.

      Show 4 nested
      • function_idstring

        Optional single function id (alternative to `functions`).

      • functionsstring[]

        Optional list of function ids this how-to covers.

      • titlestring

        Optional human-readable title (mirrors what an `# H1` would give).

      • typestring

        Required marker — only `type: how-to` files are considered.

    • skill_idstringrequired
    Variant 2
    valuenull
  • metadataunknown
  • namestringrequired
  • registered_triggersobject[]required
    • configunknownrequired
    • idstringrequired
    • trigger_typestringrequired
  • request_schemaunknown
  • response_schemaunknown
  • worker_namestring

registry::worker-info

Function

Fetch full registry metadata for one worker: worker envelope (same shape as registry::worker-list rows and directory::worker-info), readme, full API reference (functions + triggers schemas), and tree of skill/prompt file paths. Pass either `version` or `tag` (defaults to tag="latest"). Results are cached for `registry_cache_ttl_ms`.

Request
  • namestringrequired

    Worker name in the registry (e.g. `"resend"`).

  • tagstring
  • versionstring

    Mutually exclusive with `tag`. If neither is provided we fall back to `tag: "latest"`.

Response
  • api_referenceobjectrequired
    • functionsobject[]
      • descriptionstring
      • metadataunknown
      • namestringrequired
      • request_schemaunknown
      • response_schemaunknown
    • triggersobject[]
      • descriptionstring
      • invocation_schemaunknown
      • metadataunknown
      • namestringrequired
      • return_schemaunknown
  • readmestring
  • skills_treeobjectrequired
    • promptsobject[]
      • descriptionstring
      • namestringrequired
    • skillsobject[]
      • pathstringrequired
  • workerall ofrequired

    Same shape as `worker-list` rows (and `directory::worker-info.worker`).

    all of (1)
    Variant 1
    • authorany of
      Show 2 nested
      any of (2)
      Variant 1
      • is_verifiedboolean
      • namestring
      • profile_picturestring
      Variant 2
      valuenull
    • descriptionstring
    • namestringrequired
    • repostring
    • versionstring

      Latest published version (worker-list) or the resolved version (worker-info, when called with `version` / `tag`).

directory::function-list

Function

List every function registered with the engine. Filter by free-text search, namespace prefix, and/or worker name.

Request
  • prefixstring

    Exact prefix match on `function_id` (e.g. `"mem::"`).

  • searchstring

    Case-insensitive substring match against `function_id` and `description`.

  • workerstring

    Exact worker-name match (the worker that registered the function).

Response
  • functionsobject[]required
    • descriptionstring
    • function_idstringrequired
    • namestringrequired

      Last `::` segment of `function_id`.

    • worker_namestring

      Worker that registered it (resolved via `WorkerInfo.functions[]`), or the first `::` segment of `function_id` as fallback.

directory::worker-list

Function

List every worker currently connected to the engine. Filter by name substring, runtime, or status. Same row shape as registry::worker-list so callers learn one envelope.

Request
  • runtimestring

    Exact runtime match (e.g. `"rust"`, `"node"`).

  • searchstring

    Case-insensitive substring match against `name`.

  • statusstring

    Exact status match (e.g. `"connected"`).

Response
  • workersobject[]required
    • active_invocationsinteger· uintrequiredmin 0
    • connected_at_msinteger· uint64requiredmin 0
    • descriptionstring

      Engine-side workers carry no description; field present for shape parity with `registry::Worker.description`. Always `None`.

    • function_countinteger· uintrequiredmin 0
    • idstringrequired

      Engine-assigned connection id (directory-specific).

    • ip_addressstring
    • isolationstring
    • namestring

      Worker name as registered with the engine.

    • osstring
    • runtimestring
    • statusstringrequired

      Connection state (e.g. `"connected"`, `"disconnected"`).

    • versionstring

      Worker version string from the worker's published manifest.

directory::trigger-info

Function

Full detail for one trigger type: configuration schema, return schema, owning worker, and current instance count.

Request
  • idstringrequired
Response
  • configuration_schemaunknown

    SDK 0.11.3 surfaces a single `trigger_request_format` that doubles as the per-instance configuration shape; expose it explicitly so callers don't have to know the alias.

  • descriptionstringrequired
  • idstringrequired
  • instance_countinteger· uintrequiredmin 0
  • namestringrequired
  • return_schemaunknown
  • worker_namestring

prompts::list

Function

List filesystem-backed prompts (name, description, modified_at) from skills_folder.

Request
Empty object
Response
  • promptsobject[]required
    • descriptionstringrequired
    • modified_atstringrequired

      File mtime as RFC 3339.

    • namestringrequired

directory::registered-trigger-info

Function

Full denormalized detail for one registered trigger: instance config + trigger-type detail + function detail.

Request
  • idstringrequired
Response
  • configunknownrequired
  • functionany of

    Full function detail for `function_id`. `None` if the function has been unregistered between calls.

    any of (2)
    Variant 1
    • descriptionstring
    • function_idstringrequired
    • how_guideany of
      Show 2 nested
      any of (2)
      Variant 1
      • abs_pathstringrequired
      • bodystringrequired
      • frontmatterobjectrequired

        Subset of frontmatter fields the scanner cares about. Anything else in the YAML block is preserved verbatim by `split_frontmatter` but ignored here.

        Show 4 nested
        • function_idstring

          Optional single function id (alternative to `functions`).

        • functionsstring[]

          Optional list of function ids this how-to covers.

        • titlestring

          Optional human-readable title (mirrors what an `# H1` would give).

        • typestring

          Required marker — only `type: how-to` files are considered.

      • skill_idstringrequired
      Variant 2
      valuenull
    • metadataunknown
    • namestringrequired
    • registered_triggersobject[]required
      Show 3 nested
      • configunknownrequired
      • idstringrequired
      • trigger_typestringrequired
    • request_schemaunknown
    • response_schemaunknown
    • worker_namestring
    Variant 2
    valuenull
  • function_idstringrequired
  • idstringrequired
  • metadataunknown
  • triggerany of

    Full trigger-type detail for `trigger_type`. `None` if the type has been unregistered between calls.

    any of (2)
    Variant 1
    • configuration_schemaunknown

      SDK 0.11.3 surfaces a single `trigger_request_format` that doubles as the per-instance configuration shape; expose it explicitly so callers don't have to know the alias.

    • descriptionstringrequired
    • idstringrequired
    • instance_countinteger· uintrequiredmin 0
    • namestringrequired
    • return_schemaunknown
    • worker_namestring
    Variant 2
    valuenull
  • trigger_typestringrequired
  • worker_namestring

skills::list

Function

List filesystem-backed skills (id, body length, modified_at) from skills_folder.

Request
Empty object
Response
  • skillsobject[]required
    • bytesinteger· uintrequiredmin 0
    • idstringrequired
    • modified_atstringrequired

      File mtime as RFC 3339 (best effort; empty if unavailable).

directory::trigger-list

Function

List every trigger TYPE registered with the engine. Filter by search, prefix, worker. (For registered trigger instances, use directory::registered-trigger-list.)

Request
  • prefixstring
  • searchstring
  • workerstring
Response
  • triggersobject[]required
    • descriptionstringrequired
    • idstringrequired
    • namestringrequired
    • worker_namestring

registry::worker-list

Function

List workers from the public registry (api.workers.iii.dev) matching the free-text term `search`. Same row shape as directory::worker-list so callers learn one envelope. Results are cached for `registry_cache_ttl_ms` (default 60s).

Request
  • limitinteger· uint32min 0

    Max results to return. Defaults to 20; capped at 100.

  • searchstring

    Free-text query forwarded to the registry as `?q=…`. Required — the public registry doesn't support an unscoped browse endpoint.

Response
  • workersobject[]required
    • authorany of
      any of (2)
      Variant 1
      • is_verifiedboolean
      • namestring
      • profile_picturestring
      Variant 2
      valuenull
    • descriptionstring
    • namestringrequired
    • repostring
    • versionstring

      Latest published version (worker-list) or the resolved version (worker-info, when called with `version` / `tag`).

Triggers2

prompts::on-change

Trigger

Fires after every successful skills::download that wrote at least one prompt markdown file.

Invocation
valueunknown
Return
valueunknown

skills::on-change

Trigger

Fires after every successful skills::download that wrote at least one skill markdown file.

Invocation
valueunknown
Return
valueunknown

Search the registry

Find workers, kits and executables, or jump to a page.