@rkat/mobkit-sdk 0.6.14 → 0.6.16

package/dist/cjs/index.cjs

@@ -25,9 +25,9 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMobStructuralEvent = exports.parsePersistedEvent = exports.parseReconcileEdgesReport = exports.parseRediscoverReport = exports.parseGatingPendingEntry = exports.parseGatingAuditEntry = exports.parseGatingDecisionResult = exports.parseGatingEvaluateResult = exports.parseRuntimeRouteResult = exports.parseMemberSnapshot = exports.parseCallToolResult = exports.parseMemoryIndexResult = exports.parseMemoryStoreInfo = exports.parseMemoryQueryResult = exports.parseDeliveryHistoryResult = exports.parseDeliveryResult = exports.parseRoutingResolution = exports.parseSendMessageResult = exports.parseSubscribeResult = exports.parseEventEnvelope = exports.parseKeepAliveConfig = exports.parseSpawnResult = exports.parseReconcileResult = exports.parseCapabilitiesResult = exports.parseStatusResult = exports.ErrorCategory = exports.MEMBER_STATE_RETIRING = exports.MEMBER_STATE_ACTIVE = exports.isMobEventsStaleError = exports.isRpcError = exports.MobkitRpcError = exports.NotConnectedError = exports.ContractMismatchError = exports.CapabilityUnavailableError = exports.MOB_EVENTS_STALE_CURSOR_CODE = exports.MobEventsStaleError = exports.RpcError = exports.TransportError = exports.MobKitError = exports.CallbackDispatcher = exports.sessionQueryToDict = exports.preSpawnDataToDict = exports.discoverySpecToDict = exports.SessionBuildOptions = exports.SseBridge = exports.ToolCaller = exports.MobHandle = exports.MobKitRuntime = exports.MobKitBuilder = exports.MobKit = void 0;
-exports.buildConsoleRoute = exports.defineModule = exports.defineModuleTool = exports.decorateModuleTool = exports.decorateModuleSpec = exports.defineModuleSpec = exports.sessionStore = exports.memory = exports.auth = exports.EventStream = exports.isToolCallRequested = exports.isTurnCompleted = exports.isRunFailed = exports.isRunCompleted = exports.isTextComplete = exports.isTextDelta = exports.parseAgentEventFromSse = exports.parseMobEventFromSse = exports.parseAgentEvent = exports.parseBlobUploadResult = exports.parseLeaseRenewResult = exports.parseLeaseAcquireResult = exports.leaseGrantToDict = exports.parseLeaseGrant = exports.sessionSnapshotToDict = exports.parseSessionSnapshot = exports.parseContinuityResolveState = exports.parseContinuityFailure = exports.continuityRecordToDict = exports.parseContinuityRecord = exports.parseIdentityStatus = exports.agentBuildDraftToDict = exports.parseAgentBuildDraft = exports.parseAgentBuildContext = exports.externalToolDefToDict = exports.parseExternalToolDef = exports.managedPeerEdgeToDict = exports.parseManagedPeerEdge = exports.dispatchInputToDict = exports.parseDispatchInput = exports.durableAgentSpecToDict = exports.parseDurableAgentSpec = exports.eventQueryToDict = exports.parseErrorEvent = exports.parseLoopIterationRecord = exports.parseLoopRecord = exports.parseFrameRecord = exports.parseFailureRecord = exports.parseStepRecord = exports.parseMobRun = void 0;
-exports.MobkitAsyncClient = exports.MobkitTypedClient = exports.encodeSseEvent = exports.parseSseStream = exports.createJsonRpcHttpTransport = exports.createGatewayAsyncTransport = exports.createGatewaySyncTransport = exports.buildJsonRpcRequest = exports.PersistentTransport = exports.buildConsoleRoutes = exports.buildConsoleExperienceRoute = exports.buildConsoleModulesRoute = void 0;
+exports.parseRediscoverReport = exports.parseGatingPendingEntry = exports.parseGatingAuditEntry = exports.parseGatingDecisionResult = exports.parseGatingEvaluateResult = exports.parseRuntimeRouteResult = exports.parseMemberSnapshot = exports.parseCallToolResult = exports.parseMemoryIndexResult = exports.parseMemoryStoreInfo = exports.parseMemoryQueryResult = exports.parseDeliveryHistoryResult = exports.parseDeliveryResult = exports.parseRoutingResolution = exports.parseSendMessageResult = exports.parseSubscribeResult = exports.parseEventEnvelope = exports.parseKeepAliveConfig = exports.parseSpawnResult = exports.parseReconcileResult = exports.parseCapabilitiesResult = exports.parseStatusResult = exports.ErrorCategory = exports.MEMBER_STATE_RETIRING = exports.MEMBER_STATE_ACTIVE = exports.isMobEventsStaleError = exports.isRpcError = exports.MobkitRpcError = exports.NotConnectedError = exports.ContractMismatchError = exports.MemoryBackendUnavailableError = exports.CapabilityUnavailableError = exports.MEMORY_BACKEND_UNAVAILABLE_CODE = exports.CAPABILITY_UNAVAILABLE_CODE = exports.MOB_EVENTS_STALE_CURSOR_CODE = exports.MobEventsStaleError = exports.RpcError = exports.TransportError = exports.MobKitError = exports.CallbackDispatcher = exports.sessionQueryToDict = exports.preSpawnDataToDict = exports.discoverySpecToDict = exports.SessionBuildOptions = exports.SseBridge = exports.ToolCaller = exports.MobHandle = exports.MobKitRuntime = exports.MobKitBuilder = exports.MobKit = void 0;
+exports.isToolCallRequested = exports.isTurnCompleted = exports.isRunFailed = exports.isRunCompleted = exports.isTextComplete = exports.isTextDelta = exports.parseAgentEventFromSse = exports.parseMobEventFromSse = exports.parseAgentEvent = exports.parseBlobUploadResult = exports.leaseRenewResultToDict = exports.parseLeaseRenewResult = exports.leaseAcquireResultToDict = exports.parseLeaseAcquireResult = exports.leaseGrantToDict = exports.parseLeaseGrant = exports.sessionSnapshotToDict = exports.parseSessionSnapshot = exports.parseContinuityResolveState = exports.parseContinuityFailure = exports.continuityRecordToDict = exports.parseContinuityRecord = exports.parseIdentityStatus = exports.agentBuildDraftToDict = exports.parseAgentBuildDraft = exports.parseAgentBuildContext = exports.externalToolDefToDict = exports.parseExternalToolDef = exports.managedPeerEdgeToDict = exports.parseManagedPeerEdge = exports.dispatchInputToDict = exports.parseDispatchInput = exports.durableAgentSpecToDict = exports.parseDurableAgentSpec = exports.eventQueryToDict = exports.parseErrorEvent = exports.parseLoopIterationRecord = exports.parseLoopRecord = exports.parseFrameRecord = exports.parseFailureRecord = exports.parseStepRecord = exports.parseModelsCatalogResult = exports.parseCrossMobContactEntry = exports.parseMobRunSnapshot = exports.parseHelperResult = exports.parseRichMemberSnapshot = exports.parseMobRun = exports.parseMobStructuralEvent = exports.parsePersistedEvent = exports.parseReconcileEdgesReport = void 0;
+exports.MobkitAsyncClient = exports.MobkitTypedClient = exports.encodeSseEvent = exports.parseSseStream = exports.createJsonRpcHttpTransport = exports.createGatewayAsyncTransport = exports.createGatewaySyncTransport = exports.buildJsonRpcRequest = exports.PersistentTransport = exports.buildConsoleRoutes = exports.buildConsoleExperienceRoute = exports.buildConsoleModulesRoute = exports.buildConsoleRoute = exports.defineModule = exports.defineModuleTool = exports.decorateModuleTool = exports.decorateModuleSpec = exports.defineModuleSpec = exports.sessionStore = exports.memory = exports.auth = exports.EventStream = void 0;
 // -- Builder + Runtime ----------------------------------------------------
 var builder_js_1 = require("./builder.cjs");
 Object.defineProperty(exports, "MobKit", { enumerable: true, get: function () { return builder_js_1.MobKit; } });
@@ -53,7 +53,10 @@ Object.defineProperty(exports, "TransportError", { enumerable: true, get: functi
 Object.defineProperty(exports, "RpcError", { enumerable: true, get: function () { return errors_js_1.RpcError; } });
 Object.defineProperty(exports, "MobEventsStaleError", { enumerable: true, get: function () { return errors_js_1.MobEventsStaleError; } });
 Object.defineProperty(exports, "MOB_EVENTS_STALE_CURSOR_CODE", { enumerable: true, get: function () { return errors_js_1.MOB_EVENTS_STALE_CURSOR_CODE; } });
+Object.defineProperty(exports, "CAPABILITY_UNAVAILABLE_CODE", { enumerable: true, get: function () { return errors_js_1.CAPABILITY_UNAVAILABLE_CODE; } });
+Object.defineProperty(exports, "MEMORY_BACKEND_UNAVAILABLE_CODE", { enumerable: true, get: function () { return errors_js_1.MEMORY_BACKEND_UNAVAILABLE_CODE; } });
 Object.defineProperty(exports, "CapabilityUnavailableError", { enumerable: true, get: function () { return errors_js_1.CapabilityUnavailableError; } });
+Object.defineProperty(exports, "MemoryBackendUnavailableError", { enumerable: true, get: function () { return errors_js_1.MemoryBackendUnavailableError; } });
 Object.defineProperty(exports, "ContractMismatchError", { enumerable: true, get: function () { return errors_js_1.ContractMismatchError; } });
 Object.defineProperty(exports, "NotConnectedError", { enumerable: true, get: function () { return errors_js_1.NotConnectedError; } });
 Object.defineProperty(exports, "MobkitRpcError", { enumerable: true, get: function () { return errors_js_1.MobkitRpcError; } });
@@ -90,6 +93,11 @@ Object.defineProperty(exports, "parseReconcileEdgesReport", { enumerable: true,
 Object.defineProperty(exports, "parsePersistedEvent", { enumerable: true, get: function () { return types_js_1.parsePersistedEvent; } });
 Object.defineProperty(exports, "parseMobStructuralEvent", { enumerable: true, get: function () { return types_js_1.parseMobStructuralEvent; } });
 Object.defineProperty(exports, "parseMobRun", { enumerable: true, get: function () { return types_js_1.parseMobRun; } });
+Object.defineProperty(exports, "parseRichMemberSnapshot", { enumerable: true, get: function () { return types_js_1.parseRichMemberSnapshot; } });
+Object.defineProperty(exports, "parseHelperResult", { enumerable: true, get: function () { return types_js_1.parseHelperResult; } });
+Object.defineProperty(exports, "parseMobRunSnapshot", { enumerable: true, get: function () { return types_js_1.parseMobRunSnapshot; } });
+Object.defineProperty(exports, "parseCrossMobContactEntry", { enumerable: true, get: function () { return types_js_1.parseCrossMobContactEntry; } });
+Object.defineProperty(exports, "parseModelsCatalogResult", { enumerable: true, get: function () { return types_js_1.parseModelsCatalogResult; } });
 Object.defineProperty(exports, "parseStepRecord", { enumerable: true, get: function () { return types_js_1.parseStepRecord; } });
 Object.defineProperty(exports, "parseFailureRecord", { enumerable: true, get: function () { return types_js_1.parseFailureRecord; } });
 Object.defineProperty(exports, "parseFrameRecord", { enumerable: true, get: function () { return types_js_1.parseFrameRecord; } });
@@ -119,7 +127,9 @@ Object.defineProperty(exports, "sessionSnapshotToDict", { enumerable: true, get:
 Object.defineProperty(exports, "parseLeaseGrant", { enumerable: true, get: function () { return types_js_1.parseLeaseGrant; } });
 Object.defineProperty(exports, "leaseGrantToDict", { enumerable: true, get: function () { return types_js_1.leaseGrantToDict; } });
 Object.defineProperty(exports, "parseLeaseAcquireResult", { enumerable: true, get: function () { return types_js_1.parseLeaseAcquireResult; } });
+Object.defineProperty(exports, "leaseAcquireResultToDict", { enumerable: true, get: function () { return types_js_1.leaseAcquireResultToDict; } });
 Object.defineProperty(exports, "parseLeaseRenewResult", { enumerable: true, get: function () { return types_js_1.parseLeaseRenewResult; } });
+Object.defineProperty(exports, "leaseRenewResultToDict", { enumerable: true, get: function () { return types_js_1.leaseRenewResultToDict; } });
 Object.defineProperty(exports, "parseBlobUploadResult", { enumerable: true, get: function () { return types_js_1.parseBlobUploadResult; } });
 // -- Typed events ---------------------------------------------------------
 var events_js_1 = require("./events.cjs");

package/dist/cjs/runtime.cjs

@@ -206,6 +206,20 @@ class MobKitRuntime {
         if (this._config.eventLog) {
             runtimeOptions.event_log = serializeConfig(this._config.eventLog);
         }
+        if (this._config.consoleConfigPath) {
+            runtimeOptions.console_config_path = this._config.consoleConfigPath;
+        }
+        if (this._config.consoleRequireAppAuth !== null) {
+            runtimeOptions.console_require_app_auth =
+                this._config.consoleRequireAppAuth;
+        }
+        if (this._config.demoLlm) {
+            runtimeOptions.demo_llm = true;
+        }
+        if (this._config.implicitDelegateIdleRetireSecs !== undefined) {
+            runtimeOptions.implicit_delegate_idle_retire_secs =
+                this._config.implicitDelegateIdleRetireSecs;
+        }
         params.runtime_options = runtimeOptions;
         if (this._config.persistentState) {
             params.persistent_state = this._config.persistentState;
@@ -213,6 +227,15 @@ class MobKitRuntime {
         if (this._config.rosterProvider !== null) {
             params.has_roster_provider = true;
         }
+        if (this._config.continuityStore !== null) {
+            params.has_continuity_store = true;
+        }
+        if (this._config.leaseProvider !== null) {
+            params.has_lease_provider = true;
+        }
+        if (this._config.scratchDir !== null) {
+            params.scratch_dir = this._config.scratchDir;
+        }
         if (this._config.topologyProvider !== null) {
             params.has_topology_provider = true;
         }
@@ -231,7 +254,19 @@ class MobKitRuntime {
         const response = (await this._transport.sendAsync(request));
         if ("error" in response) {
             const err = response.error;
-            throw new errors_js_1.RpcError(Number(err.code ?? -1), String(err.message ?? String(err)), rid, method, err.data);
+            const code = Number(err.code ?? -1);
+            const message = String(err.message ?? String(err));
+            if (code === errors_js_1.CAPABILITY_UNAVAILABLE_CODE) {
+                throw new errors_js_1.CapabilityUnavailableError(message, rid, method, err.data);
+            }
+            if (code === errors_js_1.MEMORY_BACKEND_UNAVAILABLE_CODE) {
+                throw new errors_js_1.MemoryBackendUnavailableError(message, rid, method, err.data);
+            }
+            const rpcError = new errors_js_1.RpcError(code, message, rid, method, err.data);
+            if (code === errors_js_1.MOB_EVENTS_STALE_CURSOR_CODE) {
+                throw errors_js_1.MobEventsStaleError.fromRpcError(rpcError);
+            }
+            throw rpcError;
         }
         return response.result;
     }
@@ -311,6 +346,14 @@ class MobKitRuntime {
     async deleteIdentity(identity) {
         return this._rpc("mobkit/delete_identity", { identity });
     }
+    /** Inspect identity continuity/runtime state. */
+    async inspectIdentity(identity) {
+        return this._rpc("mobkit/inspect_identity", { identity });
+    }
+    /** Re-run identity-first reconciliation. */
+    async reconcileIdentity() {
+        return this._rpc("mobkit/reconcile_identity", {});
+    }
 }
 exports.MobKitRuntime = MobKitRuntime;
 // -- MobHandle ------------------------------------------------------------
@@ -337,6 +380,9 @@ class MobHandle {
     async capabilities() {
         return (0, types_js_1.parseCapabilitiesResult)(await this._runtime._rpc("mobkit/capabilities"));
     }
+    async modelsCatalog() {
+        return (0, types_js_1.parseModelsCatalogResult)(await this._runtime._rpc("mobkit/models/catalog"));
+    }
     // -- Spawn & reconcile --------------------------------------------------
     async spawn(spec) {
         return (0, types_js_1.parseSpawnResult)(await this._runtime._rpc("mobkit/spawn_member", (0, models_js_1.discoverySpecToDict)(spec)));
@@ -528,7 +574,19 @@ class MobHandle {
         }
         if ("error" in body) {
             const err = body.error;
-            throw new errors_js_1.RpcError(Number(err.code ?? -1), String(err.message ?? String(err)), id, method, err.data);
+            const code = Number(err.code ?? -1);
+            const message = String(err.message ?? String(err));
+            if (code === errors_js_1.CAPABILITY_UNAVAILABLE_CODE) {
+                throw new errors_js_1.CapabilityUnavailableError(message, id, method, err.data);
+            }
+            if (code === errors_js_1.MEMORY_BACKEND_UNAVAILABLE_CODE) {
+                throw new errors_js_1.MemoryBackendUnavailableError(message, id, method, err.data);
+            }
+            const rpcError = new errors_js_1.RpcError(code, message, id, method, err.data);
+            if (code === errors_js_1.MOB_EVENTS_STALE_CURSOR_CODE) {
+                throw errors_js_1.MobEventsStaleError.fromRpcError(rpcError);
+            }
+            throw rpcError;
         }
         if (!response.ok) {
             throw new errors_js_1.TransportError(`multipart RPC failed (status=${response.status}): ${responseText}`);
@@ -583,6 +641,14 @@ class MobHandle {
             member_id: memberId,
         });
     }
+    async memberStatus(memberId) {
+        return (0, types_js_1.parseRichMemberSnapshot)(await this._runtime._rpc("mobkit/member_status", { member_id: memberId }));
+    }
+    async forceCancelMember(memberId) {
+        await this._runtime._rpc("mobkit/force_cancel_member", {
+            member_id: memberId,
+        });
+    }
     /**
      * Wait until all current mob members are startup-ready for orchestration.
      *
@@ -607,6 +673,18 @@ class MobHandle {
         };
     }
     // -- Flows --------------------------------------------------------------
+    async cancelFlow(runId) {
+        await this._runtime._rpc("mobkit/cancel_flow", { run_id: runId });
+    }
+    async flowStatus(runId) {
+        const raw = await this._runtime._rpc("mobkit/flow_status", { run_id: runId });
+        if (raw === null)
+            return null;
+        if (typeof raw === "object" && raw !== null && raw.status === "not_found") {
+            return null;
+        }
+        return (0, types_js_1.parseMobRunSnapshot)(raw);
+    }
     /**
      * List all configured flow IDs in this mob definition. Relays meerkat
      * 0.6's `MobHandle::list_flows`. Order is unspecified.
@@ -672,6 +750,38 @@ class MobHandle {
         }
         throw new Error(`unexpected run_flow response: ${JSON.stringify(raw)}`);
     }
+    async collectCompleted() {
+        const raw = await this._runtime._rpc("mobkit/collect_completed");
+        const entries = typeof raw === "object" && raw !== null
+            ? (Array.isArray(raw.completed)
+                ? raw.completed
+                : [])
+            : Array.isArray(raw)
+                ? raw
+                : [];
+        const result = [];
+        for (const entry of entries) {
+            const record = typeof entry === "object" && entry !== null
+                ? entry
+                : {};
+            const memberId = String(record.member_id ?? "");
+            result.push([memberId, (0, types_js_1.parseRichMemberSnapshot)(record.snapshot ?? record)]);
+        }
+        return result;
+    }
+    // -- Scheduling ---------------------------------------------------------
+    async schedulingEvaluate(schedules, tickMs) {
+        return this._runtime._rpc("mobkit/scheduling/evaluate", {
+            schedules: [...schedules],
+            tick_ms: tickMs,
+        });
+    }
+    async schedulingDispatch(schedules, tickMs) {
+        return this._runtime._rpc("mobkit/scheduling/dispatch", {
+            schedules: [...schedules],
+            tick_ms: tickMs,
+        });
+    }
     // -- Routing ------------------------------------------------------------
     async resolveRouting(recipient, options) {
         return (0, types_js_1.parseRoutingResolution)(await this._runtime._rpc("mobkit/routing/resolve", {
@@ -754,6 +864,9 @@ class MobHandle {
     toolCaller(moduleId) {
         return new ToolCaller(this, moduleId);
     }
+    async sessionStoreBigQuery(options) {
+        return this._runtime._rpc("mobkit/session_store/bigquery", options);
+    }
     // -- Gating -------------------------------------------------------------
     async gatingEvaluate(action, actorId, options) {
         return (0, types_js_1.parseGatingEvaluateResult)(await this._runtime._rpc("mobkit/gating/evaluate", {
@@ -797,6 +910,118 @@ class MobHandle {
     async reconcileEdges() {
         return (0, types_js_1.parseReconcileEdgesReport)(await this._runtime._rpc("mobkit/reconcile_edges"));
     }
+    // -- Cross-mob ----------------------------------------------------------
+    async listExternalMobs() {
+        const raw = await this._runtime._rpc("mobkit/cross_mob/directory");
+        const mobs = typeof raw === "object" && raw !== null
+            ? (Array.isArray(raw.mobs)
+                ? raw.mobs
+                : [])
+            : [];
+        return mobs.map(types_js_1.parseCrossMobContactEntry);
+    }
+    async peerInfo(memberId) {
+        const raw = await this._runtime._rpc("mobkit/cross_mob/peer_info", {
+            member_id: memberId,
+        });
+        const out = {};
+        if (typeof raw === "object" && raw !== null) {
+            for (const [k, v] of Object.entries(raw)) {
+                out[k] = String(v);
+            }
+        }
+        return out;
+    }
+    async peerPubkey() {
+        const raw = await this._runtime._rpc("mobkit/peer_pubkey");
+        return typeof raw === "object" && raw !== null
+            ? String(raw.pubkey_b64 ?? "")
+            : "";
+    }
+    async wireLocal(localMemberId, remoteCommsName, remotePeerId, remoteAddress, options) {
+        const params = {
+            local_member_id: localMemberId,
+            remote_comms_name: remoteCommsName,
+            remote_peer_id: remotePeerId,
+            remote_address: remoteAddress,
+        };
+        if (options?.remotePubkeyB64) {
+            params.remote_pubkey_b64 = options.remotePubkeyB64;
+        }
+        await this._runtime._rpc("mobkit/cross_mob/wire_local", params);
+    }
+    async unwireLocal(localMemberId, remoteCommsName, remotePeerId, remoteAddress, options) {
+        const params = {
+            local_member_id: localMemberId,
+            remote_comms_name: remoteCommsName,
+            remote_peer_id: remotePeerId,
+            remote_address: remoteAddress,
+        };
+        if (options?.remotePubkeyB64) {
+            params.remote_pubkey_b64 = options.remotePubkeyB64;
+        }
+        await this._runtime._rpc("mobkit/cross_mob/unwire_local", params);
+    }
+    async wireCrossMob(localMemberId, remoteMemberId, remoteHandle) {
+        const localInfo = await this.peerInfo(localMemberId);
+        const remoteInfo = await remoteHandle.peerInfo(remoteMemberId);
+        await this.wireLocal(localMemberId, remoteInfo.comms_name, remoteInfo.peer_id, remoteInfo.address);
+        try {
+            await remoteHandle.wireLocal(remoteMemberId, localInfo.comms_name, localInfo.peer_id, localInfo.address);
+        }
+        catch (err) {
+            try {
+                await this.unwireLocal(localMemberId, remoteInfo.comms_name, remoteInfo.peer_id, remoteInfo.address);
+            }
+            catch {
+                // Best-effort rollback; preserve the original remote error.
+            }
+            throw err;
+        }
+    }
+    async sendCrossMob(remoteMemberId, remoteHandle, message) {
+        return remoteHandle.send(remoteMemberId, message);
+    }
+    // -- Helper members -----------------------------------------------------
+    async spawnHelper(agentIdentity, task, options) {
+        const helperOptions = {};
+        if (options?.role)
+            helperOptions.role = options.role;
+        if (options?.runtimeMode)
+            helperOptions.runtime_mode = options.runtimeMode;
+        if (options?.backend)
+            helperOptions.backend = options.backend;
+        const params = { agent_identity: agentIdentity, task };
+        if (Object.keys(helperOptions).length > 0)
+            params.options = helperOptions;
+        return (0, types_js_1.parseHelperResult)(await this._runtime._rpc("mobkit/spawn_helper", params));
+    }
+    async forkHelper(sourceMemberId, agentIdentity, task, options) {
+        const helperOptions = {};
+        if (options?.role)
+            helperOptions.role = options.role;
+        if (options?.runtimeMode)
+            helperOptions.runtime_mode = options.runtimeMode;
+        if (options?.backend)
+            helperOptions.backend = options.backend;
+        const params = {
+            source_member_id: sourceMemberId,
+            agent_identity: agentIdentity,
+            task,
+        };
+        if (options?.forkContext)
+            params.fork_context = options.forkContext;
+        if (Object.keys(helperOptions).length > 0)
+            params.options = helperOptions;
+        return (0, types_js_1.parseHelperResult)(await this._runtime._rpc("mobkit/fork_helper", params));
+    }
+    async attachSession(role, agentIdentity, sessionId) {
+        return (0, types_js_1.parseRichMemberSnapshot)(await this._runtime._rpc("mobkit/attach_existing_session", {
+            role,
+            agent_identity: agentIdentity,
+            session_id: sessionId,
+        }));
+    }
     // -- Mob/run labels — mobkit-side sidecar metadata ----------------------
     /**
      * Replace the label set associated with this mob.

package/dist/cjs/types.cjs

@@ -39,6 +39,15 @@ exports.parseFrameRecord = parseFrameRecord;
 exports.parseLoopRecord = parseLoopRecord;
 exports.parseLoopIterationRecord = parseLoopIterationRecord;
 exports.parseMobRun = parseMobRun;
+exports.parseMobUnreachablePeer = parseMobUnreachablePeer;
+exports.parsePeerConnectivitySnapshot = parsePeerConnectivitySnapshot;
+exports.parseRichMemberSnapshot = parseRichMemberSnapshot;
+exports.parseHelperResult = parseHelperResult;
+exports.parseMobRunSnapshot = parseMobRunSnapshot;
+exports.parseCrossMobContactEntry = parseCrossMobContactEntry;
+exports.parseCatalogEntry = parseCatalogEntry;
+exports.parseProviderDefaults = parseProviderDefaults;
+exports.parseModelsCatalogResult = parseModelsCatalogResult;
 exports.parseErrorEvent = parseErrorEvent;
 exports.parseDurableAgentSpec = parseDurableAgentSpec;
 exports.durableAgentSpecToDict = durableAgentSpecToDict;
@@ -64,7 +73,9 @@ exports.sessionSnapshotToDict = sessionSnapshotToDict;
 exports.parseLeaseGrant = parseLeaseGrant;
 exports.leaseGrantToDict = leaseGrantToDict;
 exports.parseLeaseAcquireResult = parseLeaseAcquireResult;
+exports.leaseAcquireResultToDict = leaseAcquireResultToDict;
 exports.parseLeaseRenewResult = parseLeaseRenewResult;
+exports.leaseRenewResultToDict = leaseRenewResultToDict;
 // -- Helpers (internal) ---------------------------------------------------
 function asRecord(value) {
     if (typeof value === "object" && value !== null) {
@@ -94,6 +105,15 @@ function asStringRecord(value) {
     }
     return result;
 }
+function validateAgentIdentity(identity) {
+    if (identity.length === 0 ||
+        identity.trim() !== identity ||
+        /\s/.test(identity) ||
+        identity.includes("/")) {
+        throw new Error(`invalid agent identity: ${identity}`);
+    }
+    return identity;
+}
 // -- Constants ------------------------------------------------------------
 exports.MEMBER_STATE_ACTIVE = "active";
 exports.MEMBER_STATE_RETIRING = "retiring";
@@ -341,6 +361,24 @@ function parseRediscoverReport(raw) {
 }
 function parseUnifiedEvent(raw) {
     const d = asRecord(raw);
+    if (d.kind === "agent") {
+        return {
+            kind: "agent",
+            agentId: String(d.agent_id ?? d.agentId ?? ""),
+            eventType: String(d.event_type ?? d.eventType ?? ""),
+            payload: typeof d.payload === "object" && d.payload !== null
+                ? asRecord(d.payload)
+                : null,
+        };
+    }
+    if (d.kind === "module") {
+        return {
+            kind: "module",
+            module: String(d.module ?? ""),
+            eventType: String(d.event_type ?? d.eventType ?? ""),
+            payload: asRecord(d.payload),
+        };
+    }
     if ("Agent" in d) {
         const agent = asRecord(d.Agent);
         return {
@@ -530,6 +568,103 @@ function parseMobRun(raw) {
         loopIterationOutputs: iterOutputs,
     };
 }
+function parseMobUnreachablePeer(raw) {
+    const d = asRecord(raw);
+    return {
+        peer: String(d.peer ?? ""),
+        reason: typeof d.reason === "string" ? d.reason : null,
+    };
+}
+function parsePeerConnectivitySnapshot(raw) {
+    const d = asRecord(raw);
+    return {
+        reachablePeerCount: Number(d.reachable_peer_count ?? 0),
+        unknownPeerCount: Number(d.unknown_peer_count ?? 0),
+        unreachablePeers: asRecordArray(d.unreachable_peers).map(parseMobUnreachablePeer),
+    };
+}
+function parseRichMemberSnapshot(raw) {
+    const d = asRecord(raw);
+    return {
+        status: String(d.status ?? "unknown"),
+        outputPreview: typeof d.output_preview === "string" ? d.output_preview : null,
+        error: typeof d.error === "string" ? d.error : null,
+        tokensUsed: Number(d.tokens_used ?? 0),
+        isFinal: Boolean(d.is_final),
+        currentSessionId: typeof d.current_session_id === "string" ? d.current_session_id : null,
+        peerConnectivity: typeof d.peer_connectivity === "object" && d.peer_connectivity !== null
+            ? parsePeerConnectivitySnapshot(d.peer_connectivity)
+            : null,
+    };
+}
+function parseHelperResult(raw) {
+    const d = asRecord(raw);
+    return {
+        output: typeof d.output === "string" ? d.output : null,
+        tokensUsed: Number(d.tokens_used ?? 0),
+        sessionId: typeof d.session_id === "string" ? d.session_id : null,
+    };
+}
+function parseMobRunSnapshot(raw) {
+    const d = asRecord(raw);
+    return {
+        runId: String(d.run_id ?? ""),
+        mobId: String(d.mob_id ?? ""),
+        flowId: String(d.flow_id ?? ""),
+        status: String(d.status ?? "unknown"),
+        stepLedger: asRecordArray(d.step_ledger),
+        failureLedger: asRecordArray(d.failure_ledger),
+    };
+}
+function parseCrossMobContactEntry(raw) {
+    const d = asRecord(raw);
+    let transport = d.transport;
+    if (typeof transport === "object" && transport !== null) {
+        const t = asRecord(transport);
+        if (typeof t.Tcp === "string")
+            transport = `tcp://${t.Tcp}`;
+        else if (typeof t.Uds === "string")
+            transport = `uds://${t.Uds}`;
+        else
+            transport = "inproc";
+    }
+    else if (transport === "Inproc") {
+        transport = "inproc";
+    }
+    return {
+        mobId: String(d.mob_id ?? ""),
+        transport: String(transport ?? ""),
+    };
+}
+function parseCatalogEntry(raw) {
+    const d = asRecord(raw);
+    const profile = asRecord(d.profile);
+    return {
+        id: String(d.id ?? ""),
+        displayName: String(d.display_name ?? ""),
+        provider: String(d.provider ?? ""),
+        tier: String(d.tier ?? ""),
+        contextWindow: d.context_window == null ? null : Number(d.context_window),
+        maxOutputTokens: d.max_output_tokens == null ? null : Number(d.max_output_tokens),
+        vision: Boolean(profile.vision),
+        imageToolResults: Boolean(profile.image_tool_results),
+    };
+}
+function parseProviderDefaults(raw) {
+    const d = asRecord(raw);
+    return {
+        provider: String(d.provider ?? ""),
+        defaultModelId: String(d.default_model_id ?? ""),
+        models: asRecordArray(d.models).map(parseCatalogEntry),
+    };
+}
+function parseModelsCatalogResult(raw) {
+    const d = asRecord(raw);
+    return {
+        models: asRecordArray(d.models).map(parseCatalogEntry),
+        providerDefaults: asRecordArray(d.provider_defaults).map(parseProviderDefaults),
+    };
+}
 // -- ErrorCategory / ErrorEvent -------------------------------------------
 exports.ErrorCategory = {
     SPAWN_FAILURE: "spawn_failure",
@@ -579,7 +714,7 @@ function parseErrorEvent(raw) {
 function parseDurableAgentSpec(raw) {
     const d = asRecord(raw);
     return {
-        identity: String(d.identity ?? ""),
+        identity: validateAgentIdentity(String(d.identity ?? "")),
         profile: String(d.profile ?? ""),
         addressability: String(d.addressability ?? "addressable"),
         displayName: typeof d.display_name === "string" ? d.display_name : null,
@@ -719,10 +854,16 @@ function dispatchInputToDict(input) {
 }
 function parseManagedPeerEdge(raw) {
     const d = asRecord(raw);
-    return { a: String(d.a ?? ""), b: String(d.b ?? "") };
+    const a = validateAgentIdentity(String(d.a ?? ""));
+    const b = validateAgentIdentity(String(d.b ?? ""));
+    if (a === b) {
+        throw new Error(`managed peer edge cannot connect an identity to itself: ${a}`);
+    }
+    return a < b ? { a, b } : { a: b, b: a };
 }
 function managedPeerEdgeToDict(edge) {
-    return { a: edge.a, b: edge.b };
+    const parsed = parseManagedPeerEdge(edge);
+    return { a: parsed.a, b: parsed.b };
 }
 function parseExternalToolDef(raw) {
     const d = asRecord(raw);
@@ -897,31 +1038,68 @@ function parseLeaseGrant(raw) {
     return {
         identity: String(d.identity ?? ""),
         fencingToken: Number(d.fencing_token ?? 0),
-        ttlMs: Number(d.ttl_ms ?? 0),
+        ttlMs: Number(d.ttl ?? d.ttl_ms ?? 0),
     };
 }
 function leaseGrantToDict(grant) {
     return {
         identity: grant.identity,
         fencing_token: grant.fencingToken,
-        ttl_ms: grant.ttlMs,
+        ttl: grant.ttlMs,
     };
 }
 function parseLeaseAcquireResult(raw) {
     const d = asRecord(raw);
-    const wireStatus = String(d.status ?? "acquired");
+    const wireStatus = String(d.result ?? d.status ?? "acquired");
     const status = wireStatus === "already_held" ? "alreadyHeld" : "acquired";
     return {
         status,
-        grant: d.grant != null ? parseLeaseGrant(d.grant) : undefined,
+        identity: typeof d.identity === "string" ? d.identity : undefined,
+        grant: d.grant != null
+            ? parseLeaseGrant(d.grant)
+            : status === "acquired"
+                ? parseLeaseGrant(d)
+                : undefined,
         holder: typeof d.holder === "string" ? d.holder : undefined,
     };
 }
+function leaseAcquireResultToDict(result) {
+    if (result.status === "alreadyHeld") {
+        return {
+            result: "already_held",
+            identity: result.identity ?? result.grant?.identity ?? "",
+            holder: result.holder ?? "",
+        };
+    }
+    const grant = result.grant;
+    return {
+        result: "acquired",
+        ...(grant ? leaseGrantToDict(grant) : {}),
+    };
+}
 function parseLeaseRenewResult(raw) {
     const d = asRecord(raw);
-    const status = String(d.status ?? "renewed");
+    const status = String(d.result ?? d.status ?? "renewed");
     return {
         status,
-        grant: d.grant != null ? parseLeaseGrant(d.grant) : undefined,
+        identity: typeof d.identity === "string" ? d.identity : undefined,
+        grant: d.grant != null
+            ? parseLeaseGrant(d.grant)
+            : status === "renewed"
+                ? parseLeaseGrant(d)
+                : undefined,
+    };
+}
+function leaseRenewResultToDict(result) {
+    if (result.status === "lost") {
+        return {
+            result: "lost",
+            identity: result.identity ?? result.grant?.identity ?? "",
+        };
+    }
+    const grant = result.grant;
+    return {
+        result: "renewed",
+        ...(grant ? leaseGrantToDict(grant) : {}),
     };
 }

package/dist/config/auth.d.ts

@@ -6,6 +6,7 @@ export interface GoogleAuthConfig {
     readonly discoveryUrl: string;
     readonly audience: string | null;
     readonly leewaySeconds: number;
+    toDict(): Record<string, unknown>;
 }
 export declare function google(clientId: string, options?: {
     discoveryUrl?: string;
@@ -18,6 +19,7 @@ export interface JwtAuthConfig {
     readonly issuer: string | null;
     readonly audience: string | null;
     readonly leewaySeconds: number;
+    toDict(): Record<string, unknown>;
 }
 export declare function jwt(sharedSecret: string, options?: {
     issuer?: string;

package/dist/config/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/config/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,MAAM,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,gBAAgB,CASlB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,wBAAgB,GAAG,CACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,aAAa,CAOf;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/config/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,MAAM,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,gBAAgB,CAalB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,GAAG,CACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,aAAa,CAWf;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}