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

package/dist/src/context/key.js

@@ -1,101 +1,79 @@
 /**
- * Global registry mapping key names to instances. Populated automatically
- * by the {@link ContextKey} constructor so `deserializeContext` can resolve
- * string names back to typed keys without an explicit list.
- */
-const keyRegistry = new Map();
-/**
- * Registry of state keys (keys with an {@link ContextKey.initial | initial}
- * factory). Used by `runStep` to hydrate and commit durable state.
+ * Global registries mapping key names to instances.
+ *
+ * Durable context keys are public/authored keys persisted on `session.context`.
+ * Runtime context keys are private framework keys used for seed values,
+ * providers, and runtime-only bookkeeping inside one step.
  */
-const stateKeyRegistry = new Map();
+const durableKeyRegistry = new Map();
+const runtimeKeyRegistry = new Map();
+const serializableRuntimeKeyRegistry = new Map();
+const registeredKeyNames = new Set();
+function registerKeyName(name) {
+    if (registeredKeyNames.has(name)) {
+        throw new Error(`Context key "${name}" was registered more than once.`);
+    }
+    registeredKeyNames.add(name);
+}
 /**
- * Typed key that identifies a value inside an {@link AshContext} container.
- *
- * Use a `ContextKey` to declare a piece of durable, per-session state that
- * tools, steps, and model callbacks can read and write inside an Ash
- * execution scope. The key is declared once at module top-level and reused
- * everywhere — the value is stored on the active session, not on the key.
- *
- * @example Declare a durable state key and use it from a tool
- * ```ts
- * import { ContextKey, getState, setState } from "experimental-ash";
- * import { defineTool } from "experimental-ash/tools";
- * import { z } from "zod";
+ * Public durable context key.
  *
- * interface NoteListState {
- *   readonly notes: readonly string[];
- * }
- *
- * // `initial` makes this a state key — its value survives across
- * // workflow step boundaries and compaction. The name must be unique
- * // across the whole agent process.
- * const NoteListStateKey = new ContextKey<NoteListState>("notes", {
- *   initial: () => ({ notes: [] }),
- * });
- *
- * export default defineTool({
- *   description: "Append a note, or read the running list.",
- *   inputSchema: z.object({ note: z.string().optional() }),
- *   async execute({ note }) {
- *     if (note) {
- *       setState(NoteListStateKey, (current) => ({
- *         notes: [...current.notes, note],
- *       }));
- *     }
- *     return getState(NoteListStateKey);
- *   },
- * });
- * ```
- *
- * Keys with an `initial` factory are **state keys** — durable mutable values
- * hydrated from the session at step start and persisted back at step end.
- * Keys without `initial` are ephemeral and only live for the current step.
- *
- * State keys participate in compaction via tool-level `onCompact` hooks
- * declared on a `ToolDefinition`, not on the key itself.
- *
- * Keys that hold values which are not JSON-safe (e.g. live class instances)
- * must declare a `codec` so the framework can serialize/deserialize at step
- * boundaries.
- *
- * Every key self-registers in a global registry so the serialization layer
- * can resolve string names back to typed keys without an explicit list.
- * Construct each key exactly once at module scope; constructing the same
- * key name twice is a programmer error.
+ * Values stored under a `ContextKey` are session-durable. The runtime
+ * hydrates them from `session.context` before each step and commits them back
+ * after the step completes.
  */
 export class ContextKey {
+    codec;
     name;
+    constructor(name, options = {}) {
+        registerKeyName(name);
+        this.name = name;
+        this.codec = options.codec;
+        durableKeyRegistry.set(name, this);
+    }
+}
+/**
+ * Private runtime-only key used for seed values, providers, and other
+ * framework internals that must not be persisted on `session.context`.
+ */
+export class RuntimeContextKey {
     codec;
-    /**
-     * When provided, this key stores durable state on the harness session
-     * across workflow step boundaries. The factory returns the default value
-     * used when no persisted state exists on the session yet.
-     */
-    initial;
+    name;
+    serializable;
     constructor(name, options = {}) {
+        registerKeyName(name);
         this.name = name;
         this.codec = options.codec;
-        this.initial = options.initial;
-        keyRegistry.set(name, this);
-        if (this.initial !== undefined) {
-            stateKeyRegistry.set(name, this);
+        this.serializable = options.serializable ?? false;
+        runtimeKeyRegistry.set(name, this);
+        if (this.serializable) {
+            serializableRuntimeKeyRegistry.set(name, this);
         }
     }
 }
+export function isDurableContextKey(key) {
+    return key instanceof ContextKey;
+}
+export function isRuntimeContextKey(key) {
+    return key instanceof RuntimeContextKey;
+}
 /**
- * Looks up a registered key by name. Returns `undefined` for unknown names.
+ * Looks up one registered durable key by name.
  */
-export function resolveKey(name) {
-    return keyRegistry.get(name);
+export function resolveContextKey(name) {
+    return durableKeyRegistry.get(name);
 }
 /**
- * Returns all registered state keys (keys with an `initial` factory).
- *
- * Used by `runStep` to generically hydrate and commit durable state without
- * knowledge of specific key identities.
+ * Looks up one registered runtime key by name.
+ */
+export function resolveRuntimeContextKey(name) {
+    return runtimeKeyRegistry.get(name);
+}
+/**
+ * Returns all registered runtime keys that participate in runtime-seed
+ * serialization across durable workflow boundaries.
  */
-export function getStateKeys() {
-    return stateKeyRegistry.values();
+export function getSerializableRuntimeContextKeys() {
+    return serializableRuntimeKeyRegistry.values();
 }
 //# sourceMappingURL=key.js.map

package/dist/src/context/key.js.map

@@ -1 +1 @@
-{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../src/context/key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE3D;;;GAGG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA+B,CAAC;AAsBhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,OAAO,UAAU;IACZ,IAAI,CAAS;IACb,KAAK,CAGZ;IAEF;;;;OAIG;IACM,OAAO,CAAW;IAE3B,YAAY,IAAY,EAAE,UAAgC,EAAE;QAC1D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAA2B,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAA2B,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,gBAAgB,CAAC,MAAM,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../src/context/key.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA+B,CAAC;AAClE,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAsC,CAAC;AACzE,MAAM,8BAA8B,GAAG,IAAI,GAAG,EAAsC,CAAC;AACrF,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAU,CAAC;AA0B7C,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,kCAAkC,CAAC,CAAC;IAC1E,CAAC;IAED,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,UAAU;IACZ,KAAK,CAAsB;IAC3B,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,UAAgC,EAAE;QAC1D,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,IAA2B,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACnB,KAAK,CAAsB;IAC3B,IAAI,CAAS;IACb,YAAY,CAAU;IAE/B,YAAY,IAAY,EAAE,UAAuC,EAAE;QACjE,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;QAClD,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAkC,CAAC,CAAC;QAEjE,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,8BAA8B,CAAC,GAAG,CAAC,IAAI,EAAE,IAAkC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF;AAID,MAAM,UAAU,mBAAmB,CAAC,GAA6B;IAC/D,OAAO,GAAG,YAAY,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,GAA6B;IAE7B,OAAO,GAAG,YAAY,iBAAiB,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO,8BAA8B,CAAC,MAAM,EAAE,CAAC;AACjD,CAAC"}

package/dist/src/context/keys.d.ts

@@ -1,14 +1,10 @@
-import "../channel/http-emitter.js";
-import "../channel/schedule-emitter.js";
-import "../channel/slack-emitter.js";
-import "../channel/subagent-emitter.js";
-import type { ChannelEmitter, SessionAuthContext, SessionParent, SessionTurn } from "../channel/types.js";
+import { type Channel, type SessionAuthContext, type SessionParent, type SessionTurn } from "../channel/types.js";
 import type { SandboxAccess } from "../execution/sandboxes/types.js";
 import type { SkillAccess } from "../execution/skills/types.js";
-import type { RunMode } from "../run-mode.js";
 import { getCompiledRuntimeAgentBundle } from "../runtime/sessions/compiled-agent-cache.js";
-import { ContextKey } from "./key.js";
+import { RuntimeContextKey } from "./key.js";
 export type { SessionAuthContext, SessionParent, SessionTurn } from "../channel/types.js";
+export { AuthKey, ContinuationTokenKey, InitiatorAuthKey, ModeKey, ParentSessionKey, SessionIdKey, } from "./seed-keys.js";
 /**
  * Auth metadata on the active session.
  *
@@ -26,25 +22,17 @@ export interface SessionAuth {
 export interface Session {
     readonly auth: SessionAuth;
     readonly parent?: SessionParent;
-    readonly runId: string;
     readonly sessionId: string;
     readonly turn: SessionTurn;
 }
-export declare const AuthKey: ContextKey<SessionAuthContext | null>;
-export declare const InitiatorAuthKey: ContextKey<SessionAuthContext | null>;
-export declare const SessionIdKey: ContextKey<string>;
-export declare const RunIdKey: ContextKey<string>;
-export declare const ContinuationTokenKey: ContextKey<string>;
-export declare const ModeKey: ContextKey<RunMode>;
-export declare const ParentSessionKey: ContextKey<SessionParent>;
-export declare const ChannelEmitterKey: ContextKey<ChannelEmitter>;
+export declare const ChannelKey: RuntimeContextKey<Channel>;
 /**
  * Bundle returned by the compiled-agent cache. Carries the resolved agent
  * graph, registries, and the active node's turn agent.
  */
 export type CompiledBundle = Awaited<ReturnType<typeof getCompiledRuntimeAgentBundle>>;
-export declare const BundleKey: ContextKey<import("../runtime/sessions/compiled-agent-cache.js").CompiledRuntimeAgentBundle>;
-export declare const SessionKey: ContextKey<Session>;
-export declare const SandboxKey: ContextKey<SandboxAccess>;
-export declare const SkillKey: ContextKey<SkillAccess>;
+export declare const BundleKey: RuntimeContextKey<import("../runtime/sessions/compiled-agent-cache.js").CompiledRuntimeAgentBundle>;
+export declare const SessionKey: RuntimeContextKey<Session>;
+export declare const SandboxKey: RuntimeContextKey<SandboxAccess>;
+export declare const SkillKey: RuntimeContextKey<SkillAccess>;
 //# sourceMappingURL=keys.d.ts.map

package/dist/src/context/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/context/keys.ts"],"names":[],"mappings":"AAKA,OAAO,4BAA4B,CAAC;AACpC,OAAO,gCAAgC,CAAC;AACxC,OAAO,6BAA6B,CAAC;AACrC,OAAO,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAM1F;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAMD,eAAO,MAAM,OAAO,uCAAwD,CAAC;AAC7E,eAAO,MAAM,gBAAgB,uCAAiE,CAAC;AAC/F,eAAO,MAAM,YAAY,oBAA0C,CAAC;AACpE,eAAO,MAAM,QAAQ,oBAAsC,CAAC;AAC5D,eAAO,MAAM,oBAAoB,oBAAkD,CAAC;AACpF,eAAO,MAAM,OAAO,qBAAsC,CAAC;AAC3D,eAAO,MAAM,gBAAgB,2BAAqD,CAAC;AAWnF,eAAO,MAAM,iBAAiB,4BAmB5B,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC;AAOvF,eAAO,MAAM,SAAS,8FAcpB,CAAC;AAMH,eAAO,MAAM,UAAU,qBAAyC,CAAC;AACjE,eAAO,MAAM,UAAU,2BAA+C,CAAC;AACvE,eAAO,MAAM,QAAQ,yBAA2C,CAAC"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/context/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAGhE,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAMxB;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAWD,eAAO,MAAM,UAAU,4BAqBrB,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,6BAA6B,CAAC,CAAC,CAAC;AAOvF,eAAO,MAAM,SAAS,qGAepB,CAAC;AAMH,eAAO,MAAM,UAAU,4BAAgD,CAAC;AACxE,eAAO,MAAM,UAAU,kCAAsD,CAAC;AAC9E,eAAO,MAAM,QAAQ,gCAAkD,CAAC"}

package/dist/src/context/keys.js

@@ -1,43 +1,28 @@
-import { getChannelEmitterClass } from "../channel/emitter-registry.js";
-// Side-effect imports: each module registers its emitter class with the
-// process-global registry at import time. The imports must stay even though
-// the symbols are unused, otherwise the registry would be empty when the
-// codec runs.
-import "../channel/http-emitter.js";
-import "../channel/schedule-emitter.js";
-import "../channel/slack-emitter.js";
-import "../channel/subagent-emitter.js";
+import { getChannelClassKind, } from "../channel/types.js";
+import { deserializeRuntimeChannel } from "../runtime/channels/registry.js";
 import { getCompiledRuntimeAgentBundle } from "../runtime/sessions/compiled-agent-cache.js";
-import { ContextKey } from "./key.js";
-// ---------------------------------------------------------------------------
-// Seed keys — serialized/deserialized at step boundaries
-// ---------------------------------------------------------------------------
-export const AuthKey = new ContextKey("ash.auth");
-export const InitiatorAuthKey = new ContextKey("ash.initiatorAuth");
-export const SessionIdKey = new ContextKey("ash.sessionId");
-export const RunIdKey = new ContextKey("ash.runId");
-export const ContinuationTokenKey = new ContextKey("ash.continuationToken");
-export const ModeKey = new ContextKey("ash.mode");
-export const ParentSessionKey = new ContextKey("ash.parentSession");
-export const ChannelEmitterKey = new ContextKey("ash.channelEmitter", {
+import { RuntimeContextKey } from "./key.js";
+// Re-export seed keys so existing consumers of `context/keys` keep working.
+export { AuthKey, ContinuationTokenKey, InitiatorAuthKey, ModeKey, ParentSessionKey, SessionIdKey, } from "./seed-keys.js";
+export const ChannelKey = new RuntimeContextKey("ash.channel", {
     codec: {
-        serialize(emitter) {
+        serialize(channel) {
             return {
-                kind: emitter.kind,
-                state: emitter.serialize(),
+                kind: getChannelClassKind(channel.constructor),
+                state: channel.serialize(),
             };
         },
-        deserialize(data) {
-            const { kind, state } = data;
-            const cls = getChannelEmitterClass(kind);
-            if (cls === undefined) {
-                throw new Error(`Unknown channel emitter kind: "${kind}". The module that defines this emitter must be imported before deserialization so it can register itself via registerChannelEmitter().`);
+        deserialize(data, ctx) {
+            const bundle = ctx.tryGet(BundleKey);
+            if (bundle === undefined) {
+                throw new Error('Cannot deserialize "ash.channel" before "ash.bundle". The runtime bundle must be present in context.');
             }
-            return cls.deserialize(state);
+            return deserializeRuntimeChannel(bundle.channelRegistry, data);
         },
     },
+    serializable: true,
 });
-export const BundleKey = new ContextKey("ash.bundle", {
+export const BundleKey = new RuntimeContextKey("ash.bundle", {
     codec: {
         serialize: (bundle) => ({
             nodeSelector: bundle.nodeSelector,
@@ -51,11 +36,12 @@ export const BundleKey = new ContextKey("ash.bundle", {
             });
         },
     },
+    serializable: true,
 });
 // ---------------------------------------------------------------------------
 // Derived keys — reconstructed by providers each step, never serialized
 // ---------------------------------------------------------------------------
-export const SessionKey = new ContextKey("ash.session");
-export const SandboxKey = new ContextKey("ash.sandbox");
-export const SkillKey = new ContextKey("ash.skill");
+export const SessionKey = new RuntimeContextKey("ash.session");
+export const SandboxKey = new RuntimeContextKey("ash.sandbox");
+export const SkillKey = new RuntimeContextKey("ash.skill");
 //# sourceMappingURL=keys.js.map

package/dist/src/context/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/context/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,wEAAwE;AACxE,4EAA4E;AAC5E,yEAAyE;AACzE,cAAc;AACd,OAAO,4BAA4B,CAAC;AACpC,OAAO,gCAAgC,CAAC;AACxC,OAAO,6BAA6B,CAAC;AACrC,OAAO,gCAAgC,CAAC;AAWxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAgCtC,8EAA8E;AAC9E,yDAAyD;AACzD,8EAA8E;AAE9E,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,UAAU,CAA4B,UAAU,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAA4B,mBAAmB,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,UAAU,CAAS,eAAe,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAS,WAAW,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,UAAU,CAAS,uBAAuB,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,UAAU,CAAU,UAAU,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAgB,mBAAmB,CAAC,CAAC;AAWnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,UAAU,CAAiB,oBAAoB,EAAE;IACpF,KAAK,EAAE;QACL,SAAS,CAAC,OAAO;YACf,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;aAC3B,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,IAAI;YACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAgC,CAAC;YACzD,MAAM,GAAG,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,kCAAkC,IAAI,yIAAyI,CAChL,CAAC;YACJ,CAAC;YACD,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;KACF;CACF,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,UAAU,CAAiB,YAAY,EAAE;IACpE,KAAK,EAAE;QACL,SAAS,EAAE,CAAC,MAAM,EAAoB,EAAE,CAAC,CAAC;YACxC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,MAAM,EAAE,MAAM,CAAC,uBAAuB;SACvC,CAAC;QACF,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;YACpB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAwB,CAAC;YAC1D,OAAO,6BAA6B,CAAC;gBACnC,uBAAuB,EAAE,MAAM;gBAC/B,YAAY;aACb,CAAC,CAAC;QACL,CAAC;KACF;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,CAAU,aAAa,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,UAAU,CAAgB,aAAa,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAc,WAAW,CAAC,CAAC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/context/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,mBAAmB,GAIpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAI7C,4EAA4E;AAC5E,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,gBAAgB,EAChB,OAAO,EACP,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAqCxB,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAU,aAAa,EAAE;IACtE,KAAK,EAAE;QACL,SAAS,CAAC,OAAO;YACf,OAAO;gBACL,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,WAA2B,CAAC;gBAC9D,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE;aAC3B,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,IAAI,EAAE,GAAG;YACnB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAErC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;YACJ,CAAC;YAED,OAAO,yBAAyB,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;KACF;IACD,YAAY,EAAE,IAAI;CACnB,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAiB,YAAY,EAAE;IAC3E,KAAK,EAAE;QACL,SAAS,EAAE,CAAC,MAAM,EAAoB,EAAE,CAAC,CAAC;YACxC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,MAAM,EAAE,MAAM,CAAC,uBAAuB;SACvC,CAAC;QACF,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE;YACpB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAwB,CAAC;YAC1D,OAAO,6BAA6B,CAAC;gBACnC,uBAAuB,EAAE,MAAM;gBAC/B,YAAY;aACb,CAAC,CAAC;QACL,CAAC;KACF;IACD,YAAY,EAAE,IAAI;CACnB,CAAC,CAAC;AAEH,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAU,aAAa,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,iBAAiB,CAAgB,aAAa,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,iBAAiB,CAAc,WAAW,CAAC,CAAC"}

package/dist/src/context/provider.d.ts

@@ -1,6 +1,6 @@
 import type { HarnessSession } from "../harness/types.js";
 import type { AshContext } from "./container.js";
-import type { ContextKey } from "./key.js";
+import type { ContextStoreKey } from "./key.js";
 /**
  * Value returned by a provider's `create` method.
  *
@@ -17,7 +17,7 @@ export interface ProviderResult<T> {
  * to persist changes back onto the harness session.
  */
 export interface ContextProvider<T> {
-    readonly key: ContextKey<T>;
+    readonly key: ContextStoreKey<T>;
     create(ctx: AshContext, session: HarnessSession): ProviderResult<T> | undefined | Promise<ProviderResult<T> | undefined>;
     commit?(value: T, session: HarnessSession): HarnessSession | Promise<HarnessSession>;
 }

package/dist/src/context/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/context/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAE5B,MAAM,CACJ,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,cAAc,GACtB,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE1E,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACtF"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/context/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,CACJ,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,cAAc,GACtB,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE1E,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACtF"}

package/dist/src/context/providers/connection.d.ts

@@ -0,0 +1,4 @@
+import type { ConnectionRegistry } from "../../runtime/connections/types.js";
+import type { ContextProvider } from "../provider.js";
+export declare const connectionProvider: ContextProvider<ConnectionRegistry>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/context/providers/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAI7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,kBAAkB,EAAE,eAAe,CAAC,kBAAkB,CAYlE,CAAC"}

package/dist/src/context/providers/connection.js

@@ -0,0 +1,18 @@
+import { ConnectionRegistryImpl } from "../../runtime/connections/registry.js";
+import { ConnectionRegistryKey } from "../../runtime/framework-tools/connection-search.js";
+import { BundleKey } from "../keys.js";
+import { getActiveRuntimeNode } from "../node.js";
+export const connectionProvider = {
+    key: ConnectionRegistryKey,
+    create(ctx, _session) {
+        const bundle = ctx.tryGet(BundleKey);
+        if (bundle === undefined)
+            return undefined;
+        const node = getActiveRuntimeNode(ctx);
+        const connections = node.agent?.connections;
+        if (!connections || connections.length === 0)
+            return undefined;
+        return { value: new ConnectionRegistryImpl(connections) };
+    },
+};
+//# sourceMappingURL=connection.js.map

package/dist/src/context/providers/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../../src/context/providers/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAE/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oDAAoD,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,CAAC,MAAM,kBAAkB,GAAwC;IACrE,GAAG,EAAE,qBAAqB;IAE1B,MAAM,CAAC,GAAG,EAAE,QAAQ;QAClB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,IAAI,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC;QAC5C,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAE/D,OAAO,EAAE,KAAK,EAAE,IAAI,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/src/context/providers/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,OAAO,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,CAkBpD,CAAC"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,OAAO,EAGb,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC,OAAO,CAiBpD,CAAC"}

package/dist/src/context/providers/session.js

@@ -1,4 +1,4 @@
-import { AuthKey, InitiatorAuthKey, ParentSessionKey, RunIdKey, SessionIdKey, SessionKey, } from "../keys.js";
+import { AuthKey, InitiatorAuthKey, ParentSessionKey, SessionIdKey, SessionKey, } from "../keys.js";
 export const sessionProvider = {
     key: SessionKey,
     create(ctx) {
@@ -10,7 +10,6 @@ export const sessionProvider = {
                     initiator: ctx.tryGet(InitiatorAuthKey) ?? currentAuth,
                 },
                 parent: ctx.tryGet(ParentSessionKey),
-                runId: ctx.get(RunIdKey),
                 sessionId: ctx.get(SessionIdKey),
                 turn: { id: `turn-${crypto.randomUUID()}`, sequence: 0 },
             }),

package/dist/src/context/providers/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/context/providers/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EAER,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,GAAG,EAAE,UAAU;IACf,MAAM,CAAC,GAAG;QACR,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE;oBACJ,OAAO,EAAE,WAAW;oBACpB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,WAAW;iBACvD;gBACD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACpC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;gBACxB,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;gBAChC,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;aACzD,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/context/providers/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,gBAAgB,EAEhB,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,GAAG,EAAE,UAAU;IACf,MAAM,CAAC,GAAG;QACR,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAErC,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE;oBACJ,OAAO,EAAE,WAAW;oBACpB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,WAAW;iBACvD;gBACD,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACpC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;gBAChC,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;aACzD,CAAC;SACH,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/src/context/providers/skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/skill.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAInE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,WAAW,CA0BtD,CAAC"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/context/providers/skill.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAInE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,eAAO,MAAM,aAAa,EAAE,eAAe,CAAC,WAAW,CActD,CAAC"}

package/dist/src/context/providers/skill.js

@@ -1,11 +1,10 @@
 import { createSkillAccess } from "../../execution/skills/access.js";
-import { enrichInstructionsWithSkills } from "../../execution/skills/instructions.js";
 import { SkillStateKey } from "../../runtime/framework-tools/skill.js";
 import { BundleKey, SkillKey } from "../keys.js";
 import { getActiveRuntimeNode } from "../node.js";
 export const skillProvider = {
     key: SkillKey,
-    create(ctx, session) {
+    create(ctx, _session) {
         const bundle = ctx.tryGet(BundleKey);
         if (bundle === undefined)
             return undefined;
@@ -14,19 +13,7 @@ export const skillProvider = {
             return undefined;
         const skillState = ctx.tryGet(SkillStateKey);
         const activeSkillIds = skillState?.activeIds ?? [];
-        return {
-            value: createSkillAccess({ activeSkillIds, skills }),
-            session: {
-                ...session,
-                agent: {
-                    ...session.agent,
-                    system: enrichInstructionsWithSkills({
-                        baseSystem: session.agent.system,
-                        skills,
-                    }),
-                },
-            },
-        };
+        return { value: createSkillAccess({ activeSkillIds, skills }) };
     },
 };
 //# sourceMappingURL=skill.js.map

package/dist/src/context/providers/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/context/providers/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAEtF,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,GAAG,EAAE,QAAQ;IAEb,MAAM,CAAC,GAAG,EAAE,OAAO;QACjB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAE1C,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,UAAU,EAAE,SAAS,IAAI,EAAE,CAAC;QAEnD,OAAO;YACL,KAAK,EAAE,iBAAiB,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;YACpD,OAAO,EAAE;gBACP,GAAG,OAAO;gBACV,KAAK,EAAE;oBACL,GAAG,OAAO,CAAC,KAAK;oBAChB,MAAM,EAAE,4BAA4B,CAAC;wBACnC,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM;wBAChC,MAAM;qBACP,CAAC;iBACH;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/context/providers/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,GAAG,EAAE,QAAQ;IAEb,MAAM,CAAC,GAAG,EAAE,QAAQ;QAClB,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;QAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAE1C,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,UAAU,EAAE,SAAS,IAAI,EAAE,CAAC;QAEnD,OAAO,EAAE,KAAK,EAAE,iBAAiB,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAClE,CAAC;CACF,CAAC"}

package/dist/src/context/run-step.d.ts

@@ -3,14 +3,12 @@ import { type AshContext } from "./container.js";
 /**
  * Runs one step inside the unified context.
  *
- * 1. Hydrates registered state keys from `session.state` (or their defaults).
- * 2. Iterates framework providers in order — each may populate its key on
- *    `ctx` and optionally modify the harness session (e.g. skills enriching
- *    instructions).
- * 3. Runs `callback` inside the ALS scope so authored code can read context.
- * 4. After the step, runs each provider's `commit` hook to persist mutable
- *    state (sandbox snapshots, skill activations) back onto the session.
- * 5. Commits modified state keys back to `session.state`.
+ * 1. Iterates framework providers in order — each may populate its runtime
+ *    key on `ctx` and optionally modify the harness session.
+ * 2. Runs `callback` inside the ALS scope so authored code can read context.
+ * 3. After the step, runs each provider's `commit` hook to persist mutable
+ *    runtime state back onto the session.
+ * 4. Commits the full durable context bag back to `session.context`.
  */
 export declare function runStep(ctx: AshContext, harnessSession: HarnessSession, callback: (session: HarnessSession) => Promise<StepResult>): Promise<StepResult>;
 //# sourceMappingURL=run-step.d.ts.map

package/dist/src/context/run-step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-step.d.ts","sourceRoot":"","sources":["../../../src/context/run-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAoBjE;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,UAAU,EACf,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,CAoCrB"}
+{"version":3,"file":"run-step.d.ts","sourceRoot":"","sources":["../../../src/context/run-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,gBAAgB,CAAC;AAsBjE;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,UAAU,EACf,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

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

@@ -1,37 +1,35 @@
 import { contextStorage } from "./container.js";
+import { commitDurableContext } from "./durable-context.js";
+import { connectionProvider } from "./providers/connection.js";
 import { sandboxProvider } from "./providers/sandbox.js";
 import { sessionProvider } from "./providers/session.js";
 import { skillProvider } from "./providers/skill.js";
-import { commitStateKeys, hydrateStateKeys } from "./state.js";
 /**
  * Framework providers in dependency order.
  *
  * Session runs first (depends only on seed keys). Sandbox and skill depend on
  * `BundleKey` (a seed) and optionally `SessionKey`.
  */
-// biome-ignore lint/suspicious/noExplicitAny: heterogeneous provider collection requires type erasure
+// biome-ignore lint/suspicious/noExplicitAny: heterogeneous provider collection
 const providers = [
     sessionProvider,
+    connectionProvider,
     sandboxProvider,
     skillProvider,
 ];
 /**
  * Runs one step inside the unified context.
  *
- * 1. Hydrates registered state keys from `session.state` (or their defaults).
- * 2. Iterates framework providers in order — each may populate its key on
- *    `ctx` and optionally modify the harness session (e.g. skills enriching
- *    instructions).
- * 3. Runs `callback` inside the ALS scope so authored code can read context.
- * 4. After the step, runs each provider's `commit` hook to persist mutable
- *    state (sandbox snapshots, skill activations) back onto the session.
- * 5. Commits modified state keys back to `session.state`.
+ * 1. Iterates framework providers in order — each may populate its runtime
+ *    key on `ctx` and optionally modify the harness session.
+ * 2. Runs `callback` inside the ALS scope so authored code can read context.
+ * 3. After the step, runs each provider's `commit` hook to persist mutable
+ *    runtime state back onto the session.
+ * 4. Commits the full durable context bag back to `session.context`.
  */
 export async function runStep(ctx, harnessSession, callback) {
     let session = harnessSession;
-    // 1. Hydrate state keys from session.state (or defaults)
-    const stateSnapshot = await hydrateStateKeys(ctx, session);
-    // 2. Run providers
+    // 1. Run providers
     for (const p of providers) {
         const result = await p.create(ctx, session);
         if (result !== undefined) {
@@ -41,17 +39,17 @@ export async function runStep(ctx, harnessSession, callback) {
             }
         }
     }
-    // 3. Run callback inside ALS scope
+    // 2. Run callback inside ALS scope
     const stepResult = await contextStorage.run(ctx, () => callback(session));
-    // 4. Commit providers
+    // 3. Commit providers
     let committed = stepResult.session;
     for (const p of providers) {
         if (p.commit && ctx.has(p.key)) {
             committed = await p.commit(ctx.get(p.key), committed);
         }
     }
-    // 5. Commit modified state keys
-    committed = commitStateKeys(ctx, committed, stateSnapshot);
+    // 4. Commit durable context
+    committed = commitDurableContext(ctx, committed);
     if (committed === stepResult.session) {
         return stepResult;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"run-step.js","sourceRoot":"","sources":["../../../src/context/run-step.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D;;;;;GAKG;AACH,sGAAsG;AACtG,MAAM,SAAS,GAAoC;IACjD,eAAe;IACf,eAAe;IACf,aAAa;CACd,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAe,EACf,cAA8B,EAC9B,QAA0D;IAE1D,IAAI,OAAO,GAAG,cAAc,CAAC;IAE7B,yDAAyD;IACzD,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE3D,mBAAmB;IACnB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,sBAAsB;IACtB,IAAI,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,SAAS,GAAG,eAAe,CAAC,GAAG,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAE3D,IAAI,SAAS,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC"}
+{"version":3,"file":"run-step.js","sourceRoot":"","sources":["../../../src/context/run-step.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;GAKG;AACH,gFAAgF;AAChF,MAAM,SAAS,GAAoC;IACjD,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,aAAa;CACd,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAe,EACf,cAA8B,EAC9B,QAA0D;IAE1D,IAAI,OAAO,GAAG,cAAc,CAAC;IAE7B,mBAAmB;IACnB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC3B,CAAC;QACH,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,sBAAsB;IACtB,IAAI,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,SAAS,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,SAAS,GAAG,oBAAoB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAEjD,IAAI,SAAS,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC;QACrC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC"}

package/dist/src/context/seed-keys.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Simple seed keys — serializable values carried across workflow step
+ * boundaries. These keys have no codec and no heavyweight imports, so
+ * they can be safely imported from channel code without triggering
+ * circular module dependencies.
+ *
+ * Complex codec keys ({@link import("./keys.js").ChannelKey ChannelKey},
+ * {@link import("./keys.js").BundleKey BundleKey}) and derived keys
+ * ({@link import("./keys.js").SessionKey SessionKey}, etc.) live in
+ * `context/keys.ts` which re-exports everything from this module.
+ */
+import type { SessionAuthContext, SessionParent } from "../channel/types.js";
+import type { RunMode } from "../run-mode.js";
+import { RuntimeContextKey } from "./key.js";
+export declare const AuthKey: RuntimeContextKey<SessionAuthContext | null>;
+export declare const InitiatorAuthKey: RuntimeContextKey<SessionAuthContext | null>;
+export declare const SessionIdKey: RuntimeContextKey<string>;
+export declare const ContinuationTokenKey: RuntimeContextKey<string>;
+export declare const ModeKey: RuntimeContextKey<RunMode>;
+export declare const ParentSessionKey: RuntimeContextKey<SessionParent>;
+//# sourceMappingURL=seed-keys.d.ts.map

package/dist/src/context/seed-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-keys.d.ts","sourceRoot":"","sources":["../../../src/context/seed-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,OAAO,8CAElB,CAAC;AACH,eAAO,MAAM,gBAAgB,8CAK5B,CAAC;AACF,eAAO,MAAM,YAAY,2BAEvB,CAAC;AACH,eAAO,MAAM,oBAAoB,2BAE/B,CAAC;AACH,eAAO,MAAM,OAAO,4BAElB,CAAC;AACH,eAAO,MAAM,gBAAgB,kCAE3B,CAAC"}