AgentCatalogEntry

Fields

23 fields

agent_id · required

string

concurrency_class · required

string

default_tier · required

string

dependencies · required

array of string

escalation · required

array of string

execution · required

string

expected_cost_usd · required

number

expected_latency_ms · required

integer

fallback · required

string

inline_input_supported

boolean

Accepts inline_input on POST /api/v1/agents/{agent_id}/invoke (a pasted input anchored to a stored test run of the project); the detail publishes its schema as inline_input_json_schema.

input_schema · required

string

input_schema_resolved · required

boolean

False when the input schema is a label with no model yet; the wrapper then accepts only a SubjectRef.

invokable · required

boolean

Can be invoked independently; false means the capability requires a surrounding workflow.

max_retries · required

integer

output_schema · required

string

output_schema_resolved · required

boolean

permission · required

string

produces_report · required

boolean

Its output is a report contract, so a run of it needs human review (E8).

required_evidence · required

array of string

stage_name · required

string

sync_eligible · required

boolean

May be invoked synchronously: deterministic and expected to finish in 5 s or less.

timeout_seconds · required

integer

version · required

integer

Raw schema (JSON)

{
  "properties": {
    "agent_id": {
      "title": "Agent Id",
      "type": "string"
    },
    "concurrency_class": {
      "title": "Concurrency Class",
      "type": "string"
    },
    "default_tier": {
      "enum": [
        "deterministic",
        "slm",
        "llm"
      ],
      "title": "Default Tier",
      "type": "string"
    },
    "dependencies": {
      "items": {
        "type": "string"
      },
      "title": "Dependencies",
      "type": "array"
    },
    "escalation": {
      "items": {
        "enum": [
          "validation_failure",
          "low_confidence",
          "not_enough_evidence",
          "contradictions",
          "multi_artifact_evidence"
        ],
        "type": "string"
      },
      "title": "Escalation",
      "type": "array"
    },
    "execution": {
      "title": "Execution",
      "type": "string"
    },
    "expected_cost_usd": {
      "title": "Expected Cost Usd",
      "type": "number"
    },
    "expected_latency_ms": {
      "title": "Expected Latency Ms",
      "type": "integer"
    },
    "fallback": {
      "title": "Fallback",
      "type": "string"
    },
    "inline_input_supported": {
      "default": false,
      "description": "Accepts inline_input on POST /api/v1/agents/{agent_id}/invoke (a pasted input anchored to a stored test run of the project); the detail publishes its schema as inline_input_json_schema.",
      "title": "Inline Input Supported",
      "type": "boolean"
    },
    "input_schema": {
      "title": "Input Schema",
      "type": "string"
    },
    "input_schema_resolved": {
      "description": "False when the input schema is a label with no model yet; the wrapper then accepts only a SubjectRef.",
      "title": "Input Schema Resolved",
      "type": "boolean"
    },
    "invokable": {
      "description": "Can be invoked independently; false means the capability requires a surrounding workflow.",
      "title": "Invokable",
      "type": "boolean"
    },
    "max_retries": {
      "title": "Max Retries",
      "type": "integer"
    },
    "output_schema": {
      "title": "Output Schema",
      "type": "string"
    },
    "output_schema_resolved": {
      "title": "Output Schema Resolved",
      "type": "boolean"
    },
    "permission": {
      "title": "Permission",
      "type": "string"
    },
    "produces_report": {
      "description": "Its output is a report contract, so a run of it needs human review (E8).",
      "title": "Produces Report",
      "type": "boolean"
    },
    "required_evidence": {
      "items": {
        "type": "string"
      },
      "title": "Required Evidence",
      "type": "array"
    },
    "stage_name": {
      "title": "Stage Name",
      "type": "string"
    },
    "sync_eligible": {
      "description": "May be invoked synchronously: deterministic and expected to finish in 5 s or less.",
      "title": "Sync Eligible",
      "type": "boolean"
    },
    "timeout_seconds": {
      "title": "Timeout Seconds",
      "type": "integer"
    },
    "version": {
      "title": "Version",
      "type": "integer"
    }
  },
  "required": [
    "agent_id",
    "version",
    "stage_name",
    "permission",
    "execution",
    "default_tier",
    "escalation",
    "sync_eligible",
    "invokable",
    "produces_report",
    "input_schema",
    "output_schema",
    "input_schema_resolved",
    "output_schema_resolved",
    "dependencies",
    "required_evidence",
    "expected_latency_ms",
    "expected_cost_usd",
    "timeout_seconds",
    "max_retries",
    "fallback",
    "concurrency_class"
  ],
  "title": "AgentCatalogEntry",
  "type": "object"
}

Used by endpoints

One endpoint sends or returns this schema, on its own or inside another schema.

• GET /api/v1/agents/catalog — List Agent Catalog

Used by schemas

No other schema contains this one.

More details

• Specification: OpenAPI JSON