fh agents and fh describe

fh agents

fabric-harness agents [--json]

List every finite job under .fabricharness/jobs/ and persistent agent under .fabricharness/agents/. The default output is human-readable; --json includes each definition's kind (job or agent), source path, model, target, description, and triggers.

fh agents
fh agents --json

fh describe

fabric-harness describe AGENT_NAME [--json]

Show metadata for a single definition. Finite jobs expose their declared model, target default, triggers, examples, and input/output schemas. Persistent agents expose their route name and kind: "agent" without running the per-instance initializer.

fh describe ask
fh describe ask --json

For finite agents declared with defineAgent({...}), describe shows:

• name and description,
• input schema, rendered as JSON Schema,
• output schema,
• declared model,
• triggers (webhook, etc.),
• run target default,
• examples (if examples: [...] was provided).

Plain default-exported functions are rejected. Finite definitions use defineAgent({...}); persistent definitions use createAgent(...).

Why this exists

describe is the contract for tooling. CI, dev servers, deploy pipelines, and operator tools can use --json to discover a definition without parsing TypeScript.