Skip to content

Glossary

Terms used across Seams Pantry and the Lowerarchy commerce modules.

Glossary ​

AgentSessionActor ​

The durable actor that owns one agent's accepted history, checkpoints, turns, budget, and event stream inside a Case.

BakeryTask ​

One bakery operation in a production schedule or a native workcell run, such as a process step, a transfer, or a handoff. It belongs to bakery orchestration and is unrelated to a Case or a HarnessTask.

Case ​

The provider-neutral body of related work. A Case owns shared context, assignments, accepted proposals, and its durable output outbox.

CaseContextCollection ​

A record that relates selected evidence and Cases concerning the same matter, such as a purchase request, its supplier emails, and a delivery exception. It stores references and relationship metadata. Source owners keep the content, and linking evidence grants no access. OrganisationActor stores collections.

CaseContextDiscovery ​

The optional feature that finds permitted candidate evidence, evaluates whether it concerns the same matter, and proposes or attaches it to a CaseContextCollection. Connectors schedule it and OrganisationActor owns its configuration, evaluation records, and relationship review.

ConnectorActor ​

The durable actor that admits provider ingress, owns delivery and retry state, and settles provider receipts.

Conversation window ​

WhatsApp's provider grouping for one customer's active support exchange. It bounds when a reply may be sent. It is not a CaseContextCollection.

Commerce authority ​

The selected transactional system of record for an organisation's commerce facts, such as Seams Checkout or Shopify.

Commerce Read Layer ​

The rebuildable projections, commerce queries, search, and operational history of Pantry. Older plans call it Blotter.

Contracts ​

The shared commerce language and contract definitions implemented in packages/contracts. Older plans call this role Lexicon.

Harness ​

The route-selected agent runtime behind AgentSessionActor's common adapter. organisation_subscription + openai uses Pi with the organisation's ChatGPT sign-in. organisation_byo + openai uses Pi with the organisation's Vault-encrypted OpenAI API key. platform + openai-compatible uses Pi with Seams-funded OpenRouter access. A route stays fixed for its session and never falls back to another funding authority. Picocodex is retired.

HarnessTask ​

Work that an agent harness identifies or continues, carried by HarnessTaskId and HarnessTaskContinuation. It belongs to the harness and session components.

Organisation ​

The customer isolation scope. An Organisation owns membership, roles, shared configuration, credentials, budgets, and placement. OrganisationActor holds its organisation-wide state. Users, merchants, shops, workspaces, provider accounts, and Cases are separate concepts within it.

Punter ​

The independent buyer and acceptance harness in scripts/punter that exercises the system through supported storefront and commerce journeys.

Seams Pantry ​

The bakery operating system: governed operations for café and bakery production and commerce. Its product areas include Kitchen, Café, and Commerce.

Seams Checkout ​

The built-in commerce that people see: checkout pages, the QR order page, and the Register. The commerce engine in services/commerce runs it.

Sous Chef ​

The merchant-principal agent behavior: operating work through the Cases, tools, policies, and approvals of Pantry. Its instructions and skills live in services/platform/src/data/merchant-agent-skills.ts. Older plans call it Urk.

Workspace executor ​

The on-demand heavy execution boundary. It materializes an immutable workspace revision, returns artifacts and a validated changeset, and owns no durable commerce or Case state.