directory::skills::get
functionFetch one filesystem-backed skill by id. Returns the raw markdown body plus id, title, description, and modified_at — same flat shape as directory::prompts::get. Accepts a bare id (e.g. "directory/skills/list") or the same id prefixed with iii://.
idstring*required
Skill id (the same string returned by `directory::skills::list`, e.g. `"directory/skills/list"`). The legacy `iii://{id}` form is also accepted for ergonomics; the prefix is stripped before validation. Other URI schemes are rejected.
bodystring*required
Raw markdown body (post-frontmatter) from disk.
descriptionstring*required
modified_atstring*required
File mtime as RFC 3339.
List registered trigger instances (the link rows between trigger types and target functions). Filter by trigger_type, function_id, worker, or free-text search.
registered_triggersobject[]*required
config_summarystring*required
Truncated (~80 chars) JSON preview of `config` so listings stay scannable. Use `directory::registered-trigger-info` for the full payload.
function_idstring*required
trigger_typestring*required
List every worker currently connected to the engine. Filter by name substring, runtime, or status. Same row shape as directory::registry::workers::list so callers learn one envelope.
runtimestring
Exact runtime match (e.g. `"rust"`, `"node"`).
searchstring
Case-insensitive substring match against `name`.
statusstring
Exact status match (e.g. `"connected"`).
workersobject[]*required
active_invocationsinteger· uint*requiredmin 0
connected_at_msinteger· uint64*requiredmin 0
descriptionstring
Engine-side workers carry no description; field present for shape parity with `registry::Worker.description`. Always `None`.
function_countinteger· uint*requiredmin 0
idstring*required
Engine-assigned connection id (directory-specific).
namestring
Worker name as registered with the engine.
statusstring*required
Connection state (e.g. `"connected"`, `"disconnected"`).
versionstring
Worker version string from the worker's published manifest.
List every trigger TYPE registered with the engine. Filter by search, prefix, worker. (For registered trigger instances, use directory::engine::registered-triggers::list.)
triggersobject[]*required
descriptionstring*required
directory::skills::list
functionList filesystem-backed skills (id, title, description, bytes, modified_at) from skills_folder. Each row carries the H1 title and first-paragraph description so consumers can render a picker or indented index without one get per row.
skillsobject[]*required
bytesinteger· uint*requiredmin 0
descriptionstring*required
First paragraph of the body, empty when the file has only headings.
modified_atstring*required
File mtime as RFC 3339 (best effort; empty if unavailable).
titlestring*required
First `# H1` line in the body, falling back to `id` when absent.
List workers from the public registry (api.workers.iii.dev) matching the free-text term `search`. Same row shape as directory::engine::workers::list so callers learn one envelope. Results are cached for `registry_cache_ttl_ms` (default 60s).
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.
workersobject[]*required
versionstring
Latest published version (worker-list) or the resolved version (worker-info, when called with `version` / `tag`).
directory::prompts::get
functionFetch one filesystem-backed prompt by name. Returns the raw markdown body plus name, description, and modified_at — no envelope, no templating.
bodystring*required
Raw markdown body (post-frontmatter) from disk.
descriptionstring*required
modified_atstring*required
File mtime as RFC 3339.
Full detail for one trigger type: configuration schema, return schema, owning worker, and current instance count.
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.
descriptionstring*required
instance_countinteger· uint*requiredmin 0
Download skills + prompts into skills_folder. Pass {repo, skill, branch?} to clone a single skill folder from a GitHub repo (git clone --depth 1 --branch <branch>; branch defaults to "main"), or {worker, version?|tag?} to pull from the workers registry (defaults to tag="latest" when neither version nor tag is given). Files in the destination namespace are overwritten file-by-file.
branchstring
Source A: branch to clone. Defaults to `"main"`. Pass `"master"` (or any other branch name) for repos whose default branch is not `main`.
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`. Defaults to `"latest"` when neither `version` nor `tag` is provided.
versionstring
Source B: explicit semver to pull. Mutually exclusive with `tag`.
workerstring
Source B: workers registry name. Pair with exactly one of `version` / `tag`.
prompts_writtenstring[]*required
skills_writtenstring[]*required
List every function registered with the engine. Filter by free-text search, namespace prefix, and/or worker name.
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).
functionsobject[]*required
function_idstring*required
worker_namestring
Worker that registered it (resolved via `WorkerInfo.functions[]`), or the first `::` segment of `function_id` as fallback.
directory::prompts::list
functionList filesystem-backed prompts (name, description, modified_at) from skills_folder.
promptsobject[]*required
descriptionstring*required
modified_atstring*required
File mtime as RFC 3339.
Full detail for one function: schemas, owning worker, registered triggers that target it, and any matching how-to skill from skills_folder.
function_idstring*required
function_idstring*required
registered_triggersobject[]*required
trigger_typestring*required
related_skillsobject[]*required
Other skills (any `type`) that mention this function via either the literal `function_id` or the `iii://fn/<dotted/path>` URI. Body content is omitted; fetch on demand via `directory::skills::get`.
Worker envelope plus the lists of functions, trigger types, and registered triggers it owns. The `worker` field has the same shape as directory::registry::workers::info so callers can switch between local + registry surfaces with the same parser.
functionsobject[]*required
function_idstring*required
registered_triggersobject[]*required
function_idstring*required
trigger_typestring*required
trigger_typesobject[]*required
descriptionstring*required
workerall of*required
Same shape as `worker-list` rows (and `registry::worker-info.worker`).
all of (1)
variant 1
active_invocationsinteger· uint*requiredmin 0
connected_at_msinteger· uint64*requiredmin 0
descriptionstring
Engine-side workers carry no description; field present for shape parity with `registry::Worker.description`. Always `None`.
function_countinteger· uint*requiredmin 0
idstring*required
Engine-assigned connection id (directory-specific).
namestring
Worker name as registered with the engine.
statusstring*required
Connection state (e.g. `"connected"`, `"disconnected"`).
versionstring
Worker version string from the worker's published manifest.
Full denormalized detail for one registered trigger: instance config + trigger-type detail + function detail.
functionany of
Full function detail for `function_id`. `None` if the function has been unregistered between calls.
any of (2)
variant 1
function_idstring*required
how_guideany of
… expand 2 nestedcollapse
registered_triggersobject[]*required
… expand 3 nestedcollapse
trigger_typestring*required
related_skillsobject[]*required
Other skills (any `type`) that mention this function via either the literal `function_id` or the `iii://fn/<dotted/path>` URI. Body content is omitted; fetch on demand via `directory::skills::get`.
… expand 2 nestedcollapse
function_idstring*required
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.
descriptionstring*required
instance_countinteger· uint*requiredmin 0
trigger_typestring*required
Fetch full registry metadata for one worker: worker envelope (same shape as directory::registry::workers::list rows and directory::engine::workers::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`.
namestring*required
Worker name in the registry (e.g. `"resend"`).
versionstring
Mutually exclusive with `tag`. If neither is provided we fall back to `tag: "latest"`.
api_referenceobject*required
skills_treeobject*required
workerall of*required
Same shape as `directory::registry::workers::list` rows (and `directory::engine::workers::info.worker`).
all of (1)
variant 1
authorany of
… expand 2 nestedcollapse
versionstring
Latest published version (worker-list) or the resolved version (worker-info, when called with `version` / `tag`).
