review_recipe_buildQuote or run a bounded semantic quality review of the exact private draft revision.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| revision | Yes | ||
| build_ref | Yes | ||
| idempotency_key | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "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"
- },
- {
- "additionalProperties": false,
- "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_state": {
- "enum": [
- "not_redeemed",
- "active"
- ]
- },
- "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"
- },
- {
- "additionalProperties": false,
- "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"
- },
- {
- "additionalProperties": false,
- "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"
- }
-]New value: +[
+ {
+ "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"
+ }
+]Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "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"
- },
- {
- "additionalProperties": false,
- "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_state": {
- "enum": [
- "not_redeemed",
- "active"
- ]
- },
- "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"
- },
- {
- "additionalProperties": false,
- "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"
- },
- {
- "additionalProperties": false,
- "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",
- "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",
- "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"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "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"
+ },
+ {
+ "additionalProperties": false,
+ "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_state": {
+ "enum": [
+ "not_redeemed",
+ "active"
+ ]
+ },
+ "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"
+ },
+ {
+ "additionalProperties": false,
+ "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"
+ },
+ {
+ "additionalProperties": false,
+ "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"
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover idempotency and non-destructiveness, so the description only needed to add contextual behavior. It does add 'bounded' and 'exact private draft revision', which give some useful scoping beyond the annotations. However, it does not clarify what actually happens in 'quote' mode versus 'execute' mode, or whether executing a review writes any state to the revision.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no filler, and the primary mode distinction is front-loaded. It is appropriately concise, though the brevity comes at the cost of missing substantive guidance captured in other dimensions.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a four-parameter tool with zero schema description coverage, the description is too sparse. Although an output schema exists, the agent still lacks enough context to understand what quote vs. execute yields, what the idempotency key is for, or when this tool should be selected among twelve siblings. It is minimally viable at best.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description needed to explain the four required parameters. It only loosely covers 'revision' and 'build_ref' via 'exact private draft revision', and it merely echoes the 'mode' enum with 'Quote or run'. It provides no meaningful semantics for 'idempotency_key' and no parameter-level guidance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific action ('Quote or run') and a concrete scope ('a bounded semantic quality review of the exact private draft revision'). It is not a tautology and gives the agent a sense of what the tool operates on. However, it does not explicitly distinguish itself from sibling tools like 'check_recipe_build', and the phrase 'bounded semantic quality review' is somewhat jargon-heavy.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no explicit guidance on when to use this tool versus alternatives. Sibling names like 'check_recipe_build', 'commit_recipe_build', and 'update_recipe_build' suggest related workflows, but the description never says why an agent should choose 'review_recipe_build' over them. The only implicit context is that it targets a 'private draft revision'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.