@eduardorenani/atlasjs 0.1.0-alpha.2 → 0.1.0-alpha.4

package/README.md

@@ -27,8 +27,7 @@ npm install @eduardorenani/atlasjs@alpha xstate
 A trivial agent with two modes: `listening` waits for a user message, `answering` calls an LLM and routes back to `listening`.
 
 ```ts
-import { createActor } from "xstate";
-import { defineMode, defineAgent } from "@eduardorenani/atlasjs";
+import { defineMode, defineAgent, startAgent } from "@eduardorenani/atlasjs";
 
 type Ctx = { question: string; answer: string };
 type Ev = { type: "ASK"; question: string };
@@ -79,19 +78,74 @@ const machine = defineAgent<
     modes: { listening, answering },
 });
 
-const actor = createActor(machine).start();
+const actor = startAgent<Ctx, Ev>(machine);
 actor.send({ type: "ASK", question: "What is a mode?" });
 ```
 
 `behavior` returns `{ outcome, payload }`. The route on `achieved` is the **only** way out of a successful run — there is no untyped escape hatch.
 
+`startAgent` is the runtime boundary: hosts never import from `xstate` directly. The returned actor exposes `send`, `stop`, and `getSnapshot` — nothing else from XState's surface leaks out.
+
+## Multi-turn agents (snapshot rehydration)
+
+For agents that span multiple turns, `actor.getSnapshot()` returns an opaque `AgentSnapshot<Ctx>` that round-trips through `JSON.stringify` / `JSON.parse`. Feed it back as `startAgent({ snapshot })` next turn and the agent resumes mid-conversation — including `local` slots declared on `defineCompoundMode`'s `context`.
+
+```ts
+async function runTurn(
+    text: string,
+    snapshot?: AgentSnapshot<Ctx>,
+): Promise<AgentSnapshot<Ctx>> {
+    let resolveReady: (() => void) | null = null;
+    const actor = startAgent<Ctx, Ev>(machine, {
+        snapshot,
+        inspect: (e) => {
+            // Atlas-vocabulary event. `from` / `to` are dot-joined mode paths
+            // (e.g. "socratic.teaching"). Phase 1 emits `transition` only.
+            if (e.to === "listening" && resolveReady) {
+                const r = resolveReady;
+                resolveReady = null;
+                r();
+            }
+        },
+    });
+    const ready = new Promise<void>((r) => { resolveReady = r; });
+    actor.send({ type: "ASK", question: text });
+    await ready;
+    const next = actor.getSnapshot();
+    actor.stop();
+    return next;
+}
+```
+
+The canonical multi-turn host is one `runTurn` call per incoming message: load the previous snapshot from storage, run one turn, persist the new snapshot. `examples/zoe/` ships this end-to-end with a file-backed session store. Contract details in [`docs/specs/009-snapshot-aware-rehydration.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/009-snapshot-aware-rehydration.md).
+
+### Fire-and-log via `onError`
+
+When a `behavior` rejects and **no** `routes.error` entry catches it (absent route, no matched `when`, or matched `target: RE_THROW`), the rejection escapes the machine. `startAgent({ onError })` is the host-side hook — it fires precisely when XState would otherwise raise an uncaught error. Intra-machine recovery (`routes.error: { target: <sibling> }`) is unchanged and the host observes only the recovery transition through `inspect`.
+
+```ts
+import { startAgent, type AgentErrorInfo } from "@eduardorenani/atlasjs";
+
+startAgent<Ctx, Ev>(machine, {
+    onError: (info: AgentErrorInfo<Ctx>) => {
+        // info.error      — raw rejection (unknown)
+        // info.modePath   — dot-joined leaf path, e.g. "socratic.teaching"
+        // info.context    — root context after any routes.error.assign ran
+        // info.snapshot   — AgentSnapshot pointing at the failed leaf
+        logger.error({ err: info.error, modePath: info.modePath, traceId }, "agent escape");
+    },
+});
+```
+
+`onError` is opt-in: when omitted, the wrapper makes no `subscribe` call and Node's default unhandled-rejection propagation applies (strictly additive — no migration). Full contract in [`docs/specs/010-error-channel.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/010-error-channel.md).
+
 ## The three constructors
 
 | Constructor          | Purpose                                                                   |
 | -------------------- | ------------------------------------------------------------------------- |
 | `defineMode`         | A leaf mode. Pass `{ input, behavior, routes }` for active, `{ on }` for passive. Mixing is a compile error. |
 | `defineCompoundMode` | A composite of nested modes. Routes to `END` to exit; the enclosing scope's `onDone` picks the destination. |
-| `defineAgent`        | The top-level entry. Compiles to an XState machine ready for `createActor`. |
+| `defineAgent`        | The top-level entry. Compiles to an XState machine; boot it with `startAgent`. |
 
 ## Concepts in 60 seconds
 
@@ -104,8 +158,8 @@ actor.send({ type: "ASK", question: "What is a mode?" });
 ## Where to go next
 
 - **API reference** — the type signatures and JSDoc in [`packages/atlas/src/types.ts`](https://github.com/EduardoRenani/atlas/blob/main/packages/atlas/src/types.ts) are the source of truth.
-- **Worked example** — [`examples/zoe/`](https://github.com/EduardoRenani/atlas/tree/main/examples/zoe) is a CLI agent that classifies user intent and dispatches across greetings / improvising / socratic modes.
-- **Specs** — the API contract lives in [`docs/specs/004-xstate-agent-wrapper.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/004-xstate-agent-wrapper.md), [`005-agent-deps-and-stringifiable-context.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/005-agent-deps-and-stringifiable-context.md), and [`006-modes-not-states.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/006-modes-not-states.md).
+- **Worked example** — [`examples/zoe/`](https://github.com/EduardoRenani/atlas/tree/main/examples/zoe) is a CLI agent that classifies user intent and dispatches across greetings / improvising / socratic modes, and persists every turn via file-backed snapshots.
+- **Specs** — the API contract lives in [`docs/specs/004-xstate-agent-wrapper.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/004-xstate-agent-wrapper.md), [`005-agent-deps-and-stringifiable-context.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/005-agent-deps-and-stringifiable-context.md), [`006-modes-not-states.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/006-modes-not-states.md), [`009-snapshot-aware-rehydration.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/009-snapshot-aware-rehydration.md) (the `startAgent` actor surface + multi-turn persistence contract), and [`010-error-channel.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/specs/010-error-channel.md) (the host-side `onError` channel).
 - **Design decisions** — [`docs/design-decisions.md`](https://github.com/EduardoRenani/atlas/blob/main/docs/design-decisions.md) records the "why" behind the four-outcome contract, goal-bound exits, and the modes-not-states vocabulary.
 
 ## License

package/dist/defineCompoundMode.d.ts

@@ -26,7 +26,10 @@ export type CompoundModeCarrier<TParentContext, TEvents extends {
  *
  * Children's effective context is `LocalContextOf<TParentContext, TCtx>`:
  * - With `context` supplied: `Pick<TParentContext, inherit[number]> & typeof local`.
- *   Inherited keys are live-mirrored; locals are reset on every entry.
+ *   Inherited keys are live-mirrored; locals are reset on every re-entry, but
+ *   **NOT** on snapshot restore — when an actor is rehydrated via
+ *   `startAgent({ snapshot })`, the persisted slot wins over the entry-reset
+ *   (spec 009 §Persistence Contract).
  * - Without `context`: children see the full `TParentContext`.
  *
  * Children route out of the compound via `END` (defined in `./types.ts`); the

package/dist/defineCompoundMode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineCompoundMode.d.ts","sourceRoot":"","sources":["../src/defineCompoundMode.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACR,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,CAC3B,cAAc,EACd,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,GAAG,OAAO,EAClB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,wBAAgB,kBAAkB,CAC9B,cAAc,EACd,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,IAAI,SACE,eAAe,CACb,cAAc,EACd,aAAa,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAO5C,MAAM,CACT,GACC,SAAS,EACf,MAAM,SAAS,QAAQ,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAC7E,QAAQ,GAAG,SAAS,EACpB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE7D,MAAM,EAAE,kBAAkB,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,GACnF,YAAY,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAMxD"}
+{"version":3,"file":"defineCompoundMode.d.ts","sourceRoot":"","sources":["../src/defineCompoundMode.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACR,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,QAAQ,EACX,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,mBAAmB,CAC3B,cAAc,EACd,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,GAAG,OAAO,EAClB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,wBAAgB,kBAAkB,CAC9B,cAAc,EACd,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,IAAI,SACE,eAAe,CACb,cAAc,EACd,aAAa,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,EAO5C,MAAM,CACT,GACC,SAAS,EACf,MAAM,SAAS,QAAQ,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAC7E,QAAQ,GAAG,SAAS,EACpB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE7D,MAAM,EAAE,kBAAkB,CAAC,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,GACnF,YAAY,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAMxD"}

package/dist/defineCompoundMode.js

@@ -22,7 +22,10 @@
  *
  * Children's effective context is `LocalContextOf<TParentContext, TCtx>`:
  * - With `context` supplied: `Pick<TParentContext, inherit[number]> & typeof local`.
- *   Inherited keys are live-mirrored; locals are reset on every entry.
+ *   Inherited keys are live-mirrored; locals are reset on every re-entry, but
+ *   **NOT** on snapshot restore — when an actor is rehydrated via
+ *   `startAgent({ snapshot })`, the persisted slot wins over the entry-reset
+ *   (spec 009 §Persistence Contract).
  * - Without `context`: children see the full `TParentContext`.
  *
  * Children route out of the compound via `END` (defined in `./types.ts`); the

package/dist/defineCompoundMode.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineCompoundMode.js","sourceRoot":"","sources":["../src/defineCompoundMode.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,qEAAqE;AACrE,wFAAwF;AACxF,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,4EAA4E;AAC5E,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,+DAA+D;AAC/D,+EAA+E;AAkC/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,MAAM,UAAU,kBAAkB,CAoB9B,MAAkF;IAElF,MAAM,OAAO,GAAkE;QAC3E,MAAM,EAAE,UAAU;QAClB,MAAM;KACT,CAAC;IACF,OAAO,OAA4E,CAAC;AACxF,CAAC"}
+{"version":3,"file":"defineCompoundMode.js","sourceRoot":"","sources":["../src/defineCompoundMode.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,qEAAqE;AACrE,wFAAwF;AACxF,oEAAoE;AACpE,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,4EAA4E;AAC5E,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,+DAA+D;AAC/D,+EAA+E;AAkC/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,MAAM,UAAU,kBAAkB,CAoB9B,MAAkF;IAElF,MAAM,OAAO,GAAkE;QAC3E,MAAM,EAAE,UAAU;QAClB,MAAM;KACT,CAAC;IACF,OAAO,OAA4E,CAAC;AACxF,CAAC"}

package/dist/formatModePath.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Walk XState's nested mode-value shape and return a dot-joined Atlas
+ * mode-path. Strings pass through unchanged. Nested objects representing a
+ * compound's active substate are recursed into. Parallel regions (an object
+ * with more than one key) are not produced by Atlas's lowering, so we treat
+ * them as a wrapper invariant violation and throw.
+ *
+ * @param value  Either a leaf-mode name (`string`) or a nested compound
+ *               value (`{ [parent]: childValue }`).
+ * @returns      A dot-joined path, e.g. `"socratic.teaching"` or
+ *               `"listening"`.
+ * @throws       If `value` is an object with more than one key — Atlas does
+ *               not currently lower to XState parallel regions, so this
+ *               indicates either a future change or a bug.
+ */
+export declare function formatModePath(value: unknown): string;
+//# sourceMappingURL=formatModePath.d.ts.map

package/dist/formatModePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatModePath.d.ts","sourceRoot":"","sources":["../src/formatModePath.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAerD"}

package/dist/formatModePath.js

@@ -0,0 +1,42 @@
+// `formatModePath` — render XState's nested `value` shape as an Atlas-
+// vocabulary mode-path string.
+//
+// Spec: docs/specs/009-snapshot-aware-rehydration.md §`AgentInspectionEvent`
+//        + §Clarification 6 (dot-only separator; throw on parallel regions).
+//
+// Lifted from the inline `formatStateValue` that used to live in
+// `examples/zoe/src/machine.ts:42-50`, with one defensive change: Atlas does
+// not lower to parallel regions, so a value with more than one key here is
+// a wrapper invariant violation and we throw instead of joining with `, `.
+/**
+ * Walk XState's nested mode-value shape and return a dot-joined Atlas
+ * mode-path. Strings pass through unchanged. Nested objects representing a
+ * compound's active substate are recursed into. Parallel regions (an object
+ * with more than one key) are not produced by Atlas's lowering, so we treat
+ * them as a wrapper invariant violation and throw.
+ *
+ * @param value  Either a leaf-mode name (`string`) or a nested compound
+ *               value (`{ [parent]: childValue }`).
+ * @returns      A dot-joined path, e.g. `"socratic.teaching"` or
+ *               `"listening"`.
+ * @throws       If `value` is an object with more than one key — Atlas does
+ *               not currently lower to XState parallel regions, so this
+ *               indicates either a future change or a bug.
+ */
+export function formatModePath(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value !== "object" || value === null) {
+        return String(value);
+    }
+    const entries = Object.entries(value);
+    if (entries.length !== 1) {
+        throw new Error(`formatModePath: Atlas does not lower to parallel regions; ` +
+            `got value with ${entries.length} keys (${entries.map(([k]) => k).join(", ")})`);
+    }
+    const entry = entries[0];
+    if (entry === undefined)
+        return "";
+    return `${entry[0]}.${formatModePath(entry[1])}`;
+}
+//# sourceMappingURL=formatModePath.js.map

package/dist/formatModePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatModePath.js","sourceRoot":"","sources":["../src/formatModePath.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,+BAA+B;AAC/B,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,EAAE;AACF,iEAAiE;AACjE,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAE3E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACX,4DAA4D;YACxD,kBAAkB,OAAO,CAAC,MAAM,UAAU,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtF,CAAC;IACN,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { defineMode } from "./defineMode.js";
 export { defineCompoundMode } from "./defineCompoundMode.js";
 export { defineAgent } from "./defineAgent.js";
+export { startAgent } from "./startAgent.js";
 export { END, RE_THROW } from "./types.js";
-export type { ModeOutput, Outcome, Mode, CompoundMode, ModeConfig, ActiveModeConfig, PassiveModeConfig, CompoundModeConfig, AgentConfig, ModesMap, CompoundContext, Routes, RouteList, RouteTarget, ErrorRouteTarget, EventHandlers, JsonPrimitive, JsonValue, JsonObject, JsonArray, JsonCompatible, } from "./types.js";
+export type { ModeOutput, Outcome, Mode, CompoundMode, ModeConfig, ActiveModeConfig, PassiveModeConfig, CompoundModeConfig, AgentConfig, ModesMap, CompoundContext, Routes, RouteList, RouteTarget, ErrorRouteTarget, EventHandlers, JsonPrimitive, JsonValue, JsonObject, JsonArray, JsonCompatible, AgentActor, AgentSnapshot, AgentInspectionEvent, AgentErrorInfo, StartAgentOptions, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACR,UAAU,EACV,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,eAAe,EACf,MAAM,EACN,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACR,UAAU,EACV,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,QAAQ,EACR,eAAe,EACf,MAAM,EACN,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,SAAS,EACT,UAAU,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,iBAAiB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -2,9 +2,11 @@
 //
 // Spec: docs/specs/004-xstate-agent-wrapper.md
 //       docs/specs/005-agent-deps-and-stringifiable-context.md
+//       docs/specs/009-snapshot-aware-rehydration.md
 // Tasks: docs/specs/004-tasks.md
 export { defineMode } from "./defineMode.js";
 export { defineCompoundMode } from "./defineCompoundMode.js";
 export { defineAgent } from "./defineAgent.js";
+export { startAgent } from "./startAgent.js";
 export { END, RE_THROW } from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,+CAA+C;AAC/C,+DAA+D;AAC/D,iCAAiC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,+CAA+C;AAC/C,+DAA+D;AAC/D,qDAAqD;AACrD,iCAAiC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/startAgent.d.ts

@@ -0,0 +1,23 @@
+import { type AnyStateMachine } from "xstate";
+import type { AgentActor, StartAgentOptions } from "./types.js";
+/**
+ * Boot an Atlas agent. Wraps `createActor(...).start()` under the hood.
+ *
+ * - When `options.snapshot` is provided, the actor is rehydrated from that
+ *   snapshot. XState v5 does NOT re-run `entry` actions on a restored state,
+ *   so compound-`local` slots in the snapshot survive (spec 009
+ *   §Persistence Contract).
+ * - When `options.inspect` is provided, it receives Atlas-vocabulary
+ *   events. Phase 1 emits only `transition`.
+ *
+ * The returned `AgentActor` is auto-started. Call `.stop()` to dispose.
+ *
+ * @template TContext  The agent's root context shape. Must match the shape
+ *                     the machine was declared with — `AgentSnapshot<TContext>`
+ *                     refuses cross-context restores at the type level.
+ * @template TEvents   The agent's full event union. Used to type `send`.
+ */
+export declare function startAgent<TContext, TEvents extends {
+    type: string;
+}>(agent: AnyStateMachine, options?: StartAgentOptions<TContext>): AgentActor<TContext, TEvents>;
+//# sourceMappingURL=startAgent.d.ts.map

package/dist/startAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startAgent.d.ts","sourceRoot":"","sources":["../src/startAgent.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAe,KAAK,eAAe,EAAuC,MAAM,QAAQ,CAAC;AAGhG,OAAO,KAAK,EACR,UAAU,EAEV,iBAAiB,EACpB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GACtC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAsE/B"}

package/dist/startAgent.js

@@ -0,0 +1,108 @@
+// `startAgent` — boot an Atlas agent.
+//
+// Spec: docs/specs/009-snapshot-aware-rehydration.md
+//        §`startAgent` + §Persistence Contract + §Mapping
+//       docs/specs/010-error-channel.md
+//        §Public API Changes + §Behavior Contract + §Mapping
+//
+// Wraps XState's `createActor(...).start()` so:
+//   1. A persisted `AgentSnapshot` survives compound-`local` reset on entry
+//      (spec 009 / issue #15).
+//   2. Hosts no longer import from `xstate` directly (spec 009 / issue #12).
+//   3. Rejections that escape the machine's declarative recovery
+//      (`routes.error`) surface to a typed host callback via
+//      `options.onError`, instead of becoming uncaught process-level errors
+//      (spec 010 / P14).
+//
+// This file is the ONLY place inside `packages/atlas/src` allowed to import
+// `createActor`. The wrapper hides it; nothing else in user code or in the
+// examples references XState's runtime API.
+import { createActor } from "xstate";
+import { formatModePath } from "./formatModePath.js";
+const ATLAS_SNAPSHOT_VERSION = "1";
+/**
+ * Boot an Atlas agent. Wraps `createActor(...).start()` under the hood.
+ *
+ * - When `options.snapshot` is provided, the actor is rehydrated from that
+ *   snapshot. XState v5 does NOT re-run `entry` actions on a restored state,
+ *   so compound-`local` slots in the snapshot survive (spec 009
+ *   §Persistence Contract).
+ * - When `options.inspect` is provided, it receives Atlas-vocabulary
+ *   events. Phase 1 emits only `transition`.
+ *
+ * The returned `AgentActor` is auto-started. Call `.stop()` to dispose.
+ *
+ * @template TContext  The agent's root context shape. Must match the shape
+ *                     the machine was declared with — `AgentSnapshot<TContext>`
+ *                     refuses cross-context restores at the type level.
+ * @template TEvents   The agent's full event union. Used to type `send`.
+ */
+export function startAgent(agent, options) {
+    let previousPath;
+    const userInspect = options?.inspect;
+    const userOnError = options?.onError;
+    const xstateActor = createActor(agent, {
+        snapshot: options?.snapshot?.persisted,
+        inspect: userInspect
+            ? (raw) => {
+                if (raw.type !== "@xstate.snapshot")
+                    return;
+                // Filter foreign actors. The closure captures `xstateActor`
+                // by reference; sound even though the variable is referenced
+                // inside its own initializer — the inspect callback fires
+                // only on subsequent updates.
+                if (raw.actorRef !== xstateActor)
+                    return;
+                const snap = raw.snapshot;
+                const next = formatModePath(snap.value);
+                if (next === previousPath)
+                    return;
+                const from = previousPath ?? "(init)";
+                previousPath = next;
+                userInspect({
+                    type: "transition",
+                    from,
+                    to: next,
+                    context: snap.context,
+                });
+            }
+            : undefined,
+    });
+    // Spec 010 §Behavior Contract: subscribe ONLY when `onError` is provided.
+    // When omitted, no subscribe call is made — XState's default propagation
+    // is preserved (the strict additive guarantee).
+    if (userOnError !== undefined) {
+        xstateActor.subscribe({
+            error: (rawError) => {
+                // Spec 010 §Snapshot-at-error semantics: read the actor's
+                // current snapshot synchronously inside the error subscriber.
+                // xstate@5.31.1 keeps `value` and `context` populated at this
+                // point (the failed leaf is still in `value`).
+                const live = xstateActor.getSnapshot();
+                userOnError({
+                    error: rawError,
+                    modePath: formatModePath(live.value),
+                    context: live.context,
+                    snapshot: buildAgentSnapshot(xstateActor.getPersistedSnapshot()),
+                });
+            },
+        });
+    }
+    xstateActor.start();
+    return {
+        send: (event) => {
+            xstateActor.send(event);
+        },
+        stop: () => {
+            xstateActor.stop();
+        },
+        getSnapshot: () => buildAgentSnapshot(xstateActor.getPersistedSnapshot()),
+    };
+}
+function buildAgentSnapshot(persisted) {
+    return {
+        atlasVersion: ATLAS_SNAPSHOT_VERSION,
+        persisted,
+    };
+}
+//# sourceMappingURL=startAgent.js.map

package/dist/startAgent.js.map

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

package/dist/types.d.ts

@@ -478,9 +478,11 @@ export type ModesMap<TContext, TEvents extends {
  *   **live-mirrored** into this compound. Keys NOT in `inherit` are invisible
  *   to children at the type level.
  * - **`local`** — own variables declared at this compound. Initialized on
- *   entry and **reset on re-entry** (DD-018). Constrained to
- *   `JsonCompatible<TLocal>` because the slot is persisted as part of the
- *   root context.
+ *   entry and **reset on re-entry** (DD-018), but **NOT** reset on snapshot
+ *   restore: when an actor is rehydrated via `startAgent({ snapshot })`,
+ *   the persisted slot wins over the entry-reset (spec 009 §Persistence
+ *   Contract). Constrained to `JsonCompatible<TLocal>` so the slot is
+ *   JSON-safe — required for snapshot serialization.
  *
  * Children see `Pick<TParent, inherit[number]> & typeof local` as their
  * context.
@@ -591,5 +593,93 @@ export type AgentConfig<TContext, TEvents extends {
     }) => Partial<TContext>>>;
     modes: TModes;
 };
+/**
+ * Atlas-vocabulary observation event. Phase 1 emits only `transition`.
+ *
+ * - `from` / `to` are mode-paths formatted by `formatModePath` (dot-joined,
+ *   parent first). Hosts no longer parse XState's nested `snapshot.value`
+ *   shape directly.
+ * - `context` is the root `TContext` AFTER the transition's assigns have
+ *   run.
+ */
+export type AgentInspectionEvent<TContext> = {
+    type: "transition";
+    from: string;
+    to: string;
+    context: TContext;
+};
+declare const agentSnapshotBrand: unique symbol;
+/**
+ * Opaque persisted agent state. Returned by `actor.getSnapshot()`; fed back
+ * to `startAgent({ snapshot })` next turn. The `TContext` parameter is brand-
+ * only (phantom) — used so a snapshot from agent A cannot be passed to
+ * `startAgent` for an agent whose `TContext` shape differs.
+ *
+ * Treat the value as opaque: persist `JSON.stringify(snapshot)` and restore
+ * with `JSON.parse` at the storage boundary.
+ */
+export type AgentSnapshot<TContext> = {
+    readonly atlasVersion: string;
+    readonly persisted: unknown;
+    readonly [agentSnapshotBrand]?: (_: TContext) => TContext;
+};
+/**
+ * Started Atlas actor. Auto-started by `startAgent`; call `stop()` to
+ * dispose. Use `inspect` at construction time for observation; build any
+ * readiness gates the host needs from that callback.
+ */
+export type AgentActor<TContext, TEvents extends {
+    type: string;
+}> = {
+    send: (event: TEvents) => void;
+    stop: () => void;
+    getSnapshot: () => AgentSnapshot<TContext>;
+};
+/**
+ * Payload delivered to `StartAgentOptions.onError` when a rejection escapes
+ * the machine — i.e. `behavior` rejected and either `routes.error` was
+ * absent, no `routes.error` entry's `when` matched, or a matched entry
+ * targeted `RE_THROW`. See spec 010 §Behavior Contract.
+ *
+ * - `error` — the raw rejection value. Typed as `unknown` because
+ *   `behavior` is a user-controlled `async` function whose rejection value
+ *   can be anything; narrowing is the host's job.
+ * - `modePath` — dot-joined path of the leaf whose `behavior` rejected,
+ *   formatted by the same `formatModePath` used by `inspect.transition`.
+ * - `context` — root context at the moment the rejection became fatal
+ *   (i.e. after any matched `routes.error.assign` ran).
+ * - `snapshot` — the agent snapshot at the moment of error, suitable for
+ *   persistence. Captured synchronously inside the error subscriber, before
+ *   the actor's terminal state is observable to `send`. Feeding it to a
+ *   fresh `startAgent({ snapshot })` re-enters the failed leaf — hosts
+ *   that want to "fire-and-log and keep listening" persist the *prior*
+ *   turn's snapshot instead (spec 010 §Recommended host pattern).
+ */
+export type AgentErrorInfo<TContext> = {
+    error: unknown;
+    modePath: string;
+    context: TContext;
+    snapshot: AgentSnapshot<TContext>;
+};
+/**
+ * Options accepted by `startAgent`.
+ *
+ * - `snapshot` — persisted state from a previous turn. When omitted, the
+ *   machine boots into its `initial` state. When present, the persisted
+ *   slot for every compound `local` survives `entry`-reset (spec 009
+ *   §Persistence Contract).
+ * - `inspect` — construction-time callback receiving Atlas-vocabulary
+ *   events. Phase 1 emits only `transition`.
+ * - `onError` — construction-time callback fired when a rejection escapes
+ *   the machine's declarative recovery (`routes.error`). Strictly
+ *   additive: when omitted, the wrapper makes no `subscribe` call and
+ *   current Node `unhandledRejection` propagation is preserved
+ *   (spec 010 §Behavior Contract).
+ */
+export type StartAgentOptions<TContext> = {
+    snapshot?: AgentSnapshot<TContext>;
+    inspect?: (event: AgentInspectionEvent<TContext>) => void;
+    onError?: (info: AgentErrorInfo<TContext>) => void;
+};
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,GAAG,CAAC,GAC3B,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACnE,CAAC,SAAS,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,KAAK,GACtE,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,KAAK,GAC/C,CAAC,SAAS,MAAM,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC3D,KAAK,CAAC;AAIV;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,CAAC,QAAQ,GAAG,OAAO,IAAI;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC;CACrB,CAAC;AAIF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,GAAG,EAAE,OAAO,MAA4B,CAAC;AACtD,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,QAAQ,EAAE,OAAO,MAAiC,CAAC;AAChE,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC;AAIvC;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,GAAG,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC;AAIvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,SAAS,CACjB,QAAQ,EACR,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/F,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,UAAU,CAClB,QAAQ,EACR,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC/F,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,CAClB,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC5F,CAAC;AAIF;;;;;;GAMG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAChD,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;CAAE,GAC1C,CAAC,CAAC;AAER;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAExC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IACjB,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GACpB,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAInE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,MAAM,CACd,QAAQ,EACR,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,QAAQ,EACF,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,KAAK,EACC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,GACrC,SAAS,EAAE,GACX,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACvD,SAAS,EACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,EACA,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC3B,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,cAAc,CACtB,QAAQ,EACR,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,QAAQ,EACF,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,SAAS,EACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,EACA,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC3B,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;CAChD,CAAC;AAIF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,eAAe,CACvB,QAAQ,EACR,aAAa,EACb,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACrC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC;CACvF,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,CACrB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;KACC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EACjB,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,KAAK,CAAC,GAC/D,SAAS,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,EAAE,KAAK,CAAC,EAAE;CACnF,CAAC;AAIF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,gBAAgB,CACxB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,KAAK,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC;IAC7D,QAAQ,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnF,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,CACzB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,EAAE,EAAE,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,CAClB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,EACR,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAE3D,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,GACpD,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAQlD,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAC;AACzC,OAAO,CAAC,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,IAAI,CACjB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,GAAG,OAAO,EAClB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAE7D,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE;QACrB,OAAO,EAAE,QAAQ,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,QAAQ,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY,CACzB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,QAAQ,GAAG,OAAO,EAClB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAE7D,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QACzB,OAAO,EAAE,QAAQ,CAAC;QAClB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,EAAE,QAAQ,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;CAClD;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,QAAQ,CAChB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D,QAAQ,CAAC,MAAM,CACf,MAAM,EACJ,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,GACvC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CACpD,CAAC,CAAC;AAIH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,eAAe,CACvB,OAAO,EACP,QAAQ,SAAS,aAAa,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,EACtD,MAAM,IACN;IACA,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,EAAE,IAAI,IACpC,IAAI,SAAS,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACjD,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,GAC5C,OAAO,CAAC;AAIlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,kBAAkB,CAC1B,cAAc,EACd,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAKhC,IAAI,SACE;IACE,OAAO,EAAE,aAAa,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC;IACtD,KAAK,EAAE,MAAM,CAAC;CACjB,GACC,SAAS,EACf,MAAM,SAAS,QAAQ,CAAC,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAC7E,QAAQ,GAAG,SAAS,EACpB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QACZ,OAAO,EAAE,cAAc,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,EAAE,KAAK,CAAC;KACf,KAAK,QAAQ,CAAC;IACf,MAAM,EAAE,cAAc,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;CAC3D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,WAAW,CACnB,QAAQ,EACR,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChC,MAAM,SAAS,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,EACjD,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAC7D;IACA,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;IAO/B,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CACrB,MAAM,EACN,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAClF,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,CAAC,QAAQ,IAAI;IACzC,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,QAAQ,CAAC;CAC7D,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,QAAQ,EAAE,OAAO,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,IAAI;IACjE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,cAAc,CAAC,QAAQ,IAAI;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,CAAC,QAAQ,IAAI;IACtC,QAAQ,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAC1D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;CACtD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@eduardorenani/atlasjs",
-    "version": "0.1.0-alpha.2",
+    "version": "0.1.0-alpha.4",
     "description": "Mode-based agent orchestration on top of XState v5. Typed modes, four-outcome contract, goal-bound exits.",
     "type": "module",
     "main": "./dist/index.js",