{ "openapi": "3.0.3", "info": { "title": "Automata Labs Agent Services", "version": "1.0.0", "description": "Reference execution with separate workspace authorization. All production capabilities require approval. Legacy catalog keys are not workspace identity." }, "servers": [ { "url": "http://127.0.0.1:4321", "description": "Local reference development" } ], "security": [ { "ServiceKey": [] }, { "AccountSession": [] } ], "paths": { "/api/v1/services": { "get": { "operationId": "listServices", "security": [], "responses": { "200": { "description": "Read-only catalog, never registers or executes" } } }, "head": { "operationId": "headServices", "security": [], "responses": { "200": { "description": "Catalog metadata" } } } }, "/api/v1/jobs": { "get": { "operationId": "listJobs", "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } }, "parameters": [ { "in": "query", "name": "limit", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "in": "query", "name": "cursor", "schema": { "type": "string", "maxLength": 4096 }, "description": "Opaque, authority-bound seek cursor; expires after 15 minutes or server restart." } ] }, "post": { "operationId": "submitJob", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobRequest" } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/auth/development": { "post": { "operationId": "post_auth_development", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "synthetic_only": { "type": "boolean", "enum": [ true ] } }, "required": [ "synthetic_only" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/auth/logout": { "post": { "operationId": "post_auth_logout", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/workspaces": { "get": { "operationId": "get_workspaces", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_workspaces", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "name" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/workspaces/{workspace_id}": { "get": { "operationId": "get_workspaces_workspace_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "workspace_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "patch": { "operationId": "patch_workspaces_workspace_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "workspace_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "retention_hours": { "type": "integer", "minimum": 1, "maximum": 24 } }, "required": [ "name", "retention_hours" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/workspaces/{workspace_id}/members": { "get": { "operationId": "get_workspaces_workspace_id_members", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "workspace_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_workspaces_workspace_id_members", "description": "Unavailable until separately approved provider configuration.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "workspace_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "responses": { "503": { "description": "Provider unavailable; no external effect" } } }, "patch": { "operationId": "patch_workspaces_workspace_id_members", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "workspace_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "account_id": { "type": "string", "maxLength": 100 }, "role": { "type": "string", "enum": [ "admin", "developer", "reviewer", "billing", "viewer" ] } }, "required": [ "account_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "delete": { "operationId": "delete_workspaces_workspace_id_members", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "workspace_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "account_id": { "type": "string", "maxLength": 100 }, "role": { "type": "string", "enum": [ "admin", "developer", "reviewer", "billing", "viewer" ] } }, "required": [ "account_id" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/projects": { "get": { "operationId": "get_projects", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_projects", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "allowed_services": { "type": "array", "items": { "type": "string", "enum": [ "S01", "S02", "S03", "S04", "S05", "S06", "S07", "S08", "S09", "S10", "S11", "S12", "S13" ] }, "minItems": 1, "maxItems": 13 }, "budget_units": { "type": "integer", "minimum": 1, "maximum": 1000000 } }, "required": [ "name", "allowed_services", "budget_units" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/projects/{project_id}": { "get": { "operationId": "get_projects_project_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "project_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "patch": { "operationId": "patch_projects_project_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "project_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100 }, "allowed_services": { "type": "array", "items": { "type": "string", "enum": [ "S01", "S02", "S03", "S04", "S05", "S06", "S07", "S08", "S09", "S10", "S11", "S12", "S13" ] }, "minItems": 1, "maxItems": 13 }, "budget_units": { "type": "integer", "minimum": 1, "maximum": 1000000 } }, "required": [ "name", "allowed_services", "budget_units" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/keys": { "get": { "operationId": "get_keys", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_keys", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "scopes": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 }, "minItems": 1, "maxItems": 100 }, "expires_days": { "type": "integer", "minimum": 1, "maximum": 30 } }, "required": [ "scopes", "expires_days" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/keys/{key_id}/revoke": { "post": { "operationId": "post_keys_key_id_revoke", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "key_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/uploads": { "post": { "operationId": "post_uploads", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "filename": { "type": "string", "minLength": 1, "maxLength": 120, "pattern": "^[^\\\\/\\x00-\\x1f:]+$" }, "media_type": { "type": "string", "enum": [ "text/csv", "application/json", "application/pdf", "image/jpeg", "image/png", "image/webp" ] }, "bytes": { "type": "integer", "minimum": 1, "maximum": 52428800 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "filename", "media_type", "bytes", "sha256" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/uploads/{upload_id}": { "get": { "operationId": "get_uploads_upload_id", "description": "Authenticated private attachment; never a public storage URL.", "parameters": [ { "in": "path", "name": "upload_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "put": { "operationId": "put_uploads_upload_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "upload_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "delete": { "operationId": "delete_uploads_upload_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "upload_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/uploads/{upload_id}/finalize": { "post": { "operationId": "post_uploads_upload_id_finalize", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "upload_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/jobs/{job_id}": { "get": { "operationId": "get_jobs_job_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "job_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/jobs/{job_id}/events": { "get": { "operationId": "get_jobs_job_id_events", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "job_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/jobs/{job_id}/cancel": { "post": { "operationId": "post_jobs_job_id_cancel", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "job_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/artifacts/{artifact_id}": { "get": { "operationId": "get_artifacts_artifact_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "artifact_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "delete": { "operationId": "delete_artifacts_artifact_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "artifact_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/artifacts/{artifact_id}/download": { "get": { "operationId": "get_artifacts_artifact_id_download", "description": "Authenticated private attachment; never a public storage URL.", "parameters": [ { "in": "path", "name": "artifact_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/approvals": { "get": { "operationId": "get_approvals", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/approvals/{approval_id}": { "get": { "operationId": "get_approvals_approval_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "approval_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/approvals/{approval_id}/decision": { "post": { "operationId": "post_approvals_approval_id_decision", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "approval_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "decision": { "type": "string", "enum": [ "approve", "reject" ] }, "action_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "confirm": { "type": "boolean", "enum": [ true ] } }, "required": [ "decision", "action_digest", "confirm" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/reviews": { "post": { "operationId": "post_reviews", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "finding_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "finding_version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "decision": { "type": "string", "enum": [ "accept", "reject" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "job_id", "finding_id", "finding_version", "decision", "reason" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/usage": { "get": { "operationId": "get_usage", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/budgets": { "get": { "operationId": "get_budgets", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "patch": { "operationId": "patch_budgets", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "budget_units": { "type": "integer", "minimum": 0, "maximum": 1000000 }, "scope": { "type": "string", "enum": [ "project", "workspace", "key" ], "default": "project" }, "key_id": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "budget_units" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/billing/receipts": { "post": { "operationId": "post_billing_receipts", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "units": { "type": "integer", "minimum": 1, "maximum": 1000000 }, "simulation": { "type": "boolean", "enum": [ true ] } }, "required": [ "units", "simulation" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/provider-hooks/reference-payment": { "post": { "operationId": "post_provider-hooks_reference-payment", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [], "parameters": [ { "in": "header", "name": "X-Reference-Signature", "required": true, "schema": { "type": "string" }, "description": "Raw-body HMAC with timestamp and replay verification. Synthetic provider only." } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/provider-hooks/local-mail": { "post": { "operationId": "post_provider-hooks_local-mail", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [], "parameters": [ { "in": "header", "name": "X-Reference-Signature", "required": true, "schema": { "type": "string" }, "description": "Raw-body HMAC with timestamp and replay verification. Synthetic provider only." } ], "requestBody": { "required": true, "content": { "application/octet-stream": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/inboxes/{resource_id}": { "get": { "operationId": "get_inboxes_resource_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "resource_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/messages/{resource_id}": { "get": { "operationId": "get_messages_resource_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "resource_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/drafts/{resource_id}": { "get": { "operationId": "get_drafts_resource_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "parameters": [ { "in": "path", "name": "resource_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/inboxes/{resource_id}/attachment-intake": { "post": { "operationId": "post_inboxes_resource_id_attachment-intake", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "resource_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "confirm": { "type": "boolean", "enum": [ true ] }, "inbox_version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 } }, "required": [ "confirm", "inbox_version" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/connections": { "get": { "operationId": "get_connections", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_connections", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "fixture" ] }, "scopes": { "type": "array", "items": { "type": "string", "enum": [ "records:read", "records:write" ] }, "minItems": 1, "maxItems": 2 } }, "required": [ "provider", "scopes" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/connections/{connection_id}": { "get": { "operationId": "get_connections_connection_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "connection_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "delete": { "operationId": "delete_connections_connection_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "connection_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/connections/{provider}/callback": { "get": { "operationId": "get_connections_provider_callback", "description": "Unavailable until separately approved provider configuration.", "parameters": [ { "in": "path", "name": "provider", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "503": { "description": "Provider unavailable; no external effect" } } }, "post": { "operationId": "post_connections_provider_callback", "description": "Unavailable until separately approved provider configuration.", "parameters": [ { "in": "path", "name": "provider", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "responses": { "503": { "description": "Provider unavailable; no external effect" } } } }, "/api/v1/monitors": { "get": { "operationId": "get_monitors", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_monitors", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "snapshot": { "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "string", "format": "uri", "maxLength": 2048 }, "minItems": 1, "maxItems": 50 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "recipe": { "type": "object", "properties": { "item_selector": { "type": "string", "minLength": 1, "maxLength": 200 }, "fields": { "type": "object", "additionalProperties": { "type": "object", "properties": { "selector": { "type": "string", "maxLength": 200 }, "attribute": { "type": "string", "enum": [ "text", "href", "data-id", "content" ], "default": "text" }, "required": { "type": "boolean" } }, "required": [ "selector", "required" ], "additionalProperties": false } } }, "required": [ "item_selector", "fields" ], "additionalProperties": false }, "normalization": { "type": "object", "properties": { "trim": { "type": "boolean" }, "collapse_whitespace": { "type": "boolean" } }, "required": [ "trim", "collapse_whitespace" ], "additionalProperties": false } }, "required": [ "urls", "schema_version", "recipe", "normalization" ], "additionalProperties": false }, "cadence_minutes": { "type": "integer", "minimum": 15, "maximum": 525600 }, "timezone": { "type": "string", "enum": [ "UTC" ] }, "overlap": { "type": "string", "enum": [ "skip", "queue" ] }, "max_runs": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 1000 }, "webhook_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "snapshot", "cadence_minutes", "timezone", "overlap", "max_runs" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/monitors/{monitor_id}": { "get": { "operationId": "get_monitors_monitor_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "patch": { "operationId": "patch_monitors_monitor_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "paused": { "type": "boolean" } }, "required": [ "paused" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "delete": { "operationId": "delete_monitors_monitor_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "monitor_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/webhooks": { "get": { "operationId": "get_webhooks", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_webhooks", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "format": "uri", "maxLength": 2048 }, "event": { "type": "string", "enum": [ "job.completed" ] } }, "required": [ "url", "event" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/webhooks/{webhook_id}": { "get": { "operationId": "get_webhooks_webhook_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "webhook_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } } ], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "delete": { "operationId": "delete_webhooks_webhook_id", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "path", "name": "webhook_id", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,100}$" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/account/deletion": { "get": { "operationId": "get_account_deletion", "description": "Records a deletion request; this does not claim completed erasure.", "security": [ { "AccountSession": [] } ], "parameters": [], "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } }, "post": { "operationId": "post_account_deletion", "description": "Records a deletion request; this does not claim completed erasure.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "confirm": { "type": "boolean", "enum": [ true ] } }, "required": [ "confirm" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } }, "/api/v1/operator/services": { "post": { "operationId": "post_operator_services", "description": "Tenant-scoped reference operation. Current role/scope and session mutation policy apply.", "security": [ { "AccountSession": [] } ], "parameters": [ { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string", "minLength": 8, "maxLength": 128 } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S01", "S02", "S03", "S04", "S05", "S06", "S07", "S08", "S09", "S10", "S11", "S12", "S13" ] }, "enabled": { "type": "boolean" } }, "required": [ "service_id", "enabled" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "Authorized result" }, "202": { "description": "Accepted asynchronous job" }, "400": { "description": "Invalid strict request" }, "401": { "description": "Separate workspace identity required" }, "403": { "description": "Policy denied" }, "404": { "description": "Resource unavailable or not owned" }, "409": { "description": "Version/idempotency conflict" }, "413": { "description": "Resource ceiling exceeded" }, "429": { "description": "Rate or budget limit" }, "503": { "description": "Required capability/provider unavailable" } } } } }, "components": { "securitySchemes": { "ServiceKey": { "type": "http", "scheme": "bearer", "description": "als_ scoped project key; never an alk_ catalog key" }, "AccountSession": { "type": "apiKey", "in": "cookie", "name": "als_session", "description": "Authenticated account session. Mutations also require X-CSRF-Token and same Origin." } }, "schemas": { "S01_verify_input": { "type": "object", "properties": { "records": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "type": { "type": "string", "enum": [ "invoice", "contract", "rate_card", "po", "receipt" ] }, "supplier": { "type": "string", "maxLength": 500 }, "number": { "type": "string", "maxLength": 500 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "lines": { "type": "array", "items": { "type": "object", "properties": { "line_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "quantity": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" }, "unit_price": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" }, "tax": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$", "default": "0" }, "discount": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$", "default": "0" }, "surcharge": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$", "default": "0" }, "surcharge_category": { "type": "string", "maxLength": 500 }, "total": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" } }, "required": [ "line_id", "quantity", "unit_price" ], "additionalProperties": false }, "maxItems": 10000 }, "total": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" }, "source": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "document_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "page": { "type": "integer", "minimum": 1 }, "row": { "type": "integer", "minimum": 1 }, "field": { "type": "string", "maxLength": 500 } }, "additionalProperties": false } }, "required": [ "id", "type", "supplier", "number", "currency", "lines" ], "additionalProperties": false }, "minItems": 2, "maxItems": 25 }, "field_mapping": { "type": "object", "additionalProperties": { "type": "string", "maxLength": 100 }, "default": {} }, "rules": { "type": "array", "items": { "type": "string", "enum": [ "duplicate", "missing_line", "extra_line", "rate_variance", "quantity_variance", "arithmetic", "currency", "surcharge" ] }, "minItems": 1, "maxItems": 8 }, "tolerances": { "type": "object", "properties": { "amount": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" }, "quantity": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" } }, "required": [ "amount", "quantity" ], "additionalProperties": false }, "currency_policy": { "type": "string", "enum": [ "block_mixed" ] }, "allowed_surcharges": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 50, "default": [] } }, "required": [ "records", "rules", "tolerances", "currency_policy" ], "additionalProperties": false, "example": { "records": [ { "id": "invoice_1", "type": "invoice", "supplier": "Synthetic Supply", "number": "INV-001", "currency": "CAD", "lines": [ { "line_id": "item_1", "quantity": "2", "unit_price": "12.00", "total": "24.00" } ] }, { "id": "po_1", "type": "po", "supplier": "Synthetic Supply", "number": "PO-001", "currency": "CAD", "lines": [ { "line_id": "item_1", "quantity": "2", "unit_price": "10.00", "total": "20.00" } ] } ], "field_mapping": {}, "rules": [ "rate_variance", "arithmetic", "currency" ], "tolerances": { "amount": "0.01", "quantity": "0" }, "currency_policy": "block_mixed" } }, "S01_verify_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "findings": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "rule_id": { "type": "string", "maxLength": 500 }, "rule_version": { "type": "string", "enum": [ "1.0.0" ] }, "severity": { "type": "string", "enum": [ "info", "warning", "error" ] }, "observed": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] }, "expected": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] }, "calculation": { "type": "string", "maxLength": 500 }, "evidence": { "type": "array", "items": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "document_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "page": { "type": "integer", "minimum": 1 }, "row": { "type": "integer", "minimum": 1 }, "field": { "type": "string", "maxLength": 500 } }, "additionalProperties": false }, "maxItems": 25 }, "needs_review": { "type": "boolean" } }, "required": [ "id", "version", "rule_id", "rule_version", "severity", "observed", "expected", "calculation", "evidence", "needs_review" ], "additionalProperties": false }, "maxItems": 10000 }, "totals": { "type": "object", "additionalProperties": { "type": "string", "pattern": "^-?\\d{1,34}(\\.\\d{1,16})?$" } }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "findings", "totals", "artifacts" ], "additionalProperties": false }, "S01_review_input": { "type": "object", "properties": { "job_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "finding_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "finding_version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "decision": { "type": "string", "enum": [ "accept", "reject" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 1000 } }, "required": [ "job_id", "finding_id", "finding_version", "decision", "reason" ], "additionalProperties": false, "example": { "job_id": "job_fixture", "finding_id": "finding_1", "finding_version": 1, "decision": "accept", "reason": "Reviewed against synthetic source." } }, "S01_review_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "review_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "finding_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "decision": { "type": "string", "enum": [ "accept", "reject" ] }, "reviewer_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "review_id", "finding_id", "version", "decision", "reviewer_id" ], "additionalProperties": false }, "S02_compare_input": { "type": "object", "properties": { "left": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "additionalProperties": false }, "right": { "type": "object", "properties": { "rows": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "additionalProperties": false }, "key_fields": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 10 }, "field_map": { "type": "object", "additionalProperties": { "type": "string", "maxLength": 100 } }, "normalization": { "type": "object", "additionalProperties": { "type": "string", "enum": [ "none", "trim", "lower", "upper" ] } }, "tolerance_policy": { "type": "object", "additionalProperties": { "type": "string", "pattern": "^-?\\d{1,15}(\\.\\d{1,8})?$" } }, "blank_policy": { "type": "string", "enum": [ "distinct", "empty_is_null" ] }, "profile_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "profile_version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 } }, "required": [ "left", "right", "key_fields", "field_map", "normalization", "tolerance_policy", "blank_policy" ], "additionalProperties": false, "example": { "left": { "rows": [ { "id": "001", "amount": "10.00" } ] }, "right": { "rows": [ { "id": "001", "amount": "10.01" } ] }, "key_fields": [ "id" ], "field_map": { "amount": "amount" }, "normalization": {}, "tolerance_policy": { "amount": "0.01" }, "blank_policy": "distinct" } }, "S02_compare_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "counts": { "type": "object", "properties": { "matched": { "type": "integer" }, "mismatched": { "type": "integer" }, "left_only": { "type": "integer" }, "right_only": { "type": "integer" }, "ambiguous": { "type": "integer" }, "invalid": { "type": "integer" }, "left_rows": { "type": "integer" }, "right_rows": { "type": "integer" } }, "required": [ "matched", "mismatched", "left_only", "right_only", "ambiguous", "invalid", "left_rows", "right_rows" ], "additionalProperties": false }, "matches": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "maxLength": 500 }, "left_rows": { "type": "array", "items": { "type": "integer", "minimum": 0 }, "maxItems": 100000 }, "right_rows": { "type": "array", "items": { "type": "integer", "minimum": 0 }, "maxItems": 100000 }, "class": { "type": "string", "enum": [ "matched", "mismatched", "left_only", "right_only", "ambiguous", "invalid" ] }, "deltas": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "maxLength": 500 }, "left": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] }, "right": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] }, "delta": { "type": "string", "maxLength": 8193, "pattern": "^-?\\d{1,4097}(\\.\\d{1,4094})?$", "nullable": true } }, "required": [ "field", "left", "right", "delta" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "key", "left_rows", "right_rows", "class", "deltas" ], "additionalProperties": false }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "counts", "matches", "artifacts" ], "additionalProperties": false }, "S03_profile_input": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "delimiter": { "type": "string", "enum": [ ",", ";", "\t", "|" ] }, "encoding": { "type": "string", "enum": [ "utf-8" ], "default": "utf-8" }, "header": { "type": "boolean", "enum": [ true ], "default": true } }, "required": [ "upload_id" ], "additionalProperties": false, "example": { "upload_id": "upl_fixture", "delimiter": ",", "encoding": "utf-8", "header": true } }, "S03_profile_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "row_count": { "type": "integer", "minimum": 0 }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 100 }, "input_hash": { "type": "string", "maxLength": 500 }, "recipe_digest": { "type": "string", "maxLength": 500 }, "step_counts": { "type": "array", "items": { "type": "integer", "minimum": 0 }, "maxItems": 30 }, "before": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "after": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "validation": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "row_count", "columns", "input_hash", "step_counts", "before", "after", "validation", "artifacts" ], "additionalProperties": false }, "S03_preview_recipe_input": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "delimiter": { "type": "string", "enum": [ ",", ";", "\t", "|" ] }, "encoding": { "type": "string", "enum": [ "utf-8" ], "default": "utf-8" }, "header": { "type": "boolean", "enum": [ true ], "default": true }, "recipe_version": { "type": "string", "enum": [ "1.0.0" ] }, "recipe": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "select" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 } }, "required": [ "type", "columns" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "rename" ] }, "from": { "type": "string", "maxLength": 500 }, "to": { "type": "string", "maxLength": 500 } }, "required": [ "type", "from", "to" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "reorder" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 } }, "required": [ "type", "columns" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "trim" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 } }, "required": [ "type", "columns" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "case" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 }, "mode": { "type": "string", "enum": [ "upper", "lower" ] } }, "required": [ "type", "columns", "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "cast" ] }, "column": { "type": "string", "maxLength": 500 }, "to": { "type": "string", "enum": [ "string", "decimal", "integer", "iso_date" ] }, "scale": { "type": "integer", "minimum": 0, "maximum": 8, "default": 2 } }, "required": [ "type", "column", "to" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "deduplicate" ] }, "keys": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 10 }, "keep": { "type": "string", "enum": [ "first", "last" ] } }, "required": [ "type", "keys", "keep" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "derived_expression" ] }, "column": { "type": "string", "maxLength": 500 }, "expression": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "concat", "add", "subtract" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 5 }, "separator": { "type": "string", "maxLength": 30, "default": "" } }, "required": [ "op", "columns" ], "additionalProperties": false } }, "required": [ "type", "column", "expression" ], "additionalProperties": false } ] }, "maxItems": 30 }, "target_schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 500 }, "required": { "type": "boolean" }, "type": { "type": "string", "enum": [ "string", "decimal", "integer", "iso_date" ] }, "allowed": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 100 }, "max_length": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 4096 }, "precision": { "type": "integer", "minimum": 0, "maximum": 8 } }, "required": [ "name", "required", "type" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "preview_limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 }, "expected_input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "upload_id", "recipe_version", "recipe" ], "additionalProperties": false, "example": { "upload_id": "upl_fixture", "delimiter": ",", "encoding": "utf-8", "header": true, "recipe_version": "1.0.0", "recipe": [ { "type": "trim", "columns": [ "name" ] } ], "target_schema": [], "preview_limit": 10 } }, "S03_preview_recipe_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "row_count": { "type": "integer", "minimum": 0 }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 100 }, "input_hash": { "type": "string", "maxLength": 500 }, "recipe_digest": { "type": "string", "maxLength": 500 }, "step_counts": { "type": "array", "items": { "type": "integer", "minimum": 0 }, "maxItems": 30 }, "before": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "after": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "validation": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "row_count", "columns", "input_hash", "step_counts", "before", "after", "validation", "artifacts" ], "additionalProperties": false }, "S03_apply_recipe_input": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "delimiter": { "type": "string", "enum": [ ",", ";", "\t", "|" ] }, "encoding": { "type": "string", "enum": [ "utf-8" ], "default": "utf-8" }, "header": { "type": "boolean", "enum": [ true ], "default": true }, "recipe_version": { "type": "string", "enum": [ "1.0.0" ] }, "recipe": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "select" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 } }, "required": [ "type", "columns" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "rename" ] }, "from": { "type": "string", "maxLength": 500 }, "to": { "type": "string", "maxLength": 500 } }, "required": [ "type", "from", "to" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "reorder" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 } }, "required": [ "type", "columns" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "trim" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 } }, "required": [ "type", "columns" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "case" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 100 }, "mode": { "type": "string", "enum": [ "upper", "lower" ] } }, "required": [ "type", "columns", "mode" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "cast" ] }, "column": { "type": "string", "maxLength": 500 }, "to": { "type": "string", "enum": [ "string", "decimal", "integer", "iso_date" ] }, "scale": { "type": "integer", "minimum": 0, "maximum": 8, "default": 2 } }, "required": [ "type", "column", "to" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "deduplicate" ] }, "keys": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 10 }, "keep": { "type": "string", "enum": [ "first", "last" ] } }, "required": [ "type", "keys", "keep" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "derived_expression" ] }, "column": { "type": "string", "maxLength": 500 }, "expression": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "concat", "add", "subtract" ] }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 5 }, "separator": { "type": "string", "maxLength": 30, "default": "" } }, "required": [ "op", "columns" ], "additionalProperties": false } }, "required": [ "type", "column", "expression" ], "additionalProperties": false } ] }, "maxItems": 30 }, "target_schema": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 500 }, "required": { "type": "boolean" }, "type": { "type": "string", "enum": [ "string", "decimal", "integer", "iso_date" ] }, "allowed": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 100 }, "max_length": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 4096 }, "precision": { "type": "integer", "minimum": 0, "maximum": 8 } }, "required": [ "name", "required", "type" ], "additionalProperties": false }, "maxItems": 100, "default": [] }, "preview_limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 }, "expected_input_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "upload_id", "recipe_version", "recipe" ], "additionalProperties": false, "example": { "upload_id": "upl_fixture", "delimiter": ",", "encoding": "utf-8", "header": true, "recipe_version": "1.0.0", "recipe": [ { "type": "trim", "columns": [ "name" ] } ], "target_schema": [], "preview_limit": 10, "expected_input_hash": "0000000000000000000000000000000000000000000000000000000000000000" } }, "S03_apply_recipe_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "row_count": { "type": "integer", "minimum": 0 }, "columns": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 100 }, "input_hash": { "type": "string", "maxLength": 500 }, "recipe_digest": { "type": "string", "maxLength": 500 }, "step_counts": { "type": "array", "items": { "type": "integer", "minimum": 0 }, "maxItems": 30 }, "before": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "after": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "validation": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "row_count", "columns", "input_hash", "step_counts", "before", "after", "validation", "artifacts" ], "additionalProperties": false }, "S04_inspect_pdf_input": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "profile": { "type": "object", "properties": { "version": { "type": "string", "enum": [ "1.0.0" ] }, "width_pt": { "type": "number", "exclusiveMinimum": true, "minimum": 0, "maximum": 14400 }, "height_pt": { "type": "number", "exclusiveMinimum": true, "minimum": 0, "maximum": 14400 }, "tolerance_pt": { "type": "number", "minimum": 0, "maximum": 72 }, "bleed_pt": { "type": "number", "minimum": 0, "maximum": 72 }, "font_policy": { "type": "string", "enum": [ "embedded", "any" ], "default": "embedded" }, "min_dpi": { "type": "number", "minimum": 1, "maximum": 2400, "default": 300 }, "allowed_color_spaces": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 10, "default": [] }, "output_intent": { "type": "string", "enum": [ "required", "optional" ], "default": "optional" } }, "required": [ "version", "width_pt", "height_pt", "tolerance_pt", "bleed_pt" ], "additionalProperties": false }, "checks": { "type": "array", "items": { "type": "string", "enum": [ "page_size", "trim_box", "bleed_box", "fonts", "resolution", "color", "output_intent", "pdf_x" ] }, "minItems": 1, "maxItems": 8 } }, "required": [ "upload_id", "profile", "checks" ], "additionalProperties": false, "example": { "upload_id": "upl_fixture", "profile": { "version": "1.0.0", "width_pt": 612, "height_pt": 792, "tolerance_pt": 1, "bleed_pt": 9 }, "checks": [ "page_size", "trim_box", "bleed_box", "fonts" ] } }, "S04_inspect_pdf_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "page_count": { "type": "integer" }, "findings": { "type": "array", "items": { "type": "object", "properties": { "check": { "type": "string", "maxLength": 500 }, "page": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "state": { "type": "string", "enum": [ "passed", "failed", "not_checked" ] }, "detail": { "type": "string", "maxLength": 500 } }, "required": [ "check", "state", "detail" ], "additionalProperties": false }, "maxItems": 800 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "page_count", "findings", "artifacts" ], "additionalProperties": false }, "S05_inspect_input": { "type": "object", "properties": { "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 20 }, "metadata_visibility": { "type": "string", "enum": [ "masked" ] }, "provenance_check": { "type": "boolean", "default": false } }, "required": [ "upload_ids", "metadata_visibility" ], "additionalProperties": false, "example": { "upload_ids": [ "upl_fixture" ], "metadata_visibility": "masked" } }, "S05_inspect_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "images": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "images", "artifacts" ], "additionalProperties": false }, "S05_sanitize_input": { "type": "object", "properties": { "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 20 }, "removal_profile": { "type": "string", "enum": [ "all_removable", "location", "device", "author" ] }, "output_profile": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "jpeg", "png", "webp" ] }, "quality": { "type": "integer", "minimum": 1, "maximum": 100 }, "max_width": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 10000 }, "max_height": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 10000 }, "max_bytes": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 26214400 }, "normalize_orientation": { "type": "boolean", "enum": [ true ] }, "background": { "type": "string", "pattern": "^#[a-fA-F0-9]{6}$" } }, "required": [ "format", "quality", "max_width", "max_height", "max_bytes", "normalize_orientation" ], "additionalProperties": false } }, "required": [ "upload_ids", "removal_profile", "output_profile" ], "additionalProperties": false, "example": { "upload_ids": [ "upl_fixture" ], "removal_profile": "all_removable", "output_profile": { "format": "png", "quality": 90, "max_width": 1000, "max_height": 1000, "max_bytes": 1000000, "normalize_orientation": true } } }, "S05_sanitize_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "images": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "images", "artifacts" ], "additionalProperties": false }, "S06_snapshot_input": { "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "string", "format": "uri", "maxLength": 2048 }, "minItems": 1, "maxItems": 50 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "recipe": { "type": "object", "properties": { "item_selector": { "type": "string", "minLength": 1, "maxLength": 200 }, "fields": { "type": "object", "additionalProperties": { "type": "object", "properties": { "selector": { "type": "string", "maxLength": 200 }, "attribute": { "type": "string", "enum": [ "text", "href", "data-id", "content" ], "default": "text" }, "required": { "type": "boolean" } }, "required": [ "selector", "required" ], "additionalProperties": false } } }, "required": [ "item_selector", "fields" ], "additionalProperties": false }, "normalization": { "type": "object", "properties": { "trim": { "type": "boolean" }, "collapse_whitespace": { "type": "boolean" } }, "required": [ "trim", "collapse_whitespace" ], "additionalProperties": false } }, "required": [ "urls", "schema_version", "recipe", "normalization" ], "additionalProperties": false, "example": { "urls": [ "http://127.0.0.1:4322/products" ], "schema_version": "1.0.0", "recipe": { "item_selector": "article", "fields": { "id": { "selector": "", "attribute": "data-id", "required": true }, "name": { "selector": "h2", "attribute": "text", "required": true } } }, "normalization": { "trim": true, "collapse_whitespace": true } } }, "S06_snapshot_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "snapshot_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "targets": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "records": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "snapshot_id", "targets", "records", "artifacts" ], "additionalProperties": false }, "S06_compare_snapshots_input": { "type": "object", "properties": { "previous_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "current_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "identity_field": { "type": "string", "maxLength": 500 }, "change_fields": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "minItems": 1, "maxItems": 30 } }, "required": [ "previous_id", "current_id", "identity_field", "change_fields" ], "additionalProperties": false, "example": { "previous_id": "snap_previous", "current_id": "snap_current", "identity_field": "id", "change_fields": [ "name" ] } }, "S06_compare_snapshots_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "changes": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "excluded": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "changes", "excluded", "artifacts" ], "additionalProperties": false }, "S06_create_monitor_input": { "type": "object", "properties": { "snapshot": { "type": "object", "properties": { "urls": { "type": "array", "items": { "type": "string", "format": "uri", "maxLength": 2048 }, "minItems": 1, "maxItems": 50 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "recipe": { "type": "object", "properties": { "item_selector": { "type": "string", "minLength": 1, "maxLength": 200 }, "fields": { "type": "object", "additionalProperties": { "type": "object", "properties": { "selector": { "type": "string", "maxLength": 200 }, "attribute": { "type": "string", "enum": [ "text", "href", "data-id", "content" ], "default": "text" }, "required": { "type": "boolean" } }, "required": [ "selector", "required" ], "additionalProperties": false } } }, "required": [ "item_selector", "fields" ], "additionalProperties": false }, "normalization": { "type": "object", "properties": { "trim": { "type": "boolean" }, "collapse_whitespace": { "type": "boolean" } }, "required": [ "trim", "collapse_whitespace" ], "additionalProperties": false } }, "required": [ "urls", "schema_version", "recipe", "normalization" ], "additionalProperties": false }, "cadence_minutes": { "type": "integer", "minimum": 15, "maximum": 525600 }, "timezone": { "type": "string", "enum": [ "UTC" ] }, "overlap": { "type": "string", "enum": [ "skip", "queue" ] }, "max_runs": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 1000 }, "webhook_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "snapshot", "cadence_minutes", "timezone", "overlap", "max_runs" ], "additionalProperties": false, "example": { "snapshot": { "urls": [ "http://127.0.0.1:4322/products" ], "schema_version": "1.0.0", "recipe": { "item_selector": "article", "fields": { "id": { "selector": "", "attribute": "data-id", "required": true }, "name": { "selector": "h2", "attribute": "text", "required": true } } }, "normalization": { "trim": true, "collapse_whitespace": true } }, "cadence_minutes": 60, "timezone": "UTC", "overlap": "skip", "max_runs": 10 } }, "S06_create_monitor_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "monitor_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "enabled", "paused" ] }, "next_run": { "type": "integer" }, "effective_limit": { "type": "integer" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "monitor_id", "state", "next_run", "effective_limit" ], "additionalProperties": false }, "S07_run_suite_input": { "type": "object", "properties": { "origin": { "type": "string", "format": "uri", "maxLength": 2048 }, "suite_version": { "type": "string", "enum": [ "1.0.0" ] }, "flows": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 500 }, "steps": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "navigate" ] }, "path": { "type": "string", "maxLength": 1000, "pattern": "^\\/(?!\\/)" } }, "required": [ "type", "path" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "read" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 } }, "required": [ "type", "role", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "fill" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "value": { "type": "string", "maxLength": 500 } }, "required": [ "type", "role", "name", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "click" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "effect": { "type": "string", "enum": [ "none", "submit" ], "default": "none" } }, "required": [ "type", "role", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "assert_text" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "text": { "type": "string", "maxLength": 500 } }, "required": [ "type", "role", "name", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "assert_state" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "state": { "type": "string", "enum": [ "visible", "hidden", "checked", "disabled" ] } }, "required": [ "type", "role", "name", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "capture" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "type", "label" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "handoff" ] }, "reason": { "type": "string", "enum": [ "login", "otp" ] } }, "required": [ "type", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "download" ] }, "path": { "type": "string", "maxLength": 1000, "pattern": "^\\/(?!\\/)" } }, "required": [ "type", "path" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "wait" ] }, "milliseconds": { "type": "integer", "minimum": 1, "maximum": 1000 } }, "required": [ "type", "milliseconds" ], "additionalProperties": false } ] }, "minItems": 1, "maxItems": 30 } }, "required": [ "name", "steps" ], "additionalProperties": false }, "minItems": 1, "maxItems": 5 }, "fixture_refs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 10, "default": [] }, "credential_ref": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "origin", "suite_version", "flows" ], "additionalProperties": false, "example": { "origin": "http://127.0.0.1:4322", "suite_version": "1.0.0", "flows": [ { "name": "Known good", "steps": [ { "type": "navigate", "path": "/release" }, { "type": "assert_text", "role": "heading", "name": "Fixture", "text": "Fixture" } ] } ] } }, "S07_run_suite_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "flows": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "passed": { "type": "boolean" }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "flows", "passed", "artifacts" ], "additionalProperties": false }, "S08_create_inbox_input": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "local_sink", "configured" ] }, "domain": { "type": "string", "maxLength": 253 }, "purpose": { "type": "string", "minLength": 1, "maxLength": 200 }, "retention_hours": { "type": "integer", "minimum": 1, "maximum": 24 } }, "required": [ "provider", "domain", "purpose", "retention_hours" ], "additionalProperties": false, "example": { "provider": "local_sink", "domain": "mail.local.test", "purpose": "Synthetic reference", "retention_hours": 24 } }, "S08_create_inbox_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "inbox_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "address": { "type": "string", "format": "email" }, "state": { "type": "string", "enum": [ "local_only", "provider" ] }, "restrictions": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "inbox_id", "address", "state", "restrictions" ], "additionalProperties": false }, "S08_list_messages_input": { "type": "object", "properties": { "inbox_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "cursor": { "type": "string", "maxLength": 4096 }, "query": { "type": "string", "maxLength": 100 } }, "required": [ "inbox_id" ], "additionalProperties": false, "example": { "inbox_id": "inbox_fixture" } }, "S08_list_messages_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "messages": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "from": { "type": "string", "maxLength": 254 }, "subject": { "type": "string", "maxLength": 200 }, "body": { "type": "string", "maxLength": 4096 }, "kind": { "type": "string", "enum": [ "message", "bounce", "complaint" ] }, "content_format": { "type": "string", "enum": [ "plain_text_inert" ] }, "thread_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$", "nullable": true }, "in_reply_to": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$", "nullable": true }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "filename": { "type": "string", "maxLength": 120 }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 16384 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "state": { "type": "string", "enum": [ "intent", "quarantine", "clean", "rejected", "purged", "unavailable" ] }, "scan": { "type": "string", "maxLength": 500 } }, "required": [ "upload_id", "filename", "media_type", "bytes", "sha256", "state", "scan" ], "additionalProperties": false }, "maxItems": 5 } }, "required": [ "id", "from", "subject", "body", "kind", "content_format", "thread_id", "in_reply_to", "attachments" ], "additionalProperties": false }, "maxItems": 100 }, "next_cursor": { "type": "string", "nullable": true } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "messages", "next_cursor" ], "additionalProperties": false }, "S08_draft_message_input": { "type": "object", "properties": { "inbox_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "recipients": { "type": "array", "items": { "type": "string", "format": "email", "maxLength": 254 }, "minItems": 1, "maxItems": 1 }, "subject": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\r\\n]+$" }, "body": { "type": "string", "maxLength": 20000 }, "attachment_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 5 } }, "required": [ "inbox_id", "recipients", "subject", "body", "attachment_ids" ], "additionalProperties": false, "example": { "inbox_id": "inbox_fixture", "recipients": [ "recipient@mail.local.test" ], "subject": "Synthetic message", "body": "No real email is sent.", "attachment_ids": [] } }, "S08_draft_message_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "draft_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "version": { "type": "integer" }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "action_digest": { "type": "string", "maxLength": 500 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "draft_id", "version", "approval_id", "action_digest" ], "additionalProperties": false }, "S08_send_approved_message_input": { "type": "object", "properties": { "draft_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "draft_version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "draft_id", "draft_version", "approval_id" ], "additionalProperties": false, "example": { "draft_id": "draft_fixture", "draft_version": 1, "approval_id": "approval_fixture" } }, "S08_send_approved_message_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "resource_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "accepted", "delivered", "unknown", "completed", "stopped", "awaiting_approval" ] }, "effect_outcome": { "type": "string", "enum": [ "none", "completed", "unknown" ] }, "reconciliation_required": { "type": "boolean" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "resource_id", "state", "effect_outcome", "reconciliation_required" ], "additionalProperties": false }, "S09_run_recipe_input": { "type": "object", "properties": { "origin": { "type": "string", "format": "uri", "maxLength": 2048 }, "allowed_origins": { "type": "array", "items": { "type": "string", "format": "uri", "maxLength": 2048 }, "minItems": 1, "maxItems": 5 }, "recipe_version": { "type": "string", "enum": [ "1.0.0" ] }, "steps": { "type": "array", "items": { "anyOf": [ { "type": "object", "properties": { "type": { "type": "string", "enum": [ "navigate" ] }, "path": { "type": "string", "maxLength": 1000, "pattern": "^\\/(?!\\/)" } }, "required": [ "type", "path" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "read" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 } }, "required": [ "type", "role", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "fill" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "value": { "type": "string", "maxLength": 500 } }, "required": [ "type", "role", "name", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "click" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "effect": { "type": "string", "enum": [ "none", "submit" ], "default": "none" } }, "required": [ "type", "role", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "assert_text" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "text": { "type": "string", "maxLength": 500 } }, "required": [ "type", "role", "name", "text" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "assert_state" ] }, "role": { "type": "string", "enum": [ "button", "link", "textbox", "heading", "status", "checkbox" ] }, "name": { "type": "string", "maxLength": 100 }, "state": { "type": "string", "enum": [ "visible", "hidden", "checked", "disabled" ] } }, "required": [ "type", "role", "name", "state" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "capture" ] }, "label": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "type", "label" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "handoff" ] }, "reason": { "type": "string", "enum": [ "login", "otp" ] } }, "required": [ "type", "reason" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "download" ] }, "path": { "type": "string", "maxLength": 1000, "pattern": "^\\/(?!\\/)" } }, "required": [ "type", "path" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "wait" ] }, "milliseconds": { "type": "integer", "minimum": 1, "maximum": 1000 } }, "required": [ "type", "milliseconds" ], "additionalProperties": false } ] }, "minItems": 1, "maxItems": 30 }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "credential_ref": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "origin", "allowed_origins", "recipe_version", "steps" ], "additionalProperties": false, "example": { "origin": "http://127.0.0.1:4322", "allowed_origins": [ "http://127.0.0.1:4322" ], "recipe_version": "1.0.0", "steps": [ { "type": "navigate", "path": "/release" }, { "type": "read", "role": "heading", "name": "Fixture" } ] } }, "S09_run_recipe_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "completed", "awaiting_approval", "handoff", "stopped" ] }, "steps": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "session_id", "state", "steps", "artifacts" ], "additionalProperties": false }, "S09_terminate_session_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "reason": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "session_id", "reason" ], "additionalProperties": false, "example": { "session_id": "session_fixture", "reason": "User requested stop" } }, "S09_terminate_session_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "resource_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "accepted", "delivered", "unknown", "completed", "stopped", "awaiting_approval" ] }, "effect_outcome": { "type": "string", "enum": [ "none", "completed", "unknown" ] }, "reconciliation_required": { "type": "boolean" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "resource_id", "state", "effect_outcome", "reconciliation_required" ], "additionalProperties": false }, "S10_list_capabilities_input": { "type": "object", "properties": { "connector": { "type": "string", "enum": [ "fixture", "github" ] }, "connection_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "connector" ], "additionalProperties": false, "example": { "connector": "fixture" } }, "S10_list_capabilities_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "capabilities": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "effective_scopes": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "provider_verified": { "type": "boolean" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "capabilities", "effective_scopes", "provider_verified" ], "additionalProperties": false }, "S10_read_input": { "type": "object", "properties": { "connection_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "resource": { "type": "string", "enum": [ "repositories", "issues", "records" ] }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string", "maxLength": 4096 }, "query": { "type": "string", "maxLength": 100 } }, "required": [ "connection_id", "resource", "limit" ], "additionalProperties": false, "example": { "connection_id": "connection_fixture", "resource": "records", "limit": 10 } }, "S10_read_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "objects": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "next_cursor": { "type": "string", "nullable": true } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "objects", "next_cursor" ], "additionalProperties": false }, "S10_propose_action_input": { "type": "object", "properties": { "connection_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "action": { "type": "string", "enum": [ "update_record" ] }, "object_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "values": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } } }, "required": [ "connection_id", "action", "object_id", "values" ], "additionalProperties": false, "example": { "connection_id": "connection_fixture", "action": "update_record", "object_id": "record_1", "values": { "status": "reviewed" } } }, "S10_propose_action_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "proposal_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "version": { "type": "integer" }, "action_digest": { "type": "string", "maxLength": 500 }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "proposal_id", "version", "action_digest", "approval_id" ], "additionalProperties": false }, "S10_execute_approved_action_input": { "type": "object", "properties": { "proposal_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "proposal_version": { "type": "integer", "exclusiveMinimum": true, "minimum": 0 }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "proposal_id", "proposal_version", "approval_id" ], "additionalProperties": false, "example": { "proposal_id": "proposal_fixture", "proposal_version": 1, "approval_id": "approval_fixture" } }, "S10_execute_approved_action_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "resource_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "accepted", "delivered", "unknown", "completed", "stopped", "awaiting_approval" ] }, "effect_outcome": { "type": "string", "enum": [ "none", "completed", "unknown" ] }, "reconciliation_required": { "type": "boolean" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "resource_id", "state", "effect_outcome", "reconciliation_required" ], "additionalProperties": false }, "S11_inspect_port_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "ports": { "type": "array", "items": { "type": "integer", "minimum": 1, "maximum": 65535 }, "minItems": 1, "maxItems": 20 }, "protocol": { "type": "string", "enum": [ "tcp", "udp" ] } }, "required": [ "session_id", "ports", "protocol" ], "additionalProperties": false, "example": { "session_id": "local_session", "ports": [ 4319 ], "protocol": "tcp" } }, "S11_inspect_port_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "rows", "artifacts" ], "additionalProperties": false }, "S11_inspect_file_lock_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "paths": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1024 }, "minItems": 1, "maxItems": 10 } }, "required": [ "session_id", "paths" ], "additionalProperties": false, "example": { "session_id": "local_session", "paths": [ "C:\\automata-reference\\fixture.txt" ] } }, "S11_inspect_file_lock_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "rows": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "rows", "artifacts" ], "additionalProperties": false }, "S12_transform_pdf_input": { "type": "object", "properties": { "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "minItems": 1, "maxItems": 25 }, "transform": { "type": "string", "enum": [ "split", "merge", "reorder", "extract", "stamp" ] }, "pages": { "type": "array", "items": { "type": "object", "properties": { "input": { "type": "integer", "minimum": 0, "maximum": 24 }, "page": { "type": "integer", "minimum": 1, "maximum": 100 } }, "required": [ "input", "page" ], "additionalProperties": false }, "minItems": 1, "maxItems": 100 }, "stamp": { "type": "object", "properties": { "text": { "type": "string", "minLength": 1, "maxLength": 100 }, "x": { "type": "number", "minimum": 0, "maximum": 14400 }, "y": { "type": "number", "minimum": 0, "maximum": 14400 }, "bates_start": { "type": "integer", "minimum": 0 } }, "required": [ "text", "x", "y" ], "additionalProperties": false } }, "required": [ "upload_ids", "transform", "pages" ], "additionalProperties": false, "example": { "upload_ids": [ "upl_fixture" ], "transform": "reorder", "pages": [ { "input": 0, "page": 2 }, { "input": 0, "page": 1 } ] } }, "S12_transform_pdf_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "manifest": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "manifest", "artifacts" ], "additionalProperties": false }, "S12_compare_revisions_input": { "type": "object", "properties": { "previous_upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "current_upload_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "page_map": { "type": "array", "items": { "type": "object", "properties": { "previous": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 100 }, "current": { "type": "integer", "exclusiveMinimum": true, "minimum": 0, "maximum": 100 } }, "required": [ "previous", "current" ], "additionalProperties": false }, "maxItems": 100 }, "mode": { "type": "string", "enum": [ "structure", "visual", "text" ] }, "comparison_version": { "type": "string", "enum": [ "1.0.0" ] } }, "required": [ "previous_upload_id", "current_upload_id", "page_map", "mode", "comparison_version" ], "additionalProperties": false, "example": { "previous_upload_id": "upl_previous", "current_upload_id": "upl_current", "page_map": [ { "previous": 1, "current": 1 } ], "mode": "structure", "comparison_version": "1.0.0" } }, "S12_compare_revisions_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "differences": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 }, "unmatched_previous": { "type": "array", "items": { "type": "integer" } }, "unmatched_current": { "type": "array", "items": { "type": "integer" } }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "differences", "unmatched_previous", "unmatched_current", "artifacts" ], "additionalProperties": false }, "S12_measure_calibrated_input": { "type": "object", "properties": { "page_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "coordinate_system": { "type": "string", "enum": [ "pdf_points" ] }, "bounds": { "type": "object", "properties": { "width": { "type": "number", "exclusiveMinimum": true, "minimum": 0, "maximum": 14400 }, "height": { "type": "number", "exclusiveMinimum": true, "minimum": 0, "maximum": 14400 } }, "required": [ "width", "height" ], "additionalProperties": false }, "calibration": { "type": "object", "properties": { "from": { "type": "object", "properties": { "x": { "type": "number", "minimum": 0 }, "y": { "type": "number", "minimum": 0 } }, "required": [ "x", "y" ], "additionalProperties": false }, "to": { "type": "object", "properties": { "x": { "type": "number", "minimum": 0 }, "y": { "type": "number", "minimum": 0 } }, "required": [ "x", "y" ], "additionalProperties": false }, "length": { "type": "number", "exclusiveMinimum": true, "minimum": 0, "maximum": 1000000000 }, "unit": { "type": "string", "enum": [ "mm", "cm", "m", "in", "ft" ] }, "provenance": { "type": "string", "minLength": 1, "maxLength": 500 } }, "required": [ "from", "to", "length", "unit", "provenance" ], "additionalProperties": false }, "kind": { "type": "string", "enum": [ "distance", "area" ] }, "points": { "type": "array", "items": { "type": "object", "properties": { "x": { "type": "number", "minimum": 0 }, "y": { "type": "number", "minimum": 0 } }, "required": [ "x", "y" ], "additionalProperties": false }, "minItems": 2, "maxItems": 100 } }, "required": [ "page_id", "coordinate_system", "bounds", "calibration", "kind", "points" ], "additionalProperties": false, "example": { "page_id": "page_1", "coordinate_system": "pdf_points", "bounds": { "width": 612, "height": 792 }, "calibration": { "from": { "x": 0, "y": 0 }, "to": { "x": 100, "y": 0 }, "length": 10, "unit": "m", "provenance": "Synthetic calibration supplied by operator" }, "kind": "distance", "points": [ { "x": 0, "y": 0 }, { "x": 30, "y": 40 } ] } }, "S12_measure_calibrated_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "value": { "type": "number" }, "unit": { "type": "string", "maxLength": 500 }, "scale": { "type": "number", "exclusiveMinimum": true, "minimum": 0 }, "calibration_provenance": { "type": "string", "maxLength": 500 }, "artifacts": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "media_type": { "type": "string", "maxLength": 500 }, "bytes": { "type": "integer", "minimum": 0 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "media_type", "bytes", "sha256" ], "additionalProperties": false }, "maxItems": 100 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "value", "unit", "scale", "calibration_provenance", "artifacts" ], "additionalProperties": false }, "S13_list_recipes_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "session_id" ], "additionalProperties": false, "example": { "session_id": "local_session" } }, "S13_list_recipes_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "recipes": { "type": "array", "items": { "type": "object", "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "enum": [ "null" ], "nullable": true } ] } }, "maxItems": 100000 } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "recipes" ], "additionalProperties": false }, "S13_preview_recipe_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "recipe_id": { "type": "string", "enum": [ "inspect_active_window", "focus_test_app", "test_app_sequence" ] }, "recipe_version": { "type": "string", "enum": [ "1.0.0" ] }, "executable_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "text": { "type": "string", "maxLength": 100 } }, "required": [ "session_id", "recipe_id", "recipe_version", "executable_hash" ], "additionalProperties": false, "example": { "session_id": "local_session", "recipe_id": "inspect_active_window", "recipe_version": "1.0.0", "executable_hash": "0000000000000000000000000000000000000000000000000000000000000000" } }, "S13_preview_recipe_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "action_digest": { "type": "string", "maxLength": 500 }, "steps": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "expires_at": { "type": "integer" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "action_digest", "steps", "expires_at" ], "additionalProperties": false }, "S13_execute_approved_recipe_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "preview_digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "approval_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "session_id", "preview_digest", "approval_id" ], "additionalProperties": false, "example": { "session_id": "local_session", "preview_digest": "0000000000000000000000000000000000000000000000000000000000000000", "approval_id": "local_approval" } }, "S13_execute_approved_recipe_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "resource_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "accepted", "delivered", "unknown", "completed", "stopped", "awaiting_approval" ] }, "effect_outcome": { "type": "string", "enum": [ "none", "completed", "unknown" ] }, "reconciliation_required": { "type": "boolean" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "resource_id", "state", "effect_outcome", "reconciliation_required" ], "additionalProperties": false }, "S13_stop_session_input": { "type": "object", "properties": { "session_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" } }, "required": [ "session_id" ], "additionalProperties": false, "example": { "session_id": "local_session" } }, "S13_stop_session_output": { "type": "object", "properties": { "execution_mode": { "type": "string", "enum": [ "reference", "provider", "simulation" ] }, "engine_version": { "type": "string", "maxLength": 500 }, "schema_version": { "type": "string", "enum": [ "1.0.0" ] }, "warnings": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "limitations": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 }, "coverage": { "type": "object", "properties": { "checked": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 }, "not_checked": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 200 } }, "required": [ "checked", "total", "not_checked" ], "additionalProperties": false }, "resource_id": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "state": { "type": "string", "enum": [ "accepted", "delivered", "unknown", "completed", "stopped", "awaiting_approval" ] }, "effect_outcome": { "type": "string", "enum": [ "none", "completed", "unknown" ] }, "reconciliation_required": { "type": "boolean" } }, "required": [ "execution_mode", "engine_version", "schema_version", "warnings", "limitations", "coverage", "resource_id", "state", "effect_outcome", "reconciliation_required" ], "additionalProperties": false }, "JobRequest": { "oneOf": [ { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S01" ] }, "operation": { "type": "string", "enum": [ "verify" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S01_verify_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S01" ] }, "operation": { "type": "string", "enum": [ "review" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S01_review_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S02" ] }, "operation": { "type": "string", "enum": [ "compare" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S02_compare_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S03" ] }, "operation": { "type": "string", "enum": [ "profile" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S03_profile_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S03" ] }, "operation": { "type": "string", "enum": [ "preview_recipe" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S03_preview_recipe_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S03" ] }, "operation": { "type": "string", "enum": [ "apply_recipe" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S03_apply_recipe_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S04" ] }, "operation": { "type": "string", "enum": [ "inspect_pdf" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S04_inspect_pdf_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S05" ] }, "operation": { "type": "string", "enum": [ "inspect" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S05_inspect_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S05" ] }, "operation": { "type": "string", "enum": [ "sanitize" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S05_sanitize_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S06" ] }, "operation": { "type": "string", "enum": [ "snapshot" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S06_snapshot_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S06" ] }, "operation": { "type": "string", "enum": [ "compare_snapshots" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S06_compare_snapshots_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S06" ] }, "operation": { "type": "string", "enum": [ "create_monitor" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S06_create_monitor_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S07" ] }, "operation": { "type": "string", "enum": [ "run_suite" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S07_run_suite_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S08" ] }, "operation": { "type": "string", "enum": [ "create_inbox" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S08_create_inbox_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S08" ] }, "operation": { "type": "string", "enum": [ "list_messages" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S08_list_messages_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S08" ] }, "operation": { "type": "string", "enum": [ "draft_message" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S08_draft_message_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S08" ] }, "operation": { "type": "string", "enum": [ "send_approved_message" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S08_send_approved_message_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S09" ] }, "operation": { "type": "string", "enum": [ "run_recipe" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S09_run_recipe_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S09" ] }, "operation": { "type": "string", "enum": [ "terminate_session" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S09_terminate_session_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S10" ] }, "operation": { "type": "string", "enum": [ "list_capabilities" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S10_list_capabilities_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S10" ] }, "operation": { "type": "string", "enum": [ "read" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S10_read_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S10" ] }, "operation": { "type": "string", "enum": [ "propose_action" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S10_propose_action_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S10" ] }, "operation": { "type": "string", "enum": [ "execute_approved_action" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S10_execute_approved_action_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S11" ] }, "operation": { "type": "string", "enum": [ "inspect_port" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S11_inspect_port_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S11" ] }, "operation": { "type": "string", "enum": [ "inspect_file_lock" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S11_inspect_file_lock_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S12" ] }, "operation": { "type": "string", "enum": [ "transform_pdf" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S12_transform_pdf_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S12" ] }, "operation": { "type": "string", "enum": [ "compare_revisions" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S12_compare_revisions_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S12" ] }, "operation": { "type": "string", "enum": [ "measure_calibrated" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S12_measure_calibrated_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S13" ] }, "operation": { "type": "string", "enum": [ "list_recipes" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S13_list_recipes_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S13" ] }, "operation": { "type": "string", "enum": [ "preview_recipe" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S13_preview_recipe_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S13" ] }, "operation": { "type": "string", "enum": [ "execute_approved_recipe" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S13_execute_approved_recipe_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false }, { "type": "object", "properties": { "service_id": { "type": "string", "enum": [ "S13" ] }, "operation": { "type": "string", "enum": [ "stop_session" ] }, "operation_version": { "type": "string", "enum": [ "1.0.0" ] }, "parameters": { "$ref": "#/components/schemas/S13_stop_session_input" }, "upload_ids": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_-]+$" }, "maxItems": 25, "default": [] }, "max_units": { "type": "integer", "minimum": 0, "maximum": 1000000 } }, "required": [ "service_id", "operation", "operation_version", "max_units" ], "additionalProperties": false } ] } } } }