opensquid 0.5.441 → 0.5.447

package/dist/rag/backends/loop_engine.js

@@ -1,160 +0,0 @@
-/**
- * Loop-engine RAG backend — routes RagBackend through the engine daemon's
- * JSON-RPC API (memory.search + memory.create) via the T.4 UDS singleton.
- *
- * Quality: `mode: 'hybrid'` invokes engine-side RRF fusion (K=60, Cormack
- * et al. 2009) — drop-in equivalent to opensquid's `src/rag/rrf.ts:65`
- * per T.1.JJ. No TS-side fusion needed; engine does it server-side over a
- * larger native vector index than libsql's DiskANN.
- *
- * Critical design locks (T.1.B + T.1.#6):
- *
- *  1. **storeLesson → memory.create is INTENTIONAL, not a bug.** Routing
- *     here through `lesson.create` would force every recall-pool write
- *     through the wedge gate's 24h + applied_count=3 + external_signal
- *     promotion requirements (per T.1.F — unsatisfiable in a single
- *     write call, breaks unit tests). RagBackend.storeLesson semantically
- *     stores a recallable memory, NOT a wedge-gated lesson; lesson
- *     lifecycle is a separate surface added in T.6.
- *
- *  2. **Description synthesis is mandatory.** `memory.create` rejects
- *     empty `description` (T.1.B INVALID_PARAMS -32602). Synthesized
- *     from first sentence → first 80 chars → ultimate fallback. Lesson
- *     shape doesn't carry a description field today, so we derive it.
- *
- *  3. **`include_body: true` on every recall.** memory.search's default
- *     `body_preview` is truncated to 240 chars (engine serve.rs); without
- *     this flag RecallHit.lesson.content gets cut mid-sentence.
- *
- *  4. **Source vocab mapping at the boundary.** Engine speaks
- *     `'semantic' | 'text' | 'both'`; RagBackend's RecallHit speaks
- *     `'semantic' | 'lexical' | 'fused'`. The adapter table is the
- *     single point of translation — DO NOT leak engine vocab past it.
- *
- *  5. **Engine schema gap.** `memory.create` doesn't preserve tags /
- *     source / author / createdAt today (T.8 follow-up filed). For v1
- *     we send `description` + `content` only; lesson metadata round-trips
- *     via the Lesson defaults applied by `src/functions/rag.ts:122-145`.
- *
- *  6. **No daemon lifecycle here.** `EngineClient` connects via the T.4
- *     `acquireOrSpawnEngine()` singleton transparently — zero per-call
- *     subprocess cost, cross-session shared engine.
- *
- * Imports from: ../../engine/client.js, ../ollama_client.js, ../types.js.
- * Imported by: src/rag/backend_factory.ts.
- */
-import { ENGINE_ERROR, EngineClient, RpcError } from '../../engine/client.js';
-import { ollamaEmbed } from '../ollama_client.js';
-import { UserAuthoredImmunityError } from '../types.js';
-export function loopEngineBackend(opts = {}) {
-    const client = opts.client ?? new EngineClient();
-    const mode = opts.mode ?? 'hybrid';
-    const ollamaUrl = opts.ollamaUrl ?? 'http://localhost:11434';
-    return {
-        async init() {
-            // Ensures engine daemon is up + connected before any primitive call.
-            // Singleton handles spawn-or-acquire; ping confirms the handshake.
-            await client.ping();
-        },
-        async embed(text) {
-            // RagBackend contract says embedder-unavailable returns null, not
-            // throws (T.1.T). ollamaEmbed throws on HTTP / malformed response;
-            // we translate.
-            try {
-                return await ollamaEmbed(ollamaUrl, text);
-            }
-            catch {
-                return null;
-            }
-        },
-        async recall(query, k) {
-            const result = await client.memorySearch({
-                query,
-                limit: k,
-                mode,
-                include_body: true,
-            });
-            return result.results.map((h) => ({
-                lesson: {
-                    id: h.id,
-                    content: h.body_preview,
-                    tags: [],
-                    source: 'unknown',
-                    author: 'user',
-                    createdAt: '',
-                },
-                score: h.similarity,
-                source: mapEngineSource(h.source),
-            }));
-        },
-        async storeLesson(lesson) {
-            const description = synthesizeDescription(lesson.content);
-            await client.memoryCreate({
-                description,
-                content: lesson.content,
-                // Preserve eviction immunity across the write-path cutover: a `user`-authored memory must
-                // round-trip `authored_by` so the engine keeps it eviction-immune (else memorize→storeLesson
-                // would silently strip immunity). The string collapses to Lesson.author ('user'|'agent').
-                authored_by: lesson.author,
-            });
-        },
-        async deleteLesson(id, delOpts) {
-            try {
-                await client.memoryGet({ id }); // existence pre-check (NOT_FOUND → not-found result)
-            }
-            catch (e) {
-                if (e instanceof RpcError && e.code === ENGINE_ERROR.NOT_FOUND) {
-                    return { deleted: false, forced: false };
-                }
-                throw e;
-            }
-            try {
-                const result = await client.memoryDelete({
-                    id,
-                    ...(delOpts?.force === undefined ? {} : { force: delOpts.force }),
-                });
-                return { deleted: true, forced: result.forced };
-            }
-            catch (e) {
-                if (e instanceof RpcError && e.code === ENGINE_ERROR.USER_MEMORY_IMMUNE) {
-                    throw new UserAuthoredImmunityError(id);
-                }
-                throw e;
-            }
-        },
-    };
-}
-/**
- * Derive a non-empty description from lesson content. Engine rejects
- * empty descriptions with INVALID_PARAMS -32602 (T.1.B). Algorithm:
- *   1. First sentence (split on `.!?\n`), trimmed, capped at 80 chars
- *   2. Fallback: first 80 chars of raw content (for sentence-free text)
- *   3. Ultimate fallback: `'untitled memory'` (empty-content edge case)
- *
- * 80 chars chosen to match engine's description display budget without
- * truncation in `manifest.assemble` output (engine serve.rs body_preview).
- */
-function synthesizeDescription(content) {
-    const firstSentence = content.split(/[.!?\n]/)[0]?.trim() ?? content;
-    return firstSentence.slice(0, 80) || content.slice(0, 80) || 'untitled memory';
-}
-/**
- * Translate engine source vocabulary into RagBackend RecallHit vocabulary.
- * Engine uses `'semantic' | 'text' | 'both'` (only present in hybrid
- * results); opensquid uses `'semantic' | 'lexical' | 'fused'`. When
- * engine omits source (non-hybrid modes), default to `'semantic'` —
- * matches the dominant recall-from-vector path.
- */
-function mapEngineSource(s) {
-    switch (s) {
-        case 'semantic':
-            return 'semantic';
-        case 'text':
-            return 'lexical';
-        case 'both':
-            return 'fused';
-        default:
-            return 'semantic';
-    }
-}
-//# sourceMappingURL=loop_engine.js.map

package/dist/rag/backends/loop_engine.js.map

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

package/dist/recall.d.ts

@@ -1,82 +0,0 @@
-/**
- * Phase 4: recall ranking utilities — Reciprocal Rank Fusion (RRF)
- * + similarity-threshold gating.
- *
- * The engine returns lessons (text-match similarity) and memories
- * (semantic-vector similarity) on different score scales — they're
- * not directly comparable. RRF sidesteps that: it ignores absolute
- * scores and uses ranks-within-list only. Items appearing in BOTH
- * lists get a strong combined boost — "the text matched AND the
- * embedding is close" is the most reliable signal.
- *
- * The similarity threshold filters PER-SOURCE before merging so a
- * weak hit in one list can't poison the merged ranking. When all
- * results are filtered out, recall returns an empty merged array —
- * "no relevant context" is decision-makable; "top hit at sim=0.31"
- * is noise.
- */
-/** Conventional RRF damping constant — survives well across domains. */
-export declare const RRF_K = 60;
-/** Default minimum similarity to consider a result relevant. */
-export declare const DEFAULT_MIN_SIMILARITY = 0.5;
-export interface LessonHit {
-    kind: "lesson";
-    id: string;
-    description: string;
-    status: string;
-    body_preview: string;
-    similarity: number;
-    applied_count: number;
-}
-export interface MemoryHit {
-    kind: "memory";
-    id: string;
-    description: string;
-    body_preview: string;
-    similarity: number;
-    /** v0.5: present when the engine's `memory.search` ran in hybrid
-     * (or text-only) mode. `"both"` means the hit surfaced from both
-     * the semantic neighborhood AND the text-match scan — strongest
-     * signal. Surfaced through to the MCP response for diagnostics. */
-    source?: "semantic" | "text" | "both";
-}
-export type RecallHit = LessonHit | MemoryHit;
-export interface MergedHit {
-    kind: "lesson" | "memory";
-    id: string;
-    description: string;
-    body_preview: string;
-    /** Original per-source similarity (lesson text-match or memory semantic). */
-    similarity: number;
-    /** RRF score — higher is better. Not directly comparable to similarity. */
-    rrf_score: number;
-    /** 1-based rank in the lesson list (undefined if not a lesson hit). */
-    lesson_rank?: number;
-    /** 1-based rank in the memory list (undefined if not a memory hit). */
-    memory_rank?: number;
-    /** v0.5: when this hit came from a memory and the engine produced
-     * the memory in hybrid (or text-only) mode, this carries the
-     * sub-source attribution: `"semantic"`, `"text"`, or `"both"`.
-     * Lesson hits leave this undefined (engine.recall doesn't expose
-     * a sub-source). */
-    source?: "semantic" | "text" | "both";
-}
-/**
- * Filter a hit list to those with similarity at or above `threshold`.
- * Stable: preserves the input order (which is engine-side rank).
- */
-export declare function filterBySimilarity<T extends {
-    similarity: number;
-}>(hits: T[], threshold: number): T[];
-/**
- * Reciprocal Rank Fusion across two ranked lists. The RRF score for
- * an item is `sum over each source list: 1 / (RRF_K + rank_in_that_list)`,
- * where rank is 1-based. Items appearing in both lists accumulate
- * contributions and naturally rank above single-source items.
- *
- * Returns merged hits ordered by descending `rrf_score`. Identity is
- * by `id` — a lesson and a memory with the same id (engine never
- * collides these in practice) would merge; we treat that as harmless.
- */
-export declare function mergeRrf(lessons: LessonHit[], memories: MemoryHit[]): MergedHit[];
-//# sourceMappingURL=recall.d.ts.map

package/dist/recall.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../src.legacy/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,wEAAwE;AACxE,eAAO,MAAM,KAAK,KAAK,CAAC;AAExB,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB;;;uEAGmE;IACnE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;wBAIoB;IACpB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EACjE,IAAI,EAAE,CAAC,EAAE,EACT,SAAS,EAAE,MAAM,GAChB,CAAC,EAAE,CAGL;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAwCjF"}

package/dist/recall.js

@@ -1,81 +0,0 @@
-/**
- * Phase 4: recall ranking utilities — Reciprocal Rank Fusion (RRF)
- * + similarity-threshold gating.
- *
- * The engine returns lessons (text-match similarity) and memories
- * (semantic-vector similarity) on different score scales — they're
- * not directly comparable. RRF sidesteps that: it ignores absolute
- * scores and uses ranks-within-list only. Items appearing in BOTH
- * lists get a strong combined boost — "the text matched AND the
- * embedding is close" is the most reliable signal.
- *
- * The similarity threshold filters PER-SOURCE before merging so a
- * weak hit in one list can't poison the merged ranking. When all
- * results are filtered out, recall returns an empty merged array —
- * "no relevant context" is decision-makable; "top hit at sim=0.31"
- * is noise.
- */
-/** Conventional RRF damping constant — survives well across domains. */
-export const RRF_K = 60;
-/** Default minimum similarity to consider a result relevant. */
-export const DEFAULT_MIN_SIMILARITY = 0.5;
-/**
- * Filter a hit list to those with similarity at or above `threshold`.
- * Stable: preserves the input order (which is engine-side rank).
- */
-export function filterBySimilarity(hits, threshold) {
-    if (threshold <= 0)
-        return hits;
-    return hits.filter((h) => h.similarity >= threshold);
-}
-/**
- * Reciprocal Rank Fusion across two ranked lists. The RRF score for
- * an item is `sum over each source list: 1 / (RRF_K + rank_in_that_list)`,
- * where rank is 1-based. Items appearing in both lists accumulate
- * contributions and naturally rank above single-source items.
- *
- * Returns merged hits ordered by descending `rrf_score`. Identity is
- * by `id` — a lesson and a memory with the same id (engine never
- * collides these in practice) would merge; we treat that as harmless.
- */
-export function mergeRrf(lessons, memories) {
-    const byId = new Map();
-    lessons.forEach((h, idx) => {
-        const rank = idx + 1; // 1-based
-        const score = 1 / (RRF_K + rank);
-        byId.set(h.id, {
-            kind: "lesson",
-            id: h.id,
-            description: h.description,
-            body_preview: h.body_preview,
-            similarity: h.similarity,
-            rrf_score: score,
-            lesson_rank: rank,
-        });
-    });
-    memories.forEach((h, idx) => {
-        const rank = idx + 1;
-        const score = 1 / (RRF_K + rank);
-        const existing = byId.get(h.id);
-        if (existing) {
-            existing.rrf_score += score;
-            existing.memory_rank = rank;
-            if (h.source)
-                existing.source = h.source;
-        }
-        else {
-            byId.set(h.id, {
-                kind: "memory",
-                id: h.id,
-                description: h.description,
-                body_preview: h.body_preview,
-                similarity: h.similarity,
-                rrf_score: score,
-                memory_rank: rank,
-                source: h.source,
-            });
-        }
-    });
-    return Array.from(byId.values()).sort((a, b) => b.rrf_score - a.rrf_score);
-}
-//# sourceMappingURL=recall.js.map

package/dist/recall.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"recall.js","sourceRoot":"","sources":["../src.legacy/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;AAExB,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAgD1C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAS,EACT,SAAiB;IAEjB,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAoB,EAAE,QAAqB;IAClE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU;QAChC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC;YAC5B,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC;YAC5B,IAAI,CAAC,CAAC,MAAM;gBAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,YAAY,EAAE,CAAC,CAAC,YAAY;gBAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AAC7E,CAAC"}

package/dist/runtime/agent_bridge/autospawn.d.ts

@@ -1,131 +0,0 @@
-/**
- * agent-bridge headless responder autospawn (T-CHAT-AS-TERMINAL CAT.5.1).
- *
- * The chat-transport daemon (`src/channels/daemon/autospawn.ts`) already
- * autospawns from the MCP chat-bridge boot. The HEADLESS RESPONDER — the
- * agent-bridge daemon that ANSWERS chat when no terminal is live (CAT.5 the
- * project umbrella's headless responder, CAT.6 the project-less `general`
- * session) — did NOT. This module mirrors that chat-daemon autospawn so the
- * headless responder is ALWAYS-ON too: started opportunistically on MCP boot,
- * keyed PER-INSTANCE so `loop` + `general` run concurrently (CAT.5.1's
- * per-scope lock/pid in daemon.ts).
- *
- * SAFE to autospawn the project headless even while a terminal is live: CAT.5's
- * lease-ownership guard makes it STAND DOWN. The headless only answers when it
- * owns a fresh umbrella lease; while a human `chat watch` lease is present the
- * dispatcher's flush-time `isLeaseFreshAndOwnedBy` guard suppresses it — it
- * idles at zero token cost (fs-only heartbeat) until the human lease lapses.
- *
- * Behavior (mirrors `ensureChatDaemonRunning`):
- *   - No-op when no chat platform is configured.
- *   - No-op when the SCOPED daemon (its own pidfile) is already running.
- *   - Else acquire an atomic per-scope spawn-lock (`fs.open(lock, 'wx')`) so two
- *     MCP servers don't double-spawn; the loser waits briefly for the pidfile.
- *     Stale lock (> 15s) is reclaimed.
- *   - Always async + non-throwing. A resolution failure (no project uuid / no
- *     pack) → `{ status: 'no_config' }` (skip that scope, never throw).
- *
- * It spawns `dist/cli.js agent-bridge start [--general]` DETACHED:
- *   - general: `agent-bridge start --general` (env as-is — the worker resolves
- *     the built-in `general` pack itself).
- *   - project umbrella: `agent-bridge start` with `OPENSQUID_PROJECT_UUID` +
- *     `OPENSQUID_PACK_ROOT` injected into the child env (resolved exactly like
- *     cli.ts's non-general path: `resolveProjectUuid` + `resolvePackRootFromEnv`).
- *     If the project uuid can't be resolved → skip (no-op).
- *
- * Imports from: node:fs, node:os, node:path, node:child_process, node:url,
- *   ../../channels/config, ../../channels/routing, ../paths, ./daemon.
- * Imported by: src/mcp/chat-bridge-server.ts (boot) + tests.
- */
-import { type AgentBridgeScopeKey } from './daemon.js';
-export interface AgentBridgeAutoSpawnResult {
-    status: 'spawned' | 'already_running' | 'waited_for_peer' | 'no_config' | 'error';
-    pid?: number;
-    error?: string;
-}
-/**
- * What to autospawn: either the project-less `general` session, or a project
- * umbrella's headless responder (keyed by umbrella id + cwd → project/pack).
- */
-export type EnsureTarget = {
-    kind: 'general';
-} | {
-    kind: 'umbrella';
-    /** The umbrella the cwd resolves to (CAT.5 — the scope identity). */
-    umbrellaId: string;
-    /** Working dir to resolve the project uuid / pack root from. */
-    cwd: string;
-};
-/**
- * Resolve the CLI binary (`dist/cli.js`). From the MCP server at
- * `dist/mcp/chat-bridge-server.js` the CLI sits at `dist/cli.js`; from this
- * module's built location (`dist/runtime/agent_bridge/autospawn.js`) it's three
- * dirs up. We resolve relative to the MCP-server layout to match the chat
- * daemon's `resolveCliEntrypoint`, honoring `OPENSQUID_CLI_ENTRYPOINT`.
- */
-export declare function resolveCliEntrypoint(): string;
-/** A pidfile-liveness probe result, scope-keyed. */
-export interface ScopedStatus {
-    running: boolean;
-    pid?: number;
-}
-/** A detached spawn invocation: argv (after the cli entrypoint) + child env. */
-export interface SpawnInvocation {
-    args: string[];
-    env: NodeJS.ProcessEnv;
-}
-/**
- * Injection seams for tests — exercise the autospawn FSM WITHOUT reading the
- * developer's real chat config or spawning a live daemon.
- */
-export interface EnsureAgentBridgeDeps {
-    /** Override the spawned worker's entrypoint (defaults to `dist/cli.js`). */
-    entrypoint?: string;
-    /** Override the "is any platform configured" probe. */
-    isConfigured?: () => Promise<boolean>;
-    /** Override the scoped-liveness probe. */
-    statusFn?: (scope: AgentBridgeScopeKey) => Promise<ScopedStatus>;
-    /** Override the detached spawn. */
-    spawnFn?: (entrypoint: string, inv: SpawnInvocation) => {
-        pid?: number;
-    };
-    /** Override the project-uuid resolver (tests). */
-    resolveProjectUuidFn?: (opts: {
-        cwd: string;
-        env?: NodeJS.ProcessEnv;
-    }) => Promise<string | null>;
-    /** Override the pack-root resolver (tests). */
-    resolvePackRootFn?: (env?: NodeJS.ProcessEnv) => string;
-    /** Override base env threaded into the child (defaults to `process.env`). */
-    env?: NodeJS.ProcessEnv;
-}
-/**
- * Best-effort: ensure the headless agent-bridge responder for `target` is
- * running. Returns on the no-op paths (no config, already running, peer
- * spawning, unresolvable scope). NEVER throws.
- */
-export declare function ensureAgentBridgeRunning(target: EnsureTarget, opts?: EnsureAgentBridgeDeps): Promise<AgentBridgeAutoSpawnResult>;
-/**
- * MCP-boot convenience (CAT.5.1): ensure (a) the GENERAL headless responder
- * (always) and (b) the headless responder for the umbrella the cwd resolves to
- * (if any). Each is fire-and-forget at the call site; this helper awaits both
- * and returns their results for logging. Never throws.
- *
- * `cwd` defaults to `CLAUDE_PROJECT_DIR ?? process.cwd()` (matches the MCP
- * server's active-umbrella resolution). `umbrellaForCwd` lets the caller pass
- * the already-resolved umbrella (the MCP boot resolves it once for logging).
- */
-export declare function ensureHeadlessRespondersForBoot(opts: {
-    /** The umbrella the cwd resolves to (null ⇒ only the general responder). */
-    umbrellaForCwd: string | null;
-    /** Working dir for the project/pack resolution. */
-    cwd?: string;
-    /** Test seam — forwarded to each `ensureAgentBridgeRunning`. */
-    deps?: EnsureAgentBridgeDeps;
-    /** Test seam — override the ensure fn itself (asserts call shape). */
-    ensureFn?: typeof ensureAgentBridgeRunning;
-}): Promise<{
-    general: AgentBridgeAutoSpawnResult;
-    umbrella: AgentBridgeAutoSpawnResult | null;
-}>;
-//# sourceMappingURL=autospawn.d.ts.map

package/dist/runtime/agent_bridge/autospawn.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"autospawn.d.ts","sourceRoot":"","sources":["../../../src/runtime/agent_bridge/autospawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAWH,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,CAAC;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEN;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAYD,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAyBD,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAgBD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACjE,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,KAAK;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,kDAAkD;IAClD,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAClG,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,KAAK,MAAM,CAAC;IACxD,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAqCD;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CAmDrC;AAuCD;;;;;;;;;GASG;AACH,wBAAsB,+BAA+B,CAAC,IAAI,EAAE;IAC1D,4EAA4E;IAC5E,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,CAAC,EAAE,qBAAqB,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,OAAO,wBAAwB,CAAC;CAC5C,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,0BAA0B,CAAC;IAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAA;CAAE,CAAC,CAShG"}