@rkat/mobkit-sdk 0.4.9

package/dist/events.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Typed event hierarchy for MobKit SDK streaming.
+ *
+ * Events form a discriminated union on the `type` field (snake_case to match
+ * the wire protocol). All other fields use idiomatic camelCase.
+ *
+ * @example
+ * ```ts
+ * for await (const event of handle.subscribeAgent("agent-1")) {
+ *   switch (event.event.type) {
+ *     case "text_delta":
+ *       process.stdout.write(event.event.delta);
+ *       break;
+ *     case "run_completed":
+ *       console.log(`Done: ${event.event.result}`);
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+import type { SseEvent } from "./sse.js";
+export interface RunStartedEvent {
+    readonly type: "run_started";
+    readonly sessionId: string;
+    readonly prompt: string;
+}
+export interface RunCompletedEvent {
+    readonly type: "run_completed";
+    readonly sessionId: string;
+    readonly result: string;
+}
+export interface RunFailedEvent {
+    readonly type: "run_failed";
+    readonly sessionId: string;
+    readonly error: string;
+}
+export interface TurnStartedEvent {
+    readonly type: "turn_started";
+    readonly turnNumber: number;
+}
+export interface TextDeltaEvent {
+    readonly type: "text_delta";
+    readonly delta: string;
+}
+export interface TextCompleteEvent {
+    readonly type: "text_complete";
+    readonly content: string;
+}
+export interface ToolCallRequestedEvent {
+    readonly type: "tool_call_requested";
+    readonly id: string;
+    readonly name: string;
+    readonly args: unknown;
+}
+export interface ToolResultReceivedEvent {
+    readonly type: "tool_result_received";
+    readonly id: string;
+    readonly name: string;
+    readonly isError: boolean;
+}
+export interface TurnCompletedEvent {
+    readonly type: "turn_completed";
+    readonly stopReason: string;
+}
+export interface ToolExecutionStartedEvent {
+    readonly type: "tool_execution_started";
+    readonly id: string;
+    readonly name: string;
+}
+export interface ToolExecutionCompletedEvent {
+    readonly type: "tool_execution_completed";
+    readonly id: string;
+    readonly name: string;
+    readonly result: string;
+    readonly isError: boolean;
+    readonly durationMs: number;
+}
+export interface UnknownEvent {
+    readonly type: string;
+    readonly data: Record<string, unknown>;
+}
+export type AgentEvent = RunStartedEvent | RunCompletedEvent | RunFailedEvent | TurnStartedEvent | TextDeltaEvent | TextCompleteEvent | ToolCallRequestedEvent | ToolResultReceivedEvent | TurnCompletedEvent | ToolExecutionStartedEvent | ToolExecutionCompletedEvent | UnknownEvent;
+/**
+ * Parse a raw event dict into a typed {@link AgentEvent}.
+ *
+ * Unknown event types are returned as {@link UnknownEvent} for
+ * forward-compatibility with newer server versions.
+ */
+export declare function parseAgentEvent(raw: Record<string, unknown>): AgentEvent;
+/**
+ * A mob-level attributed event from the runtime.
+ *
+ * Wraps an {@link AgentEvent} with the `memberId` of the agent that produced it.
+ */
+export interface MobEventEnvelope {
+    readonly memberId: string;
+    readonly event: AgentEvent;
+    readonly timestampMs: number;
+}
+export declare function parseMobEventFromSse(sse: SseEvent): MobEventEnvelope;
+/**
+ * A per-agent event from the runtime.
+ *
+ * The `event` field contains the typed {@link AgentEvent} subtype.
+ */
+export interface AgentEventEnvelope {
+    readonly eventType: string;
+    readonly event: AgentEvent;
+}
+export declare function parseAgentEventFromSse(sse: SseEvent): AgentEventEnvelope;
+export declare function isTextDelta(event: AgentEvent): event is TextDeltaEvent;
+export declare function isTextComplete(event: AgentEvent): event is TextCompleteEvent;
+export declare function isRunCompleted(event: AgentEvent): event is RunCompletedEvent;
+export declare function isRunFailed(event: AgentEvent): event is RunFailedEvent;
+export declare function isTurnCompleted(event: AgentEvent): event is TurnCompletedEvent;
+export declare function isToolCallRequested(event: AgentEvent): event is ToolCallRequestedEvent;
+/**
+ * Typed async iterator wrapping raw SSE events into domain events.
+ */
+export declare class EventStream<T> implements AsyncIterable<T> {
+    private readonly _source;
+    private readonly _parse;
+    constructor(_source: AsyncIterable<SseEvent>, _parse: (sse: SseEvent) => T);
+    [Symbol.asyncIterator](): AsyncGenerator<T, void, undefined>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,164 @@
+/**
+ * Typed event hierarchy for MobKit SDK streaming.
+ *
+ * Events form a discriminated union on the `type` field (snake_case to match
+ * the wire protocol). All other fields use idiomatic camelCase.
+ *
+ * @example
+ * ```ts
+ * for await (const event of handle.subscribeAgent("agent-1")) {
+ *   switch (event.event.type) {
+ *     case "text_delta":
+ *       process.stdout.write(event.event.delta);
+ *       break;
+ *     case "run_completed":
+ *       console.log(`Done: ${event.event.result}`);
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+const EVENT_MAP = {
+    run_started: (raw) => ({
+        type: "run_started",
+        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_failed: (raw) => ({
+        type: "run_failed",
+        sessionId: String(raw.session_id ?? ""),
+        error: String(raw.error ?? ""),
+    }),
+    turn_started: (raw) => ({
+        type: "turn_started",
+        turnNumber: Number(raw.turn_number ?? 0),
+    }),
+    text_delta: (raw) => ({
+        type: "text_delta",
+        delta: String(raw.delta ?? ""),
+    }),
+    text_complete: (raw) => ({
+        type: "text_complete",
+        content: String(raw.content ?? ""),
+    }),
+    tool_call_requested: (raw) => ({
+        type: "tool_call_requested",
+        id: String(raw.id ?? ""),
+        name: String(raw.name ?? ""),
+        args: raw.args ?? null,
+    }),
+    tool_result_received: (raw) => ({
+        type: "tool_result_received",
+        id: String(raw.id ?? ""),
+        name: String(raw.name ?? ""),
+        isError: Boolean(raw.is_error),
+    }),
+    turn_completed: (raw) => ({
+        type: "turn_completed",
+        stopReason: String(raw.stop_reason ?? ""),
+    }),
+    tool_execution_started: (raw) => ({
+        type: "tool_execution_started",
+        id: String(raw.id ?? ""),
+        name: String(raw.name ?? ""),
+    }),
+    tool_execution_completed: (raw) => ({
+        type: "tool_execution_completed",
+        id: String(raw.id ?? ""),
+        name: String(raw.name ?? ""),
+        result: String(raw.result ?? ""),
+        isError: Boolean(raw.is_error),
+        durationMs: Number(raw.duration_ms ?? 0),
+    }),
+};
+/**
+ * Parse a raw event dict into a typed {@link AgentEvent}.
+ *
+ * Unknown event types are returned as {@link UnknownEvent} for
+ * forward-compatibility with newer server versions.
+ */
+export function parseAgentEvent(raw) {
+    const eventType = String(raw.type ?? "");
+    const factory = EVENT_MAP[eventType];
+    if (factory) {
+        return factory(raw);
+    }
+    return { type: eventType, data: raw };
+}
+export function parseMobEventFromSse(sse) {
+    let raw;
+    try {
+        raw = JSON.parse(sse.data);
+    }
+    catch {
+        raw = {};
+    }
+    const memberId = String(raw.member_id ?? raw.source ?? "");
+    const payload = (typeof raw.payload === "object" && raw.payload !== null
+        ? raw.payload
+        : raw);
+    return {
+        memberId,
+        event: parseAgentEvent(payload),
+        timestampMs: Number(raw.timestamp_ms ?? 0),
+    };
+}
+export function parseAgentEventFromSse(sse) {
+    let raw;
+    try {
+        raw = JSON.parse(sse.data);
+    }
+    catch {
+        raw = {};
+    }
+    return {
+        eventType: sse.event,
+        event: parseAgentEvent(raw),
+    };
+}
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+export function isTextDelta(event) {
+    return event.type === "text_delta";
+}
+export function isTextComplete(event) {
+    return event.type === "text_complete";
+}
+export function isRunCompleted(event) {
+    return event.type === "run_completed";
+}
+export function isRunFailed(event) {
+    return event.type === "run_failed";
+}
+export function isTurnCompleted(event) {
+    return event.type === "turn_completed";
+}
+export function isToolCallRequested(event) {
+    return event.type === "tool_call_requested";
+}
+// ---------------------------------------------------------------------------
+// EventStream (typed async iterator wrapping SSE → domain events)
+// ---------------------------------------------------------------------------
+/**
+ * Typed async iterator wrapping raw SSE events into domain events.
+ */
+export class EventStream {
+    _source;
+    _parse;
+    constructor(_source, _parse) {
+        this._source = _source;
+        this._parse = _parse;
+    }
+    async *[Symbol.asyncIterator]() {
+        for await (const sse of this._source) {
+            yield this._parse(sse);
+        }
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Module authoring helpers and console route builders.
+ *
+ * These are public utilities for defining MobKit modules, tools, and
+ * admin console routes. Matches the Python SDK's `meerkat_mobkit.helpers`.
+ */
+export type RestartPolicy = "never" | "always" | "on_failure";
+export interface ModuleSpec {
+    readonly id: string;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly restart_policy: RestartPolicy;
+}
+export type ModuleSpecDecorator = (spec: ModuleSpec) => ModuleSpec;
+export interface ModuleToolContext {
+    readonly moduleId: string;
+    readonly requestId: string;
+}
+export type ModuleToolHandler<TInput = unknown, TOutput = unknown> = (input: TInput, context: ModuleToolContext) => Promise<TOutput> | TOutput;
+export type ModuleToolDecorator<TInput = unknown, TOutput = unknown> = (next: ModuleToolHandler<TInput, TOutput>) => ModuleToolHandler<TInput, TOutput>;
+export interface ModuleToolDefinition<TInput = unknown, TOutput = unknown> {
+    readonly name: string;
+    readonly description?: string;
+    readonly handler: ModuleToolHandler<TInput, TOutput>;
+}
+export interface ModuleDefinition {
+    readonly spec: ModuleSpec;
+    readonly description?: string;
+    readonly tools: readonly ModuleToolDefinition[];
+}
+export interface ConsoleRoutes {
+    readonly modules: string;
+    readonly experience: string;
+}
+export declare function defineModuleSpec(input: {
+    id: string;
+    command: string;
+    args?: string[];
+    restartPolicy?: RestartPolicy;
+}): ModuleSpec;
+export declare function decorateModuleSpec(spec: ModuleSpec, ...decorators: ModuleSpecDecorator[]): ModuleSpec;
+export declare function decorateModuleTool<TInput = unknown, TOutput = unknown>(handler: ModuleToolHandler<TInput, TOutput>, ...decorators: ModuleToolDecorator<TInput, TOutput>[]): ModuleToolHandler<TInput, TOutput>;
+export declare function defineModuleTool<TInput = unknown, TOutput = unknown>(input: {
+    name: string;
+    handler: ModuleToolHandler<TInput, TOutput>;
+    description?: string;
+    decorators?: ModuleToolDecorator<TInput, TOutput>[];
+}): ModuleToolDefinition<TInput, TOutput>;
+export declare function defineModule(input: {
+    spec: ModuleSpec;
+    description?: string;
+    tools?: ModuleToolDefinition[];
+}): ModuleDefinition;
+export declare function buildConsoleRoute(path: "/console/modules" | "/console/experience", authToken?: string): string;
+export declare function buildConsoleModulesRoute(authToken?: string): string;
+export declare function buildConsoleExperienceRoute(authToken?: string): string;
+export declare function buildConsoleRoutes(authToken?: string): ConsoleRoutes;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

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

package/dist/helpers.js

@@ -0,0 +1,62 @@
+/**
+ * Module authoring helpers and console route builders.
+ *
+ * These are public utilities for defining MobKit modules, tools, and
+ * admin console routes. Matches the Python SDK's `meerkat_mobkit.helpers`.
+ */
+// -- Module spec helpers --------------------------------------------------
+export function defineModuleSpec(input) {
+    return {
+        id: input.id,
+        command: input.command,
+        args: input.args ?? [],
+        restart_policy: input.restartPolicy ?? "never",
+    };
+}
+export function decorateModuleSpec(spec, ...decorators) {
+    const base = { ...spec, args: [...spec.args] };
+    return decorators.reduce((current, decorate) => decorate(current), base);
+}
+// -- Module tool helpers --------------------------------------------------
+export function decorateModuleTool(handler, ...decorators) {
+    return decorators.reduceRight((next, decorate) => decorate(next), handler);
+}
+export function defineModuleTool(input) {
+    return {
+        name: input.name,
+        description: input.description,
+        handler: decorateModuleTool(input.handler, ...(input.decorators ?? [])),
+    };
+}
+// -- Module definition ----------------------------------------------------
+export function defineModule(input) {
+    return {
+        spec: { ...input.spec, args: [...input.spec.args] },
+        description: input.description,
+        tools: [...(input.tools ?? [])],
+    };
+}
+// -- Console route helpers ------------------------------------------------
+function appendAuthToken(path, authToken) {
+    if (!authToken) {
+        return path;
+    }
+    const joiner = path.includes("?") ? "&" : "?";
+    return `${path}${joiner}auth_token=${encodeURIComponent(authToken)}`;
+}
+export function buildConsoleRoute(path, authToken) {
+    return appendAuthToken(path, authToken);
+}
+export function buildConsoleModulesRoute(authToken) {
+    return buildConsoleRoute("/console/modules", authToken);
+}
+export function buildConsoleExperienceRoute(authToken) {
+    return buildConsoleRoute("/console/experience", authToken);
+}
+export function buildConsoleRoutes(authToken) {
+    return {
+        modules: buildConsoleModulesRoute(authToken),
+        experience: buildConsoleExperienceRoute(authToken),
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8CH,4EAA4E;AAE5E,MAAM,UAAU,gBAAgB,CAAC,KAKhC;IACC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,cAAc,EAAE,KAAK,CAAC,aAAa,IAAI,OAAO;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAgB,EAChB,GAAG,UAAiC;IAEpC,MAAM,IAAI,GAAe,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3D,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3E,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,kBAAkB,CAChC,OAA2C,EAC3C,GAAG,UAAkD;IAErD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAsC,KAKrE;IACC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,YAAY,CAAC,KAI5B;IACC,OAAO;QACL,IAAI,EAAE,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACnD,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,KAAK,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E,SAAS,eAAe,CAAC,IAAY,EAAE,SAAkB;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9C,OAAO,GAAG,IAAI,GAAG,MAAM,cAAc,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAgD,EAChD,SAAkB;IAElB,OAAO,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAkB;IACzD,OAAO,iBAAiB,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,SAAkB;IAC5D,OAAO,iBAAiB,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAkB;IACnD,OAAO;QACL,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC;QAC5C,UAAU,EAAE,2BAA2B,CAAC,SAAS,CAAC;KACnD,CAAC;AACJ,CAAC"}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";
+module.exports = require("./cjs/index.cjs");

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * MobKit TypeScript SDK — companion orchestration for the Meerkat runtime.
+ *
+ * @example
+ * ```ts
+ * import { MobKit } from "@rkat/mobkit-sdk";
+ *
+ * const rt = await MobKit.builder()
+ *   .mob("config/mob.toml")
+ *   .gateway("./target/release/phase0b_rpc_gateway")
+ *   .build();
+ *
+ * const handle = rt.mobHandle();
+ * const status = await handle.status();
+ * console.log(status.contractVersion, status.loadedModules);
+ *
+ * for await (const event of handle.subscribeAgent("agent-1")) {
+ *   if (event.event.type === "text_delta") {
+ *     process.stdout.write(event.event.delta);
+ *   }
+ * }
+ *
+ * await rt.shutdown();
+ * ```
+ */
+export { MobKit, MobKitBuilder } from "./builder.js";
+export type { MobKitBuilderConfig } from "./builder.js";
+export { MobKitRuntime, MobHandle, ToolCaller, SseBridge } from "./runtime.js";
+export { SessionBuildOptions } from "./models.js";
+export type { DiscoverySpec, PreSpawnData, SessionQuery, ToolHandler, } from "./models.js";
+export { discoverySpecToDict, preSpawnDataToDict, sessionQueryToDict, } from "./models.js";
+export type { SessionAgentBuilder, ErrorCallback } from "./agent-builder.js";
+export { CallbackDispatcher } from "./agent-builder.js";
+export { MobKitError, TransportError, RpcError, CapabilityUnavailableError, ContractMismatchError, NotConnectedError, MobkitRpcError, } from "./errors.js";
+export { MEMBER_STATE_ACTIVE, MEMBER_STATE_RETIRING, ErrorCategory, parseStatusResult, parseCapabilitiesResult, parseReconcileResult, parseSpawnResult, parseKeepAliveConfig, parseEventEnvelope, parseSubscribeResult, parseSendMessageResult, parseRoutingResolution, parseDeliveryResult, parseDeliveryHistoryResult, parseMemoryQueryResult, parseMemoryStoreInfo, parseMemoryIndexResult, parseCallToolResult, parseMemberSnapshot, parseRuntimeRouteResult, parseGatingEvaluateResult, parseGatingDecisionResult, parseGatingAuditEntry, parseGatingPendingEntry, parseRediscoverReport, parseReconcileEdgesReport, parsePersistedEvent, parseErrorEvent, eventQueryToDict, } from "./types.js";
+export type { StatusResult, CapabilitiesResult, ReconcileResult, SpawnResult, SpawnMemberResult, KeepAliveConfig, EventEnvelope, SubscribeResult, SendMessageResult, RoutingResolution, DeliveryResult, DeliveryHistoryResult, MemoryQueryResult, MemoryStoreInfo, MemoryIndexResult, CallToolResult, MemberSnapshot, RuntimeRouteResult, GatingEvaluateResult, GatingDecisionResult, GatingAuditEntry, GatingPendingEntry, RediscoverReport, ReconcileEdgesReport, UnifiedAgentEvent, UnifiedModuleEvent, UnifiedEvent, PersistedEvent, EventQuery, ErrorEvent, ErrorCategoryValue, } from "./types.js";
+export { parseAgentEvent, parseMobEventFromSse, parseAgentEventFromSse, isTextDelta, isTextComplete, isRunCompleted, isRunFailed, isTurnCompleted, isToolCallRequested, EventStream, } from "./events.js";
+export type { AgentEvent, RunStartedEvent, RunCompletedEvent, RunFailedEvent, TurnStartedEvent, TextDeltaEvent, TextCompleteEvent, ToolCallRequestedEvent, ToolResultReceivedEvent, TurnCompletedEvent, ToolExecutionStartedEvent, ToolExecutionCompletedEvent, UnknownEvent, MobEventEnvelope, AgentEventEnvelope, } from "./events.js";
+export { auth, memory, sessionStore } from "./config/index.js";
+export { defineModuleSpec, decorateModuleSpec, decorateModuleTool, defineModuleTool, defineModule, buildConsoleRoute, buildConsoleModulesRoute, buildConsoleExperienceRoute, buildConsoleRoutes, } from "./helpers.js";
+export type { RestartPolicy, ModuleSpec, ModuleSpecDecorator, ModuleToolContext, ModuleToolHandler, ModuleToolDecorator, ModuleToolDefinition, ModuleDefinition, ConsoleRoutes, } from "./helpers.js";
+export { PersistentTransport, buildJsonRpcRequest, createGatewaySyncTransport, createGatewayAsyncTransport, createJsonRpcHttpTransport, } from "./transport.js";
+export type { JsonRpcRequest, JsonRpcResponse, JsonRpcSuccess, JsonRpcErrorResponse, JsonRpcErrorBody, JsonRpcTransport, JsonRpcSyncTransport, CallbackHandler, FetchLike, FetchLikeResponse, } from "./transport.js";
+export { parseSseStream, encodeSseEvent } from "./sse.js";
+export type { SseEvent } from "./sse.js";
+export { MobkitTypedClient, MobkitAsyncClient, } from "./client.js";
+export type { MobkitStatusResult, MobkitCapabilitiesResult, MobkitReconcileResult, MobkitSpawnMemberResult, MobkitSubscribeScope, MobkitSubscribeParams, MobkitSubscribeKeepAlive, MobkitEventEnvelope, MobkitSubscribeResult, } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,49 @@
+/**
+ * MobKit TypeScript SDK — companion orchestration for the Meerkat runtime.
+ *
+ * @example
+ * ```ts
+ * import { MobKit } from "@rkat/mobkit-sdk";
+ *
+ * const rt = await MobKit.builder()
+ *   .mob("config/mob.toml")
+ *   .gateway("./target/release/phase0b_rpc_gateway")
+ *   .build();
+ *
+ * const handle = rt.mobHandle();
+ * const status = await handle.status();
+ * console.log(status.contractVersion, status.loadedModules);
+ *
+ * for await (const event of handle.subscribeAgent("agent-1")) {
+ *   if (event.event.type === "text_delta") {
+ *     process.stdout.write(event.event.delta);
+ *   }
+ * }
+ *
+ * await rt.shutdown();
+ * ```
+ */
+// -- Builder + Runtime ----------------------------------------------------
+export { MobKit, MobKitBuilder } from "./builder.js";
+export { MobKitRuntime, MobHandle, ToolCaller, SseBridge } from "./runtime.js";
+// -- Data models ----------------------------------------------------------
+export { SessionBuildOptions } from "./models.js";
+export { discoverySpecToDict, preSpawnDataToDict, sessionQueryToDict, } from "./models.js";
+export { CallbackDispatcher } from "./agent-builder.js";
+// -- Errors ---------------------------------------------------------------
+export { MobKitError, TransportError, RpcError, CapabilityUnavailableError, ContractMismatchError, NotConnectedError, MobkitRpcError, } from "./errors.js";
+// -- Typed return models --------------------------------------------------
+export { MEMBER_STATE_ACTIVE, MEMBER_STATE_RETIRING, ErrorCategory, parseStatusResult, parseCapabilitiesResult, parseReconcileResult, parseSpawnResult, parseKeepAliveConfig, parseEventEnvelope, parseSubscribeResult, parseSendMessageResult, parseRoutingResolution, parseDeliveryResult, parseDeliveryHistoryResult, parseMemoryQueryResult, parseMemoryStoreInfo, parseMemoryIndexResult, parseCallToolResult, parseMemberSnapshot, parseRuntimeRouteResult, parseGatingEvaluateResult, parseGatingDecisionResult, parseGatingAuditEntry, parseGatingPendingEntry, parseRediscoverReport, parseReconcileEdgesReport, parsePersistedEvent, parseErrorEvent, eventQueryToDict, } from "./types.js";
+// -- Typed events ---------------------------------------------------------
+export { parseAgentEvent, parseMobEventFromSse, parseAgentEventFromSse, isTextDelta, isTextComplete, isRunCompleted, isRunFailed, isTurnCompleted, isToolCallRequested, EventStream, } from "./events.js";
+// -- Config modules -------------------------------------------------------
+export { auth, memory, sessionStore } from "./config/index.js";
+// -- Module authoring helpers ---------------------------------------------
+export { defineModuleSpec, decorateModuleSpec, decorateModuleTool, defineModuleTool, defineModule, buildConsoleRoute, buildConsoleModulesRoute, buildConsoleExperienceRoute, buildConsoleRoutes, } from "./helpers.js";
+// -- Transport (advanced usage) -------------------------------------------
+export { PersistentTransport, buildJsonRpcRequest, createGatewaySyncTransport, createGatewayAsyncTransport, createJsonRpcHttpTransport, } from "./transport.js";
+// -- SSE (advanced usage) -------------------------------------------------
+export { parseSseStream, encodeSseEvent } from "./sse.js";
+// -- Low-level clients (backward compat) ----------------------------------
+export { MobkitTypedClient, MobkitAsyncClient, } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,4EAA4E;AAE5E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/E,4EAA4E;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAOlD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,4EAA4E;AAE5E,OAAO,EACL,WAAW,EACX,cAAc,EACd,QAAQ,EACR,0BAA0B,EAC1B,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,4EAA4E;AAE5E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAoCpB,4EAA4E;AAE5E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,cAAc,EACd,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,WAAW,GACZ,MAAM,aAAa,CAAC;AAoBrB,4EAA4E;AAE5E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/D,4EAA4E;AAE5E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,EACxB,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,cAAc,CAAC;AActB,4EAA4E;AAE5E,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AAexB,4EAA4E;AAE5E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1D,4EAA4E;AAE5E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Typed data models for MobKit SDK — input/config objects sent to the runtime.
+ */
+export interface DiscoverySpec {
+    readonly profile: string;
+    readonly meerkatId: string;
+    readonly labels?: Readonly<Record<string, string>>;
+    readonly appContext?: unknown;
+    readonly additionalInstructions?: readonly string[];
+    readonly resumeSessionId?: string;
+}
+export declare function discoverySpecToDict(spec: DiscoverySpec): Record<string, unknown>;
+export interface PreSpawnData {
+    readonly resumeMap?: Readonly<Record<string, string>>;
+    readonly moduleId?: string;
+    readonly env?: Readonly<Record<string, string>>;
+}
+export declare function preSpawnDataToDict(data: PreSpawnData): Record<string, unknown>;
+export interface SessionQuery {
+    readonly agentType?: string;
+    readonly ownerId?: string;
+    readonly labels?: Readonly<Record<string, string>>;
+    readonly includeDeleted?: boolean;
+    readonly limit?: number;
+}
+export declare function sessionQueryToDict(query: SessionQuery): Record<string, unknown>;
+/** Callback tool handler: receives arguments dict, returns JSON-serializable result. */
+export type ToolHandler = (args: Record<string, unknown>) => unknown | Promise<unknown>;
+/**
+ * Mutable options passed to {@link SessionAgentBuilder.buildAgent}.
+ *
+ * The builder mutates fields during agent construction — sets profileName,
+ * calls {@link addTools} or {@link registerTool}.
+ *
+ * @example
+ * ```ts
+ * const builder: SessionAgentBuilder = {
+ *   async buildAgent(opts) {
+ *     opts.profileName = "assistant";
+ *     opts.registerTool("search", searchHandler);
+ *   },
+ * };
+ * ```
+ */
+export declare class SessionBuildOptions {
+    appContext: unknown;
+    additionalInstructions: string[];
+    sessionId: string | null;
+    labels: Record<string, string>;
+    profileName: string | null;
+    private _tools;
+    private _toolHandlers;
+    /** Declare tool names the agent can use. */
+    addTools(tools: string[]): void;
+    /** Register a callable tool with the agent. */
+    registerTool(name: string, handler: ToolHandler): void;
+    get tools(): string[];
+    get toolHandlers(): ReadonlyMap<string, ToolHandler>;
+    toDict(): Record<string, unknown>;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB;AAID,wFAAwF;AACxF,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB;IAC9B,UAAU,EAAE,OAAO,CAAa;IAChC,sBAAsB,EAAE,MAAM,EAAE,CAAM;IACtC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAAuC;IAE5D,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAW/B,+CAA+C;IAC/C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAetD,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED,IAAI,YAAY,IAAI,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAEnD;IAED,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAclC"}