Skip to main content
Glama

StewAI

by com.stewai
OverviewDiscussionsAdmin

Start a StewAI Recipe Build

start_recipe_build
Idempotent

Create a private recipe build from a bounded intent and declared contract. Recipe inputs are strings: use type:string, positive maxLength, and only minLength:1 on required inputs. Richer input constraints must be handled in recipe logic and tested, not claimed as enforced by the input node. The response returns the stored contracts when they fit the bounded result; the archetype bundle is optional guidance, not the build contract. Optionally provide source_recipe_ref to adapt an owned recipe or a fully viewable public-open recipe into a new private draft.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameYes
intentYes
capabilitiesYes
risk_domainsYes
input_contractYes
idempotency_keyYes
output_contractYes
quality_profileYes
research_policyYes
source_recipe_refNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "archetype_bundle_role": {
-        "const": "optional_guidance"
-      },
-      "budget_ceiling": {
-        "maxLength": 64,
-        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
-        "type": "string"
-      },
-      "build_ref": {
-        "maxLength": 4096,
-        "minLength": 1,
-        "type": "string"
-      },
-      "catalog_version": {
-        "maxLength": 64,
-        "type": "string"
-      },
-      "contract_bundle": {
-        "additionalProperties": false,
-        "properties": {
-          "archetype": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "archetype_id": {
-                    "maxLength": 64,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "capabilities": {
-                    "items": {
-                      "maxLength": 64,
-                      "type": "string"
-                    },
-                    "maxItems": 20,
-                    "type": "array"
-                  },
-                  "node_kinds": {
-                    "items": {
-                      "maxLength": 64,
-                      "type": "string"
-                    },
-                    "maxItems": 24,
-                    "type": "array"
-                  },
-                  "summary": {
-                    "maxLength": 500,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "title": {
-                    "maxLength": 120,
-                    "minLength": 1,
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "archetype_id",
-                  "title",
-                  "summary",
-                  "capabilities",
-                  "node_kinds"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "catalog_version": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "input_contract": {
-            "additionalProperties": false,
-            "properties": {
-              "fields": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "description": {
-                      "maxLength": 500,
-                      "type": "string"
-                    },
-                    "handle": {
-                      "maxLength": 64,
-                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                      "type": "string"
-                    },
-                    "label": {
-                      "maxLength": 120,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "required": {
-                      "type": "boolean"
-                    },
-                    "schema": {
-                      "maxProperties": 100,
-                      "type": "object"
-                    }
-                  },
-                  "required": [
-                    "handle",
-                    "label",
-                    "description",
-                    "required",
-                    "schema"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 20,
-                "type": "array"
-              }
-            },
-            "required": [
-              "fields"
-            ],
-            "type": "object"
-          },
-          "output_contract": {
-            "additionalProperties": false,
-            "properties": {
-              "fields": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "description": {
-                      "maxLength": 500,
-                      "type": "string"
-                    },
-                    "handle": {
-                      "maxLength": 64,
-                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                      "type": "string"
-                    },
-                    "label": {
-                      "maxLength": 120,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "required": {
-                      "const": true
-                    },
-                    "schema": {
-                      "maxProperties": 100,
-                      "type": "object"
-                    }
-                  },
-                  "required": [
-                    "handle",
-                    "label",
-                    "description",
-                    "required",
-                    "schema"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 20,
-                "type": "array"
-              }
-            },
-            "required": [
-              "fields"
-            ],
-            "type": "object"
-          },
-          "recipe_spec": {
-            "type": "object"
-          },
-          "versions": {
-            "additionalProperties": false,
-            "properties": {
-              "archetypes": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "capabilities": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "checks": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "guidance": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "models": {
-                "maxLength": 64,
-                "type": "string"
-              }
-            },
-            "required": [
-              "archetypes",
-              "capabilities",
-              "checks",
-              "guidance",
-              "models"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "catalog_version",
-          "archetype",
-          "input_contract",
-          "output_contract",
-          "recipe_spec"
-        ],
-        "type": "object"
-      },
-      "contracts_in_response": {
-        "type": "boolean"
-      },
-      "dsl_version": {
-        "minimum": 2,
-        "type": "integer"
-      },
-      "editor_url": {
-        "maxLength": 512,
-        "type": "string"
-      },
-      "guidance_version": {
-        "maxLength": 64,
-        "type": "string"
-      },
-      "input_contract": {
-        "additionalProperties": false,
-        "properties": {
-          "fields": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "description": {
-                  "maxLength": 500,
-                  "type": "string"
-                },
-                "handle": {
-                  "maxLength": 64,
-                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                  "type": "string"
-                },
-                "label": {
-                  "maxLength": 120,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "required": {
-                  "type": "boolean"
-                },
-                "schema": {
-                  "maxProperties": 100,
-                  "type": "object"
-                }
-              },
-              "required": [
-                "handle",
-                "label",
-                "description",
-                "required",
-                "schema"
-              ],
-              "type": "object"
-            },
-            "maxItems": 20,
-            "type": "array"
-          }
-        },
-        "required": [
-          "fields"
-        ],
-        "type": "object"
-      },
-      "matched_archetypes": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "archetype_id": {
-              "maxLength": 64,
-              "minLength": 1,
-              "type": "string"
-            },
-            "capabilities": {
-              "items": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "maxItems": 20,
-              "type": "array"
-            },
-            "node_kinds": {
-              "items": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "maxItems": 24,
-              "type": "array"
-            },
-            "summary": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 120,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "archetype_id",
-            "title",
-            "summary",
-            "capabilities",
-            "node_kinds"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "minimum_acceptance_categories": {
-        "items": {
-          "maxLength": 64,
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array"
-      },
-      "output_contract": {
-        "additionalProperties": false,
-        "properties": {
-          "fields": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "description": {
-                  "maxLength": 500,
-                  "type": "string"
-                },
-                "handle": {
-                  "maxLength": 64,
-                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                  "type": "string"
-                },
-                "label": {
-                  "maxLength": 120,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "required": {
-                  "const": true
-                },
-                "schema": {
-                  "maxProperties": 100,
-                  "type": "object"
-                }
-              },
-              "required": [
-                "handle",
-                "label",
-                "description",
-                "required",
-                "schema"
-              ],
-              "type": "object"
-            },
-            "maxItems": 20,
-            "type": "array"
-          }
-        },
-        "required": [
-          "fields"
-        ],
-        "type": "object"
-      },
-      "research_tier": {
-        "enum": [
-          "skipped",
-          "recommended",
-          "required"
-        ]
-      },
-      "revision": {
-        "maxLength": 64,
-        "pattern": "^[0-9a-f]{64}$",
-        "type": "string"
-      },
-      "truncation": {
-        "additionalProperties": false,
-        "properties": {
-          "applied": {
-            "const": true
-          },
-          "omitted_items": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "original_result_bytes": {
-            "minimum": 1,
-            "type": "integer"
-          },
-          "reason": {
-            "const": "response_size_limit"
-          },
-          "truncated_values": {
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "applied",
-          "reason",
-          "omitted_items",
-          "truncated_values",
-          "original_result_bytes"
-        ],
-        "type": "object"
-      },
-      "versions": {
-        "additionalProperties": false,
-        "properties": {
-          "archetypes": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "capabilities": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "checks": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "guidance": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "models": {
-            "maxLength": 64,
-            "type": "string"
-          }
-        },
-        "required": [
-          "archetypes",
-          "capabilities",
-          "checks",
-          "guidance",
-          "models"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "build_ref",
-      "revision",
-      "contracts_in_response",
-      "editor_url",
-      "matched_archetypes",
-      "contract_bundle",
-      "archetype_bundle_role",
-      "research_tier",
-      "minimum_acceptance_categories",
-      "dsl_version",
-      "catalog_version",
-      "guidance_version",
-      "budget_ceiling"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "case_id": {
-        "maxLength": 64,
-        "minLength": 1,
-        "type": "string"
-      },
-      "error": {
-        "enum": [
-          "not_found",
-          "invalid_reference",
-          "invalid_params",
-          "revision_conflict",
-          "idempotency_conflict",
-          "document_too_large",
-          "payload_too_large",
-          "chunk_sequence_invalid",
-          "chunk_digest_mismatch",
-          "chunk_expired",
-          "invalid_cursor",
-          "suite_duplicate_case_id",
-          "suite_unresolved_pair",
-          "suite_schema_invalid",
-          "suite_missing_categories",
-          "suite_weak_normal_oracle",
-          "suite_too_large",
-          "unknown_case_id",
-          "duplicate_case_id",
-          "incomplete_case_selection",
-          "unsupported_node_kind",
-          "research_required",
-          "review_required",
-          "acceptance_required",
-          "qualification_stale",
-          "budget_not_approved",
-          "budget_exhausted",
-          "budget_superseded",
-          "budget_capability_consumed",
-          "budget_capability_expired",
-          "acceptance_case_cost_exceeded",
-          "authoring_budget_exceeded",
-          "authoring_grant_not_active",
-          "insufficient_credits",
-          "billing_anomaly",
-          "activity_stalled",
-          "activity_in_flight",
-          "handoff_approval_required",
-          "handoff_expired",
-          "handoff_not_pending",
-          "handoff_stale",
-          "handoff_disclosure_incomplete",
-          "feature_unavailable",
-          "resource_unavailable",
-          "resource_binding_required",
-          "resource_requirement_not_found",
-          "activity_not_cancellable",
-          "quota_exceeded",
-          "rate_limited",
-          "already_published",
-          "safety_locked",
-          "build_terminal",
-          "commit_capability_expired",
-          "account_unavailable",
-          "limit_unavailable"
-        ]
-      },
-      "estimated_credits": {
-        "maxLength": 64,
-        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
-        "type": "string"
-      },
-      "field": {
-        "maxLength": 64,
-        "type": "string"
-      },
-      "hint": {
-        "maxLength": 240,
-        "type": "string"
-      },
-      "issue": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "field": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "operator": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "path": {
-            "maxLength": 512,
-            "type": "string"
-          },
-          "type": {
-            "maxLength": 64,
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "path"
-        ],
-        "type": "object"
-      },
-      "limit_credits": {
-        "maxLength": 64,
-        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
-        "type": "string"
-      },
-      "missing_categories": {
-        "items": {
-          "maxLength": 64,
-          "type": "string"
-        },
-        "maxItems": 10,
-        "type": "array",
-        "uniqueItems": true
-      },
-      "repair_hint": {
-        "maxLength": 500,
-        "type": "string"
-      },
-      "retry_after_seconds": {
-        "maximum": 86400,
-        "minimum": 1,
-        "type": "integer"
-      },
-      "review_cost": {
-        "additionalProperties": false,
-        "properties": {
-          "basis": {
-            "const": "utf8_byte_upper_bound"
-          },
-          "estimated_credits": {
-            "maxLength": 64,
-            "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
-            "type": "string"
-          },
-          "input_token_bound": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "limit_credits": {
-            "maxLength": 64,
-            "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
-            "type": "string"
-          },
-          "model": {
-            "maxLength": 200,
-            "type": "string"
-          },
-          "output_token_cap": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "prompt_bytes": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "provider": {
-            "maxLength": 200,
-            "type": "string"
-          },
-          "section_bytes": {
-            "additionalProperties": false,
-            "properties": {
-              "acceptance_suite": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "input_contract": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "intent": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "output_contract": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "research_evidence": {
-                "minimum": 0,
-                "type": "integer"
-              },
-              "spec": {
-                "minimum": 0,
-                "type": "integer"
-              }
-            },
-            "required": [],
-            "type": "object"
-          }
-        },
-        "required": [
-          "estimated_credits",
-          "limit_credits",
-          "provider",
-          "model",
-          "basis",
-          "input_token_bound",
-          "output_token_cap",
-          "prompt_bytes",
-          "section_bytes"
-        ],
-        "type": "object"
-      },
-      "truncation": {
-        "additionalProperties": false,
-        "properties": {
-          "applied": {
-            "const": true
-          },
-          "omitted_items": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "original_result_bytes": {
-            "minimum": 1,
-            "type": "integer"
-          },
-          "reason": {
-            "const": "response_size_limit"
-          },
-          "truncated_values": {
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "applied",
-          "reason",
-          "omitted_items",
-          "truncated_values",
-          "original_result_bytes"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "archetype_bundle_role": {
+        "const": "optional_guidance"
+      },
+      "budget_ceiling": {
+        "maxLength": 64,
+        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+        "type": "string"
+      },
+      "build_ref": {
+        "maxLength": 4096,
+        "minLength": 1,
+        "type": "string"
+      },
+      "catalog_version": {
+        "maxLength": 64,
+        "type": "string"
+      },
+      "contract_bundle": {
+        "additionalProperties": false,
+        "properties": {
+          "archetype": {
+            "oneOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "archetype_id": {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "capabilities": {
+                    "items": {
+                      "maxLength": 64,
+                      "type": "string"
+                    },
+                    "maxItems": 20,
+                    "type": "array"
+                  },
+                  "node_kinds": {
+                    "items": {
+                      "maxLength": 64,
+                      "type": "string"
+                    },
+                    "maxItems": 24,
+                    "type": "array"
+                  },
+                  "summary": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "title": {
+                    "maxLength": 120,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "archetype_id",
+                  "title",
+                  "summary",
+                  "capabilities",
+                  "node_kinds"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "catalog_version": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "input_contract": {
+            "additionalProperties": false,
+            "properties": {
+              "fields": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "description": {
+                      "maxLength": 500,
+                      "type": "string"
+                    },
+                    "handle": {
+                      "maxLength": 64,
+                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                      "type": "string"
+                    },
+                    "label": {
+                      "maxLength": 120,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "required": {
+                      "type": "boolean"
+                    },
+                    "schema": {
+                      "maxProperties": 100,
+                      "type": "object"
+                    }
+                  },
+                  "required": [
+                    "handle",
+                    "label",
+                    "description",
+                    "required",
+                    "schema"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 20,
+                "type": "array"
+              }
+            },
+            "required": [
+              "fields"
+            ],
+            "type": "object"
+          },
+          "output_contract": {
+            "additionalProperties": false,
+            "properties": {
+              "fields": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "description": {
+                      "maxLength": 500,
+                      "type": "string"
+                    },
+                    "handle": {
+                      "maxLength": 64,
+                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                      "type": "string"
+                    },
+                    "label": {
+                      "maxLength": 120,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "required": {
+                      "const": true
+                    },
+                    "schema": {
+                      "maxProperties": 100,
+                      "type": "object"
+                    }
+                  },
+                  "required": [
+                    "handle",
+                    "label",
+                    "description",
+                    "required",
+                    "schema"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 20,
+                "type": "array"
+              }
+            },
+            "required": [
+              "fields"
+            ],
+            "type": "object"
+          },
+          "recipe_spec": {
+            "type": "object"
+          },
+          "versions": {
+            "additionalProperties": false,
+            "properties": {
+              "archetypes": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "capabilities": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "checks": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "guidance": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "models": {
+                "maxLength": 64,
+                "type": "string"
+              }
+            },
+            "required": [
+              "archetypes",
+              "capabilities",
+              "checks",
+              "guidance",
+              "models"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "catalog_version",
+          "archetype",
+          "input_contract",
+          "output_contract",
+          "recipe_spec"
+        ],
+        "type": "object"
+      },
+      "contracts_in_response": {
+        "type": "boolean"
+      },
+      "dsl_version": {
+        "minimum": 2,
+        "type": "integer"
+      },
+      "editor_url": {
+        "maxLength": 512,
+        "type": "string"
+      },
+      "guidance_version": {
+        "maxLength": 64,
+        "type": "string"
+      },
+      "input_contract": {
+        "additionalProperties": false,
+        "properties": {
+          "fields": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "description": {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                "handle": {
+                  "maxLength": 64,
+                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                  "type": "string"
+                },
+                "label": {
+                  "maxLength": 120,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "required": {
+                  "type": "boolean"
+                },
+                "schema": {
+                  "maxProperties": 100,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "handle",
+                "label",
+                "description",
+                "required",
+                "schema"
+              ],
+              "type": "object"
+            },
+            "maxItems": 20,
+            "type": "array"
+          }
+        },
+        "required": [
+          "fields"
+        ],
+        "type": "object"
+      },
+      "matched_archetypes": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "archetype_id": {
+              "maxLength": 64,
+              "minLength": 1,
+              "type": "string"
+            },
+            "capabilities": {
+              "items": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "maxItems": 20,
+              "type": "array"
+            },
+            "node_kinds": {
+              "items": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "maxItems": 24,
+              "type": "array"
+            },
+            "summary": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 120,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "archetype_id",
+            "title",
+            "summary",
+            "capabilities",
+            "node_kinds"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "minimum_acceptance_categories": {
+        "items": {
+          "maxLength": 64,
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array"
+      },
+      "output_contract": {
+        "additionalProperties": false,
+        "properties": {
+          "fields": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "description": {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                "handle": {
+                  "maxLength": 64,
+                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                  "type": "string"
+                },
+                "label": {
+                  "maxLength": 120,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "required": {
+                  "const": true
+                },
+                "schema": {
+                  "maxProperties": 100,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "handle",
+                "label",
+                "description",
+                "required",
+                "schema"
+              ],
+              "type": "object"
+            },
+            "maxItems": 20,
+            "type": "array"
+          }
+        },
+        "required": [
+          "fields"
+        ],
+        "type": "object"
+      },
+      "research_tier": {
+        "enum": [
+          "skipped",
+          "recommended",
+          "required"
+        ]
+      },
+      "revision": {
+        "maxLength": 64,
+        "pattern": "^[0-9a-f]{64}$",
+        "type": "string"
+      },
+      "truncation": {
+        "additionalProperties": false,
+        "properties": {
+          "applied": {
+            "const": true
+          },
+          "omitted_items": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "original_result_bytes": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "reason": {
+            "const": "response_size_limit"
+          },
+          "truncated_values": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "applied",
+          "reason",
+          "omitted_items",
+          "truncated_values",
+          "original_result_bytes"
+        ],
+        "type": "object"
+      },
+      "versions": {
+        "additionalProperties": false,
+        "properties": {
+          "archetypes": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "capabilities": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "checks": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "guidance": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "models": {
+            "maxLength": 64,
+            "type": "string"
+          }
+        },
+        "required": [
+          "archetypes",
+          "capabilities",
+          "checks",
+          "guidance",
+          "models"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "build_ref",
+      "revision",
+      "contracts_in_response",
+      "editor_url",
+      "matched_archetypes",
+      "contract_bundle",
+      "archetype_bundle_role",
+      "research_tier",
+      "minimum_acceptance_categories",
+      "dsl_version",
+      "catalog_version",
+      "guidance_version",
+      "budget_ceiling"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "case_id": {
+        "maxLength": 64,
+        "minLength": 1,
+        "type": "string"
+      },
+      "error": {
+        "enum": [
+          "not_found",
+          "invalid_reference",
+          "invalid_params",
+          "revision_conflict",
+          "idempotency_conflict",
+          "document_too_large",
+          "payload_too_large",
+          "chunk_sequence_invalid",
+          "chunk_digest_mismatch",
+          "chunk_expired",
+          "invalid_cursor",
+          "suite_duplicate_case_id",
+          "suite_unresolved_pair",
+          "suite_schema_invalid",
+          "suite_missing_categories",
+          "suite_weak_normal_oracle",
+          "suite_too_large",
+          "unknown_case_id",
+          "duplicate_case_id",
+          "incomplete_case_selection",
+          "unsupported_node_kind",
+          "research_required",
+          "review_required",
+          "acceptance_required",
+          "qualification_stale",
+          "budget_not_approved",
+          "budget_exhausted",
+          "budget_superseded",
+          "budget_capability_consumed",
+          "budget_capability_expired",
+          "acceptance_case_cost_exceeded",
+          "authoring_budget_exceeded",
+          "authoring_grant_not_active",
+          "insufficient_credits",
+          "billing_anomaly",
+          "activity_stalled",
+          "activity_in_flight",
+          "handoff_approval_required",
+          "handoff_expired",
+          "handoff_not_pending",
+          "handoff_stale",
+          "handoff_disclosure_incomplete",
+          "feature_unavailable",
+          "resource_unavailable",
+          "resource_binding_required",
+          "resource_requirement_not_found",
+          "activity_not_cancellable",
+          "quota_exceeded",
+          "rate_limited",
+          "already_published",
+          "safety_locked",
+          "build_terminal",
+          "commit_capability_expired",
+          "account_unavailable",
+          "limit_unavailable"
+        ]
+      },
+      "estimated_credits": {
+        "maxLength": 64,
+        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+        "type": "string"
+      },
+      "field": {
+        "maxLength": 64,
+        "type": "string"
+      },
+      "hint": {
+        "maxLength": 240,
+        "type": "string"
+      },
+      "issue": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "field": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "operator": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "path": {
+            "maxLength": 512,
+            "type": "string"
+          },
+          "type": {
+            "maxLength": 64,
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "path"
+        ],
+        "type": "object"
+      },
+      "limit_credits": {
+        "maxLength": 64,
+        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+        "type": "string"
+      },
+      "missing_categories": {
+        "items": {
+          "maxLength": 64,
+          "type": "string"
+        },
+        "maxItems": 10,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "repair_hint": {
+        "maxLength": 500,
+        "type": "string"
+      },
+      "retry_after_seconds": {
+        "maximum": 86400,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "review_cost": {
+        "additionalProperties": false,
+        "properties": {
+          "basis": {
+            "const": "utf8_byte_upper_bound"
+          },
+          "estimated_credits": {
+            "maxLength": 64,
+            "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+            "type": "string"
+          },
+          "input_token_bound": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "limit_credits": {
+            "maxLength": 64,
+            "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+            "type": "string"
+          },
+          "model": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "output_token_cap": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "prompt_bytes": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "provider": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "section_bytes": {
+            "additionalProperties": false,
+            "properties": {
+              "acceptance_suite": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "input_contract": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "intent": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "output_contract": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "research_evidence": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "spec": {
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [],
+            "type": "object"
+          }
+        },
+        "required": [
+          "estimated_credits",
+          "limit_credits",
+          "provider",
+          "model",
+          "basis",
+          "input_token_bound",
+          "output_token_cap",
+          "prompt_bytes",
+          "section_bytes"
+        ],
+        "type": "object"
+      },
+      "truncation": {
+        "additionalProperties": false,
+        "properties": {
+          "applied": {
+            "const": true
+          },
+          "omitted_items": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "original_result_bytes": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "reason": {
+            "const": "response_size_limit"
+          },
+          "truncated_values": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "applied",
+          "reason",
+          "omitted_items",
+          "truncated_values",
+          "original_result_bytes"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "archetype_bundle_role": {
-        "const": "optional_guidance"
-      },
-      "budget_ceiling": {
-        "maxLength": 64,
-        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
-        "type": "string"
-      },
-      "build_ref": {
-        "maxLength": 4096,
-        "minLength": 1,
-        "type": "string"
-      },
-      "catalog_version": {
-        "maxLength": 64,
-        "type": "string"
-      },
-      "contract_bundle": {
-        "additionalProperties": false,
-        "properties": {
-          "archetype": {
-            "oneOf": [
-              {
-                "additionalProperties": false,
-                "properties": {
-                  "archetype_id": {
-                    "maxLength": 64,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "capabilities": {
-                    "items": {
-                      "maxLength": 64,
-                      "type": "string"
-                    },
-                    "maxItems": 20,
-                    "type": "array"
-                  },
-                  "node_kinds": {
-                    "items": {
-                      "maxLength": 64,
-                      "type": "string"
-                    },
-                    "maxItems": 24,
-                    "type": "array"
-                  },
-                  "summary": {
-                    "maxLength": 500,
-                    "minLength": 1,
-                    "type": "string"
-                  },
-                  "title": {
-                    "maxLength": 120,
-                    "minLength": 1,
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "archetype_id",
-                  "title",
-                  "summary",
-                  "capabilities",
-                  "node_kinds"
-                ],
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "catalog_version": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "input_contract": {
-            "additionalProperties": false,
-            "properties": {
-              "fields": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "description": {
-                      "maxLength": 500,
-                      "type": "string"
-                    },
-                    "handle": {
-                      "maxLength": 64,
-                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                      "type": "string"
-                    },
-                    "label": {
-                      "maxLength": 120,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "required": {
-                      "type": "boolean"
-                    },
-                    "schema": {
-                      "maxProperties": 100,
-                      "type": "object"
-                    }
-                  },
-                  "required": [
-                    "handle",
-                    "label",
-                    "description",
-                    "required",
-                    "schema"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 20,
-                "type": "array"
-              }
-            },
-            "required": [
-              "fields"
-            ],
-            "type": "object"
-          },
-          "output_contract": {
-            "additionalProperties": false,
-            "properties": {
-              "fields": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "description": {
-                      "maxLength": 500,
-                      "type": "string"
-                    },
-                    "handle": {
-                      "maxLength": 64,
-                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                      "type": "string"
-                    },
-                    "label": {
-                      "maxLength": 120,
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "required": {
-                      "const": true
-                    },
-                    "schema": {
-                      "maxProperties": 100,
-                      "type": "object"
-                    }
-                  },
-                  "required": [
-                    "handle",
-                    "label",
-                    "description",
-                    "required",
-                    "schema"
-                  ],
-                  "type": "object"
-                },
-                "maxItems": 20,
-                "type": "array"
-              }
-            },
-            "required": [
-              "fields"
-            ],
-            "type": "object"
-          },
-          "recipe_spec": {
-            "type": "object"
-          },
-          "versions": {
-            "additionalProperties": false,
-            "properties": {
-              "archetypes": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "capabilities": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "checks": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "guidance": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "models": {
-                "maxLength": 64,
-                "type": "string"
-              }
-            },
-            "required": [
-              "archetypes",
-              "capabilities",
-              "checks",
-              "guidance",
-              "models"
-            ],
-            "type": "object"
-          }
-        },
-        "required": [
-          "catalog_version",
-          "archetype",
-          "input_contract",
-          "output_contract",
-          "recipe_spec"
-        ],
-        "type": "object"
-      },
-      "contracts_in_response": {
-        "type": "boolean"
-      },
-      "dsl_version": {
-        "minimum": 2,
-        "type": "integer"
-      },
-      "editor_url": {
-        "maxLength": 512,
-        "type": "string"
-      },
-      "guidance_version": {
-        "maxLength": 64,
-        "type": "string"
-      },
-      "input_contract": {
-        "additionalProperties": false,
-        "properties": {
-          "fields": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "description": {
-                  "maxLength": 500,
-                  "type": "string"
-                },
-                "handle": {
-                  "maxLength": 64,
-                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                  "type": "string"
-                },
-                "label": {
-                  "maxLength": 120,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "required": {
-                  "type": "boolean"
-                },
-                "schema": {
-                  "maxProperties": 100,
-                  "type": "object"
-                }
-              },
-              "required": [
-                "handle",
-                "label",
-                "description",
-                "required",
-                "schema"
-              ],
-              "type": "object"
-            },
-            "maxItems": 20,
-            "type": "array"
-          }
-        },
-        "required": [
-          "fields"
-        ],
-        "type": "object"
-      },
-      "matched_archetypes": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "archetype_id": {
-              "maxLength": 64,
-              "minLength": 1,
-              "type": "string"
-            },
-            "capabilities": {
-              "items": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "maxItems": 20,
-              "type": "array"
-            },
-            "node_kinds": {
-              "items": {
-                "maxLength": 64,
-                "type": "string"
-              },
-              "maxItems": 24,
-              "type": "array"
-            },
-            "summary": {
-              "maxLength": 500,
-              "minLength": 1,
-              "type": "string"
-            },
-            "title": {
-              "maxLength": 120,
-              "minLength": 1,
-              "type": "string"
-            }
-          },
-          "required": [
-            "archetype_id",
-            "title",
-            "summary",
-            "capabilities",
-            "node_kinds"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "type": "array"
-      },
-      "minimum_acceptance_categories": {
-        "items": {
-          "maxLength": 64,
-          "type": "string"
-        },
-        "maxItems": 20,
-        "type": "array"
-      },
-      "output_contract": {
-        "additionalProperties": false,
-        "properties": {
-          "fields": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "description": {
-                  "maxLength": 500,
-                  "type": "string"
-                },
-                "handle": {
-                  "maxLength": 64,
-                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
-                  "type": "string"
-                },
-                "label": {
-                  "maxLength": 120,
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "required": {
-                  "const": true
-                },
-                "schema": {
-                  "maxProperties": 100,
-                  "type": "object"
-                }
-              },
-              "required": [
-                "handle",
-                "label",
-                "description",
-                "required",
-                "schema"
-              ],
-              "type": "object"
-            },
-            "maxItems": 20,
-            "type": "array"
-          }
-        },
-        "required": [
-          "fields"
-        ],
-        "type": "object"
-      },
-      "research_tier": {
-        "enum": [
-          "skipped",
-          "recommended",
-          "required"
-        ]
-      },
-      "revision": {
-        "maxLength": 64,
-        "pattern": "^[0-9a-f]{64}$",
-        "type": "string"
-      },
-      "truncation": {
-        "additionalProperties": false,
-        "properties": {
-          "applied": {
-            "const": true
-          },
-          "omitted_items": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "original_result_bytes": {
-            "minimum": 1,
-            "type": "integer"
-          },
-          "reason": {
-            "const": "response_size_limit"
-          },
-          "truncated_values": {
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "applied",
-          "reason",
-          "omitted_items",
-          "truncated_values",
-          "original_result_bytes"
-        ],
-        "type": "object"
-      },
-      "versions": {
-        "additionalProperties": false,
-        "properties": {
-          "archetypes": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "capabilities": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "checks": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "guidance": {
-            "maxLength": 64,
-            "type": "string"
-          },
-          "models": {
-            "maxLength": 64,
-            "type": "string"
-          }
-        },
-        "required": [
-          "archetypes",
-          "capabilities",
-          "checks",
-          "guidance",
-          "models"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "build_ref",
-      "revision",
-      "contracts_in_response",
-      "editor_url",
-      "matched_archetypes",
-      "contract_bundle",
-      "archetype_bundle_role",
-      "research_tier",
-      "minimum_acceptance_categories",
-      "dsl_version",
-      "catalog_version",
-      "guidance_version",
-      "budget_ceiling"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "case_id": {
-        "maxLength": 64,
-        "minLength": 1,
-        "type": "string"
-      },
-      "error": {
-        "enum": [
-          "not_found",
-          "invalid_reference",
-          "invalid_params",
-          "revision_conflict",
-          "idempotency_conflict",
-          "document_too_large",
-          "payload_too_large",
-          "chunk_sequence_invalid",
-          "chunk_digest_mismatch",
-          "chunk_expired",
-          "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": {
+      "archetype_bundle_role": {
+        "const": "optional_guidance"
+      },
+      "budget_ceiling": {
+        "maxLength": 64,
+        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+        "type": "string"
+      },
+      "build_ref": {
+        "maxLength": 4096,
+        "minLength": 1,
+        "type": "string"
+      },
+      "catalog_version": {
+        "maxLength": 64,
+        "type": "string"
+      },
+      "contract_bundle": {
+        "additionalProperties": false,
+        "properties": {
+          "archetype": {
+            "oneOf": [
+              {
+                "additionalProperties": false,
+                "properties": {
+                  "archetype_id": {
+                    "maxLength": 64,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "capabilities": {
+                    "items": {
+                      "maxLength": 64,
+                      "type": "string"
+                    },
+                    "maxItems": 20,
+                    "type": "array"
+                  },
+                  "node_kinds": {
+                    "items": {
+                      "maxLength": 64,
+                      "type": "string"
+                    },
+                    "maxItems": 24,
+                    "type": "array"
+                  },
+                  "summary": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "title": {
+                    "maxLength": 120,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "archetype_id",
+                  "title",
+                  "summary",
+                  "capabilities",
+                  "node_kinds"
+                ],
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "catalog_version": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "input_contract": {
+            "additionalProperties": false,
+            "properties": {
+              "fields": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "description": {
+                      "maxLength": 500,
+                      "type": "string"
+                    },
+                    "handle": {
+                      "maxLength": 64,
+                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                      "type": "string"
+                    },
+                    "label": {
+                      "maxLength": 120,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "required": {
+                      "type": "boolean"
+                    },
+                    "schema": {
+                      "maxProperties": 100,
+                      "type": "object"
+                    }
+                  },
+                  "required": [
+                    "handle",
+                    "label",
+                    "description",
+                    "required",
+                    "schema"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 20,
+                "type": "array"
+              }
+            },
+            "required": [
+              "fields"
+            ],
+            "type": "object"
+          },
+          "output_contract": {
+            "additionalProperties": false,
+            "properties": {
+              "fields": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "description": {
+                      "maxLength": 500,
+                      "type": "string"
+                    },
+                    "handle": {
+                      "maxLength": 64,
+                      "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                      "type": "string"
+                    },
+                    "label": {
+                      "maxLength": 120,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "required": {
+                      "const": true
+                    },
+                    "schema": {
+                      "maxProperties": 100,
+                      "type": "object"
+                    }
+                  },
+                  "required": [
+                    "handle",
+                    "label",
+                    "description",
+                    "required",
+                    "schema"
+                  ],
+                  "type": "object"
+                },
+                "maxItems": 20,
+                "type": "array"
+              }
+            },
+            "required": [
+              "fields"
+            ],
+            "type": "object"
+          },
+          "recipe_spec": {
+            "type": "object"
+          },
+          "versions": {
+            "additionalProperties": false,
+            "properties": {
+              "archetypes": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "capabilities": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "checks": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "guidance": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "models": {
+                "maxLength": 64,
+                "type": "string"
+              }
+            },
+            "required": [
+              "archetypes",
+              "capabilities",
+              "checks",
+              "guidance",
+              "models"
+            ],
+            "type": "object"
+          }
+        },
+        "required": [
+          "catalog_version",
+          "archetype",
+          "input_contract",
+          "output_contract",
+          "recipe_spec"
+        ],
+        "type": "object"
+      },
+      "contracts_in_response": {
+        "type": "boolean"
+      },
+      "dsl_version": {
+        "minimum": 2,
+        "type": "integer"
+      },
+      "editor_url": {
+        "maxLength": 512,
+        "type": "string"
+      },
+      "guidance_version": {
+        "maxLength": 64,
+        "type": "string"
+      },
+      "input_contract": {
+        "additionalProperties": false,
+        "properties": {
+          "fields": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "description": {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                "handle": {
+                  "maxLength": 64,
+                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                  "type": "string"
+                },
+                "label": {
+                  "maxLength": 120,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "required": {
+                  "type": "boolean"
+                },
+                "schema": {
+                  "maxProperties": 100,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "handle",
+                "label",
+                "description",
+                "required",
+                "schema"
+              ],
+              "type": "object"
+            },
+            "maxItems": 20,
+            "type": "array"
+          }
+        },
+        "required": [
+          "fields"
+        ],
+        "type": "object"
+      },
+      "matched_archetypes": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "archetype_id": {
+              "maxLength": 64,
+              "minLength": 1,
+              "type": "string"
+            },
+            "capabilities": {
+              "items": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "maxItems": 20,
+              "type": "array"
+            },
+            "node_kinds": {
+              "items": {
+                "maxLength": 64,
+                "type": "string"
+              },
+              "maxItems": 24,
+              "type": "array"
+            },
+            "summary": {
+              "maxLength": 500,
+              "minLength": 1,
+              "type": "string"
+            },
+            "title": {
+              "maxLength": 120,
+              "minLength": 1,
+              "type": "string"
+            }
+          },
+          "required": [
+            "archetype_id",
+            "title",
+            "summary",
+            "capabilities",
+            "node_kinds"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "type": "array"
+      },
+      "minimum_acceptance_categories": {
+        "items": {
+          "maxLength": 64,
+          "type": "string"
+        },
+        "maxItems": 20,
+        "type": "array"
+      },
+      "output_contract": {
+        "additionalProperties": false,
+        "properties": {
+          "fields": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "description": {
+                  "maxLength": 500,
+                  "type": "string"
+                },
+                "handle": {
+                  "maxLength": 64,
+                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
+                  "type": "string"
+                },
+                "label": {
+                  "maxLength": 120,
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "required": {
+                  "const": true
+                },
+                "schema": {
+                  "maxProperties": 100,
+                  "type": "object"
+                }
+              },
+              "required": [
+                "handle",
+                "label",
+                "description",
+                "required",
+                "schema"
+              ],
+              "type": "object"
+            },
+            "maxItems": 20,
+            "type": "array"
+          }
+        },
+        "required": [
+          "fields"
+        ],
+        "type": "object"
+      },
+      "research_tier": {
+        "enum": [
+          "skipped",
+          "recommended",
+          "required"
+        ]
+      },
+      "revision": {
+        "maxLength": 64,
+        "pattern": "^[0-9a-f]{64}$",
+        "type": "string"
+      },
+      "truncation": {
+        "additionalProperties": false,
+        "properties": {
+          "applied": {
+            "const": true
+          },
+          "omitted_items": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "original_result_bytes": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "reason": {
+            "const": "response_size_limit"
+          },
+          "truncated_values": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "applied",
+          "reason",
+          "omitted_items",
+          "truncated_values",
+          "original_result_bytes"
+        ],
+        "type": "object"
+      },
+      "versions": {
+        "additionalProperties": false,
+        "properties": {
+          "archetypes": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "capabilities": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "checks": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "guidance": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "models": {
+            "maxLength": 64,
+            "type": "string"
+          }
+        },
+        "required": [
+          "archetypes",
+          "capabilities",
+          "checks",
+          "guidance",
+          "models"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "build_ref",
+      "revision",
+      "contracts_in_response",
+      "editor_url",
+      "matched_archetypes",
+      "contract_bundle",
+      "archetype_bundle_role",
+      "research_tier",
+      "minimum_acceptance_categories",
+      "dsl_version",
+      "catalog_version",
+      "guidance_version",
+      "budget_ceiling"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "case_id": {
+        "maxLength": 64,
+        "minLength": 1,
+        "type": "string"
+      },
+      "error": {
+        "enum": [
+          "not_found",
+          "invalid_reference",
+          "invalid_params",
+          "revision_conflict",
+          "idempotency_conflict",
+          "document_too_large",
+          "payload_too_large",
+          "chunk_sequence_invalid",
+          "chunk_digest_mismatch",
+          "chunk_expired",
+          "invalid_cursor",
+          "suite_duplicate_case_id",
+          "suite_unresolved_pair",
+          "suite_schema_invalid",
+          "suite_missing_categories",
+          "suite_weak_normal_oracle",
+          "suite_too_large",
+          "unknown_case_id",
+          "duplicate_case_id",
+          "incomplete_case_selection",
+          "unsupported_node_kind",
+          "research_required",
+          "review_required",
+          "acceptance_required",
+          "qualification_stale",
+          "budget_not_approved",
+          "budget_exhausted",
+          "budget_superseded",
+          "budget_capability_consumed",
+          "budget_capability_expired",
+          "acceptance_case_cost_exceeded",
+          "authoring_budget_exceeded",
+          "authoring_grant_not_active",
+          "insufficient_credits",
+          "billing_anomaly",
+          "activity_stalled",
+          "activity_in_flight",
+          "handoff_approval_required",
+          "handoff_expired",
+          "handoff_not_pending",
+          "handoff_stale",
+          "handoff_disclosure_incomplete",
+          "feature_unavailable",
+          "resource_unavailable",
+          "resource_binding_required",
+          "resource_requirement_not_found",
+          "activity_not_cancellable",
+          "quota_exceeded",
+          "rate_limited",
+          "already_published",
+          "safety_locked",
+          "build_terminal",
+          "commit_capability_expired",
+          "account_unavailable",
+          "limit_unavailable"
+        ]
+      },
+      "estimated_credits": {
+        "maxLength": 64,
+        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+        "type": "string"
+      },
+      "field": {
+        "maxLength": 64,
+        "type": "string"
+      },
+      "hint": {
+        "maxLength": 240,
+        "type": "string"
+      },
+      "issue": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "field": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "operator": {
+            "maxLength": 64,
+            "type": "string"
+          },
+          "path": {
+            "maxLength": 512,
+            "type": "string"
+          },
+          "type": {
+            "maxLength": 64,
+            "type": "string"
+          }
+        },
+        "required": [
+          "code",
+          "path"
+        ],
+        "type": "object"
+      },
+      "limit_credits": {
+        "maxLength": 64,
+        "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+        "type": "string"
+      },
+      "missing_categories": {
+        "items": {
+          "maxLength": 64,
+          "type": "string"
+        },
+        "maxItems": 10,
+        "type": "array",
+        "uniqueItems": true
+      },
+      "repair_hint": {
+        "maxLength": 500,
+        "type": "string"
+      },
+      "retry_after_seconds": {
+        "maximum": 86400,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "review_cost": {
+        "additionalProperties": false,
+        "properties": {
+          "basis": {
+            "const": "utf8_byte_upper_bound"
+          },
+          "estimated_credits": {
+            "maxLength": 64,
+            "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+            "type": "string"
+          },
+          "input_token_bound": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "limit_credits": {
+            "maxLength": 64,
+            "pattern": "^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$",
+            "type": "string"
+          },
+          "model": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "output_token_cap": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "prompt_bytes": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "provider": {
+            "maxLength": 200,
+            "type": "string"
+          },
+          "section_bytes": {
+            "additionalProperties": false,
+            "properties": {
+              "acceptance_suite": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "input_contract": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "intent": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "output_contract": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "research_evidence": {
+                "minimum": 0,
+                "type": "integer"
+              },
+              "spec": {
+                "minimum": 0,
+                "type": "integer"
+              }
+            },
+            "required": [],
+            "type": "object"
+          }
+        },
+        "required": [
+          "estimated_credits",
+          "limit_credits",
+          "provider",
+          "model",
+          "basis",
+          "input_token_bound",
+          "output_token_cap",
+          "prompt_bytes",
+          "section_bytes"
+        ],
+        "type": "object"
+      },
+      "truncation": {
+        "additionalProperties": false,
+        "properties": {
+          "applied": {
+            "const": true
+          },
+          "omitted_items": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "original_result_bytes": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "reason": {
+            "const": "response_size_limit"
+          },
+          "truncated_values": {
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "applied",
+          "reason",
+          "omitted_items",
+          "truncated_values",
+          "original_result_bytes"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  }
+]
  3. First observed

TDQS

A3.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds real value beyond the annotations: it discloses that the response returns stored contracts only when they fit the bounded result, that the archetype bundle is optional guidance rather than the build contract, and that richer input constraints must be handled in recipe logic and tested rather than claimed as enforced. This behavioral context is not signaled anywhere in the structured annotations and is genuinely useful. No contradiction with annotations (idempotentHint=true aligns with the idempotency-related context, readOnlyHint=false matches the create operation).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is dense but purposeful, front-loading the purpose in sentence one and adding behavioral and constraint context in the following sentences. It's longer than ideal but every sentence earns its place, covering response semantics, constraint enforcement, and the source-adaptation option.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

This is a complex tool (10 params, 9 required, nested objects, 2 enums) and the description covers the most important semantics well, including response behavior and input constraint philosophy. But it leaves the enums (quality_profile, research_policy, capabilities, risk_domains) and the idempotency_key contract unexplained, relying on the output schema and agent inference to fill gaps.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 0%, so the description carries the burden. It partially compensates by explaining source_recipe_ref's purpose and setting input string constraint norms (type:string, positive maxLength, minLength:1 only on required inputs). However, it does not address several key parameters (idempotency_key semantics, quality_profile, research_policy, capabilities, risk_domains), leaving the agent to infer or open the schema for those.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence 'Create a private recipe build from a bounded intent and declared contract' gives a specific verb, resource, and scope, and the 'private draft' wording helps distinguish it from update/commit siblings. However, it doesn't explicitly name which siblings it is not (e.g., update_recipe_build, commit_recipe_build), leaving some differentiation to inference.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use it (creating a new private draft) and explains the optional source_recipe_ref for adapting owned or public-open recipes, which is genuinely useful routing context. But it never explicitly states when NOT to use it or names alternatives like update_recipe_build or review_recipe_build, so the guidance is implied rather than explicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All StewAI toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources