@loomfsm/mcp-server 0.1.0

package/dist/src/tools/run-task.js

@@ -0,0 +1,172 @@
+// pipeline_run_task — task-create handler.
+//
+// Composition order:
+//   1. assertProjectDirAllowed — refusal lands as an error-shaped wire
+//      envelope, NOT a thrown exception.
+//   2. Validate client_idempotency_uuid — empty → error envelope.
+//   3. Ledger cache lookup — a `task-create:<uuid>` row carrying a
+//      materialized response_blob replays the cached creation envelope
+//      verbatim (same task_id / driver_state_id, read off the canonical
+//      pipeline_state row).
+//   4. Parse the raw task string when no policy_preset was supplied.
+//   5. Open one withStateTransaction → initializeTask (atomic multi-table
+//      insert + co-committed task-create ledger row) + a co-committed
+//      audit row → commit.
+//   6. Load state, run the FSM to its first directive, shape it.
+//   7. Update the ledger row's response_blob with the shaped envelope so
+//      a later replay returns it verbatim.
+//
+// Operational failures (allowlist refusal, missing UUID, kernel-coded
+// refusals) become structured error envelopes; the MCP client sees the
+// same wire shape for a refusal as for the happy path. Only programmer
+// errors throw.
+import { assertProjectDirAllowed, captureNow, initializeTask, KernelError, loadState, openDb, readLedgerRow, runFSM, TransactionImpl, withStateTransaction, writeLedgerRow, } from "@loomfsm/kernel";
+import { parseTaskArgs } from "../lib/parse-task-args.js";
+import { persistDriverStepIndex } from "../lib/persist-progress.js";
+import { createTransportAdapter } from "../transport-adapter.js";
+const UNKNOWN_DRIVER = "d-unknown";
+export function createRunTaskTool(deps = {}) {
+    const adapter = createTransportAdapter();
+    return async (input) => {
+        // 1. Project-dir allowlist.
+        try {
+            await assertProjectDirAllowed(input.project_dir, deps.allowlistPath !== undefined ? { allowlistPath: deps.allowlistPath } : undefined);
+        }
+        catch (err) {
+            return refusal(err);
+        }
+        // 2. client_idempotency_uuid is REQUIRED.
+        if (typeof input.client_idempotency_uuid !== "string" ||
+            input.client_idempotency_uuid.length === 0) {
+            return {
+                response: errorResponse(UNKNOWN_DRIVER, "TASK_IDEMPOTENCY_REQUIRED", "client_idempotency_uuid is required on every pipeline_run_task call"),
+            };
+        }
+        // 3. Replay — return the cached creation envelope verbatim.
+        const cached = await readCachedCreation(input.project_dir, input.client_idempotency_uuid);
+        if (cached !== null)
+            return cached;
+        if (deps.resolveRegistry === undefined) {
+            return {
+                response: errorResponse(UNKNOWN_DRIVER, "REGISTRY_UNAVAILABLE", "no registry resolver is wired for the active-task path"),
+            };
+        }
+        const registry = await deps.resolveRegistry(input.project_dir);
+        // 4. Parse the raw task only when the host did not name a preset.
+        let task = input.task;
+        let policyPreset = input.policy_preset;
+        let warnings = [];
+        if (policyPreset === undefined) {
+            const parsed = parseTaskArgs(input.task);
+            task = parsed.task;
+            policyPreset = parsed.policy_preset;
+            warnings = parsed.warnings;
+        }
+        // 5. Atomic create + co-committed audit row.
+        const identifier = typeof input.client_identifier_unverified === "string" &&
+            input.client_identifier_unverified.length > 0
+            ? input.client_identifier_unverified
+            : "unknown";
+        let ids;
+        try {
+            ids = await withStateTransaction(input.project_dir, captureNow(), async (tx) => {
+                const created = await initializeTask(tx, {
+                    project_dir: input.project_dir,
+                    task,
+                    task_short: null,
+                    owner_id: input.owner_id ?? "anonymous",
+                    ...(policyPreset !== undefined ? { policy_preset: policyPreset } : {}),
+                    ...(input.gate_policies !== undefined
+                        ? { gate_policies: input.gate_policies }
+                        : {}),
+                    ...(input.complexity_hint !== undefined
+                        ? { complexity_hint: input.complexity_hint }
+                        : {}),
+                    ...(input.tests_mode_hint !== undefined
+                        ? { tests_mode_hint: input.tests_mode_hint }
+                        : {}),
+                    stack: input.stack ?? null,
+                    client_idempotency_uuid: input.client_idempotency_uuid,
+                    phases: registry.bundle.phases,
+                    // Drive the bundle's declared default flow. The kernel stores
+                    // this on the driver row at create; runFSM resolves it against
+                    // the registry's flow map every tick.
+                    flow_name: registry.bundle.default_flow,
+                });
+                await writeAuditRow(tx, "pipeline_run_task", created.task_id, created.driver_state_id, {
+                    client_identifier_unverified: identifier,
+                });
+                return created;
+            });
+        }
+        catch (err) {
+            return refusal(err);
+        }
+        // 6. Load state, run the FSM to its first directive, shape it.
+        const loaded = await readState(input.project_dir);
+        const { state: ticked, directive } = await runFSM(loaded, registry);
+        const response = adapter.shape(directive, { driver_state_id: ids.driver_state_id });
+        // 7. Persist the tick's paused step index + materialize the cached
+        //    creation response on the ledger row, co-committed.
+        await withStateTransaction(input.project_dir, captureNow(), async (tx) => {
+            await persistDriverStepIndex(tx, ticked.driver.step_index);
+            await writeLedgerRow(tx, `task-create:${input.client_idempotency_uuid}`, {
+                driver_state_id: ids.driver_state_id,
+                task_id: ids.task_id,
+                response_blob: JSON.stringify(response),
+            });
+        });
+        return {
+            response,
+            task_id: ids.task_id,
+            driver_state_id: ids.driver_state_id,
+            ...(warnings.length > 0 ? { warnings } : {}),
+        };
+    };
+}
+// Read the canonical state through a read-only TransactionImpl — the
+// handler never commits this scope, so the now token threaded here is
+// local and not observable on disk.
+async function readState(projectDir) {
+    const db = openDb(projectDir);
+    const tx = new TransactionImpl(db, captureNow());
+    return await loadState(tx);
+}
+async function readCachedCreation(projectDir, uuid) {
+    const db = openDb(projectDir);
+    const tx = new TransactionImpl(db, captureNow());
+    const row = await readLedgerRow(tx, `task-create:${uuid}`);
+    if (row === null || row.response_blob === null)
+        return null;
+    const response = JSON.parse(row.response_blob);
+    const ps = await tx.queryRow("SELECT task_id, driver_state_id FROM pipeline_state WHERE id = 1");
+    const out = { response };
+    if (ps !== null) {
+        if (ps.task_id !== null)
+            out.task_id = String(ps.task_id);
+        out.driver_state_id = String(ps.driver_state_id);
+    }
+    return out;
+}
+async function writeAuditRow(tx, type, taskId, driverStateId, payload) {
+    await tx.exec("INSERT INTO audit (ts, type, task_id, driver_state_id, payload, verdict, error_class) " +
+        "VALUES (?, ?, ?, ?, ?, 'ok', NULL)", [tx.now, type, taskId, driverStateId, JSON.stringify(payload)]);
+}
+// Map a thrown KernelError into an error-shaped wire envelope; rethrow
+// anything that is not a kernel-coded refusal (programmer error).
+function refusal(err) {
+    if (err instanceof KernelError) {
+        return { response: errorResponse(UNKNOWN_DRIVER, err.code, err.message) };
+    }
+    throw err;
+}
+function errorResponse(driverStateId, code, message) {
+    return {
+        status: "error",
+        driver_state_id: driverStateId,
+        code,
+        message,
+        recovery_options: [],
+    };
+}
+//# sourceMappingURL=run-task.js.map

package/dist/src/tools/run-task.js.map

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

package/dist/src/tools/state-get.d.ts

@@ -0,0 +1,2 @@
+import type { PipelineStateView, StateGetInput, ToolHandler } from "../types.js";
+export declare function createStateGetTool(): ToolHandler<StateGetInput, PipelineStateView>;

package/dist/src/tools/state-get.js

@@ -0,0 +1,176 @@
+// pipeline_state_get — operator-inspection handler. Four output
+// formats sit behind one entry: a compact summary keyed on the most-
+// asked counters, the full PipelineState aggregate, per-table JSONL,
+// and a stable-width ASCII rendering whose column widths are pinned
+// so two snapshots diff cleanly.
+//
+// Every format reads inside a single `withReadTransaction`: one
+// consistent committed snapshot per call (BEGIN DEFERRED + query_only),
+// so a multi-statement inspection never sees a torn mix across an
+// interleaved writer commit, and the reader never blocks the writer.
+import { loadState, withReadTransaction } from "@loomfsm/kernel";
+const DEFAULT_TABLE = "audit";
+const DEFAULT_TABLE_LIMIT = 100;
+const MAX_TABLE_LIMIT = 1000;
+// Tables the caller may inspect via `jsonl` / `pretty-table`. The
+// allowlist closes the surface against accidental cross-table reads
+// from the same handler — the operator cannot trick the tool into
+// dumping the idempotency ledger by passing `kernel_idempotency_ledger`
+// as the table filter, because that table is not on the list.
+const INSPECTABLE_TABLES = new Set([
+    "pipeline_state",
+    "pipeline_counters",
+    "pipeline_gate_counters",
+    "driver_state",
+    "phases",
+    "agent_records",
+    "pending_agents",
+    "agent_verdicts",
+    "findings",
+    "gates",
+    "audit",
+    "installed_extensions",
+]);
+// Tables that carry a `ts` column the `since` filter can target. Other
+// inspectable tables use a `recorded_at` or `started_at` column; the
+// `since` filter intentionally stays narrow to keep the contract
+// predictable.
+const TS_FILTERED_TABLES = new Set(["audit", "findings"]);
+function tsColumnFor(table) {
+    if (table === "audit")
+        return "ts";
+    if (table === "findings")
+        return "recorded_at";
+    return null;
+}
+function clampLimit(raw) {
+    if (raw === undefined || !Number.isFinite(raw) || raw <= 0)
+        return DEFAULT_TABLE_LIMIT;
+    if (raw > MAX_TABLE_LIMIT)
+        return MAX_TABLE_LIMIT;
+    return Math.floor(raw);
+}
+export function createStateGetTool() {
+    return async (input) => {
+        const format = input.format ?? "summary";
+        return await withReadTransaction(input.project_dir, async (tx) => {
+            if (format === "summary")
+                return await renderSummary(tx);
+            if (format === "json")
+                return { format: "json", state: await loadState(tx) };
+            if (format === "jsonl")
+                return await renderJsonl(tx, input);
+            return await renderPrettyTable(tx, input);
+        });
+    };
+}
+// ---------------------------------------------------------------------
+// summary — small per-table counts. Avoids loading PipelineState so a
+// state-get call against an uninitialized project still returns a
+// useful envelope.
+// ---------------------------------------------------------------------
+async function renderSummary(tx) {
+    const ps = await tx.queryRow("SELECT task_id, status, owner_id FROM pipeline_state WHERE id = 1");
+    const pendingRow = await tx.queryRow("SELECT COUNT(*) AS c FROM pending_agents");
+    const gatesRow = await tx.queryRow("SELECT COUNT(*) AS c FROM gates");
+    const auditRow = await tx.queryRow("SELECT COUNT(*) AS c FROM audit");
+    const findingsRow = await tx.queryRow("SELECT COUNT(*) AS c FROM findings");
+    return {
+        format: "summary",
+        summary: {
+            task_id: ps?.task_id ?? null,
+            status: ps?.status ?? null,
+            owner_id: ps?.owner_id ?? null,
+            pending_agent_count: Number(pendingRow?.c ?? 0),
+            gate_count: Number(gatesRow?.c ?? 0),
+            audit_row_count: Number(auditRow?.c ?? 0),
+            finding_count: Number(findingsRow?.c ?? 0),
+        },
+    };
+}
+// ---------------------------------------------------------------------
+// jsonl — each row of the requested table on its own line.
+// ---------------------------------------------------------------------
+async function renderJsonl(tx, input) {
+    const table = resolveTable(input.table);
+    const limit = clampLimit(input.limit);
+    const rows = await queryTable(tx, table, input.since, limit);
+    return { format: "jsonl", lines: rows.map((r) => JSON.stringify(r)) };
+}
+// ---------------------------------------------------------------------
+// pretty-table — stable-width ASCII renderer. Widths are
+// max(column name length, max cell length) per column; the same input
+// rows render identically across runs so two state-get snapshots diff
+// cleanly without whitespace noise.
+// ---------------------------------------------------------------------
+async function renderPrettyTable(tx, input) {
+    const limit = clampLimit(input.limit);
+    const tables = {};
+    if (input.table !== undefined) {
+        const table = resolveTable(input.table);
+        const rows = await queryTable(tx, table, input.since, limit);
+        tables[table] = renderTable(rows);
+        return { format: "pretty-table", tables };
+    }
+    const table = DEFAULT_TABLE;
+    const rows = await queryTable(tx, table, input.since, limit);
+    tables[table] = renderTable(rows);
+    return { format: "pretty-table", tables };
+}
+// ---------------------------------------------------------------------
+// Per-table query helper. Honors `since` only when the table exposes a
+// timestamp column on the allowlist.
+// ---------------------------------------------------------------------
+async function queryTable(tx, table, since, limit) {
+    const tsCol = tsColumnFor(table);
+    if (since !== undefined && tsCol !== null && TS_FILTERED_TABLES.has(table)) {
+        return await tx.queryAll(`SELECT * FROM ${table} WHERE ${tsCol} >= ? LIMIT ?`, [since, limit]);
+    }
+    return await tx.queryAll(`SELECT * FROM ${table} LIMIT ?`, [limit]);
+}
+function resolveTable(requested) {
+    const candidate = requested ?? DEFAULT_TABLE;
+    if (!INSPECTABLE_TABLES.has(candidate)) {
+        // Fall through to default rather than throwing: the tool is an
+        // operator inspection surface, and a typo on the table name should
+        // not nuke the call. Future work may surface this as a warning
+        // envelope alongside the table dump.
+        return DEFAULT_TABLE;
+    }
+    return candidate;
+}
+function renderTable(rows) {
+    if (rows.length === 0)
+        return "(empty)";
+    const headers = Object.keys(rows[0]);
+    const widths = headers.map((h) => {
+        let w = h.length;
+        for (const row of rows) {
+            const cell = stringifyCell(row[h]);
+            if (cell.length > w)
+                w = cell.length;
+        }
+        return w;
+    });
+    const headerLine = headers
+        .map((h, i) => h.padEnd(widths[i]))
+        .join(" | ");
+    const sep = widths.map((w) => "-".repeat(w)).join("-+-");
+    const body = rows
+        .map((row) => headers
+        .map((h, i) => stringifyCell(row[h]).padEnd(widths[i]))
+        .join(" | "))
+        .join("\n");
+    return `${headerLine}\n${sep}\n${body}`;
+}
+function stringifyCell(v) {
+    if (v === null || v === undefined)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint") {
+        return String(v);
+    }
+    return JSON.stringify(v);
+}
+//# sourceMappingURL=state-get.js.map

package/dist/src/tools/state-get.js.map

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

package/dist/src/transport-adapter.d.ts

@@ -0,0 +1,6 @@
+import type { KernelDirective } from "@loomfsm/kernel";
+import type { TransportAdapter, TransportResponse } from "@loomfsm/transport-types";
+export declare function createTransportAdapter(): TransportAdapter;
+export declare function shape(directive: KernelDirective, ctx: {
+    driver_state_id: string;
+}): TransportResponse;

package/dist/src/transport-adapter.js

@@ -0,0 +1,94 @@
+// The MCP transport adapter — pure mapping `KernelDirective →
+// TransportResponse`.
+//
+// No I/O, no DB reads, no clock reads: the same directive in produces a
+// structurally-equal envelope out. Pushing the kernel-to-wire seam into
+// one pure function lets every transport carry its own copy without
+// re-implementing kernel reads, and keeps the kernel free of any
+// wire-shape coupling.
+//
+// `runner_hint` is hard-coded to "mcp-server" on every emitted spawn
+// descriptor; the hint is opaque to the kernel and lets the host
+// disambiguate provider routing.
+//
+// `advance` is never a top-level `runFSM` result — the tick loop
+// swallows it internally and only returns at a terminal directive. The
+// adapter refuses the impossible with a `KERNEL_INVARIANT` error rather
+// than crashing, so a kernel regression surfaces as a structured wire
+// error the client can display.
+const RUNNER_HINT = "mcp-server";
+export function createTransportAdapter() {
+    return { shape };
+}
+export function shape(directive, ctx) {
+    switch (directive.kind) {
+        case "advance":
+            return {
+                status: "error",
+                driver_state_id: ctx.driver_state_id,
+                code: "KERNEL_INVARIANT",
+                message: "top-level advance directive surfaced — kernel must terminate at a non-advance kind",
+                recovery_options: [],
+            };
+        case "shuttle": {
+            const intent = directive.spawn;
+            return {
+                status: "spawn-agent",
+                driver_state_id: ctx.driver_state_id,
+                agent_run_id: intent.agent_run_id,
+                agent: intent.agent,
+                spawn_request: toSpawnRequest(intent),
+            };
+        }
+        case "shuttle-batch":
+            return {
+                status: "spawn-agents-parallel",
+                driver_state_id: ctx.driver_state_id,
+                spawns: directive.spawns.map((intent) => ({
+                    agent_run_id: intent.agent_run_id,
+                    agent: intent.agent,
+                    spawn_request: toSpawnRequest(intent),
+                })),
+            };
+        case "ask-user":
+            return {
+                status: "ask-user",
+                driver_state_id: directive.driver_state_id,
+                gate: directive.gate,
+                gate_event_id: directive.gate_event_id,
+                message: directive.message,
+                valid_answers: directive.valid_answers,
+            };
+        case "complete":
+            return {
+                status: "complete",
+                task_id: directive.task_id,
+                verdict: directive.verdict,
+                summary: directive.summary,
+            };
+        case "error":
+            return {
+                status: "error",
+                driver_state_id: directive.driver_state_id,
+                code: directive.code,
+                message: directive.message,
+                recovery_options: directive.recovery_options,
+            };
+        default: {
+            const _exhaustive = directive;
+            return _exhaustive;
+        }
+    }
+}
+function toSpawnRequest(intent) {
+    const req = {
+        runner_hint: RUNNER_HINT,
+        description: `${intent.agent} (${intent.phase})`,
+        prompt: intent.prompt,
+        model: intent.model,
+    };
+    if (intent.extras !== undefined)
+        req.extras = intent.extras;
+    return req;
+}
+//# sourceMappingURL=transport-adapter.js.map

package/dist/src/transport-adapter.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,171 @@
+import type { ContinueTaskInput, ExtensionKind, ExtensionManifest, PipelineStateView, StackInfo } from "@loomfsm/kernel";
+import type { SpawnRequest, TransportResponse } from "@loomfsm/transport-types";
+export type { PipelineStateView };
+export type { ContinueTaskInput, SpawnRequest, TransportResponse };
+export interface ClientCapabilities {
+    honors_shuttle?: boolean;
+    supports_sse?: boolean;
+    supports_streaming?: boolean;
+}
+export interface MetaInput {
+    client_identifier_unverified?: string;
+    client_capabilities?: ClientCapabilities;
+}
+export interface MetaTransports {
+    active: string;
+    available: string[];
+}
+export interface MetaProviders {
+    enabled: string[];
+    active_default: string;
+    compatible_with_client: string[];
+}
+export interface MetaBundle {
+    name: string;
+    version: string;
+}
+export interface MetaSandbox {
+    kind: string;
+}
+export interface PipelineMetaResponse {
+    protocol_version: string;
+    plugin_api_version: string;
+    kernel_version: string;
+    client_identifier_unverified: string;
+    flag_vocabulary: string[];
+    transports: MetaTransports;
+    providers: MetaProviders;
+    bundles_available: MetaBundle[];
+    sandbox: MetaSandbox;
+}
+export type StateGetFormat = "summary" | "json" | "jsonl" | "pretty-table";
+export interface StateGetInput {
+    project_dir: string;
+    format?: StateGetFormat;
+    table?: string;
+    since?: string;
+    limit?: number;
+}
+export type ExtensionStatus = "enabled" | "disabled" | "failed";
+export interface ExtensionsListInput {
+    project_dir: string;
+    kind?: ExtensionKind;
+    status?: ExtensionStatus;
+    include_manifest?: boolean;
+}
+export interface ExtensionsListEntry {
+    id: string;
+    kind: ExtensionKind;
+    name: string;
+    publisher: string;
+    version: string;
+    status: ExtensionStatus;
+    installed_at: string;
+    updated_at: string;
+    failure_reason?: string;
+    manifest?: ExtensionManifest;
+}
+export interface ExtensionsListResponse {
+    extensions: ExtensionsListEntry[];
+}
+export interface ParsedTaskArgs {
+    task: string;
+    policy_preset?: string;
+    warnings: string[];
+}
+export interface RunTaskInput {
+    project_dir: string;
+    task: string;
+    client_idempotency_uuid: string;
+    policy_preset?: string;
+    gate_policies?: Record<string, string>;
+    complexity_hint?: "simple" | "medium" | "complex";
+    tests_mode_hint?: "tdd" | "regression-only";
+    stack?: StackInfo;
+    owner_id?: string;
+    client_identifier_unverified?: string;
+}
+export interface RunTaskResponse {
+    response: TransportResponse;
+    task_id?: string;
+    driver_state_id?: string;
+    warnings?: string[];
+}
+export interface ContinueTaskRequestInput {
+    project_dir: string;
+    driver_state_id: string;
+    input: ContinueTaskInput;
+    client_identifier_unverified?: string;
+}
+export interface ContinueTaskResponse {
+    response: TransportResponse;
+}
+export type RecoveryChoiceInput = "abandon" | "force-close" | "retry" | "retry-failed" | "cancel-pending";
+export interface BypassMarkerInput {
+    issued_at: string;
+    expires_at: string;
+    reason: string;
+    hmac: string;
+    key_id: string;
+}
+export interface RecoverTaskInput {
+    project_dir: string;
+    driver_state_id: string;
+    choice: RecoveryChoiceInput;
+    agent_run_ids?: string[];
+    recovery_id?: string;
+    owner_id?: string;
+    marker?: BypassMarkerInput;
+    client_identifier_unverified?: string;
+}
+export interface IssueCrossOwnerMarkerInput {
+    project_dir: string;
+    driver_state_id: string;
+    ttl_ms: number;
+    client_identifier_unverified?: string;
+}
+export interface IssueCrossOwnerMarkerResponse {
+    key_id: string | null;
+    hmac: string | null;
+    issued_at: string | null;
+    expires_at: string | null;
+    reason: string | null;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface RecoverTaskResponse {
+    response: TransportResponse;
+    recovery_id: string;
+}
+export interface BackupInput {
+    project_dir: string;
+    to: string;
+    client_identifier_unverified?: string;
+}
+export interface BackupResponse {
+    bytes_written: number | null;
+    ts: string;
+    backup_path: string | null;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface RestoreInput {
+    project_dir: string;
+    from: string;
+    format: "sql" | "binary";
+    confirm?: boolean;
+    client_identifier_unverified?: string;
+}
+export interface RestoreResponse {
+    restored: boolean;
+    ts: string;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export type ToolHandler<I, O> = (input: I) => Promise<O>;

package/dist/src/types.js

@@ -0,0 +1,9 @@
+// Local envelopes returned by the read-only tools.
+//
+// Defined here rather than in a shared transport-types package so the
+// read-only surface stays self-contained; when the mutating tools land
+// and need to emit a wire-shared response shape, that work extracts a
+// transport-types package and shifts these or their richer siblings
+// into it.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,sEAAsE;AACtE,uEAAuE;AACvE,sEAAsE;AACtE,oEAAoE;AACpE,WAAW"}