experimental-ash 0.2.0-alpha.21 → 0.2.0-alpha.23

package/dist/src/execution/step-context.js

@@ -1,54 +0,0 @@
-import { isDeepStrictEqual } from "node:util";
-import { hydrateDurableContext } from "../context/durable-context.js";
-import { AuthKey, ChannelKey } from "../context/keys.js";
-import { runStep } from "../context/run-step.js";
-import { deserializeRuntimeContext } from "../context/serialize.js";
-import { seedPendingInputRequestsContext } from "../harness/input-requests.js";
-export async function prepareStepContext(input) {
-    const ctx = await deserializeRuntimeContext(input.serializedRuntimeContext);
-    await hydrateDurableContext(ctx, input.session);
-    seedPendingInputRequestsContext(ctx, input.session);
-    if (input.delivery?.auth !== undefined) {
-        ctx.set(AuthKey, input.delivery.auth ?? null);
-    }
-    const channel = ctx.get(ChannelKey);
-    const channelStateSnapshot = channel.serialize();
-    const resolved = input.delivery !== undefined ? await channel.onDeliver(ctx, input.delivery.payload) : undefined;
-    assertChannelStateIsStable({
-        channel,
-        phase: "onDeliver",
-        serializedState: channelStateSnapshot,
-    });
-    return {
-        channel,
-        channelStateSnapshot,
-        ctx,
-        input: resolved,
-    };
-}
-/**
- * Runs one step inside the provider lifecycle and asserts that the
- * channel's serialized state was not mutated during execution.
- *
- * Combines {@link runStep} with a post-step channel stability check so
- * callers do not need to repeat the three-call sequence themselves.
- */
-export async function runStepWithChannelGuard(prepared, session, callback) {
-    const stepResult = await runStep(prepared.ctx, session, callback);
-    assertChannelStateIsStable({
-        channel: prepared.channel,
-        phase: "step execution",
-        serializedState: prepared.channelStateSnapshot,
-    });
-    return stepResult;
-}
-function assertChannelStateIsStable(input) {
-    const currentState = input.channel.serialize();
-    if (isDeepStrictEqual(currentState, input.serializedState)) {
-        return;
-    }
-    throw new Error(`Channel "${input.channel.kind}" mutated its serialized state during ${input.phase}. ` +
-        "Channel constructor state must stay immutable after the run starts. " +
-        "Move per-session mutable data into durable context or session.internal instead.");
-}
-//# sourceMappingURL=step-context.js.map

package/dist/src/execution/step-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-context.js","sourceRoot":"","sources":["../../../src/execution/step-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAI9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,8BAA8B,CAAC;AAe/E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAIxC;IACC,MAAM,GAAG,GAAG,MAAM,yBAAyB,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5E,MAAM,qBAAqB,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAChD,+BAA+B,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEpD,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpC,MAAM,oBAAoB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IACjD,MAAM,QAAQ,GACZ,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElG,0BAA0B,CAAC;QACzB,OAAO;QACP,KAAK,EAAE,WAAW;QAClB,eAAe,EAAE,oBAAoB;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO;QACP,oBAAoB;QACpB,GAAG;QACH,KAAK,EAAE,QAAQ;KAChB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,QAA6B,EAC7B,OAAuB,EACvB,QAA0D;IAE1D,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClE,0BAA0B,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,KAAK,EAAE,gBAAgB;QACvB,eAAe,EAAE,QAAQ,CAAC,oBAAoB;KAC/C,CAAC,CAAC;IACH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,0BAA0B,CAAC,KAInC;IACC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;IAC/C,IAAI,iBAAiB,CAAC,YAAY,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3D,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CACb,YAAY,KAAK,CAAC,OAAO,CAAC,IAAI,yCAAyC,KAAK,CAAC,KAAK,IAAI;QACpF,sEAAsE;QACtE,iFAAiF,CACpF,CAAC;AACJ,CAAC"}

package/docs/public/migration-guide.md

@@ -1,71 +0,0 @@
-# Migration Guide
-
-Ash now has one durable authored-context model.
-
-## Breaking Changes
-
-- `getState(key)` is now `getContext(key)`.
-- `setState(key, value)` is now `setContext(key, value)`.
-- `ensureContext(key, valueOrFactory)` replaces `ContextKey({ initial })`.
-- `ContextKeyOptions.initial` was removed.
-- Public `ContextKey` values are session-durable by default.
-- `HarnessSession.state` is now split into `session.context` and internal `session.internal`.
-- Tool compaction hooks no longer return `sessionPatch`. Mutate durable context through `ctx` instead.
-
-## Before
-
-```ts
-import { ContextKey, getState, setState } from "experimental-ash";
-
-const NotesKey = new ContextKey("myapp.notes", {
-  initial: () => ({ notes: [] }),
-});
-
-setState(NotesKey, (current) => ({
-  notes: [...current.notes, "hello"],
-}));
-
-return getState(NotesKey);
-```
-
-## After
-
-```ts
-import { ContextKey, ensureContext, getContext, setContext } from "experimental-ash";
-
-const NotesKey = new ContextKey("myapp.notes");
-
-const current = ensureContext(NotesKey, () => ({ notes: [] }));
-
-setContext(NotesKey, {
-  notes: [...current.notes, "hello"],
-});
-
-return getContext(NotesKey);
-```
-
-## Channel Guidance
-
-- Use `channel.onDeliver(ctx, payload)` to seed or extend durable context on every turn.
-- Treat serialized channel state as immutable after the run starts.
-- Move mutable per-session data into durable context or `session.internal`, not onto the channel instance.
-
-## Compaction Hooks
-
-Before:
-
-```ts
-onCompact() {
-  return {
-    sessionPatch: { state: {} },
-  };
-}
-```
-
-After:
-
-```ts
-onCompact({ ctx }) {
-  ctx.set(NotesKey, { notes: [] });
-}
-```