Skip to main content
Glama
Sourcey

Sourcey

Official

Prepare an Agent Readiness declaration

prepare_declaration
Read-onlyIdempotent

Prepare a canonical Agent Readiness declaration draft for one service and job, including participants, endpoints, API/MCP interfaces, job operations, and optional verified-run bindings.

Instructions

Prepare the canonical Agent Readiness declaration for one service and job: participants, endpoints, API and MCP interfaces, the job operation on each interface that performs the job (the request the probes send with no account, or the operation in the vendor's OpenAPI document where the interface has no public endpoint), and optional job bindings for a verified run. The company must already exist in Sourcey and resolves by exact identity; an unknown company returns identity_allocation_required. Complete declarations use POST /v1/submissions as product agent_readiness. Drafts grant no publication, verification or grade, and startup credits and deals never count as service readiness.

Input Schema

NameRequiredDescriptionDefault
scopeNo
subjectNo
endpointsYes
relationsYes
resourcesYes
interfacesYes
declared_atNo
job_bindingsYes
participantsYes
subject_rolesYes
job_operationsYes
offer_relationsYes
authority_intentNo
command_contractYes
scope_source_urisYes
account_operationsNo
surface_exclusionsYes
base_authoring_fileNo

Output Schema

NameRequiredDescriptionDefault
dataYes
release_idYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changedv1.0.1
    • addedInput schema / definitions
      Added value: +{
      +  "__schema0": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "number"
      +      },
      +      {
      +        "type": "boolean"
      +      },
      +      {
      +        "type": "null"
      +      },
      +      {
      +        "items": {
      +          "$ref": "#/definitions/__schema0"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "additionalProperties": {
      +          "$ref": "#/definitions/__schema0"
      +        },
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "__schema1": {
      +    "anyOf": [
      +      {
      +        "type": "string"
      +      },
      +      {
      +        "type": "number"
      +      },
      +      {
      +        "type": "boolean"
      +      },
      +      {
      +        "type": "null"
      +      },
      +      {
      +        "items": {
      +          "$ref": "#/definitions/__schema1"
      +        },
      +        "type": "array"
      +      },
      +      {
      +        "additionalProperties": {
      +          "$ref": "#/definitions/__schema1"
      +        },
      +        "propertyNames": {
      +          "type": "string"
      +        },
      +        "type": "object"
      +      }
      +    ]
      +  }
      +}
    • addedInput schema / properties / account_operations
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "operation": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "endpoint_id": {
      +            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +            "type": "string"
      +          },
      +          "interface_id": {
      +            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +            "type": "string"
      +          },
      +          "method": {
      +            "enum": [
      +              "POST",
      +              "PUT",
      +              "PATCH"
      +            ],
      +            "type": "string"
      +          },
      +          "operation_id": {
      +            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +            "type": "string"
      +          },
      +          "role": {
      +            "enum": [
      +              "registration",
      +              "top_up"
      +            ],
      +            "type": "string"
      +          },
      +          "spec_url": {
      +            "format": "uri",
      +            "maxLength": 2048,
      +            "type": "string"
      +          },
      +          "url": {
      +            "format": "uri",
      +            "maxLength": 2048,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "operation_id",
      +          "interface_id",
      +          "role",
      +          "endpoint_id",
      +          "method",
      +          "url",
      +          "spec_url"
      +        ],
      +        "type": "object"
      +      },
      +      "source_uris": {
      +        "items": {
      +          "format": "uri",
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "operation",
      +      "source_uris"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / assessment_targets
      Removed value: -{
      -  "default": [],
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "interface_ids": {
      -        "items": {
      -          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "name": {
      -        "maxLength": 240,
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "source_uris": {
      -        "items": {
      -          "format": "uri",
      -          "type": "string"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "target_id": {
      -        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "target_id",
      -      "name",
      -      "interface_ids",
      -      "source_uris"
      -    ],
      -    "type": "object"
      -  },
      -  "type": "array"
      -}
    • changedInput schema / properties / endpoints / items / properties / roles / items / enum
      Previous value: -[
      -  "service",
      -  "authorization",
      -  "token",
      -  "registration",
      -  "protected_resource",
      -  "checkout",
      -  "status",
      -  "recovery",
      -  "webhook"
      -]New value: +[
      +  "service",
      +  "authorization",
      +  "token",
      +  "registration",
      +  "access_request",
      +  "access_setting",
      +  "claim",
      +  "protected_resource",
      +  "checkout",
      +  "top_up",
      +  "key_renewal",
      +  "status",
      +  "recovery",
      +  "webhook"
      +]
    • addedInput schema / properties / job_bindings
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "binding": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "assertions": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "assertion": {
      +                  "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                  "type": "string"
      +                },
      +                "observations": {
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "call": {
      +                        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                        "type": "string"
      +                      },
      +                      "name": {
      +                        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                        "type": "string"
      +                      },
      +                      "pointer": {
      +                        "maxLength": 256,
      +                        "pattern": "^(?:\\/(?:[^~/]|~[01])*)*$",
      +                        "type": "string"
      +                      },
      +                      "source": {
      +                        "enum": [
      +                          "json",
      +                          "stream",
      +                          "request"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "name",
      +                      "call",
      +                      "source",
      +                      "pointer"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "maxItems": 8,
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "assertion",
      +                "observations"
      +              ],
      +              "type": "object"
      +            },
      +            "maxItems": 8,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "binding_id": {
      +            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +            "type": "string"
      +          },
      +          "calls": {
      +            "items": {
      +              "oneOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "body": {
      +                      "anyOf": [
      +                        {
      +                          "oneOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "json": {
      +                                  "$ref": "#/definitions/__schema0"
      +                                },
      +                                "media_type": {
      +                                  "const": "application/json",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "media_type",
      +                                "json"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "form": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "name": {
      +                                        "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                        "type": "string"
      +                                      },
      +                                      "value": {
      +                                        "maxLength": 2048,
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "name",
      +                                      "value"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "maxItems": 32,
      +                                  "type": "array"
      +                                },
      +                                "media_type": {
      +                                  "const": "application/x-www-form-urlencoded",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "media_type",
      +                                "form"
      +                              ],
      +                              "type": "object"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "call_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "credentials": {
      +                      "items": {
      +                        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                        "type": "string"
      +                      },
      +                      "maxItems": 4,
      +                      "type": "array"
      +                    },
      +                    "endpoint_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "headers": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "name": {
      +                            "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                            "type": "string"
      +                          },
      +                          "value": {
      +                            "maxLength": 512,
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "name",
      +                          "value"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "maxItems": 16,
      +                      "type": "array"
      +                    },
      +                    "kind": {
      +                      "const": "http",
      +                      "type": "string"
      +                    },
      +                    "method": {
      +                      "enum": [
      +                        "GET",
      +                        "HEAD",
      +                        "POST",
      +                        "PUT",
      +                        "PATCH",
      +                        "DELETE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "maxLength": 2048,
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "kind",
      +                    "call_id",
      +                    "endpoint_id",
      +                    "method",
      +                    "url",
      +                    "headers",
      +                    "body",
      +                    "credentials"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "arguments": {
      +                      "$ref": "#/definitions/__schema1"
      +                    },
      +                    "call_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "credentials": {
      +                      "items": {
      +                        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                        "type": "string"
      +                      },
      +                      "maxItems": 4,
      +                      "type": "array"
      +                    },
      +                    "endpoint_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "kind": {
      +                      "const": "mcp",
      +                      "type": "string"
      +                    },
      +                    "tool": {
      +                      "maxLength": 128,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "kind",
      +                    "call_id",
      +                    "endpoint_id",
      +                    "tool",
      +                    "arguments",
      +                    "credentials"
      +                  ],
      +                  "type": "object"
      +                }
      +              ]
      +            },
      +            "maxItems": 8,
      +            "minItems": 1,
      +            "type": "array"
      +          },
      +          "cleanup": {
      +            "items": {
      +              "oneOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "body": {
      +                      "anyOf": [
      +                        {
      +                          "oneOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "json": {
      +                                  "$ref": "#/definitions/__schema0"
      +                                },
      +                                "media_type": {
      +                                  "const": "application/json",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "media_type",
      +                                "json"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "form": {
      +                                  "items": {
      +                                    "additionalProperties": false,
      +                                    "properties": {
      +                                      "name": {
      +                                        "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                        "type": "string"
      +                                      },
      +                                      "value": {
      +                                        "maxLength": 2048,
      +                                        "type": "string"
      +                                      }
      +                                    },
      +                                    "required": [
      +                                      "name",
      +                                      "value"
      +                                    ],
      +                                    "type": "object"
      +                                  },
      +                                  "maxItems": 32,
      +                                  "type": "array"
      +                                },
      +                                "media_type": {
      +                                  "const": "application/x-www-form-urlencoded",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "media_type",
      +                                "form"
      +                              ],
      +                              "type": "object"
      +                            }
      +                          ]
      +                        },
      +                        {
      +                          "type": "null"
      +                        }
      +                      ]
      +                    },
      +                    "call_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "credentials": {
      +                      "items": {
      +                        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                        "type": "string"
      +                      },
      +                      "maxItems": 4,
      +                      "type": "array"
      +                    },
      +                    "endpoint_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "headers": {
      +                      "items": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "name": {
      +                            "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                            "type": "string"
      +                          },
      +                          "value": {
      +                            "maxLength": 512,
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "name",
      +                          "value"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "maxItems": 16,
      +                      "type": "array"
      +                    },
      +                    "kind": {
      +                      "const": "http",
      +                      "type": "string"
      +                    },
      +                    "method": {
      +                      "enum": [
      +                        "GET",
      +                        "HEAD",
      +                        "POST",
      +                        "PUT",
      +                        "PATCH",
      +                        "DELETE"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "url": {
      +                      "maxLength": 2048,
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "kind",
      +                    "call_id",
      +                    "endpoint_id",
      +                    "method",
      +                    "url",
      +                    "headers",
      +                    "body",
      +                    "credentials"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "arguments": {
      +                      "$ref": "#/definitions/__schema1"
      +                    },
      +                    "call_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "credentials": {
      +                      "items": {
      +                        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                        "type": "string"
      +                      },
      +                      "maxItems": 4,
      +                      "type": "array"
      +                    },
      +                    "endpoint_id": {
      +                      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                      "type": "string"
      +                    },
      +                    "kind": {
      +                      "const": "mcp",
      +                      "type": "string"
      +                    },
      +                    "tool": {
      +                      "maxLength": 128,
      +                      "minLength": 1,
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "kind",
      +                    "call_id",
      +                    "endpoint_id",
      +                    "tool",
      +                    "arguments",
      +                    "credentials"
      +                  ],
      +                  "type": "object"
      +                }
      +              ]
      +            },
      +            "maxItems": 4,
      +            "type": "array"
      +          },
      +          "delegation": {
      +            "oneOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "kind": {
      +                    "const": "none",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "credentials": {
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "endpoint_ids": {
      +                          "items": {
      +                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                            "type": "string"
      +                          },
      +                          "maxItems": 8,
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "methods": {
      +                          "items": {
      +                            "enum": [
      +                              "GET",
      +                              "HEAD",
      +                              "POST",
      +                              "PUT",
      +                              "PATCH",
      +                              "DELETE"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "placement": {
      +                          "anyOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "header_name": {
      +                                  "const": "authorization",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "enum": [
      +                                    "bearer",
      +                                    "basic"
      +                                  ],
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "header_name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "header_name": {
      +                                  "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "const": "header",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "header_name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "field": {
      +                                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "const": "form",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "field"
      +                              ],
      +                              "type": "object"
      +                            }
      +                          ]
      +                        },
      +                        "role": {
      +                          "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "role",
      +                        "placement",
      +                        "endpoint_ids",
      +                        "methods"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "maxItems": 4,
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "kind": {
      +                    "const": "entered",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind",
      +                  "credentials"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "authorization_endpoint_id": {
      +                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                    "type": "string"
      +                  },
      +                  "client": {
      +                    "enum": [
      +                      "client_id_metadata_document",
      +                      "dynamic_registration",
      +                      "preregistered"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "keep": {
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "endpoint_ids": {
      +                          "items": {
      +                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                            "type": "string"
      +                          },
      +                          "maxItems": 8,
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "expires_in_pointer": {
      +                          "maxLength": 256,
      +                          "pattern": "^(?:\\/(?:[^~/]|~[01])*)*$",
      +                          "type": "string"
      +                        },
      +                        "methods": {
      +                          "items": {
      +                            "enum": [
      +                              "GET",
      +                              "HEAD",
      +                              "POST",
      +                              "PUT",
      +                              "PATCH",
      +                              "DELETE"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "placement": {
      +                          "anyOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "header_name": {
      +                                  "const": "authorization",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "enum": [
      +                                    "bearer",
      +                                    "basic"
      +                                  ],
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "header_name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "header_name": {
      +                                  "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "const": "header",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "header_name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "field": {
      +                                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "const": "form",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "field"
      +                              ],
      +                              "type": "object"
      +                            }
      +                          ]
      +                        },
      +                        "pointer": {
      +                          "maxLength": 256,
      +                          "pattern": "^(?:\\/(?:[^~/]|~[01])*)*$",
      +                          "type": "string"
      +                        },
      +                        "role": {
      +                          "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "role",
      +                        "placement",
      +                        "endpoint_ids",
      +                        "methods",
      +                        "pointer"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "maxItems": 4,
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "kind": {
      +                    "const": "oauth",
      +                    "type": "string"
      +                  },
      +                  "scopes": {
      +                    "items": {
      +                      "pattern": "^[\\x21\\x23-\\x5B\\x5D-\\x7E]{1,128}$",
      +                      "type": "string"
      +                    },
      +                    "maxItems": 32,
      +                    "type": "array"
      +                  },
      +                  "token_endpoint_id": {
      +                    "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind",
      +                  "authorization_endpoint_id",
      +                  "token_endpoint_id",
      +                  "client",
      +                  "scopes",
      +                  "keep"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "call": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "body": {
      +                        "anyOf": [
      +                          {
      +                            "oneOf": [
      +                              {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "json": {
      +                                    "$ref": "#/definitions/__schema0"
      +                                  },
      +                                  "media_type": {
      +                                    "const": "application/json",
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "media_type",
      +                                  "json"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "form": {
      +                                    "items": {
      +                                      "additionalProperties": false,
      +                                      "properties": {
      +                                        "name": {
      +                                          "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                          "type": "string"
      +                                        },
      +                                        "value": {
      +                                          "maxLength": 2048,
      +                                          "type": "string"
      +                                        }
      +                                      },
      +                                      "required": [
      +                                        "name",
      +                                        "value"
      +                                      ],
      +                                      "type": "object"
      +                                    },
      +                                    "maxItems": 32,
      +                                    "type": "array"
      +                                  },
      +                                  "media_type": {
      +                                    "const": "application/x-www-form-urlencoded",
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "media_type",
      +                                  "form"
      +                                ],
      +                                "type": "object"
      +                              }
      +                            ]
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "call_id": {
      +                        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                        "type": "string"
      +                      },
      +                      "credentials": {
      +                        "items": {
      +                          "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                          "type": "string"
      +                        },
      +                        "maxItems": 4,
      +                        "type": "array"
      +                      },
      +                      "endpoint_id": {
      +                        "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                        "type": "string"
      +                      },
      +                      "headers": {
      +                        "items": {
      +                          "additionalProperties": false,
      +                          "properties": {
      +                            "name": {
      +                              "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                              "type": "string"
      +                            },
      +                            "value": {
      +                              "maxLength": 512,
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "name",
      +                            "value"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "maxItems": 16,
      +                        "type": "array"
      +                      },
      +                      "kind": {
      +                        "const": "http",
      +                        "type": "string"
      +                      },
      +                      "method": {
      +                        "enum": [
      +                          "GET",
      +                          "HEAD",
      +                          "POST",
      +                          "PUT",
      +                          "PATCH",
      +                          "DELETE"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "url": {
      +                        "maxLength": 2048,
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "kind",
      +                      "call_id",
      +                      "endpoint_id",
      +                      "method",
      +                      "url",
      +                      "headers",
      +                      "body",
      +                      "credentials"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "from": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "endpoint_ids": {
      +                        "items": {
      +                          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                          "type": "string"
      +                        },
      +                        "maxItems": 8,
      +                        "minItems": 1,
      +                        "type": "array"
      +                      },
      +                      "methods": {
      +                        "items": {
      +                          "enum": [
      +                            "GET",
      +                            "HEAD",
      +                            "POST",
      +                            "PUT",
      +                            "PATCH",
      +                            "DELETE"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "minItems": 1,
      +                        "type": "array"
      +                      },
      +                      "placement": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "header_name": {
      +                                "const": "authorization",
      +                                "type": "string"
      +                              },
      +                              "scheme": {
      +                                "enum": [
      +                                  "bearer",
      +                                  "basic"
      +                                ],
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "scheme",
      +                              "header_name"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "header_name": {
      +                                "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                                "type": "string"
      +                              },
      +                              "scheme": {
      +                                "const": "header",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "scheme",
      +                              "header_name"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "field": {
      +                                "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                "type": "string"
      +                              },
      +                              "scheme": {
      +                                "const": "form",
      +                                "type": "string"
      +                              }
      +                            },
      +                            "required": [
      +                              "scheme",
      +                              "field"
      +                            ],
      +                            "type": "object"
      +                          }
      +                        ]
      +                      },
      +                      "role": {
      +                        "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "role",
      +                      "placement",
      +                      "endpoint_ids",
      +                      "methods"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "keep": {
      +                    "items": {
      +                      "additionalProperties": false,
      +                      "properties": {
      +                        "endpoint_ids": {
      +                          "items": {
      +                            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                            "type": "string"
      +                          },
      +                          "maxItems": 8,
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "expires_in_pointer": {
      +                          "maxLength": 256,
      +                          "pattern": "^(?:\\/(?:[^~/]|~[01])*)*$",
      +                          "type": "string"
      +                        },
      +                        "methods": {
      +                          "items": {
      +                            "enum": [
      +                              "GET",
      +                              "HEAD",
      +                              "POST",
      +                              "PUT",
      +                              "PATCH",
      +                              "DELETE"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "minItems": 1,
      +                          "type": "array"
      +                        },
      +                        "placement": {
      +                          "anyOf": [
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "header_name": {
      +                                  "const": "authorization",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "enum": [
      +                                    "bearer",
      +                                    "basic"
      +                                  ],
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "header_name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "header_name": {
      +                                  "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "const": "header",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "header_name"
      +                              ],
      +                              "type": "object"
      +                            },
      +                            {
      +                              "additionalProperties": false,
      +                              "properties": {
      +                                "field": {
      +                                  "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                                  "type": "string"
      +                                },
      +                                "scheme": {
      +                                  "const": "form",
      +                                  "type": "string"
      +                                }
      +                              },
      +                              "required": [
      +                                "scheme",
      +                                "field"
      +                              ],
      +                              "type": "object"
      +                            }
      +                          ]
      +                        },
      +                        "pointer": {
      +                          "maxLength": 256,
      +                          "pattern": "^(?:\\/(?:[^~/]|~[01])*)*$",
      +                          "type": "string"
      +                        },
      +                        "role": {
      +                          "pattern": "^[a-z][a-z0-9_]{0,63}$",
      +                          "type": "string"
      +                        }
      +                      },
      +                      "required": [
      +                        "role",
      +                        "placement",
      +                        "endpoint_ids",
      +                        "methods",
      +                        "pointer"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "maxItems": 4,
      +                    "minItems": 1,
      +                    "type": "array"
      +                  },
      +                  "kind": {
      +                    "const": "minted",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind",
      +                  "from",
      +                  "call",
      +                  "keep"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          },
      +          "interface_id": {
      +            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +            "type": "string"
      +          },
      +          "payment": {
      +            "oneOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "kind": {
      +                    "const": "none",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "kind": {
      +                    "const": "prepaid_balance",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "kind": {
      +                    "const": "per_call",
      +                    "type": "string"
      +                  },
      +                  "protocol": {
      +                    "enum": [
      +                      "x402",
      +                      "mpp"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "kind",
      +                  "protocol"
      +                ],
      +                "type": "object"
      +              }
      +            ]
      +          }
      +        },
      +        "required": [
      +          "binding_id",
      +          "interface_id",
      +          "calls",
      +          "assertions",
      +          "delegation",
      +          "payment",
      +          "cleanup"
      +        ],
      +        "type": "object"
      +      },
      +      "source_uris": {
      +        "items": {
      +          "format": "uri",
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "binding",
      +      "source_uris"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / job_operations
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "operation": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "body": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "credential_field": {
      +                        "pattern": "^[A-Za-z0-9_.-]{1,64}$",
      +                        "type": "string"
      +                      },
      +                      "media_type": {
      +                        "maxLength": 127,
      +                        "pattern": "^[a-z]+\\/[a-z0-9][a-z0-9.+-]*$",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "media_type"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "endpoint_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "headers": {
      +                "items": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "name": {
      +                      "pattern": "^[a-z0-9!#$%&'*+.^_`|~-]{1,128}$",
      +                      "type": "string"
      +                    },
      +                    "value": {
      +                      "pattern": "^[\\x21-\\x7E](?:[\\x20-\\x7E]{0,510}[\\x21-\\x7E])?$",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "name",
      +                    "value"
      +                  ],
      +                  "type": "object"
      +                },
      +                "maxItems": 8,
      +                "type": "array"
      +              },
      +              "interface_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "kind": {
      +                "const": "http",
      +                "type": "string"
      +              },
      +              "method": {
      +                "enum": [
      +                  "GET",
      +                  "POST",
      +                  "PUT",
      +                  "PATCH"
      +                ],
      +                "type": "string"
      +              },
      +              "operation_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "spec": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "key_operations": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "create": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "method": {
      +                                    "enum": [
      +                                      "GET",
      +                                      "POST",
      +                                      "PUT",
      +                                      "PATCH",
      +                                      "DELETE"
      +                                    ],
      +                                    "type": "string"
      +                                  },
      +                                  "path": {
      +                                    "maxLength": 512,
      +                                    "pattern": "^\\/[\\x21-\\x7E]*$",
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "method",
      +                                  "path"
      +                                ],
      +                                "type": "object"
      +                              },
      +                              "revoke": {
      +                                "additionalProperties": false,
      +                                "properties": {
      +                                  "method": {
      +                                    "enum": [
      +                                      "GET",
      +                                      "POST",
      +                                      "PUT",
      +                                      "PATCH",
      +                                      "DELETE"
      +                                    ],
      +                                    "type": "string"
      +                                  },
      +                                  "path": {
      +                                    "maxLength": 512,
      +                                    "pattern": "^\\/[\\x21-\\x7E]*$",
      +                                    "type": "string"
      +                                  }
      +                                },
      +                                "required": [
      +                                  "method",
      +                                  "path"
      +                                ],
      +                                "type": "object"
      +                              }
      +                            },
      +                            "required": [
      +                              "create",
      +                              "revoke"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "url": {
      +                        "format": "uri",
      +                        "maxLength": 2048,
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "url",
      +                      "key_operations"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "url": {
      +                "format": "uri",
      +                "maxLength": 2048,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "operation_id",
      +              "interface_id",
      +              "kind",
      +              "endpoint_id",
      +              "method",
      +              "url",
      +              "headers",
      +              "body",
      +              "spec"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "endpoint_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "interface_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "kind": {
      +                "const": "mcp",
      +                "type": "string"
      +              },
      +              "operation_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "tool": {
      +                "pattern": "^[A-Za-z0-9_.\\-/]{1,128}$",
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "operation_id",
      +              "interface_id",
      +              "kind",
      +              "endpoint_id",
      +              "tool"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "interface_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "key_operations": {
      +                "anyOf": [
      +                  {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "create": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "method": {
      +                            "enum": [
      +                              "GET",
      +                              "POST",
      +                              "PUT",
      +                              "PATCH",
      +                              "DELETE"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "path": {
      +                            "maxLength": 512,
      +                            "pattern": "^\\/[\\x21-\\x7E]*$",
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "method",
      +                          "path"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "revoke": {
      +                        "additionalProperties": false,
      +                        "properties": {
      +                          "method": {
      +                            "enum": [
      +                              "GET",
      +                              "POST",
      +                              "PUT",
      +                              "PATCH",
      +                              "DELETE"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "path": {
      +                            "maxLength": 512,
      +                            "pattern": "^\\/[\\x21-\\x7E]*$",
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "method",
      +                          "path"
      +                        ],
      +                        "type": "object"
      +                      }
      +                    },
      +                    "required": [
      +                      "create",
      +                      "revoke"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  {
      +                    "type": "null"
      +                  }
      +                ]
      +              },
      +              "kind": {
      +                "const": "spec",
      +                "type": "string"
      +              },
      +              "method": {
      +                "enum": [
      +                  "GET",
      +                  "POST",
      +                  "PUT",
      +                  "PATCH",
      +                  "DELETE"
      +                ],
      +                "type": "string"
      +              },
      +              "operation_id": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "path": {
      +                "maxLength": 512,
      +                "pattern": "^\\/[\\x21-\\x7E]*$",
      +                "type": "string"
      +              },
      +              "spec_url": {
      +                "format": "uri",
      +                "maxLength": 2048,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "operation_id",
      +              "interface_id",
      +              "kind",
      +              "spec_url",
      +              "method",
      +              "path",
      +              "key_operations"
      +            ],
      +            "type": "object"
      +          }
      +        ]
      +      },
      +      "source_uris": {
      +        "items": {
      +          "format": "uri",
      +          "type": "string"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "operation",
      +      "source_uris"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / properties / offer_relations / items / properties / applicable_stages
      Removed value: -{
      -  "items": {
      -    "enum": [
      -      "evaluate",
      -      "sign_up",
      -      "pay",
      -      "provision",
      -      "operate"
      -    ],
      -    "type": "string"
      -  },
      -  "minItems": 1,
      -  "type": "array"
      -}
    • changedInput schema / properties / offer_relations / items / required
      Previous value: -[
      -  "offer_relation_proposal_id",
      -  "offer_id",
      -  "purpose",
      -  "applicable_stages",
      -  "source_uris"
      -]New value: +[
      +  "offer_relation_proposal_id",
      +  "offer_id",
      +  "purpose",
      +  "source_uris"
      +]
    • removedInput schema / properties / scope / properties / funnel
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "key": {
      -      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      -      "type": "string"
      -    },
      -    "name": {
      -      "maxLength": 160,
      -      "minLength": 1,
      -      "type": "string"
      -    }
      -  },
      -  "required": [
      -    "key",
      -    "name"
      -  ],
      -  "type": "object"
      -}
    • addedInput schema / properties / scope / properties / job
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "key": {
      +      "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +      "type": "string"
      +    },
      +    "name": {
      +      "maxLength": 160,
      +      "minLength": 1,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "key",
      +    "name"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / properties / scope / required
      Previous value: -[
      -  "product",
      -  "funnel"
      -]New value: +[
      +  "product",
      +  "job"
      +]
    • changedInput schema / required
      Previous value: -[
      -  "command_contract",
      -  "scope_source_uris",
      -  "subject_roles",
      -  "assessment_targets",
      -  "participants",
      -  "resources",
      -  "endpoints",
      -  "interfaces",
      -  "relations",
      -  "offer_relations",
      -  "surface_exclusions"
      -]New value: +[
      +  "command_contract",
      +  "scope_source_uris",
      +  "subject_roles",
      +  "job_operations",
      +  "job_bindings",
      +  "participants",
      +  "resources",
      +  "endpoints",
      +  "interfaces",
      +  "relations",
      +  "offer_relations",
      +  "surface_exclusions"
      +]
    • changedOutput schema / properties / data / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "diagnostics": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "required",
      -                "invalid",
      -                "ambiguous_identity",
      -                "cross_entity_offer",
      -                "base_authoring_mismatch"
      -              ],
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 500,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "path": {
      -              "format": "starts_with",
      -              "pattern": "^\\/.*",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "path",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "status": {
      -        "const": "invalid",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "diagnostics"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "diagnostics": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "required",
      -                "invalid",
      -                "ambiguous_identity",
      -                "cross_entity_offer",
      -                "base_authoring_mismatch"
      -              ],
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 500,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "path": {
      -              "format": "starts_with",
      -              "pattern": "^\\/.*",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "path",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "status": {
      -        "const": "identity_allocation_required",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "diagnostics"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base_release_id": {
      -        "pattern": "^sha256:[a-f0-9]{64}$",
      -        "type": "string"
      -      },
      -      "diagnostics": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "required",
      -                "invalid",
      -                "ambiguous_identity",
      -                "cross_entity_offer",
      -                "base_authoring_mismatch"
      -              ],
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 500,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "path": {
      -              "format": "starts_with",
      -              "pattern": "^\\/.*",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "path",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "entity_id": {
      -        "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$",
      -        "type": "string"
      -      },
      -      "entity_revision_digest": {
      -        "pattern": "^sha256:[a-f0-9]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "incomplete",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "base_release_id",
      -      "entity_id",
      -      "entity_revision_digest",
      -      "diagnostics"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "base_release_id": {
      -        "pattern": "^sha256:[a-f0-9]{64}$",
      -        "type": "string"
      -      },
      -      "diagnostics": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "required",
      -                "invalid",
      -                "ambiguous_identity",
      -                "cross_entity_offer",
      -                "base_authoring_mismatch"
      -              ],
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 500,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "path": {
      -              "format": "starts_with",
      -              "pattern": "^\\/.*",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "path",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "minItems": 1,
      -        "type": "array"
      -      },
      -      "entity_id": {
      -        "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$",
      -        "type": "string"
      -      },
      -      "entity_revision_digest": {
      -        "pattern": "^sha256:[a-f0-9]{64}$",
      -        "type": "string"
      -      },
      -      "status": {
      -        "const": "conflict",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "base_release_id",
      -      "diagnostics"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "authoring_file": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "content": {
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "content_digest": {
      -            "pattern": "^sha256:[a-f0-9]{64}$",
      -            "type": "string"
      -          },
      -          "path": {
      -            "pattern": "^entities\\/[a-z0-9]{1,2}\\/[a-z0-9]+(?:-[a-z0-9]+)*\\.yaml$",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "path",
      -          "content",
      -          "content_digest"
      -        ],
      -        "type": "object"
      -      },
      -      "base_release_id": {
      -        "pattern": "^sha256:[a-f0-9]{64}$",
      -        "type": "string"
      -      },
      -      "declaration_id": {
      -        "pattern": "^[a-z0-9][a-z0-9_-]*$",
      -        "type": "string"
      -      },
      -      "diagnostics": {
      -        "items": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "code": {
      -              "enum": [
      -                "required",
      -                "invalid",
      -                "ambiguous_identity",
      -                "cross_entity_offer",
      -                "base_authoring_mismatch"
      -              ],
      -              "type": "string"
      -            },
      -            "message": {
      -              "maxLength": 500,
      -              "minLength": 1,
      -              "type": "string"
      -            },
      -            "path": {
      -              "format": "starts_with",
      -              "pattern": "^\\/.*",
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "code",
      -            "path",
      -            "message"
      -          ],
      -          "type": "object"
      -        },
      -        "maxItems": 0,
      -        "minItems": 0,
      -        "type": "array"
      -      },
      -      "entity_id": {
      -        "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$",
      -        "type": "string"
      -      },
      -      "entity_revision_digest": {
      -        "pattern": "^sha256:[a-f0-9]{64}$",
      -        "type": "string"
      -      },
      -      "scope": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "funnel": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "key": {
      -                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      -                "type": "string"
      -              },
      -              "name": {
      -                "maxLength": 160,
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "key",
      -              "name"
      -            ],
      -            "type": "object"
      -          },
      -          "product": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "key": {
      -                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      -                "type": "string"
      -              },
      -              "name": {
      -                "maxLength": 160,
      -                "minLength": 1,
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "key",
      -              "name"
      -            ],
      -            "type": "object"
      -          }
      -        },
      -        "required": [
      -          "product",
      -          "funnel"
      -        ],
      -        "type": "object"
      -      },
      -      "status": {
      -        "const": "materialized",
      -        "type": "string"
      -      },
      -      "subject_display": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "name": {
      -            "maxLength": 240,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "slug": {
      -            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "slug",
      -          "name"
      -        ],
      -        "type": "object"
      -      },
      -      "submission": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "method": {
      -            "const": "POST",
      -            "type": "string"
      -          },
      -          "path": {
      -            "const": "/v1/submissions",
      -            "type": "string"
      -          },
      -          "product": {
      -            "const": "agent_readiness",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "method",
      -          "path",
      -          "product"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "base_release_id",
      -      "entity_id",
      -      "entity_revision_digest",
      -      "subject_display",
      -      "scope",
      -      "declaration_id",
      -      "authoring_file",
      -      "submission",
      -      "diagnostics"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "diagnostics": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "required",
      +                "invalid",
      +                "ambiguous_identity",
      +                "cross_entity_offer",
      +                "base_authoring_mismatch"
      +              ],
      +              "type": "string"
      +            },
      +            "message": {
      +              "maxLength": 500,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "path": {
      +              "format": "starts_with",
      +              "pattern": "^\\/.*",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "path",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "status": {
      +        "const": "invalid",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "diagnostics"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "diagnostics": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "required",
      +                "invalid",
      +                "ambiguous_identity",
      +                "cross_entity_offer",
      +                "base_authoring_mismatch"
      +              ],
      +              "type": "string"
      +            },
      +            "message": {
      +              "maxLength": 500,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "path": {
      +              "format": "starts_with",
      +              "pattern": "^\\/.*",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "path",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "status": {
      +        "const": "identity_allocation_required",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "diagnostics"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base_release_id": {
      +        "pattern": "^sha256:[a-f0-9]{64}$",
      +        "type": "string"
      +      },
      +      "diagnostics": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "required",
      +                "invalid",
      +                "ambiguous_identity",
      +                "cross_entity_offer",
      +                "base_authoring_mismatch"
      +              ],
      +              "type": "string"
      +            },
      +            "message": {
      +              "maxLength": 500,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "path": {
      +              "format": "starts_with",
      +              "pattern": "^\\/.*",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "path",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "entity_id": {
      +        "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$",
      +        "type": "string"
      +      },
      +      "entity_revision_digest": {
      +        "pattern": "^sha256:[a-f0-9]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "incomplete",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "base_release_id",
      +      "entity_id",
      +      "entity_revision_digest",
      +      "diagnostics"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "base_release_id": {
      +        "pattern": "^sha256:[a-f0-9]{64}$",
      +        "type": "string"
      +      },
      +      "diagnostics": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "required",
      +                "invalid",
      +                "ambiguous_identity",
      +                "cross_entity_offer",
      +                "base_authoring_mismatch"
      +              ],
      +              "type": "string"
      +            },
      +            "message": {
      +              "maxLength": 500,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "path": {
      +              "format": "starts_with",
      +              "pattern": "^\\/.*",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "path",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "minItems": 1,
      +        "type": "array"
      +      },
      +      "entity_id": {
      +        "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$",
      +        "type": "string"
      +      },
      +      "entity_revision_digest": {
      +        "pattern": "^sha256:[a-f0-9]{64}$",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "conflict",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "base_release_id",
      +      "diagnostics"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "authoring_file": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "content": {
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "content_digest": {
      +            "pattern": "^sha256:[a-f0-9]{64}$",
      +            "type": "string"
      +          },
      +          "path": {
      +            "pattern": "^entities\\/[a-z0-9]{1,2}\\/[a-z0-9]+(?:-[a-z0-9]+)*\\.yaml$",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "path",
      +          "content",
      +          "content_digest"
      +        ],
      +        "type": "object"
      +      },
      +      "base_release_id": {
      +        "pattern": "^sha256:[a-f0-9]{64}$",
      +        "type": "string"
      +      },
      +      "declaration_id": {
      +        "pattern": "^[a-z0-9][a-z0-9_-]*$",
      +        "type": "string"
      +      },
      +      "diagnostics": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "code": {
      +              "enum": [
      +                "required",
      +                "invalid",
      +                "ambiguous_identity",
      +                "cross_entity_offer",
      +                "base_authoring_mismatch"
      +              ],
      +              "type": "string"
      +            },
      +            "message": {
      +              "maxLength": 500,
      +              "minLength": 1,
      +              "type": "string"
      +            },
      +            "path": {
      +              "format": "starts_with",
      +              "pattern": "^\\/.*",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "code",
      +            "path",
      +            "message"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 0,
      +        "minItems": 0,
      +        "type": "array"
      +      },
      +      "entity_id": {
      +        "pattern": "^ent_[0-9a-hjkmnp-tv-z]{26}$",
      +        "type": "string"
      +      },
      +      "entity_revision_digest": {
      +        "pattern": "^sha256:[a-f0-9]{64}$",
      +        "type": "string"
      +      },
      +      "scope": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "job": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "key": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "name": {
      +                "maxLength": 160,
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "key",
      +              "name"
      +            ],
      +            "type": "object"
      +          },
      +          "product": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "key": {
      +                "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +                "type": "string"
      +              },
      +              "name": {
      +                "maxLength": 160,
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "key",
      +              "name"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "product",
      +          "job"
      +        ],
      +        "type": "object"
      +      },
      +      "status": {
      +        "const": "materialized",
      +        "type": "string"
      +      },
      +      "subject_display": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "name": {
      +            "maxLength": 240,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "slug": {
      +            "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "slug",
      +          "name"
      +        ],
      +        "type": "object"
      +      },
      +      "submission": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "method": {
      +            "const": "POST",
      +            "type": "string"
      +          },
      +          "path": {
      +            "const": "/v1/submissions",
      +            "type": "string"
      +          },
      +          "product": {
      +            "const": "agent_readiness",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "method",
      +          "path",
      +          "product"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "base_release_id",
      +      "entity_id",
      +      "entity_revision_digest",
      +      "subject_display",
      +      "scope",
      +      "declaration_id",
      +      "authoring_file",
      +      "submission",
      +      "diagnostics"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. First observedv1.0.0

TDQS

A3.6/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the bar is lower, and the description still adds real behavioural context: drafts grant no publication, verification or grade, startup credits and deals never count as service readiness, and unknown companies fail with identity_allocation_required. That is meaningful beyond the structured hints, though it says nothing about payload size limits or how repeated drafts relate to each other.

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

Conciseness4/5

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

The purpose is front-loaded in the first clause and every subsequent clause carries content — contents, precondition, error semantics, and the draft-versus-published caveat. It is a single dense paragraph with long compound sentences, which costs some readability, but there is no filler.

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?

With an output schema present, return values need not be described, and the description covers purpose, preconditions and the draft's lack of force. Against a 12-required/18-parameter nested schema with zero parameter descriptions, however, field-level guidance is thin enough that an agent would still be assembling much of the payload blind.

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 description coverage is 0% across 18 parameters, so the description carries the burden, and it partially compensates by explaining the trickiest concepts: what a 'job operation' is on each interface (the request probes send with no account, or the vendor OpenAPI operation where no public endpoint exists) and that job bindings are for a verified run. However, many top-level fields (command_contract, scope_source_uris, subject_roles, resources, relations, offer_relations, surface_exclusions, base_authoring_file) remain unaddressed, so the compensation is incomplete.

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 description uses a specific verb+resource ('Prepare the canonical Agent Readiness declaration for one service and job') and then enumerates the declaration's contents (participants, endpoints, interfaces, job operations, job bindings), so the agent knows exactly what artifact is produced. It does not explicitly name or differentiate itself from siblings like get_readiness or search_readiness, but the authoring verb versus read verbs makes the distinction inferable.

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?

It states a precondition ('the company must already exist in Sourcey and resolves by exact identity') and an error outcome ('an unknown company returns identity_allocation_required'), which is useful context, but there is no explicit when-to-use/when-not guidance relative to get_readiness or search_readiness. The mention that complete declarations go through POST /v1/submissions hints at a downstream path but does not route the agent among the sibling tools.

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