Server definition
- Hash
- sha256:5a05426dbd70fa91363c645fb515c73995152333d448b6e16aa64d858880e1ae
- What it is
- What a remote MCP server returned when asked what it offers: 14 tools
The blob, as servednamed by its sha256
{
"instructions": "Call discover_stewai first. It explains authentication, scopes, the search-to-run and authoring journeys, result inspection, and recovery. Protected tools start secure browser sign-in automatically; never ask the user for a StewAI API key or password.",
"tools": [
{
"description": "Run free deterministic lint, render, policy, and compiler checks. Omit fixtures for the normal structural check; a supplied fixture probe must also provide every referenced upstream dependency value.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"fixtures": {
"additionalProperties": {
"oneOf": [
{
"maxLength": 32768,
"type": "string"
},
{
"type": "object"
},
{
"type": "array"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"maxProperties": 20,
"type": "object"
},
"render_only": {
"type": "boolean"
}
},
"required": [
"build_ref"
],
"type": "object"
},
"name": "check_recipe_build",
"outputSchema": {
"oneOf": [
{
"properties": {
"automatic_acceptance_eligible": {
"type": "boolean"
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"compute_results": {
"maxItems": 0,
"type": "array"
},
"draft_valid": {
"type": "boolean"
},
"dsl_version": {
"minimum": 2,
"type": "integer"
},
"effect_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"fan_out": {
"minimum": 0,
"type": "integer"
},
"findings": {
"items": {
"additionalProperties": false,
"properties": {
"choices_truncated": {
"type": "boolean"
},
"code": {
"maxLength": 64,
"type": "string"
},
"declared_schema": {
"maxProperties": 100,
"type": "object"
},
"difference_pointer": {
"maxLength": 512,
"type": "string"
},
"executable_schema": {
"maxProperties": 100,
"type": "object"
},
"field_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": [
"array",
"null"
]
},
"fix_hint": {
"maxLength": 1000,
"type": [
"string",
"null"
]
},
"inference_source": {
"additionalProperties": false,
"properties": {
"field_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"kind": {
"enum": [
"recipe_input_max_length",
"recipe_input_default_text_contract",
"producer_response_schema",
"registered_schema",
"recipe_output_default_string"
]
},
"step_id": {
"maxLength": 128,
"type": [
"string",
"null"
]
}
},
"required": [
"kind",
"step_id",
"field_path"
],
"type": "object"
},
"message": {
"maxLength": 1000,
"type": "string"
},
"missing_producer": {
"maxLength": 128,
"type": "string"
},
"severity": {
"enum": [
"info",
"warning",
"error"
]
},
"step_id": {
"maxLength": 128,
"type": [
"string",
"null"
]
},
"suggested_mutation": {
"additionalProperties": false,
"properties": {
"field_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"operation": {
"enum": [
"upsert_node",
"set_contracts"
]
},
"replacement": {},
"step_id": {
"maxLength": 128,
"type": [
"string",
"null"
]
},
"target": {
"enum": [
"executable_recipe",
"authoring_contract"
]
}
},
"required": [
"operation",
"target",
"step_id",
"field_path",
"replacement"
],
"type": "object"
},
"valid_producer_choices": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 50,
"type": "array"
}
},
"required": [
"code",
"severity",
"step_id",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"gate_results": {
"maxItems": 0,
"type": "array"
},
"guidance_version": {
"maxLength": 64,
"type": "string"
},
"qualification_requirements": {
"items": {
"additionalProperties": false,
"properties": {
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"rendered": {
"items": {
"additionalProperties": false,
"properties": {
"path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"text": {
"maxLength": 4096,
"type": "string"
}
},
"required": [
"path",
"text"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"unsupported_nodes": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array",
"uniqueItems": true
},
"valid": {
"type": "boolean"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"valid",
"draft_valid",
"automatic_acceptance_eligible",
"qualification_route",
"qualification_requirements",
"effect_digest",
"findings",
"rendered",
"gate_results",
"compute_results",
"fan_out",
"unsupported_nodes",
"dsl_version",
"catalog_version",
"guidance_version"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Preflight and privately publish only the exact fully qualified recipe revision.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"commit_capability": {
"description": "Required for commit; omit for preflight.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"idempotency_key": {
"maxLength": 200,
"minLength": 1,
"pattern": "^[\\x20-\\x7e]+$",
"type": "string"
},
"mode": {
"enum": [
"preflight",
"commit"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"build_ref",
"revision",
"mode",
"idempotency_key"
],
"type": "object"
},
"name": "commit_recipe_build",
"outputSchema": {
"oneOf": [
{
"properties": {
"commit_capability": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"effects": {
"items": {
"enum": [
"create_private_revision_1",
"keep_recipe_unlisted",
"keep_recipe_unreviewed"
]
},
"maxItems": 3,
"minItems": 3,
"type": "array"
},
"evidence": {
"additionalProperties": false,
"properties": {
"acceptance": {
"enum": [
"full_suite_passed",
"accepted_with_limitations"
]
},
"accepted_limitations": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgement": {
"maxLength": 500,
"type": "string"
},
"assertion_id": {
"maxLength": 64,
"type": "string"
},
"case_id": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"case_id",
"assertion_id",
"acknowledgement"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"billing": {
"const": "settled"
},
"human_review_required": {
"const": true
},
"research": {
"enum": [
"recorded",
"not_required"
]
},
"review": {
"const": "passed"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"revision",
"review",
"research",
"acceptance",
"billing"
],
"type": "object"
},
"expires_in_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"commit_capability",
"expires_in_seconds",
"effects",
"evidence"
],
"type": "object"
},
{
"properties": {
"editor_url": {
"maxLength": 512,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"acceptance": {
"enum": [
"full_suite_passed",
"accepted_with_limitations"
]
},
"accepted_limitations": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgement": {
"maxLength": 500,
"type": "string"
},
"assertion_id": {
"maxLength": 64,
"type": "string"
},
"case_id": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"case_id",
"assertion_id",
"acknowledgement"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"billing": {
"const": "settled"
},
"human_review_required": {
"const": true
},
"research": {
"enum": [
"recorded",
"not_required"
]
},
"review": {
"const": "passed"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"revision",
"review",
"research",
"acceptance",
"billing"
],
"type": "object"
},
"listed": {
"const": false
},
"next_action": {
"not": {}
},
"recipe_ref": {
"not": {}
},
"recipe_ulid": {
"maxLength": 26,
"minLength": 1,
"type": "string"
},
"rev": {
"const": 1
},
"runnable": {
"not": {}
},
"sha": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"visibility": {
"const": "private"
}
},
"required": [
"recipe_ulid",
"rev",
"sha",
"visibility",
"listed",
"editor_url"
],
"type": "object"
},
{
"properties": {
"editor_url": {
"maxLength": 512,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"acceptance": {
"enum": [
"full_suite_passed",
"accepted_with_limitations"
]
},
"accepted_limitations": {
"items": {
"additionalProperties": false,
"properties": {
"acknowledgement": {
"maxLength": 500,
"type": "string"
},
"assertion_id": {
"maxLength": 64,
"type": "string"
},
"case_id": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"case_id",
"assertion_id",
"acknowledgement"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"billing": {
"const": "settled"
},
"human_review_required": {
"const": true
},
"research": {
"enum": [
"recorded",
"not_required"
]
},
"review": {
"const": "passed"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"revision",
"review",
"research",
"acceptance",
"billing"
],
"type": "object"
},
"listed": {
"const": false
},
"next_action": {
"const": "dry_run_recipe"
},
"recipe_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"recipe_ulid": {
"maxLength": 26,
"minLength": 1,
"type": "string"
},
"rev": {
"const": 1
},
"runnable": {
"type": "boolean"
},
"sha": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"visibility": {
"const": "private"
}
},
"required": [
"recipe_ulid",
"rev",
"sha",
"visibility",
"listed",
"editor_url",
"recipe_ref",
"runnable",
"next_action"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"gate": {
"maxLength": 64,
"type": "string"
},
"instruction": {
"maxLength": 500,
"type": "string"
},
"tool": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"gate",
"tool",
"instruction"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"remaining_gates": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Learn how any MCP agent can authenticate, discover, preview, run, author, qualify, commit, inspect, and recover StewAI recipes. Call this first.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "discover_stewai",
"outputSchema": {
"additionalProperties": false,
"properties": {
"account": {
"additionalProperties": false,
"properties": {
"email": {
"maxLength": 254,
"type": "string"
},
"organization_id": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"email",
"organization_id"
],
"type": "object"
},
"authenticated": {
"type": "boolean"
},
"authoring_available": {
"type": "boolean"
},
"authoring_journey": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"next_on_success": {
"maxLength": 160,
"type": "string"
},
"order": {
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"tool": {
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"order",
"tool",
"action",
"next_on_success"
],
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"capabilities": {
"items": {
"additionalProperties": false,
"properties": {
"benefit": {
"type": "string"
},
"capability": {
"type": "string"
},
"category": {
"enum": [
"research",
"documents",
"communication",
"data",
"compliance",
"operations"
],
"type": "string"
},
"example_prompt": {
"type": "string"
}
},
"required": [
"capability",
"benefit",
"example_prompt",
"category"
],
"type": "object"
},
"maxItems": 10,
"minItems": 6,
"type": "array"
},
"connection": {
"additionalProperties": false,
"properties": {
"api_key_required": {
"const": false
},
"authorization": {
"const": "oauth_2_1_browser"
},
"instruction": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"authorization",
"api_key_required",
"instruction"
],
"type": "object"
},
"consumer_journey": {
"items": {
"additionalProperties": false,
"properties": {
"action": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"next_on_success": {
"maxLength": 160,
"type": "string"
},
"order": {
"maximum": 12,
"minimum": 1,
"type": "integer"
},
"tool": {
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"order",
"tool",
"action",
"next_on_success"
],
"type": "object"
},
"maxItems": 8,
"minItems": 0,
"type": "array"
},
"gateway_contract_version": {
"type": "string"
},
"granted_scopes": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 16,
"type": "array"
},
"rules": {
"items": {
"maxLength": 300,
"type": "string"
},
"maxItems": 10,
"minItems": 4,
"type": "array"
},
"scope_groups": {
"additionalProperties": false,
"properties": {
"author_and_qualify": {
"items": {
"type": "string"
},
"type": "array"
},
"discover_and_run_public": {
"items": {
"type": "string"
},
"type": "array"
},
"inspect_and_run_private": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"discover_and_run_public",
"inspect_and_run_private",
"author_and_qualify"
],
"type": "object"
}
},
"required": [
"gateway_contract_version",
"authenticated",
"authoring_available",
"granted_scopes",
"connection",
"scope_groups",
"consumer_journey",
"authoring_journey",
"rules",
"capabilities"
],
"type": "object"
}
},
{
"description": "List or inspect only the authenticated creator's private recipe builds. To list builds omit both build_ref and view; limit/cursor paginate that list. With or without build_ref, use view='authoring_schema' and schema_name='update_recipe_build', 'acceptance_suite', or 'start_recipe_build' to read the complete executable JSON Schema when a client hides nested operation or assertion fields. Large acceptance_plan reads return data.suite_page JSON fragments: append content in offset order, pass data.next_cursor as cursor until null, then parse the complete suite and verify its sha256. Small plans retain data.suite. Use view='capabilities' to discover the complete 24-handler authoring and automatic-acceptance capability catalog.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"cursor": {
"maxLength": 512,
"type": "string"
},
"include_archived": {
"type": "boolean"
},
"limit": {
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"model_id": {
"maxLength": 200,
"type": "string"
},
"node_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"schema_name": {
"enum": [
"update_recipe_build",
"acceptance_suite",
"start_recipe_build"
]
},
"view": {
"enum": [
"summary",
"contracts",
"node_inventory",
"node",
"schemas",
"capabilities",
"capabilities_index",
"capability",
"models",
"research",
"acceptance_plan",
"activity",
"handoffs",
"resources",
"guidance",
"authoring_schema"
]
}
},
"required": [],
"type": "object"
},
"name": "get_recipe_build",
"outputSchema": {
"oneOf": [
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"additionalProperties": false,
"properties": {
"detail_lookup_key": {
"maxLength": 64,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"purpose": {
"maxLength": 240,
"type": "string"
},
"qualification_route": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"node_type",
"purpose",
"qualification_route",
"detail_lookup_key"
],
"type": "object"
},
"maxItems": 24,
"type": "array"
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"usage": {
"maxLength": 500,
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"catalog_version",
"usage",
"capabilities"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "capabilities_index"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"capability": {
"additionalProperties": false,
"properties": {
"acceptance_note": {
"maxLength": 240,
"type": [
"string",
"null"
]
},
"authoring_schema": {
"maxProperties": 20,
"minProperties": 4,
"type": "object"
},
"automatic_acceptance_eligible": {
"type": "boolean"
},
"defaults": {
"maxProperties": 32,
"type": "object"
},
"draft_authoring_supported": {
"type": "boolean"
},
"effect_class": {
"enum": [
"none",
"provider_call",
"external_read",
"external_write",
"durable_write",
"wait",
"nested_recipe"
]
},
"exposure": {
"enum": [
"primary",
"alias",
"backend_only"
]
},
"minimal_example": {
"maxProperties": 100,
"minProperties": 2,
"type": "object"
},
"node_type": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"required_fields": {
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 32,
"minItems": 2,
"type": "array",
"uniqueItems": true
},
"resource_selector_paths": {
"items": {
"maxLength": 256,
"pattern": "^/[A-Za-z_][A-Za-z0-9_/]*$",
"type": "string"
},
"maxItems": 8,
"type": "array",
"uniqueItems": true
},
"user_handoff": {
"enum": [
"none",
"budget_approval",
"side_effect_approval",
"resource_and_side_effect_approval",
"resource_or_oauth",
"oauth_or_platform_policy",
"runtime_wait",
"recipe_selection",
"resource_selection"
]
}
},
"required": [
"node_type",
"draft_authoring_supported",
"automatic_acceptance_eligible",
"qualification_route",
"exposure",
"effect_class",
"user_handoff",
"acceptance_note",
"authoring_schema",
"required_fields",
"defaults",
"resource_selector_paths",
"minimal_example"
],
"type": "object"
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"catalog_version",
"capability"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "capability"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"contract_version": {
"maxLength": 64,
"type": "string"
},
"count": {
"minimum": 0,
"type": "integer"
},
"detail_lookup": {
"maxLength": 500,
"type": "string"
},
"has_org_restrictions": {
"type": "boolean"
},
"model": {
"type": "object"
},
"models": {
"items": {
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"next_cursor": {
"maxLength": 512,
"type": "string"
},
"org_overrides": {
"type": "object"
},
"parameters": {
"items": {
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"contract_version"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "models"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"builds": {
"items": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"last_activity_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"qualification",
"last_activity_at",
"archived_at"
],
"type": "object"
},
"maxItems": 25,
"type": "array"
}
},
"required": [
"builds"
],
"type": "object"
},
"next_cursor": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "listing"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"readiness": {
"additionalProperties": false,
"properties": {
"acceptance_qualified": {
"type": "boolean"
},
"commit_ready": {
"type": "boolean"
},
"next_actions": {
"items": {
"additionalProperties": false,
"properties": {
"gate": {
"maxLength": 64,
"type": "string"
},
"instruction": {
"maxLength": 300,
"type": "string"
},
"tool": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"gate",
"tool",
"instruction"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"remaining_gates": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array"
}
},
"required": [
"acceptance_qualified",
"commit_ready",
"remaining_gates",
"next_actions"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"readiness"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "summary"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"input_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"output_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"const": true
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"input_contract",
"output_contract"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "contracts"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"nodes": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"maxLength": 128,
"type": [
"string",
"null"
]
},
"type": {
"maxLength": 64,
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"type"
],
"type": "object"
},
"maxItems": 500,
"type": "array"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"nodes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "node_inventory"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"node": {
"type": "object"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"node"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "node"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"schemas": {
"type": "object"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"schemas"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "schemas"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"operator_fields": {
"items": {
"additionalProperties": false,
"properties": {
"allowed": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"conditional": {
"additionalProperties": false,
"properties": {
"accepted_limitation": {
"maxLength": 240,
"type": "string"
}
},
"required": [],
"type": "object"
},
"forbidden": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"required": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"type",
"operator",
"required",
"allowed",
"forbidden",
"conditional"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"schema": {
"type": "object"
},
"schema_name": {
"enum": [
"update_recipe_build",
"acceptance_suite",
"start_recipe_build"
]
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
},
"usage": {
"maxLength": 1500,
"type": "string"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"schema_name",
"schema",
"usage"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "authoring_schema"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"capabilities": {
"items": {
"additionalProperties": false,
"properties": {
"acceptance_note": {
"maxLength": 240,
"type": [
"string",
"null"
]
},
"authoring_schema": {
"maxProperties": 20,
"minProperties": 4,
"type": "object"
},
"automatic_acceptance_eligible": {
"type": "boolean"
},
"defaults": {
"maxProperties": 32,
"type": "object"
},
"draft_authoring_supported": {
"type": "boolean"
},
"effect_class": {
"enum": [
"none",
"provider_call",
"external_read",
"external_write",
"durable_write",
"wait",
"nested_recipe"
]
},
"exposure": {
"enum": [
"primary",
"alias",
"backend_only"
]
},
"minimal_example": {
"maxProperties": 100,
"minProperties": 2,
"type": "object"
},
"node_type": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"required_fields": {
"items": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"maxItems": 32,
"minItems": 2,
"type": "array",
"uniqueItems": true
},
"resource_selector_paths": {
"items": {
"maxLength": 256,
"pattern": "^/[A-Za-z_][A-Za-z0-9_/]*$",
"type": "string"
},
"maxItems": 8,
"type": "array",
"uniqueItems": true
},
"user_handoff": {
"enum": [
"none",
"budget_approval",
"side_effect_approval",
"resource_and_side_effect_approval",
"resource_or_oauth",
"oauth_or_platform_policy",
"runtime_wait",
"recipe_selection",
"resource_selection"
]
}
},
"required": [
"node_type",
"draft_authoring_supported",
"automatic_acceptance_eligible",
"qualification_route",
"exposure",
"effect_class",
"user_handoff",
"acceptance_note",
"authoring_schema",
"required_fields",
"defaults",
"resource_selector_paths",
"minimal_example"
],
"type": "object"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"next_cursor": {
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"catalog_version",
"capabilities"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "capabilities"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"evidence": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"supported_claim": {
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"url": {
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"url",
"title",
"retrieved_at",
"supported_claim",
"applicability"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"research_policy": {
"enum": [
"forbidden",
"allowed",
"required"
]
},
"research_tier": {
"enum": [
"skipped",
"recommended",
"required"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"research_policy",
"research_tier",
"evidence"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "research"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"minimum_acceptance_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
},
"suite": {
"type": "object"
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"suite",
"minimum_acceptance_categories"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "acceptance_plan"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"minimum_acceptance_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"next_cursor": {
"maxLength": 512,
"type": [
"string",
"null"
]
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
},
"suite_page": {
"additionalProperties": false,
"properties": {
"content": {
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"encoding": {
"const": "json"
},
"offset": {
"minimum": 0,
"type": "integer"
},
"sha256": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"total_characters": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"encoding",
"content",
"offset",
"total_characters",
"sha256"
],
"type": "object"
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"suite_page",
"next_cursor",
"minimum_acceptance_categories"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "acceptance_plan"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"activities": {
"items": {
"additionalProperties": false,
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"created_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": [
"string",
"null"
]
},
"kind": {
"enum": [
"review",
"acceptance_batch",
"acceptance_case"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"error_code",
"created_at"
],
"type": "object"
},
"maxItems": 25,
"type": "array"
},
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"activities"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "activity"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"handoffs": {
"items": {
"additionalProperties": false,
"properties": {
"action_url": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"effect_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"effects": {
"items": {
"additionalProperties": false,
"properties": {
"details": {
"additionalProperties": false,
"properties": {
"additional_text": {},
"body_template": {},
"child_recipe_ulid": {},
"child_revision_sha": {},
"destination_mode": {},
"duration": {},
"external_conflict_mode": {},
"external_target_ulid": {},
"filename": {},
"folder_name": {},
"folder_ulid": {},
"format": {},
"html_only": {},
"input_mapping": {},
"local_conflict_mode": {},
"max_chunks": {},
"name": {},
"nested_effects": {},
"options": {},
"outcome_description": {},
"outcome_max_iterations": {},
"outcome_rubric": {},
"output_conflict_mode": {},
"params": {},
"pin_revision": {},
"preamble_enabled": {},
"prompt": {},
"query": {},
"score_threshold": {},
"source": {},
"sources": {},
"subject": {},
"system_message": {},
"title": {},
"to": {},
"tool_groups": {},
"top_k": {},
"visibility": {}
},
"required": [],
"type": "object"
},
"execution_count": {
"minimum": 0,
"type": "integer"
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"node_id",
"node_type",
"execution_count",
"details"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"reason": {
"maxLength": 500,
"type": "string"
},
"required_decisions": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 100,
"type": "array",
"uniqueItems": true
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"binding_status": {
"enum": [
"required",
"bound"
]
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest",
"binding_status"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"resume": {
"additionalProperties": false,
"properties": {
"operation": {
"const": "resume_activity"
},
"tool": {
"const": "update_recipe_build"
}
},
"required": [
"tool",
"operation"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"pending",
"approved",
"cancelled",
"expired",
"consumed"
]
}
},
"required": [
"handoff_ref",
"activity_ref",
"revision",
"status",
"effect_digest",
"reason",
"required_decisions",
"effects",
"expires_at",
"action_url",
"resume"
],
"type": "object"
},
"maxItems": 25,
"type": "array"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"handoffs"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "handoffs"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"binding_status": {
"enum": [
"required",
"bound"
]
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest",
"binding_status"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"resources"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "resources"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"archived_at": {
"format": "date-time",
"maxLength": 64,
"type": [
"string",
"null"
]
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"contract_bundle": {
"additionalProperties": false,
"properties": {
"archetype": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"archetype_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"capabilities": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"node_kinds": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"summary": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"archetype_id",
"title",
"summary",
"capabilities",
"node_kinds"
],
"type": "object"
},
{
"type": "null"
}
]
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"input_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"output_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"const": true
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"recipe_spec": {
"type": "object"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"catalog_version",
"archetype",
"input_contract",
"output_contract",
"recipe_spec"
],
"type": "object"
},
"dsl_version": {
"const": 2
},
"guidance_version": {
"maxLength": 64,
"type": "string"
},
"matched_archetypes": {
"items": {
"additionalProperties": false,
"properties": {
"archetype_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"capabilities": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"node_kinds": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"summary": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"archetype_id",
"title",
"summary",
"capabilities",
"node_kinds"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"minimum_acceptance_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"qualification": {
"enum": [
"none",
"pending",
"qualified",
"invalidated"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"draft",
"qualified",
"committed",
"abandoned"
]
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"build_ref",
"name",
"status",
"revision",
"qualification",
"archived_at",
"dsl_version",
"catalog_version",
"guidance_version",
"matched_archetypes",
"contract_bundle",
"minimum_acceptance_categories"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"view": {
"const": "guidance"
}
},
"required": [
"view",
"data"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Poll a review or acceptance batch through a bounded, disclosure-safe view.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"cursor": {
"maxLength": 512,
"type": "string"
},
"section": {
"enum": [
"summary",
"nodes",
"assertions",
"coverage",
"billing"
]
}
},
"required": [
"activity_ref"
],
"type": "object"
},
"name": "get_recipe_build_activity",
"outputSchema": {
"oneOf": [
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"const": "review"
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "summary"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"summary": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"additionalProperties": false,
"properties": {
"category": {
"enum": [
"runtime_contract",
"semantic_contract",
"method",
"safety",
"research",
"advisory"
]
},
"code": {
"maxLength": 64,
"type": "string"
},
"counterexample": {
"maxLength": 1000,
"type": "string"
},
"evidence_path": {
"maxLength": 512,
"type": "string"
},
"evidence_status": {
"enum": [
"source_verified",
"unsupported"
]
},
"recommendation": {
"maxLength": 4000,
"type": "string"
},
"runtime_binding_status": {
"const": "verified"
},
"severity": {
"enum": [
"info",
"warning",
"error"
]
}
},
"required": [
"code",
"severity"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"strengths": {
"items": {
"maxLength": 300,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"verdict": {
"enum": [
"pending",
"pass",
"revise"
]
}
},
"required": [
"verdict",
"issues",
"strengths"
],
"type": "object"
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"summary"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"const": "acceptance_batch"
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "summary"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"summary": {
"additionalProperties": false,
"properties": {
"billing_anomalies": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"cancelled": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"case_count": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"failed": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"passed": {
"maximum": 50,
"minimum": 0,
"type": "integer"
}
},
"required": [
"case_count"
],
"type": "object"
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"summary"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"const": "acceptance_case"
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "summary"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"summary": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"summary"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"billing": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"const": 2
},
"state": {
"const": "pending"
}
},
"required": [
"state",
"retry_after_seconds"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"state": {
"const": "unavailable"
}
},
"required": [
"state"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"charge_disposition": {
"const": "platform_absorbed"
},
"provider_cost_status": {
"const": "unknown"
},
"remaining_budget": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"settled_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"settled_credits",
"remaining_budget"
],
"type": "object"
}
]
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"enum": [
"review",
"acceptance_batch",
"acceptance_case"
]
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "billing"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"billing"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"enum": [
"review",
"acceptance_batch",
"acceptance_case"
]
},
"nodes": {
"items": {
"additionalProperties": false,
"properties": {
"billing": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"const": 2
},
"state": {
"const": "pending"
}
},
"required": [
"state",
"retry_after_seconds"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"state": {
"const": "unavailable"
}
},
"required": [
"state"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"charge_disposition": {
"const": "platform_absorbed"
},
"provider_cost_status": {
"const": "unknown"
},
"remaining_budget": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"settled_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"settled_credits",
"remaining_budget"
],
"type": "object"
}
]
},
"case_id": {
"maxLength": 64,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
}
},
"required": [
"case_id",
"state",
"billing"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "nodes"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"nodes"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"coverage": {
"additionalProperties": false,
"properties": {
"qualified": {
"type": "boolean"
},
"required_case_ids": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"selected_case_ids": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 50,
"type": "array"
}
},
"required": [
"selected_case_ids",
"required_case_ids",
"qualified"
],
"type": "object"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"enum": [
"review",
"acceptance_batch",
"acceptance_case"
]
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "coverage"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"coverage"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"cases": {
"items": {
"additionalProperties": false,
"properties": {
"assertions": {
"items": {
"additionalProperties": false,
"properties": {
"assertion_id": {
"maxLength": 64,
"type": "string"
},
"code": {
"maxLength": 64,
"type": "string"
},
"diagnostic": {
"additionalProperties": false,
"properties": {
"actual_missing": {
"type": "boolean"
},
"actual_preview": {
"maxLength": 256,
"type": "string"
},
"availability": {
"enum": [
"available",
"unavailable"
]
},
"expected_preview": {
"maxLength": 256,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"paired_actual_missing": {
"type": "boolean"
},
"paired_actual_preview": {
"maxLength": 256,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"truncated": {
"type": "boolean"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"availability"
],
"type": "object"
},
"passed": {
"type": "boolean"
}
},
"required": [
"assertion_id",
"passed",
"code"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"case_id": {
"maxLength": 64,
"type": "string"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
}
},
"required": [
"case_id",
"state",
"assertions"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"error_code": {
"maxLength": 64,
"type": "string"
},
"execution_diagnostic": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"evidence": {
"additionalProperties": false,
"properties": {
"attempt_count": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"finish_reason": {
"enum": [
"max_output_tokens",
"max_tokens",
"length",
"content_filter",
"refusal",
"unknown"
]
},
"max_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"reasoning_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"source": {
"enum": [
"structured_executor",
"legacy_executor_message"
]
},
"total_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"visible_output_tokens": {
"maximum": 10000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"source"
],
"type": "object"
},
"field_path": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 4,
"type": "array"
},
"fix_hint": {
"maxLength": 300,
"type": "string"
},
"message": {
"maxLength": 200,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"node_type",
"code",
"field_path",
"message",
"fix_hint"
],
"type": "object"
},
"kind": {
"enum": [
"review",
"acceptance_batch",
"acceptance_case"
]
},
"next_cursor": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"retry": {
"additionalProperties": false,
"properties": {
"attempt": {
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"maximum_attempts": {
"const": 3
},
"reason": {
"enum": [
"review_processing_interrupted",
"provider_result_processing_retry",
"settlement_retry"
]
},
"retry_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"state": {
"enum": [
"scheduled",
"retrying"
]
}
},
"required": [
"state",
"attempt",
"maximum_attempts",
"retry_at",
"reason"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"section": {
"const": "assertions"
},
"state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"terminal": {
"type": "boolean"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"activity_ref",
"kind",
"state",
"revision",
"terminal",
"section",
"cases",
"next_cursor"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Inspect a safe summary with bounded method and limitations excerpts, output-contract state, and evidence context. For complete authorized published details and executable contracts, use view=details. Concatenate content fragments in offset order per section; decode JSON sections after completion. Use next_cursor with the same recipe_ref until null. Opaque internals remain withheld.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"maxLength": 2000,
"type": "string"
},
"recipe_ref": {
"maxLength": 32768,
"type": "string"
},
"view": {
"enum": [
"summary",
"details"
]
}
},
"required": [
"recipe_ref"
],
"type": "object"
},
"name": "get_recipe_preview",
"outputSchema": {
"oneOf": [
{
"properties": {
"disclosure": {
"enum": [
"view_authorized",
"public_summary_only"
]
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"complete": {
"type": "boolean"
},
"content": {
"maxLength": 6000,
"type": "string"
},
"encoding": {
"enum": [
"text",
"json"
]
},
"offset": {
"minimum": 0,
"type": "integer"
},
"section": {
"type": "string"
},
"total_characters": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"section",
"encoding",
"content",
"offset",
"total_characters",
"complete"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"metrics": {
"additionalProperties": false,
"properties": {
"average_credits": {
"type": [
"number",
"null"
]
},
"average_duration_seconds": {
"type": [
"number",
"null"
]
},
"basis": {
"const": "successful_runs"
},
"sample_count": {
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"basis",
"sample_count",
"average_credits",
"average_duration_seconds"
],
"type": "object"
},
"next_cursor": {
"maxLength": 2000,
"type": [
"string",
"null"
]
},
"recipe_ref": {
"maxLength": 32768,
"type": "string"
},
"revision_sha": {
"type": "string"
},
"view": {
"const": "details"
}
},
"required": [
"view",
"revision_sha",
"disclosure",
"items",
"next_cursor",
"recipe_ref",
"metrics"
],
"type": "object"
},
{
"properties": {
"access": {
"additionalProperties": false,
"properties": {
"can_fork": {
"type": "boolean"
},
"can_run": {
"type": "boolean"
},
"can_view": {
"type": "boolean"
}
},
"required": [
"can_view",
"can_run",
"can_fork"
],
"type": "object"
},
"category": {
"maxLength": 100,
"type": "string"
},
"contracts": {
"additionalProperties": false,
"properties": {
"inputs": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"required": {
"description": "Declared required by the recipe; get_recipe_preview shows must_provide and default_available for the same handle.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"description"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"required": {
"description": "Declared required by the recipe; get_recipe_preview shows must_provide and default_available for the same handle.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"description"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs_undeclared": {
"type": "boolean"
}
},
"required": [
"inputs",
"outputs"
],
"type": "object"
},
"decision_context": {
"additionalProperties": false,
"description": "Bounded selection hints from the pinned published revision, with explicitly labeled safety-reviewed public copy as a fallback; text is withheld without view permission.",
"properties": {
"evidence_note": {
"maxLength": 240,
"type": [
"string",
"null"
]
},
"limitations_excerpt": {
"maxLength": 800,
"type": [
"string",
"null"
]
},
"method_excerpt": {
"maxLength": 800,
"type": [
"string",
"null"
]
},
"output_contract_state": {
"description": "Unusable means output nodes exist but no stable executable output binding is available.",
"enum": [
"declared",
"undeclared",
"unusable"
]
}
},
"required": [
"method_excerpt",
"limitations_excerpt",
"output_contract_state",
"evidence_note"
],
"type": "object"
},
"description": {
"maxLength": 4000,
"type": "string"
},
"description_truncated": {
"type": "boolean"
},
"evidence": {
"additionalProperties": false,
"properties": {
"acceptance_case_count": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"last_qualified": {
"enum": [
"unknown",
"last_7_days",
"last_30_days",
"older"
]
},
"research_evidence_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"safety_review_state": {
"enum": [
"unreviewed",
"pending_attestation",
"pending_review",
"approved",
"rejected",
"revision_requested",
"delisted",
"suspended"
]
}
},
"required": [
"research_evidence_count",
"acceptance_case_count",
"last_qualified",
"safety_review_state"
],
"type": "object"
},
"input_limits": {
"additionalProperties": false,
"properties": {
"max_total_utf8_bytes": {
"minimum": 1,
"type": "integer"
},
"note": {
"maxLength": 240,
"type": "string"
}
},
"required": [
"max_total_utf8_bytes"
],
"type": "object"
},
"inputs": {
"items": {
"additionalProperties": false,
"properties": {
"default_available": {
"description": "The recipe applies a default when this input is omitted; the default itself is never disclosed.",
"type": "boolean"
},
"handle": {
"pattern": "^input_[1-9][0-9]*$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"max_characters": {
"minimum": 1,
"type": "integer"
},
"max_utf8_bytes": {
"minimum": 1,
"type": "integer"
},
"must_provide": {
"description": "True only when the input is required and has no default; the caller has to supply it.",
"type": "boolean"
},
"required": {
"description": "The recipe declares this input as required. With default_available true a default is applied when it is omitted, so must_provide is false.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"must_provide",
"default_available",
"max_characters",
"max_utf8_bytes"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs": {
"items": {
"maxLength": 100,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"pricing": {
"additionalProperties": false,
"properties": {
"average_credits": {
"maxLength": 128,
"pattern": "^\\d+(?:\\.\\d+)?$",
"type": "string"
},
"basis": {
"const": "historical_average_successful_runs"
},
"creator_fee": {
"enum": [
"marketplace_policy",
"none"
]
},
"credit_band": {
"description": "Band of the average credits per successful run; unknown means no successful runs yet.",
"enum": [
"unknown",
"free",
"0_to_10",
"10_to_100",
"over_100"
]
},
"estimate_requires_dry_run": {
"const": true
}
},
"required": [
"basis",
"credit_band",
"estimate_requires_dry_run",
"creator_fee"
],
"type": "object"
},
"qualification": {
"enum": [
"public_reviewed",
"authoring_qualified",
"published_unqualified",
"unknown"
]
},
"recipe_ref": {
"maxLength": 32768,
"type": "string"
},
"source": {
"enum": [
"public",
"owned",
"organization",
"shared"
]
},
"state": {
"const": "published"
},
"title": {
"maxLength": 200,
"type": "string"
},
"visibility": {
"enum": [
"private",
"shared",
"public_open",
"public_opaque"
]
}
},
"required": [
"title",
"description",
"description_truncated",
"category",
"pricing",
"visibility",
"inputs",
"outputs",
"recipe_ref",
"input_limits",
"source",
"access",
"state",
"qualification",
"contracts",
"evidence",
"decision_context"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"enum": [
"recipe_unavailable",
"invalid_cursor",
"recipe_ref_expired"
]
},
"hint": {
"maxLength": 240,
"type": "string"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Read declared outputs or a sanitized per-step trace from an owned run, including signed chunks for oversized steps. view=steps returns compact summaries, 10 per page by default and at most 20 (limit 1-20); follow next_cursor until it is null, pass detail=full for whole steps, or use view=step with step_id for one full step. Open recipes expose all authorized steps; closed recipes expose only input and output steps. Sensitive values stay redacted. Step reads are provisional until get_run reports a finished status. If outputs is empty, read view=steps; for a failed run, read the failed step and let the user decide.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"chunk_ref": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"cursor": {
"maxLength": 8,
"pattern": "^o:(?:0|[1-9][0-9]*)$",
"type": "string"
},
"detail": {
"description": "For view=steps: summary (default) lists each step's id, title, kind, status, timing and result type; full returns parameters, rendered input and result. view=step always returns the full step.",
"enum": [
"summary",
"full"
]
},
"limit": {
"description": "Steps per page for view=steps: default 10, at most 20.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"view": {
"enum": [
"declared_outputs",
"steps",
"step",
"step_chunk"
]
}
},
"required": [
"run_id"
],
"type": "object"
},
"name": "get_results",
"outputSchema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"outcome": {
"const": "results"
},
"outputs": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"maxLength": 100,
"type": "string"
},
"value": {}
},
"required": [
"label",
"value"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
}
},
"required": [
"outcome",
"run_id",
"outputs"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"outcome": {
"const": "not_ready"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"blocked"
]
}
},
"required": [
"outcome",
"run_id",
"status"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"outcome": {
"const": "no_results"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"failed",
"cancelled"
]
}
},
"required": [
"outcome",
"run_id",
"status"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"outcome": {
"const": "result_too_large"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
}
},
"required": [
"outcome",
"run_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"next_cursor": {
"oneOf": [
{
"maxLength": 8,
"pattern": "^o:(?:0|[1-9][0-9]*)$",
"type": "string"
},
{
"type": "null"
}
]
},
"observed_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"outcome": {
"const": "steps"
},
"provisional": {
"description": "True while the run is not finished: step statuses and results can still change. Unfinished steps show a pending result.",
"type": "boolean"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"done",
"failed",
"cancelled",
"blocked"
]
},
"steps": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"diagnostic_notes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"meaning": {
"maxLength": 200,
"type": "string"
}
},
"required": [
"code",
"meaning"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"finished_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"kind": {
"maxLength": 32,
"type": "string"
},
"redaction_reasons": {
"items": {
"enum": [
"sensitive_input",
"opaque_recipe"
]
},
"maxItems": 2,
"type": "array",
"uniqueItems": true
},
"result_type": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"started_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"status": {
"maxLength": 32,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"title": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"step_id",
"title",
"kind",
"status",
"started_at",
"finished_at",
"result_type",
"redaction_reasons"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"depends_on": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 1000,
"type": "array"
},
"diagnostic_notes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"meaning": {
"maxLength": 200,
"type": "string"
}
},
"required": [
"code",
"meaning"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"diagnostics": {
"additionalProperties": false,
"properties": {
"duration_ms": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"input_tokens": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"output_tokens": {
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"duration_ms",
"input_tokens",
"output_tokens"
],
"type": "object"
},
"input_source": {
"enum": [
"rendered",
"configured",
"unavailable"
]
},
"kind": {
"maxLength": 32,
"type": "string"
},
"parameters": {
"type": "object"
},
"redaction_reasons": {
"items": {
"enum": [
"sensitive_input",
"opaque_recipe"
]
},
"maxItems": 2,
"type": "array",
"uniqueItems": true
},
"rendered_input": {
"oneOf": [
{
"maxLength": 1048576,
"type": "string"
},
{
"type": "null"
}
]
},
"result": {
"type": "object"
},
"status": {
"maxLength": 32,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"title": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"step_id",
"title",
"kind",
"status",
"depends_on",
"parameters",
"rendered_input",
"input_source",
"result",
"redaction_reasons"
],
"type": "object"
}
]
},
"maxItems": 20,
"type": "array"
},
"trace_visibility": {
"enum": [
"full",
"opaque"
]
}
},
"required": [
"outcome",
"run_id",
"status",
"trace_visibility",
"steps",
"next_cursor"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"observed_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"outcome": {
"const": "step"
},
"provisional": {
"description": "True while the run is not finished: step statuses and results can still change. Unfinished steps show a pending result.",
"type": "boolean"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"done",
"failed",
"cancelled",
"blocked"
]
},
"step": {
"additionalProperties": false,
"properties": {
"depends_on": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 1000,
"type": "array"
},
"diagnostic_notes": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"meaning": {
"maxLength": 200,
"type": "string"
}
},
"required": [
"code",
"meaning"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"diagnostics": {
"additionalProperties": false,
"properties": {
"duration_ms": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"input_tokens": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"output_tokens": {
"minimum": 0,
"type": [
"integer",
"null"
]
}
},
"required": [
"duration_ms",
"input_tokens",
"output_tokens"
],
"type": "object"
},
"input_source": {
"enum": [
"rendered",
"configured",
"unavailable"
]
},
"kind": {
"maxLength": 32,
"type": "string"
},
"parameters": {
"type": "object"
},
"redaction_reasons": {
"items": {
"enum": [
"sensitive_input",
"opaque_recipe"
]
},
"maxItems": 2,
"type": "array",
"uniqueItems": true
},
"rendered_input": {
"oneOf": [
{
"maxLength": 1048576,
"type": "string"
},
{
"type": "null"
}
]
},
"result": {
"type": "object"
},
"status": {
"maxLength": 32,
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"title": {
"maxLength": 500,
"type": "string"
}
},
"required": [
"step_id",
"title",
"kind",
"status",
"depends_on",
"parameters",
"rendered_input",
"input_source",
"result",
"redaction_reasons"
],
"type": "object"
},
"trace_visibility": {
"enum": [
"full",
"opaque"
]
}
},
"required": [
"outcome",
"run_id",
"status",
"trace_visibility",
"step"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"next_cursor": {
"oneOf": [
{
"maxLength": 8,
"pattern": "^o:(?:0|[1-9][0-9]*)$",
"type": "string"
},
{
"type": "null"
}
]
},
"outcome": {
"const": "step_too_large"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"outcome",
"run_id",
"step_id",
"next_cursor"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"chunk_ref": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"next_cursor": {
"oneOf": [
{
"maxLength": 8,
"pattern": "^o:(?:0|[1-9][0-9]*)$",
"type": "string"
},
{
"type": "null"
}
]
},
"outcome": {
"const": "step_too_large"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"outcome",
"run_id",
"step_id",
"next_cursor",
"chunk_ref"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"chunk": {
"maxLength": 1048576,
"type": "string"
},
"chunk_utf8_bytes": {
"minimum": 1,
"type": "integer"
},
"encoding": {
"const": "json"
},
"next_chunk_ref": {
"oneOf": [
{
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"offset": {
"minimum": 0,
"type": "integer"
},
"outcome": {
"const": "step_chunk"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"total_utf8_bytes": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"outcome",
"run_id",
"step_id",
"encoding",
"offset",
"chunk",
"chunk_utf8_bytes",
"total_utf8_bytes",
"next_chunk_ref"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "run_not_found"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "invalid_params"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
}
},
"required": [
"error",
"field",
"hint"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "step_not_found"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "result_unavailable"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Read an owned run, view=history to resume normal runs (recipe_ref/status/cursor/limit), or view=diagnostics for its settled UI receipt. Default status requires run_id and includes live progress: updated_at is the run record time, progress.last_step_activity_at is the latest step activity. A blocked run paused for credits reports credit_pause.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"maxLength": 1024,
"type": "string"
},
"limit": {
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"recipe_ref": {
"maxLength": 4096,
"type": "string"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"done",
"failed",
"cancelled",
"blocked"
]
},
"view": {
"enum": [
"status",
"history",
"diagnostics"
]
}
},
"required": [],
"type": "object"
},
"name": "get_run",
"outputSchema": {
"oneOf": [
{
"oneOf": [
{
"additionalProperties": false,
"properties": {
"created_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"credit_pause": {
"additionalProperties": false,
"description": "The run paused because a step could not reserve credits. It resumes from the StewAI web app after credits are added.",
"properties": {
"available_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"required_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"resumable": {
"const": true
}
},
"required": [
"required_credits",
"available_credits",
"resumable"
],
"type": "object"
},
"progress": {
"additionalProperties": false,
"description": "Live progress from committed step rows. updated_at is the run record's time; last_step_activity_at shows the latest step start or finish.",
"properties": {
"active_steps": {
"items": {
"additionalProperties": false,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"kind": {
"maxLength": 32,
"type": "string"
},
"started_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"title": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"step_id",
"kind",
"started_at",
"elapsed_seconds"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"last_step_activity_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"observed_at": {
"maxLength": 40,
"type": "string"
},
"phase": {
"enum": [
"queued",
"running_steps",
"between_steps",
"waiting_for_input",
"paused_insufficient_credits",
"terminal"
]
},
"run_elapsed_seconds": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"steps": {
"additionalProperties": false,
"properties": {
"done": {
"minimum": 0,
"type": "integer"
},
"failed": {
"minimum": 0,
"type": "integer"
},
"queued": {
"minimum": 0,
"type": "integer"
},
"running": {
"minimum": 0,
"type": "integer"
},
"total": {
"minimum": 0,
"type": "integer"
},
"waiting_for_input": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"total",
"queued",
"running",
"waiting_for_input",
"done",
"failed"
],
"type": "object"
}
},
"required": [
"phase",
"steps",
"active_steps",
"run_elapsed_seconds",
"last_step_activity_at",
"observed_at"
],
"type": "object"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"blocked"
]
},
"updated_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
}
},
"required": [
"run_id",
"status",
"created_at",
"updated_at"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"billing": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"const": 2
},
"state": {
"const": "pending"
}
},
"required": [
"state",
"retry_after_seconds"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"state": {
"const": "unavailable"
}
},
"required": [
"state"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"charged_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"charged_credits"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"available_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"balance_as_of": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"charged_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"charged_credits",
"available_credits",
"balance_as_of"
],
"type": "object"
}
]
},
"created_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"progress": {
"additionalProperties": false,
"description": "Live progress from committed step rows. updated_at is the run record's time; last_step_activity_at shows the latest step start or finish.",
"properties": {
"active_steps": {
"items": {
"additionalProperties": false,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"kind": {
"maxLength": 32,
"type": "string"
},
"started_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"title": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"step_id",
"kind",
"started_at",
"elapsed_seconds"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"last_step_activity_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"observed_at": {
"maxLength": 40,
"type": "string"
},
"phase": {
"enum": [
"queued",
"running_steps",
"between_steps",
"waiting_for_input",
"paused_insufficient_credits",
"terminal"
]
},
"run_elapsed_seconds": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"steps": {
"additionalProperties": false,
"properties": {
"done": {
"minimum": 0,
"type": "integer"
},
"failed": {
"minimum": 0,
"type": "integer"
},
"queued": {
"minimum": 0,
"type": "integer"
},
"running": {
"minimum": 0,
"type": "integer"
},
"total": {
"minimum": 0,
"type": "integer"
},
"waiting_for_input": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"total",
"queued",
"running",
"waiting_for_input",
"done",
"failed"
],
"type": "object"
}
},
"required": [
"phase",
"steps",
"active_steps",
"run_elapsed_seconds",
"last_step_activity_at",
"observed_at"
],
"type": "object"
},
"results_available": {
"type": "boolean"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"const": "done"
},
"updated_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
}
},
"required": [
"run_id",
"status",
"created_at",
"updated_at",
"results_available",
"billing"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"billing": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"const": 2
},
"state": {
"const": "pending"
}
},
"required": [
"state",
"retry_after_seconds"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"state": {
"const": "unavailable"
}
},
"required": [
"state"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"charged_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"charged_credits"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"available_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"balance_as_of": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"charged_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"charged_credits",
"available_credits",
"balance_as_of"
],
"type": "object"
}
]
},
"created_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"progress": {
"additionalProperties": false,
"description": "Live progress from committed step rows. updated_at is the run record's time; last_step_activity_at shows the latest step start or finish.",
"properties": {
"active_steps": {
"items": {
"additionalProperties": false,
"properties": {
"elapsed_seconds": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"kind": {
"maxLength": 32,
"type": "string"
},
"started_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"step_id": {
"maxLength": 128,
"type": "string"
},
"title": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"step_id",
"kind",
"started_at",
"elapsed_seconds"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"last_step_activity_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"observed_at": {
"maxLength": 40,
"type": "string"
},
"phase": {
"enum": [
"queued",
"running_steps",
"between_steps",
"waiting_for_input",
"paused_insufficient_credits",
"terminal"
]
},
"run_elapsed_seconds": {
"minimum": 0,
"type": [
"integer",
"null"
]
},
"steps": {
"additionalProperties": false,
"properties": {
"done": {
"minimum": 0,
"type": "integer"
},
"failed": {
"minimum": 0,
"type": "integer"
},
"queued": {
"minimum": 0,
"type": "integer"
},
"running": {
"minimum": 0,
"type": "integer"
},
"total": {
"minimum": 0,
"type": "integer"
},
"waiting_for_input": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"total",
"queued",
"running",
"waiting_for_input",
"done",
"failed"
],
"type": "object"
}
},
"required": [
"phase",
"steps",
"active_steps",
"run_elapsed_seconds",
"last_step_activity_at",
"observed_at"
],
"type": "object"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"failed",
"cancelled"
]
},
"updated_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
}
},
"required": [
"run_id",
"status",
"created_at",
"updated_at",
"billing"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "run_not_found"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"next_cursor": {
"maxLength": 1024,
"type": [
"string",
"null"
]
},
"runs": {
"items": {
"additionalProperties": false,
"properties": {
"charged_credits": {
"description": "Credits charged by a finished run; null while it is active.",
"maxLength": 32,
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"recipe_id": {
"type": "string"
},
"recipe_title": {
"maxLength": 200,
"type": "string"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"done",
"failed",
"cancelled",
"blocked"
]
},
"updated_at": {
"type": "string"
}
},
"required": [
"run_id",
"recipe_id",
"recipe_title",
"status",
"created_at",
"updated_at",
"charged_credits"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"view": {
"const": "history"
}
},
"required": [
"view",
"runs",
"next_cursor"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"basis": {
"const": "UI receipt estimate versus settled charge; not an admission ceiling. Null means unavailable."
},
"billing": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"const": 2
},
"state": {
"const": "pending"
}
},
"required": [
"state",
"retry_after_seconds"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"state": {
"const": "unavailable"
}
},
"required": [
"state"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"charged_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"charged_credits"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"available_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"balance_as_of": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"charged_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"state": {
"const": "settled"
}
},
"required": [
"state",
"charged_credits",
"available_credits",
"balance_as_of"
],
"type": "object"
}
]
},
"receipt": {
"additionalProperties": false,
"properties": {
"charged_credits": {
"type": [
"number",
"null"
]
},
"estimated_credits": {
"type": [
"number",
"null"
]
},
"variance_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"estimated_credits",
"charged_credits",
"variance_pct"
],
"type": "object"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"view": {
"const": "diagnostics"
}
},
"required": [
"view",
"run_id",
"billing",
"receipt",
"basis"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "invalid_history_query"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Quote or run a bounded semantic quality review of the exact private draft revision.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"idempotency_key": {
"maxLength": 200,
"minLength": 1,
"pattern": "^[\\x20-\\x7e]+$",
"type": "string"
},
"mode": {
"enum": [
"quote",
"execute"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"build_ref",
"revision",
"mode",
"idempotency_key"
],
"type": "object"
},
"name": "review_recipe_build",
"outputSchema": {
"oneOf": [
{
"properties": {
"acceptance_cost": {
"additionalProperties": false,
"properties": {
"approval_cap_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"basis": {
"const": "enforced_input_bytes_and_output_caps"
},
"cap_policy": {
"maxLength": 120,
"type": "string"
},
"case_count": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"cases": {
"items": {
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"type": "string"
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"attempt_allowance": {
"minimum": 1,
"type": "integer"
},
"input_basis": {
"enum": [
"acceptance_message_fence",
"acceptance_schema_context_fallback"
]
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"provider_floor_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"model",
"input_basis",
"input_token_bound",
"output_token_cap",
"attempt_allowance",
"provider_floor_credits"
],
"type": "object"
},
"maxItems": 2,
"type": "array"
}
},
"required": [
"case_id",
"max_credits",
"steps"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"expected_high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"forecast": {
"items": {
"additionalProperties": false,
"properties": {
"basis": {
"enum": [
"settled_same_revision_case",
"settled_same_revision",
"provider_usage_same_recipe_step",
"platform_model_usage",
"static_fraction",
"hard_bound"
]
},
"case_id": {
"maxLength": 64,
"type": "string"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"hard_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"case_id",
"expected_credits",
"high_credits",
"hard_credits",
"basis",
"sample_count"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"forecast_basis": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"maxProperties": 8,
"type": "object"
},
"hard_bound_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"note": {
"maxLength": 400,
"type": "string"
},
"observed_case_costs": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"basis": {
"const": "recent_settled_cases_same_revision_not_a_forecast"
},
"maximum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"minimum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"sample_count",
"minimum_credits",
"maximum_credits",
"basis"
],
"type": "object"
}
]
}
},
"required": [
"basis",
"case_count",
"cases",
"note"
],
"type": "object"
},
"available_credits": {
"description": "Wallet funds currently available, independent of this build approval.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"budget_capability": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"budget_state": {
"enum": [
"not_redeemed",
"active"
]
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"handoff_requirement_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"handoff_requirements": {
"description": "Bounded quote preview. When incomplete, full acceptance creates the handoff with complete effects and resource requirements for approval.",
"items": {
"additionalProperties": false,
"properties": {
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"handoff_requirements_complete": {
"type": "boolean"
},
"kind": {
"enum": [
"review",
"acceptance"
]
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"next_action": {
"additionalProperties": false,
"properties": {
"instruction": {
"maxLength": 300,
"type": "string"
},
"operation": {
"const": "set_budget"
},
"tool": {
"const": "update_recipe_build"
}
},
"required": [
"tool",
"operation",
"instruction"
],
"type": "object"
},
"outcome": {
"const": "quoted"
},
"planned_fan_out": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"remaining_build_budget": {
"description": "Unspent and unreserved cumulative authority in the active grant for this build revision; zero before redemption.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"unsupported_nodes": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
}
},
"required": [
"outcome",
"kind",
"max_credits",
"available_credits",
"remaining_build_budget",
"budget_capability",
"expires_at",
"budget_state",
"next_action"
],
"type": "object"
},
{
"properties": {
"acceptance_cost": {
"additionalProperties": false,
"properties": {
"approval_cap_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"basis": {
"const": "enforced_input_bytes_and_output_caps"
},
"cap_policy": {
"maxLength": 120,
"type": "string"
},
"case_count": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"cases": {
"items": {
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"type": "string"
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"attempt_allowance": {
"minimum": 1,
"type": "integer"
},
"input_basis": {
"enum": [
"acceptance_message_fence",
"acceptance_schema_context_fallback"
]
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"provider_floor_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"model",
"input_basis",
"input_token_bound",
"output_token_cap",
"attempt_allowance",
"provider_floor_credits"
],
"type": "object"
},
"maxItems": 2,
"type": "array"
}
},
"required": [
"case_id",
"max_credits",
"steps"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"expected_high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"forecast": {
"items": {
"additionalProperties": false,
"properties": {
"basis": {
"enum": [
"settled_same_revision_case",
"settled_same_revision",
"provider_usage_same_recipe_step",
"platform_model_usage",
"static_fraction",
"hard_bound"
]
},
"case_id": {
"maxLength": 64,
"type": "string"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"hard_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"case_id",
"expected_credits",
"high_credits",
"hard_credits",
"basis",
"sample_count"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"forecast_basis": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"maxProperties": 8,
"type": "object"
},
"hard_bound_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"note": {
"maxLength": 400,
"type": "string"
},
"observed_case_costs": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"basis": {
"const": "recent_settled_cases_same_revision_not_a_forecast"
},
"maximum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"minimum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"sample_count",
"minimum_credits",
"maximum_credits",
"basis"
],
"type": "object"
}
]
}
},
"required": [
"basis",
"case_count",
"cases",
"note"
],
"type": "object"
},
"available_credits": {
"description": "Wallet funds currently available, independent of this build approval.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"budget_capability": {
"not": {}
},
"budget_state": {
"enum": [
"not_redeemed",
"active"
]
},
"expires_at": {
"not": {}
},
"handoff_requirement_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"handoff_requirements": {
"description": "Bounded quote preview. When incomplete, full acceptance creates the handoff with complete effects and resource requirements for approval.",
"items": {
"additionalProperties": false,
"properties": {
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"handoff_requirements_complete": {
"type": "boolean"
},
"kind": {
"enum": [
"review",
"acceptance"
]
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"next_action": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"instruction": {
"maxLength": 300,
"type": "string"
},
"mode": {
"const": "execute"
},
"tool": {
"const": "review_recipe_build"
}
},
"required": [
"tool",
"mode",
"instruction"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"instruction": {
"maxLength": 300,
"type": "string"
},
"mode": {
"const": "full"
},
"tool": {
"const": "run_recipe_acceptance"
}
},
"required": [
"tool",
"mode",
"instruction"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_ids": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"instruction": {
"maxLength": 300,
"type": "string"
},
"mode": {
"const": "selected_cases"
},
"tool": {
"const": "run_recipe_acceptance"
}
},
"required": [
"tool",
"mode",
"case_ids",
"instruction"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"instruction": {
"maxLength": 300,
"type": "string"
},
"tool": {
"const": "get_recipe_build_activity"
}
},
"required": [
"tool",
"activity_ref",
"instruction"
],
"type": "object"
}
]
},
"outcome": {
"const": "quoted"
},
"planned_fan_out": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"remaining_build_budget": {
"description": "Unspent and unreserved cumulative authority in the active grant for this build revision; zero before redemption.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"unsupported_nodes": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
}
},
"required": [
"outcome",
"kind",
"max_credits",
"available_credits",
"remaining_build_budget",
"budget_state",
"next_action"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"fan_out": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"outcome": {
"const": "queued"
},
"poll_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"state": {
"const": "queued"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"outcome",
"activity_ref",
"state",
"revision",
"poll_after_seconds"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"handoff": {
"additionalProperties": false,
"properties": {
"action_url": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"effect_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"effects": {
"items": {
"additionalProperties": false,
"properties": {
"details": {
"additionalProperties": false,
"properties": {
"additional_text": {},
"body_template": {},
"child_recipe_ulid": {},
"child_revision_sha": {},
"destination_mode": {},
"duration": {},
"external_conflict_mode": {},
"external_target_ulid": {},
"filename": {},
"folder_name": {},
"folder_ulid": {},
"format": {},
"html_only": {},
"input_mapping": {},
"local_conflict_mode": {},
"max_chunks": {},
"name": {},
"nested_effects": {},
"options": {},
"outcome_description": {},
"outcome_max_iterations": {},
"outcome_rubric": {},
"output_conflict_mode": {},
"params": {},
"pin_revision": {},
"preamble_enabled": {},
"prompt": {},
"query": {},
"score_threshold": {},
"source": {},
"sources": {},
"subject": {},
"system_message": {},
"title": {},
"to": {},
"tool_groups": {},
"top_k": {},
"visibility": {}
},
"required": [],
"type": "object"
},
"execution_count": {
"minimum": 0,
"type": "integer"
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"node_id",
"node_type",
"execution_count",
"details"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"reason": {
"maxLength": 500,
"type": "string"
},
"required_decisions": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 100,
"type": "array",
"uniqueItems": true
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"binding_status": {
"enum": [
"required",
"bound"
]
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest",
"binding_status"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"resume": {
"additionalProperties": false,
"properties": {
"operation": {
"const": "resume_activity"
},
"tool": {
"const": "update_recipe_build"
}
},
"required": [
"tool",
"operation"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"pending",
"approved",
"cancelled",
"expired",
"consumed"
]
}
},
"required": [
"handoff_ref",
"activity_ref",
"revision",
"status",
"effect_digest",
"reason",
"required_decisions",
"effects",
"expires_at",
"action_url",
"resume"
],
"type": "object"
},
"outcome": {
"const": "supervised_required"
},
"qualification_route": {
"const": "supervised"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"state": {
"const": "blocked"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"outcome",
"activity_ref",
"state",
"revision",
"qualification_route",
"handoff"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Estimate or run a previewed public or account-authorized published recipe. dry_run returns history (credits charged by past runs of this recipe), fees, your balance, and estimated_credits, a theoretical worst case. If credits run out during a run, it pauses and can be resumed after adding credits. On recipe_ref_expired, search or preview again and retry.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"dry_run": {
"type": "boolean"
},
"idempotency_key": {
"maxLength": 200,
"minLength": 1,
"pattern": "^[\\x20-\\x7E]+$",
"type": "string"
},
"inputs": {
"additionalProperties": {
"type": "string"
},
"maxProperties": 50,
"propertyNames": {
"pattern": "^input_[1-9][0-9]*$"
},
"type": "object"
},
"recipe_ref": {
"maxLength": 32768,
"type": "string"
}
},
"required": [
"recipe_ref",
"inputs",
"idempotency_key"
],
"type": "object"
},
"name": "run_recipe",
"outputSchema": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"available_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"balance_as_of": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"ceiling_explanation": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "current_effective_rates_and_runtime_bounds"
},
"details_limited": {
"type": "boolean"
},
"meaning": {
"maxLength": 500,
"type": "string"
},
"provider_floors": {
"items": {
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"meaning",
"basis",
"provider_floors",
"details_limited"
],
"type": "object"
},
"estimate_basis": {
"const": "conservative_input_aware"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"execution_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"fee_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"historical_comparison": {
"enum": [
"lower",
"same",
"higher",
"unknown"
]
},
"historical_credit_band": {
"enum": [
"unknown",
"free",
"0_to_10",
"10_to_100",
"over_100"
]
},
"history": {
"additionalProperties": false,
"description": "Credits charged by past successful runs of this recipe's current version. With fewer than three runs, statistics are null and recent_charges lists the actual charges.",
"properties": {
"average_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"failed_runs": {
"minimum": 0,
"type": "integer"
},
"last_run_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"median_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"p90_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"recent_charges": {
"description": "Actual charges of the one or two runs when there are too few for statistics.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"successful_runs": {
"minimum": 0,
"type": "integer"
},
"window_days": {
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"required": [
"successful_runs",
"failed_runs",
"average_credits",
"median_credits",
"p90_credits",
"last_run_at",
"window_days",
"recent_charges"
],
"type": "object"
},
"input_token_floor": {
"minimum": 1,
"type": "integer"
},
"marketplace_fee_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"outcome": {
"const": "estimated"
},
"pricing_warning": {
"maxLength": 240,
"type": [
"string",
"null"
]
},
"sufficient": {
"type": "boolean"
}
},
"required": [
"outcome",
"execution_credits",
"marketplace_fee_credits",
"estimated_credits",
"available_credits",
"sufficient",
"estimate_basis",
"input_token_floor",
"historical_credit_band",
"historical_comparison",
"pricing_warning"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"history": {
"additionalProperties": false,
"description": "Credits charged by past successful runs of this recipe's current version. With fewer than three runs, statistics are null and recent_charges lists the actual charges.",
"properties": {
"average_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"failed_runs": {
"minimum": 0,
"type": "integer"
},
"last_run_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"median_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"p90_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"recent_charges": {
"description": "Actual charges of the one or two runs when there are too few for statistics.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"successful_runs": {
"minimum": 0,
"type": "integer"
},
"window_days": {
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"required": [
"successful_runs",
"failed_runs",
"average_credits",
"median_credits",
"p90_credits",
"last_run_at",
"window_days",
"recent_charges"
],
"type": "object"
},
"outcome": {
"const": "started"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"const": "queued"
}
},
"required": [
"outcome",
"run_id",
"status",
"estimated_credits"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"outcome": {
"const": "replayed"
},
"run_id": {
"maxLength": 26,
"minLength": 26,
"pattern": "^[0-9A-Za-z]{26}$",
"type": "string"
},
"status": {
"enum": [
"queued",
"running",
"done",
"failed",
"cancelled",
"blocked"
]
}
},
"required": [
"outcome",
"run_id",
"status"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "recipe_unavailable"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "run_unavailable"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "account_unavailable"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "invalid_inputs"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "idempotency_conflict"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "idempotency_unavailable"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "run_limit"
}
},
"required": [
"error"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "rate_limited"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
}
},
"required": [
"error",
"retry_after_seconds"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"available_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"error": {
"const": "insufficient_credits"
},
"required_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
}
},
"required": [
"error",
"required_credits",
"available_credits"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "recipe_ref_expired"
},
"hint": {
"maxLength": 240,
"type": "string"
}
},
"required": [
"error",
"hint"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "invalid_inputs"
},
"issues": {
"items": {
"additionalProperties": false,
"properties": {
"code": {
"enum": [
"required",
"blank",
"invalid_type",
"unknown_handle",
"too_many_inputs",
"max_characters",
"max_value_utf8_bytes",
"max_total_utf8_bytes"
]
},
"hint": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"limit": {
"minimum": 1,
"type": "integer"
},
"message": {
"maxLength": 160,
"minLength": 1,
"type": "string"
},
"path": {
"maxLength": 32,
"pattern": "^inputs(?:\\.input_[1-9][0-9]*)?$",
"type": "string"
},
"received": {
"additionalProperties": false,
"properties": {
"characters": {
"minimum": 0,
"type": "integer"
},
"item_count": {
"minimum": 0,
"type": "integer"
},
"type": {
"enum": [
"missing",
"null",
"boolean",
"integer",
"number",
"string",
"array",
"object",
"other"
]
},
"utf8_bytes": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"path",
"code",
"message",
"hint"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
}
},
"required": [
"error",
"issues"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "run_unavailable"
},
"message": {
"maxLength": 240,
"type": "string"
},
"next_action": {
"maxLength": 240,
"type": "string"
},
"reason": {
"enum": [
"recipe_validation_failed",
"recipe_step_policy_restricted",
"recipe_fee_configuration_invalid",
"invalid_credit_evidence",
"admission_inconsistent",
"configuration_unavailable"
]
}
},
"required": [
"error",
"reason",
"message",
"next_action"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"const": "pricing_unavailable"
},
"message": {
"maxLength": 240,
"type": "string"
},
"next_action": {
"additionalProperties": false,
"properties": {
"action": {
"const": "choose_another_recipe"
},
"reason": {
"maxLength": 240,
"type": "string"
},
"tool": {
"const": "search_recipes"
}
},
"required": [
"tool",
"action",
"reason"
],
"type": "object"
}
},
"required": [
"error",
"message",
"next_action"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Quote or run selected or complete behavioral acceptance cases for an exact private draft revision. Quotes explain enforced input bounds, output caps and retry allowances in acceptance_cost. Preserve representative fixtures and assertions; remove unnecessary model stages rather than weakening tests to lower a quote. Paid work requires an approved budget. A full run that needs user approval returns supervised_required before any case, reservation, or external effect; first bind every returned required resource with update_recipe_build bind_resource, then open action_url for user approval, and finally resume the same activity with update_recipe_build resume_activity.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"case_ids": {
"description": "Required for selected_cases, optional for quote, forbidden for full.",
"items": {
"maxLength": 64,
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"idempotency_key": {
"maxLength": 200,
"minLength": 1,
"pattern": "^[\\x20-\\x7e]+$",
"type": "string"
},
"mode": {
"enum": [
"quote",
"selected_cases",
"full"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"build_ref",
"revision",
"mode",
"idempotency_key"
],
"type": "object"
},
"name": "run_recipe_acceptance",
"outputSchema": {
"oneOf": [
{
"properties": {
"acceptance_cost": {
"additionalProperties": false,
"properties": {
"approval_cap_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"basis": {
"const": "enforced_input_bytes_and_output_caps"
},
"cap_policy": {
"maxLength": 120,
"type": "string"
},
"case_count": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"cases": {
"items": {
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"type": "string"
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"attempt_allowance": {
"minimum": 1,
"type": "integer"
},
"input_basis": {
"enum": [
"acceptance_message_fence",
"acceptance_schema_context_fallback"
]
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"provider_floor_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"model",
"input_basis",
"input_token_bound",
"output_token_cap",
"attempt_allowance",
"provider_floor_credits"
],
"type": "object"
},
"maxItems": 2,
"type": "array"
}
},
"required": [
"case_id",
"max_credits",
"steps"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"expected_high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"forecast": {
"items": {
"additionalProperties": false,
"properties": {
"basis": {
"enum": [
"settled_same_revision_case",
"settled_same_revision",
"provider_usage_same_recipe_step",
"platform_model_usage",
"static_fraction",
"hard_bound"
]
},
"case_id": {
"maxLength": 64,
"type": "string"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"hard_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"case_id",
"expected_credits",
"high_credits",
"hard_credits",
"basis",
"sample_count"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"forecast_basis": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"maxProperties": 8,
"type": "object"
},
"hard_bound_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"note": {
"maxLength": 400,
"type": "string"
},
"observed_case_costs": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"basis": {
"const": "recent_settled_cases_same_revision_not_a_forecast"
},
"maximum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"minimum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"sample_count",
"minimum_credits",
"maximum_credits",
"basis"
],
"type": "object"
}
]
}
},
"required": [
"basis",
"case_count",
"cases",
"note"
],
"type": "object"
},
"available_credits": {
"description": "Wallet funds currently available, independent of this build approval.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"budget_capability": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"budget_state": {
"enum": [
"not_redeemed",
"active"
]
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"handoff_requirement_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"handoff_requirements": {
"description": "Bounded quote preview. When incomplete, full acceptance creates the handoff with complete effects and resource requirements for approval.",
"items": {
"additionalProperties": false,
"properties": {
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"handoff_requirements_complete": {
"type": "boolean"
},
"kind": {
"enum": [
"review",
"acceptance"
]
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"next_action": {
"additionalProperties": false,
"properties": {
"instruction": {
"maxLength": 300,
"type": "string"
},
"operation": {
"const": "set_budget"
},
"tool": {
"const": "update_recipe_build"
}
},
"required": [
"tool",
"operation",
"instruction"
],
"type": "object"
},
"outcome": {
"const": "quoted"
},
"planned_fan_out": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"remaining_build_budget": {
"description": "Unspent and unreserved cumulative authority in the active grant for this build revision; zero before redemption.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"unsupported_nodes": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
}
},
"required": [
"outcome",
"kind",
"max_credits",
"available_credits",
"remaining_build_budget",
"budget_capability",
"expires_at",
"budget_state",
"next_action"
],
"type": "object"
},
{
"properties": {
"acceptance_cost": {
"additionalProperties": false,
"properties": {
"approval_cap_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"basis": {
"const": "enforced_input_bytes_and_output_caps"
},
"cap_policy": {
"maxLength": 120,
"type": "string"
},
"case_count": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"cases": {
"items": {
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"type": "string"
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"steps": {
"items": {
"additionalProperties": false,
"properties": {
"attempt_allowance": {
"minimum": 1,
"type": "integer"
},
"input_basis": {
"enum": [
"acceptance_message_fence",
"acceptance_schema_context_fallback"
]
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"provider_floor_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"step_id": {
"maxLength": 128,
"type": "string"
}
},
"required": [
"step_id",
"model",
"input_basis",
"input_token_bound",
"output_token_cap",
"attempt_allowance",
"provider_floor_credits"
],
"type": "object"
},
"maxItems": 2,
"type": "array"
}
},
"required": [
"case_id",
"max_credits",
"steps"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"expected_high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"forecast": {
"items": {
"additionalProperties": false,
"properties": {
"basis": {
"enum": [
"settled_same_revision_case",
"settled_same_revision",
"provider_usage_same_recipe_step",
"platform_model_usage",
"static_fraction",
"hard_bound"
]
},
"case_id": {
"maxLength": 64,
"type": "string"
},
"expected_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"hard_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"high_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"case_id",
"expected_credits",
"high_credits",
"hard_credits",
"basis",
"sample_count"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"forecast_basis": {
"additionalProperties": {
"minimum": 0,
"type": "integer"
},
"maxProperties": 8,
"type": "object"
},
"hard_bound_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"note": {
"maxLength": 400,
"type": "string"
},
"observed_case_costs": {
"anyOf": [
{
"type": "null"
},
{
"additionalProperties": false,
"properties": {
"basis": {
"const": "recent_settled_cases_same_revision_not_a_forecast"
},
"maximum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"minimum_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"sample_count": {
"maximum": 20,
"minimum": 1,
"type": "integer"
}
},
"required": [
"sample_count",
"minimum_credits",
"maximum_credits",
"basis"
],
"type": "object"
}
]
}
},
"required": [
"basis",
"case_count",
"cases",
"note"
],
"type": "object"
},
"available_credits": {
"description": "Wallet funds currently available, independent of this build approval.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"budget_capability": {
"not": {}
},
"budget_state": {
"enum": [
"not_redeemed",
"active"
]
},
"expires_at": {
"not": {}
},
"handoff_requirement_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"handoff_requirements": {
"description": "Bounded quote preview. When incomplete, full acceptance creates the handoff with complete effects and resource requirements for approval.",
"items": {
"additionalProperties": false,
"properties": {
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"handoff_requirements_complete": {
"type": "boolean"
},
"kind": {
"enum": [
"review",
"acceptance"
]
},
"max_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"next_action": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"instruction": {
"maxLength": 300,
"type": "string"
},
"mode": {
"const": "execute"
},
"tool": {
"const": "review_recipe_build"
}
},
"required": [
"tool",
"mode",
"instruction"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"instruction": {
"maxLength": 300,
"type": "string"
},
"mode": {
"const": "full"
},
"tool": {
"const": "run_recipe_acceptance"
}
},
"required": [
"tool",
"mode",
"instruction"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_ids": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 50,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"instruction": {
"maxLength": 300,
"type": "string"
},
"mode": {
"const": "selected_cases"
},
"tool": {
"const": "run_recipe_acceptance"
}
},
"required": [
"tool",
"mode",
"case_ids",
"instruction"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"instruction": {
"maxLength": 300,
"type": "string"
},
"tool": {
"const": "get_recipe_build_activity"
}
},
"required": [
"tool",
"activity_ref",
"instruction"
],
"type": "object"
}
]
},
"outcome": {
"const": "quoted"
},
"planned_fan_out": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"qualification_route": {
"enum": [
"automatic",
"conditional",
"supervised"
]
},
"remaining_build_budget": {
"description": "Unspent and unreserved cumulative authority in the active grant for this build revision; zero before redemption.",
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"unsupported_nodes": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
}
},
"required": [
"outcome",
"kind",
"max_credits",
"available_credits",
"remaining_build_budget",
"budget_state",
"next_action"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"fan_out": {
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"outcome": {
"const": "queued"
},
"poll_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"state": {
"const": "queued"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"outcome",
"activity_ref",
"state",
"revision",
"poll_after_seconds"
],
"type": "object"
},
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"handoff": {
"additionalProperties": false,
"properties": {
"action_url": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"effect_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"effects": {
"items": {
"additionalProperties": false,
"properties": {
"details": {
"additionalProperties": false,
"properties": {
"additional_text": {},
"body_template": {},
"child_recipe_ulid": {},
"child_revision_sha": {},
"destination_mode": {},
"duration": {},
"external_conflict_mode": {},
"external_target_ulid": {},
"filename": {},
"folder_name": {},
"folder_ulid": {},
"format": {},
"html_only": {},
"input_mapping": {},
"local_conflict_mode": {},
"max_chunks": {},
"name": {},
"nested_effects": {},
"options": {},
"outcome_description": {},
"outcome_max_iterations": {},
"outcome_rubric": {},
"output_conflict_mode": {},
"params": {},
"pin_revision": {},
"preamble_enabled": {},
"prompt": {},
"query": {},
"score_threshold": {},
"source": {},
"sources": {},
"subject": {},
"system_message": {},
"title": {},
"to": {},
"tool_groups": {},
"top_k": {},
"visibility": {}
},
"required": [],
"type": "object"
},
"execution_count": {
"minimum": 0,
"type": "integer"
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"node_id",
"node_type",
"execution_count",
"details"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"reason": {
"maxLength": 500,
"type": "string"
},
"required_decisions": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 100,
"type": "array",
"uniqueItems": true
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"binding_status": {
"enum": [
"required",
"bound"
]
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest",
"binding_status"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"resume": {
"additionalProperties": false,
"properties": {
"operation": {
"const": "resume_activity"
},
"tool": {
"const": "update_recipe_build"
}
},
"required": [
"tool",
"operation"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"pending",
"approved",
"cancelled",
"expired",
"consumed"
]
}
},
"required": [
"handoff_ref",
"activity_ref",
"revision",
"status",
"effect_digest",
"reason",
"required_decisions",
"effects",
"expires_at",
"action_url",
"resume"
],
"type": "object"
},
"outcome": {
"const": "supervised_required"
},
"qualification_route": {
"const": "supervised"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"state": {
"const": "blocked"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"outcome",
"activity_ref",
"state",
"revision",
"qualification_route",
"handoff"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Find safe public recipes and published recipes available to the current account. results are direct fits (exact or strong); related_results are adjacent recipes, not direct fits. Each row states its output contract, past-run cost history and, for reviewed public recipes, that safety review is not output-quality validation. required_inputs and required_outputs match exact handles or normalized labels, never meanings. When paging.has_more is true, repeat the identical call with cursor=next_cursor.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"cursor": {
"description": "next_cursor from the previous page of the identical query and filters. Omit for the first page.",
"pattern": "^[0-9]{1,2}$",
"type": "string"
},
"query": {
"description": "At least 3 non-padding characters, up to 2000. Name the task in a few words; add constraints as required_inputs or required_outputs; follow next_cursor when results are cut.",
"maxLength": 2000,
"minLength": 3,
"type": "string"
},
"required_inputs": {
"description": "Exact normalized handle/label matching, not semantic meaning; inspect filter_diagnostics for available labels.",
"items": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"type": "array",
"uniqueItems": true
},
"required_outputs": {
"description": "Exact normalized handle/label matching, not semantic meaning; filters are never weakened automatically.",
"items": {
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"maxItems": 20,
"type": "array",
"uniqueItems": true
},
"runnable_only": {
"type": "boolean"
},
"sources": {
"description": "When omitted, search public recipes and any library lanes authorized by this connection. Explicit private lanes require recipes:read permission.",
"items": {
"enum": [
"public",
"owned",
"organization",
"shared"
]
},
"maxItems": 4,
"minItems": 1,
"type": "array",
"uniqueItems": true
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_recipes",
"outputSchema": {
"oneOf": [
{
"properties": {
"candidate_counts": {
"additionalProperties": false,
"description": "Counts over the bounded ranked pool, not the whole catalogue.",
"properties": {
"related": {
"minimum": 0,
"type": "integer"
},
"returned": {
"minimum": 0,
"type": "integer"
},
"suitable": {
"description": "Suitable candidates within the ranked pool of at most 25; a value near 25 means more may exist.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"suitable",
"related",
"returned"
],
"type": "object"
},
"excluded_candidates": {
"additionalProperties": false,
"properties": {
"awaiting_review_binding": {
"minimum": 1,
"type": "integer"
},
"guidance": {
"maxLength": 240,
"type": "string"
}
},
"required": [
"awaiting_review_binding",
"guidance"
],
"type": "object"
},
"filter_diagnostics": {
"additionalProperties": false,
"properties": {
"available_inputs": {
"items": {
"maxLength": 100,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"available_outputs": {
"items": {
"maxLength": 100,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"labels_note": {
"maxLength": 240,
"type": "string"
},
"labels_truncated": {
"type": "boolean"
},
"matching": {
"const": "normalized_handles_or_labels_not_meanings"
},
"rejected_candidate_count": {
"minimum": 0,
"type": "integer"
},
"required_inputs": {
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"required_outputs": {
"items": {
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"matching",
"required_inputs",
"required_outputs",
"rejected_candidate_count",
"available_inputs",
"available_outputs",
"labels_truncated"
],
"type": "object"
},
"match_status": {
"enum": [
"matches",
"no_suitable_match"
]
},
"next_action": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"list_recent_builds",
"review_requirements"
]
},
"reason": {
"maxLength": 240,
"type": "string"
},
"tool": {
"enum": [
"get_recipe_build",
"discover_stewai"
]
}
},
"required": [
"tool",
"action",
"reason"
],
"type": "object"
},
"next_cursor": {
"description": "Pass back as cursor with the identical query and filters to fetch the next page of suitable results; null on the last page.",
"maxLength": 2,
"type": [
"string",
"null"
]
},
"paging": {
"additionalProperties": false,
"properties": {
"has_more": {
"type": "boolean"
},
"how": {
"maxLength": 160,
"type": "string"
}
},
"required": [
"has_more",
"how"
],
"type": "object"
},
"related_results": {
"items": {
"additionalProperties": false,
"properties": {
"access": {
"additionalProperties": false,
"properties": {
"can_fork": {
"type": "boolean"
},
"can_run": {
"type": "boolean"
},
"can_view": {
"type": "boolean"
}
},
"required": [
"can_view",
"can_run",
"can_fork"
],
"type": "object"
},
"category": {
"maxLength": 100,
"type": "string"
},
"contracts": {
"additionalProperties": false,
"properties": {
"inputs": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"required": {
"description": "Declared required by the recipe; get_recipe_preview shows must_provide and default_available for the same handle.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"description"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"required": {
"description": "Declared required by the recipe; get_recipe_preview shows must_provide and default_available for the same handle.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"description"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs_undeclared": {
"type": "boolean"
}
},
"required": [
"inputs",
"outputs"
],
"type": "object"
},
"description": {
"maxLength": 500,
"type": "string"
},
"description_truncated": {
"type": "boolean"
},
"duration_band": {
"enum": [
"unknown",
"seconds",
"minutes",
"long"
]
},
"evidence": {
"additionalProperties": false,
"properties": {
"acceptance_case_count": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"last_qualified": {
"enum": [
"unknown",
"last_7_days",
"last_30_days",
"older"
]
},
"research_evidence_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"safety_review_state": {
"enum": [
"unreviewed",
"pending_attestation",
"pending_review",
"approved",
"rejected",
"revision_requested",
"delisted",
"suspended"
]
}
},
"required": [
"research_evidence_count",
"acceptance_case_count",
"last_qualified",
"safety_review_state"
],
"type": "object"
},
"evidence_note": {
"maxLength": 240,
"type": [
"string",
"null"
]
},
"history": {
"additionalProperties": false,
"description": "Credits charged by past successful runs of this recipe's current version. With fewer than three runs, statistics are null and recent_charges lists the actual charges.",
"properties": {
"average_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"failed_runs": {
"minimum": 0,
"type": "integer"
},
"last_run_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"median_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"p90_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"recent_charges": {
"description": "Actual charges of the one or two runs when there are too few for statistics.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"successful_runs": {
"minimum": 0,
"type": "integer"
},
"window_days": {
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"required": [
"successful_runs",
"failed_runs",
"average_credits",
"median_credits",
"p90_credits",
"last_run_at",
"window_days",
"recent_charges"
],
"type": "object"
},
"match_quality": {
"description": "strong: the recipe's own title, description, tags or category contain at least two informative query words, or half of them, or the whole query verbatim; related: one word. Suitable rows are ordered exact, strong, then reviewed before unqualified.",
"enum": [
"exact",
"strong",
"related",
"unknown"
]
},
"matched_fields": {
"items": {
"maxLength": 100,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"output_contract_state": {
"description": "declared: stable output bindings; undeclared: the recipe declares no outputs even if its description promises some; unusable: outputs exist without a stable binding.",
"enum": [
"declared",
"undeclared",
"unusable"
]
},
"pricing": {
"additionalProperties": false,
"properties": {
"average_credits": {
"maxLength": 128,
"pattern": "^\\d+(?:\\.\\d+)?$",
"type": "string"
},
"basis": {
"const": "historical_average_successful_runs"
},
"creator_fee": {
"enum": [
"marketplace_policy",
"none"
]
},
"credit_band": {
"description": "Band of the average credits per successful run; unknown means no successful runs yet.",
"enum": [
"unknown",
"free",
"0_to_10",
"10_to_100",
"over_100"
]
},
"estimate_requires_dry_run": {
"const": true
}
},
"required": [
"basis",
"credit_band",
"estimate_requires_dry_run",
"creator_fee"
],
"type": "object"
},
"qualification": {
"enum": [
"public_reviewed",
"authoring_qualified",
"published_unqualified",
"unknown"
]
},
"rating": {
"additionalProperties": false,
"properties": {
"average": {
"type": [
"number",
"null"
]
},
"count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
"recipe_ref": {
"maxLength": 32768,
"type": "string"
},
"source": {
"enum": [
"public",
"owned",
"organization",
"shared"
]
},
"state": {
"const": "published"
},
"title": {
"maxLength": 200,
"type": "string"
},
"visibility": {
"enum": [
"private",
"shared",
"public_open",
"public_opaque"
]
}
},
"required": [
"title",
"description",
"description_truncated",
"category",
"visibility",
"pricing",
"duration_band",
"rating",
"recipe_ref",
"source",
"access",
"state",
"qualification",
"contracts",
"evidence"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
},
"related_results_guidance": {
"maxLength": 240,
"type": "string"
},
"results": {
"items": {
"additionalProperties": false,
"properties": {
"access": {
"additionalProperties": false,
"properties": {
"can_fork": {
"type": "boolean"
},
"can_run": {
"type": "boolean"
},
"can_view": {
"type": "boolean"
}
},
"required": [
"can_view",
"can_run",
"can_fork"
],
"type": "object"
},
"category": {
"maxLength": 100,
"type": "string"
},
"contracts": {
"additionalProperties": false,
"properties": {
"inputs": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"required": {
"description": "Declared required by the recipe; get_recipe_preview shows must_provide and default_available for the same handle.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"description"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 100,
"type": "string"
},
"required": {
"description": "Declared required by the recipe; get_recipe_preview shows must_provide and default_available for the same handle.",
"type": "boolean"
}
},
"required": [
"handle",
"label",
"required",
"description"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"outputs_undeclared": {
"type": "boolean"
}
},
"required": [
"inputs",
"outputs"
],
"type": "object"
},
"description": {
"maxLength": 500,
"type": "string"
},
"description_truncated": {
"type": "boolean"
},
"duration_band": {
"enum": [
"unknown",
"seconds",
"minutes",
"long"
]
},
"evidence": {
"additionalProperties": false,
"properties": {
"acceptance_case_count": {
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"last_qualified": {
"enum": [
"unknown",
"last_7_days",
"last_30_days",
"older"
]
},
"research_evidence_count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"safety_review_state": {
"enum": [
"unreviewed",
"pending_attestation",
"pending_review",
"approved",
"rejected",
"revision_requested",
"delisted",
"suspended"
]
}
},
"required": [
"research_evidence_count",
"acceptance_case_count",
"last_qualified",
"safety_review_state"
],
"type": "object"
},
"evidence_note": {
"maxLength": 240,
"type": [
"string",
"null"
]
},
"history": {
"additionalProperties": false,
"description": "Credits charged by past successful runs of this recipe's current version. With fewer than three runs, statistics are null and recent_charges lists the actual charges.",
"properties": {
"average_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"failed_runs": {
"minimum": 0,
"type": "integer"
},
"last_run_at": {
"maxLength": 40,
"type": [
"string",
"null"
]
},
"median_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"p90_credits": {
"maxLength": 32,
"type": [
"string",
"null"
]
},
"recent_charges": {
"description": "Actual charges of the one or two runs when there are too few for statistics.",
"items": {
"maxLength": 32,
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"successful_runs": {
"minimum": 0,
"type": "integer"
},
"window_days": {
"minimum": 1,
"type": [
"integer",
"null"
]
}
},
"required": [
"successful_runs",
"failed_runs",
"average_credits",
"median_credits",
"p90_credits",
"last_run_at",
"window_days",
"recent_charges"
],
"type": "object"
},
"match_quality": {
"description": "strong: the recipe's own title, description, tags or category contain at least two informative query words, or half of them, or the whole query verbatim; related: one word. Suitable rows are ordered exact, strong, then reviewed before unqualified.",
"enum": [
"exact",
"strong",
"related",
"unknown"
]
},
"matched_fields": {
"items": {
"maxLength": 100,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"output_contract_state": {
"description": "declared: stable output bindings; undeclared: the recipe declares no outputs even if its description promises some; unusable: outputs exist without a stable binding.",
"enum": [
"declared",
"undeclared",
"unusable"
]
},
"pricing": {
"additionalProperties": false,
"properties": {
"average_credits": {
"maxLength": 128,
"pattern": "^\\d+(?:\\.\\d+)?$",
"type": "string"
},
"basis": {
"const": "historical_average_successful_runs"
},
"creator_fee": {
"enum": [
"marketplace_policy",
"none"
]
},
"credit_band": {
"description": "Band of the average credits per successful run; unknown means no successful runs yet.",
"enum": [
"unknown",
"free",
"0_to_10",
"10_to_100",
"over_100"
]
},
"estimate_requires_dry_run": {
"const": true
}
},
"required": [
"basis",
"credit_band",
"estimate_requires_dry_run",
"creator_fee"
],
"type": "object"
},
"qualification": {
"enum": [
"public_reviewed",
"authoring_qualified",
"published_unqualified",
"unknown"
]
},
"rating": {
"additionalProperties": false,
"properties": {
"average": {
"type": [
"number",
"null"
]
},
"count": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"average",
"count"
],
"type": "object"
},
"recipe_ref": {
"maxLength": 32768,
"type": "string"
},
"source": {
"enum": [
"public",
"owned",
"organization",
"shared"
]
},
"state": {
"const": "published"
},
"title": {
"maxLength": 200,
"type": "string"
},
"visibility": {
"enum": [
"private",
"shared",
"public_open",
"public_opaque"
]
}
},
"required": [
"title",
"description",
"description_truncated",
"category",
"visibility",
"pricing",
"duration_band",
"rating",
"recipe_ref",
"source",
"access",
"state",
"qualification",
"contracts",
"evidence"
],
"type": "object"
},
"maxItems": 5,
"type": "array"
}
},
"required": [
"results",
"match_status"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"error": {
"enum": [
"invalid_query",
"rate_limited",
"search_unavailable"
],
"type": "string"
},
"field": {
"maxLength": 32,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"retry_after_seconds": {
"minimum": 1,
"type": "integer"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Create a private recipe build from a bounded intent and declared contract. Recipe inputs are strings: use type:string, positive maxLength, and only minLength:1 on required inputs. Richer input constraints must be handled in recipe logic and tested, not claimed as enforced by the input node. The response returns the stored contracts when they fit the bounded result; the archetype bundle is optional guidance, not the build contract. Optionally provide source_recipe_ref to adapt an owned recipe or a fully viewable public-open recipe into a new private draft.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"capabilities": {
"items": {
"enum": [
"research",
"extract",
"classify",
"summarize",
"transform",
"score",
"compare",
"route",
"render",
"reconcile"
]
},
"maxItems": 20,
"type": "array",
"uniqueItems": true
},
"idempotency_key": {
"maxLength": 200,
"minLength": 1,
"pattern": "^[\\x20-\\x7e]+$",
"type": "string"
},
"input_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"intent": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"output_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"const": true
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"quality_profile": {
"enum": [
"balanced",
"rigorous"
]
},
"research_policy": {
"enum": [
"forbidden",
"allowed",
"required"
]
},
"risk_domains": {
"items": {
"enum": [
"general",
"legal",
"financial",
"medical",
"employment",
"education",
"credit",
"insurance",
"public_services",
"safety",
"privacy",
"security"
]
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"source_recipe_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"intent",
"input_contract",
"output_contract",
"capabilities",
"risk_domains",
"quality_profile",
"research_policy",
"idempotency_key"
],
"type": "object"
},
"name": "start_recipe_build",
"outputSchema": {
"oneOf": [
{
"properties": {
"archetype_bundle_role": {
"const": "optional_guidance"
},
"budget_ceiling": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"contract_bundle": {
"additionalProperties": false,
"properties": {
"archetype": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"archetype_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"capabilities": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"node_kinds": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"summary": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"archetype_id",
"title",
"summary",
"capabilities",
"node_kinds"
],
"type": "object"
},
{
"type": "null"
}
]
},
"catalog_version": {
"maxLength": 64,
"type": "string"
},
"input_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"output_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"const": true
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"recipe_spec": {
"type": "object"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"catalog_version",
"archetype",
"input_contract",
"output_contract",
"recipe_spec"
],
"type": "object"
},
"contracts_in_response": {
"type": "boolean"
},
"dsl_version": {
"minimum": 2,
"type": "integer"
},
"editor_url": {
"maxLength": 512,
"type": "string"
},
"guidance_version": {
"maxLength": 64,
"type": "string"
},
"input_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"matched_archetypes": {
"items": {
"additionalProperties": false,
"properties": {
"archetype_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"capabilities": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"node_kinds": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 24,
"type": "array"
},
"summary": {
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"title": {
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"archetype_id",
"title",
"summary",
"capabilities",
"node_kinds"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
},
"minimum_acceptance_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"output_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"const": true
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"research_tier": {
"enum": [
"skipped",
"recommended",
"required"
]
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
},
"versions": {
"additionalProperties": false,
"properties": {
"archetypes": {
"maxLength": 64,
"type": "string"
},
"capabilities": {
"maxLength": 64,
"type": "string"
},
"checks": {
"maxLength": 64,
"type": "string"
},
"guidance": {
"maxLength": 64,
"type": "string"
},
"models": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"archetypes",
"capabilities",
"checks",
"guidance",
"models"
],
"type": "object"
}
},
"required": [
"build_ref",
"revision",
"contracts_in_response",
"editor_url",
"matched_archetypes",
"contract_bundle",
"archetype_bundle_role",
"research_tier",
"minimum_acceptance_categories",
"dsl_version",
"catalog_version",
"guidance_version",
"budget_ceiling"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
},
{
"description": "Apply bounded optimistic changes to an owned private recipe build. After an uncertain response, inspect the build and replay the identical request with the same idempotency key; a new key duplicates the work. Use only the exact op names and payload keys in inputSchema: set_metadata takes metadata, upsert_schema takes schema_id and schema, and acceptance uses set_acceptance_cases with suite. Never invent set_schema or set_acceptance_suite. If an op appears unknown, read get_recipe_build view='authoring_schema', schema_name='update_recipe_build'; read schema_name='acceptance_suite' for the complete suite shape and every assertion operator with its required, allowed and forbidden fields. Do not guess them. Use set_contracts to replace the declared executable input and output contracts; this changes the revision and invalidates qualification. For a supervised acceptance handoff, use bind_resource only to approve an exact selector already frozen in the draft, then resume_activity or cancel_activity with the returned opaque handoff and activity references. Each handoff control operation must be the only op in its request. An acceptance suite is {version:1,cases:[{case_id,label,kind,fixtures,assertions}]}. Each fixture is {target,content_type,value}. A minimal assertion is {assertion_id:'result_exists',type:'scalar',operator:'exists',path:'/result'}. JSON Pointer paths start with '/'. A metamorphic case also requires pair_with naming another case. Use a paired assertion such as {assertion_id:'stable',type:'paired',operator:'fields_unchanged',path:'',pair_case_id:'base',fields:['/summary']}; pair_case_id is not valid on a scalar assertion. Client transport recommendation, not a server limit: keep serialized tool arguments below 32 KiB including JSON escaping and the request envelope. For larger spec, suite, or research content use begin_chunk, ordered append_chunk (seq starts at 0), then commit_chunk. Keep each complete append request below 12 KiB; split text further after measuring escaped JSON bytes. Hash the exact assembled UTF-8 text with SHA-256. Begin/append do not change the revision; commit changes it once. After an uncertain response, inspect the build and replay the identical request with the same idempotency key; do not create duplicate work with a new key.",
"inputSchema": {
"additionalProperties": false,
"definitions": {
"expression": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "literal"
},
"value": {
"type": "number"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"const": "path"
},
"path": {
"maxLength": 256,
"type": "string"
}
},
"required": [
"kind",
"path"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"kind": {
"const": "case_path"
},
"path": {
"maxLength": 256,
"type": "string"
}
},
"required": [
"kind",
"case_id",
"path"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"expression": {
"$ref": "#/definitions/expression"
},
"kind": {
"enum": [
"count",
"sum"
]
}
},
"required": [
"kind",
"expression"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"add",
"subtract",
"multiply",
"divide"
]
},
"left": {
"$ref": "#/definitions/expression"
},
"right": {
"$ref": "#/definitions/expression"
}
},
"required": [
"kind",
"left",
"right"
],
"type": "object"
}
]
},
"field_mapping": {
"additionalProperties": false,
"properties": {
"pair_path": {
"maxLength": 256,
"type": "string"
},
"path": {
"maxLength": 256,
"type": "string"
}
},
"required": [
"path",
"pair_path"
],
"type": "object"
},
"scalar_predicate": {
"additionalProperties": false,
"properties": {
"expected": {},
"maximum": {
"type": "number"
},
"minimum": {
"type": "number"
},
"operator": {
"enum": [
"between",
"contains",
"equals",
"exists",
"glob",
"in_set",
"not_in_set",
"type_is"
]
},
"path": {
"maxLength": 256,
"type": "string"
},
"pattern": {
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"values": {
"maxItems": 200,
"type": "array"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"description": "Client transport recommendation, not a server limit: keep serialized tool arguments below 32 KiB including JSON escaping and the request envelope. For larger spec, suite, or research content use begin_chunk, ordered append_chunk (seq starts at 0), then commit_chunk. Keep each complete append request below 12 KiB; split text further after measuring escaped JSON bytes. Hash the exact assembled UTF-8 text with SHA-256. Begin/append do not change the revision; commit changes it once. After an uncertain response, inspect the build and replay the identical request with the same idempotency key; do not create duplicate work with a new key.",
"properties": {
"build_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"idempotency_key": {
"maxLength": 200,
"minLength": 1,
"pattern": "^[\\x20-\\x7e]+$",
"type": "string"
},
"ops": {
"items": {
"oneOf": [
{
"additionalProperties": false,
"properties": {
"op": {
"const": "replace_spec"
},
"spec": {
"type": "object"
}
},
"required": [
"op",
"spec"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"input_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"type": "boolean"
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
},
"op": {
"const": "set_contracts"
},
"output_contract": {
"additionalProperties": false,
"properties": {
"fields": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"maxLength": 500,
"type": "string"
},
"handle": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"required": {
"const": true
},
"schema": {
"maxProperties": 100,
"type": "object"
}
},
"required": [
"handle",
"label",
"description",
"required",
"schema"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"fields"
],
"type": "object"
}
},
"required": [
"op",
"input_contract",
"output_contract"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"metadata": {
"additionalProperties": false,
"properties": {
"$comment": {
"oneOf": [
{
"maxLength": 4096,
"type": "string"
},
{
"type": "object"
}
]
},
"$ui": {
"type": "object"
},
"description": {
"maxLength": 4096,
"type": "string"
},
"name": {
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [],
"type": "object"
},
"op": {
"const": "set_metadata"
}
},
"required": [
"op",
"metadata"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"node": {
"type": "object"
},
"op": {
"const": "upsert_node"
}
},
"required": [
"op",
"node"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"node_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"op": {
"const": "remove_node"
}
},
"required": [
"op",
"node_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"node_ids": {
"items": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"maxItems": 200,
"type": "array",
"uniqueItems": true
},
"op": {
"const": "reorder_nodes"
}
},
"required": [
"op",
"node_ids"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"op": {
"const": "upsert_schema"
},
"schema": {
"maxProperties": 100,
"type": "object"
},
"schema_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
}
},
"required": [
"op",
"schema_id",
"schema"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"op": {
"const": "remove_schema"
},
"schema_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
}
},
"required": [
"op",
"schema_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"op": {
"const": "set_acceptance_cases"
},
"suite": {
"additionalProperties": false,
"properties": {
"cases": {
"items": {
"additionalProperties": false,
"properties": {
"assertions": {
"items": {
"additionalProperties": false,
"allOf": [
{
"if": {
"properties": {
"type": {
"const": "classification"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"coverage_at_least",
"join_by_id",
"metric_at_least",
"no_critical_false_negative"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "collection"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"any",
"count_equals",
"covers_records",
"every",
"unique_by"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "coverage"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"branch_covered",
"enum_covered"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "html"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"escaped",
"well_formed"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "paired"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"fields_unchanged",
"mirror_changes",
"permutation_invariant",
"sensitivity_stable"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "quote_present"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"quote_present_in"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "reconcile"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"equals_computed",
"within_tolerance"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "scalar"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"between",
"contains",
"equals",
"exists",
"glob",
"in_set",
"not_in_set",
"type_is"
]
}
}
}
},
{
"if": {
"properties": {
"type": {
"const": "security"
}
},
"required": [
"type"
]
},
"then": {
"properties": {
"operator": {
"enum": [
"answer_not_leaked",
"injection_resisted"
]
}
}
}
}
],
"properties": {
"accepted_limitation": {
"description": "User-approved semantic limitation and reason for accepting it for supervised private use. Never invent approval. Failure remains visible but does not block this case.",
"maxLength": 500,
"minLength": 20,
"type": "string"
},
"actual_id_path": {
"maxLength": 256,
"type": "string"
},
"actual_label_path": {
"maxLength": 256,
"type": "string"
},
"assertion_id": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"critical_labels": {
"items": {
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"expected": {},
"expected_id_path": {
"maxLength": 256,
"type": "string"
},
"expected_label_path": {
"maxLength": 256,
"type": "string"
},
"expected_records": {
"maxItems": 200,
"type": "array"
},
"fields": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"fixture_target": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"fixture_targets": {
"items": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"maxItems": 20,
"type": "array"
},
"forbidden_literals": {
"items": {
"maxLength": 500,
"type": "string"
},
"maxItems": 50,
"type": "array"
},
"key_path": {
"maxLength": 256,
"type": "string"
},
"left": {
"$ref": "#/definitions/expression"
},
"mappings": {
"items": {
"$ref": "#/definitions/field_mapping"
},
"maxItems": 50,
"type": "array"
},
"maximum": {
"type": "number"
},
"message": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"metric": {
"enum": [
"accuracy",
"macro_precision",
"macro_recall",
"macro_f1"
]
},
"minimum": {
"type": "number"
},
"operator": {
"enum": [
"answer_not_leaked",
"any",
"between",
"branch_covered",
"contains",
"count_equals",
"coverage_at_least",
"covers_records",
"enum_covered",
"equals",
"equals_computed",
"escaped",
"every",
"exists",
"fields_unchanged",
"glob",
"in_set",
"injection_resisted",
"join_by_id",
"metric_at_least",
"mirror_changes",
"no_critical_false_negative",
"not_in_set",
"permutation_invariant",
"quote_present_in",
"sensitivity_stable",
"type_is",
"unique_by",
"well_formed",
"within_tolerance"
]
},
"pair_case_id": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"pair_path": {
"maxLength": 256,
"type": "string"
},
"path": {
"maxLength": 256,
"type": "string"
},
"pattern": {
"maxLength": 256,
"minLength": 1,
"type": "string"
},
"predicate": {
"$ref": "#/definitions/scalar_predicate"
},
"required_values": {
"maxItems": 200,
"type": "array"
},
"right": {
"$ref": "#/definitions/expression"
},
"threshold": {
"maximum": 1,
"minimum": 0,
"type": "number"
},
"tolerance": {
"minimum": 0,
"type": "number"
},
"type": {
"enum": [
"classification",
"collection",
"coverage",
"html",
"paired",
"quote_present",
"reconcile",
"scalar",
"security"
]
},
"values": {
"maxItems": 200,
"type": "array"
}
},
"required": [
"assertion_id",
"type",
"operator"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"case_id": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"expect_branch": {
"additionalProperties": false,
"properties": {
"path": {
"maxLength": 256,
"type": "string"
},
"value": {
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"path",
"value"
],
"type": "object"
},
"fixtures": {
"items": {
"additionalProperties": false,
"properties": {
"content_type": {
"enum": [
"application/json",
"text/plain"
]
},
"target": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
},
"value": {
"maxLength": 32768,
"type": "string"
}
},
"required": [
"target",
"content_type",
"value"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"kind": {
"enum": [
"adversarial",
"empty",
"injection",
"malformed",
"metamorphic",
"normal"
]
},
"label": {
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"pair_with": {
"pattern": "^[a-z0-9][a-z0-9_-]{0,63}$",
"type": "string"
}
},
"required": [
"case_id",
"label",
"kind",
"fixtures",
"assertions"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"version": {
"const": 1
}
},
"required": [
"version",
"cases"
],
"type": "object"
}
},
"required": [
"op",
"suite"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"evidence": {
"items": {
"additionalProperties": false,
"properties": {
"applicability": {
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"retrieved_at": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"supported_claim": {
"maxLength": 1000,
"minLength": 1,
"type": "string"
},
"title": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"url": {
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"url",
"title",
"retrieved_at",
"supported_claim",
"applicability"
],
"type": "object"
},
"maxItems": 20,
"type": "array"
},
"op": {
"const": "record_research"
}
},
"required": [
"op",
"evidence"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"budget_capability": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"op": {
"const": "set_budget"
}
},
"required": [
"op",
"budget_capability"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"op": {
"const": "bind_resource"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
}
},
"required": [
"op",
"handoff_ref",
"requirement_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"op": {
"const": "resume_activity"
}
},
"required": [
"op",
"handoff_ref",
"activity_ref"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"op": {
"const": "cancel_activity"
}
},
"required": [
"op",
"handoff_ref",
"activity_ref"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"op": {
"const": "restore"
}
},
"required": [
"op"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"chunk_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"op": {
"const": "begin_chunk"
}
},
"required": [
"op",
"chunk_id"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"chunk_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"op": {
"const": "append_chunk"
},
"seq": {
"maximum": 32767,
"minimum": 0,
"type": "integer"
},
"text": {
"maxLength": 49152,
"minLength": 1,
"type": "string"
}
},
"required": [
"op",
"chunk_id",
"seq",
"text"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"chunk_id": {
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_]{0,63}$",
"type": "string"
},
"op": {
"const": "commit_chunk"
},
"sha256": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"target": {
"enum": [
"replace_spec",
"set_acceptance_cases",
"record_research"
]
}
},
"required": [
"op",
"chunk_id",
"sha256",
"target"
],
"type": "object"
}
]
},
"maxItems": 25,
"minItems": 1,
"type": "array"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
}
},
"required": [
"build_ref",
"revision",
"idempotency_key",
"ops"
],
"type": "object"
},
"name": "update_recipe_build",
"outputSchema": {
"oneOf": [
{
"properties": {
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"activity_state": {
"enum": [
"queued",
"running",
"blocked",
"done",
"failed",
"cancelled"
]
},
"budget_superseded": {
"type": "boolean"
},
"findings": {
"maxItems": 0,
"type": "array"
},
"handoff": {
"additionalProperties": false,
"properties": {
"action_url": {
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"activity_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"effect_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"effects": {
"items": {
"additionalProperties": false,
"properties": {
"details": {
"additionalProperties": false,
"properties": {
"additional_text": {},
"body_template": {},
"child_recipe_ulid": {},
"child_revision_sha": {},
"destination_mode": {},
"duration": {},
"external_conflict_mode": {},
"external_target_ulid": {},
"filename": {},
"folder_name": {},
"folder_ulid": {},
"format": {},
"html_only": {},
"input_mapping": {},
"local_conflict_mode": {},
"max_chunks": {},
"name": {},
"nested_effects": {},
"options": {},
"outcome_description": {},
"outcome_max_iterations": {},
"outcome_rubric": {},
"output_conflict_mode": {},
"params": {},
"pin_revision": {},
"preamble_enabled": {},
"prompt": {},
"query": {},
"score_threshold": {},
"source": {},
"sources": {},
"subject": {},
"system_message": {},
"title": {},
"to": {},
"tool_groups": {},
"top_k": {},
"visibility": {}
},
"required": [],
"type": "object"
},
"execution_count": {
"minimum": 0,
"type": "integer"
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"node_id",
"node_type",
"execution_count",
"details"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"expires_at": {
"format": "date-time",
"maxLength": 64,
"type": "string"
},
"handoff_ref": {
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"reason": {
"maxLength": 500,
"type": "string"
},
"required_decisions": {
"items": {
"maxLength": 128,
"type": "string"
},
"maxItems": 100,
"type": "array",
"uniqueItems": true
},
"resources": {
"items": {
"additionalProperties": false,
"properties": {
"binding_status": {
"enum": [
"required",
"bound"
]
},
"node_id": {
"maxLength": 128,
"type": "string"
},
"node_path": {
"items": {
"type": [
"string",
"integer"
]
},
"maxItems": 32,
"type": "array"
},
"node_type": {
"maxLength": 64,
"type": "string"
},
"parameter_digest": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"qualification_route": {
"enum": [
"conditional",
"supervised"
]
},
"reason": {
"maxLength": 128,
"type": "string"
},
"required_decision": {
"maxLength": 128,
"type": "string"
},
"requirement_id": {
"pattern": "^[0-9a-f]{32}$",
"type": "string"
},
"resource_paths": {
"items": {
"maxLength": 256,
"type": "string"
},
"maxItems": 8,
"type": "array"
}
},
"required": [
"requirement_id",
"node_id",
"node_type",
"node_path",
"qualification_route",
"reason",
"required_decision",
"resource_paths",
"parameter_digest",
"binding_status"
],
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"resume": {
"additionalProperties": false,
"properties": {
"operation": {
"const": "resume_activity"
},
"tool": {
"const": "update_recipe_build"
}
},
"required": [
"tool",
"operation"
],
"type": "object"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"status": {
"enum": [
"pending",
"approved",
"cancelled",
"expired",
"consumed"
]
}
},
"required": [
"handoff_ref",
"activity_ref",
"revision",
"status",
"effect_digest",
"reason",
"required_decisions",
"effects",
"expires_at",
"action_url",
"resume"
],
"type": "object"
},
"normalization_diff": {
"items": {
"additionalProperties": false,
"properties": {
"changed": {
"type": "boolean"
},
"op": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"op",
"changed"
],
"type": "object"
},
"maxItems": 25,
"type": "array"
},
"outcome": {
"enum": [
"resource_bound",
"activity_resumed",
"activity_cancelled"
]
},
"qualification_invalidated": {
"type": "boolean"
},
"revision": {
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"revision",
"normalization_diff",
"findings",
"qualification_invalidated",
"budget_superseded"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"case_id": {
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"error": {
"enum": [
"not_found",
"invalid_reference",
"invalid_params",
"revision_conflict",
"idempotency_conflict",
"document_too_large",
"payload_too_large",
"chunk_sequence_invalid",
"chunk_digest_mismatch",
"chunk_expired",
"invalid_cursor",
"suite_duplicate_case_id",
"suite_unresolved_pair",
"suite_schema_invalid",
"suite_missing_categories",
"suite_weak_normal_oracle",
"suite_too_large",
"unknown_case_id",
"duplicate_case_id",
"incomplete_case_selection",
"unsupported_node_kind",
"research_required",
"review_required",
"acceptance_required",
"qualification_stale",
"budget_not_approved",
"budget_exhausted",
"budget_superseded",
"budget_capability_consumed",
"budget_capability_expired",
"acceptance_case_cost_exceeded",
"authoring_budget_exceeded",
"authoring_grant_not_active",
"insufficient_credits",
"billing_anomaly",
"activity_stalled",
"activity_in_flight",
"handoff_approval_required",
"handoff_expired",
"handoff_not_pending",
"handoff_stale",
"handoff_disclosure_incomplete",
"feature_unavailable",
"resource_unavailable",
"resource_binding_required",
"resource_requirement_not_found",
"activity_not_cancellable",
"quota_exceeded",
"rate_limited",
"already_published",
"safety_locked",
"build_terminal",
"commit_capability_expired",
"account_unavailable",
"limit_unavailable"
]
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"hint": {
"maxLength": 240,
"type": "string"
},
"issue": {
"additionalProperties": false,
"properties": {
"code": {
"maxLength": 64,
"type": "string"
},
"field": {
"maxLength": 64,
"type": "string"
},
"operator": {
"maxLength": 64,
"type": "string"
},
"path": {
"maxLength": 512,
"type": "string"
},
"type": {
"maxLength": 64,
"type": "string"
}
},
"required": [
"code",
"path"
],
"type": "object"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"missing_categories": {
"items": {
"maxLength": 64,
"type": "string"
},
"maxItems": 10,
"type": "array",
"uniqueItems": true
},
"repair_hint": {
"maxLength": 500,
"type": "string"
},
"retry_after_seconds": {
"maximum": 86400,
"minimum": 1,
"type": "integer"
},
"review_cost": {
"additionalProperties": false,
"properties": {
"basis": {
"const": "utf8_byte_upper_bound"
},
"estimated_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"input_token_bound": {
"minimum": 0,
"type": "integer"
},
"limit_credits": {
"maxLength": 64,
"pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
"type": "string"
},
"model": {
"maxLength": 200,
"type": "string"
},
"output_token_cap": {
"minimum": 0,
"type": "integer"
},
"prompt_bytes": {
"minimum": 0,
"type": "integer"
},
"provider": {
"maxLength": 200,
"type": "string"
},
"section_bytes": {
"additionalProperties": false,
"properties": {
"acceptance_suite": {
"minimum": 0,
"type": "integer"
},
"input_contract": {
"minimum": 0,
"type": "integer"
},
"intent": {
"minimum": 0,
"type": "integer"
},
"output_contract": {
"minimum": 0,
"type": "integer"
},
"research_evidence": {
"minimum": 0,
"type": "integer"
},
"spec": {
"minimum": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"required": [
"estimated_credits",
"limit_credits",
"provider",
"model",
"basis",
"input_token_bound",
"output_token_cap",
"prompt_bytes",
"section_bytes"
],
"type": "object"
},
"truncation": {
"additionalProperties": false,
"properties": {
"applied": {
"const": true
},
"omitted_items": {
"minimum": 0,
"type": "integer"
},
"original_result_bytes": {
"minimum": 1,
"type": "integer"
},
"reason": {
"const": "response_size_limit"
},
"truncated_values": {
"minimum": 0,
"type": "integer"
}
},
"required": [
"applied",
"reason",
"omitted_items",
"truncated_values",
"original_result_bytes"
],
"type": "object"
}
},
"required": [
"error"
],
"type": "object"
}
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:5a05426dbd70fa91363c645fb515c73995152333d448b6e16aa64d858880e1ae | sha256sum