@rkat/mobkit-sdk 0.5.2 → 0.6.3

package/dist/cjs/types.cjs

@@ -32,7 +32,36 @@ exports.parseReconcileEdgesReport = parseReconcileEdgesReport;
 exports.parseRediscoverReport = parseRediscoverReport;
 exports.parsePersistedEvent = parsePersistedEvent;
 exports.eventQueryToDict = eventQueryToDict;
+exports.parseMobStructuralEvent = parseMobStructuralEvent;
+exports.parseStepRecord = parseStepRecord;
+exports.parseFailureRecord = parseFailureRecord;
+exports.parseFrameRecord = parseFrameRecord;
+exports.parseLoopRecord = parseLoopRecord;
+exports.parseLoopIterationRecord = parseLoopIterationRecord;
+exports.parseMobRun = parseMobRun;
 exports.parseErrorEvent = parseErrorEvent;
+exports.parseDurableAgentSpec = parseDurableAgentSpec;
+exports.durableAgentSpecToDict = durableAgentSpecToDict;
+exports.parseDispatchInput = parseDispatchInput;
+exports.dispatchInputToDict = dispatchInputToDict;
+exports.parseManagedPeerEdge = parseManagedPeerEdge;
+exports.managedPeerEdgeToDict = managedPeerEdgeToDict;
+exports.parseExternalToolDef = parseExternalToolDef;
+exports.externalToolDefToDict = externalToolDefToDict;
+exports.parseAgentBuildContext = parseAgentBuildContext;
+exports.parseAgentBuildDraft = parseAgentBuildDraft;
+exports.agentBuildDraftToDict = agentBuildDraftToDict;
+exports.parseIdentityStatus = parseIdentityStatus;
+exports.parseContinuityRecord = parseContinuityRecord;
+exports.continuityRecordToDict = continuityRecordToDict;
+exports.parseContinuityFailure = parseContinuityFailure;
+exports.parseContinuityResolveState = parseContinuityResolveState;
+exports.parseSessionSnapshot = parseSessionSnapshot;
+exports.sessionSnapshotToDict = sessionSnapshotToDict;
+exports.parseLeaseGrant = parseLeaseGrant;
+exports.leaseGrantToDict = leaseGrantToDict;
+exports.parseLeaseAcquireResult = parseLeaseAcquireResult;
+exports.parseLeaseRenewResult = parseLeaseRenewResult;
 // -- Helpers (internal) ---------------------------------------------------
 function asRecord(value) {
     if (typeof value === "object" && value !== null) {
@@ -124,8 +153,8 @@ function parseSpawnResult(raw) {
     return {
         accepted: Boolean(d.accepted),
         moduleId: String(d.module_id ?? ""),
-        meerkatId: typeof d.meerkat_id === "string" ? d.meerkat_id : null,
-        profile: typeof d.profile === "string" ? d.profile : null,
+        agentIdentity: typeof d.agent_identity === "string" ? d.agent_identity : null,
+        role: typeof d.role === "string" ? d.role : null,
     };
 }
 function parseKeepAliveConfig(raw) {
@@ -146,7 +175,13 @@ function parseEventEnvelope(raw) {
 }
 function parseSubscribeResult(raw) {
     const d = asRecord(raw);
-    const eventsRaw = Array.isArray(d.events) ? d.events : [];
+    // Pre-fix this mapped every entry — including null/string/number —
+    // through `parseEventEnvelope`, where `asRecord` quietly returned
+    // `{}` and produced silently-empty envelopes. Filter to objects so
+    // non-object entries are dropped instead of becoming data-loss.
+    const eventsRaw = Array.isArray(d.events)
+        ? d.events.filter((entry) => typeof entry === "object" && entry !== null && !Array.isArray(entry))
+        : [];
     return {
         scope: String(d.scope ?? ""),
         replayFromEventId: typeof d.replay_from_event_id === "string"
@@ -219,8 +254,8 @@ function parseCallToolResult(raw) {
 function parseMemberSnapshot(raw) {
     const d = asRecord(raw);
     return {
-        meerkatId: String(d.meerkat_id ?? ""),
-        profile: String(d.profile ?? ""),
+        agentIdentity: String(d.agent_identity ?? ""),
+        role: String(d.role ?? ""),
         state: String(d.state ?? ""),
         wiredTo: asStringArray(d.wired_to),
         labels: asStringRecord(d.labels),
@@ -309,6 +344,9 @@ function parseUnifiedEvent(raw) {
             kind: "agent",
             agentId: String(agent.agent_id ?? ""),
             eventType: String(agent.event_type ?? ""),
+            payload: typeof agent.payload === "object" && agent.payload !== null
+                ? asRecord(agent.payload)
+                : null,
         };
     }
     if ("Module" in d) {
@@ -349,6 +387,14 @@ function eventQueryToDict(query) {
         d.until_ms = query.untilMs;
     if (query.memberId !== undefined)
         d.member_id = query.memberId;
+    if (query.identity !== undefined)
+        d.identity = query.identity;
+    if (query.mobId !== undefined)
+        d.mob_id = query.mobId;
+    if (query.runId !== undefined)
+        d.run_id = query.runId;
+    if (query.stepId !== undefined)
+        d.step_id = query.stepId;
     if (query.eventTypes !== undefined && query.eventTypes.length > 0) {
         d.event_types = [...query.eventTypes];
     }
@@ -358,6 +404,129 @@ function eventQueryToDict(query) {
         d.after_seq = query.afterSeq;
     return d;
 }
+function parseMobStructuralEvent(raw) {
+    const d = asRecord(raw);
+    const data = d.data;
+    return {
+        eventId: String(d.event_id ?? ""),
+        cursor: Number(d.cursor ?? 0),
+        mobId: String(d.mob_id ?? ""),
+        timestampMs: Number(d.timestamp_ms ?? 0),
+        kind: String(d.kind ?? ""),
+        runId: typeof d.run_id === "string" ? d.run_id : null,
+        stepId: typeof d.step_id === "string" ? d.step_id : null,
+        agentIdentity: typeof d.agent_identity === "string" ? d.agent_identity : null,
+        mobLabels: asStringRecord(d.mob_labels),
+        runLabels: asStringRecord(d.run_labels),
+        data: typeof data === "object" && data !== null
+            ? data
+            : {},
+    };
+}
+function parseStepRecord(raw) {
+    const d = asRecord(raw);
+    return {
+        stepId: String(d.step_id ?? ""),
+        agentIdentity: String(d.agent_identity ?? ""),
+        status: String(d.status ?? ""),
+        output: d.output,
+        timestamp: String(d.timestamp ?? ""),
+    };
+}
+function parseFailureRecord(raw) {
+    const d = asRecord(raw);
+    return {
+        stepId: String(d.step_id ?? ""),
+        reason: String(d.reason ?? ""),
+        timestamp: String(d.timestamp ?? ""),
+    };
+}
+function parseFrameRecord(raw) {
+    const d = asRecord(raw);
+    return { kernelState: d.kernel_state };
+}
+function parseLoopRecord(raw) {
+    const d = asRecord(raw);
+    return { kernelState: d.kernel_state };
+}
+function parseLoopIterationRecord(raw) {
+    const d = asRecord(raw);
+    return {
+        loopInstanceId: String(d.loop_instance_id ?? ""),
+        iteration: Number(d.iteration ?? 0),
+        frameId: String(d.frame_id ?? ""),
+    };
+}
+function parseMobRunStatus(raw) {
+    const known = [
+        "pending",
+        "running",
+        "completed",
+        "failed",
+        "canceled",
+    ];
+    if (typeof raw === "string" && known.includes(raw)) {
+        return raw;
+    }
+    return "pending";
+}
+function parseMobRun(raw) {
+    const d = asRecord(raw);
+    const stepLedger = Array.isArray(d.step_ledger)
+        ? d.step_ledger.map(parseStepRecord)
+        : [];
+    const failureLedger = Array.isArray(d.failure_ledger)
+        ? d.failure_ledger.map(parseFailureRecord)
+        : [];
+    const iterations = Array.isArray(d.loop_iteration_ledger)
+        ? d.loop_iteration_ledger.map(parseLoopIterationRecord)
+        : [];
+    const framesIn = typeof d.frames === "object" && d.frames !== null
+        ? d.frames
+        : {};
+    const frames = {};
+    for (const [k, v] of Object.entries(framesIn)) {
+        if (typeof v === "object" && v !== null) {
+            frames[k] = parseFrameRecord(v);
+        }
+    }
+    const loopsIn = typeof d.loops === "object" && d.loops !== null
+        ? d.loops
+        : {};
+    const loops = {};
+    for (const [k, v] of Object.entries(loopsIn)) {
+        if (typeof v === "object" && v !== null) {
+            loops[k] = parseLoopRecord(v);
+        }
+    }
+    const rootOutputs = typeof d.root_step_outputs === "object" && d.root_step_outputs !== null
+        ? d.root_step_outputs
+        : {};
+    const iterOutputs = typeof d.loop_iteration_outputs === "object" &&
+        d.loop_iteration_outputs !== null
+        ? d.loop_iteration_outputs
+        : {};
+    return {
+        runId: String(d.run_id ?? ""),
+        mobId: String(d.mob_id ?? ""),
+        flowId: String(d.flow_id ?? ""),
+        status: parseMobRunStatus(d.status),
+        flowState: d.flow_state,
+        activationParams: d.activation_params,
+        createdAt: String(d.created_at ?? ""),
+        completedAt: d.completed_at === null || d.completed_at === undefined
+            ? null
+            : String(d.completed_at),
+        stepLedger,
+        failureLedger,
+        frames,
+        loops,
+        loopIterationLedger: iterations,
+        schemaVersion: Number(d.schema_version ?? 0),
+        rootStepOutputs: rootOutputs,
+        loopIterationOutputs: iterOutputs,
+    };
+}
 // -- ErrorCategory / ErrorEvent -------------------------------------------
 exports.ErrorCategory = {
     SPAWN_FAILURE: "spawn_failure",
@@ -404,3 +573,312 @@ function parseErrorEvent(raw) {
     }
     return { category, message, context };
 }
+function parseDurableAgentSpec(raw) {
+    const d = asRecord(raw);
+    return {
+        identity: String(d.identity ?? ""),
+        profile: String(d.profile ?? ""),
+        addressability: String(d.addressability ?? "addressable"),
+        displayName: typeof d.display_name === "string" ? d.display_name : null,
+        labels: asStringRecord(d.labels),
+        context: d.context !== undefined && d.context !== null ? d.context : null,
+        additionalInstructions: asStringArray(d.additional_instructions),
+    };
+}
+function durableAgentSpecToDict(spec) {
+    const result = {
+        identity: spec.identity,
+        profile: spec.profile,
+        addressability: spec.addressability,
+    };
+    if (spec.displayName !== null)
+        result.display_name = spec.displayName;
+    if (Object.keys(spec.labels).length > 0)
+        result.labels = { ...spec.labels };
+    if (spec.context !== null)
+        result.context = spec.context;
+    if (spec.additionalInstructions.length > 0) {
+        result.additional_instructions = [...spec.additionalInstructions];
+    }
+    return result;
+}
+function parseContentBlock(raw) {
+    const d = asRecord(raw);
+    if (d.type === "image") {
+        return {
+            type: "image",
+            mediaType: String(d.media_type ?? d.mediaType ?? ""),
+            data: String(d.data ?? ""),
+        };
+    }
+    return { type: "text", text: String(d.text ?? "") };
+}
+function contentBlockToDict(block) {
+    if (block.type === "image") {
+        return { type: "image", media_type: block.mediaType, data: block.data };
+    }
+    return { type: "text", text: block.text };
+}
+const DISPATCH_ORIGIN_VALUES = [
+    "connector",
+    "scheduler",
+    "policy",
+    "flow",
+    "system",
+];
+function parseDispatchOrigin(raw) {
+    // Pre-fix this was `String(d.origin ?? "system") as DispatchOrigin`
+    // — an unchecked cast that admitted arbitrary strings, so a
+    // consumer's `switch (input.origin)` over the closed set hit no
+    // branch silently. Validate against the union and fall back to
+    // "system" for anything else.
+    if (typeof raw === "string" && DISPATCH_ORIGIN_VALUES.includes(raw)) {
+        return raw;
+    }
+    return "system";
+}
+function parseDispatchInput(raw) {
+    const d = asRecord(raw);
+    let content;
+    if (typeof d.content === "string") {
+        content = d.content;
+    }
+    else if (Array.isArray(d.content)) {
+        content = d.content.map(parseContentBlock);
+    }
+    else {
+        content = "";
+    }
+    return {
+        content,
+        origin: parseDispatchOrigin(d.origin),
+        correlationId: typeof d.correlation_id === "string" ? d.correlation_id : undefined,
+        idempotencyKey: typeof d.idempotency_key === "string" ? d.idempotency_key : undefined,
+    };
+}
+function dispatchInputToDict(input) {
+    const result = {
+        origin: input.origin,
+    };
+    if (typeof input.content === "string") {
+        result.content = input.content;
+    }
+    else {
+        result.content = input.content.map(contentBlockToDict);
+    }
+    if (input.correlationId !== undefined) {
+        result.correlation_id = input.correlationId;
+    }
+    if (input.idempotencyKey !== undefined) {
+        result.idempotency_key = input.idempotencyKey;
+    }
+    return result;
+}
+function parseManagedPeerEdge(raw) {
+    const d = asRecord(raw);
+    return { a: String(d.a ?? ""), b: String(d.b ?? "") };
+}
+function managedPeerEdgeToDict(edge) {
+    return { a: edge.a, b: edge.b };
+}
+function parseExternalToolDef(raw) {
+    const d = asRecord(raw);
+    return {
+        name: String(d.name ?? ""),
+        description: String(d.description ?? ""),
+        inputSchema: asRecord(d.input_schema),
+    };
+}
+function externalToolDefToDict(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.inputSchema,
+    };
+}
+function parseAgentBuildContext(raw) {
+    const d = asRecord(raw);
+    const rawEdges = Array.isArray(d.managed_edges) ? d.managed_edges : [];
+    return {
+        identity: String(d.identity ?? ""),
+        activePeers: asStringArray(d.active_peers),
+        managedEdges: rawEdges.map(parseManagedPeerEdge),
+    };
+}
+function parseAgentBuildDraft(raw) {
+    const d = asRecord(raw);
+    const rawTools = Array.isArray(d.external_tools) ? d.external_tools : [];
+    return {
+        model: typeof d.model === "string" ? d.model : null,
+        systemPrompt: typeof d.system_prompt === "string" ? d.system_prompt : null,
+        additionalInstructions: asStringArray(d.additional_instructions),
+        labels: asStringRecord(d.labels),
+        appContext: d.app_context !== undefined && d.app_context !== null ? d.app_context : null,
+        externalTools: rawTools.map(parseExternalToolDef),
+    };
+}
+function agentBuildDraftToDict(draft) {
+    const result = {};
+    if (draft.model !== null)
+        result.model = draft.model;
+    if (draft.systemPrompt !== null)
+        result.system_prompt = draft.systemPrompt;
+    if (draft.additionalInstructions.length > 0) {
+        result.additional_instructions = [...draft.additionalInstructions];
+    }
+    if (Object.keys(draft.labels).length > 0)
+        result.labels = { ...draft.labels };
+    if (draft.appContext !== null)
+        result.app_context = draft.appContext;
+    if (draft.externalTools.length > 0) {
+        result.external_tools = draft.externalTools.map(externalToolDefToDict);
+    }
+    return result;
+}
+function parseLeaseInfo(raw) {
+    if (raw == null || typeof raw !== "object")
+        return null;
+    const d = raw;
+    return {
+        fencingToken: Number(d.fencing_token ?? 0),
+        ttlRemainingMs: Number(d.ttl_remaining_ms ?? 0),
+        healthy: Boolean(d.healthy ?? false),
+    };
+}
+function parseDurabilityPolicy(raw) {
+    const d = asRecord(raw);
+    const wireKind = String(d.kind ?? "sync_write_through");
+    let kind;
+    switch (wireKind) {
+        case "async_replicated":
+            kind = "asyncReplicated";
+            break;
+        case "buffered_export":
+            kind = "bufferedExport";
+            break;
+        default:
+            kind = "syncWriteThrough";
+            break;
+    }
+    const result = { kind };
+    if (kind === "bufferedExport" && d.max_loss_window_ms !== undefined) {
+        return { kind, maxLossWindowMs: Number(d.max_loss_window_ms) };
+    }
+    return result;
+}
+function parseContinuityHealth(raw) {
+    if (raw == null || typeof raw !== "object")
+        return null;
+    const d = raw;
+    return {
+        storeReachable: Boolean(d.store_reachable ?? false),
+        durabilityPolicy: parseDurabilityPolicy(d.durability_policy),
+        lastCheckpointVersion: typeof d.last_checkpoint_version === "number"
+            ? d.last_checkpoint_version
+            : null,
+    };
+}
+function parseIdentityStatus(raw) {
+    const d = asRecord(raw);
+    return {
+        identity: String(d.identity ?? ""),
+        lifecycleState: String(d.state ?? ""),
+        agentRuntimeId: String(d.agent_runtime_id ?? ""),
+        sessionId: String(d.session_id ?? ""),
+        profile: String(d.profile ?? ""),
+        addressability: String(d.addressability ?? "addressable"),
+        displayName: typeof d.display_name === "string" ? d.display_name : null,
+        labels: asStringRecord(d.labels),
+        generation: Number(d.generation ?? 0),
+        checkpointVersion: Number(d.checkpoint_version ?? 0),
+        lease: parseLeaseInfo(d.lease),
+        continuityHealth: parseContinuityHealth(d.continuity_health),
+    };
+}
+function parseContinuityRecord(raw) {
+    const d = asRecord(raw);
+    return {
+        identity: String(d.identity ?? ""),
+        agentRuntimeId: String(d.agent_runtime_id ?? ""),
+        sessionId: String(d.session_id ?? ""),
+        generation: Number(d.generation ?? 0),
+        checkpointVersion: Number(d.checkpoint_version ?? 0),
+    };
+}
+function continuityRecordToDict(record) {
+    return {
+        identity: record.identity,
+        agent_runtime_id: record.agentRuntimeId,
+        session_id: record.sessionId,
+        generation: record.generation,
+        checkpoint_version: record.checkpointVersion,
+    };
+}
+function parseContinuityFailure(raw) {
+    const d = asRecord(raw);
+    return {
+        identity: String(d.identity ?? ""),
+        kind: String(d.kind ?? ""),
+        record: d.record != null ? parseContinuityRecord(d.record) : undefined,
+        detail: String(d.detail ?? ""),
+    };
+}
+function parseContinuityResolveState(raw) {
+    const d = asRecord(raw);
+    const state = String(d.state ?? "uninitialized");
+    return {
+        state,
+        record: d.record != null ? parseContinuityRecord(d.record) : undefined,
+        failure: d.failure != null ? parseContinuityFailure(d.failure) : undefined,
+    };
+}
+function parseSessionSnapshot(raw) {
+    const d = asRecord(raw);
+    const b64 = String(d.data ?? "");
+    const binary = atob(b64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return { data: bytes };
+}
+function sessionSnapshotToDict(snap) {
+    let binary = "";
+    for (let i = 0; i < snap.data.length; i++) {
+        binary += String.fromCharCode(snap.data[i]);
+    }
+    return { data: btoa(binary) };
+}
+function parseLeaseGrant(raw) {
+    const d = asRecord(raw);
+    return {
+        identity: String(d.identity ?? ""),
+        fencingToken: Number(d.fencing_token ?? 0),
+        ttlMs: Number(d.ttl_ms ?? 0),
+    };
+}
+function leaseGrantToDict(grant) {
+    return {
+        identity: grant.identity,
+        fencing_token: grant.fencingToken,
+        ttl_ms: grant.ttlMs,
+    };
+}
+function parseLeaseAcquireResult(raw) {
+    const d = asRecord(raw);
+    const wireStatus = String(d.status ?? "acquired");
+    const status = wireStatus === "already_held" ? "alreadyHeld" : "acquired";
+    return {
+        status,
+        grant: d.grant != null ? parseLeaseGrant(d.grant) : undefined,
+        holder: typeof d.holder === "string" ? d.holder : undefined,
+    };
+}
+function parseLeaseRenewResult(raw) {
+    const d = asRecord(raw);
+    const status = String(d.status ?? "renewed");
+    return {
+        status,
+        grant: d.grant != null ? parseLeaseGrant(d.grant) : undefined,
+    };
+}

package/dist/errors.d.ts

@@ -27,7 +27,33 @@ export declare class RpcError extends MobKitError {
     readonly code: number;
     readonly requestId: string;
     readonly method: string;
-    constructor(code: number, message: string, requestId: string, method: string);
+    /** Optional structured payload from the JSON-RPC `error.data` field. */
+    readonly data?: unknown | undefined;
+    constructor(code: number, message: string, requestId: string, method: string, 
+    /** Optional structured payload from the JSON-RPC `error.data` field. */
+    data?: unknown | undefined);
+}
+/**
+ * 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).
+ */
+export declare const 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.
+ */
+export declare class MobEventsStaleError extends RpcError {
+    readonly afterCursor: number;
+    readonly latestCursor: number;
+    constructor(message: string, afterCursor: number, latestCursor: number, requestId: string, method: string, data?: unknown);
+    /**
+     * 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: RpcError): MobEventsStaleError;
 }
 /** Raised when a requested capability is not available on the runtime. */
 export declare class CapabilityUnavailableError extends MobKitError {
@@ -41,6 +67,17 @@ export declare class ContractMismatchError extends MobKitError {
 export declare class NotConnectedError extends MobKitError {
     constructor(message: string);
 }
+/**
+ * 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.
+ */
+export declare function isRpcError(err: unknown): err is RpcError;
+/** Structural test for a `MobEventsStaleError`. See `isRpcError`. */
+export declare function isMobEventsStaleError(err: unknown): err is MobEventsStaleError;
 /** @deprecated Use {@link RpcError} instead. */
 export declare const MobkitRpcError: typeof RpcError;
 /** @deprecated Use {@link RpcError} instead. */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,gDAAgD;AAChD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAID,yFAAyF;AACzF,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAID,6DAA6D;AAC7D,qBAAa,QAAS,SAAQ,WAAW;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAHd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM;CAK1B;AAID,0EAA0E;AAC1E,qBAAa,0BAA2B,SAAQ,WAAW;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAID,0EAA0E;AAC1E,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAID,mFAAmF;AACnF,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAID,gDAAgD;AAChD,eAAO,MAAM,cAAc,iBAAW,CAAC;AACvC,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,gDAAgD;AAChD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAID,yFAAyF;AACzF,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAID,6DAA6D;AAC7D,qBAAa,QAAS,SAAQ,WAAW;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO;gBALd,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACN,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM;IACvB,wEAAwE;IAC/D,IAAI,CAAC,EAAE,OAAO,YAAA;CAK1B;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAG,CAAC,KAAc,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAG7C,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACN,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO;IAMhB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,QAAQ,GAAG,mBAAmB;CAgBxD;AAID,0EAA0E;AAC1E,qBAAa,0BAA2B,SAAQ,WAAW;gBAC7C,OAAO,EAAE,MAAM;CAI5B;AAID,0EAA0E;AAC1E,qBAAa,qBAAsB,SAAQ,WAAW;gBACxC,OAAO,EAAE,MAAM;CAI5B;AAID,mFAAmF;AACnF,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAID;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAYxD;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,mBAAmB,CAS9E;AAID,gDAAgD;AAChD,eAAO,MAAM,cAAc,iBAAW,CAAC;AACvC,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC"}

package/dist/errors.js

@@ -36,14 +36,52 @@ export 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";
     }
 }
+/**
+ * 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).
+ */
+export const 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.
+ */
+export class MobEventsStaleError extends RpcError {
+    afterCursor;
+    latestCursor;
+    constructor(message, afterCursor, latestCursor, requestId, method, data) {
+        super(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);
+    }
+}
 // -- Capability errors ----------------------------------------------------
 /** Raised when a requested capability is not available on the runtime. */
 export class CapabilityUnavailableError extends MobKitError {
@@ -68,6 +106,35 @@ export class NotConnectedError extends MobKitError {
         this.name = "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.
+ */
+export 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`. */
+export function isMobEventsStaleError(err) {
+    if (err instanceof MobEventsStaleError) {
+        return true;
+    }
+    return (isRpcError(err) &&
+        err.code === MOB_EVENTS_STALE_CURSOR_CODE &&
+        err.name === "MobEventsStaleError");
+}
 // -- Backward compatibility -----------------------------------------------
 /** @deprecated Use {@link RpcError} instead. */
 export const MobkitRpcError = RpcError;