@rkat/mobkit-sdk 0.5.1 → 0.6.2

package/dist/cjs/builder.cjs

@@ -68,6 +68,13 @@ function defaultConfig() {
         authConfig: null,
         gatewayBin: null,
         modules: [],
+        persistentState: null,
+        continuityStore: null,
+        leaseProvider: null,
+        scratchDir: null,
+        rosterProvider: null,
+        agentCustomizer: null,
+        topologyProvider: null,
     };
 }
 // -- MobKitBuilder --------------------------------------------------------
@@ -139,12 +146,62 @@ 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 Promise.resolve().then(() => __importStar(require("./runtime.cjs")));
         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/cjs/errors.cjs

@@ -16,7 +16,9 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MobkitRpcError = exports.NotConnectedError = exports.ContractMismatchError = exports.CapabilityUnavailableError = exports.RpcError = exports.TransportError = exports.MobKitError = void 0;
+exports.MobkitRpcError = exports.NotConnectedError = exports.ContractMismatchError = exports.CapabilityUnavailableError = exports.MobEventsStaleError = exports.MOB_EVENTS_STALE_CURSOR_CODE = exports.RpcError = exports.TransportError = exports.MobKitError = void 0;
+exports.isRpcError = isRpcError;
+exports.isMobEventsStaleError = isMobEventsStaleError;
 // -- Base error -----------------------------------------------------------
 /** Base exception for all MobKit SDK errors. */
 class MobKitError extends Error {
@@ -41,15 +43,54 @@ class RpcError extends MobKitError {
     code;
     requestId;
     method;
-    constructor(code, message, requestId, method) {
+    data;
+    constructor(code, message, requestId, method, 
+    /** Optional structured payload from the JSON-RPC `error.data` field. */
+    data) {
         super(message);
         this.code = code;
         this.requestId = requestId;
         this.method = method;
+        this.data = data;
         this.name = "RpcError";
     }
 }
 exports.RpcError = RpcError;
+/**
+ * JSON-RPC error code returned when the caller's `after_seq` is past the
+ * current ledger frontier. Returned by `mobkit/mob_events/{query,subscribe}`
+ * and the `/mobkit/mob_events/stream` SSE route (HTTP 410 Gone).
+ */
+exports.MOB_EVENTS_STALE_CURSOR_CODE = -32010;
+/**
+ * Raised when the caller passes an `after_seq` past the current ledger
+ * frontier. The server's `error.data` payload carries `after_cursor` and
+ * `latest_cursor` — use the latter to rewind and resume.
+ */
+class MobEventsStaleError extends RpcError {
+    afterCursor;
+    latestCursor;
+    constructor(message, afterCursor, latestCursor, requestId, method, data) {
+        super(exports.MOB_EVENTS_STALE_CURSOR_CODE, message, requestId, method, data);
+        this.afterCursor = afterCursor;
+        this.latestCursor = latestCursor;
+        this.name = "MobEventsStaleError";
+    }
+    /**
+     * Reify a generic {@link RpcError} with code `-32010` into the typed
+     * form. Reads `after_cursor` / `latest_cursor` from the JSON-RPC
+     * `error.data` payload; missing fields fall back to `0`.
+     */
+    static fromRpcError(err) {
+        const payload = typeof err.data === "object" && err.data !== null
+            ? err.data
+            : {};
+        const afterCursor = Number(payload.after_cursor ?? 0);
+        const latestCursor = Number(payload.latest_cursor ?? 0);
+        return new MobEventsStaleError(err.message, Number.isFinite(afterCursor) ? afterCursor : 0, Number.isFinite(latestCursor) ? latestCursor : 0, err.requestId, err.method, err.data);
+    }
+}
+exports.MobEventsStaleError = MobEventsStaleError;
 // -- Capability errors ----------------------------------------------------
 /** Raised when a requested capability is not available on the runtime. */
 class CapabilityUnavailableError extends MobKitError {
@@ -77,6 +118,35 @@ class NotConnectedError extends MobKitError {
     }
 }
 exports.NotConnectedError = NotConnectedError;
+// -- Cross-module identity helpers ---------------------------------------
+/**
+ * Structural test for an `RpcError`. Pre-fix every site used
+ * `err instanceof RpcError`, but JS class identity is module-scoped:
+ * dual CJS+ESM packaging, vitest module isolation, and hoisted-vs-
+ * nested workspace deps can produce two `RpcError` constructors that
+ * fail `instanceof` for each other's instances. The structural check
+ * survives those splits.
+ */
+function isRpcError(err) {
+    if (err instanceof RpcError) {
+        return true;
+    }
+    if (err === null || typeof err !== "object") {
+        return false;
+    }
+    const candidate = err;
+    return (candidate.name === "RpcError" ||
+        candidate.name === "MobEventsStaleError") && typeof candidate.code === "number";
+}
+/** Structural test for a `MobEventsStaleError`. See `isRpcError`. */
+function isMobEventsStaleError(err) {
+    if (err instanceof MobEventsStaleError) {
+        return true;
+    }
+    return (isRpcError(err) &&
+        err.code === exports.MOB_EVENTS_STALE_CURSOR_CODE &&
+        err.name === "MobEventsStaleError");
+}
 // -- Backward compatibility -----------------------------------------------
 /** @deprecated Use {@link RpcError} instead. */
 exports.MobkitRpcError = RpcError;

package/dist/cjs/events.cjs

@@ -36,11 +36,21 @@ const EVENT_MAP = {
         sessionId: String(raw.session_id ?? ""),
         prompt: String(raw.prompt ?? ""),
     }),
-    run_completed: (raw) => ({
-        type: "run_completed",
-        sessionId: String(raw.session_id ?? ""),
-        result: String(raw.result ?? ""),
-    }),
+    run_completed: (raw) => {
+        // `structured_output` is `skip_serializing_if = "Option::is_none"`
+        // upstream, so the field is absent (not `null`) when there's no
+        // schema-extracted value. Mirror that on the TS side: undefined
+        // when missing, pass-through value otherwise.
+        const evt = {
+            type: "run_completed",
+            sessionId: String(raw.session_id ?? ""),
+            result: String(raw.result ?? ""),
+        };
+        if (raw.structured_output !== undefined) {
+            return { ...evt, structuredOutput: raw.structured_output };
+        }
+        return evt;
+    },
     run_failed: (raw) => ({
         type: "run_failed",
         sessionId: String(raw.session_id ?? ""),

package/dist/cjs/index.cjs

@@ -25,8 +25,9 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseAgentEventFromSse = exports.parseMobEventFromSse = exports.parseAgentEvent = exports.eventQueryToDict = exports.parseErrorEvent = 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.MobkitRpcError = exports.NotConnectedError = exports.ContractMismatchError = exports.CapabilityUnavailableError = 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.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 = exports.isToolCallRequested = exports.isTurnCompleted = exports.isRunFailed = exports.isRunCompleted = exports.isTextComplete = exports.isTextDelta = void 0;
+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.buildConsoleModulesRoute = 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.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 = void 0;
 // -- Builder + Runtime ----------------------------------------------------
 var builder_js_1 = require("./builder.cjs");
 Object.defineProperty(exports, "MobKit", { enumerable: true, get: function () { return builder_js_1.MobKit; } });
@@ -50,10 +51,14 @@ var errors_js_1 = require("./errors.cjs");
 Object.defineProperty(exports, "MobKitError", { enumerable: true, get: function () { return errors_js_1.MobKitError; } });
 Object.defineProperty(exports, "TransportError", { enumerable: true, get: function () { return errors_js_1.TransportError; } });
 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, "CapabilityUnavailableError", { enumerable: true, get: function () { return errors_js_1.CapabilityUnavailableError; } });
 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; } });
+Object.defineProperty(exports, "isRpcError", { enumerable: true, get: function () { return errors_js_1.isRpcError; } });
+Object.defineProperty(exports, "isMobEventsStaleError", { enumerable: true, get: function () { return errors_js_1.isMobEventsStaleError; } });
 // -- Typed return models --------------------------------------------------
 var types_js_1 = require("./types.cjs");
 Object.defineProperty(exports, "MEMBER_STATE_ACTIVE", { enumerable: true, get: function () { return types_js_1.MEMBER_STATE_ACTIVE; } });
@@ -83,8 +88,38 @@ Object.defineProperty(exports, "parseGatingPendingEntry", { enumerable: true, ge
 Object.defineProperty(exports, "parseRediscoverReport", { enumerable: true, get: function () { return types_js_1.parseRediscoverReport; } });
 Object.defineProperty(exports, "parseReconcileEdgesReport", { enumerable: true, get: function () { return types_js_1.parseReconcileEdgesReport; } });
 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, "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; } });
+Object.defineProperty(exports, "parseLoopRecord", { enumerable: true, get: function () { return types_js_1.parseLoopRecord; } });
+Object.defineProperty(exports, "parseLoopIterationRecord", { enumerable: true, get: function () { return types_js_1.parseLoopIterationRecord; } });
 Object.defineProperty(exports, "parseErrorEvent", { enumerable: true, get: function () { return types_js_1.parseErrorEvent; } });
 Object.defineProperty(exports, "eventQueryToDict", { enumerable: true, get: function () { return types_js_1.eventQueryToDict; } });
+// Identity-first parsers
+Object.defineProperty(exports, "parseDurableAgentSpec", { enumerable: true, get: function () { return types_js_1.parseDurableAgentSpec; } });
+Object.defineProperty(exports, "durableAgentSpecToDict", { enumerable: true, get: function () { return types_js_1.durableAgentSpecToDict; } });
+Object.defineProperty(exports, "parseDispatchInput", { enumerable: true, get: function () { return types_js_1.parseDispatchInput; } });
+Object.defineProperty(exports, "dispatchInputToDict", { enumerable: true, get: function () { return types_js_1.dispatchInputToDict; } });
+Object.defineProperty(exports, "parseManagedPeerEdge", { enumerable: true, get: function () { return types_js_1.parseManagedPeerEdge; } });
+Object.defineProperty(exports, "managedPeerEdgeToDict", { enumerable: true, get: function () { return types_js_1.managedPeerEdgeToDict; } });
+Object.defineProperty(exports, "parseExternalToolDef", { enumerable: true, get: function () { return types_js_1.parseExternalToolDef; } });
+Object.defineProperty(exports, "externalToolDefToDict", { enumerable: true, get: function () { return types_js_1.externalToolDefToDict; } });
+Object.defineProperty(exports, "parseAgentBuildContext", { enumerable: true, get: function () { return types_js_1.parseAgentBuildContext; } });
+Object.defineProperty(exports, "parseAgentBuildDraft", { enumerable: true, get: function () { return types_js_1.parseAgentBuildDraft; } });
+Object.defineProperty(exports, "agentBuildDraftToDict", { enumerable: true, get: function () { return types_js_1.agentBuildDraftToDict; } });
+Object.defineProperty(exports, "parseIdentityStatus", { enumerable: true, get: function () { return types_js_1.parseIdentityStatus; } });
+Object.defineProperty(exports, "parseContinuityRecord", { enumerable: true, get: function () { return types_js_1.parseContinuityRecord; } });
+Object.defineProperty(exports, "continuityRecordToDict", { enumerable: true, get: function () { return types_js_1.continuityRecordToDict; } });
+Object.defineProperty(exports, "parseContinuityFailure", { enumerable: true, get: function () { return types_js_1.parseContinuityFailure; } });
+Object.defineProperty(exports, "parseContinuityResolveState", { enumerable: true, get: function () { return types_js_1.parseContinuityResolveState; } });
+Object.defineProperty(exports, "parseSessionSnapshot", { enumerable: true, get: function () { return types_js_1.parseSessionSnapshot; } });
+Object.defineProperty(exports, "sessionSnapshotToDict", { enumerable: true, get: function () { return types_js_1.sessionSnapshotToDict; } });
+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, "parseLeaseRenewResult", { enumerable: true, get: function () { return types_js_1.parseLeaseRenewResult; } });
 // -- Typed events ---------------------------------------------------------
 var events_js_1 = require("./events.cjs");
 Object.defineProperty(exports, "parseAgentEvent", { enumerable: true, get: function () { return events_js_1.parseAgentEvent; } });

package/dist/cjs/models.cjs

@@ -9,8 +9,8 @@ exports.preSpawnDataToDict = preSpawnDataToDict;
 exports.sessionQueryToDict = sessionQueryToDict;
 function discoverySpecToDict(spec) {
     const result = {
-        profile: spec.profile,
-        meerkat_id: spec.meerkatId,
+        role: spec.role,
+        agent_identity: spec.agentIdentity,
     };
     if (spec.labels && Object.keys(spec.labels).length > 0) {
         result.labels = { ...spec.labels };