@rkat/mobkit-sdk 0.5.2 → 0.6.2

package/dist/agent-builder.d.ts

@@ -5,7 +5,7 @@
  * mutable SessionBuildOptions and modifies it in place.
  */
 import { SessionBuildOptions } from "./models.js";
-import { type ErrorEvent } from "./types.js";
+import { type ErrorEvent, type SessionCreatedContext, type ContinuityStore, type LeaseProvider, type RosterProvider, type AgentCustomizer, type TopologyProvider } from "./types.js";
 /**
  * Protocol for building agents during session creation.
  *
@@ -21,6 +21,8 @@ import { type ErrorEvent } from "./types.js";
  */
 export interface SessionAgentBuilder {
     buildAgent(options: SessionBuildOptions): Promise<void>;
+    /** Called after session creation succeeds. Best-effort — errors logged, not propagated. */
+    afterCreate?(sessionId: string, context: SessionCreatedContext): Promise<void>;
 }
 export type ErrorCallback = (event: ErrorEvent) => void | Promise<void>;
 /**
@@ -35,8 +37,18 @@ export declare class CallbackDispatcher {
     private _errorCallback;
     private readonly _toolHandlers;
     private readonly _scopeTools;
+    private _continuityStore;
+    private _leaseProvider;
+    private _rosterProvider;
+    private _agentCustomizer;
+    private _topologyProvider;
     registerBuilder(builder: SessionAgentBuilder): void;
     registerErrorCallback(callback: ErrorCallback): void;
+    registerContinuityStore(store: ContinuityStore): void;
+    registerLeaseProvider(provider: LeaseProvider): void;
+    registerRosterProvider(provider: RosterProvider): void;
+    registerAgentCustomizer(customizer: AgentCustomizer): void;
+    registerTopologyProvider(provider: TopologyProvider): void;
     /** Remove all tool handlers for a scope. Call when a session ends. */
     releaseScope(scopeId: string): void;
     handleCallback(method: string, params: Record<string, unknown>): Promise<unknown>;

package/dist/agent-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-builder.d.ts","sourceRoot":"","sources":["../src/agent-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAoB,MAAM,aAAa,CAAC;AACpE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAI9D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAID,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIxE;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAE3D,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIpD,sEAAsE;IACtE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU7B,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAwFpB"}
+{"version":3,"file":"agent-builder.d.ts","sourceRoot":"","sources":["../src/agent-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAoB,MAAM,aAAa,CAAC;AACpE,OAAO,EAaL,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,2FAA2F;IAC3F,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAID,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIxE;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,iBAAiB,CAAiC;IAE1D,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAInD,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIpD,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIrD,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAIpD,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAItD,uBAAuB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAI1D,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI1D,sEAAsE;IACtE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU7B,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;CAoQpB"}

package/dist/agent-builder.js

@@ -5,7 +5,7 @@
  * mutable SessionBuildOptions and modifies it in place.
  */
 import { SessionBuildOptions } from "./models.js";
-import { parseErrorEvent } from "./types.js";
+import { parseErrorEvent, parseContinuityRecord, parseSessionSnapshot, parseLeaseGrant, parseAgentBuildContext, parseDurableAgentSpec, parseAgentBuildDraft, agentBuildDraftToDict, durableAgentSpecToDict, sessionSnapshotToDict, managedPeerEdgeToDict, } from "./types.js";
 // -- CallbackDispatcher ---------------------------------------------------
 /**
  * Routes incoming JSON-RPC callbacks from the Rust runtime to the
@@ -19,12 +19,32 @@ export class CallbackDispatcher {
     _errorCallback = null;
     _toolHandlers = new Map();
     _scopeTools = new Map();
+    _continuityStore = null;
+    _leaseProvider = null;
+    _rosterProvider = null;
+    _agentCustomizer = null;
+    _topologyProvider = null;
     registerBuilder(builder) {
         this._builder = builder;
     }
     registerErrorCallback(callback) {
         this._errorCallback = callback;
     }
+    registerContinuityStore(store) {
+        this._continuityStore = store;
+    }
+    registerLeaseProvider(provider) {
+        this._leaseProvider = provider;
+    }
+    registerRosterProvider(provider) {
+        this._rosterProvider = provider;
+    }
+    registerAgentCustomizer(customizer) {
+        this._agentCustomizer = customizer;
+    }
+    registerTopologyProvider(provider) {
+        this._topologyProvider = provider;
+    }
     /** Remove all tool handlers for a scope. Call when a session ends. */
     releaseScope(scopeId) {
         const tools = this._scopeTools.get(scopeId);
@@ -48,6 +68,27 @@ export class CallbackDispatcher {
             }
             return null;
         }
+        if (method === "callback/after_create") {
+            if (this._builder !== null && typeof this._builder.afterCreate === "function") {
+                const sessionId = String(params.session_id ?? "");
+                const context = {
+                    model: String(params.model ?? ""),
+                    labels: typeof params.labels === "object" && params.labels !== null
+                        ? params.labels
+                        : {},
+                    systemPrompt: typeof params.system_prompt === "string"
+                        ? params.system_prompt
+                        : null,
+                };
+                try {
+                    await this._builder.afterCreate(sessionId, context);
+                }
+                catch {
+                    // Best-effort — swallow afterCreate failures.
+                }
+            }
+            return null;
+        }
         if (method === "callback/build_agent") {
             if (this._builder === null) {
                 throw new Error("no SessionAgentBuilder registered");
@@ -105,6 +146,130 @@ export class CallbackDispatcher {
             const result = await handler(args);
             return { content: result };
         }
+        // -- Continuity callbacks -----------------------------------------------
+        if (method === "callback/continuity/resolve_many") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const identities = Array.isArray(params.identities)
+                ? params.identities.map(String)
+                : [];
+            return this._continuityStore.resolveMany(identities);
+        }
+        if (method === "callback/continuity/load_session_snapshot") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const sessionId = String(params.session_id ?? "");
+            const snap = await this._continuityStore.loadSessionSnapshot(sessionId);
+            if (snap === null)
+                return null;
+            return sessionSnapshotToDict(snap);
+        }
+        if (method === "callback/continuity/save_session_snapshot") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const identity = String(params.identity ?? "");
+            const sessionId = String(params.session_id ?? "");
+            const generation = Number(params.generation ?? 0);
+            const version = Number(params.checkpoint_version ?? 0);
+            const fencingToken = Number(params.fencing_token ?? 0);
+            const snapshot = parseSessionSnapshot({ data: params.snapshot ?? "" });
+            await this._continuityStore.saveSessionSnapshot(identity, sessionId, generation, version, fencingToken, snapshot);
+            return null;
+        }
+        if (method === "callback/continuity/upsert_continuity_record") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const record = parseContinuityRecord(params.record);
+            const fencingToken = Number(params.fencing_token ?? 0);
+            await this._continuityStore.upsertContinuityRecord(record, fencingToken);
+            return null;
+        }
+        // -- Lease callbacks ----------------------------------------------------
+        if (method === "callback/lease/acquire_leases") {
+            if (this._leaseProvider === null) {
+                throw new Error("no LeaseProvider registered");
+            }
+            const identities = Array.isArray(params.identities)
+                ? params.identities.map(String)
+                : [];
+            const runtimeInstance = String(params.runtime_instance ?? "");
+            return this._leaseProvider.acquireLeases(identities, runtimeInstance);
+        }
+        if (method === "callback/lease/renew_leases") {
+            if (this._leaseProvider === null) {
+                throw new Error("no LeaseProvider registered");
+            }
+            const rawGrants = Array.isArray(params.grants) ? params.grants : [];
+            const grants = rawGrants.map(parseLeaseGrant);
+            return this._leaseProvider.renewLeases(grants);
+        }
+        if (method === "callback/lease/release_leases") {
+            if (this._leaseProvider === null) {
+                throw new Error("no LeaseProvider registered");
+            }
+            const rawGrants = Array.isArray(params.grants) ? params.grants : [];
+            const grants = rawGrants.map(parseLeaseGrant);
+            await this._leaseProvider.releaseLeases(grants);
+            return null;
+        }
+        // -- Roster callback ----------------------------------------------------
+        if (method === "callback/roster") {
+            if (this._rosterProvider === null) {
+                throw new Error("no RosterProvider registered");
+            }
+            const context = params.context ?? {};
+            const specs = await this._rosterProvider.roster(context);
+            return specs.map(durableAgentSpecToDict);
+        }
+        // -- Topology callback --------------------------------------------------
+        if (method === "callback/topology/compute_edges") {
+            if (this._topologyProvider === null) {
+                throw new Error("no TopologyProvider registered");
+            }
+            const targetIdentities = Array.isArray(params.target_identities)
+                ? params.target_identities.map(String)
+                : [];
+            const context = params.context ?? {};
+            const edges = await this._topologyProvider.computeEdges(targetIdentities, context);
+            return edges.map(managedPeerEdgeToDict);
+        }
+        // -- Customizer callbacks -----------------------------------------------
+        if (method === "callback/customizer/customize_build") {
+            if (this._agentCustomizer === null) {
+                throw new Error("no AgentCustomizer registered");
+            }
+            const context = parseAgentBuildContext(params.context);
+            const spec = parseDurableAgentSpec(params.spec);
+            const draft = parseAgentBuildDraft(params.draft);
+            await this._agentCustomizer.customizeBuild(context, spec, draft);
+            return agentBuildDraftToDict(draft);
+        }
+        if (method === "callback/customizer/after_create") {
+            if (this._agentCustomizer !== null &&
+                typeof this._agentCustomizer.afterCreate === "function") {
+                const identity = String(params.identity ?? "");
+                const sessionId = String(params.session_id ?? "");
+                const rawLabels = (params.labels != null && typeof params.labels === "object")
+                    ? Object.fromEntries(Object.entries(params.labels).map(([k, v]) => [k, String(v)]))
+                    : {};
+                const context = {
+                    model: String(params.model ?? ""),
+                    labels: rawLabels,
+                    systemPrompt: typeof params.system_prompt === "string" ? params.system_prompt : null,
+                };
+                try {
+                    await this._agentCustomizer.afterCreate(identity, sessionId, context);
+                }
+                catch {
+                    // Best-effort — swallow afterCreate failures.
+                }
+            }
+            return null;
+        }
         throw new Error(`unknown callback method: ${method}`);
     }
 }

package/dist/agent-builder.js.map

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

package/dist/builder.d.ts

@@ -17,6 +17,7 @@
  */
 import type { SessionAgentBuilder, ErrorCallback } from "./agent-builder.js";
 import type { MobKitRuntime } from "./runtime.js";
+import type { ContinuityStore, LeaseProvider, RosterProvider, AgentCustomizer, TopologyProvider } from "./types.js";
 export interface MobKitBuilderConfig {
     mobConfigPath: string | null;
     sessionBuilder: SessionAgentBuilder | null;
@@ -32,6 +33,13 @@ export interface MobKitBuilderConfig {
     authConfig: unknown;
     gatewayBin: string | null;
     modules: unknown[];
+    persistentState: string | null;
+    continuityStore: ContinuityStore | null;
+    leaseProvider: LeaseProvider | null;
+    scratchDir: string | null;
+    rosterProvider: RosterProvider | null;
+    agentCustomizer: AgentCustomizer | null;
+    topologyProvider: TopologyProvider | null;
 }
 /**
  * Chainable builder for MobKit runtime configuration.
@@ -65,7 +73,27 @@ export declare class MobKitBuilder {
     auth(config: unknown): this;
     gateway(binPath: string): this;
     modules(moduleSpecs: unknown[]): this;
+    /**
+     * Enable persistent state at the given path.
+     *
+     * When set, the gateway creates SQLite session store, FsBlobStore,
+     * and redb mob storage under this directory.
+     */
+    persistentState(path: string): this;
+    /** Set an external ContinuityStore provider. Mutually exclusive with persistentState. */
+    continuityStore(store: ContinuityStore): this;
+    /** Set an external LeaseProvider. Mutually exclusive with persistentState. */
+    leaseProvider(provider: LeaseProvider): this;
+    /** Set scratch directory for external provider path. */
+    scratchDir(path: string): this;
+    /** Set a RosterProvider. */
+    rosterProvider(provider: RosterProvider): this;
+    /** Set an AgentCustomizer. */
+    agentCustomizer(customizer: AgentCustomizer): this;
+    /** Set a TopologyProvider. */
+    topologyProvider(provider: TopologyProvider): this;
     build(): Promise<MobKitRuntime>;
+    private _validateConfig;
     private _applyConventionDefaults;
 }
 export declare class MobKit {

package/dist/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAuBD;;;;;;;;;;GAUG;AACH,qBAAa,aAAa;IACxB,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAmB;IAExD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK7B,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAMnE,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAKlC,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAKjC,QAAQ,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAA,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;IAKpE,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKtC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKhC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKjC,UAAU,CAAC,GAAG,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI;IAK5C,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAM/D,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAK3B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI;IAK/B,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAOrC,OAAO,CAAC,wBAAwB;CA0BjC;AAID,qBAAa,MAAM;IACjB,MAAM,CAAC,OAAO,IAAI,aAAa;CAGhC"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"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"}

package/dist/builder.js

@@ -32,6 +32,13 @@ function defaultConfig() {
         authConfig: null,
         gatewayBin: null,
         modules: [],
+        persistentState: null,
+        continuityStore: null,
+        leaseProvider: null,
+        scratchDir: null,
+        rosterProvider: null,
+        agentCustomizer: null,
+        topologyProvider: null,
     };
 }
 // -- MobKitBuilder --------------------------------------------------------
@@ -103,12 +110,62 @@ export class MobKitBuilder {
         this._config.modules = moduleSpecs;
         return this;
     }
+    /**
+     * Enable persistent state at the given path.
+     *
+     * When set, the gateway creates SQLite session store, FsBlobStore,
+     * and redb mob storage under this directory.
+     */
+    persistentState(path) {
+        this._config.persistentState = path;
+        return this;
+    }
+    /** Set an external ContinuityStore provider. Mutually exclusive with persistentState. */
+    continuityStore(store) {
+        this._config.continuityStore = store;
+        return this;
+    }
+    /** Set an external LeaseProvider. Mutually exclusive with persistentState. */
+    leaseProvider(provider) {
+        this._config.leaseProvider = provider;
+        return this;
+    }
+    /** Set scratch directory for external provider path. */
+    scratchDir(path) {
+        this._config.scratchDir = path;
+        return this;
+    }
+    /** Set a RosterProvider. */
+    rosterProvider(provider) {
+        this._config.rosterProvider = provider;
+        return this;
+    }
+    /** Set an AgentCustomizer. */
+    agentCustomizer(customizer) {
+        this._config.agentCustomizer = customizer;
+        return this;
+    }
+    /** Set a TopologyProvider. */
+    topologyProvider(provider) {
+        this._config.topologyProvider = provider;
+        return this;
+    }
     async build() {
+        this._validateConfig();
         this._applyConventionDefaults();
         // Dynamic import to break circular dep (runtime imports from builder config type)
         const { MobKitRuntime } = await import("./runtime.js");
         return MobKitRuntime._create(this._config);
     }
+    _validateConfig() {
+        const hasPersistent = this._config.persistentState !== null;
+        const hasExternal = this._config.continuityStore !== null ||
+            this._config.leaseProvider !== null;
+        if (hasPersistent && hasExternal) {
+            throw new Error("persistentState and continuityStore/leaseProvider are mutually exclusive — " +
+                "use one path or the other, not both");
+        }
+    }
     _applyConventionDefaults() {
         if (this._config.gatingConfigPath === null) {
             const candidate = "config/gating.toml";

package/dist/builder.js.map

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

package/dist/cjs/agent-builder.cjs

@@ -22,12 +22,32 @@ class CallbackDispatcher {
     _errorCallback = null;
     _toolHandlers = new Map();
     _scopeTools = new Map();
+    _continuityStore = null;
+    _leaseProvider = null;
+    _rosterProvider = null;
+    _agentCustomizer = null;
+    _topologyProvider = null;
     registerBuilder(builder) {
         this._builder = builder;
     }
     registerErrorCallback(callback) {
         this._errorCallback = callback;
     }
+    registerContinuityStore(store) {
+        this._continuityStore = store;
+    }
+    registerLeaseProvider(provider) {
+        this._leaseProvider = provider;
+    }
+    registerRosterProvider(provider) {
+        this._rosterProvider = provider;
+    }
+    registerAgentCustomizer(customizer) {
+        this._agentCustomizer = customizer;
+    }
+    registerTopologyProvider(provider) {
+        this._topologyProvider = provider;
+    }
     /** Remove all tool handlers for a scope. Call when a session ends. */
     releaseScope(scopeId) {
         const tools = this._scopeTools.get(scopeId);
@@ -51,6 +71,27 @@ class CallbackDispatcher {
             }
             return null;
         }
+        if (method === "callback/after_create") {
+            if (this._builder !== null && typeof this._builder.afterCreate === "function") {
+                const sessionId = String(params.session_id ?? "");
+                const context = {
+                    model: String(params.model ?? ""),
+                    labels: typeof params.labels === "object" && params.labels !== null
+                        ? params.labels
+                        : {},
+                    systemPrompt: typeof params.system_prompt === "string"
+                        ? params.system_prompt
+                        : null,
+                };
+                try {
+                    await this._builder.afterCreate(sessionId, context);
+                }
+                catch {
+                    // Best-effort — swallow afterCreate failures.
+                }
+            }
+            return null;
+        }
         if (method === "callback/build_agent") {
             if (this._builder === null) {
                 throw new Error("no SessionAgentBuilder registered");
@@ -108,6 +149,130 @@ class CallbackDispatcher {
             const result = await handler(args);
             return { content: result };
         }
+        // -- Continuity callbacks -----------------------------------------------
+        if (method === "callback/continuity/resolve_many") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const identities = Array.isArray(params.identities)
+                ? params.identities.map(String)
+                : [];
+            return this._continuityStore.resolveMany(identities);
+        }
+        if (method === "callback/continuity/load_session_snapshot") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const sessionId = String(params.session_id ?? "");
+            const snap = await this._continuityStore.loadSessionSnapshot(sessionId);
+            if (snap === null)
+                return null;
+            return (0, types_js_1.sessionSnapshotToDict)(snap);
+        }
+        if (method === "callback/continuity/save_session_snapshot") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const identity = String(params.identity ?? "");
+            const sessionId = String(params.session_id ?? "");
+            const generation = Number(params.generation ?? 0);
+            const version = Number(params.checkpoint_version ?? 0);
+            const fencingToken = Number(params.fencing_token ?? 0);
+            const snapshot = (0, types_js_1.parseSessionSnapshot)({ data: params.snapshot ?? "" });
+            await this._continuityStore.saveSessionSnapshot(identity, sessionId, generation, version, fencingToken, snapshot);
+            return null;
+        }
+        if (method === "callback/continuity/upsert_continuity_record") {
+            if (this._continuityStore === null) {
+                throw new Error("no ContinuityStore registered");
+            }
+            const record = (0, types_js_1.parseContinuityRecord)(params.record);
+            const fencingToken = Number(params.fencing_token ?? 0);
+            await this._continuityStore.upsertContinuityRecord(record, fencingToken);
+            return null;
+        }
+        // -- Lease callbacks ----------------------------------------------------
+        if (method === "callback/lease/acquire_leases") {
+            if (this._leaseProvider === null) {
+                throw new Error("no LeaseProvider registered");
+            }
+            const identities = Array.isArray(params.identities)
+                ? params.identities.map(String)
+                : [];
+            const runtimeInstance = String(params.runtime_instance ?? "");
+            return this._leaseProvider.acquireLeases(identities, runtimeInstance);
+        }
+        if (method === "callback/lease/renew_leases") {
+            if (this._leaseProvider === null) {
+                throw new Error("no LeaseProvider registered");
+            }
+            const rawGrants = Array.isArray(params.grants) ? params.grants : [];
+            const grants = rawGrants.map(types_js_1.parseLeaseGrant);
+            return this._leaseProvider.renewLeases(grants);
+        }
+        if (method === "callback/lease/release_leases") {
+            if (this._leaseProvider === null) {
+                throw new Error("no LeaseProvider registered");
+            }
+            const rawGrants = Array.isArray(params.grants) ? params.grants : [];
+            const grants = rawGrants.map(types_js_1.parseLeaseGrant);
+            await this._leaseProvider.releaseLeases(grants);
+            return null;
+        }
+        // -- Roster callback ----------------------------------------------------
+        if (method === "callback/roster") {
+            if (this._rosterProvider === null) {
+                throw new Error("no RosterProvider registered");
+            }
+            const context = params.context ?? {};
+            const specs = await this._rosterProvider.roster(context);
+            return specs.map(types_js_1.durableAgentSpecToDict);
+        }
+        // -- Topology callback --------------------------------------------------
+        if (method === "callback/topology/compute_edges") {
+            if (this._topologyProvider === null) {
+                throw new Error("no TopologyProvider registered");
+            }
+            const targetIdentities = Array.isArray(params.target_identities)
+                ? params.target_identities.map(String)
+                : [];
+            const context = params.context ?? {};
+            const edges = await this._topologyProvider.computeEdges(targetIdentities, context);
+            return edges.map(types_js_1.managedPeerEdgeToDict);
+        }
+        // -- Customizer callbacks -----------------------------------------------
+        if (method === "callback/customizer/customize_build") {
+            if (this._agentCustomizer === null) {
+                throw new Error("no AgentCustomizer registered");
+            }
+            const context = (0, types_js_1.parseAgentBuildContext)(params.context);
+            const spec = (0, types_js_1.parseDurableAgentSpec)(params.spec);
+            const draft = (0, types_js_1.parseAgentBuildDraft)(params.draft);
+            await this._agentCustomizer.customizeBuild(context, spec, draft);
+            return (0, types_js_1.agentBuildDraftToDict)(draft);
+        }
+        if (method === "callback/customizer/after_create") {
+            if (this._agentCustomizer !== null &&
+                typeof this._agentCustomizer.afterCreate === "function") {
+                const identity = String(params.identity ?? "");
+                const sessionId = String(params.session_id ?? "");
+                const rawLabels = (params.labels != null && typeof params.labels === "object")
+                    ? Object.fromEntries(Object.entries(params.labels).map(([k, v]) => [k, String(v)]))
+                    : {};
+                const context = {
+                    model: String(params.model ?? ""),
+                    labels: rawLabels,
+                    systemPrompt: typeof params.system_prompt === "string" ? params.system_prompt : null,
+                };
+                try {
+                    await this._agentCustomizer.afterCreate(identity, sessionId, context);
+                }
+                catch {
+                    // Best-effort — swallow afterCreate failures.
+                }
+            }
+            return null;
+        }
         throw new Error(`unknown callback method: ${method}`);
     }
 }