Glossary
Operator vocabulary first, with the substrate term beside it where one exists. Operator surfaces never show substrate vocabulary (I-28); this table is where the two meet.
| Operator term | Meaning | Substrate term / home |
|---|---|---|
| Solution | The sold package: one client, a set of Capabilities pinned to versions, per-client configuration. | SolutionRow (product) |
| Capability | A versioned, governed, invocable unit of value; what a customer invokes. | bound to one WorkflowDefinition per version |
| Capability Version | An immutable, content-hashed snapshot of a Capability's composition. | WorkflowDefinition + contentHash |
| Publication | The gate between authoring and execution; binds a Version to an environment with Evidence. | Workflow Pointer flip + CapabilityPublishCompleted |
| Activation | Moving the production pointer to a published Version; reversible. | WorkflowPointerFlip |
| Desk | A Capability archetype for professional work: routed shape, governance envelope, session operation model. | desk-<id> capability + DeskConfig |
| Skill | One reusable AI action bound to exactly one primitive; binds Prompt + Model + optional Knowledge. | compiles to one workflow node |
| Recipe | A reusable workflow composed of Skills. | — |
| Primitive | A platform-owned, closed set of action kinds a Skill can be (llm.generate, tool.invoke, …). |
node kind via the resolver |
| Component | A reusable, versioned authored object: Prompt or Knowledge. | CompositionComponent (Layer 2) |
| Prompt | Instruction text with declared inputs and a runtime version pointer. | PromptVersion + PromptPointer |
| Knowledge | A named corpus the platform retrieves from at run time. | KnowledgeSource / Document / DocumentVersion |
| Document | Operator-uploaded content under a Knowledge corpus; versioned per upload. | DocumentVersion, chunks, vectors |
| Grant | An explicit, ledgered permission for a Capability to retrieve from a platform-owned source. | KnowledgeGrant |
| Memory | What a relationship has learned over time; stated or inferred; erasable. | MemoryItem (@magpie/relationship-memory) |
| Run | The canonical fact of one Capability invocation. | WorkflowRun + WorkflowExecution rows |
| Action / Node Run | One executed step within a Run, with attempts, input snapshot, output, timing. | NodeRun; identity <runId>::<nodeId>::1 |
| Review | A pause for a human decision; an Action, not infrastructure. | ReviewRequest, HumanReview ledger row |
| Tool | A governed outward action (send email, fetch data). | ToolNode, ToolInvocation ledger row |
| Evaluation Case / Suite | A test input with expected outcomes; a bundle of cases certifying a Version. | EvalCase, EvalRunRef, S3 archive |
| Evidence | The content-hashed record of which tests ran against a Version and what they found. | evalRunRef on the publication ledger entry |
| Customer / Tenant | The client organisation; the isolation boundary. | tenantId on every row |
| Entitlement | A tenant's access to a specific Capability; independent of Subscription. | CapabilityEntitlement |
| Subscription | A tenant's commercial relationship; independent of Entitlement and of access state. | Stripe-backed |
| Credential | The Bearer identity a client's software presents to our API; hashed at rest; rotatable. | credentialId:secret |
| Cost | What a Run used, when, and what it cost at the rate in effect; append-only. | Cost Record (substrate; never surfaced raw) |
| History | What changed and who changed it. | the trust ledger (append-only) |
| Operation | A registered, governed unit of change: plan, dry-run, approve, execute, verify, ledger. | GovernedOperation (kernel) |
| Dry-run | The rendered plan of an Operation before anything is written; carries a plan hash. | DryRun envelope |
| Front Door | The public intake Solution on matterandgas.com. | front-door-* functions |
| Studio | The operator surface where Capabilities are built, tested, published and operated. | /admin/studio |
| Magpie | The workflow execution kernel and substrate; structurally hidden from operators. | @magpie/* |
| mag-composition | The component and capability definition layer; executes nothing. | @mag/* |
| Resolver | The only code that knows both layers; compiles a Capability into a workflow definition. | amplify/resolver/ |