{"name":"xy-workflow-platform","protocol":"mcp","transport":"streamable-http","tools":[{"name":"catalog_list_agents","description":"List published agent versions entitled to this organization.","inputSchema":{"properties":{},"title":"catalog_list_agentsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"catalog_list_agentsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agents:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"catalog_get_agent","description":"Inspect one catalog agent, including exact setup and input schemas.","inputSchema":{"properties":{"agent_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Agent Id","type":"string"}},"required":["agent_id"],"title":"catalog_get_agentArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"catalog_get_agentDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agents:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"catalog_discover_agents","description":"Browse XY use cases and a bounded page of third-party software.\n\nThese are broad agent categories, not installed or immediately executable agents.\nUse each card's short_description and capabilities to explain the work\nit performs. An expected item means the primary business record handled\nby that work, not an hour or a model token. The correct business unit\ndepends on the customer's process; do not invent a unit from a job title.\nCost evidence and workflow implementation details are not part of the catalog.\nXY cards may include icon_url: a monochrome SVG for your UI to recolor\nas a CSS mask. Use a fallback when null; no color argument is needed.\nexternal_listings separately contains cached public Microsoft/AWS software\nmetadata with provider/source links and optional logo_url for display.\nA logo is a product/publisher image, not an XY avatar; null needs a fallback.\nCheck external_catalogs for freshness\nand unavailable providers; missing feeds do not mean no such product exists.\nXY cards are returned together; external listings default to 25 per page\n(maximum 100). Follow external_pagination.next_offset using external_offset,\noptionally filter by external_provider. If catalog_version changes between\npages, restart paging. Matching searches the full cache, not only this page.\n","inputSchema":{"properties":{"external_provider":{"anyOf":[{"enum":["microsoft","aws"],"type":"string"},{"type":"null"}],"default":null,"title":"External Provider"},"external_limit":{"default":25,"maximum":100,"minimum":1,"title":"External Limit","type":"integer"},"external_offset":{"default":0,"maximum":12000,"minimum":0,"title":"External Offset","type":"integer"}},"title":"catalog_discover_agentsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"catalog_discover_agentsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agents:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"catalog_match_tasks","description":"Assess 1-8 plain-language tasks and suggest current Discover use cases.\n\nWhere enabled, concurrency limits count active requests across all of an\norganization's keys and pods, not tasks. On a concurrency 429 or busy\n503, honor Retry-After before retrying. Rejected work does not invoke a\nmatching model; neither error means that the task has no matching agent.\n\nDo not choose an agent first: describe the work, inputs, systems,\nconstraints, and desired outcome. A task name is optional, echoed for\ndisplay, and ignored for matching. Task IDs are optional caller-owned\ncorrelation handles and never influence matching. Each result separates\nagentizability (whether XY can automate the work) from zero to four scored\ncatalog matches (which current cards fit); the two scores are not\ninterchangeable and neither is a share of human hours saved. Matches can\nbe many-to-many and cross-industry.\n\nOptionally include monthly customer labor inputs. The returned labor_value\nis deterministic human-cost context, not an XY price, quote, or guaranteed\nsavings, and it does not affect model scores. Supplying\nlabor_baseline.remaining_human_hours_per_month also yields\nlabor_value.estimated_human_effort_reduction, a 0-1 fraction: current\nhuman hours minus remaining human hours, divided by current human hours.\n0.8 means 80% fewer human hours under the caller's estimate, not 80%\nagent runtime. Its basis is caller_supplied_remaining_hours, not\nmeasured evidence. Include all remaining work, review, corrections,\nand oversight for the same workload and quality standard. If remaining\nhours are unknown, omit them: reduction and its basis are null, without\nblocking cost estimates. Never infer a numerical split from the task\ndescription, feasibility score, or fit score. A result can be agentizable\nwith no current match. After the user chooses suggested cards—or chooses to\nproceed without one—use custom_agent_request_create to capture the\ncustomer-specific configuration required before build and execution.\nWith no workload estimate, a match with recent XY cost history returns\na reference daily operating cost at a comparable deployment's observed\nworkload. When reference_items_per_day is present, it is the average\nrecorded business records per workflow-day, using the same sample as\nthe reference daily cost. Null means no comparable item-volume evidence;\nnever infer a record count from human hours or workflow runs.\nIt is not a customer-specific amount. Optionally provide\nexpected_items_per_month for primary work items (e.g. claims or payments),\nor expected_runs_per_month for workflow invocations. These are separate\nfrom labor work units. When comparable XY history is sufficient, volume\nyields one indicative monthly operating_cost_estimate; item-volume evidence\ntakes precedence when both inputs are supplied. Missing evidence yields\nnull, never an invented zero. Raw cost evidence is not exposed. Neither\nestimate is a quote or guaranteed savings.\nXY cost fields require separate organization approval\n(useOperatingCostReports). Without it all four operating_cost_* fields\nare null; matching and public vendor prices remain available. Reported\nXY dollars include estimated logging costs allocated to the workflow;\nraw evidence and vendor prices are unchanged.\nFor an entire project, supply expected_items instead of monthly volume.\nOptionally add project_duration_months for monthly averages. The result has period project,\nestimated_project_operating_cost_usd, average_items_per_month, and\nestimated_average_monthly_operating_cost_usd. Project cost uses comparable\nper-item history; monthly averages divide by duration and assume evenly\nspread workload. Without duration, the project total is available but\nproject_duration_months and both monthly averages are null, not zero.\nFractional months are allowed. Duration requires expected_items. Do not combine project\ninputs with expected_items_per_month or expected_runs_per_month. Missing\nitem evidence still yields null; neither a daily reference nor monthly\nrun history substitutes for project item cost. labor_baseline remains\noptional monthly human-cost comparison data, independent of operating cost.\nAlongside XY matches, external_matches may suggest relevant cached public\nMicrosoft/AWS listings. These remain separate from XY matches and never\ninclude an XY operating-cost estimate or deployment capability. Follow\ntheir source links; do not pass external listing IDs as XY selections\nwhen creating a workflow request. Discovery does not purchase, configure,\nor deploy third-party software. Check external_catalogs for feed coverage.\nAWS and Microsoft listings can include vendor_pricing with public USD rates, original\nbilling dimensions, normalized explicit units, conditions and checked_at.\nUse the same expected_items_per_month or expected_items for all providers.\nAdd expected_item_unit (e.g. page, document or ticket). Optional\nworkload_units_per_item contains known business relationships such as\n{\"page\": 5} per document. The server resolves the priced operation from\nthe description, validates published IDs, converts units and calculates\ncharges. No provider-specific request or caller-selected rate ID is needed.\nUnknown ratios, ambiguous operations or billing conditions yield specific\nneeds_more_information reasons, not an invented total. Each component\nshows billed quantity, units_per_item and conversion_basis. Fixed plans\nand contract fees remain metadata, not linear per-item rates. Conditional\noverage prices remain visible but require subscription/allowance scoping\nbefore an estimate; annual commitments are not plain monthly fees. Legacy\nexternal_pricing_inputs is deprecated but still supported; do not combine\nit with shared workload units. Never equate pages with documents/runs.\nOperation resolution is model-assisted; dollar math and conversion\nratios are not. Existing XY inputs are unchanged and still require\ncomparable history; a supplied unit does not establish compatibility.\nThe result\nuses the same operating_cost_estimate/status fields with basis\npublished_vendor_rates and partial coverage. Other fees are excluded.\nMonthly/contract prices are displayed but not multiplied by item volume.\nMissing, stale, expired or unknown rates yield no estimate, never $0.\nAn explicitly zero published rate means that vendor charge only is zero.\n","inputSchema":{"$defs":{"DiscoveryLaborBaseline":{"additionalProperties":false,"description":"Customer-supplied human effort for one task, normalized to one month.","properties":{"human_hours_per_month":{"description":"Current human hours spent on this task in a typical month.","exclusiveMinimum":0,"maximum":1000000,"title":"Human Hours Per Month","type":"number"},"fully_loaded_hourly_cost_usd":{"description":"Current fully loaded hourly labor cost in USD, including salary, benefits, and employer overhead.","exclusiveMinimum":0,"maximum":1000000,"title":"Fully Loaded Hourly Cost Usd","type":"number"},"remaining_human_hours_per_month":{"anyOf":[{"maximum":1000000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Estimated total monthly human effort remaining after automation, including unautomated work, review, escalations, corrections, and ongoing oversight. Compare the same workload and quality standard as human_hours_per_month. Omit when unknown; zero explicitly assumes no remaining human effort. Cannot exceed current human hours.","title":"Remaining Human Hours Per Month"},"work_units_per_month":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000000,"type":"number"},{"type":"null"}],"default":null,"description":"Optional current monthly task volume, used only to express the human labor value per work unit.","title":"Work Units Per Month"}},"required":["human_hours_per_month","fully_loaded_hourly_cost_usd"],"title":"DiscoveryLaborBaseline","type":"object"},"DiscoveryTask":{"additionalProperties":false,"properties":{"id":{"anyOf":[{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","type":"string"},{"type":"null"}],"default":null,"description":"Optional caller-owned correlation handle. Omit it to receive task-1, task-2, and so on. It is never shown to the matching model.","title":"Id"},"name":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"\\S","type":"string"},{"type":"null"}],"default":null,"description":"Optional human-readable task title, echoed in the result for display. Matching uses the description, not this title.","title":"Name"},"description":{"description":"Plain-language work description including useful inputs, actions, systems, constraints, and desired outcome. Do not name a catalog agent.","maxLength":2000,"minLength":1,"pattern":"\\S","title":"Description","type":"string"},"labor_baseline":{"anyOf":[{"$ref":"#/$defs/DiscoveryLaborBaseline"},{"type":"null"}],"default":null,"description":"Optional customer labor inputs for deterministic human labor-value math. These values do not affect LLM scores and are not XY pricing."},"external_pricing_inputs":{"anyOf":[{"items":{"$ref":"#/$defs/ExternalPricingInput"},"maxItems":20,"type":"array"},{"type":"null"}],"default":null,"deprecated":true,"description":"Legacy explicit vendor-rate quantities, retained for existing clients. Prefer the shared expected_items_per_month or expected_items with expected_item_unit. Cannot be combined with the shared unit/conversions.","title":"External Pricing Inputs"},"expected_item_unit":{"anyOf":[{"maxLength":80,"minLength":1,"pattern":"^[a-z][a-z0-9_]*$","type":"string"},{"type":"null"}],"default":null,"description":"Meaning of one expected item, e.g. page, document, ticket or claim. Used with the same item count and period for XY and vendor matches. Required for automatic vendor estimates; does not establish XY history compatibility.","title":"Expected Item Unit"},"workload_units_per_item":{"anyOf":[{"maxProperties":10,"patternProperties":{"^[a-z][a-z0-9_]*$":{"exclusiveMinimum":0,"maximum":1000000,"type":"number"}},"propertyNames":{"maxLength":80,"minLength":1},"type":"object"},{"type":"null"}],"default":null,"description":"Optional workload conversion assumptions shared across providers: for document items, {page: 5} means five processed pages per document. Keys are singular units, not vendor rate IDs. Requires an item count and expected_item_unit; unknown conversion ratios are never inferred.","title":"Workload Units Per Item"},"expected_runs_per_month":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"integer"},{"type":"null"}],"default":null,"description":"Optional expected monthly workflow executions for an indicative XY operating-cost projection. A customer work item is not necessarily one workflow run.","title":"Expected Runs Per Month"},"expected_items_per_month":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000000,"type":"integer"},{"type":"null"}],"default":null,"description":"Optional expected monthly primary work items (such as claims or payments), not workflow runs. Item-normalized estimates are returned only when XY has comparable governed item-volume and cost history for the matched use case.","title":"Expected Items Per Month"},"expected_items":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000000,"type":"integer"},{"type":"null"}],"default":null,"description":"Total primary work items across the entire project, not per month or workflow executions. Optionally supply project_duration_months for monthly averages. Cannot be combined with expected_items_per_month or expected_runs_per_month.","title":"Expected Items"},"project_duration_months":{"anyOf":[{"exclusiveMinimum":0,"maximum":1200,"type":"number"},{"type":"null"}],"default":null,"description":"Optional project duration in months, up to 1200; fractional months are allowed. Requires expected_items. Used to express average monthly volume and operating cost, assuming the workload is spread evenly.","title":"Project Duration Months"}},"required":["description"],"title":"DiscoveryTask","type":"object"},"ExternalPricingInput":{"additionalProperties":false,"description":"An explicit vendor billing dimension; never an inferred XY item count.","properties":{"listing_id":{"maxLength":300,"pattern":"^(?:aws|microsoft):[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Listing Id","type":"string"},"rate_id":{"description":"Exact rate_id returned in the listing's vendor_pricing.rates.","pattern":"^[0-9a-f]{16}$","title":"Rate Id","type":"string"},"quantity":{"description":"Count of the selected rate's billed units, for the supplied period. Read its unit, description and conditions: pages are not PDFs or workflow invocations. This does not set XY work-item volume.","exclusiveMinimum":0,"maximum":1000000000,"title":"Quantity","type":"number"},"period":{"default":"month","enum":["month","project"],"title":"Period","type":"string"},"project_duration_months":{"anyOf":[{"exclusiveMinimum":0,"maximum":1200,"type":"number"},{"type":"null"}],"default":null,"title":"Project Duration Months"}},"required":["listing_id","rate_id","quantity"],"title":"ExternalPricingInput","type":"object"}},"properties":{"tasks":{"items":{"$ref":"#/$defs/DiscoveryTask"},"maxItems":8,"minItems":1,"title":"Tasks","type":"array"}},"required":["tasks"],"title":"catalog_match_tasksArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"catalog_match_tasksDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agents:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"agent_install","description":"Install an entitled catalog agent using its returned setup schema.","inputSchema":{"properties":{"agent_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Agent Id","type":"string"},"configuration":{"additionalProperties":true,"title":"Configuration","type":"object"},"agent_version":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Agent Version"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["agent_id","configuration"],"title":"agent_installArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"agent_installDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"agent_uninstall","description":"Retire an installation and free the name it holds for reuse.\n\nUse this to clear a failed or superseded installation. Without it a\nKnowledge Base name stays claimed by the definition the install created,\nand every later install under that name fails with\nKNOWLEDGE_BASE_NAME_CONFLICT. Idempotent.\n","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"}},"required":["installation_id"],"title":"agent_uninstallArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"agent_uninstallDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"installation_get","description":"Read provisioning, connection, source, and readiness state.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"}},"required":["installation_id"],"title":"installation_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"installation_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"installation_start_authorization","description":"Create a short-lived hosted authorization link for a required connection.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"connection":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Connection"}},"required":["installation_id"],"title":"installation_start_authorizationArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"installation_start_authorizationDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"installation_list_authorizations","description":"List authorization actions and their current states.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"}},"required":["installation_id"],"title":"installation_list_authorizationsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"installation_list_authorizationsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_add_url","description":"Attach and index a public website in a Knowledge Base installation.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"url":{"title":"Url","type":"string"},"crawl_limit":{"default":50,"maximum":500,"minimum":1,"title":"Crawl Limit","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["installation_id","url"],"title":"knowledge_source_add_urlArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_add_urlDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_create_file_upload","description":"Create a signed upload target for a Knowledge Base file source.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"file_name":{"title":"File Name","type":"string"},"content_type":{"title":"Content Type","type":"string"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["installation_id","file_name","content_type"],"title":"knowledge_source_create_file_uploadArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_create_file_uploadDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_sources_list","description":"List every source and indexing state for a Knowledge Base installation.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"}},"required":["installation_id"],"title":"knowledge_sources_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_sources_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_get","description":"Read upload or indexing state for one Knowledge Base source.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"source_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Source Id","type":"string"}},"required":["installation_id","source_id"],"title":"knowledge_source_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_complete_upload","description":"Confirm a signed file upload and start ingestion and indexing.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"source_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Source Id","type":"string"}},"required":["installation_id","source_id"],"title":"knowledge_source_complete_uploadArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_complete_uploadDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_delete","description":"Delete a Knowledge Base source and its indexed content.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"source_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Source Id","type":"string"}},"required":["installation_id","source_id"],"title":"knowledge_source_deleteArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_deleteDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_batch_create","description":"Queue bulk creation of Knowledge Base file and URL sources.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"sources":{"items":{"additionalProperties":true,"type":"object"},"title":"Sources","type":"array"},"max_concurrency":{"default":5,"maximum":10,"minimum":1,"title":"Max Concurrency","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["installation_id","sources"],"title":"knowledge_source_batch_createArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_batch_createDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_batch_get","description":"Read item-level state for a Knowledge Base source batch.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"batch_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Batch Id","type":"string"}},"required":["installation_id","batch_id"],"title":"knowledge_source_batch_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_batch_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_batch_upload_actions","description":"Create fresh signed upload actions for pending file items in a batch.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"batch_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Batch Id","type":"string"}},"required":["installation_id","batch_id"],"title":"knowledge_source_batch_upload_actionsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_batch_upload_actionsDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_batch_complete","description":"Queue completion checks for uploaded file items in a source batch.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"batch_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Batch Id","type":"string"}},"required":["installation_id","batch_id"],"title":"knowledge_source_batch_completeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_batch_completeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"knowledge_source_batch_cancel","description":"Cancel queued creation work for a Knowledge Base source batch.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"batch_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Batch Id","type":"string"}},"required":["installation_id","batch_id"],"title":"knowledge_source_batch_cancelArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"knowledge_source_batch_cancelDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["installations:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"agent_execution_start","description":"Start an asynchronous run of an installed catalog agent.","inputSchema":{"properties":{"installation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Installation Id","type":"string"},"input":{"additionalProperties":true,"title":"Input","type":"object"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Metadata"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["installation_id","input"],"title":"agent_execution_startArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"agent_execution_startDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"agent_execution_get","description":"Poll one catalog-agent execution for status and its stable result.","inputSchema":{"properties":{"execution_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Execution Id","type":"string"}},"required":["execution_id"],"title":"agent_execution_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"agent_execution_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"agent_executions_list","description":"List organization-scoped catalog-agent executions.","inputSchema":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Status"},"agent_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Agent Id"},"installation_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Installation Id"},"limit":{"default":25,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"offset":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},"title":"agent_executions_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"agent_executions_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_list","description":"List my workflow requests to XY: the requests I asked XY to build.\n\nA person sees their own requests, made through this connection or in the\nXY app; XY staff pass organization_id to list one organization's. Filter\nby state, such as submitted or needs_information. Show each request's\nform_url as a link to its form in the XY app. Read one with\ncustom_agent_request_get for its form and XY's messages. Pass\nnext_cursor back as cursor for the next page.\n","inputSchema":{"properties":{"state":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"State"},"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"cursor":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Cursor"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"title":"custom_agent_request_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_get","description":"Read a custom request: its state, messages, and form.\n\nA request made with custom_agent_request_create includes its form's\nSpec (workflow_spec), what it still needs (open_fields), and form_url.\nIncludes the review, clarification, and delivery fields. Use the returned\nversion to change it or for planner approval. Staff Workflow Requests use\nworkflow_request_* tools.\n","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["request_id"],"title":"custom_agent_request_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_deployments","description":"Read the published workflows delivered for an XY request.\n\nKeep the same request_id returned by creation or bulk submission. This\nreads deployment provenance, not Discover matches or build success.\nEmpty data means no delivered workflow has been registered yet.\nReturns IDs, versions and availability only, never YAML or payloads.\n","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["request_id"],"title":"custom_agent_request_deploymentsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AgentRequestDeployment":{"additionalProperties":false,"properties":{"workflow_id":{"title":"Workflow Id","type":"string"},"workflow_version":{"minimum":1,"title":"Workflow Version","type":"integer"},"deployed_at":{"format":"date-time","title":"Deployed At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"status":{"enum":["available","retired"],"title":"Status","type":"string"}},"required":["workflow_id","workflow_version","deployed_at","updated_at","status"],"title":"AgentRequestDeployment","type":"object"}},"additionalProperties":false,"properties":{"request_id":{"title":"Request Id","type":"string"},"data":{"items":{"$ref":"#/$defs/AgentRequestDeployment"},"title":"Data","type":"array"}},"required":["request_id","data"],"title":"AgentRequestDeploymentList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_usage","description":"Read runs, tokens and observed operating cost for a delivered XY request.\n\nISO-8601 timestamps require timezones: from_time is inclusive and\nto_time exclusive. Defaults to 30 days, maximum 400 days. Test runs and\nusage before deployment are excluded. Run counts use run creation time;\ntoken counts use call recording time. These are observed totals, not\nbilling or guaranteed complete metering. operating_cost uses this\nrequest's own workflows, not a Discovery match: recorded model charges\nplus allocated runtime costs on completed UTC days after daily collection.\nPartial is an observed subtotal; unavailable is null, not zero. Averages\nrequire complete coverage and, for items, compatible primary-item counts.\nCost reporting requires separate organization approval\n(useOperatingCostReports); otherwise operating_cost is null while runs\nand tokens remain available. Reported XY cost includes estimated\nlogging costs allocated to the workflow, not measured logging charges. Other shared services, support and margin are excluded. No raw\nbills, provider details, customer records, prompts or workflow code return.\nSubscribe to custom_request.operating_cost_updated for corrected rolling\n30-day cost snapshots; custom_request.usage_updated includes daily costs.\n","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"from_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"From Time"},"to_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"To Time"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["request_id"],"title":"custom_agent_request_usageArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AgentRequestOperatingCost":{"additionalProperties":false,"properties":{"from":{"format":"date-time","title":"From","type":"string"},"to":{"format":"date-time","title":"To","type":"string"},"status":{"enum":["available","partial","unavailable"],"title":"Status","type":"string"},"currency":{"const":"USD","default":"USD","title":"Currency","type":"string"},"basis":{"const":"observed_usage_with_allocated_runtime_costs","default":"observed_usage_with_allocated_runtime_costs","title":"Basis","type":"string"},"observed_operating_cost_usd":{"anyOf":[{"maximum":1000000000000.0,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Reported cost from observed/allocated workflow evidence, including estimated logging costs. Not fully metered expenditure or a customer invoice.","title":"Observed Operating Cost Usd"},"observed_run_count":{"minimum":0,"title":"Observed Run Count","type":"integer"},"observed_item_count":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Observed Item Count"},"average_cost_per_run_usd":{"anyOf":[{"maximum":1000000000000.0,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Average Cost Per Run Usd"},"average_cost_per_item_usd":{"anyOf":[{"maximum":1000000000000.0,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Average Cost Per Item Usd"},"covered_workflow_days":{"minimum":0,"title":"Covered Workflow Days","type":"integer"},"incomplete_workflow_days":{"minimum":0,"title":"Incomplete Workflow Days","type":"integer"},"last_observed_on":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"title":"Last Observed On"},"note":{"title":"Note","type":"string"},"request_id":{"title":"Request Id","type":"string"}},"required":["from","to","status","observed_run_count","covered_workflow_days","incomplete_workflow_days","note","request_id"],"title":"AgentRequestOperatingCost","type":"object"}},"additionalProperties":false,"description":"Aggregate recorded usage, not an invoice or a complete metering guarantee.\n\nRun counts use run creation time; token counts use recorded call time. Test\nruns, build-time usage, payloads, model names, and raw provider bills are excluded.\nPeriods are inclusive at `from` and exclusive at `to`. Zero recorded calls\ndoes not prove that a workflow makes no LLM calls.","properties":{"request_id":{"title":"Request Id","type":"string"},"from":{"format":"date-time","title":"From","type":"string"},"to":{"format":"date-time","title":"To","type":"string"},"as_of":{"format":"date-time","title":"As Of","type":"string"},"workflow_count":{"minimum":0,"title":"Workflow Count","type":"integer"},"run_count":{"minimum":0,"title":"Run Count","type":"integer"},"succeeded_count":{"minimum":0,"title":"Succeeded Count","type":"integer"},"completed_with_failures_count":{"minimum":0,"title":"Completed With Failures Count","type":"integer"},"failed_count":{"minimum":0,"title":"Failed Count","type":"integer"},"cancelled_count":{"minimum":0,"title":"Cancelled Count","type":"integer"},"active_count":{"minimum":0,"title":"Active Count","type":"integer"},"other_count":{"minimum":0,"title":"Other Count","type":"integer"},"recorded_llm_calls":{"minimum":0,"title":"Recorded Llm Calls","type":"integer"},"input_tokens":{"minimum":0,"title":"Input Tokens","type":"integer"},"output_tokens":{"minimum":0,"title":"Output Tokens","type":"integer"},"cached_input_tokens":{"minimum":0,"title":"Cached Input Tokens","type":"integer"},"cache_creation_tokens":{"minimum":0,"title":"Cache Creation Tokens","type":"integer"},"basis":{"const":"recorded_usage_since_deployment","title":"Basis","type":"string"},"operating_cost":{"anyOf":[{"$ref":"#/$defs/AgentRequestOperatingCost"},{"type":"null"}],"default":null,"description":"Null when organization cost visibility is not approved. Otherwise the delivered workflows' own recorded/allocated operating cost, including estimated logging costs, on completed UTC days. Available after daily collection, not immediately at publication. Partial is an observed subtotal; unavailable is null, never inferred free. It is not a Discovery estimate, customer price or invoice. Unit averages require complete cost coverage; per-item averages additionally require primary-item observations for every costed run."}},"required":["request_id","from","to","as_of","workflow_count","run_count","succeeded_count","completed_with_failures_count","failed_count","cancelled_count","active_count","other_count","recorded_llm_calls","input_tokens","output_tokens","cached_input_tokens","cache_creation_tokens","basis"],"title":"AgentRequestUsage","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_create","description":"Make a workflow request: ask XY to build a workflow, and get its form.\n\nUse this for a customer's or partner's workflow request; staff use\nworkflow_request_* instead. specification is what the workflow should\nachieve in plain words; it\nprefills the form's desired outcome. After catalog_match_tasks, pass each\nmatched task with its optional name and chosen cards as discovery_selections; for a task\nwith no current match, pass its description as specification instead.\nFill in the rest with custom_agent_request_update, then publish it with\ncustom_agent_request_publish. Use the returned id as request_id for every\ncustom request tool; form_url opens the same form in the XY app, where\nindividual Workflow Requests app permission is required. This does not\nchange the API/MCP scopes required by these tools.\n","inputSchema":{"$defs":{"AgentRequestDiscoverySelection":{"additionalProperties":false,"description":"Original customer task and the Discover cards chosen for that task.","properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","title":"Id","type":"string"},"name":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"\\S","type":"string"},{"type":"null"}],"default":null,"title":"Name"},"description":{"maxLength":2000,"minLength":1,"pattern":"\\S","title":"Description","type":"string"},"selected_agent_ids":{"items":{"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","type":"string"},"maxItems":4,"minItems":1,"title":"Selected Agent Ids","type":"array"}},"required":["id","description","selected_agent_ids"],"title":"AgentRequestDiscoverySelection","type":"object"},"AgentRequestFormAccessMethodAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["website_portal","api","file_transfer","email","other"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormAccessMethodAnswer","type":"object"},"AgentRequestFormAvailabilityAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["available","being_arranged","third_party_dependency","not_needed"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormAvailabilityAnswer","type":"object"},"AgentRequestFormBrowserPortal":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"domain":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Domain"},"system":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"System"},"steps":{"items":{"$ref":"#/$defs/AgentRequestFormPortalStep"},"maxItems":200,"title":"Steps","type":"array"}},"title":"AgentRequestFormBrowserPortal","type":"object"},"AgentRequestFormCredentialsAndAccess":{"additionalProperties":false,"description":"One section of the form.","properties":{"credentials_needed":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormYesNoAnswer"},{"type":"boolean"},{"type":"null"}],"title":"Credentials Needed"},"vault_reference":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormVaultReferenceAnswer"},{"pattern":"^c[a-z0-9]{24}$","type":"string"},{"type":"null"}],"title":"Vault Reference"},"outstanding_requirements":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Outstanding Requirements"}},"title":"AgentRequestFormCredentialsAndAccess","type":"object"},"AgentRequestFormCurrentProcess":{"additionalProperties":false,"description":"One section of the form.","properties":{"documentation_status":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormDocumentationStatusAnswer"},{"enum":["complete","partial_informal","mainly_undocumented"],"type":"string"},{"type":"null"}],"title":"Documentation Status"},"sop_links":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Sop Links"}},"title":"AgentRequestFormCurrentProcess","type":"object"},"AgentRequestFormDocumentationStatusAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["complete","partial_informal","mainly_undocumented"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormDocumentationStatusAnswer","type":"object"},"AgentRequestFormExpectedOutput":{"additionalProperties":false,"description":"One section of the form.","properties":{"description":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Description"},"examples":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Examples"}},"title":"AgentRequestFormExpectedOutput","type":"object"},"AgentRequestFormGoalAndScope":{"additionalProperties":false,"description":"One section of the form.","properties":{"desired_outcome":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Desired Outcome"},"why_it_matters":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Why It Matters"},"in_scope":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"In Scope"},"out_of_scope":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Out Of Scope"},"success_criteria":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Success Criteria"}},"title":"AgentRequestFormGoalAndScope","type":"object"},"AgentRequestFormInput":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Description"},"example":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Example"}},"title":"AgentRequestFormInput","type":"object"},"AgentRequestFormJudgmentTypeAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["rules_based","human_judgment","ai_judgment"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormJudgmentTypeAnswer","type":"object"},"AgentRequestFormListMark":{"additionalProperties":false,"description":"A repeating section marked Not applicable, with the reason it has no items.","properties":{"state":{"default":"unanswered","enum":["unanswered","not_applicable"],"title":"State","type":"string"},"value":{"default":null,"title":"Value","type":"null"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormListMark","type":"object"},"AgentRequestFormNotApplicableSections":{"additionalProperties":false,"description":"Repeating sections that can be empty, if marked Not applicable with a reason.","properties":{"browser_portals":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormListMark"},{"type":"null"}],"title":"Browser Portals"},"inputs":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormListMark"},{"type":"null"}],"title":"Inputs"}},"title":"AgentRequestFormNotApplicableSections","type":"object"},"AgentRequestFormPortalStep":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"instruction":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Instruction"}},"title":"AgentRequestFormPortalStep","type":"object"},"AgentRequestFormRequestContext":{"additionalProperties":false,"description":"One section of the form.","properties":{"customer_name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Customer Name"},"workflow_name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Workflow Name"}},"title":"AgentRequestFormRequestContext","type":"object"},"AgentRequestFormRulesAndJudgment":{"additionalProperties":false,"description":"One section of the form.","properties":{"rules":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Rules"},"judgment_type":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormJudgmentTypeAnswer"},{"enum":["rules_based","human_judgment","ai_judgment"],"type":"string"},{"type":"null"}],"title":"Judgment Type"}},"title":"AgentRequestFormRulesAndJudgment","type":"object"},"AgentRequestFormSandboxAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["yes","no","partial"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormSandboxAnswer","type":"object"},"AgentRequestFormSpec":{"additionalProperties":false,"description":"The request form: the Spec sections a customer fills in. Send only the sections to change; a list of items replaces the list.","properties":{"request_context":{"$ref":"#/$defs/AgentRequestFormRequestContext","title":"Request Context"},"goal_and_scope":{"$ref":"#/$defs/AgentRequestFormGoalAndScope","title":"Goal And Scope"},"systems":{"items":{"$ref":"#/$defs/AgentRequestFormSystem"},"maxItems":50,"title":"Systems","type":"array"},"browser_portals":{"items":{"$ref":"#/$defs/AgentRequestFormBrowserPortal"},"maxItems":50,"title":"Browser Portals","type":"array"},"credentials_and_access":{"$ref":"#/$defs/AgentRequestFormCredentialsAndAccess","title":"Credentials And Access"},"current_process":{"$ref":"#/$defs/AgentRequestFormCurrentProcess","title":"Current Process"},"inputs":{"items":{"$ref":"#/$defs/AgentRequestFormInput"},"maxItems":100,"title":"Inputs","type":"array"},"expected_output":{"$ref":"#/$defs/AgentRequestFormExpectedOutput","title":"Expected Output"},"testing":{"$ref":"#/$defs/AgentRequestFormTesting","title":"Testing"},"rules_and_judgment":{"$ref":"#/$defs/AgentRequestFormRulesAndJudgment","title":"Rules And Judgment"},"variations":{"$ref":"#/$defs/AgentRequestFormVariations","title":"Variations"},"not_applicable":{"$ref":"#/$defs/AgentRequestFormNotApplicableSections","title":"Not Applicable"}},"title":"AgentRequestFormSpec","type":"object"},"AgentRequestFormSystem":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"use":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Use"},"access_method":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormAccessMethodAnswer"},{"enum":["website_portal","api","file_transfer","email","other"],"type":"string"},{"type":"null"}],"title":"Access Method"},"availability":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormAvailabilityAnswer"},{"enum":["available","being_arranged","third_party_dependency","not_needed"],"type":"string"},{"type":"null"}],"title":"Availability"}},"title":"AgentRequestFormSystem","type":"object"},"AgentRequestFormTestDataSourcesAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"items":{"enum":["customer_samples","live_production","synthetic","other"],"type":"string"},"maxItems":4,"minItems":1,"type":"array","uniqueItems":true},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormTestDataSourcesAnswer","type":"object"},"AgentRequestFormTesting":{"additionalProperties":false,"description":"One section of the form.","properties":{"sandbox":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormSandboxAnswer"},{"enum":["yes","no","partial"],"type":"string"},{"type":"null"}],"title":"Sandbox or test environment"},"sandbox_details":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Sandbox details"},"test_data_sources":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTestDataSourcesAnswer"},{"items":{"enum":["customer_samples","live_production","synthetic","other"],"type":"string"},"maxItems":4,"minItems":1,"type":"array","uniqueItems":true},{"type":"null"}],"title":"Test data source"},"test_data_details":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Test data details"},"cadence_and_volume":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Cadence and volume"},"test_data_provider":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Provided by"}},"title":"AgentRequestFormTesting","type":"object"},"AgentRequestFormTextAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormTextAnswer","type":"object"},"AgentRequestFormVariationTypeAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["one_path","two_or_three","category_based","changing_conditions"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormVariationTypeAnswer","type":"object"},"AgentRequestFormVariations":{"additionalProperties":false,"description":"One section of the form.","properties":{"variation_type":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormVariationTypeAnswer"},{"enum":["one_path","two_or_three","category_based","changing_conditions"],"type":"string"},{"type":"null"}],"title":"Variation Type"},"description":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Description"}},"title":"AgentRequestFormVariations","type":"object"},"AgentRequestFormVaultReferenceAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"pattern":"^c[a-z0-9]{24}$","type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormVaultReferenceAnswer","type":"object"},"AgentRequestFormYesNoAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormYesNoAnswer","type":"object"}},"properties":{"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"},"specification":{"anyOf":[{"maxLength":20000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Specification"},"discovery_selections":{"anyOf":[{"items":{"$ref":"#/$defs/AgentRequestDiscoverySelection"},"maxItems":8,"type":"array"},{"type":"null"}],"default":null,"title":"Discovery Selections"},"systems":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Systems"},"workflow_spec":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormSpec"},{"type":"null"}],"default":null},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["name"],"title":"custom_agent_request_createArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_createDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_submit_bulk","description":"Submit approved tasks to XY as separate partially completed requests.\n\nUse only after the customer approves sending these tasks to XY. Each\ntask needs name and description; its optional id is the caller's task\nID, not an agent ID. selected_agent_ids may contain chosen XY Discover\ncards; never third-party listing IDs. For a third-party selection, use\nselected_external_listing_id instead, with the ID from external_matches\nor external_listings. Never combine it with selected_agent_ids. XY saves\nthe catalog metadata and returns state pending plus external_selection;\nthis is a consultation hold, not an XY build, purchase, licensing or\nthird-party deployment. The form link opens the read-only tracked request.\nThis shares each request with XY\nimmediately, unlike custom_agent_request_create, which makes a draft.\nNo detailed form, build, deployment, or execution is required or started\nhere. XY gathers missing requirements before building XY/custom tasks;\nthird-party selections remain pending until separately scoped follow-up.\n\nReturns task_id, request_id, form_url and state for every task. Retain\nrequest_id for tracking and messaging. Retry the exact same batch with\nthe same idempotency_key; caller task IDs also deduplicate identical\nsubmissions across keys. Reusing an ID for changed content is refused.\nAccepts 1–50 tasks atomically; discovery's eight-task limit is separate.\nSupports personal and managed organization service credentials.\n","inputSchema":{"$defs":{"AgentRequestBulkTask":{"additionalProperties":false,"properties":{"name":{"maxLength":200,"minLength":1,"pattern":"\\S","title":"Name","type":"string"},"description":{"maxLength":2000,"minLength":1,"pattern":"\\S","title":"Description","type":"string"},"id":{"description":"Optional caller task ID, unique within the organization. Reuse it only for the same task submission.","maxLength":100,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","title":"Id","type":"string"},"selected_agent_ids":{"description":"Optional chosen XY Discover cards, not executable or third-party listing IDs.","items":{"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","type":"string"},"maxItems":4,"title":"Selected Agent Ids","type":"array"},"selected_external_listing_id":{"description":"An ID returned in external_matches or external_listings. Records a pending\nthird-party consultation request, never an XY build. Cannot be combined with\nselected_agent_ids. XY saves the original provider metadata from its catalog.","maxLength":300,"pattern":"^(aws|microsoft):[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Selected External Listing Id","type":"string"}},"required":["name","description"],"title":"AgentRequestBulkTask","type":"object"}},"properties":{"tasks":{"items":{"$ref":"#/$defs/AgentRequestBulkTask"},"maxItems":50,"minItems":1,"title":"Tasks","type":"array"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["tasks","idempotency_key"],"title":"custom_agent_request_submit_bulkArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AgentRequestBulkResult":{"additionalProperties":false,"properties":{"task_id":{"description":"The caller's task ID, or the assigned request ID when none was supplied.","title":"Task Id","type":"string"},"request_id":{"title":"Request Id","type":"string"},"form_url":{"title":"Form Url","type":"string"},"state":{"title":"State","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"replayed":{"title":"Replayed","type":"boolean"},"external_selection":{"$ref":"#/$defs/ExternalListing","description":"Saved provider metadata for a parked third-party request; absent for XY requests.","title":"External Selection"}},"required":["task_id","request_id","form_url","state","version","replayed"],"title":"AgentRequestBulkResult","type":"object"},"ExternalListing":{"additionalProperties":false,"description":"Only allowlisted public metadata crosses the collector/API boundary.","properties":{"id":{"maxLength":300,"minLength":1,"title":"Id","type":"string"},"provider":{"enum":["microsoft","aws"],"title":"Provider","type":"string"},"source_id":{"maxLength":255,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Source Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"description":{"maxLength":4000,"minLength":1,"title":"Description","type":"string"},"publisher":{"maxLength":500,"minLength":1,"title":"Publisher","type":"string"},"source_url":{"maxLength":2048,"title":"Source Url","type":"string"},"logo_url":{"anyOf":[{"maxLength":2048,"type":"string"},{"type":"null"}],"default":null,"description":"Public HTTPS product or publisher logo thumbnail URL; null when unavailable.","title":"Logo Url"},"product_type":{"maxLength":100,"minLength":1,"title":"Product Type","type":"string"},"categories":{"items":{"type":"string"},"maxItems":30,"title":"Categories","type":"array"},"pricing_models":{"items":{"type":"string"},"maxItems":20,"title":"Pricing Models","type":"array"},"vendor_pricing":{"anyOf":[{"$ref":"#/$defs/VendorPricing"},{"type":"null"}],"default":null,"description":"Published public vendor prices, not measured XY cost. Null means not collected."},"deployment":{"const":"external_provider","default":"external_provider","title":"Deployment","type":"string"}},"required":["id","provider","source_id","name","description","publisher","source_url","product_type"],"title":"ExternalListing","type":"object"},"VendorPriceRate":{"additionalProperties":false,"properties":{"rate_id":{"pattern":"^[0-9a-f]{16}$","title":"Rate Id","type":"string"},"offer_id":{"maxLength":255,"minLength":1,"pattern":"^[\\w-]+$","title":"Offer Id","type":"string"},"dimension_key":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Dimension Key"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"description":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"currency":{"const":"USD","default":"USD","title":"Currency","type":"string"},"period":{"enum":["unit","month","contract"],"title":"Period","type":"string"},"unit":{"maxLength":500,"minLength":1,"title":"Unit","type":"string"},"vendor_unit":{"maxLength":500,"minLength":1,"title":"Vendor Unit","type":"string"},"unit_price_usd":{"maximum":1000000000,"minimum":0,"title":"Unit Price Usd","type":"number"},"duration":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"title":"Duration"},"expires_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Expires At"},"conditions":{"items":{"type":"string"},"maxItems":20,"title":"Conditions","type":"array"}},"required":["rate_id","offer_id","name","period","unit","vendor_unit","unit_price_usd"],"title":"VendorPriceRate","type":"object"},"VendorPricing":{"additionalProperties":false,"properties":{"basis":{"const":"published_vendor_prices","default":"published_vendor_prices","title":"Basis","type":"string"},"status":{"description":"Availability when collected, not a promise that cached or saved prices remain current.","enum":["available","needs_more_information"],"title":"Status","type":"string"},"checked_at":{"description":"Original verification time. Estimates reject prices older than two days; saved selections retain their intake snapshot.","format":"date-time","title":"Checked At","type":"string"},"rates":{"items":{"$ref":"#/$defs/VendorPriceRate"},"maxItems":100,"title":"Rates","type":"array"},"coverage":{"const":"partial","default":"partial","title":"Coverage","type":"string"},"unavailable_reason":{"anyOf":[{"enum":["collection_failed","no_usable_public_price"],"type":"string"},{"type":"null"}],"default":null,"title":"Unavailable Reason"},"note":{"default":"Published USD prices from default public offers, not XY operating-cost evidence or a quote. Different operations and conditions have different rates. Other charges may apply; unlisted rates are unknown, not free.","title":"Note","type":"string"}},"required":["status","checked_at"],"title":"VendorPricing","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/AgentRequestBulkResult"},"title":"Data","type":"array"}},"required":["data"],"title":"AgentRequestBulkResponse","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_update","description":"Save changes to a custom request's form without sharing them with XY.\n\nworkflow_spec holds only the Spec sections to change, in the shape\ncustom_agent_request_get returns. A section's fields change one by one;\na list of items (systems, browser_portals, inputs, and a portal's steps)\nreplaces the list, and an item without an id is new. Give an answer as\nits value, null to clear it, or {\"state\": \"not_applicable\", \"reason\":\n\"...\"} when it does not apply. open_fields in the result lists what XY\nstill needs. Credentials are only ever a Password Vault credential ID in\ncredentials_and_access.vault_reference, never a password or key.\n\ntesting follows Expected output. testing.sandbox is yes|no|partial;\ntesting.test_data_sources is a non-empty list of unique choices from\ncustomer_samples|live_production|synthetic|other. The remaining fields\nsandbox_details, test_data_details, cadence_and_volume, and\ntest_data_provider take text answers. Testing does not yet affect\nsubmission readiness. Customers cannot choose Not sure.\n\nPass the request's current version; each change returns the next one.\nRetry an unchanged call with the same idempotency_key and version.\n","inputSchema":{"$defs":{"AgentRequestFormAccessMethodAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["website_portal","api","file_transfer","email","other"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormAccessMethodAnswer","type":"object"},"AgentRequestFormAvailabilityAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["available","being_arranged","third_party_dependency","not_needed"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormAvailabilityAnswer","type":"object"},"AgentRequestFormBrowserPortal":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"domain":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Domain"},"system":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"System"},"steps":{"items":{"$ref":"#/$defs/AgentRequestFormPortalStep"},"maxItems":200,"title":"Steps","type":"array"}},"title":"AgentRequestFormBrowserPortal","type":"object"},"AgentRequestFormCredentialsAndAccess":{"additionalProperties":false,"description":"One section of the form.","properties":{"credentials_needed":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormYesNoAnswer"},{"type":"boolean"},{"type":"null"}],"title":"Credentials Needed"},"vault_reference":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormVaultReferenceAnswer"},{"pattern":"^c[a-z0-9]{24}$","type":"string"},{"type":"null"}],"title":"Vault Reference"},"outstanding_requirements":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Outstanding Requirements"}},"title":"AgentRequestFormCredentialsAndAccess","type":"object"},"AgentRequestFormCurrentProcess":{"additionalProperties":false,"description":"One section of the form.","properties":{"documentation_status":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormDocumentationStatusAnswer"},{"enum":["complete","partial_informal","mainly_undocumented"],"type":"string"},{"type":"null"}],"title":"Documentation Status"},"sop_links":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Sop Links"}},"title":"AgentRequestFormCurrentProcess","type":"object"},"AgentRequestFormDocumentationStatusAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["complete","partial_informal","mainly_undocumented"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormDocumentationStatusAnswer","type":"object"},"AgentRequestFormExpectedOutput":{"additionalProperties":false,"description":"One section of the form.","properties":{"description":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Description"},"examples":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Examples"}},"title":"AgentRequestFormExpectedOutput","type":"object"},"AgentRequestFormGoalAndScope":{"additionalProperties":false,"description":"One section of the form.","properties":{"desired_outcome":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Desired Outcome"},"why_it_matters":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Why It Matters"},"in_scope":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"In Scope"},"out_of_scope":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Out Of Scope"},"success_criteria":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Success Criteria"}},"title":"AgentRequestFormGoalAndScope","type":"object"},"AgentRequestFormInput":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Description"},"example":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Example"}},"title":"AgentRequestFormInput","type":"object"},"AgentRequestFormJudgmentTypeAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["rules_based","human_judgment","ai_judgment"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormJudgmentTypeAnswer","type":"object"},"AgentRequestFormListMark":{"additionalProperties":false,"description":"A repeating section marked Not applicable, with the reason it has no items.","properties":{"state":{"default":"unanswered","enum":["unanswered","not_applicable"],"title":"State","type":"string"},"value":{"default":null,"title":"Value","type":"null"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormListMark","type":"object"},"AgentRequestFormNotApplicableSections":{"additionalProperties":false,"description":"Repeating sections that can be empty, if marked Not applicable with a reason.","properties":{"browser_portals":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormListMark"},{"type":"null"}],"title":"Browser Portals"},"inputs":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormListMark"},{"type":"null"}],"title":"Inputs"}},"title":"AgentRequestFormNotApplicableSections","type":"object"},"AgentRequestFormPortalStep":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"instruction":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Instruction"}},"title":"AgentRequestFormPortalStep","type":"object"},"AgentRequestFormRequestContext":{"additionalProperties":false,"description":"One section of the form.","properties":{"customer_name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Customer Name"},"workflow_name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Workflow Name"}},"title":"AgentRequestFormRequestContext","type":"object"},"AgentRequestFormRulesAndJudgment":{"additionalProperties":false,"description":"One section of the form.","properties":{"rules":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Rules"},"judgment_type":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormJudgmentTypeAnswer"},{"enum":["rules_based","human_judgment","ai_judgment"],"type":"string"},{"type":"null"}],"title":"Judgment Type"}},"title":"AgentRequestFormRulesAndJudgment","type":"object"},"AgentRequestFormSandboxAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["yes","no","partial"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormSandboxAnswer","type":"object"},"AgentRequestFormSpec":{"additionalProperties":false,"description":"The request form: the Spec sections a customer fills in. Send only the sections to change; a list of items replaces the list.","properties":{"request_context":{"$ref":"#/$defs/AgentRequestFormRequestContext","title":"Request Context"},"goal_and_scope":{"$ref":"#/$defs/AgentRequestFormGoalAndScope","title":"Goal And Scope"},"systems":{"items":{"$ref":"#/$defs/AgentRequestFormSystem"},"maxItems":50,"title":"Systems","type":"array"},"browser_portals":{"items":{"$ref":"#/$defs/AgentRequestFormBrowserPortal"},"maxItems":50,"title":"Browser Portals","type":"array"},"credentials_and_access":{"$ref":"#/$defs/AgentRequestFormCredentialsAndAccess","title":"Credentials And Access"},"current_process":{"$ref":"#/$defs/AgentRequestFormCurrentProcess","title":"Current Process"},"inputs":{"items":{"$ref":"#/$defs/AgentRequestFormInput"},"maxItems":100,"title":"Inputs","type":"array"},"expected_output":{"$ref":"#/$defs/AgentRequestFormExpectedOutput","title":"Expected Output"},"testing":{"$ref":"#/$defs/AgentRequestFormTesting","title":"Testing"},"rules_and_judgment":{"$ref":"#/$defs/AgentRequestFormRulesAndJudgment","title":"Rules And Judgment"},"variations":{"$ref":"#/$defs/AgentRequestFormVariations","title":"Variations"},"not_applicable":{"$ref":"#/$defs/AgentRequestFormNotApplicableSections","title":"Not Applicable"}},"title":"AgentRequestFormSpec","type":"object"},"AgentRequestFormSystem":{"additionalProperties":false,"description":"One item; send it without an id to add it.","properties":{"id":{"title":"Id","type":"string"},"name":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"use":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Use"},"access_method":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormAccessMethodAnswer"},{"enum":["website_portal","api","file_transfer","email","other"],"type":"string"},{"type":"null"}],"title":"Access Method"},"availability":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormAvailabilityAnswer"},{"enum":["available","being_arranged","third_party_dependency","not_needed"],"type":"string"},{"type":"null"}],"title":"Availability"}},"title":"AgentRequestFormSystem","type":"object"},"AgentRequestFormTestDataSourcesAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"items":{"enum":["customer_samples","live_production","synthetic","other"],"type":"string"},"maxItems":4,"minItems":1,"type":"array","uniqueItems":true},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormTestDataSourcesAnswer","type":"object"},"AgentRequestFormTesting":{"additionalProperties":false,"description":"One section of the form.","properties":{"sandbox":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormSandboxAnswer"},{"enum":["yes","no","partial"],"type":"string"},{"type":"null"}],"title":"Sandbox or test environment"},"sandbox_details":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Sandbox details"},"test_data_sources":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTestDataSourcesAnswer"},{"items":{"enum":["customer_samples","live_production","synthetic","other"],"type":"string"},"maxItems":4,"minItems":1,"type":"array","uniqueItems":true},{"type":"null"}],"title":"Test data source"},"test_data_details":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Test data details"},"cadence_and_volume":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Cadence and volume"},"test_data_provider":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Provided by"}},"title":"AgentRequestFormTesting","type":"object"},"AgentRequestFormTextAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormTextAnswer","type":"object"},"AgentRequestFormVariationTypeAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"enum":["one_path","two_or_three","category_based","changing_conditions"],"type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormVariationTypeAnswer","type":"object"},"AgentRequestFormVariations":{"additionalProperties":false,"description":"One section of the form.","properties":{"variation_type":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormVariationTypeAnswer"},{"enum":["one_path","two_or_three","category_based","changing_conditions"],"type":"string"},{"type":"null"}],"title":"Variation Type"},"description":{"anyOf":[{"$ref":"#/$defs/AgentRequestFormTextAnswer"},{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Description"}},"title":"AgentRequestFormVariations","type":"object"},"AgentRequestFormVaultReferenceAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"pattern":"^c[a-z0-9]{24}$","type":"string"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormVaultReferenceAnswer","type":"object"},"AgentRequestFormYesNoAnswer":{"additionalProperties":false,"description":"One answer: its state, its value when answered, and a reason when Not applicable.","properties":{"state":{"default":"unanswered","enum":["unanswered","answered","not_applicable"],"title":"State","type":"string"},"value":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Value"},"reason":{"anyOf":[{"maxLength":10000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Reason"}},"title":"AgentRequestFormYesNoAnswer","type":"object"}},"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"},"workflow_spec":{"$ref":"#/$defs/AgentRequestFormSpec"}},"required":["request_id","version","idempotency_key","workflow_spec"],"title":"custom_agent_request_updateArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_updateDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_publish","description":"Share a custom request's saved form with XY as its next version.\n\nConfirm with the user first. The first publish, and the first after XY\nasks for more information, moves the request to submitted. XY may reply\nthrough the request's messages.\n","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["request_id","version","idempotency_key"],"title":"custom_agent_request_publishArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_publishDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_close","description":"Withdraw a custom request; a closed request no longer changes.\n\nConfirm with the user first. The note tells XY why.\nEmits custom_request.closed. This withdraws the request, not a running\nbuild or deployed workflow; it does not cancel execution or billing.\n","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"note":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["request_id","version"],"title":"custom_agent_request_closeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_closeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_message","description":"Answer an XY clarification or add context to a submitted request.","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"message":{"title":"Message","type":"string"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["request_id","message"],"title":"custom_agent_request_messageArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_messageDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_configuration","description":"Get supported events and organization workflow/queue-state setup choices.\n\nUse these workflow IDs and declared queue states to configure actual run\noutcomes, daily results, and review-required notifications. No raw workflow\ndefinitions, item data, or signing secrets are exposed.\n","inputSchema":{"properties":{},"title":"webhook_configurationArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"WebhookWorkflowChoice":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"queue_statuses":{"items":{"type":"string"},"title":"Queue Statuses","type":"array"}},"required":["id","name","entity_type","queue_statuses"],"title":"WebhookWorkflowChoice","type":"object"}},"additionalProperties":false,"properties":{"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"workflows":{"items":{"$ref":"#/$defs/WebhookWorkflowChoice"},"title":"Workflows","type":"array"}},"required":["event_types","workflows"],"title":"WebhookConfiguration","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscriptions_list","description":"List organization webhook subscriptions without signing secrets.","inputSchema":{"properties":{},"title":"webhook_subscriptions_listArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"Pagination":{"additionalProperties":false,"properties":{"total":{"minimum":0,"title":"Total","type":"integer"},"limit":{"minimum":1,"title":"Limit","type":"integer"},"offset":{"minimum":0,"title":"Offset","type":"integer"},"has_more":{"title":"Has More","type":"boolean"}},"required":["total","limit","offset","has_more"],"title":"Pagination","type":"object"},"WebhookSubscription":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"default":null},"status":{"enum":["active","disabled"],"title":"Status","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"secret_hint":{"maxLength":6,"minLength":6,"title":"Secret Hint","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","url","description","event_types","status","version","secret_hint","created_at","updated_at"],"title":"WebhookSubscription","type":"object"},"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/WebhookSubscription"},"title":"Data","type":"array"},"pagination":{"anyOf":[{"$ref":"#/$defs/Pagination"},{"type":"null"}],"default":null}},"required":["data"],"title":"WebhookSubscriptionList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscription_create","description":"Create an organization HTTPS receiver; save its one-time signing secret.\n\nFor workflow run, review, daily-results, or portal sign-in events, supply\nworkflow_notifications selecting organization workflow IDs. Review alerts\nneed explicit queue review_statuses; daily reports use timezone and\ndaily_send_time (defaults UTC, 09:00).\nSigning secrets verify outbound events; they are not API authorization keys.\n","inputSchema":{"$defs":{"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"properties":{"url":{"title":"Url","type":"string"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"default":null}},"required":["url","event_types"],"title":"webhook_subscription_createArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"default":null},"status":{"enum":["active","disabled"],"title":"Status","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"secret_hint":{"maxLength":6,"minLength":6,"title":"Secret Hint","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"signing_secret":{"description":"Returned only for the first successful creation, never on replay.","title":"Signing Secret","type":"string"}},"required":["id","url","description","event_types","status","version","secret_hint","created_at","updated_at"],"title":"WebhookSubscriptionCreateResult","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscription_get","description":"Read one webhook subscription without its signing secret.","inputSchema":{"properties":{"subscription_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Subscription Id","type":"string"}},"required":["subscription_id"],"title":"webhook_subscription_getArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"default":null},"status":{"enum":["active","disabled"],"title":"Status","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"secret_hint":{"maxLength":6,"minLength":6,"title":"Secret Hint","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","url","description","event_types","status","version","secret_hint","created_at","updated_at"],"title":"WebhookSubscription","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscription_update","description":"Conditionally update an organization webhook subscription.","inputSchema":{"$defs":{"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"properties":{"subscription_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Subscription Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"},"event_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"title":"Event Types"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"enum":["active","disabled"],"type":"string"},{"type":"null"}],"default":null,"title":"Status"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"title":"Workflow Notifications"}},"required":["subscription_id","version"],"title":"webhook_subscription_updateArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"default":null},"status":{"enum":["active","disabled"],"title":"Status","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"secret_hint":{"maxLength":6,"minLength":6,"title":"Secret Hint","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","url","description","event_types","status","version","secret_hint","created_at","updated_at"],"title":"WebhookSubscription","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscription_delete","description":"Irreversibly disable and hide a webhook; delivery history remains.","inputSchema":{"properties":{"subscription_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Subscription Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"}},"required":["subscription_id","version"],"title":"webhook_subscription_deleteArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":false,"properties":{"subscription_id":{"title":"Subscription Id","type":"string"},"deleted":{"const":true,"title":"Deleted","type":"boolean"}},"required":["subscription_id","deleted"],"title":"WebhookSubscriptionDeleteResult","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscription_rotate_secret","description":"Rotate a signing secret and save the one-time replacement returned.","inputSchema":{"properties":{"subscription_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Subscription Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"}},"required":["subscription_id","version"],"title":"webhook_subscription_rotate_secretArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"WorkflowWebhookRule":{"additionalProperties":false,"properties":{"workflow_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Id","type":"string"},"review_statuses":{"items":{"type":"string"},"maxItems":25,"title":"Review Statuses","type":"array"}},"required":["workflow_id"],"title":"WorkflowWebhookRule","type":"object"},"WorkflowWebhookSettings":{"additionalProperties":false,"properties":{"workflows":{"description":"Explicit workflows owned by this organization; never a cross-org wildcard.","items":{"$ref":"#/$defs/WorkflowWebhookRule"},"maxItems":25,"minItems":1,"title":"Workflows","type":"array"},"timezone":{"default":"UTC","maxLength":100,"minLength":1,"title":"Timezone","type":"string"},"daily_send_time":{"default":"09:00","description":"Local send time for the previous calendar day's daily results.","pattern":"^(?:[01]\\d|2[0-3]):[0-5]\\d$","title":"Daily Send Time","type":"string"}},"required":["workflows"],"title":"WorkflowWebhookSettings","type":"object"}},"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"url":{"format":"uri","minLength":1,"title":"Url","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"workflow_notifications":{"anyOf":[{"$ref":"#/$defs/WorkflowWebhookSettings"},{"type":"null"}],"default":null},"status":{"enum":["active","disabled"],"title":"Status","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"secret_hint":{"maxLength":6,"minLength":6,"title":"Secret Hint","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"signing_secret":{"description":"One-time signing secret returned by an explicit rotation.","title":"Signing Secret","type":"string"}},"required":["id","url","description","event_types","status","version","secret_hint","created_at","updated_at","signing_secret"],"title":"WebhookSubscriptionIssued","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_subscription_test","description":"Queue one signed test event for an active webhook subscription.","inputSchema":{"properties":{"subscription_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Subscription Id","type":"string"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["subscription_id"],"title":"webhook_subscription_testArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"subscription_id":{"title":"Subscription Id","type":"string"},"event_id":{"title":"Event Id","type":"string"},"status":{"enum":["pending","delivering","succeeded","dead_lettered"],"title":"Status","type":"string"},"attempt_count":{"minimum":0,"title":"Attempt Count","type":"integer"},"last_response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Response Status"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"next_attempt_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Next Attempt At"},"delivered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Delivered At"},"dead_lettered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Dead Lettered At"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","subscription_id","event_id","status","attempt_count","last_response_status","last_error_code","next_attempt_at","delivered_at","dead_lettered_at","created_at","updated_at"],"title":"WebhookDelivery","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_deliveries_list","description":"Inspect delivery, retry, and dead-letter state without response bodies.","inputSchema":{"properties":{"subscription_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Subscription Id"},"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"webhook_deliveries_listArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"WebhookDelivery":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"subscription_id":{"title":"Subscription Id","type":"string"},"event_id":{"title":"Event Id","type":"string"},"status":{"enum":["pending","delivering","succeeded","dead_lettered"],"title":"Status","type":"string"},"attempt_count":{"minimum":0,"title":"Attempt Count","type":"integer"},"last_response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Response Status"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"next_attempt_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Next Attempt At"},"delivered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Delivered At"},"dead_lettered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Dead Lettered At"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","subscription_id","event_id","status","attempt_count","last_response_status","last_error_code","next_attempt_at","delivered_at","dead_lettered_at","created_at","updated_at"],"title":"WebhookDelivery","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/WebhookDelivery"},"title":"Data","type":"array"}},"required":["data"],"title":"WebhookDeliveryList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_delivery_get","description":"Read one webhook delivery status without receiver response bodies.","inputSchema":{"properties":{"delivery_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Delivery Id","type":"string"}},"required":["delivery_id"],"title":"webhook_delivery_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"subscription_id":{"title":"Subscription Id","type":"string"},"event_id":{"title":"Event Id","type":"string"},"status":{"enum":["pending","delivering","succeeded","dead_lettered"],"title":"Status","type":"string"},"attempt_count":{"minimum":0,"title":"Attempt Count","type":"integer"},"last_response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Response Status"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"next_attempt_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Next Attempt At"},"delivered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Delivered At"},"dead_lettered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Dead Lettered At"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","subscription_id","event_id","status","attempt_count","last_response_status","last_error_code","next_attempt_at","delivered_at","dead_lettered_at","created_at","updated_at"],"title":"WebhookDelivery","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"webhook_delivery_redeliver","description":"Explicitly retry a dead-lettered event with its original event ID.","inputSchema":{"properties":{"delivery_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Delivery Id","type":"string"}},"required":["delivery_id"],"title":"webhook_delivery_redeliverArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":false,"properties":{"id":{"title":"Id","type":"string"},"subscription_id":{"title":"Subscription Id","type":"string"},"event_id":{"title":"Event Id","type":"string"},"status":{"enum":["pending","delivering","succeeded","dead_lettered"],"title":"Status","type":"string"},"attempt_count":{"minimum":0,"title":"Attempt Count","type":"integer"},"last_response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Response Status"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"next_attempt_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Next Attempt At"},"delivered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Delivered At"},"dead_lettered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Dead Lettered At"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","subscription_id","event_id","status","attempt_count","last_response_status","last_error_code","next_attempt_at","delivered_at","dead_lettered_at","created_at","updated_at"],"title":"WebhookDelivery","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["webhooks:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"custom_agent_request_approve_planner","description":"Approve a submitted request and atomically queue its one Planner build.","inputSchema":{"properties":{"request_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Request Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["request_id","version"],"title":"custom_agent_request_approve_plannerArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"custom_agent_request_approve_plannerDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:approve"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboard_agent_query","description":"Ask a read-only analytics question in ordinary business language.\n\nA long analysis answers with status \"running\" and a conversation_id\ninstead of timing out. Then call this tool again with that\nconversation_id and NO prompt (and the same organization_id) to collect\nthe answer; repeat while it still says \"running\". A finished answer has\nstatus \"completed\".\n\nPersonal keys and OAuth must scope the question to one workflow. A\nworkflow_name that resolves to exactly one workflow you can open selects\nit and the call continues. With no workflow_definition_id and no\nworkflow_name that resolves to exactly one workflow, the call fails with\na 400 that lists workflows you can query as \"<id> (<name>)\" (up to 20, or\nthe granted matches when the name is ambiguous); retry with one of those\nids as workflow_definition_id.\nA WORKFLOW_CONTROL_NOT_FOUND names what could not be reached (for example\nthe workflow definition) without saying whether it is missing or hidden.\n\nXY staff may query another organization where they are STAFF by passing\norganization_id; it needs internal_dashboards:read there.\n","inputSchema":{"properties":{"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prompt"},"workflow_definition_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Workflow Definition Id"},"workflow_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Workflow Name"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Conversation Id"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"title":"dashboard_agent_queryArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_agent_queryDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["dashboards:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboard_proposal_start","description":"Describe a new or revised dashboard in ordinary business language.\n\nState the questions people need answered, useful measures or comparisons,\nand a time range when relevant. Do not ask the user for query references,\nanalytics schemas, entity fields, or a dashboard specification; the agent\ninfers them from the selected workflow. Omit base_dashboard_version_id to\ncreate a dashboard. Supply the exact current live version to propose an edit.\nGeneration stops with a preview for human web review; this tool cannot approve\nor publish the result. Access: an explicit configure grant on the workflow,\nor (personal keys and OAuth) being able to open a dashboard in the\norganization. XY staff may pass organization_id for another organization\nwhere they are STAFF; it needs internal_dashboards:write there, and the same\norganization_id on the get, wait and cancel calls. A dashboard that has never\nbeen published has no live version; revise that preview with the staff analytics apply path\n(PreviewDashboardVersion, edit true, base version = the current preview)\nrather than this proposal tool.\n","inputSchema":{"properties":{"prompt":{"title":"Prompt","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"},"base_dashboard_version_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Base Dashboard Version Id"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Conversation Id"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["prompt","workflow_definition_id","idempotency_key"],"title":"dashboard_proposal_startArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_proposal_startDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["dashboards:propose"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboard_proposal_get","description":"Read durable proposal status and its exact human-review version.","inputSchema":{"properties":{"run_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Run Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["run_id"],"title":"dashboard_proposal_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_proposal_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["dashboards:propose"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboard_proposal_wait_for_events","description":"Replay normalized safe progress and wait briefly for the next event.","inputSchema":{"properties":{"run_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Run Id","type":"string"},"after":{"default":0,"minimum":0,"title":"After","type":"integer"},"timeout_seconds":{"default":20,"exclusiveMinimum":0,"title":"Timeout Seconds","type":"integer"},"limit":{"default":100,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["run_id"],"title":"dashboard_proposal_wait_for_eventsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_proposal_wait_for_eventsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["dashboards:propose"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboard_proposal_cancel","description":"Request cancellation without approving or deleting any created version.","inputSchema":{"properties":{"run_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Run Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["run_id"],"title":"dashboard_proposal_cancelArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_proposal_cancelDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["dashboards:propose"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboard_proposal_resolve_approval","description":"The admitted human resolves a pending operation; publication is separate.","inputSchema":{"properties":{"run_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Run Id","type":"string"},"operation_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Operation Id","type":"string"},"request_hash":{"title":"Request Hash","type":"string"},"version":{"title":"Version","type":"integer"},"approved":{"title":"Approved","type":"boolean"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["run_id","operation_id","request_hash","version","approved"],"title":"dashboard_proposal_resolve_approvalArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_proposal_resolve_approvalDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["dashboards:propose"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"dashboards_list","description":"List every live dashboard you can open in the XY analytics app.\n\nSame access as the app. XY staff may pass organization_id for another\norganization where they are STAFF; it needs internal_dashboards:read there.\nOpen one with dashboard_view. At most 200 come back; pagination.has_more\nis true (total null) past that. An empty list carries a hint naming the\norganization that was read.\n","inputSchema":{"properties":{"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"title":"dashboards_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboards_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["metrics:read"]}],"ui":{"resourceUri":"ui://xy-analytics/dashboard.html","visibility":["model"]},"openai/outputTemplate":"ui://xy-analytics/dashboard.html","openai/widgetAccessible":false}},{"name":"dashboard_view","description":"Show any dashboard you can open in the XY analytics app, with all its tiles.\n\nOmit both dates for the shared inclusive 30-day UTC window ending today (or that zone's today when timezone is set).\nTiles that do not accept dates retain their own window and are marked.\nXY staff may pass\norganization_id for another organization where they are STAFF.\nA filter the dashboard marks required (for example a workflow) that has\nno default, or whose default is accepted by none of the tiles it applies\nto, is not applied here: its tiles then cover every\nworkflow you can see (the whole organization for STAFF and admins), and\nthe result carries a warning and unapplied_required_filters. Never report\nthose numbers as the dashboard's answer; say it needs that selection.\n","inputSchema":{"properties":{"dashboard":{"description":"Dashboard id, slug, or an app.xy.ai/analytics/<id> URL.","maxLength":500,"minLength":1,"title":"Dashboard","type":"string"},"from_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"From Date"},"to_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"To Date"},"timezone":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Optional IANA zone (e.g. America/New_York) for the window and day buckets; default UTC.","title":"Timezone"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["dashboard"],"title":"dashboard_viewArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"dashboard_viewDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["metrics:read"]}],"ui":{"resourceUri":"ui://xy-analytics/dashboard.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-analytics/dashboard.html","openai/widgetAccessible":true}},{"name":"workflow_metric_dashboards_list","description":"List approved metric views for one workflow you or your dashboards can see.\n\nAccess is an explicit workflow view grant, or a grant on the dashboard\nitself (STAFF see every dashboard). XY staff may read another organization\nwhere they are STAFF by passing organization_id; it needs\ninternal_dashboards:read there.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["workflow_definition_id"],"title":"workflow_metric_dashboards_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_metric_dashboards_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["metrics:read"]}],"ui":{"resourceUri":"ui://xy-analytics/dashboard.html","visibility":["model"]},"openai/outputTemplate":"ui://xy-analytics/dashboard.html","openai/widgetAccessible":false}},{"name":"workflow_metric_dashboard_get","description":"Render one approved metric view for a workflow (same access as the list).\n\nOmit both dates for the shared inclusive 30-day UTC window ending today (or that zone's today when timezone is set).\nTiles that do not accept dates retain their own window and are marked.\nXY staff may pass organization_id for another organization where they are\nSTAFF; it needs internal_dashboards:read there.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"dashboard_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Dashboard Id","type":"string"},"from_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"From Date"},"to_date":{"anyOf":[{"pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},{"type":"null"}],"default":null,"title":"To Date"},"timezone":{"anyOf":[{"maxLength":64,"type":"string"},{"type":"null"}],"default":null,"description":"Optional IANA zone (e.g. America/New_York) for the window and day buckets; default UTC.","title":"Timezone"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization.","title":"Organization Id"}},"required":["workflow_definition_id","dashboard_id"],"title":"workflow_metric_dashboard_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_metric_dashboard_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["metrics:read"]}],"ui":{"resourceUri":"ui://xy-analytics/dashboard.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-analytics/dashboard.html","openai/widgetAccessible":true}},{"name":"review_items_list","description":"List permitted review records from catalog, Planner or code-backed workflows.\n\nUse available_decisions as authority; an empty list means read-only.\nCode-backed workflows need explicit handover and canonical queue opt-in.\nResolved listings require one source run ID and return revision tokens.\nThis returns safe summaries, not raw record attributes or attachments.\n","inputSchema":{"properties":{"workflow_definition_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Workflow Definition Id"},"workflow_instance_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[^/\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Workflow Instance Id"},"execution_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Execution Id"},"agent_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Agent Id"},"state":{"default":"open","enum":["open","resolved"],"title":"State","type":"string"},"limit":{"default":25,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"offset":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},"title":"review_items_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"review_items_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["review_items:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"review_items_decide","description":"Apply a supported decision to exact review IDs using the shared REST contract.\n\nThis can wake downstream workflows. Respect each item's available_decisions\nand report each result: a 200 response can contain conflicts or refusals.\nCode-backed writes also require the exact workflow's canReview grant.\nNo idempotency key is needed; writes compare the row version and status.\nAfter a timeout, an already committed decision may report not_found on\nretry. Check review_items_list(state=\"resolved\") before retrying.\nReopening requires review_items:revise plus the source run and revision token.\nCustom backend commands are not implied by a matching status label.\n","inputSchema":{"$defs":{"AgentReviewRevision":{"additionalProperties":false,"properties":{"execution_id":{"description":"The execution that produced this item. Required so a revision is resolved within one run instead of the organization's whole decided history.","title":"Execution Id","type":"string"},"workflow_instance_id":{"description":"The workflow run that produced this item. Use this instead of execution_id for planner_workflow or code_workflow items.","title":"Workflow Instance Id","type":"string"},"revision_token":{"description":"The revision_token returned when the state being reversed was written. If the item has moved on since - including moving away and back - the result is conflict and nothing is written.","title":"Revision Token","type":"string"}},"required":["execution_id","revision_token"],"title":"AgentReviewRevision","type":"object"},"PlannerReviewRevision":{"additionalProperties":false,"properties":{"execution_id":{"description":"The execution that produced this item. Required so a revision is resolved within one run instead of the organization's whole decided history.","title":"Execution Id","type":"string"},"workflow_instance_id":{"description":"The workflow run that produced this item. Use this instead of execution_id for planner_workflow or code_workflow items.","title":"Workflow Instance Id","type":"string"},"revision_token":{"description":"The revision_token returned when the state being reversed was written. If the item has moved on since - including moving away and back - the result is conflict and nothing is written.","title":"Revision Token","type":"string"}},"required":["workflow_instance_id","revision_token"],"title":"PlannerReviewRevision","type":"object"}},"properties":{"item_ids":{"items":{"type":"string"},"maxItems":200,"minItems":1,"title":"Item Ids","type":"array"},"decision":{"enum":["approve","reject","defer"],"title":"Decision","type":"string"},"note":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Note"},"revise":{"anyOf":[{"$ref":"#/$defs/AgentReviewRevision"},{"$ref":"#/$defs/PlannerReviewRevision"},{"type":"null"}],"default":null,"title":"Revise"}},"required":["item_ids","decision"],"title":"review_items_decideArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"review_items_decideDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["review_items:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflows_list","description":"Find workflows you may view, including delivered code-backed workflows.\n\nThese are the organization's permitted workflows, not the global agent\ncatalog. Inspect one with workflow_get before supplying runtime inputs.\n","inputSchema":{"properties":{"limit":{"default":25,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"offset":{"default":0,"maximum":1000000,"minimum":0,"title":"Offset","type":"integer"}},"title":"workflows_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflows_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_get","description":"Read workflow metadata, runtime input contract and current permissions.\n\nUse the same operation for Planner and code-backed workflows. Inputs not\ndeclared in the code-backed workflow's approved schema are rejected;\nomitted input uses its saved defaults. This never returns source code,\ncredentials or stored input values.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"}},"required":["workflow_definition_id"],"title":"workflow_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_operating_cost","description":"Read this permitted workflow's own collected operating cost.\n\nRequires separate organization cost approval (useOperatingCostReports),\nusage:read and permission to view the workflow; otherwise returns 403.\nWorks for Planner and code-backed workflows without an original order.\nOptional from_time/to_time are timezone-aware ISO timestamps (default\nlast 30 days). Only completed UTC days are costed, after daily collection.\nCost combines recorded model charges and allocated worker/orchestration\ncosts, including estimated logging costs allocated to the workflow.\nOriginal evidence is unchanged; logging is allocated, not metered. Partial is a subtotal and\nunavailable is null, never free. Per-item\naverages require complete item coverage. This is not a price or invoice.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"from_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"From Time"},"to_time":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"To Time"}},"required":["workflow_definition_id"],"title":"workflow_operating_costArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_operating_costDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["usage:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_logic_get","description":"Read the published business Logic of a permitted workflow.\n\nWorks for Planner and developer-built workflows. Follow next_offset with\nthe returned revision_id as expected_revision_id. Unavailable means no\npublished description yet. This never retrieves implementation code.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"scope_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Scope Id"},"offset":{"default":0,"minimum":0,"title":"Offset","type":"integer"},"expected_revision_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Expected Revision Id"}},"required":["workflow_definition_id"],"title":"workflow_logic_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_logic_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_change_request","description":"Propose a workflow change after reading its published Logic.\n\nRequires configure permission. Describe the desired behavior in body;\nretain scope_id and revision_id from workflow_logic_get. Code-backed\nchanges go to Engineering/FDE review, never the Planner editor. This\nrecords intent; it does not change the live flow or start a build.\nRetain the same idempotency key and body when retrying.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"scope_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Scope Id","type":"string"},"revision_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Revision Id","type":"string"},"body":{"maxLength":12000,"minLength":1,"title":"Body","type":"string"},"stage_id":{"anyOf":[{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Stage Id"},"acknowledge_stale_base":{"default":false,"title":"Acknowledge Stale Base","type":"boolean"},"idempotency_key":{"anyOf":[{"maxLength":128,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["workflow_definition_id","scope_id","revision_id","body"],"title":"workflow_change_requestArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_change_requestDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_change_get","description":"Follow an exact workflow change through review. Ticket completion is\nseparate from verified publication of that change to the live workflow.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"change_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Change Id","type":"string"}},"required":["workflow_definition_id","change_id"],"title":"workflow_change_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_change_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["agent_requests:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_get_phases","description":"Read safe phases for an exact workflow run.\n\nSTAFF may pass organization_id with internal_schedules:read for org-wide\nruns. Planner step-test runs retain internal_agent_requests:read access\nwhen the caller can see their build. executions:read is also required.\n","inputSchema":{"properties":{"workflow_instance_id":{"maxLength":500,"minLength":1,"pattern":"^[^/\\\\?#]+$","title":"Workflow Instance Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["workflow_instance_id"],"title":"workflow_get_phasesArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_get_phasesDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"resourceUri":"ui://xy-operations/run-status.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-operations/run-status.html","openai/widgetAccessible":true}},{"name":"workflow_execute","description":"Run a permitted Planner or code-backed workflow once now. Inspect its\napproved runtime inputs with workflow_get first. Defaults to a **test** run (`is_test`\ntrue), matching in-app WebMCP. For a real production run set `is_test`\nfalse and `confirm` true only after the user explicitly asked.\nTest mode labels runs and data; it can still act on external systems.\nTell them it is running and share the returned `trace_path` (XY-Mind Trace tab).\nQueues still show items; Trace is the run timeline. Never invent a Trace\nlink from a catalog-agent execution_id. Never expose the definition ID or\nworkflow_instance_id unless they ask for debugging details.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Input"},"is_test":{"default":true,"title":"Is Test","type":"boolean"},"confirm":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Confirm"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["workflow_definition_id"],"title":"workflow_executeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_executeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"workflow_cancel_run","description":"Stop one workflow run, preserving its schedule and sibling runs.\n\nApplies to permitted code-backed and Planner workflows. This requests\ncancellation; use workflow_get_phases to confirm the final state. It does\nnot undo external work already completed. Retain the key on retries.\n","inputSchema":{"properties":{"workflow_instance_id":{"maxLength":500,"minLength":1,"pattern":"^[^/\\\\?#]+$","title":"Workflow Instance Id","type":"string"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["workflow_instance_id"],"title":"workflow_cancel_runArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"workflow_cancel_runDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"execution_get_phases","description":"Read safe phases for a catalog-agent execution.\n\nSTAFF may pass organization_id with internal_schedules:read in that org;\nexecutions:read is also required.\n","inputSchema":{"properties":{"execution_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Execution Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["execution_id"],"title":"execution_get_phasesArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"execution_get_phasesDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"resourceUri":"ui://xy-operations/run-status.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-operations/run-status.html","openai/widgetAccessible":true}},{"name":"schedules_list","description":"List schedules and recent runs, including phase availability.\n\nSTAFF may pass organization_id with internal_schedules:read in that org.\nPhase availability also requires executions:read and a recorded run.\n","inputSchema":{"properties":{"limit":{"default":25,"exclusiveMinimum":0,"title":"Limit","type":"integer"},"offset":{"default":0,"minimum":0,"title":"Offset","type":"integer"},"paused_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Paused Only"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"title":"schedules_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedules_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_get","description":"Read one workflow definition’s recurring schedule.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"}},"required":["workflow_definition_id"],"title":"schedule_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_create","description":"Set up a recurring schedule for a workflow. Tell the user their\nworkflow will run automatically on the specified schedule. Never\nexpose overlap policies, cron syntax details, or definition IDs.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"cron_expression":{"title":"Cron Expression","type":"string"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Input"},"overlap_policy":{"default":"BUFFER_ALL","title":"Overlap Policy","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["workflow_definition_id","cron_expression"],"title":"schedule_createArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_createDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_update","description":"Update supplied fields on an existing workflow schedule.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"cron_expression":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Cron Expression"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Input"},"overlap_policy":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Overlap Policy"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["workflow_definition_id"],"title":"schedule_updateArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_updateDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_pause","description":"Pause future actions for one workflow schedule.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["workflow_definition_id"],"title":"schedule_pauseArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_pauseDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_resume","description":"Resume future actions for one paused workflow schedule.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Note"}},"required":["workflow_definition_id"],"title":"schedule_resumeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_resumeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_trigger","description":"Trigger now; reuse idempotency_key for every retry of one attempt.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"},"overlap_policy":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Overlap Policy"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["workflow_definition_id"],"title":"schedule_triggerArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_triggerDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"schedule_delete","description":"Delete a schedule; the workflow definition remains intact.","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":500,"minLength":1,"pattern":"^[A-Za-z0-9_.:-]+$","title":"Workflow Definition Id","type":"string"}},"required":["workflow_definition_id"],"title":"schedule_deleteArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"schedule_deleteDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["schedules:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_list_targets","description":"Find workflows whose operator screens your personal or system credential may design.","inputSchema":{"properties":{"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"cursor":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Cursor"}},"title":"queue_ui_list_targetsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignTarget":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Live Version Id"}},"required":["workflow_definition_id","title","live_url"],"title":"QueueDesignTarget","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/QueueDesignTarget"},"maxItems":100,"title":"Data","type":"array"},"next_cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"}},"required":["data"],"title":"QueueDesignTargetList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_list_designs","description":"Find your saved queue designs and their generation or review status.","inputSchema":{"properties":{"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"cursor":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Cursor"}},"title":"queue_ui_list_designsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesign":{"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/QueueDesign"},"maxItems":100,"title":"Data","type":"array"},"next_cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"}},"required":["data"],"title":"QueueDesignList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_start_design","description":"Describe an operator screen in ordinary business language.\n\nExplain what work people should see, which details help them decide, and what\nactions they need. Do not ask the user for entities, status enums, fields, or a\nUI schema; the designer infers those from the workflow. Keep the request key\nfor retries, follow progress events, then open the returned review link.\n","inputSchema":{"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"prompt":{"maxLength":20000,"minLength":1,"pattern":"\\S","title":"Prompt","type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["workflow_definition_id","prompt","idempotency_key"],"title":"queue_ui_start_designArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_get_design","description":"Check a design's progress, current version, review link, and live publication.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"}},"required":["design_id"],"title":"queue_ui_get_designArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_list_versions","description":"Compare saved design versions, validation results, and preview links.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"limit":{"default":50,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"cursor":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Cursor"}},"required":["design_id"],"title":"queue_ui_list_versionsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/QueueDesignVersion"},"maxItems":100,"title":"Data","type":"array"},"next_cursor":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"}},"required":["data"],"title":"QueueDesignVersionList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_get_version","description":"Inspect one exact saved version and open its preview for human review.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"version_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Version Id","type":"string"}},"required":["design_id","version_id"],"title":"queue_ui_get_versionArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_send_message","description":"Describe screen changes in business language to create a new version.\n\nTranslate requests such as changing what operators see, filter, decide, or do\ninto the UI contract internally. Reuse the request key when retrying.\n","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"prompt":{"maxLength":20000,"minLength":1,"pattern":"\\S","title":"Prompt","type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["design_id","prompt","idempotency_key"],"title":"queue_ui_send_messageArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_get_events","description":"Read saved generation progress and summarize it in ordinary language.\n\nKeep run_id and after_seq together; start at zero for a new run. After a\nconnection failure, inspect state and events instead of blindly sending\nanother mutation. Generation is not approval or publication. Do not show raw\nevent names or IDs unless the user requests debugging details.\n","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"run_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Run Id"},"after_seq":{"default":0,"minimum":0,"title":"After Seq","type":"integer"},"limit":{"default":100,"maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"required":["design_id"],"title":"queue_ui_get_eventsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"PlannerProgressEvent":{"additionalProperties":false,"description":"Content-safe progress shared by Planner, Queue UI, CLI, MCP, and web.","properties":{"schema_version":{"minimum":1,"title":"Schema Version","type":"integer"},"kind":{"enum":["phase_started","phase_completed","message_delta","message_snapshot","tool_started","tool_completed","artifact_changed","approval_required","approval_resolved","warning","failed","cancelled","succeeded"],"title":"Kind","type":"string"},"phase":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Phase"},"label":{"anyOf":[{"maxLength":512,"type":"string"},{"type":"null"}],"default":null,"title":"Label"},"message_delta":{"anyOf":[{"maxLength":8192,"type":"string"},{"type":"null"}],"default":null,"title":"Message Delta"},"tool_name":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Tool Name"},"tool_call_id":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Tool Call Id"},"outcome":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Outcome"},"artifact_refs":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Refs"},"approval_type":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Approval Type"},"approval_ref":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Approval Ref"},"step_number":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"title":"Step Number"},"code":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Code"},"recoverable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Recoverable"}},"required":["schema_version","kind"],"title":"PlannerProgressEvent","type":"object"},"QueueDesignEvent":{"additionalProperties":false,"properties":{"seq":{"minimum":1,"title":"Seq","type":"integer"},"run_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Run Id","type":"string"},"type":{"maxLength":100,"minLength":1,"title":"Type","type":"string"},"data":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Data"},"progress":{"anyOf":[{"$ref":"#/$defs/PlannerProgressEvent"},{"type":"null"}],"default":null},"created_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Created At"}},"required":["seq","run_id","type"],"title":"QueueDesignEvent","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/QueueDesignEvent"},"maxItems":100,"title":"Data","type":"array"},"next_cursor":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Next Cursor"}},"required":["data"],"title":"QueueDesignEventList","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_cancel_run","description":"Stop the selected or current generation run. Saved versions and previews remain available.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"run_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Run Id"}},"required":["design_id"],"title":"queue_ui_cancel_runArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_cleanup_previews","description":"Finish this design session and clean up its temporary previews. This closes the session before cleanup: no further messages or publishing are allowed. Start a fresh session to design again. Versions, publication history, and the live queue remain intact; cleanup retries and rollback still work.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"}},"required":["design_id"],"title":"queue_ui_cleanup_previewsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_approve","description":"Approve this exact design version and its returned 16-character resolved_yaml_hash using a system API key with explicit approval authority. When the version exposes release_digest, supply that exact 64-character digest. Supply the current publication.live_version_id receipt, or explicit null before first publication, as expected_live_version_id; stale approval is rejected. This records system approval, not human review or approval by the key creator. It does not publish; personal keys and user-bound OAuth cannot use this operation.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"version_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Version Id","type":"string"},"resolved_yaml_hash":{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","title":"Resolved Yaml Hash","type":"string"},"expected_live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Expected Live Version Id"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"}},"required":["design_id","version_id","resolved_yaml_hash","expected_live_version_id"],"title":"queue_ui_approveArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:approve"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_publish","description":"Publish an exact approved design version_id with authorized personal or system access. Personal publication also requires an ADMIN, PARTNER, or STAFF organization role plus explicit workflow configure permission; a scope alone is not enough. expected_live_version_id is the publication.live_version_id receipt, or null before first publication, not a design version. Approval and target publication permission are checked separately. Cannot approve a design or publish from a closed session.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"version_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Version Id","type":"string"},"expected_live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Expected Live Version Id"}},"required":["design_id","version_id","expected_live_version_id"],"title":"queue_ui_publishArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:publish"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"queue_ui_rollback","description":"Restore an earlier operator screen without changing business data. to_version_id is a receipt from publication.history or publication.baseline_version_id, not a design version. expected_live_version_id is the current publication.live_version_id receipt. Requires authorized personal or system publication access; works after session cleanup.","inputSchema":{"properties":{"design_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Design Id","type":"string"},"to_version_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"To Version Id","type":"string"},"expected_live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Expected Live Version Id"}},"required":["design_id","to_version_id","expected_live_version_id"],"title":"queue_ui_rollbackArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"QueueDesignPublication":{"additionalProperties":false,"properties":{"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"organization_id":{"maxLength":200,"minLength":1,"title":"Organization Id","type":"string"},"entity_type_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Entity Type Id","type":"string"},"entity_type_key":{"maxLength":200,"minLength":1,"title":"Entity Type Key","type":"string"},"ownership":{"enum":["APP_MANAGED","GIT_MANAGED","LEGACY_UNCLASSIFIED"],"title":"Ownership","type":"string"},"eligible":{"title":"Eligible","type":"boolean"},"ineligibility_reason":{"anyOf":[{"maxLength":1000,"minLength":1,"type":"string"},{"type":"null"}],"title":"Ineligibility Reason"},"live_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Version Id"},"live_workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Workflow Version Id"},"live_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Live Release Digest"},"live_design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Live Design Version Id"},"baseline_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Baseline Version Id"},"live_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Live Yaml Hash"},"live_config_hash":{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Live Config Hash","type":"string"},"drifted":{"title":"Drifted","type":"boolean"},"live_url":{"maxLength":2048,"minLength":1,"title":"Live Url","type":"string"},"history":{"items":{"$ref":"#/$defs/QueueDesignPublicationReceipt"},"maxItems":100,"title":"History","type":"array"},"transitioned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Transitioned"}},"required":["workflow_definition_id","organization_id","entity_type_id","entity_type_key","ownership","eligible","ineligibility_reason","live_version_id","live_workflow_version_id","live_release_digest","live_design_version_id","baseline_version_id","live_yaml_hash","live_config_hash","drifted","live_url","history"],"title":"QueueDesignPublication","type":"object"},"QueueDesignPublicationReceipt":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"operation":{"enum":["BASELINE","PUBLISH","ROLLBACK"],"title":"Operation","type":"string"},"design_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Design Version Id"},"workflow_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Workflow Version Id"},"previous_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Previous Version Id"},"rollback_to_version_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Rollback To Version Id"},"created_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By User Id"},"created_by_actor_type":{"enum":["HUMAN","SYSTEM"],"title":"Created By Actor Type","type":"string"},"created_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Created By Credential Id"},"created_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Created By Service Principal Id"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Approved Resolved Yaml Hash"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"title":"Approved Release Digest"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["id","operation","design_version_id","workflow_version_id","previous_version_id","rollback_to_version_id","created_by_user_id","created_by_actor_type","created_by_credential_id","created_by_service_principal_id","approval_actor_type","approved_by_user_id","approved_by_credential_id","approved_by_service_principal_id","approved_resolved_yaml_hash","approved_release_digest","created_at"],"title":"QueueDesignPublicationReceipt","type":"object"},"QueueDesignRun":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"completion_kind":{"anyOf":[{"enum":["message","preview"],"type":"string"},{"type":"null"}],"default":null,"title":"Completion Kind"},"response":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Response"}},"required":["id","status"],"title":"QueueDesignRun","type":"object"},"QueueDesignVersion":{"additionalProperties":false,"properties":{"id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Id","type":"string"},"session_id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Session Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"state":{"maxLength":80,"minLength":1,"title":"State","type":"string"},"resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"title":"Resolved Yaml Hash"},"artifact_manifest":{"anyOf":[{"additionalProperties":true,"maxProperties":64,"type":"object"},{"type":"null"}],"default":null,"title":"Artifact Manifest"},"release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Release Digest"},"approved_release_digest":{"anyOf":[{"maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Release Digest"},"requires_frontend_change":{"title":"Requires Frontend Change","type":"boolean"},"validation":{"additionalProperties":true,"maxProperties":64,"title":"Validation","type":"object"},"preview_urls":{"items":{"maxLength":2048,"type":"string"},"maxItems":10,"title":"Preview Urls","type":"array"},"approval_actor_type":{"anyOf":[{"enum":["HUMAN","SYSTEM"],"type":"string"},{"type":"null"}],"default":null,"description":"Persisted approval identity, never inferred from the current caller or key creator. Null means no attributed approval is exposed.","title":"Approval Actor Type"},"approved_by_user_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By User Id"},"approved_by_credential_id":{"anyOf":[{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Approved By Credential Id"},"approved_by_service_principal_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Approved By Service Principal Id"},"approved_resolved_yaml_hash":{"anyOf":[{"maxLength":16,"minLength":16,"pattern":"^[0-9a-f]{16}$","type":"string"},{"type":"null"}],"default":null,"title":"Approved Resolved Yaml Hash"},"approved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Approved At"}},"required":["id","session_id","version","state","resolved_yaml_hash","requires_frontend_change","validation","preview_urls"],"title":"QueueDesignVersion","type":"object"}},"additionalProperties":false,"properties":{"id":{"description":"The queue design's `id` (starts with qds_).","maxLength":200,"pattern":"^qds_[A-Za-z0-9_-]+$","title":"Id","type":"string"},"workflow_definition_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Workflow Definition Id","type":"string"},"title":{"maxLength":500,"title":"Title","type":"string"},"status":{"maxLength":80,"minLength":1,"title":"Status","type":"string"},"design_session_id":{"maxLength":200,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Design Session Id","type":"string"},"run":{"anyOf":[{"$ref":"#/$defs/QueueDesignRun"},{"type":"null"}],"default":null},"current_version":{"anyOf":[{"$ref":"#/$defs/QueueDesignVersion"},{"type":"null"}],"default":null},"review_url":{"maxLength":2048,"title":"Review Url","type":"string"},"live_url":{"maxLength":2048,"title":"Live Url","type":"string"},"publication":{"anyOf":[{"$ref":"#/$defs/QueueDesignPublication"},{"type":"null"}],"default":null}},"required":["id","workflow_definition_id","title","status","design_session_id","review_url","live_url"],"title":"QueueDesign","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["queue_ui:publish"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_start","description":"Start generic Marketplace authoring in the API key's organization.\n\nThis is not the STAFF cross-organization CIE Planner entry point. For\ncustomer meetings, evidence, specifications, changelogs, or CIE skills,\nuse internal_cie_authoring_start with an explicit organization instead.\nAttach exact recording, file, credential, workflow-version, or artifact\nreferences only when already known. Save the returned session_id (pass it\nas authoring_id) and resource_version, then follow authoring_events or\nauthoring_get while work is running.\n","inputSchema":{"$defs":{"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"properties":{"message":{"maxLength":200000,"minLength":1,"title":"Message","type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"},"name":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"source_references":{"anyOf":[{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"type":"array"},{"type":"null"}],"default":null,"title":"Source References"}},"required":["message","idempotency_key"],"title":"authoring_startArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_get","description":"Reconnect to one durable workflow-design conversation. Use the returned plain-language status, questions, drafts, handoff, and resource_version; do not expose implementation fields unless the user asks for debugging details.","inputSchema":{"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"}},"required":["authoring_id"],"title":"authoring_getArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_send","description":"Answer a business question or request a revision in ordinary language. Reuse the exact authoring_id and latest resource_version returned by the server. Source references are appended by default; replacement is explicit.","inputSchema":{"$defs":{"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"message":{"maxLength":200000,"minLength":1,"title":"Message","type":"string"},"resource_version":{"exclusiveMinimum":0,"title":"Resource Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"},"source_references":{"anyOf":[{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"type":"array"},{"type":"null"}],"default":null,"title":"Source References"},"source_reference_mode":{"default":"append","enum":["append","replace"],"title":"Source Reference Mode","type":"string"}},"required":["authoring_id","message","resource_version","idempotency_key"],"title":"authoring_sendArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_messages","description":"Replay the retained user and assistant conversation after an optional opaque cursor. Preserve next_cursor across reconnects; message history is not a model transcript or reasoning log.","inputSchema":{"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"after":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"After"},"limit":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"required":["authoring_id"],"title":"authoring_messagesArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AuthoringMessage":{"additionalProperties":false,"allOf":[{"if":{"properties":{"role":{"const":"assistant"}},"required":["role"]},"then":{"properties":{"actor":{"properties":{"type":{"const":"agent"}},"required":["type"]}}}},{"if":{"properties":{"role":{"const":"user"}},"required":["role"]},"then":{"properties":{"actor":{"properties":{"type":{"enum":["user","service"]}},"required":["type"]}}}}],"properties":{"message_id":{"maxLength":500,"minLength":1,"title":"Message Id","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"turn_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Turn Id"},"role":{"enum":["user","assistant"],"title":"Role","type":"string"},"actor":{"$ref":"#/$defs/MessageActor"},"content":{"maxLength":200000,"minLength":1,"title":"Content","type":"string"},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["message_id","session_id","role","actor","content","created_at"],"title":"AuthoringMessage","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"MessageActor":{"additionalProperties":false,"properties":{"type":{"enum":["user","service","agent"],"title":"Type","type":"string"},"actor_id":{"maxLength":500,"minLength":1,"title":"Actor Id","type":"string"}},"required":["type","actor_id"],"title":"MessageActor","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/AuthoringMessage"},"maxItems":200,"title":"Data","type":"array"},"next_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"},"has_more":{"title":"Has More","type":"boolean"}},"required":["data","has_more"],"title":"AuthoringMessagePage","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_events","description":"Read durable, user-safe progress after an optional opaque cursor. Summarize meaningful progress near the user's request and continue until a terminal or input-required state; do not dump raw event names.","inputSchema":{"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"after":{"anyOf":[{"maxLength":2000,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"After"},"limit":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}},"required":["authoring_id"],"title":"authoring_eventsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvent":{"additionalProperties":false,"allOf":[{"else":{"properties":{"progress":{"type":"null"}}},"if":{"properties":{"kind":{"const":"progress"}},"required":["kind"]},"then":{"properties":{"progress":{"not":{"type":"null"}}},"required":["progress"]}},{"else":{"properties":{"message_id":{"type":"null"}}},"if":{"properties":{"kind":{"const":"message_created"}},"required":["kind"]},"then":{"properties":{"message_id":{"not":{"type":"null"}}},"required":["message_id"]}},{"else":{"properties":{"artifact":{"type":"null"}}},"if":{"properties":{"kind":{"const":"artifact_version_created"}},"required":["kind"]},"then":{"properties":{"artifact":{"not":{"type":"null"}}},"required":["artifact"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"kind":{"const":"failed"}},"required":["kind"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"cursor":{"maxLength":2000,"minLength":1,"title":"Cursor","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"turn_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Turn Id"},"runtime_run_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Runtime Run Id"},"kind":{"enum":["session_created","turn_queued","progress","message_created","requirements_changed","artifact_version_created","review_required","accepted","submitted","cancelling","cancelled","failed"],"title":"Kind","type":"string"},"progress":{"anyOf":[{"$ref":"#/$defs/AuthoringProgress"},{"type":"null"}],"default":null},"message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Message Id"},"artifact":{"anyOf":[{"$ref":"#/$defs/AuthoringArtifactReference"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["cursor","session_id","kind","created_at"],"title":"AuthoringEvent","type":"object"},"AuthoringProgress":{"additionalProperties":false,"properties":{"kind":{"enum":["phase_started","phase_completed","tool_started","tool_completed","artifact_changed","approval_required","warning","failed","cancelled","succeeded"],"title":"Kind","type":"string"},"label":{"maxLength":512,"minLength":1,"title":"Label","type":"string"},"phase":{"anyOf":[{"maxLength":256,"type":"string"},{"type":"null"}],"default":null,"title":"Phase"}},"required":["kind","label"],"title":"AuthoringProgress","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/AuthoringEvent"},"maxItems":200,"title":"Data","type":"array"},"next_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Next Cursor"},"has_more":{"title":"Has More","type":"boolean"},"session_status":{"maxLength":80,"minLength":1,"title":"Session Status","type":"string"}},"required":["data","has_more","session_status"],"title":"AuthoringEventPage","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_cancel","description":"Request cooperative cancellation of active authoring work while retaining its conversation and immutable drafts. Use the latest resource_version and keep the same idempotency key when retrying an ambiguous response.","inputSchema":{"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"resource_version":{"exclusiveMinimum":0,"title":"Resource Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["authoring_id","resource_version","idempotency_key"],"title":"authoring_cancelArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_drafts","description":"List exact immutable draft receipts available for review. Present their business meaning to the user and retain the complete receipt for a later accept or discard decision.","inputSchema":{"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"}},"required":["authoring_id"],"title":"authoring_draftsArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"}},"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Data","type":"array"},"session_status":{"maxLength":80,"minLength":1,"title":"Session Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"}},"required":["data","session_status","resource_version"],"title":"AuthoringDraftPage","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_accept","description":"Explicitly accept exact draft receipts after user review. Include at least one workflow-spec receipt returned by authoring_drafts; acceptance never publishes or starts a Planner build.","inputSchema":{"$defs":{"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"}},"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"artifact_versions":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"minItems":1,"title":"Artifact Versions","type":"array"},"resource_version":{"exclusiveMinimum":0,"title":"Resource Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["authoring_id","artifact_versions","resource_version","idempotency_key"],"title":"authoring_acceptArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_discard","description":"Explicitly discard exact draft receipts while retaining the conversation and audit history. This cannot be inferred from a revision request.","inputSchema":{"$defs":{"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"}},"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"artifact_versions":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"minItems":1,"title":"Artifact Versions","type":"array"},"resource_version":{"exclusiveMinimum":0,"title":"Resource Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["authoring_id","artifact_versions","resource_version","idempotency_key"],"title":"authoring_discardArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"authoring_submit","description":"Hand one explicitly accepted immutable Workflow Spec to the governed request lifecycle. target=workflow_request creates a reviewable request; target=planner_build additionally requires agent_requests:approve and starts exactly one Planner build. Retry an ambiguous response with the same idempotency key and resource version.","inputSchema":{"properties":{"authoring_id":{"description":"The authoring session's id (starts with sess_auth_).","maxLength":200,"minLength":16,"pattern":"^sess_auth_[A-Za-z0-9_-]+$","title":"Authoring Id","type":"string"},"workflow_spec_version_id":{"maxLength":500,"minLength":1,"title":"Workflow Spec Version Id","type":"string"},"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_version":{"exclusiveMinimum":0,"title":"Resource Version","type":"integer"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"}},"required":["authoring_id","workflow_spec_version_id","target","resource_version","idempotency_key"],"title":"authoring_submitArguments","type":"object","additionalProperties":false},"outputSchema":{"$defs":{"AcceptedArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"FINALIZED","default":"FINALIZED","title":"Review Status","type":"string"},"accepted_by_user_id":{"maxLength":500,"minLength":1,"title":"Accepted By User Id","type":"string"},"accepted_at":{"format":"date-time","title":"Accepted At","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","accepted_by_user_id","accepted_at"],"title":"AcceptedArtifactReference","type":"object"},"AuthoringArtifactReference":{"additionalProperties":false,"properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"enum":["discovery-spec","workflow-spec","dashboard-spec","testing-agreement"],"title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"enum":["DRAFT","FINALIZED"],"title":"Review Status","type":"string"}},"required":["artifact_id","artifact_version_id","version","kind","content_hash","review_status"],"title":"AuthoringArtifactReference","type":"object"},"AuthoringError":{"additionalProperties":false,"properties":{"error_class":{"enum":["admission","configuration","capacity","conflict","provider_pre_output","provider_post_output","tool","timeout","cancellation","worker_lost","policy"],"title":"Error Class","type":"string"},"code":{"maxLength":200,"minLength":1,"title":"Code","type":"string"},"message":{"maxLength":2000,"minLength":1,"title":"Message","type":"string"},"retryable":{"title":"Retryable","type":"boolean"},"remediation":{"default":"none","enum":["retry_same_idempotency_key","send_new_turn","answer_requirements","contact_xy_staff","review_required","none"],"title":"Remediation","type":"string"}},"required":["error_class","code","message","retryable"],"title":"AuthoringError","type":"object"},"AuthoringEvidenceArtifactReference":{"additionalProperties":false,"description":"Reviewable CIE evidence that is not a canonical downstream spec.","properties":{"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"version":{"minimum":1,"title":"Version","type":"integer"},"kind":{"const":"recording-analysis","default":"recording-analysis","title":"Kind","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"},"review_status":{"const":"DRAFT","default":"DRAFT","title":"Review Status","type":"string"},"title":{"maxLength":500,"minLength":1,"title":"Title","type":"string"},"source_recording_ids":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Source Recording Ids","type":"array"}},"required":["artifact_id","artifact_version_id","version","content_hash","title","source_recording_ids"],"title":"AuthoringEvidenceArtifactReference","type":"object"},"AuthoringHandoff":{"additionalProperties":false,"allOf":[{"properties":{"workflow_spec_version":{"properties":{"kind":{"const":"workflow-spec"}},"required":["kind"]}}},{"properties":{"discovery_spec_version":{"anyOf":[{"type":"null"},{"properties":{"kind":{"const":"discovery-spec"}},"required":["kind"]}]}}}],"properties":{"target":{"enum":["workflow_request","planner_build"],"title":"Target","type":"string"},"resource_id":{"maxLength":500,"minLength":1,"title":"Resource Id","type":"string"},"workflow_spec_version":{"$ref":"#/$defs/AcceptedArtifactReference"},"discovery_spec_version":{"anyOf":[{"$ref":"#/$defs/AcceptedArtifactReference"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"}},"required":["target","resource_id","workflow_spec_version","created_at"],"title":"AuthoringHandoff","type":"object"},"AuthoringTurn":{"additionalProperties":false,"properties":{"turn_id":{"maxLength":500,"minLength":1,"title":"Turn Id","type":"string"},"runtime_run_id":{"maxLength":500,"minLength":1,"title":"Runtime Run Id","type":"string"},"user_message_id":{"maxLength":500,"minLength":1,"title":"User Message Id","type":"string"},"assistant_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Assistant Message Id"},"status":{"enum":["queued","claimed","started","cancelling","cancelled","succeeded","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"queue_wait_deadline_at":{"format":"date-time","title":"Queue Wait Deadline At","type":"string"},"run_deadline_at":{"format":"date-time","title":"Run Deadline At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["turn_id","runtime_run_id","user_message_id","status","queue_wait_deadline_at","run_deadline_at","created_at"],"title":"AuthoringTurn","type":"object"},"CredentialReference":{"additionalProperties":false,"properties":{"type":{"const":"credential","title":"Type","type":"string"},"credential_id":{"maxLength":500,"minLength":1,"title":"Credential Id","type":"string"},"domain":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","credential_id"],"title":"CredentialReference","type":"object"},"ExistingWorkflowReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_version","title":"Type","type":"string"},"workflow_definition_id":{"maxLength":500,"minLength":1,"title":"Workflow Definition Id","type":"string"},"workflow_version_id":{"description":"Exact immutable version; a mutable workflow name is insufficient.","maxLength":500,"minLength":1,"title":"Workflow Version Id","type":"string"}},"required":["type","workflow_definition_id","workflow_version_id"],"title":"ExistingWorkflowReference","type":"object"},"InputArtifactReference":{"additionalProperties":false,"properties":{"type":{"const":"artifact_version","title":"Type","type":"string"},"artifact_id":{"maxLength":500,"minLength":1,"title":"Artifact Id","type":"string"},"artifact_version_id":{"maxLength":500,"minLength":1,"title":"Artifact Version Id","type":"string"},"content_hash":{"maxLength":128,"minLength":32,"title":"Content Hash","type":"string"}},"required":["type","artifact_id","artifact_version_id","content_hash"],"title":"InputArtifactReference","type":"object"},"RecordedTaskReference":{"additionalProperties":false,"properties":{"type":{"const":"recorded_task","title":"Type","type":"string"},"recorded_task_id":{"maxLength":500,"minLength":1,"title":"Recorded Task Id","type":"string"},"display_name":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Display Name"}},"required":["type","recorded_task_id"],"title":"RecordedTaskReference","type":"object"},"UnresolvedRequirement":{"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"const":"resolved"}},"required":["status"]},"then":{"properties":{"answer":{"minLength":1,"pattern":".*\\S.*","type":"string"},"resolved_by_message_id":{"minLength":1,"type":"string"}},"required":["answer","resolved_by_message_id"]}},{"if":{"not":{"properties":{"status":{"enum":["resolved","dismissed"]}},"required":["status"]}},"then":{"properties":{"answer":{"type":"null"}}}}],"properties":{"requirement_key":{"description":"Stable semantic key used to ask the same missing fact deterministically.","maxLength":200,"minLength":1,"pattern":"^[a-z][a-z0-9_.-]*$","title":"Requirement Key","type":"string"},"category":{"enum":["trigger","input","output","routing","access","credential","approval","exception","safety","other"],"title":"Category","type":"string"},"question":{"maxLength":2000,"minLength":1,"title":"Question","type":"string"},"why_needed":{"maxLength":2000,"minLength":1,"title":"Why Needed","type":"string"},"required":{"default":true,"title":"Required","type":"boolean"},"status":{"default":"unresolved","enum":["unresolved","resolved","dismissed"],"title":"Status","type":"string"},"answer":{"anyOf":[{"maxLength":20000,"type":"string"},{"type":"null"}],"default":null,"title":"Answer"},"resolved_by_message_id":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"default":null,"title":"Resolved By Message Id"}},"required":["requirement_key","category","question","why_needed"],"title":"UnresolvedRequirement","type":"object"},"UploadedFileReference":{"additionalProperties":false,"properties":{"type":{"const":"uploaded_file","title":"Type","type":"string"},"file_id":{"maxLength":500,"minLength":1,"title":"File Id","type":"string"},"file_name":{"maxLength":500,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"},"content_hash":{"anyOf":[{"maxLength":128,"minLength":32,"type":"string"},{"type":"null"}],"default":null,"description":"Digest only; file bytes remain in the owned object store.","title":"Content Hash"}},"required":["type","file_id","file_name","content_type"],"title":"UploadedFileReference","type":"object"},"WorkflowLogicChangeReference":{"additionalProperties":false,"properties":{"type":{"const":"workflow_logic_change","title":"Type","type":"string"},"change_id":{"maxLength":160,"minLength":1,"title":"Change Id","type":"string"}},"required":["type","change_id"],"title":"WorkflowLogicChangeReference","type":"object"}},"additionalProperties":false,"allOf":[{"if":{"properties":{"status":{"enum":["queued","running","cancelling"]}},"required":["status"]},"then":{"properties":{"current_turn":{"not":{"type":"null"},"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}},"required":["current_turn"]}},{"if":{"properties":{"status":{"const":"awaiting_input"}},"required":["status"]},"then":{"properties":{"unresolved_requirements":{"contains":{"properties":{"required":{"const":true},"status":{"const":"unresolved"}}},"minContains":1},"current_turn":{"anyOf":[{"type":"null"},{"not":{"properties":{"status":{"enum":["queued","claimed","started","cancelling"]}},"required":["status"]}}]}},"required":["unresolved_requirements"]}},{"if":{"properties":{"status":{"const":"ready_for_review"}},"required":["status"]},"then":{"properties":{"draft_artifacts":{"minItems":1}},"required":["draft_artifacts"]}},{"if":{"properties":{"status":{"enum":["accepted","submitting","submitted"]}},"required":["status"]},"then":{"properties":{"accepted_artifacts":{"contains":{"properties":{"kind":{"const":"workflow-spec"},"review_status":{"const":"FINALIZED"}},"required":["kind"]},"minContains":1}},"required":["accepted_artifacts"]}},{"else":{"properties":{"handoff":{"type":"null"}}},"if":{"properties":{"status":{"const":"submitted"}},"required":["status"]},"then":{"properties":{"handoff":{"not":{"type":"null"}}},"required":["handoff"]}},{"else":{"properties":{"error":{"type":"null"}}},"if":{"properties":{"status":{"enum":["failed","failed_needs_review","timed_out"]}},"required":["status"]},"then":{"properties":{"error":{"not":{"type":"null"}}},"required":["error"]}}],"properties":{"schema_version":{"const":"authoring-session-v1","default":"authoring-session-v1","title":"Schema Version","type":"string"},"session_id":{"maxLength":500,"minLength":1,"title":"Session Id","type":"string"},"organization_id":{"maxLength":500,"minLength":1,"title":"Organization Id","type":"string"},"owner_user_id":{"maxLength":500,"minLength":1,"title":"Owner User Id","type":"string"},"name":{"maxLength":500,"minLength":1,"title":"Name","type":"string"},"status":{"enum":["draft","queued","running","awaiting_input","ready_for_review","accepted","submitting","submitted","cancelling","cancelled","failed","failed_needs_review","timed_out"],"title":"Status","type":"string"},"resource_version":{"minimum":1,"title":"Resource Version","type":"integer"},"last_event_cursor":{"anyOf":[{"maxLength":2000,"type":"string"},{"type":"null"}],"default":null,"title":"Last Event Cursor"},"current_turn":{"anyOf":[{"$ref":"#/$defs/AuthoringTurn"},{"type":"null"}],"default":null},"source_references":{"items":{"discriminator":{"mapping":{"artifact_version":"#/$defs/InputArtifactReference","credential":"#/$defs/CredentialReference","recorded_task":"#/$defs/RecordedTaskReference","uploaded_file":"#/$defs/UploadedFileReference","workflow_logic_change":"#/$defs/WorkflowLogicChangeReference","workflow_version":"#/$defs/ExistingWorkflowReference"},"propertyName":"type"},"oneOf":[{"$ref":"#/$defs/UploadedFileReference"},{"$ref":"#/$defs/RecordedTaskReference"},{"$ref":"#/$defs/ExistingWorkflowReference"},{"$ref":"#/$defs/CredentialReference"},{"$ref":"#/$defs/WorkflowLogicChangeReference"},{"$ref":"#/$defs/InputArtifactReference"}]},"maxItems":50,"title":"Source References","type":"array"},"unresolved_requirements":{"items":{"$ref":"#/$defs/UnresolvedRequirement"},"maxItems":100,"title":"Unresolved Requirements","type":"array"},"draft_artifacts":{"items":{"$ref":"#/$defs/AuthoringArtifactReference"},"maxItems":20,"title":"Draft Artifacts","type":"array"},"accepted_artifacts":{"items":{"$ref":"#/$defs/AcceptedArtifactReference"},"maxItems":20,"title":"Accepted Artifacts","type":"array"},"evidence_artifacts":{"items":{"$ref":"#/$defs/AuthoringEvidenceArtifactReference"},"maxItems":20,"title":"Evidence Artifacts","type":"array"},"handoff":{"anyOf":[{"$ref":"#/$defs/AuthoringHandoff"},{"type":"null"}],"default":null},"error":{"anyOf":[{"$ref":"#/$defs/AuthoringError"},{"type":"null"}],"default":null},"created_at":{"format":"date-time","title":"Created At","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"completed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"default":null,"title":"Completed At"}},"required":["session_id","organization_id","owner_user_id","name","status","resource_version","created_at","updated_at"],"title":"AuthoringSession","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["authoring:submit"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"session_get","description":"Read state and capabilities for Planner, Browser, or queue design sessions. Queue designs also require queue_ui:read.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id"],"title":"session_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"session_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:read"]}],"ui":{"visibility":["model","app"]},"openai/widgetAccessible":true}},{"name":"session_get_events","description":"Replay durable events when the session advertises replay_events=true.\n\nEvents are user-facing progress summaries; events with nothing to show\nare left out, and next_cursor still moves past them. next_cursor is an\nevent cursor, not a state_version: use the returned state_version for\ndecisions. XY STAFF may pass debug=true for the raw detail.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"after":{"default":0,"minimum":0,"title":"After","type":"integer"},"limit":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id"],"title":"session_get_eventsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"session_get_eventsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"session_wait","description":"Wait for a Planner, Browser, or queue design session without losing the cursor.\n\nPrefer until=['blocked', 'done', 'failed', 'cancelled']: the call then\nreturns only when the session needs the user or has stopped (or on\ntimeout), with state, reached, a plain-language summary to relay, the\nevents since after, and next_cursor. If resync is true the cursor did\nnot belong to this session: continue from the returned next_cursor.\nWithout until, it returns on the first new user-facing event (Planner\nbuilds only); events with nothing to show are skipped and next_cursor\nmoves past them. XY STAFF may pass debug=true for raw event detail.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"after":{"minimum":0,"title":"After","type":"integer"},"timeout_seconds":{"default":20,"exclusiveMinimum":0,"title":"Timeout Seconds","type":"integer"},"limit":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"},"until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Until"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id","after"],"title":"session_waitArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"session_waitDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:read"]}],"ui":{"visibility":["model","app"]},"openai/widgetAccessible":true}},{"name":"session_watch","description":"Show the user a live status view of a Planner, Browser, or queue design session.\n\nReturns the current state and a plain-language summary right away. In\napps that display the view, it keeps following the session and posts a\nmessage into the conversation once the session needs the user or has\nstopped. Call it once per session, then keep following with session_wait\nas usual; treat a message from the view like a session_wait result.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id"],"title":"session_watchArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"session_watchDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:read"]}],"ui":{"resourceUri":"ui://xy-platform/session-status.html","visibility":["model"]},"openai/outputTemplate":"ui://xy-platform/session-status.html","openai/widgetAccessible":false}},{"name":"session_live_view","description":"Show the user the live browser of a Planner build or Browser Studio session.\n\nIn apps that display views this renders a live browser view: the browser\nas near-live video where available (else a screenshot every few\nseconds) with the live view's status (step, phase, sign-in request,\nwho is in control, the agent's current action), a button that opens\nthe view-only live browser, and refresh. Elsewhere, relay summary and give the user live_view.url as\na clickable link; never show the token on its own. live_view is null\nwhen no browser is running for the session right now (reason says why).\nThe link expires at live_view.expires_at; call again to refresh it.\nNeeds planner:view for builds and browser:read for Browser Studio\nsessions. Leave stream at its default; the view sets it.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"stream":{"default":true,"title":"Stream","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id"],"title":"session_live_viewArguments","type":"object","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:read"]}],"ui":{"resourceUri":"ui://xy-platform/live-browser.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-platform/live-browser.html","openai/widgetAccessible":true}},{"name":"session_live_screenshot","description":"Take a current screenshot of a build's or Browser Studio session's live browser.\n\nReturns the image (JPEG, at most 1024 px wide) with the session state,\nstep and summary. Live overlay status is provided in widget-only metadata.\nUse it to see what the browser shows right now, or\nwhen the user asks; for watching along use session_live_view. When no\nbrowser is running, it returns no image and the reason. Needs\nplanner:view for builds and browser:read for Browser Studio sessions;\nthe image may show portal data, so describe it only to people allowed\nto see that session. The same frame is available over plain HTTP at\nGET /api/v1/sessions/{target_id}/live-frame.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id"],"title":"session_live_screenshotArguments","type":"object","additionalProperties":false},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:read"]}],"ui":{"visibility":["model","app"]},"openai/widgetAccessible":true}},{"name":"session_review","description":"For the session status view: what a waiting build needs from the user.\n\nReturns the open review (plan, step, or spec questions) in plain words,\nthe current state_version, and which decisions the view may offer. The\ndecisions themselves go through the Planner decision tools.","inputSchema":{"properties":{"target_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id"],"title":"session_reviewArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"session_reviewDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:read"]}],"ui":{"visibility":["app"]},"openai/widgetAccessible":true,"openai/visibility":"private"}},{"name":"session_send","description":"Send feedback to Planner, Browser, or a queue design. Queue designs also require queue_ui:write; follow their events_path for progress.","inputSchema":{"properties":{"target_id":{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","title":"Target Id","type":"string"},"message":{"maxLength":200000,"minLength":1,"title":"Message","type":"string"},"source_session_id":{"anyOf":[{"description":"A build (pbld_), browser (bas_) or queue design (qds_) id.","maxLength":200,"minLength":5,"pattern":"^(?:pbld_|bas_|qds_)[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Source Session Id"},"step_number":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Step Number"},"expected_state_version":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Expected State Version"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["target_id","message"],"title":"session_sendArguments","type":"object","additionalProperties":false},"outputSchema":{"properties":{"result":{"items":{"additionalProperties":true,"type":"object"},"title":"Result","type":"array"}},"required":["result"],"title":"session_sendOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sessions:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_start_build","description":"Start FDE implementation of an actual XY workflow.\n\nThe user describes a business outcome — do not ask them for activity names,\nYAML, entity types, status enums, or internal IDs. Translate their request\ninto the technical build context yourself. Ask only when a missing business\nfact would change behavior, access, or safety.\n\nUse this only for explicit build, modification, or implementation intent,\nincluding an accepted CIE-to-FDE handoff. Do not use it to analyze customer\nmeetings, recordings, discovery, or specifications; those belong to\ninternal_cie_authoring_start or internal_cie_authoring_send.\n\nFor a recording-based build, set ``context.recorded_task_id`` to the\norganization-owned task ID. Credentials remain separate references.\n\nTrack the returned identifiers internally for reconnection after\ndisconnects, but never show them to the user. If the build reports a\ncapacity limit, tell the user the system is temporarily busy and to\ntry again shortly — do not mention model-capacity limits or internal\nerror codes.\n","inputSchema":{"$defs":{"PlannerBuildCreateContext":{"additionalProperties":false,"description":"Structured Planner hints; omit workflow requirements that belong in request.","properties":{"portal_url":{"description":"Portal origin the workflow will access, for example https://portal.example.com.","format":"uri","minLength":1,"title":"Portal Url","type":"string"},"credential_id":{"description":"Active organization Password Vault credential reference; never a secret value.","title":"Credential Id","type":"string"},"credential_domain":{"description":"Credential lookup domain when an exact credential ID is not supplied.","title":"Credential Domain","type":"string"},"recorded_task_id":{"description":"Organization-owned Browser Agent recording ID used as workflow-build context.","title":"Recorded Task Id","type":"string"},"inputs":{"description":"Optional structured workflow input hints.","items":{"additionalProperties":true,"type":"object"},"title":"Inputs","type":"array"},"outputs":{"description":"Optional structured workflow output hints.","items":{"additionalProperties":true,"type":"object"},"title":"Outputs","type":"array"},"workflow":{"$ref":"#/$defs/PlannerWorkflowReference","description":"Name an existing workflow to change it instead of building a new one.","title":"Workflow"},"workflow_files":{"description":"Upload bundle IDs whose data files the workflow reads at run time.","items":{"type":"string"},"title":"Workflow Files","type":"array"}},"title":"PlannerBuildCreateContext","type":"object"},"PlannerWorkflowReference":{"additionalProperties":false,"description":"An existing workflow this build should CHANGE rather than replace.","properties":{"id":{"description":"Workflow definition identifier. Takes precedence over `name`.","title":"Id","type":"string"},"name":{"description":"Exact workflow name, matched case-insensitively within the organization.","title":"Name","type":"string"}},"title":"PlannerWorkflowReference","type":"object"}},"properties":{"request":{"title":"Request","type":"string"},"idempotency_key":{"maxLength":200,"minLength":1,"title":"Idempotency Key","type":"string"},"context":{"anyOf":[{"$ref":"#/$defs/PlannerBuildCreateContext"},{"type":"null"}],"default":null},"existing_yaml":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Existing Yaml"},"modification_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Modification Instructions"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["request","idempotency_key"],"title":"planner_start_buildArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_start_buildDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_list_builds","description":"List workflow builds for this organization. Present results as a\nsimple list of workflows being built, with their current stage. Keep\nbuild IDs and cursors internal.","inputSchema":{"properties":{"limit":{"default":50,"exclusiveMinimum":0,"title":"Limit","type":"integer"},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Cursor"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Status"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"title":"planner_list_buildsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_list_buildsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_get_build","description":"Check the current status of a workflow build. Summarize for the user\nas 'designing...', 'testing...', 'ready to publish', etc. Keep internal\nfields like state_version and step statuses out of the user's view.\n\nReturns the open gate, state_version (pass it to the next decision),\nwho started the build (requested_by), and each step's number, name,\nstatus, a bounded result_preview of its test output and an\nerror_summary when it failed. Generated step code is never returned.\nXY STAFF may pass debug=true for the full Planner state, with step code\nreduced to its size.\n\nFor a known Workflow Request attempt, first read\nworkflow_request_attempt_get for its exact review link and pinned spec;\nuse this slim step list in that attempt's default plan review.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id"],"title":"planner_get_buildArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_get_buildDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_get_events","description":"Read build progress events. Summarize in plain language for the user;\nkeep cursors and event names internal. Events are user-facing progress\nsummaries unless XY STAFF pass debug=true: a step result carries a\nbounded result_preview, a failure its error_summary, and the planner's\nsummary of a step test follows as progress kind 'finding'. Events with\nnothing to show are left out; next_cursor still moves past them.\nnext_cursor is an event cursor, not a state_version: pass the returned\nstate_version to decisions.\n\nMANDATORY: If the response includes a 'browser_live_view' field or\n'_user_facing_message' field, you MUST copy the full VNC URL into your\nreply as a clickable link. Never paraphrase it as 'the provided link'\n— always print the complete URL so the user can open it.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"after":{"default":0,"minimum":0,"title":"After","type":"integer"},"limit":{"default":100,"exclusiveMinimum":0,"title":"Limit","type":"integer"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id"],"title":"planner_get_eventsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_get_eventsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_wait_for_events","description":"Wait for progress on the current build and summarize what changed.\n\nSafe after disconnect or restart. Preserve the returned cursor internally.\nSummarize progress in plain language: 'designing your workflow...', 'testing\nstep 1...', 'all steps passed'. Never show raw event names, statuses,\ncursors, state versions, or identifiers to the user. Returns once there\nis something to show (or on timeout); next_cursor is an event cursor,\nnot a state_version.\n\nMANDATORY: If the response includes a 'browser_live_view' field or\n'_user_facing_message' field, you MUST copy the full VNC URL into\nyour reply. Print the complete URL as a clickable link — never\nsay 'the provided link' or omit it. The user needs the exact URL\nto open in their browser. Do this the FIRST time you see it.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"after":{"minimum":0,"title":"After","type":"integer"},"timeout_seconds":{"default":20,"exclusiveMinimum":0,"title":"Timeout Seconds","type":"integer"},"limit":{"default":100,"exclusiveMinimum":0,"title":"Limit","type":"integer"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","after"],"title":"planner_wait_for_eventsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_wait_for_eventsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_respond_to_plan","description":"Accept or request changes to the generated workflow plan.\n\naction APPROVE accepts the plan and starts building each step.\naction REJECT with a comment requests changes; the comment says what\nto revise. Only decide when the user has (never auto-approve). A gate\nalready decided elsewhere, such as in the XY app, is refused with\nBUILD_CONFLICT or a later PLANNER_REQUEST_REFUSED event: read the\nbuild and its recent events before retrying. Tell the user 'the plan looks good,\nstarting to build it' or 'requesting changes to the plan' — never\nmention APPROVE/REJECT, state versions, or durable commands.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"action":{"enum":["APPROVE","REJECT"],"title":"Action","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"comment":{"anyOf":[{"maxLength":20000,"pattern":"\\S","type":"string"},{"type":"null"}],"default":null,"title":"Comment"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","action","state_version"],"title":"planner_respond_to_planArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_respond_to_planDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model","app"]},"openai/widgetAccessible":true}},{"name":"planner_answer_spec","description":"Answer the planner's questions about the uploaded process documents.\n\nUse when planner_get_build reports gate 'spec'. The answer lets the\nplanner finish the workflow spec and continue to the plan. Tell the user\n'sending your answers to the planner' — never mention state versions or\ndurable commands.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"answer":{"maxLength":20000,"pattern":"\\S","title":"Answer","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","answer","state_version"],"title":"planner_answer_specArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_answer_specDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_accept_step","description":"Confirm a step looks good, with optional edits. Tell the user\n'step N confirmed' in plain language. Never expose action names or\nstate versions.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"edited_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Edited Code"},"edited_yaml_params":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Edited Yaml Params"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","state_version"],"title":"planner_accept_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_accept_stepDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model","app"]},"openai/widgetAccessible":true}},{"name":"planner_reject_step","description":"Request changes to a step with a description of what to fix.\nThis also reopens a step that was already accepted, e.g. when a later\nstep is blocked by it; later steps keep their code but are re-tested.\nTell the user 'requesting changes to this step'. Never expose\naction names or internal statuses.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"comment":{"title":"Comment","type":"string"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","state_version","comment"],"title":"planner_reject_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_reject_stepDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model","app"]},"openai/widgetAccessible":true}},{"name":"planner_test_step","description":"Run a step's test again, with or without edits. Send edits to\ntest a change before confirming it, or neither to re-test the saved step\nas it is, e.g. before publishing. The step then waits for a decision\nagain, even if it was accepted. Tell the user 'testing your changes' or\n're-testing this step'. Keep technical details internal.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"edited_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Edited Code"},"edited_yaml_params":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Edited Yaml Params"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","state_version"],"title":"planner_test_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_test_stepDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_retry_step","description":"Retry a step that needs another attempt. Tell the user\n'retrying this step'. Keep internal details hidden.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","state_version"],"title":"planner_retry_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_retry_stepDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_message_step","description":"Send feedback about a step without confirming or rejecting it.\nFeedback on a step that was already accepted reopens it for changes.\nUse plain language when relaying the feedback status to the user.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"comment":{"title":"Comment","type":"string"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"wait_until":{"anyOf":[{"description":"Return as soon as the session is in one of these states. ['blocked', 'done', 'failed', 'cancelled'] waits until it needs the user or has stopped.","items":{"enum":["queued","working","blocked","done","failed","cancelled","idle","unknown"],"type":"string"},"maxItems":8,"minItems":1,"type":"array"},{"type":"null"}],"default":null,"title":"Wait Until"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","state_version","comment"],"title":"planner_message_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_message_stepDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_resume","description":"Resume a workflow build that was interrupted. Tell the user\n'resuming where we left off'. Keep internal state hidden.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","state_version"],"title":"planner_resumeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_resumeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_promote","description":"Publish a completed workflow so it appears in XY Flows and can be run.\n\nIMPORTANT — always pass 'name': a short, descriptive title for the\nworkflow (2-6 words, Title Case). Examples: 'HN Top Stories Review',\n'Daily Weather Dashboard', 'Bug Triage Queue'. This is what the user\nsees as the workflow title. NEVER use the user's full prompt as the\nname — summarize the workflow's purpose in a few words.\n\nAfter publishing, tell the user in plain language:\n1. Their workflow is published and ready to run.\n2. They can open the Queues tab to view its queue.\n3. They can click 'Run workflow' to generate data for that queue.\n4. If the original request mentioned timing (daily, weekly, every morning),\n   offer to set up a recurring schedule.\n\nDo NOT auto-run the workflow — the user controls when it runs.\nThe published queue receives data when the user runs the workflow.\n\nNever mention tool names, build IDs, or definition IDs to the user.\nSay 'your workflow is published' not 'promoted to production definition'.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","state_version"],"title":"planner_promoteArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_promoteDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:promote"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_abandon","description":"Cancel and discard a workflow build permanently. Tell the user\nthe build has been cancelled. Never expose build IDs.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","state_version"],"title":"planner_abandonArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_abandonDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_cancel_step","description":"Synchronously cancel a running test; repeating this is safe.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number"],"title":"planner_cancel_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_cancel_stepDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_assist_step","description":"Ask Build Copilot for a proposed edit without mutating the build.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"prompt":{"title":"Prompt","type":"string"},"current_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Code"},"current_yaml":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Current Yaml"},"editor_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Editor Session Id"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","prompt"],"title":"planner_assist_stepArguments","type":"object","additionalProperties":false},"outputSchema":{"properties":{"result":{"items":{"additionalProperties":true,"type":"object"},"title":"Result","type":"array"}},"required":["result"],"title":"planner_assist_stepOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_save_template","description":"Save a completed build as an organization workflow template.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Category"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id"],"title":"planner_save_templateArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_save_templateDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:promote"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_export_build","description":"Export a redacted Planner journey fixture for debugging or re-seeding.","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id"],"title":"planner_export_buildArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_export_buildDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:export"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_get_browser_session","description":"Get the build's live browser links while a browser step runs.\n\nReturns vnc_control_url (the build's control link) and vnc_url (the\nbuild's watch link). Both stay the same for the whole build and follow\neach browser step. Give the person running the build one link: their\nvnc_control_url when it is present (it watches too, and they press Take\ncontrol on the page when they need to act), otherwise vnc_url. Share\nvnc_url only when they ask to show the browser to someone else. Do not\nshow raw tokens or URL parameters.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number"],"title":"planner_get_browser_sessionArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_get_browser_sessionDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:view"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_set_browser_control","description":"Pause ('human') or resume ('shared') the build's own browser actions.\n\nUse only when the user explicitly asks to pause or resume the automation.\nNever use it to hand the browser to a person: they press Take control on\ntheir live view page, which pauses the build and resumes it when they give\ncontrol back. Setting 'human' with nobody in control stalls the build.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"mode":{"enum":["human","shared"],"title":"Mode","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number","mode"],"title":"planner_set_browser_controlArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_set_browser_controlDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["planner:control"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_list_tools","description":"List safe Browser Studio authoring commands.","inputSchema":{"properties":{"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"title":"browser_list_toolsArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_list_toolsDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_recorded_tasks_list","description":"Find browser recordings for an FDE implementation build.\n\nSearch by the name a person sees, recorded-task ID, or domain. Pass the exact\nrecorded_task_id from one unambiguous match to planner_start_build as\ncontext.recorded_task_id. Ask the user when zero or multiple entries match;\nnever guess. The response never contains code, transcripts, screenshots,\nrecordings, secrets, owner IDs, or Firestore document IDs.\n\nDo not use this for CIE meeting evidence or artifact work. CIE reads\norganization-scoped recordings with internal_recorded_tasks_* and attaches\nthem to internal_cie_authoring_start or internal_cie_authoring_send.\n","inputSchema":{"properties":{"query":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"title":"Query"},"limit":{"default":50,"maximum":200,"minimum":1,"title":"Limit","type":"integer"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"title":"browser_recorded_tasks_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_recorded_tasks_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_create_session","description":"Start a Browser Studio session for one step of a Planner build.\n\nbuild_id and step_number are required: Browser Studio and Browser\nCopilot work only inside an existing Planner build (start one with\nplanner_start_build); there is no standalone session. Returns vnc_url, the user's live view of the build: the same link for\nevery session and browser step of this build, so show it once\n('Watch the browser live: <url>') and do not hand out a new link per\ncommand. When can_control is true the page has a Take control button\nthe user presses themselves; share watch_url only if they ask to show\nthe browser to someone else. Pass the returned session_id as browser_id\nto the other browser tools.\n","inputSchema":{"properties":{"build_id":{"maxLength":200,"minLength":6,"pattern":"^pbld_[A-Za-z0-9_-]+$","title":"Build Id","type":"string"},"step_number":{"exclusiveMinimum":0,"title":"Step Number","type":"integer"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"},"credential_id":{"anyOf":[{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Credential Id"},"recorded_task_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Recorded Task Id"},"existing_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Existing Code"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["build_id","step_number"],"title":"browser_create_sessionArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_create_sessionDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_get_session","description":"Read session state, including the build's live view link (vnc_url).\n\nThe link is the same one the user already has for this build; show it\nagain only if they have not seen it or it changed after expiring.\n","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_get_sessionArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_get_sessionDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_run_command","description":"Run one safe Browser Studio command in a retained session.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"tool":{"title":"Tool","type":"string"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Input"},"tab_id":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Tab Id"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id","tool"],"title":"browser_run_commandArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_run_commandDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_endpoint_observer_set","description":"Start or stop capturing API requests made by this browser session.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"enabled":{"default":true,"title":"Enabled","type":"boolean"},"tab_id":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Tab Id"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_endpoint_observer_setArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_endpoint_observer_setDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_observed_endpoints_list","description":"List a compact, redacted index of API requests captured in this session.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"url_contains":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url Contains"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Method"},"status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Status Code"},"start_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Start Time"},"end_time":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"End Time"},"limit":{"default":25,"maximum":25,"minimum":1,"title":"Limit","type":"integer"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_observed_endpoints_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_observed_endpoints_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_observed_endpoint_get","description":"Read one captured request and response after secret-field redaction.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"storage_path":{"maxLength":200,"minLength":35,"pattern":"^local://observed-endpoint/ep_[A-Za-z0-9_-]+$","title":"Storage Path","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id","storage_path"],"title":"browser_observed_endpoint_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_observed_endpoint_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_api_map_build","description":"Build or update this organization's OpenAPI-style map from captured calls.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Host"},"url_contains":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Url Contains"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Method"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_api_map_buildArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_api_map_buildDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_api_map_get","description":"Read this organization's saved endpoint map as a tree, OpenAPI, or both.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Host"},"format":{"default":"both","enum":["tree","openapi","both"],"title":"Format","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_api_map_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_api_map_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_set_control","description":"Switch a browser session between human and shared control.\n\nThe user takes control themselves with the Take control button on the\nlive view page; do not call this to hand them control.\n","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"mode":{"enum":["human","shared"],"title":"Mode","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id","mode"],"title":"browser_set_controlArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_set_controlDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:control"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_prompt","description":"Ask Browser Studio to author or revise reusable browser activity code.\n\nReturns the turn's outcome once it finishes: status, final_message (the\nCopilot's answer), draft {changed, lines, summary}, tool_calls and\nusage_total. Read the code itself with browser_get_draft. XY STAFF may\npass debug=true to also get the raw event stream.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"prompt":{"title":"Prompt","type":"string"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id","prompt"],"title":"browser_promptArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_promptDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_cancel_prompt","description":"Cancel the current Browser Copilot authoring turn.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_cancel_promptArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_cancel_promptDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_cdp_command","description":"Run raw page-target CDP; it may expose cookies or page secrets.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"method":{"title":"Method","type":"string"},"params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Params"},"tab_id":{"anyOf":[{"exclusiveMinimum":0,"type":"integer"},{"type":"null"}],"default":null,"title":"Tab Id"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id","method"],"title":"browser_cdp_commandArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_cdp_commandDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:debug"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_get_draft","description":"Read the reusable browser activity draft from a retained session.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_get_draftArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_get_draftDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_apply_draft","description":"Send the Browser Studio draft through the existing Planner step test path.\n\nReturns the step test's outcome: status (passed, failed or incomplete),\nstep_number, final_message, result_preview of the test output,\nerror_summary when it failed, and draft {changed, summary, lines}. XY\nSTAFF may pass debug=true to also get the raw event stream.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"edited_code":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Edited Code"},"debug":{"default":false,"description":"XY STAFF only. Include sanitized trace detail (logs, token counts, tool timings). Off by default: events are user-facing progress summaries. Never relay debug detail to a customer.","title":"Debug","type":"boolean"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_apply_draftArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_apply_draftDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write","planner:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"browser_close_session","description":"Close a retained browser session and release its capacity allocation.","inputSchema":{"properties":{"browser_id":{"description":"The browser's id (starts with bas_), returned by browser_create_session.","maxLength":128,"minLength":5,"pattern":"^bas_[A-Za-z0-9_-]+$","title":"Browser Id","type":"string"},"organization_id":{"anyOf":[{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"description":"Optional organization ID, slug, or exact name where you are STAFF. Omit to use the credential's own organization."},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["browser_id"],"title":"browser_close_sessionArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"browser_close_sessionDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["browser:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_get","description":"Read one live integration and its current executable capabilities.","inputSchema":{"properties":{"type_key":{"maxLength":80,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$","title":"Type Key","type":"string"}},"required":["type_key"],"title":"integration_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_create","description":"Start discovery for a NEW organization-only integration.\n\nThis is the first step when XY has no connector for an API yet; use\nintegration_factory_extend only to add capabilities to an integration\nthis organization already promoted. Provide exactly one documentation\nsource: a public HTTPS documentation_url, pasted documentation, or an\nupload_id from integration_factory_upload_prepare and\nintegration_factory_upload_complete. key is a lowercase kebab-case\nidentifier. api_key_header is only valid for API_KEY authentication\nand carries no secret; store the key with credentials_create.\n\nReturns a run_id and state_version; follow the run with\nintegration_factory_run_get until it is awaiting_generation. Repeating\nthe call with the same arguments (or the same idempotency_key) within\n24 hours returns the same run; pass a new idempotency_key to start a\ndeliberate fresh run with identical arguments.\n\nFactory stages reserve model capacity after the durable run is queued.\nIf the run reports MODEL_CAPACITY_EXCEEDED, do not retry it\nautomatically; ask an XY staff member to increase the organization's\nmodel-capacity limit before submitting more work.\n","inputSchema":{"properties":{"api_name":{"maxLength":120,"minLength":1,"title":"Api Name","type":"string"},"key":{"maxLength":80,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$","title":"Key","type":"string"},"auth_type":{"enum":["NONE","API_KEY","BASIC_AUTH","BEARER_TOKEN","CLIENT_CREDENTIALS"],"title":"Auth Type","type":"string"},"documentation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Documentation Url"},"documentation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Documentation"},"upload_id":{"anyOf":[{"maxLength":128,"minLength":8,"pattern":"^ifupl_[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Upload Id"},"api_key_header":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Api Key Header"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Category"},"base_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base Url"},"base_path":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base Path"},"custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Custom Instructions"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["api_name","key","auth_type"],"title":"integration_factory_createArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_createDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_upload_prepare","description":"Reserve a private API-documentation upload for the Integration Factory.\n\nNever send file bytes through this tool. PUT the file to the returned\nupload.url with every returned header, then call\nintegration_factory_upload_complete, and pass the upload id as\nupload_id to integration_factory_create or integration_factory_extend.\nThe reservation expires after about 20 minutes and is limited to\nmax_bytes. Supported types are PDF, JSON, YAML, DOCX, Markdown and\nplain text, and the file extension must match content_type.\n","inputSchema":{"properties":{"file_name":{"maxLength":200,"minLength":1,"title":"File Name","type":"string"},"content_type":{"maxLength":200,"minLength":1,"title":"Content Type","type":"string"}},"required":["file_name","content_type"],"title":"integration_factory_upload_prepareArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_upload_prepareDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_upload_complete","description":"Verify an uploaded documentation file so discovery can use it.","inputSchema":{"properties":{"upload_id":{"maxLength":128,"minLength":8,"pattern":"^ifupl_[A-Za-z0-9_-]+$","title":"Upload Id","type":"string"}},"required":["upload_id"],"title":"integration_factory_upload_completeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_upload_completeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_extend","description":"Discover capabilities to add to an org-owned factory integration.\n\nFactory stages reserve model capacity after the durable run is queued.\nIf the run reports MODEL_CAPACITY_EXCEEDED, do not retry it\nautomatically; ask an XY staff member to increase the organization's\nmodel-capacity limit before submitting more work.\n","inputSchema":{"properties":{"type_key":{"maxLength":80,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$","title":"Type Key","type":"string"},"documentation_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Documentation Url"},"documentation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Documentation"},"upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Upload Id"},"custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Custom Instructions"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["type_key"],"title":"integration_factory_extendArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_extendDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_run_get","description":"Read discovery, generation, validation, or promotion state for a run.","inputSchema":{"properties":{"run_id":{"maxLength":128,"minLength":8,"pattern":"^ifrun_[A-Za-z0-9_-]+$","title":"Run Id","type":"string"}},"required":["run_id"],"title":"integration_factory_run_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_run_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_generate","description":"Generate selected discovered endpoints into a new integration draft.","inputSchema":{"properties":{"run_id":{"maxLength":128,"minLength":8,"pattern":"^ifrun_[A-Za-z0-9_-]+$","title":"Run Id","type":"string"},"endpoints":{"items":{"type":"string"},"maxItems":20,"minItems":1,"title":"Endpoints","type":"array"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"base_path":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Base Path"},"auth_type":{"anyOf":[{"enum":["NONE","API_KEY","BASIC_AUTH","BEARER_TOKEN","CLIENT_CREDENTIALS"],"type":"string"},{"type":"null"}],"default":null,"title":"Auth Type"}},"required":["run_id","endpoints","state_version"],"title":"integration_factory_generateArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_generateDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_validate","description":"Validate a generated draft with an org-owned encrypted credential.","inputSchema":{"properties":{"run_id":{"maxLength":128,"minLength":8,"pattern":"^ifrun_[A-Za-z0-9_-]+$","title":"Run Id","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"credential_id":{"anyOf":[{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Credential Id"}},"required":["run_id","state_version"],"title":"integration_factory_validateArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_validateDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_test_capability","description":"Durably test one generated capability before organization promotion.\n\nSet confirm_side_effects=true only after accepting that the upstream\nAPI call may create, update, trigger, or delete real external data.\n","inputSchema":{"properties":{"run_id":{"maxLength":128,"minLength":8,"pattern":"^ifrun_[A-Za-z0-9_-]+$","title":"Run Id","type":"string"},"capability_key":{"title":"Capability Key","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"},"params":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"default":null,"title":"Params"},"credential_id":{"anyOf":[{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","type":"string"},{"type":"null"}],"default":null,"title":"Credential Id"},"confirm_side_effects":{"default":false,"title":"Confirm Side Effects","type":"boolean"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Idempotency Key"}},"required":["run_id","capability_key","state_version"],"title":"integration_factory_test_capabilityArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_test_capabilityDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:generate"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_capability_test_get","description":"Read one durable generated-capability test and its redacted result.","inputSchema":{"properties":{"run_id":{"maxLength":128,"minLength":8,"pattern":"^ifrun_[A-Za-z0-9_-]+$","title":"Run Id","type":"string"},"test_id":{"title":"Test Id","type":"string"}},"required":["run_id","test_id"],"title":"integration_factory_capability_test_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_capability_test_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"integration_factory_promote","description":"Make a validated, explicitly tested draft live only for this organization.","inputSchema":{"properties":{"run_id":{"maxLength":128,"minLength":8,"pattern":"^ifrun_[A-Za-z0-9_-]+$","title":"Run Id","type":"string"},"state_version":{"exclusiveMinimum":0,"title":"State Version","type":"integer"}},"required":["run_id","state_version"],"title":"integration_factory_promoteArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"integration_factory_promoteDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["integrations:promote"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"credentials_list","description":"List visible Password Vault references without secrets.\n\nEveryone in the organization sees site_name, domain, and credential_type.\nPrivate metadata, including username, is visible only to STAFF or the creator.\nMatch on the visible fields, then pass the exact credential_id to Planner. Integration Factory still requires an API-managed reference\ncreated through credentials_create. Ask the user when zero or multiple\nentries match; never guess a credential.\n\nTo discover a customer org's references, pass its exact ID, slug, or name.\nExplicit org lookup requires current STAFF membership and\ninternal_credentials:read on the key and the target org grant. It returns\nonly reference IDs, site names, domains, types, and active status. Omitting\norganization_id keeps the existing home-org metadata lookup. Create and\nedit human credentials through Password Vault; never request secrets in chat.\n","inputSchema":{"properties":{"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"title":"credentials_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"credentials_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["credentials:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"credentials_get","description":"Read a Password Vault reference without secrets.\n\nOther users receive only its site name, domain, type, active state, and ID.\nSTAFF and the creator also receive private metadata. Organization boundaries\nstill apply; listing an entry does not grant access to its secrets.\n\nPass an exact org ID, slug, or name for STAFF reference-only lookup, with\ninternal_credentials:read on the key and the target org grant. The selected\ncredential must belong to that org. Omit organization_id for home-org\nmetadata. This tool never grants credential use or write permission.\n","inputSchema":{"properties":{"credential_id":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Credential Id","type":"string"},"organization_id":{"anyOf":[{"description":"Exact organization ID, slug, or name. Omit to use the organization where this credential was created.","maxLength":200,"minLength":1,"pattern":"^[^\\\\?#]+$","type":"string"},{"type":"null"}],"default":null,"title":"Organization Id"}},"required":["credential_id"],"title":"credentials_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"credentials_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["credentials:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"credentials_create","description":"Create a secure credential reference without echoing secrets.\n\nIt is created in this key's organization. For a Workflow Request's portal\nlogin, send the person workflow_request_get's credential_url instead.\n","inputSchema":{"properties":{"domain":{"title":"Domain","type":"string"},"site_name":{"title":"Site Name","type":"string"},"username":{"title":"Username","type":"string"},"password":{"title":"Password","type":"string"},"login_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Login Url"},"totp":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Totp"},"pin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Pin"},"sms_phone_type":{"default":"voip","enum":["voip","real_sim"],"title":"Sms Phone Type","type":"string"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"}},"required":["domain","site_name","username","password"],"title":"credentials_createArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"credentials_createDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["credentials:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"credentials_rotate","description":"Replace a stored secret and revoke sessions using the old version.","inputSchema":{"properties":{"credential_id":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Credential Id","type":"string"},"password":{"title":"Password","type":"string"},"site_name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Site Name"},"username":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Username"},"login_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Login Url"},"totp":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Totp"},"pin":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Pin"},"sms_phone_type":{"anyOf":[{"enum":["voip","real_sim"],"type":"string"},{"type":"null"}],"default":null,"title":"Sms Phone Type"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"}},"required":["credential_id","password"],"title":"credentials_rotateArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"credentials_rotateDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["credentials:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"credentials_revoke","description":"Revoke a credential, delete its vault secret, and invalidate sessions.","inputSchema":{"properties":{"credential_id":{"maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Credential Id","type":"string"}},"required":["credential_id"],"title":"credentials_revokeArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"credentials_revokeDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["credentials:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"sms_inbox_provision","description":"Provision or retrieve this organization's dedicated VoIP SMS number.","inputSchema":{"properties":{"country_code":{"const":"US","default":"US","title":"Country Code","type":"string"},"area_code":{"anyOf":[{"pattern":"^[0-9]{3}$","type":"string"},{"type":"null"}],"default":null,"title":"Area Code"}},"title":"sms_inbox_provisionArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"sms_inbox_provisionDictOutput","type":"object"},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":true},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["credentials:write"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"sms_inbox_messages","description":"Read messages received by this organization's dedicated VoIP inbox.","inputSchema":{"properties":{"after_ms":{"default":0,"minimum":0,"title":"After Ms","type":"integer"},"limit":{"default":20,"maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"sms_inbox_messagesArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"sms_inbox_messagesDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["sms:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"organization_log_summary","description":"Summarize this organization's own log records over a time range.\n\nReturns counts by severity, the most frequent exception types and span\nnames, a time histogram, and a bounded sample — not every line. Raw log\nlines are deliberately not exposed here: a full page is thousands of\nrecords, which is far more than is useful to read into a conversation.\nUse the REST endpoint when the individual records are genuinely needed.\n\n`start` and `end` are absolute UTC timestamps; omitting them reads the\nlast ten minutes. `min_level` is one of info, warn, error.\n","inputSchema":{"properties":{"start":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Start"},"end":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"End"},"min_level":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Min Level"},"q":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Q"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Run Id"}},"title":"organization_log_summaryArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"organization_log_summaryDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["logs:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"planner_usage","description":"Read this organization's Planner, browser, and model-cost quota usage.","inputSchema":{"properties":{},"title":"planner_usageArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"planner_usageDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["usage:read"]}],"ui":{"visibility":["model"]},"openai/widgetAccessible":false}},{"name":"operations_connection_get","description":"Read the linked credential's environment, actor, home organization and granted scopes; no secrets.\n\nVerify home_organization_name is the organization the user means before any\ncall that omits organization_id. server gives the deployed build\n{version, git_sha}; plugin gives the current XY plugin release\n{version, released}: when the installed skills carry an older version,\ntell the user to reinstall the plugin.\n","inputSchema":{"properties":{},"title":"operations_connection_getArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"operations_connection_getDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":[]}],"ui":{"resourceUri":"ui://xy-operations/run-status.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-operations/run-status.html","openai/widgetAccessible":true}},{"name":"operations_executions_list","description":"List permitted catalog-agent run IDs and statuses, excluding payloads and partner references.","inputSchema":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Status"},"limit":{"default":25,"maximum":100,"minimum":1,"title":"Limit","type":"integer"},"offset":{"default":0,"minimum":0,"title":"Offset","type":"integer"}},"title":"operations_executions_listArguments","type":"object","additionalProperties":false},"outputSchema":{"additionalProperties":true,"title":"operations_executions_listDictOutput","type":"object"},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"_meta":{"securitySchemes":[{"type":"oauth2","scopes":["executions:read"]}],"ui":{"resourceUri":"ui://xy-operations/run-status.html","visibility":["model","app"]},"openai/outputTemplate":"ui://xy-operations/run-status.html","openai/widgetAccessible":true}}]}