commit_recipe_buildPreflight and privately publish only the exact fully qualified recipe revision.
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| revision | Yes | ||
| build_ref | Yes | ||
| idempotency_key | Yes | ||
| commit_capability | No | Required for commit; omit for preflight. |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "commit_capability": {
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "effects": {
- "items": {
- "enum": [
- "create_private_revision_1",
- "keep_recipe_unlisted",
- "keep_recipe_unreviewed"
- ]
- },
- "maxItems": 3,
- "minItems": 3,
- "type": "array"
- },
- "evidence": {
- "additionalProperties": false,
- "properties": {
- "acceptance": {
- "enum": [
- "full_suite_passed",
- "accepted_with_limitations"
- ]
- },
- "accepted_limitations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "acknowledgement": {
- "maxLength": 500,
- "type": "string"
- },
- "assertion_id": {
- "maxLength": 64,
- "type": "string"
- },
- "case_id": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "case_id",
- "assertion_id",
- "acknowledgement"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "billing": {
- "const": "settled"
- },
- "human_review_required": {
- "const": true
- },
- "research": {
- "enum": [
- "recorded",
- "not_required"
- ]
- },
- "review": {
- "const": "passed"
- },
- "revision": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- }
- },
- "required": [
- "revision",
- "review",
- "research",
- "acceptance",
- "billing"
- ],
- "type": "object"
- },
- "expires_in_seconds": {
- "maximum": 86400,
- "minimum": 1,
- "type": "integer"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- }
- },
- "required": [
- "commit_capability",
- "expires_in_seconds",
- "effects",
- "evidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "editor_url": {
- "maxLength": 512,
- "type": "string"
- },
- "evidence": {
- "additionalProperties": false,
- "properties": {
- "acceptance": {
- "enum": [
- "full_suite_passed",
- "accepted_with_limitations"
- ]
- },
- "accepted_limitations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "acknowledgement": {
- "maxLength": 500,
- "type": "string"
- },
- "assertion_id": {
- "maxLength": 64,
- "type": "string"
- },
- "case_id": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "case_id",
- "assertion_id",
- "acknowledgement"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "billing": {
- "const": "settled"
- },
- "human_review_required": {
- "const": true
- },
- "research": {
- "enum": [
- "recorded",
- "not_required"
- ]
- },
- "review": {
- "const": "passed"
- },
- "revision": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- }
- },
- "required": [
- "revision",
- "review",
- "research",
- "acceptance",
- "billing"
- ],
- "type": "object"
- },
- "listed": {
- "const": false
- },
- "recipe_ulid": {
- "maxLength": 26,
- "minLength": 1,
- "type": "string"
- },
- "rev": {
- "const": 1
- },
- "sha": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- },
- "visibility": {
- "const": "private"
- }
- },
- "required": [
- "recipe_ulid",
- "rev",
- "sha",
- "visibility",
- "listed",
- "editor_url"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "editor_url": {
- "maxLength": 512,
- "type": "string"
- },
- "evidence": {
- "additionalProperties": false,
- "properties": {
- "acceptance": {
- "enum": [
- "full_suite_passed",
- "accepted_with_limitations"
- ]
- },
- "accepted_limitations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "acknowledgement": {
- "maxLength": 500,
- "type": "string"
- },
- "assertion_id": {
- "maxLength": 64,
- "type": "string"
- },
- "case_id": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "case_id",
- "assertion_id",
- "acknowledgement"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "billing": {
- "const": "settled"
- },
- "human_review_required": {
- "const": true
- },
- "research": {
- "enum": [
- "recorded",
- "not_required"
- ]
- },
- "review": {
- "const": "passed"
- },
- "revision": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- }
- },
- "required": [
- "revision",
- "review",
- "research",
- "acceptance",
- "billing"
- ],
- "type": "object"
- },
- "listed": {
- "const": false
- },
- "next_action": {
- "const": "dry_run_recipe"
- },
- "recipe_ref": {
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "recipe_ulid": {
- "maxLength": 26,
- "minLength": 1,
- "type": "string"
- },
- "rev": {
- "const": 1
- },
- "runnable": {
- "type": "boolean"
- },
- "sha": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- },
- "visibility": {
- "const": "private"
- }
- },
- "required": [
- "recipe_ulid",
- "rev",
- "sha",
- "visibility",
- "listed",
- "editor_url",
- "recipe_ref",
- "runnable",
- "next_action"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "case_id": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- },
- "error": {
- "enum": [
- "not_found",
- "invalid_reference",
- "invalid_params",
- "revision_conflict",
- "idempotency_conflict",
- "document_too_large",
- "payload_too_large",
- "chunk_sequence_invalid",
- "chunk_digest_mismatch",
- "chunk_expired",
- "invalid_cursor",
- "suite_duplicate_case_id",
- "suite_unresolved_pair",
- "suite_schema_invalid",
- "suite_missing_categories",
- "suite_weak_normal_oracle",
- "suite_too_large",
- "unknown_case_id",
- "duplicate_case_id",
- "incomplete_case_selection",
- "unsupported_node_kind",
- "research_required",
- "review_required",
- "acceptance_required",
- "qualification_stale",
- "budget_not_approved",
- "budget_exhausted",
- "budget_superseded",
- "budget_capability_consumed",
- "budget_capability_expired",
- "acceptance_case_cost_exceeded",
- "authoring_budget_exceeded",
- "authoring_grant_not_active",
- "insufficient_credits",
- "billing_anomaly",
- "activity_stalled",
- "activity_in_flight",
- "handoff_approval_required",
- "handoff_expired",
- "handoff_not_pending",
- "handoff_stale",
- "handoff_disclosure_incomplete",
- "feature_unavailable",
- "resource_unavailable",
- "resource_binding_required",
- "resource_requirement_not_found",
- "activity_not_cancellable",
- "quota_exceeded",
- "rate_limited",
- "already_published",
- "safety_locked",
- "build_terminal",
- "commit_capability_expired",
- "account_unavailable",
- "limit_unavailable"
- ]
- },
- "estimated_credits": {
- "maxLength": 64,
- "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
- "type": "string"
- },
- "field": {
- "maxLength": 64,
- "type": "string"
- },
- "hint": {
- "maxLength": 240,
- "type": "string"
- },
- "issue": {
- "additionalProperties": false,
- "properties": {
- "code": {
- "maxLength": 64,
- "type": "string"
- },
- "field": {
- "maxLength": 64,
- "type": "string"
- },
- "operator": {
- "maxLength": 64,
- "type": "string"
- },
- "path": {
- "maxLength": 512,
- "type": "string"
- },
- "type": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "code",
- "path"
- ],
- "type": "object"
- },
- "limit_credits": {
- "maxLength": 64,
- "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
- "type": "string"
- },
- "missing_categories": {
- "items": {
- "maxLength": 64,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array",
- "uniqueItems": true
- },
- "next_actions": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "gate": {
- "maxLength": 64,
- "type": "string"
- },
- "instruction": {
- "maxLength": 500,
- "type": "string"
- },
- "tool": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "gate",
- "tool",
- "instruction"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "remaining_gates": {
- "items": {
- "maxLength": 64,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array"
- },
- "repair_hint": {
- "maxLength": 500,
- "type": "string"
- },
- "retry_after_seconds": {
- "maximum": 86400,
- "minimum": 1,
- "type": "integer"
- },
- "review_cost": {
- "additionalProperties": false,
- "properties": {
- "basis": {
- "const": "utf8_byte_upper_bound"
- },
- "estimated_credits": {
- "maxLength": 64,
- "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
- "type": "string"
- },
- "input_token_bound": {
- "minimum": 0,
- "type": "integer"
- },
- "limit_credits": {
- "maxLength": 64,
- "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
- "type": "string"
- },
- "model": {
- "maxLength": 200,
- "type": "string"
- },
- "output_token_cap": {
- "minimum": 0,
- "type": "integer"
- },
- "prompt_bytes": {
- "minimum": 0,
- "type": "integer"
- },
- "provider": {
- "maxLength": 200,
- "type": "string"
- },
- "section_bytes": {
- "additionalProperties": false,
- "properties": {
- "acceptance_suite": {
- "minimum": 0,
- "type": "integer"
- },
- "input_contract": {
- "minimum": 0,
- "type": "integer"
- },
- "intent": {
- "minimum": 0,
- "type": "integer"
- },
- "output_contract": {
- "minimum": 0,
- "type": "integer"
- },
- "research_evidence": {
- "minimum": 0,
- "type": "integer"
- },
- "spec": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [],
- "type": "object"
- }
- },
- "required": [
- "estimated_credits",
- "limit_credits",
- "provider",
- "model",
- "basis",
- "input_token_bound",
- "output_token_cap",
- "prompt_bytes",
- "section_bytes"
- ],
- "type": "object"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- }
- },
- "required": [
- "error"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "properties": {
+ "commit_capability": {
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "effects": {
+ "items": {
+ "enum": [
+ "create_private_revision_1",
+ "keep_recipe_unlisted",
+ "keep_recipe_unreviewed"
+ ]
+ },
+ "maxItems": 3,
+ "minItems": 3,
+ "type": "array"
+ },
+ "evidence": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance": {
+ "enum": [
+ "full_suite_passed",
+ "accepted_with_limitations"
+ ]
+ },
+ "accepted_limitations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "acknowledgement": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "assertion_id": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "case_id": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "case_id",
+ "assertion_id",
+ "acknowledgement"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "billing": {
+ "const": "settled"
+ },
+ "human_review_required": {
+ "const": true
+ },
+ "research": {
+ "enum": [
+ "recorded",
+ "not_required"
+ ]
+ },
+ "review": {
+ "const": "passed"
+ },
+ "revision": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "revision",
+ "review",
+ "research",
+ "acceptance",
+ "billing"
+ ],
+ "type": "object"
+ },
+ "expires_in_seconds": {
+ "maximum": 86400,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "commit_capability",
+ "expires_in_seconds",
+ "effects",
+ "evidence"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "editor_url": {
+ "maxLength": 512,
+ "type": "string"
+ },
+ "evidence": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance": {
+ "enum": [
+ "full_suite_passed",
+ "accepted_with_limitations"
+ ]
+ },
+ "accepted_limitations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "acknowledgement": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "assertion_id": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "case_id": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "case_id",
+ "assertion_id",
+ "acknowledgement"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "billing": {
+ "const": "settled"
+ },
+ "human_review_required": {
+ "const": true
+ },
+ "research": {
+ "enum": [
+ "recorded",
+ "not_required"
+ ]
+ },
+ "review": {
+ "const": "passed"
+ },
+ "revision": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "revision",
+ "review",
+ "research",
+ "acceptance",
+ "billing"
+ ],
+ "type": "object"
+ },
+ "listed": {
+ "const": false
+ },
+ "next_action": {
+ "not": {}
+ },
+ "recipe_ref": {
+ "not": {}
+ },
+ "recipe_ulid": {
+ "maxLength": 26,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rev": {
+ "const": 1
+ },
+ "runnable": {
+ "not": {}
+ },
+ "sha": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ },
+ "visibility": {
+ "const": "private"
+ }
+ },
+ "required": [
+ "recipe_ulid",
+ "rev",
+ "sha",
+ "visibility",
+ "listed",
+ "editor_url"
+ ],
+ "type": "object"
+ },
+ {
+ "properties": {
+ "editor_url": {
+ "maxLength": 512,
+ "type": "string"
+ },
+ "evidence": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance": {
+ "enum": [
+ "full_suite_passed",
+ "accepted_with_limitations"
+ ]
+ },
+ "accepted_limitations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "acknowledgement": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "assertion_id": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "case_id": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "case_id",
+ "assertion_id",
+ "acknowledgement"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "billing": {
+ "const": "settled"
+ },
+ "human_review_required": {
+ "const": true
+ },
+ "research": {
+ "enum": [
+ "recorded",
+ "not_required"
+ ]
+ },
+ "review": {
+ "const": "passed"
+ },
+ "revision": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "revision",
+ "review",
+ "research",
+ "acceptance",
+ "billing"
+ ],
+ "type": "object"
+ },
+ "listed": {
+ "const": false
+ },
+ "next_action": {
+ "const": "dry_run_recipe"
+ },
+ "recipe_ref": {
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "recipe_ulid": {
+ "maxLength": 26,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rev": {
+ "const": 1
+ },
+ "runnable": {
+ "type": "boolean"
+ },
+ "sha": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ },
+ "visibility": {
+ "const": "private"
+ }
+ },
+ "required": [
+ "recipe_ulid",
+ "rev",
+ "sha",
+ "visibility",
+ "listed",
+ "editor_url",
+ "recipe_ref",
+ "runnable",
+ "next_action"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "case_id": {
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "error": {
+ "enum": [
+ "not_found",
+ "invalid_reference",
+ "invalid_params",
+ "revision_conflict",
+ "idempotency_conflict",
+ "document_too_large",
+ "payload_too_large",
+ "chunk_sequence_invalid",
+ "chunk_digest_mismatch",
+ "chunk_expired",
+ "invalid_cursor",
+ "suite_duplicate_case_id",
+ "suite_unresolved_pair",
+ "suite_schema_invalid",
+ "suite_missing_categories",
+ "suite_weak_normal_oracle",
+ "suite_too_large",
+ "unknown_case_id",
+ "duplicate_case_id",
+ "incomplete_case_selection",
+ "unsupported_node_kind",
+ "research_required",
+ "review_required",
+ "acceptance_required",
+ "qualification_stale",
+ "budget_not_approved",
+ "budget_exhausted",
+ "budget_superseded",
+ "budget_capability_consumed",
+ "budget_capability_expired",
+ "acceptance_case_cost_exceeded",
+ "authoring_budget_exceeded",
+ "authoring_grant_not_active",
+ "insufficient_credits",
+ "billing_anomaly",
+ "activity_stalled",
+ "activity_in_flight",
+ "handoff_approval_required",
+ "handoff_expired",
+ "handoff_not_pending",
+ "handoff_stale",
+ "handoff_disclosure_incomplete",
+ "feature_unavailable",
+ "resource_unavailable",
+ "resource_binding_required",
+ "resource_requirement_not_found",
+ "activity_not_cancellable",
+ "quota_exceeded",
+ "rate_limited",
+ "already_published",
+ "safety_locked",
+ "build_terminal",
+ "commit_capability_expired",
+ "account_unavailable",
+ "limit_unavailable"
+ ]
+ },
+ "estimated_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "field": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "hint": {
+ "maxLength": 240,
+ "type": "string"
+ },
+ "issue": {
+ "additionalProperties": false,
+ "properties": {
+ "code": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "field": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "operator": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "path": {
+ "maxLength": 512,
+ "type": "string"
+ },
+ "type": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "path"
+ ],
+ "type": "object"
+ },
+ "limit_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "missing_categories": {
+ "items": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array",
+ "uniqueItems": true
+ },
+ "next_actions": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "gate": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "instruction": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "tool": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "gate",
+ "tool",
+ "instruction"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "remaining_gates": {
+ "items": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "repair_hint": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "retry_after_seconds": {
+ "maximum": 86400,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "review_cost": {
+ "additionalProperties": false,
+ "properties": {
+ "basis": {
+ "const": "utf8_byte_upper_bound"
+ },
+ "estimated_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "input_token_bound": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "limit_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "model": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "output_token_cap": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "prompt_bytes": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "provider": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "section_bytes": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance_suite": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "input_contract": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "intent": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "output_contract": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "research_evidence": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "spec": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [],
+ "type": "object"
+ }
+ },
+ "required": [
+ "estimated_credits",
+ "limit_credits",
+ "provider",
+ "model",
+ "basis",
+ "input_token_bound",
+ "output_token_cap",
+ "prompt_bytes",
+ "section_bytes"
+ ],
+ "type": "object"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "error"
+ ],
+ "type": "object"
+ }
+]Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "commit_capability": {
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "effects": {
- "items": {
- "enum": [
- "create_private_revision_1",
- "keep_recipe_unlisted",
- "keep_recipe_unreviewed"
- ]
- },
- "maxItems": 3,
- "minItems": 3,
- "type": "array"
- },
- "evidence": {
- "additionalProperties": false,
- "properties": {
- "acceptance": {
- "enum": [
- "full_suite_passed",
- "accepted_with_limitations"
- ]
- },
- "accepted_limitations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "acknowledgement": {
- "maxLength": 500,
- "type": "string"
- },
- "assertion_id": {
- "maxLength": 64,
- "type": "string"
- },
- "case_id": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "case_id",
- "assertion_id",
- "acknowledgement"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "billing": {
- "const": "settled"
- },
- "human_review_required": {
- "const": true
- },
- "research": {
- "enum": [
- "recorded",
- "not_required"
- ]
- },
- "review": {
- "const": "passed"
- },
- "revision": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- }
- },
- "required": [
- "revision",
- "review",
- "research",
- "acceptance",
- "billing"
- ],
- "type": "object"
- },
- "expires_in_seconds": {
- "maximum": 86400,
- "minimum": 1,
- "type": "integer"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- }
- },
- "required": [
- "commit_capability",
- "expires_in_seconds",
- "effects",
- "evidence"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "editor_url": {
- "maxLength": 512,
- "type": "string"
- },
- "evidence": {
- "additionalProperties": false,
- "properties": {
- "acceptance": {
- "enum": [
- "full_suite_passed",
- "accepted_with_limitations"
- ]
- },
- "accepted_limitations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "acknowledgement": {
- "maxLength": 500,
- "type": "string"
- },
- "assertion_id": {
- "maxLength": 64,
- "type": "string"
- },
- "case_id": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "case_id",
- "assertion_id",
- "acknowledgement"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "billing": {
- "const": "settled"
- },
- "human_review_required": {
- "const": true
- },
- "research": {
- "enum": [
- "recorded",
- "not_required"
- ]
- },
- "review": {
- "const": "passed"
- },
- "revision": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- }
- },
- "required": [
- "revision",
- "review",
- "research",
- "acceptance",
- "billing"
- ],
- "type": "object"
- },
- "listed": {
- "const": false
- },
- "recipe_ulid": {
- "maxLength": 26,
- "minLength": 1,
- "type": "string"
- },
- "rev": {
- "const": 1
- },
- "sha": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- },
- "visibility": {
- "const": "private"
- }
- },
- "required": [
- "recipe_ulid",
- "rev",
- "sha",
- "visibility",
- "listed",
- "editor_url"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "editor_url": {
- "maxLength": 512,
- "type": "string"
- },
- "evidence": {
- "additionalProperties": false,
- "properties": {
- "acceptance": {
- "enum": [
- "full_suite_passed",
- "accepted_with_limitations"
- ]
- },
- "accepted_limitations": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "acknowledgement": {
- "maxLength": 500,
- "type": "string"
- },
- "assertion_id": {
- "maxLength": 64,
- "type": "string"
- },
- "case_id": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "case_id",
- "assertion_id",
- "acknowledgement"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "billing": {
- "const": "settled"
- },
- "human_review_required": {
- "const": true
- },
- "research": {
- "enum": [
- "recorded",
- "not_required"
- ]
- },
- "review": {
- "const": "passed"
- },
- "revision": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- }
- },
- "required": [
- "revision",
- "review",
- "research",
- "acceptance",
- "billing"
- ],
- "type": "object"
- },
- "listed": {
- "const": false
- },
- "next_action": {
- "const": "dry_run_recipe"
- },
- "recipe_ref": {
- "maxLength": 4096,
- "minLength": 1,
- "type": "string"
- },
- "recipe_ulid": {
- "maxLength": 26,
- "minLength": 1,
- "type": "string"
- },
- "rev": {
- "const": 1
- },
- "runnable": {
- "type": "boolean"
- },
- "sha": {
- "maxLength": 64,
- "pattern": "^[0-9a-f]{64}$",
- "type": "string"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- },
- "visibility": {
- "const": "private"
- }
- },
- "required": [
- "recipe_ulid",
- "rev",
- "sha",
- "visibility",
- "listed",
- "editor_url",
- "recipe_ref",
- "runnable",
- "next_action"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "case_id": {
- "maxLength": 64,
- "minLength": 1,
- "type": "string"
- },
- "error": {
- "enum": [
- "not_found",
- "invalid_reference",
- "invalid_params",
- "revision_conflict",
- "idempotency_conflict",
- "document_too_large",
- "payload_too_large",
- "chunk_sequence_invalid",
- "chunk_digest_mismatch",
- "chunk_expired",
- "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
- },
- "next_actions": {
- "items": {
- "additionalProperties": false,
- "properties": {
- "gate": {
- "maxLength": 64,
- "type": "string"
- },
- "instruction": {
- "maxLength": 500,
- "type": "string"
- },
- "tool": {
- "maxLength": 64,
- "type": "string"
- }
- },
- "required": [
- "gate",
- "tool",
- "instruction"
- ],
- "type": "object"
- },
- "maxItems": 10,
- "type": "array"
- },
- "remaining_gates": {
- "items": {
- "maxLength": 64,
- "type": "string"
- },
- "maxItems": 10,
- "type": "array"
- },
- "repair_hint": {
- "maxLength": 500,
- "type": "string"
- },
- "retry_after_seconds": {
- "maximum": 86400,
- "minimum": 1,
- "type": "integer"
- },
- "review_cost": {
- "additionalProperties": false,
- "properties": {
- "basis": {
- "const": "utf8_byte_upper_bound"
- },
- "estimated_credits": {
- "maxLength": 64,
- "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
- "type": "string"
- },
- "input_token_bound": {
- "minimum": 0,
- "type": "integer"
- },
- "limit_credits": {
- "maxLength": 64,
- "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
- "type": "string"
- },
- "model": {
- "maxLength": 200,
- "type": "string"
- },
- "output_token_cap": {
- "minimum": 0,
- "type": "integer"
- },
- "prompt_bytes": {
- "minimum": 0,
- "type": "integer"
- },
- "provider": {
- "maxLength": 200,
- "type": "string"
- },
- "section_bytes": {
- "additionalProperties": false,
- "properties": {
- "acceptance_suite": {
- "minimum": 0,
- "type": "integer"
- },
- "input_contract": {
- "minimum": 0,
- "type": "integer"
- },
- "intent": {
- "minimum": 0,
- "type": "integer"
- },
- "output_contract": {
- "minimum": 0,
- "type": "integer"
- },
- "research_evidence": {
- "minimum": 0,
- "type": "integer"
- },
- "spec": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [],
- "type": "object"
- }
- },
- "required": [
- "estimated_credits",
- "limit_credits",
- "provider",
- "model",
- "basis",
- "input_token_bound",
- "output_token_cap",
- "prompt_bytes",
- "section_bytes"
- ],
- "type": "object"
- },
- "truncation": {
- "additionalProperties": false,
- "properties": {
- "applied": {
- "const": true
- },
- "omitted_items": {
- "minimum": 0,
- "type": "integer"
- },
- "original_result_bytes": {
- "minimum": 1,
- "type": "integer"
- },
- "reason": {
- "const": "response_size_limit"
- },
- "truncated_values": {
- "minimum": 0,
- "type": "integer"
- }
- },
- "required": [
- "applied",
- "reason",
- "omitted_items",
- "truncated_values",
- "original_result_bytes"
- ],
- "type": "object"
- }
- },
- "required": [
- "error"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "commit_capability": {
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "effects": {
+ "items": {
+ "enum": [
+ "create_private_revision_1",
+ "keep_recipe_unlisted",
+ "keep_recipe_unreviewed"
+ ]
+ },
+ "maxItems": 3,
+ "minItems": 3,
+ "type": "array"
+ },
+ "evidence": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance": {
+ "enum": [
+ "full_suite_passed",
+ "accepted_with_limitations"
+ ]
+ },
+ "accepted_limitations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "acknowledgement": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "assertion_id": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "case_id": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "case_id",
+ "assertion_id",
+ "acknowledgement"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "billing": {
+ "const": "settled"
+ },
+ "human_review_required": {
+ "const": true
+ },
+ "research": {
+ "enum": [
+ "recorded",
+ "not_required"
+ ]
+ },
+ "review": {
+ "const": "passed"
+ },
+ "revision": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "revision",
+ "review",
+ "research",
+ "acceptance",
+ "billing"
+ ],
+ "type": "object"
+ },
+ "expires_in_seconds": {
+ "maximum": 86400,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "commit_capability",
+ "expires_in_seconds",
+ "effects",
+ "evidence"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "editor_url": {
+ "maxLength": 512,
+ "type": "string"
+ },
+ "evidence": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance": {
+ "enum": [
+ "full_suite_passed",
+ "accepted_with_limitations"
+ ]
+ },
+ "accepted_limitations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "acknowledgement": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "assertion_id": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "case_id": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "case_id",
+ "assertion_id",
+ "acknowledgement"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "billing": {
+ "const": "settled"
+ },
+ "human_review_required": {
+ "const": true
+ },
+ "research": {
+ "enum": [
+ "recorded",
+ "not_required"
+ ]
+ },
+ "review": {
+ "const": "passed"
+ },
+ "revision": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "revision",
+ "review",
+ "research",
+ "acceptance",
+ "billing"
+ ],
+ "type": "object"
+ },
+ "listed": {
+ "const": false
+ },
+ "recipe_ulid": {
+ "maxLength": 26,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rev": {
+ "const": 1
+ },
+ "sha": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ },
+ "visibility": {
+ "const": "private"
+ }
+ },
+ "required": [
+ "recipe_ulid",
+ "rev",
+ "sha",
+ "visibility",
+ "listed",
+ "editor_url"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "editor_url": {
+ "maxLength": 512,
+ "type": "string"
+ },
+ "evidence": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance": {
+ "enum": [
+ "full_suite_passed",
+ "accepted_with_limitations"
+ ]
+ },
+ "accepted_limitations": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "acknowledgement": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "assertion_id": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "case_id": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "case_id",
+ "assertion_id",
+ "acknowledgement"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "billing": {
+ "const": "settled"
+ },
+ "human_review_required": {
+ "const": true
+ },
+ "research": {
+ "enum": [
+ "recorded",
+ "not_required"
+ ]
+ },
+ "review": {
+ "const": "passed"
+ },
+ "revision": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "revision",
+ "review",
+ "research",
+ "acceptance",
+ "billing"
+ ],
+ "type": "object"
+ },
+ "listed": {
+ "const": false
+ },
+ "next_action": {
+ "const": "dry_run_recipe"
+ },
+ "recipe_ref": {
+ "maxLength": 4096,
+ "minLength": 1,
+ "type": "string"
+ },
+ "recipe_ulid": {
+ "maxLength": 26,
+ "minLength": 1,
+ "type": "string"
+ },
+ "rev": {
+ "const": 1
+ },
+ "runnable": {
+ "type": "boolean"
+ },
+ "sha": {
+ "maxLength": 64,
+ "pattern": "^[0-9a-f]{64}$",
+ "type": "string"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ },
+ "visibility": {
+ "const": "private"
+ }
+ },
+ "required": [
+ "recipe_ulid",
+ "rev",
+ "sha",
+ "visibility",
+ "listed",
+ "editor_url",
+ "recipe_ref",
+ "runnable",
+ "next_action"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "case_id": {
+ "maxLength": 64,
+ "minLength": 1,
+ "type": "string"
+ },
+ "error": {
+ "enum": [
+ "not_found",
+ "invalid_reference",
+ "invalid_params",
+ "revision_conflict",
+ "idempotency_conflict",
+ "document_too_large",
+ "payload_too_large",
+ "chunk_sequence_invalid",
+ "chunk_digest_mismatch",
+ "chunk_expired",
+ "invalid_cursor",
+ "suite_duplicate_case_id",
+ "suite_unresolved_pair",
+ "suite_schema_invalid",
+ "suite_missing_categories",
+ "suite_weak_normal_oracle",
+ "suite_too_large",
+ "unknown_case_id",
+ "duplicate_case_id",
+ "incomplete_case_selection",
+ "unsupported_node_kind",
+ "research_required",
+ "review_required",
+ "acceptance_required",
+ "qualification_stale",
+ "budget_not_approved",
+ "budget_exhausted",
+ "budget_superseded",
+ "budget_capability_consumed",
+ "budget_capability_expired",
+ "acceptance_case_cost_exceeded",
+ "authoring_budget_exceeded",
+ "authoring_grant_not_active",
+ "insufficient_credits",
+ "billing_anomaly",
+ "activity_stalled",
+ "activity_in_flight",
+ "handoff_approval_required",
+ "handoff_expired",
+ "handoff_not_pending",
+ "handoff_stale",
+ "handoff_disclosure_incomplete",
+ "feature_unavailable",
+ "resource_unavailable",
+ "resource_binding_required",
+ "resource_requirement_not_found",
+ "activity_not_cancellable",
+ "quota_exceeded",
+ "rate_limited",
+ "already_published",
+ "safety_locked",
+ "build_terminal",
+ "commit_capability_expired",
+ "account_unavailable",
+ "limit_unavailable"
+ ]
+ },
+ "estimated_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "field": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "hint": {
+ "maxLength": 240,
+ "type": "string"
+ },
+ "issue": {
+ "additionalProperties": false,
+ "properties": {
+ "code": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "field": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "operator": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "path": {
+ "maxLength": 512,
+ "type": "string"
+ },
+ "type": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "code",
+ "path"
+ ],
+ "type": "object"
+ },
+ "limit_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "missing_categories": {
+ "items": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array",
+ "uniqueItems": true
+ },
+ "next_actions": {
+ "items": {
+ "additionalProperties": false,
+ "properties": {
+ "gate": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "instruction": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "tool": {
+ "maxLength": 64,
+ "type": "string"
+ }
+ },
+ "required": [
+ "gate",
+ "tool",
+ "instruction"
+ ],
+ "type": "object"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "remaining_gates": {
+ "items": {
+ "maxLength": 64,
+ "type": "string"
+ },
+ "maxItems": 10,
+ "type": "array"
+ },
+ "repair_hint": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "retry_after_seconds": {
+ "maximum": 86400,
+ "minimum": 1,
+ "type": "integer"
+ },
+ "review_cost": {
+ "additionalProperties": false,
+ "properties": {
+ "basis": {
+ "const": "utf8_byte_upper_bound"
+ },
+ "estimated_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "input_token_bound": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "limit_credits": {
+ "maxLength": 64,
+ "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+ "type": "string"
+ },
+ "model": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "output_token_cap": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "prompt_bytes": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "provider": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "section_bytes": {
+ "additionalProperties": false,
+ "properties": {
+ "acceptance_suite": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "input_contract": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "intent": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "output_contract": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "research_evidence": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "spec": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [],
+ "type": "object"
+ }
+ },
+ "required": [
+ "estimated_credits",
+ "limit_credits",
+ "provider",
+ "model",
+ "basis",
+ "input_token_bound",
+ "output_token_cap",
+ "prompt_bytes",
+ "section_bytes"
+ ],
+ "type": "object"
+ },
+ "truncation": {
+ "additionalProperties": false,
+ "properties": {
+ "applied": {
+ "const": true
+ },
+ "omitted_items": {
+ "minimum": 0,
+ "type": "integer"
+ },
+ "original_result_bytes": {
+ "minimum": 1,
+ "type": "integer"
+ },
+ "reason": {
+ "const": "response_size_limit"
+ },
+ "truncated_values": {
+ "minimum": 0,
+ "type": "integer"
+ }
+ },
+ "required": [
+ "applied",
+ "reason",
+ "omitted_items",
+ "truncated_values",
+ "original_result_bytes"
+ ],
+ "type": "object"
+ }
+ },
+ "required": [
+ "error"
+ ],
+ "type": "object"
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already indicate destructiveHint=true, readOnlyHint=false, and idempotentHint=true. The description adds the concepts of 'preflight' and 'privately publish' but does not clarify what each mode does, whether commit is reversible, or what 'privately publish' implies. It adds minimal behavioral context beyond the annotations and fails to explain the destructive nature or side effects of the commit operation.
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, which is concise and front-loaded. However, it is so terse that it becomes cryptic; it could benefit from a two-part structure separating preflight and commit behavior. Still, there is no fluff or unnecessary words, so it scores well on conciseness but loses points for structure due to ambiguity.
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?
With 5 parameters, a two-mode operation (preflight vs commit), and only 20% schema coverage, the description is severely incomplete. It does not explain the distinction between modes, the meaning of idempotency, what output is expected, or the consequences of committing. The presence of an output schema does not help because the description does not describe the tool's behavior enough for an agent to call it correctly.
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 only 20%, with only commit_capability having a description. The tool description does not explain any parameters. The phrase 'exact fully qualified recipe revision' hints at build_ref and revision but does not clarify their format, purpose, or the role of mode and idempotency_key. The description fails to compensate for the low schema coverage, leaving parameter meanings ambiguous.
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 'Preflight and privately publish only the exact fully qualified recipe revision' gives a general idea of preflight and publication, but it is vague about the actual operation on the recipe build. It does not explicitly say 'commit' or clearly distinguish from siblings like start_recipe_build or update_recipe_build. The phrase 'exact fully qualified recipe revision' is jargon that lacks concrete definition.
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 guidance on when to use this tool versus alternatives. The description does not mention any conditions or exclusions, and the 'mode' parameter (preflight vs commit) is not explained as a usage differentiator. With many sibling tools (start_recipe_build, check_recipe_build, etc.), the agent is left without clear routing information.
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.