Descriptors and DSL schemas¶
Generated from the architecture model
This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
| Descriptor | Version | Owner service | Schema file | Summary |
|---|---|---|---|---|
Execution scope (execution-scope-v1) |
1 | ControlPlaneApi | reference/schemas/execution-scope.schema.json |
Trusted tenant, project, caller, roles, source scope and policy context attached to every command, event and invocation. |
Run submission (run-submission-v1) |
1 | RunControlService | reference/schemas/run-submission.schema.json |
Body of POST /factory/runs; idempotent on Idempotency-Key within scope. |
Run accepted response (run-accepted-v1) |
1 | RunControlService | reference/schemas/run-submission.schema.json |
Response naming the pinned release, policy revision and snapshot (documented with the submission schema). |
Run view (run-view-v1) |
1 | RunControlService | reference/schemas/resolved-execution-snapshot.schema.json |
Read model of a run with steps, attempts, lease and approvals; fields follow the Run Control aggregates. |
Run list (run-list-v1) |
1 | RunControlService | reference/schemas/resolved-execution-snapshot.schema.json |
Paged list of runs in scope with state and freshness. |
Resolved execution snapshot (resolved-execution-snapshot-v1) |
1 | RunControlService | reference/schemas/resolved-execution-snapshot.schema.json |
Everything a run depends on, resolved at acceptance; immutable. |
Run event envelope (run-event-envelope-v1) |
1 | EnvelopeRegistryService | reference/schemas/run-event-envelope.schema.json |
ADR-0014 port-level envelope of every integration event. |
Run event stream item (run-event-v1) |
1 | RunControlService | reference/schemas/run-event-envelope.schema.json |
Server-streamed run and approval state change (WatchRun). |
Run reference (run-ref-v1) |
1 | RunControlService | reference/schemas/run-submission.schema.json |
Run id with scope for streaming subscriptions. |
Approval request (approval-request-v1) |
1 | RunControlService | reference/schemas/approval.schema.json |
Human decision bound to the exact proposal hash with authority, expiry and version. |
Approval decision (approval-decision-v1) |
1 | RunControlService | reference/schemas/approval.schema.json |
Approve, reject or request changes quoting the request version. |
Approval reference (approval-ref-v1) |
1 | RunControlService | reference/schemas/approval.schema.json |
Approval id and expiry returned to a worker that requested a decision. |
Approval list (approval-list-v1) |
1 | RunControlService | reference/schemas/approval.schema.json |
Pending and decided approval requests visible to the caller's roles. |
Acquire lease (acquire-lease-v1) |
1 | RunControlService | reference/schemas/attempt-outcome.schema.json |
Worker acquires or renews the lease of an attempt. |
Lease (lease-v1) |
1 | RunControlService | reference/schemas/attempt-outcome.schema.json |
Lease with fencing token and expiry. |
Attempt outcome (attempt-outcome-v1) |
1 | RunControlService | reference/schemas/attempt-outcome.schema.json |
Single outcome report per attempt with receipt hash and failure class. |
Acknowledgement (ack-v1) |
1 | RunControlService | reference/schemas/attempt-outcome.schema.json |
Accepted or conflict acknowledgement for a reported outcome. |
Tool invocation (tool-invocation-v1) |
1 | ToolAdapterService | reference/schemas/tool-invocation.schema.json |
Governed tool call request with scope, policy decision, side-effect class and idempotency key. |
Tool receipt (tool-receipt-v1) |
1 | ToolAdapterService | reference/schemas/tool-invocation.schema.json |
Effect receipt including uncertain outcomes and sanitized results. |
Model invocation (model-invocation-v1) |
1 | ModelRouterService | reference/schemas/model-invocation.schema.json |
Request naming a logical profile, classification and budget. |
Model receipt (model-receipt-v1) |
1 | ModelRouterService | reference/schemas/model-invocation.schema.json |
Actual route, usage status, policy receipt and validation per invocation. |
Usage reservation (usage-reservation-v1) |
1 | CostUsageService | reference/schemas/usage-record.schema.json |
Budget reservation taken before dispatch and settled afterwards. |
Usage record (usage-record-v1) |
1 | CostUsageService | reference/schemas/usage-record.schema.json |
Metered usage with pricing revision and reconciliation state. |
Policy decision (policy-decision-v1) |
1 | PolicyEngineService | reference/schemas/policy-decision.schema.json |
Record of one policy evaluation attached to receipts and approvals. |
Release manifest (release-manifest-v1) |
1 | AgentRegistryService | reference/schemas/release-manifest.schema.json |
Immutable dependency closure with hashes, evaluation verdict and signature. |
Context package (context-package-v1) |
1 | ContextBuilderService | reference/schemas/context-snapshot.schema.json |
Governed, ranked, budgeted context assembled for one attempt with provenance. |
Artifact (artifact-v1) |
1 | ArtifactService | reference/schemas/artifact.schema.json |
Content-addressed output metadata with lineage, validation and classification. |
Audit evidence (audit-evidence-v1) |
1 | AuditService | reference/schemas/audit-evidence.schema.json |
Append-only, redacted, chain-hashed record of governance-relevant actions. |
Agent task contract (agent-task-contract-v1) |
1 | AgentRuntimeService | reference/schemas/agent-task-contract.schema.json |
What an agent receives for one attempt: objective, inputs, allowed tools, limits, expected output. |
Change set (change-set-v1) |
1 | AgentRuntimeService | reference/schemas/change-set.schema.json |
Sandboxed change set with diff reference, build and test results. |
Pull request proposal (pull-request-proposal-v1) |
1 | AgentRuntimeService | reference/schemas/change-set.schema.json |
Proposal to open a PR bound to a change-set hash; shared-write action. |
Agent manifest (agent-manifest-v1) |
1 | AgentRegistryService | reference/schemas/asset-manifests.schema.json |
Authoring-time agent definition compiled into a release. |
Skill manifest (skill-manifest-v1) |
1 | AgentRegistryService | reference/schemas/asset-manifests.schema.json |
Authoring-time skill package definition. |
Tool descriptor (tool-descriptor-v1) |
1 | ToolAdapterService | reference/schemas/asset-manifests.schema.json |
Tool identity, schemas, side-effect class, authorization, limits, audit. |
Workflow definition (workflow-definition-v1) |
1 | WorkflowEngineService | reference/schemas/asset-manifests.schema.json |
Deterministic DAG with gates, retries, compensation and timers. |
Model profile (model-profile-v1) |
1 | ModelRouterService | reference/schemas/asset-manifests.schema.json |
Logical profile with capabilities, privacy class, providers, fallback, limits, evidence and license metadata. |
Blueprint common metadata (blueprint-common-v1) |
1 | BlueprintService | reference/schemas/blueprint-common.schema.json |
Metadata, personas, metrics, classification and side-effect class definitions shared by every blueprint kind (B1). |
Vision Blueprint descriptor (blueprint-vision-v1) |
1 | BlueprintService | reference/schemas/blueprint-vision.schema.json |
Descriptor document of the Vision Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Service Blueprint descriptor (blueprint-service-v1) |
1 | BlueprintService | reference/schemas/blueprint-service.schema.json |
Descriptor document of the Service Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Module Blueprint descriptor (blueprint-module-v1) |
1 | BlueprintService | reference/schemas/blueprint-module.schema.json |
Descriptor document of the Module Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Frontend Blueprint descriptor (blueprint-frontend-v1) |
1 | BlueprintService | reference/schemas/blueprint-frontend.schema.json |
Descriptor document of the Frontend Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Frontend Library Blueprint descriptor (blueprint-frontend-library-v1) |
1 | BlueprintService | reference/schemas/blueprint-frontend-library.schema.json |
Descriptor document of the Frontend Library Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Backend Library Blueprint descriptor (blueprint-backend-library-v1) |
1 | BlueprintService | reference/schemas/blueprint-backend-library.schema.json |
Descriptor document of the Backend Library Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Backend API Library Blueprint descriptor (blueprint-backend-api-library-v1) |
1 | BlueprintService | reference/schemas/blueprint-backend-api-library.schema.json |
Descriptor document of the Backend API Library Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
API Gateway Blueprint descriptor (blueprint-api-gateway-v1) |
1 | BlueprintService | reference/schemas/blueprint-api-gateway.schema.json |
Descriptor document of the API Gateway Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Database Blueprint descriptor (blueprint-database-v1) |
1 | BlueprintService | reference/schemas/blueprint-database.schema.json |
Descriptor document of the Database Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Security Blueprint descriptor (blueprint-security-v1) |
1 | BlueprintService | reference/schemas/blueprint-security.schema.json |
Descriptor document of the Security Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Pipeline Blueprint descriptor (blueprint-pipeline-v1) |
1 | BlueprintService | reference/schemas/blueprint-pipeline.schema.json |
Descriptor document of the Pipeline Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Observability Blueprint descriptor (blueprint-observability-v1) |
1 | BlueprintService | reference/schemas/blueprint-observability.schema.json |
Descriptor document of the Observability Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Integration Blueprint descriptor (blueprint-integration-v1) |
1 | BlueprintService | reference/schemas/blueprint-integration.schema.json |
Descriptor document of the Integration Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Infrastructure Blueprint descriptor (blueprint-infrastructure-v1) |
1 | BlueprintService | reference/schemas/blueprint-infrastructure.schema.json |
Descriptor document of the Infrastructure Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Documentation Blueprint descriptor (blueprint-documentation-v1) |
1 | BlueprintService | reference/schemas/blueprint-documentation.schema.json |
Descriptor document of the Documentation Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Localization Blueprint descriptor (blueprint-localization-v1) |
1 | BlueprintService | reference/schemas/blueprint-localization.schema.json |
Descriptor document of the Localization Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Mobile Blueprint descriptor (blueprint-mobile-v1) |
1 | BlueprintService | reference/schemas/blueprint-mobile.schema.json |
Descriptor document of the Mobile Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Test Blueprint descriptor (blueprint-test-v1) |
1 | BlueprintService | reference/schemas/blueprint-test.schema.json |
Descriptor document of the Test Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
User Experience Blueprint descriptor (blueprint-ux-v1) |
1 | BlueprintService | reference/schemas/blueprint-ux.schema.json |
Descriptor document of the User Experience Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Agent Microservice Standard Blueprint descriptor (blueprint-agent-microservice-v1) |
1 | BlueprintService | reference/schemas/blueprint-agent-microservice.schema.json |
Descriptor document of the Agent Microservice Standard Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
Agentic SaaS Product Blueprint descriptor (blueprint-agentic-saas-product-v1) |
1 | BlueprintService | reference/schemas/blueprint-agentic-saas-product.schema.json |
Descriptor document of the Agentic SaaS Product Blueprint kind; validated by BlueprintService (BC-02, design plan B1). |
SaaS Descriptor family descriptor (blueprint-saas-descriptor-v1) |
1 | BlueprintService | reference/schemas/blueprint-saas-descriptor.schema.json |
Descriptor document of the SaaS descriptor import kind (ADR-0025); validated by BlueprintService (BC-02, design plan B1). |