@rkat/mobkit-sdk 0.4.9

package/dist/cjs/events.cjs

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * 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;
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventStream = void 0;
+exports.parseAgentEvent = parseAgentEvent;
+exports.parseMobEventFromSse = parseMobEventFromSse;
+exports.parseAgentEventFromSse = parseAgentEventFromSse;
+exports.isTextDelta = isTextDelta;
+exports.isTextComplete = isTextComplete;
+exports.isRunCompleted = isRunCompleted;
+exports.isRunFailed = isRunFailed;
+exports.isTurnCompleted = isTurnCompleted;
+exports.isToolCallRequested = isToolCallRequested;
+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.
+ */
+function parseAgentEvent(raw) {
+    const eventType = String(raw.type ?? "");
+    const factory = EVENT_MAP[eventType];
+    if (factory) {
+        return factory(raw);
+    }
+    return { type: eventType, data: raw };
+}
+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),
+    };
+}
+function parseAgentEventFromSse(sse) {
+    let raw;
+    try {
+        raw = JSON.parse(sse.data);
+    }
+    catch {
+        raw = {};
+    }
+    return {
+        eventType: sse.event,
+        event: parseAgentEvent(raw),
+    };
+}
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+function isTextDelta(event) {
+    return event.type === "text_delta";
+}
+function isTextComplete(event) {
+    return event.type === "text_complete";
+}
+function isRunCompleted(event) {
+    return event.type === "run_completed";
+}
+function isRunFailed(event) {
+    return event.type === "run_failed";
+}
+function isTurnCompleted(event) {
+    return event.type === "turn_completed";
+}
+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.
+ */
+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);
+        }
+    }
+}
+exports.EventStream = EventStream;

package/dist/cjs/helpers.cjs

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * 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`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineModuleSpec = defineModuleSpec;
+exports.decorateModuleSpec = decorateModuleSpec;
+exports.decorateModuleTool = decorateModuleTool;
+exports.defineModuleTool = defineModuleTool;
+exports.defineModule = defineModule;
+exports.buildConsoleRoute = buildConsoleRoute;
+exports.buildConsoleModulesRoute = buildConsoleModulesRoute;
+exports.buildConsoleExperienceRoute = buildConsoleExperienceRoute;
+exports.buildConsoleRoutes = buildConsoleRoutes;
+// -- Module spec helpers --------------------------------------------------
+function defineModuleSpec(input) {
+    return {
+        id: input.id,
+        command: input.command,
+        args: input.args ?? [],
+        restart_policy: input.restartPolicy ?? "never",
+    };
+}
+function decorateModuleSpec(spec, ...decorators) {
+    const base = { ...spec, args: [...spec.args] };
+    return decorators.reduce((current, decorate) => decorate(current), base);
+}
+// -- Module tool helpers --------------------------------------------------
+function decorateModuleTool(handler, ...decorators) {
+    return decorators.reduceRight((next, decorate) => decorate(next), handler);
+}
+function defineModuleTool(input) {
+    return {
+        name: input.name,
+        description: input.description,
+        handler: decorateModuleTool(input.handler, ...(input.decorators ?? [])),
+    };
+}
+// -- Module definition ----------------------------------------------------
+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)}`;
+}
+function buildConsoleRoute(path, authToken) {
+    return appendAuthToken(path, authToken);
+}
+function buildConsoleModulesRoute(authToken) {
+    return buildConsoleRoute("/console/modules", authToken);
+}
+function buildConsoleExperienceRoute(authToken) {
+    return buildConsoleRoute("/console/experience", authToken);
+}
+function buildConsoleRoutes(authToken) {
+    return {
+        modules: buildConsoleModulesRoute(authToken),
+        experience: buildConsoleExperienceRoute(authToken),
+    };
+}

package/dist/cjs/index.cjs

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * 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();
+ * ```
+ */
+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;
+// -- Builder + Runtime ----------------------------------------------------
+var builder_js_1 = require("./builder.cjs");
+Object.defineProperty(exports, "MobKit", { enumerable: true, get: function () { return builder_js_1.MobKit; } });
+Object.defineProperty(exports, "MobKitBuilder", { enumerable: true, get: function () { return builder_js_1.MobKitBuilder; } });
+var runtime_js_1 = require("./runtime.cjs");
+Object.defineProperty(exports, "MobKitRuntime", { enumerable: true, get: function () { return runtime_js_1.MobKitRuntime; } });
+Object.defineProperty(exports, "MobHandle", { enumerable: true, get: function () { return runtime_js_1.MobHandle; } });
+Object.defineProperty(exports, "ToolCaller", { enumerable: true, get: function () { return runtime_js_1.ToolCaller; } });
+Object.defineProperty(exports, "SseBridge", { enumerable: true, get: function () { return runtime_js_1.SseBridge; } });
+// -- Data models ----------------------------------------------------------
+var models_js_1 = require("./models.cjs");
+Object.defineProperty(exports, "SessionBuildOptions", { enumerable: true, get: function () { return models_js_1.SessionBuildOptions; } });
+var models_js_2 = require("./models.cjs");
+Object.defineProperty(exports, "discoverySpecToDict", { enumerable: true, get: function () { return models_js_2.discoverySpecToDict; } });
+Object.defineProperty(exports, "preSpawnDataToDict", { enumerable: true, get: function () { return models_js_2.preSpawnDataToDict; } });
+Object.defineProperty(exports, "sessionQueryToDict", { enumerable: true, get: function () { return models_js_2.sessionQueryToDict; } });
+var agent_builder_js_1 = require("./agent-builder.cjs");
+Object.defineProperty(exports, "CallbackDispatcher", { enumerable: true, get: function () { return agent_builder_js_1.CallbackDispatcher; } });
+// -- Errors ---------------------------------------------------------------
+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, "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; } });
+// -- 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; } });
+Object.defineProperty(exports, "MEMBER_STATE_RETIRING", { enumerable: true, get: function () { return types_js_1.MEMBER_STATE_RETIRING; } });
+Object.defineProperty(exports, "ErrorCategory", { enumerable: true, get: function () { return types_js_1.ErrorCategory; } });
+Object.defineProperty(exports, "parseStatusResult", { enumerable: true, get: function () { return types_js_1.parseStatusResult; } });
+Object.defineProperty(exports, "parseCapabilitiesResult", { enumerable: true, get: function () { return types_js_1.parseCapabilitiesResult; } });
+Object.defineProperty(exports, "parseReconcileResult", { enumerable: true, get: function () { return types_js_1.parseReconcileResult; } });
+Object.defineProperty(exports, "parseSpawnResult", { enumerable: true, get: function () { return types_js_1.parseSpawnResult; } });
+Object.defineProperty(exports, "parseKeepAliveConfig", { enumerable: true, get: function () { return types_js_1.parseKeepAliveConfig; } });
+Object.defineProperty(exports, "parseEventEnvelope", { enumerable: true, get: function () { return types_js_1.parseEventEnvelope; } });
+Object.defineProperty(exports, "parseSubscribeResult", { enumerable: true, get: function () { return types_js_1.parseSubscribeResult; } });
+Object.defineProperty(exports, "parseSendMessageResult", { enumerable: true, get: function () { return types_js_1.parseSendMessageResult; } });
+Object.defineProperty(exports, "parseRoutingResolution", { enumerable: true, get: function () { return types_js_1.parseRoutingResolution; } });
+Object.defineProperty(exports, "parseDeliveryResult", { enumerable: true, get: function () { return types_js_1.parseDeliveryResult; } });
+Object.defineProperty(exports, "parseDeliveryHistoryResult", { enumerable: true, get: function () { return types_js_1.parseDeliveryHistoryResult; } });
+Object.defineProperty(exports, "parseMemoryQueryResult", { enumerable: true, get: function () { return types_js_1.parseMemoryQueryResult; } });
+Object.defineProperty(exports, "parseMemoryStoreInfo", { enumerable: true, get: function () { return types_js_1.parseMemoryStoreInfo; } });
+Object.defineProperty(exports, "parseMemoryIndexResult", { enumerable: true, get: function () { return types_js_1.parseMemoryIndexResult; } });
+Object.defineProperty(exports, "parseCallToolResult", { enumerable: true, get: function () { return types_js_1.parseCallToolResult; } });
+Object.defineProperty(exports, "parseMemberSnapshot", { enumerable: true, get: function () { return types_js_1.parseMemberSnapshot; } });
+Object.defineProperty(exports, "parseRuntimeRouteResult", { enumerable: true, get: function () { return types_js_1.parseRuntimeRouteResult; } });
+Object.defineProperty(exports, "parseGatingEvaluateResult", { enumerable: true, get: function () { return types_js_1.parseGatingEvaluateResult; } });
+Object.defineProperty(exports, "parseGatingDecisionResult", { enumerable: true, get: function () { return types_js_1.parseGatingDecisionResult; } });
+Object.defineProperty(exports, "parseGatingAuditEntry", { enumerable: true, get: function () { return types_js_1.parseGatingAuditEntry; } });
+Object.defineProperty(exports, "parseGatingPendingEntry", { enumerable: true, get: function () { return types_js_1.parseGatingPendingEntry; } });
+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, "parseErrorEvent", { enumerable: true, get: function () { return types_js_1.parseErrorEvent; } });
+Object.defineProperty(exports, "eventQueryToDict", { enumerable: true, get: function () { return types_js_1.eventQueryToDict; } });
+// -- Typed events ---------------------------------------------------------
+var events_js_1 = require("./events.cjs");
+Object.defineProperty(exports, "parseAgentEvent", { enumerable: true, get: function () { return events_js_1.parseAgentEvent; } });
+Object.defineProperty(exports, "parseMobEventFromSse", { enumerable: true, get: function () { return events_js_1.parseMobEventFromSse; } });
+Object.defineProperty(exports, "parseAgentEventFromSse", { enumerable: true, get: function () { return events_js_1.parseAgentEventFromSse; } });
+Object.defineProperty(exports, "isTextDelta", { enumerable: true, get: function () { return events_js_1.isTextDelta; } });
+Object.defineProperty(exports, "isTextComplete", { enumerable: true, get: function () { return events_js_1.isTextComplete; } });
+Object.defineProperty(exports, "isRunCompleted", { enumerable: true, get: function () { return events_js_1.isRunCompleted; } });
+Object.defineProperty(exports, "isRunFailed", { enumerable: true, get: function () { return events_js_1.isRunFailed; } });
+Object.defineProperty(exports, "isTurnCompleted", { enumerable: true, get: function () { return events_js_1.isTurnCompleted; } });
+Object.defineProperty(exports, "isToolCallRequested", { enumerable: true, get: function () { return events_js_1.isToolCallRequested; } });
+Object.defineProperty(exports, "EventStream", { enumerable: true, get: function () { return events_js_1.EventStream; } });
+// -- Config modules -------------------------------------------------------
+var index_js_1 = require("./config/index.cjs");
+Object.defineProperty(exports, "auth", { enumerable: true, get: function () { return index_js_1.auth; } });
+Object.defineProperty(exports, "memory", { enumerable: true, get: function () { return index_js_1.memory; } });
+Object.defineProperty(exports, "sessionStore", { enumerable: true, get: function () { return index_js_1.sessionStore; } });
+// -- Module authoring helpers ---------------------------------------------
+var helpers_js_1 = require("./helpers.cjs");
+Object.defineProperty(exports, "defineModuleSpec", { enumerable: true, get: function () { return helpers_js_1.defineModuleSpec; } });
+Object.defineProperty(exports, "decorateModuleSpec", { enumerable: true, get: function () { return helpers_js_1.decorateModuleSpec; } });
+Object.defineProperty(exports, "decorateModuleTool", { enumerable: true, get: function () { return helpers_js_1.decorateModuleTool; } });
+Object.defineProperty(exports, "defineModuleTool", { enumerable: true, get: function () { return helpers_js_1.defineModuleTool; } });
+Object.defineProperty(exports, "defineModule", { enumerable: true, get: function () { return helpers_js_1.defineModule; } });
+Object.defineProperty(exports, "buildConsoleRoute", { enumerable: true, get: function () { return helpers_js_1.buildConsoleRoute; } });
+Object.defineProperty(exports, "buildConsoleModulesRoute", { enumerable: true, get: function () { return helpers_js_1.buildConsoleModulesRoute; } });
+Object.defineProperty(exports, "buildConsoleExperienceRoute", { enumerable: true, get: function () { return helpers_js_1.buildConsoleExperienceRoute; } });
+Object.defineProperty(exports, "buildConsoleRoutes", { enumerable: true, get: function () { return helpers_js_1.buildConsoleRoutes; } });
+// -- Transport (advanced usage) -------------------------------------------
+var transport_js_1 = require("./transport.cjs");
+Object.defineProperty(exports, "PersistentTransport", { enumerable: true, get: function () { return transport_js_1.PersistentTransport; } });
+Object.defineProperty(exports, "buildJsonRpcRequest", { enumerable: true, get: function () { return transport_js_1.buildJsonRpcRequest; } });
+Object.defineProperty(exports, "createGatewaySyncTransport", { enumerable: true, get: function () { return transport_js_1.createGatewaySyncTransport; } });
+Object.defineProperty(exports, "createGatewayAsyncTransport", { enumerable: true, get: function () { return transport_js_1.createGatewayAsyncTransport; } });
+Object.defineProperty(exports, "createJsonRpcHttpTransport", { enumerable: true, get: function () { return transport_js_1.createJsonRpcHttpTransport; } });
+// -- SSE (advanced usage) -------------------------------------------------
+var sse_js_1 = require("./sse.cjs");
+Object.defineProperty(exports, "parseSseStream", { enumerable: true, get: function () { return sse_js_1.parseSseStream; } });
+Object.defineProperty(exports, "encodeSseEvent", { enumerable: true, get: function () { return sse_js_1.encodeSseEvent; } });
+// -- Low-level clients (backward compat) ----------------------------------
+var client_js_1 = require("./client.cjs");
+Object.defineProperty(exports, "MobkitTypedClient", { enumerable: true, get: function () { return client_js_1.MobkitTypedClient; } });
+Object.defineProperty(exports, "MobkitAsyncClient", { enumerable: true, get: function () { return client_js_1.MobkitAsyncClient; } });

package/dist/cjs/models.cjs

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Typed data models for MobKit SDK — input/config objects sent to the runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionBuildOptions = void 0;
+exports.discoverySpecToDict = discoverySpecToDict;
+exports.preSpawnDataToDict = preSpawnDataToDict;
+exports.sessionQueryToDict = sessionQueryToDict;
+function discoverySpecToDict(spec) {
+    const result = {
+        profile: spec.profile,
+        meerkat_id: spec.meerkatId,
+    };
+    if (spec.labels && Object.keys(spec.labels).length > 0) {
+        result.labels = { ...spec.labels };
+    }
+    if (spec.appContext !== undefined) {
+        result.app_context = spec.appContext;
+    }
+    if (spec.additionalInstructions && spec.additionalInstructions.length > 0) {
+        result.additional_instructions = [...spec.additionalInstructions];
+    }
+    if (spec.resumeSessionId !== undefined) {
+        result.resume_session_id = spec.resumeSessionId;
+    }
+    return result;
+}
+function preSpawnDataToDict(data) {
+    const result = {};
+    if (data.resumeMap && Object.keys(data.resumeMap).length > 0) {
+        result.resume_map = { ...data.resumeMap };
+    }
+    if (data.moduleId !== undefined) {
+        result.module_id = data.moduleId;
+    }
+    if (data.env && Object.keys(data.env).length > 0) {
+        result.env = Object.entries(data.env);
+    }
+    return result;
+}
+function sessionQueryToDict(query) {
+    const result = {};
+    if (query.agentType !== undefined)
+        result.agent_type = query.agentType;
+    if (query.ownerId !== undefined)
+        result.owner_id = query.ownerId;
+    if (query.labels && Object.keys(query.labels).length > 0) {
+        result.labels = { ...query.labels };
+    }
+    result.include_deleted = query.includeDeleted ?? false;
+    result.limit = query.limit ?? 100;
+    return result;
+}
+/**
+ * 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);
+ *   },
+ * };
+ * ```
+ */
+class SessionBuildOptions {
+    appContext = undefined;
+    additionalInstructions = [];
+    sessionId = null;
+    labels = {};
+    profileName = null;
+    _tools = [];
+    _toolHandlers = new Map();
+    /** Declare tool names the agent can use. */
+    addTools(tools) {
+        for (const t of tools) {
+            if (typeof t !== "string") {
+                throw new TypeError(`tools must be strings, got ${typeof t}: ${String(t)}`);
+            }
+        }
+        this._tools.push(...tools);
+    }
+    /** Register a callable tool with the agent. */
+    registerTool(name, handler) {
+        if (typeof name !== "string") {
+            throw new TypeError(`tool name must be a string, got ${typeof name}: ${String(name)}`);
+        }
+        if (typeof handler !== "function") {
+            throw new TypeError(`handler must be callable, got ${typeof handler}: ${String(handler)}`);
+        }
+        this._tools.push(name);
+        this._toolHandlers.set(name, handler);
+    }
+    get tools() {
+        return [...this._tools];
+    }
+    get toolHandlers() {
+        return new Map(this._toolHandlers);
+    }
+    toDict() {
+        const result = {};
+        if (this.appContext !== undefined)
+            result.app_context = this.appContext;
+        if (this.additionalInstructions.length > 0) {
+            result.additional_instructions = [...this.additionalInstructions];
+        }
+        if (this.sessionId !== null)
+            result.session_id = this.sessionId;
+        if (Object.keys(this.labels).length > 0) {
+            result.labels = { ...this.labels };
+        }
+        if (this.profileName !== null)
+            result.profile_name = this.profileName;
+        if (this._tools.length > 0)
+            result.tools = [...this._tools];
+        return result;
+    }
+}
+exports.SessionBuildOptions = SessionBuildOptions;