@owlmeans/agent-common 0.1.18-rc.16 → 0.1.18-rc.18

package/README.md

@@ -46,7 +46,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.12
+npx @owlmeans/agent-skills@^0.1.18-rc.14
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/agent-common",
-  "version": "0.1.18-rc.16",
-  "generatedAt": "2026-09-04T22:43:25.435Z",
+  "version": "0.1.18-rc.18",
+  "generatedAt": "2026-09-10T23:12:07.502Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/agent-common/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agent-common
-description: "How to use @owlmeans/agent-common — runtime-free contracts for OwlMeans agents: conversation identity, the run-lifecycle flow, and the record shapes an application persists (conversation events, run state, memory nodes and events). Auto-invoked when importing agent record types, conversationFor, truncateAt, or the agent run flow."
+description: "How to use @owlmeans/agent-common — runtime-free contracts for OwlMeans agents: conversation identity, the run-lifecycle flow, the PIPELINE declaration (PipelineSpec, PipelineRun, validatePipelineSpec, orderPipelineSteps) and the record shapes an application persists. Auto-invoked when importing agent record types, a pipeline spec or run type, conversationFor, truncateAt, or the agent run flow."
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/agent-common
 
 **Layer:** Cross-cutting domain
-**Install:** `"@owlmeans/agent-common": "^0.1.18-rc.16"` in `dependencies`
+**Install:** `"@owlmeans/agent-common": "^0.1.18-rc.18"` in `dependencies`
 
 Serializable contracts for the agent family. No LangChain, no LangGraph, no storage driver — a
 backend or a browser bundle imports these to read what an agent wrote without pulling the runtime.
@@ -24,14 +24,18 @@ The runtime is `@owlmeans/agent`.
 | `agentRunFlow`, `AgentRunStep`, `AgentRunTransition`, `AGENT_RUN_FLOW` | The `@owlmeans/flow` lifecycle a run is driven through. |
 | `agentFlows` | Every flow this package declares, for a provider to serve. |
 | `ConversationEvent`, `ConversationEventInput` | One finished run, compacted: `summary` + `advice`. |
-| `AgentRunState` | Serialized flow plus the execution snapshot — the data plane of a run. |
 | `MemoryNode`, `MemoryEvent` (+ `MemoryEventInput`) | Agent-authored memory records. |
-| `AgentRunMessage` | What a transport carries; execution state travels by reference. |
+| `AgentRunMessage` | What a transport carries — a POINTER (`runId`, `conversationId`, optional `pipeline`/`step`), never state. |
+| `PipelineStepSpec`, `PipelineSpec` | The declaration: named steps, `after: string[]` edges, `optional`, `nonIdempotent`, `attempts`, `timeout`. |
+| `PipelineRun`, `PipelineRunStatus`, `PipelineProgress` | The persisted run row — `state` is JSON **text** plus `stateChars`; `completed`/`pending`/`warnings`; `heartbeatAt`. `PipelineRunStatus.Waiting` is a run parked on a question. |
+| `PipelineRunInquiry` · `INQUIRY_ANSWERS_KEY` | What a `Waiting` run is waiting for (`step`, `askedAt`, the `Inquiry`), and the one state key answers live under. |
+| `validatePipelineSpec`, `orderPipelineSteps`, `pipelineDescendants`, `pipelineStep` | Pure spec helpers — no runtime, no graph engine. |
 | `AGENTS_SERVICE` | The service alias — **`agents`**, plural. |
 | `AGENT_*_STORE` | Port names a consumer binds its storage under. |
 | `AgentRunStatus` | `ok` / `failed`, written on a conversation event. |
-| `AgentCommonError`, `AgentRunStateError` | The error family. |
+| `AgentCommonError`, `AgentRunStateError`, `PipelineSpecError`, `PipelineVersionError`, `PipelineUnknownStepError`, `PipelineNotIdempotentError`, `PipelineStateTooLargeError`, `PipelineNotResumableError` | The error family. |
 | `DEFAULT_SUMMARY_CHARS` (1200) · `DEFAULT_ADVICE_CHARS` (400) · `DEFAULT_EVENT_WINDOW` (3) · `DEFAULT_MEMORY_NODE_CHARS` (2000) · `DEFAULT_MEMORY_EVENTS_LIMIT` (50) | The caps the runtime's plugins default to. Override them per plugin; read them here rather than restating a number. |
+| `DEFAULT_MAX_STATE_CHARS` (256_000) · `DEFAULT_STEP_ATTEMPTS` (1) · `DEFAULT_STEP_TIMEOUT` (30 min) | Pipeline defaults. The state cap is a TRIPWIRE, not a budget. |
 
 ## Rules
 
@@ -43,11 +47,33 @@ at its own adapter boundary — that is the adapter's job, not the contract's.
 `agent`: a consuming application very often already has a service of its own called that, and a
 context accessor collision is silent — the second registration simply wins.
 
-**Flow steps are lifecycle stages, not conversational turns.** `FlowPayload` holds flat scalars only
-and a ReAct loop's turn count is unbounded, so the loop lives inside the `Working` step and only its
-counter travels in the payload. What the steps buy is knowing where an interrupted run resumes:
-`Working` from the last checkpoint, or `Finalizing` when the loop finished but the compaction never
-committed.
+**Flow steps are lifecycle stages, not conversational turns, and nothing RESUMES one.** `FlowPayload`
+holds flat scalars only and a ReAct loop's turn count is unbounded, so the loop lives inside the
+`Working` step and only its counter travels in the payload. What the steps buy is the ability to say
+how far a run got when it ended, which is what a plugin reads on `onFinish`. Resumable work is a
+PIPELINE — named steps, a state of scalars, side effects guarded per step. A ReAct run is not one:
+its state is an unbounded message list whose tool results are already applied to the world.
+
+**A `PipelineSpec` is a DECLARATION and this package holds no engine.** The steps' bodies, the graph,
+the checkpointer and the stores all live in `@owlmeans/agent`; what is here is what a browser bundle,
+a reconciler or an operator console must read to say where a run stands without importing LangGraph.
+That is also why `PipelineRun.state` is JSON **text** with a `stateChars` beside it rather than a
+subdocument: a run row crosses a `$jsonSchema`, and a state whose keys are dotted paths does not.
+
+**A `Waiting` run is stopped on purpose and is NOT stale.** It has no process behind it and its
+`heartbeatAt` will not move again until somebody answers `run.inquiry`, so anything that sweeps
+stale runs must exclude it — reading it as a crashed run repairs what is merely waiting. The row
+carries `inquiry` only while it waits, and the runner clears it on every entry: a row still
+advertising an answered question has every reader offer it again. A pipeline with no run store
+cannot wait at all, which is what `PipelineNotResumableError` says. See [[inquiry]].
+
+**`validatePipelineSpec` names EVERY fault at once** — unknown `after` targets, cycles, duplicate
+step names, `attempts > 1` on a `nonIdempotent` step. A spec is authored once and fixed once, and
+reporting faults one per build turns a five-minute edit into five builds.
+
+**A resume across a `version` change is REFUSED, never adapted.** `completed` names steps by string,
+so a spec that has since renamed, removed or reordered one would let a resumed run skip work it never
+did — silently, because an unknown name in `completed` matches nothing.
 
 **Each working step keeps exactly one non-explicit outgoing transition.** That is what lets
 `FlowModel.next()` give a driver an unambiguous answer without knowing the vocabulary. `Fail` is
@@ -62,8 +88,9 @@ than as prompt text.
 silently collapse every run of every subject into one thread.
 
 **Port names are exported; ports are not bound here.** An unbound port is not an error — the plugin
-that needs it degrades to a no-op, the way `ExecutionService.checkpoint` does with no plugin
-registered.
+that needs it degrades to a no-op. `AGENT_PIPELINE_RUN_STORE` is the one exception in spirit: a
+pipeline with no run store still runs, but it is not resumable, because the ROW is what a resume
+reads. `AGENT_CHECKPOINT_STORE` may be absent with no loss of correctness at all.
 
 ## Testing
 
@@ -73,6 +100,7 @@ every other consumer of that package is client-side.
 
 ## Related
 
+- [[inquiry]] — the human-in-the-loop primitive `Waiting` and `PipelineRunInquiry` belong to
 - [[agent]] — the runtime that writes these records
-- [[llm-common]] — `LlmPurpose` and `ExecutionState`, which `AgentRunState` carries
+- [[llm-common]] — `LlmPurpose` and `ExecutionState`, which a run's execution is built from
 - [[flow]] — the flow model the run lifecycle is declared against

package/build/consts.d.ts

@@ -15,9 +15,33 @@ export declare const AGENTS_SERVICE = "agents";
  * the same way `ExecutionService.checkpoint` does with no plugin registered.
  */
 export declare const AGENT_CONVERSATION_STORE = "agent-conversation-store";
-export declare const AGENT_RUN_STATE_STORE = "agent-run-state-store";
 export declare const AGENT_MEMORY_GRAPH_STORE = "agent-memory-graph-store";
 export declare const AGENT_MEMORY_EVENTS_STORE = "agent-memory-events-store";
+export declare const AGENT_PIPELINE_RUN_STORE = "agent-pipeline-run-store";
+export declare const AGENT_CHECKPOINT_STORE = "agent-checkpoint-store";
+/**
+ * Caps and defaults for a pipeline run.
+ *
+ * `DEFAULT_MAX_STATE_CHARS` is generous by the standard of what a state may legally hold — scalars
+ * and keys — and deliberately so: it is a TRIPWIRE, not a budget. A state approaching it is a state
+ * carrying an artifact, and the step fails so that fact is discovered on the first run rather than
+ * surviving as a row nobody can read back.
+ *
+ * `DEFAULT_STEP_ATTEMPTS` is 1 because retry budgets in this family multiply: an outer retry around
+ * a model's own inner retry is their product, not their sum.
+ */
+export declare const DEFAULT_MAX_STATE_CHARS = 256000;
+export declare const DEFAULT_STEP_ATTEMPTS = 1;
+export declare const DEFAULT_STEP_TIMEOUT = 1800000;
+/**
+ * Where a pipeline's answers live in its state.
+ *
+ * One key, named here rather than per pipeline, because an answer has to survive every hop it can
+ * take: a resume merges answers into it, a composing step forwards it to its child, and a reader
+ * looks a question up by id. Scalars and keys, like everything else a state holds — the answer's
+ * decision travels here and its prose belongs wherever that pipeline keeps its documents.
+ */
+export declare const INQUIRY_ANSWERS_KEY = "answers";
 /** The lifecycle flow every agent run is driven through. */
 export declare const AGENT_RUN_FLOW = "agent-run";
 /**
@@ -26,8 +50,12 @@ export declare const AGENT_RUN_FLOW = "agent-run";
  * These are recoverable LIFECYCLE stages, not conversational turns. A ReAct loop's turn count is
  * unbounded and its messages are not scalars, while `FlowPayload` holds flat scalars only — so the
  * loop lives inside `Working` and only its counter travels in the payload. What the steps buy is
- * the ability to say where a crashed run has to resume: at `Working` from the last checkpoint, or
- * at `Finalizing` when the loop finished but the compaction never committed.
+ * the ability to say how far a run got when it ended, which is what a plugin reads on `onFinish`.
+ *
+ * Nothing RESUMES one of these. A ReAct run is not a resumable unit: its state is an unbounded
+ * message list whose tool results are side effects already applied to the world, so re-entering it
+ * would re-apply them. Resumable work is a PIPELINE — see `pipeline.ts` — whose steps are named,
+ * whose state is scalars, and whose side effects are guarded per step.
  */
 export declare enum AgentRunStep {
     Received = "received",
@@ -43,8 +71,7 @@ export declare enum AgentRunTransition {
     Work = "work",
     Finalize = "finalize",
     Finish = "finish",
-    Fail = "fail",
-    Resume = "resume"
+    Fail = "fail"
 }
 /** How a run ended. Written on the conversation event so a reader can weigh the advice. */
 export declare enum AgentRunStatus {

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,qBAAqB,0BAA0B,CAAA;AAC5D,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,yBAAyB,8BAA8B,CAAA;AAEpE,4DAA4D;AAC5D,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC;;;;;;;;GAQG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,iDAAiD;AACjD,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;CAClB;AAED,2FAA2F;AAC3F,oBAAY,cAAc;IACxB,EAAE,OAAO;IACT,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAA;AACzC,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC,eAAO,MAAM,oBAAoB,IAAI,CAAA;AACrC,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAC7C,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,SAAS,MAAM,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,yBAAyB,8BAA8B,CAAA;AACpE,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,sBAAsB,2BAA2B,CAAA;AAE9D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,SAAU,CAAA;AAC9C,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,oBAAoB,UAAY,CAAA;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAA;AAE5C,4DAA4D;AAC5D,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC;;;;;;;;;;;;GAYG;AACH,oBAAY,YAAY;IACtB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,iDAAiD;AACjD,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,2FAA2F;AAC3F,oBAAY,cAAc;IACxB,EAAE,OAAO;IACT,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAA;AACzC,eAAO,MAAM,oBAAoB,MAAM,CAAA;AACvC,eAAO,MAAM,oBAAoB,IAAI,CAAA;AACrC,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAC7C,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAE7C,6EAA6E;AAC7E,eAAO,MAAM,SAAS,MAAM,CAAA"}

package/build/consts.js

@@ -15,9 +15,33 @@ export const AGENTS_SERVICE = 'agents';
  * the same way `ExecutionService.checkpoint` does with no plugin registered.
  */
 export const AGENT_CONVERSATION_STORE = 'agent-conversation-store';
-export const AGENT_RUN_STATE_STORE = 'agent-run-state-store';
 export const AGENT_MEMORY_GRAPH_STORE = 'agent-memory-graph-store';
 export const AGENT_MEMORY_EVENTS_STORE = 'agent-memory-events-store';
+export const AGENT_PIPELINE_RUN_STORE = 'agent-pipeline-run-store';
+export const AGENT_CHECKPOINT_STORE = 'agent-checkpoint-store';
+/**
+ * Caps and defaults for a pipeline run.
+ *
+ * `DEFAULT_MAX_STATE_CHARS` is generous by the standard of what a state may legally hold — scalars
+ * and keys — and deliberately so: it is a TRIPWIRE, not a budget. A state approaching it is a state
+ * carrying an artifact, and the step fails so that fact is discovered on the first run rather than
+ * surviving as a row nobody can read back.
+ *
+ * `DEFAULT_STEP_ATTEMPTS` is 1 because retry budgets in this family multiply: an outer retry around
+ * a model's own inner retry is their product, not their sum.
+ */
+export const DEFAULT_MAX_STATE_CHARS = 256_000;
+export const DEFAULT_STEP_ATTEMPTS = 1;
+export const DEFAULT_STEP_TIMEOUT = 1_800_000;
+/**
+ * Where a pipeline's answers live in its state.
+ *
+ * One key, named here rather than per pipeline, because an answer has to survive every hop it can
+ * take: a resume merges answers into it, a composing step forwards it to its child, and a reader
+ * looks a question up by id. Scalars and keys, like everything else a state holds — the answer's
+ * decision travels here and its prose belongs wherever that pipeline keeps its documents.
+ */
+export const INQUIRY_ANSWERS_KEY = 'answers';
 /** The lifecycle flow every agent run is driven through. */
 export const AGENT_RUN_FLOW = 'agent-run';
 /**
@@ -26,8 +50,12 @@ export const AGENT_RUN_FLOW = 'agent-run';
  * These are recoverable LIFECYCLE stages, not conversational turns. A ReAct loop's turn count is
  * unbounded and its messages are not scalars, while `FlowPayload` holds flat scalars only — so the
  * loop lives inside `Working` and only its counter travels in the payload. What the steps buy is
- * the ability to say where a crashed run has to resume: at `Working` from the last checkpoint, or
- * at `Finalizing` when the loop finished but the compaction never committed.
+ * the ability to say how far a run got when it ended, which is what a plugin reads on `onFinish`.
+ *
+ * Nothing RESUMES one of these. A ReAct run is not a resumable unit: its state is an unbounded
+ * message list whose tool results are side effects already applied to the world, so re-entering it
+ * would re-apply them. Resumable work is a PIPELINE — see `pipeline.ts` — whose steps are named,
+ * whose state is scalars, and whose side effects are guarded per step.
  */
 export var AgentRunStep;
 (function (AgentRunStep) {
@@ -46,7 +74,6 @@ export var AgentRunTransition;
     AgentRunTransition["Finalize"] = "finalize";
     AgentRunTransition["Finish"] = "finish";
     AgentRunTransition["Fail"] = "fail";
-    AgentRunTransition["Resume"] = "resume";
 })(AgentRunTransition || (AgentRunTransition = {}));
 /** How a run ended. Written on the conversation event so a reader can weigh the advice. */
 export var AgentRunStatus;

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAA;AAC5D,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAA;AAEpE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA;AAEzC;;;;;;;;GAQG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,mCAAmB,CAAA;IACnB,yCAAyB,CAAA;IACzB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED,iDAAiD;AACjD,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;IACjB,mCAAa,CAAA;IACb,uCAAiB,CAAA;AACnB,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAED,2FAA2F;AAC3F,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,2BAAS,CAAA;IACT,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AACrC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAA;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAA;AAE7C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAA"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAA;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,wBAAwB,CAAA;AAE9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAA;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAE5C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACtB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB,mCAAmB,CAAA;IACnB,yCAAyB,CAAA;IACzB,qCAAqB,CAAA;IACrB,iCAAiB,CAAA;AACnB,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED,iDAAiD;AACjD,MAAM,CAAN,IAAY,kBAMX;AAND,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,2CAAqB,CAAA;IACrB,uCAAiB,CAAA;IACjB,mCAAa,CAAA;AACf,CAAC,EANW,kBAAkB,KAAlB,kBAAkB,QAM7B;AAED,2FAA2F;AAC3F,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,2BAAS,CAAA;IACT,mCAAiB,CAAA;AACnB,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAA;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,CAAA;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AACrC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAA;AAC7C,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAA;AAE7C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAA"}

package/build/errors.d.ts

@@ -8,4 +8,64 @@ export declare class AgentRunStateError extends AgentCommonError {
     static typeName: string;
     constructor(message?: string);
 }
+/**
+ * A pipeline declaration is not runnable.
+ *
+ * Thrown by {@link import('./pipeline.js').validatePipelineSpec} and by the runner's own build
+ * step, and it always names EVERY fault it found rather than the first: a spec is authored once and
+ * fixed once, and reporting faults one per build turns a five-minute edit into five builds.
+ */
+export declare class PipelineSpecError extends AgentCommonError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * A resume was asked of a run started under a different version of its pipeline.
+ *
+ * Refused rather than adapted. `completed` names steps by string, so a spec that has since renamed,
+ * removed or reordered a step would have a resumed run skip work it never did — silently, because
+ * an unknown name in `completed` simply matches nothing.
+ */
+export declare class PipelineVersionError extends AgentCommonError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/** A resume, a progress report or a skip named a step the spec does not declare. */
+export declare class PipelineUnknownStepError extends AgentCommonError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * A resume was asked to re-enter a completed step whose side effect cannot be repeated.
+ *
+ * The caller may override with `force`, which is why this is an error and not a silent skip: an
+ * operator re-running a wipe, a purge or a hostname claim has to say so.
+ */
+export declare class PipelineNotIdempotentError extends AgentCommonError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * A step produced a state larger than the run row may carry.
+ *
+ * The step FAILS — the state is never truncated and the write is never skipped. A pipeline state is
+ * scalars and keys by contract; anything that overflows it is a large artifact that belongs in a
+ * store of its own, and silently dropping it would make a resume replay from a state that never
+ * existed.
+ */
+export declare class PipelineStateTooLargeError extends AgentCommonError {
+    static typeName: string;
+    constructor(message?: string);
+}
+/**
+ * A run was asked to wait for an answer it has no way of being given.
+ *
+ * Thrown when a step asks a question, nobody is there to answer it, and the pipeline has no run
+ * store: parking would leave nothing behind to resume, so the step fails at once rather than
+ * stopping a run that could never be started again.
+ */
+export declare class PipelineNotResumableError extends AgentCommonError {
+    static typeName: string;
+    constructor(message?: string);
+}
 //# sourceMappingURL=errors.d.ts.map

package/build/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAuB,QAAQ,EAAE,MAAM,CAAoC;IAE3E,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,qFAAqF;AACrF,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,OAAuB,QAAQ,EAAE,MAAM,CAAyC;IAEhF,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,OAAuB,QAAQ,EAAE,MAAM,CAAoC;IAE3E,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,qFAAqF;AACrF,qBAAa,kBAAmB,SAAQ,gBAAgB;IACtD,OAAuB,QAAQ,EAAE,MAAM,CAAyC;IAEhF,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,OAAuB,QAAQ,EAAE,MAAM,CAA6C;IAEpF,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;IACxD,OAAuB,QAAQ,EAAE,MAAM,CAAgD;IAEvF,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED,oFAAoF;AACpF,qBAAa,wBAAyB,SAAQ,gBAAgB;IAC5D,OAAuB,QAAQ,EAAE,MAAM,CAAoD;IAE3F,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;GAKG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,OAAuB,QAAQ,EAAE,MAAM,CAAsD;IAE7F,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,0BAA2B,SAAQ,gBAAgB;IAC9D,OAAuB,QAAQ,EAAE,MAAM,CAAsD;IAE7F,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF;AAED;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,OAAuB,QAAQ,EAAE,MAAM,CAAqD;IAE5F,YAAY,OAAO,GAAE,MAAgB,EAGpC;CACF"}

package/build/errors.js

@@ -13,6 +13,90 @@ export class AgentRunStateError extends AgentCommonError {
         this.type = AgentRunStateError.typeName;
     }
 }
+/**
+ * A pipeline declaration is not runnable.
+ *
+ * Thrown by {@link import('./pipeline.js').validatePipelineSpec} and by the runner's own build
+ * step, and it always names EVERY fault it found rather than the first: a spec is authored once and
+ * fixed once, and reporting faults one per build turns a five-minute edit into five builds.
+ */
+export class PipelineSpecError extends AgentCommonError {
+    static typeName = `PipelineSpec${AgentCommonError.typeName}`;
+    constructor(message = 'error') {
+        super(`pipeline-spec:${message}`);
+        this.type = PipelineSpecError.typeName;
+    }
+}
+/**
+ * A resume was asked of a run started under a different version of its pipeline.
+ *
+ * Refused rather than adapted. `completed` names steps by string, so a spec that has since renamed,
+ * removed or reordered a step would have a resumed run skip work it never did — silently, because
+ * an unknown name in `completed` simply matches nothing.
+ */
+export class PipelineVersionError extends AgentCommonError {
+    static typeName = `PipelineVersion${AgentCommonError.typeName}`;
+    constructor(message = 'error') {
+        super(`pipeline-version:${message}`);
+        this.type = PipelineVersionError.typeName;
+    }
+}
+/** A resume, a progress report or a skip named a step the spec does not declare. */
+export class PipelineUnknownStepError extends AgentCommonError {
+    static typeName = `PipelineUnknownStep${AgentCommonError.typeName}`;
+    constructor(message = 'error') {
+        super(`pipeline-step:${message}`);
+        this.type = PipelineUnknownStepError.typeName;
+    }
+}
+/**
+ * A resume was asked to re-enter a completed step whose side effect cannot be repeated.
+ *
+ * The caller may override with `force`, which is why this is an error and not a silent skip: an
+ * operator re-running a wipe, a purge or a hostname claim has to say so.
+ */
+export class PipelineNotIdempotentError extends AgentCommonError {
+    static typeName = `PipelineNotIdempotent${AgentCommonError.typeName}`;
+    constructor(message = 'error') {
+        super(`pipeline-idempotency:${message}`);
+        this.type = PipelineNotIdempotentError.typeName;
+    }
+}
+/**
+ * A step produced a state larger than the run row may carry.
+ *
+ * The step FAILS — the state is never truncated and the write is never skipped. A pipeline state is
+ * scalars and keys by contract; anything that overflows it is a large artifact that belongs in a
+ * store of its own, and silently dropping it would make a resume replay from a state that never
+ * existed.
+ */
+export class PipelineStateTooLargeError extends AgentCommonError {
+    static typeName = `PipelineStateTooLarge${AgentCommonError.typeName}`;
+    constructor(message = 'error') {
+        super(`pipeline-state:${message}`);
+        this.type = PipelineStateTooLargeError.typeName;
+    }
+}
+/**
+ * A run was asked to wait for an answer it has no way of being given.
+ *
+ * Thrown when a step asks a question, nobody is there to answer it, and the pipeline has no run
+ * store: parking would leave nothing behind to resume, so the step fails at once rather than
+ * stopping a run that could never be started again.
+ */
+export class PipelineNotResumableError extends AgentCommonError {
+    static typeName = `PipelineNotResumable${AgentCommonError.typeName}`;
+    constructor(message = 'error') {
+        super(`pipeline-not-resumable:${message}`);
+        this.type = PipelineNotResumableError.typeName;
+    }
+}
 ResilientError.registerErrorClass(AgentCommonError);
 ResilientError.registerErrorClass(AgentRunStateError);
+ResilientError.registerErrorClass(PipelineSpecError);
+ResilientError.registerErrorClass(PipelineVersionError);
+ResilientError.registerErrorClass(PipelineUnknownStepError);
+ResilientError.registerErrorClass(PipelineNotIdempotentError);
+ResilientError.registerErrorClass(PipelineStateTooLargeError);
+ResilientError.registerErrorClass(PipelineNotResumableError);
 //# sourceMappingURL=errors.js.map

package/build/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAC3C,MAAM,CAAU,QAAQ,GAAW,QAAQ,cAAc,CAAC,QAAQ,EAAE,CAAA;IAE3E,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC,CAAA;IACtD,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,kBAAmB,SAAQ,gBAAgB;IAC/C,MAAM,CAAU,QAAQ,GAAW,WAAW,gBAAgB,CAAC,QAAQ,EAAE,CAAA;IAEhF,YAAY,OAAO,GAAW,OAAO;QACnC,KAAK,CAAC,aAAa,OAAO,EAAE,CAAC,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAA;IACzC,CAAC;CACF;AAED,cAAc,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAA;AACnD,cAAc,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/build/flows.d.ts

@@ -3,9 +3,8 @@ import type { ShallowFlow } from '@owlmeans/flow';
  * The lifecycle of one agent run.
  *
  * Read it as "how far did this run get", not "what did it say". Everything conversational happens
- * inside `Working`; the steps exist so that a run interrupted anywhere can be told where to pick
- * up. `Fail` is reachable from every working step, and `Resume` re-enters `Working` from a
- * checkpoint.
+ * inside `Working`; the steps exist so a plugin reading `onFinish` can say where a run ended.
+ * `Fail` is reachable from every working step and is TERMINAL — see the note on that step.
  *
  * `service` is left as the flow name on every step. A flow step normally binds to a service or an
  * entrypoint, but an agent run is driven by whoever holds the model — there is no second party to

package/build/flows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../src/flows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,EAAE,WA8F1B,CAAA;AAED,iEAAiE;AACjE,eAAO,MAAM,UAAU,EAAE,WAAW,EAAmB,CAAA"}
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../src/flows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,EAAE,WA0F1B,CAAA;AAED,iEAAiE;AACjE,eAAO,MAAM,UAAU,EAAE,WAAW,EAAmB,CAAA"}

package/build/flows.js

@@ -3,9 +3,8 @@ import { AGENT_RUN_FLOW, AgentRunStep, AgentRunTransition } from './consts.js';
  * The lifecycle of one agent run.
  *
  * Read it as "how far did this run get", not "what did it say". Everything conversational happens
- * inside `Working`; the steps exist so that a run interrupted anywhere can be told where to pick
- * up. `Fail` is reachable from every working step, and `Resume` re-enters `Working` from a
- * checkpoint.
+ * inside `Working`; the steps exist so a plugin reading `onFinish` can say where a run ended.
+ * `Fail` is reachable from every working step and is TERMINAL — see the note on that step.
  *
  * `service` is left as the flow name on every step. A flow step normally binds to a service or an
  * entrypoint, but an agent run is driven by whoever holds the model — there is no second party to
@@ -95,13 +94,9 @@ export const agentRunFlow = {
             index: 5,
             step: AgentRunStep.Failed,
             service: AGENT_RUN_FLOW,
-            transitions: {
-                [AgentRunTransition.Resume]: {
-                    transition: AgentRunTransition.Resume,
-                    step: AgentRunStep.Working,
-                    explicit: true,
-                },
-            },
+            // Terminal. Nothing resumes a ReAct run — its tool results are side effects already applied
+            // to the world, so re-entering it re-applies them. Resumable work is a pipeline.
+            transitions: {},
         },
     },
 };

package/build/flows.js.map

@@ -1 +1 @@
-{"version":3,"file":"flows.js","sourceRoot":"","sources":["../src/flows.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../src/flows.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -1,6 +1,7 @@
 export * from './consts.js';
 export * from './errors.js';
 export type * from './types.js';
+export * from './pipeline.js';
 export * from './flows.js';
 export * from './helpers/conversation.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,2BAA2B,CAAA"}

package/build/index.js

@@ -1,5 +1,6 @@
 export * from './consts.js';
 export * from './errors.js';
+export * from './pipeline.js';
 export * from './flows.js';
 export * from './helpers/conversation.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAE3B,cAAc,YAAY,CAAA;AAC1B,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAE3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,2BAA2B,CAAA"}