opensquid 0.5.395

package/dist/engine/client.d.ts

@@ -0,0 +1,219 @@
+/**
+ * JSON-RPC 2.0 client for the loop-engine daemon.
+ *
+ * Connects to a long-running engine process at
+ * `~/.opensquid/loop-engine.sock` via Unix domain socket. The daemon
+ * is acquired-or-spawned by `acquireOrSpawnEngine()` (singleton.ts),
+ * so multiple `EngineClient` instances across hooks + sessions share
+ * the same underlying engine process — the keystone for cross-session
+ * memory recall.
+ *
+ * Critical invariants (T.1 audit + T.4 spec):
+ *
+ *  1. **Singleton transport** — `EngineClient` no longer owns a
+ *     subprocess. It holds a `net.Socket` connection to a shared
+ *     daemon. Engine lifecycle lives in `singleton.ts`; closing a
+ *     client only closes the connection, not the engine.
+ *
+ *  2. **LOOP_HOME pin** (T.1.D) — handled by `singleton.ts` at spawn
+ *     time. Engine defaults `~/.loop`; opensquid pins to
+ *     `~/.opensquid`. Stripping the pin would make existing memories
+ *     + lessons silently invisible.
+ *
+ *  3. **Auto-reconnect on socket close** — if the daemon restarts
+ *     (kill -9, OOM, manual `engine kill`), the next `call()` will
+ *     re-acquire via the singleton. Pending calls reject so callers
+ *     can retry.
+ *
+ *  4. **Error wire shape** — five engine-custom codes in
+ *     `-32000..=-32004` range. `RpcError` carries `.code` + `.data`
+ *     so callers branch on the structured field, not the message.
+ *
+ *  5. **Authored_by wire encoding** — INPUT accepts `'user' | 'pack'`
+ *     (else maps to engine's `Llm` default); OUTPUT is
+ *     `'user' | 'pack' | 'agent'` (`Llm` renders as `"agent"`).
+ *
+ *  6. **Windows fallback** — UDS is Unix-only. On Windows,
+ *     `acquireOrSpawnEngine()` throws; callers wrap with a feature
+ *     flag (`OPENSQUID_ENGINE_SOCKET=disable`) to fall back to the
+ *     legacy per-process stdio spawn (NOT implemented here yet —
+ *     tracked as T.8 follow-up).
+ *
+ * Types live in `./types.js` — this file owns the transport + class.
+ */
+import type { CompressParams, CompressResult, ConsolidateParams, ConsolidateResult, CreateMemoryResult, GetMemoryResult, LessonCaptureFeedbackResult, LessonCreateParams, LessonCreateResult, LessonDiscardResult, LessonListResult, LessonPromoteResult, LessonRecallResult, LessonSupersedeResult, ManifestAssembleParams, ManifestAssembleResult, MemoryDeleteResult, MemoryListResult, MemoryOrigin, MemoryScope, MemorySearchParams, MemorySearchResult, MemoryUpdateResult, RecomputeCitationsResult, ScopeFilterWire, TaskGetLedgerResult, TaskLogPhaseResult } from './types.js';
+/**
+ * JSON-RPC error response surfaced as a JS Error subclass. `.code` +
+ * `.data` carry the engine-side fields so callers can branch without
+ * pattern-matching `.message`.
+ */
+export declare class RpcError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(message: string, code: number, data?: unknown);
+}
+/**
+ * Engine error codes (verified against engine/src/serve.rs:226-258).
+ *
+ * Standard JSON-RPC range (-32700 / -32600 / -32601 / -32602 / -32603)
+ * is mirrored for completeness. Engine-custom codes occupy
+ * `-32000..=-32004` and carry a structured `data` payload per T.1.E.
+ */
+export declare const ENGINE_ERROR: {
+    readonly PARSE: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL: -32603;
+    /** data: { reasons: string[] } — kebab-case reasons per T.1.E + T.1.F */
+    readonly PROMOTION_BLOCKED: -32000;
+    /** data: { lesson_id: string } */
+    readonly USER_LESSON_IMMUNE: -32001;
+    /** data: { id: string } */
+    readonly NOT_FOUND: -32002;
+    /** data: { memory_id: string, cited_by: number } */
+    readonly USER_MEMORY_IMMUNE: -32003;
+    /** data: { reason: string } */
+    readonly SUPERSEDE_BLOCKED: -32004;
+};
+/**
+ * Socket + JSON-RPC plumbing. One instance ≡ one connection to the
+ * shared engine daemon. Connection is established lazily on first
+ * `call`. Survives daemon restarts: when the socket closes, the next
+ * call re-acquires via `acquireOrSpawnEngine()`.
+ */
+export declare class EngineClient {
+    private socket;
+    private reader;
+    private pending;
+    private nextId;
+    private startupAck;
+    private spawnedByUs;
+    ping(): Promise<{
+        ok: true;
+        version: string;
+    }>;
+    lessonCreate(p: LessonCreateParams): Promise<LessonCreateResult>;
+    lessonRecall(p: {
+        query: string;
+        limit?: number;
+    }): Promise<LessonRecallResult>;
+    lessonPromote(p: {
+        id: string;
+    }): Promise<LessonPromoteResult>;
+    lessonDiscard(p: {
+        id: string;
+        reason?: string;
+        force?: boolean;
+    }): Promise<LessonDiscardResult>;
+    lessonList(p: {
+        statuses?: string[];
+        limit?: number;
+        offset?: number;
+    }): Promise<LessonListResult>;
+    lessonCaptureFeedback(p: {
+        id: string;
+        polarity: 'thumbs_up' | 'thumbs_down';
+        source_signal_id?: string;
+    }): Promise<LessonCaptureFeedbackResult>;
+    lessonSupersede(p: {
+        old_id: string;
+        new_id: string;
+        force?: boolean;
+    }): Promise<LessonSupersedeResult>;
+    memoryCreate(p: {
+        description: string;
+        content: string;
+        authored_by?: string;
+        scope?: MemoryScope;
+        origin?: MemoryOrigin;
+    }): Promise<CreateMemoryResult>;
+    memorySearch(p: MemorySearchParams): Promise<MemorySearchResult>;
+    memoryGet(p: {
+        id: string;
+    }): Promise<GetMemoryResult>;
+    memoryList(p: {
+        scope_filter?: ScopeFilterWire;
+        limit?: number;
+        offset?: number;
+    }): Promise<MemoryListResult>;
+    memoryUpdate(p: {
+        id: string;
+        description?: string;
+        content?: string;
+        scope?: MemoryScope;
+    }): Promise<MemoryUpdateResult>;
+    memoryDelete(p: {
+        id: string;
+        force?: boolean;
+    }): Promise<MemoryDeleteResult>;
+    /**
+     * Compress a window of memories into one gist `Mc` (CMP.1). Pure
+     * exposure of the engine's `compress()` lib fn — mints `Mc` with
+     * `derived_from = ids` + summed citation counters; does NOT delete
+     * predecessors (that is the host's verified, gated terminal step).
+     */
+    memoryCompress(p: CompressParams): Promise<CompressResult>;
+    /**
+     * Atomic safe-compression (CMP.4). The engine compresses the window
+     * into one gist `Mc`, VERIFIES via recall-replay that `Mc` preserves
+     * each predecessor's recall, and ONLY THEN force-deletes the
+     * NON-immune predecessors — user-cited ones are kept. Any error or
+     * verify-miss → deletes NOTHING and returns `verified: false` with
+     * the minted `Mc` id (so the host keeps `Mc` alongside the originals
+     * + surfaces drift).
+     *
+     * The D2 safety contract (verify + immunity + fail-closed) is
+     * GUARANTEED inside the engine (race-free, universal substrate
+     * integrity) — the host no longer runs recall-replay or issues any
+     * `memory.delete` in the compression path.
+     */
+    memoryConsolidate(p: ConsolidateParams): Promise<ConsolidateResult>;
+    /**
+     * Recompute every memory's `consumed_by_user_lessons` counter to
+     * ground truth (CMP.1). A host runs this after a batch of
+     * compressions / deletions to confirm citation integrity survived
+     * the `derived_from` chain.
+     */
+    memoryRecomputeCitations(): Promise<RecomputeCitationsResult>;
+    manifestAssemble(p: ManifestAssembleParams): Promise<ManifestAssembleResult>;
+    taskLogPhase(p: {
+        task_id: string;
+        phase: string;
+        note?: string;
+    }): Promise<TaskLogPhaseResult>;
+    taskGetLedger(p: {
+        task_id: string;
+    }): Promise<TaskGetLedgerResult>;
+    /**
+     * Send a JSON-RPC request, await the response. Throws `RpcError` on
+     * engine-side errors; throws `Error` on socket close mid-call.
+     *
+     * The startup `ping` call passes through without re-entering
+     * `ensureConnected` to break the chicken-and-egg.
+     */
+    call<T = unknown>(method: string, params: unknown): Promise<T>;
+    /**
+     * Close the connection to the engine daemon. Does NOT kill the
+     * daemon — engine lifecycle is owned by `singleton.ts` (and by
+     * T.7's `engine kill` for explicit teardown). After close(), the
+     * next `call()` will re-acquire.
+     */
+    close(): Promise<void>;
+    /**
+     * Returns true if this client's last connection was the one that
+     * spawned the engine daemon. Useful for telemetry — production
+     * callers should not rely on this for correctness.
+     */
+    get didSpawnEngine(): boolean;
+    private ensureConnected;
+    private onLine;
+    /**
+     * Clear connection state on close so the next call re-acquires.
+     * Mirrors the pre-T.4 behavior for subprocess exits — the daemon
+     * may restart out-of-band (kill -9, OOM, T.7 `engine kill`) and
+     * the next call should transparently respawn / reconnect.
+     */
+    private onClose;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/engine/client.d.ts.map

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

package/dist/engine/client.js

@@ -0,0 +1,312 @@
+/**
+ * JSON-RPC 2.0 client for the loop-engine daemon.
+ *
+ * Connects to a long-running engine process at
+ * `~/.opensquid/loop-engine.sock` via Unix domain socket. The daemon
+ * is acquired-or-spawned by `acquireOrSpawnEngine()` (singleton.ts),
+ * so multiple `EngineClient` instances across hooks + sessions share
+ * the same underlying engine process — the keystone for cross-session
+ * memory recall.
+ *
+ * Critical invariants (T.1 audit + T.4 spec):
+ *
+ *  1. **Singleton transport** — `EngineClient` no longer owns a
+ *     subprocess. It holds a `net.Socket` connection to a shared
+ *     daemon. Engine lifecycle lives in `singleton.ts`; closing a
+ *     client only closes the connection, not the engine.
+ *
+ *  2. **LOOP_HOME pin** (T.1.D) — handled by `singleton.ts` at spawn
+ *     time. Engine defaults `~/.loop`; opensquid pins to
+ *     `~/.opensquid`. Stripping the pin would make existing memories
+ *     + lessons silently invisible.
+ *
+ *  3. **Auto-reconnect on socket close** — if the daemon restarts
+ *     (kill -9, OOM, manual `engine kill`), the next `call()` will
+ *     re-acquire via the singleton. Pending calls reject so callers
+ *     can retry.
+ *
+ *  4. **Error wire shape** — five engine-custom codes in
+ *     `-32000..=-32004` range. `RpcError` carries `.code` + `.data`
+ *     so callers branch on the structured field, not the message.
+ *
+ *  5. **Authored_by wire encoding** — INPUT accepts `'user' | 'pack'`
+ *     (else maps to engine's `Llm` default); OUTPUT is
+ *     `'user' | 'pack' | 'agent'` (`Llm` renders as `"agent"`).
+ *
+ *  6. **Windows fallback** — UDS is Unix-only. On Windows,
+ *     `acquireOrSpawnEngine()` throws; callers wrap with a feature
+ *     flag (`OPENSQUID_ENGINE_SOCKET=disable`) to fall back to the
+ *     legacy per-process stdio spawn (NOT implemented here yet —
+ *     tracked as T.8 follow-up).
+ *
+ * Types live in `./types.js` — this file owns the transport + class.
+ */
+import { createInterface } from 'node:readline';
+import { acquireOrSpawnEngine } from './singleton.js';
+/**
+ * JSON-RPC error response surfaced as a JS Error subclass. `.code` +
+ * `.data` carry the engine-side fields so callers can branch without
+ * pattern-matching `.message`.
+ */
+export class RpcError extends Error {
+    code;
+    data;
+    constructor(message, code, data) {
+        super(message);
+        this.name = 'RpcError';
+        this.code = code;
+        this.data = data;
+    }
+}
+/**
+ * Engine error codes (verified against engine/src/serve.rs:226-258).
+ *
+ * Standard JSON-RPC range (-32700 / -32600 / -32601 / -32602 / -32603)
+ * is mirrored for completeness. Engine-custom codes occupy
+ * `-32000..=-32004` and carry a structured `data` payload per T.1.E.
+ */
+export const ENGINE_ERROR = {
+    PARSE: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL: -32603,
+    /** data: { reasons: string[] } — kebab-case reasons per T.1.E + T.1.F */
+    PROMOTION_BLOCKED: -32000,
+    /** data: { lesson_id: string } */
+    USER_LESSON_IMMUNE: -32001,
+    /** data: { id: string } */
+    NOT_FOUND: -32002,
+    /** data: { memory_id: string, cited_by: number } */
+    USER_MEMORY_IMMUNE: -32003,
+    /** data: { reason: string } */
+    SUPERSEDE_BLOCKED: -32004,
+};
+/**
+ * Socket + JSON-RPC plumbing. One instance ≡ one connection to the
+ * shared engine daemon. Connection is established lazily on first
+ * `call`. Survives daemon restarts: when the socket closes, the next
+ * call re-acquires via `acquireOrSpawnEngine()`.
+ */
+export class EngineClient {
+    socket = null;
+    reader = null;
+    pending = new Map();
+    nextId = 1;
+    startupAck = null;
+    spawnedByUs = false;
+    // --- typed wrappers per JSON-RPC method (engine serve.rs:290-310) ---
+    async ping() {
+        return this.call('ping', {});
+    }
+    async lessonCreate(p) {
+        return this.call('lesson.create', p);
+    }
+    async lessonRecall(p) {
+        return this.call('lesson.recall', p);
+    }
+    async lessonPromote(p) {
+        return this.call('lesson.promote', p);
+    }
+    async lessonDiscard(p) {
+        return this.call('lesson.discard', p);
+    }
+    async lessonList(p) {
+        return this.call('lesson.list', p);
+    }
+    async lessonCaptureFeedback(p) {
+        return this.call('lesson.capture_feedback', p);
+    }
+    async lessonSupersede(p) {
+        return this.call('lesson.supersede', p);
+    }
+    async memoryCreate(p) {
+        return this.call('memory.create', p);
+    }
+    async memorySearch(p) {
+        return this.call('memory.search', p);
+    }
+    async memoryGet(p) {
+        return this.call('memory.get', p);
+    }
+    async memoryList(p) {
+        return this.call('memory.list', p);
+    }
+    async memoryUpdate(p) {
+        return this.call('memory.update', p);
+    }
+    async memoryDelete(p) {
+        return this.call('memory.delete', p);
+    }
+    /**
+     * Compress a window of memories into one gist `Mc` (CMP.1). Pure
+     * exposure of the engine's `compress()` lib fn — mints `Mc` with
+     * `derived_from = ids` + summed citation counters; does NOT delete
+     * predecessors (that is the host's verified, gated terminal step).
+     */
+    async memoryCompress(p) {
+        return this.call('memory.compress', p);
+    }
+    /**
+     * Atomic safe-compression (CMP.4). The engine compresses the window
+     * into one gist `Mc`, VERIFIES via recall-replay that `Mc` preserves
+     * each predecessor's recall, and ONLY THEN force-deletes the
+     * NON-immune predecessors — user-cited ones are kept. Any error or
+     * verify-miss → deletes NOTHING and returns `verified: false` with
+     * the minted `Mc` id (so the host keeps `Mc` alongside the originals
+     * + surfaces drift).
+     *
+     * The D2 safety contract (verify + immunity + fail-closed) is
+     * GUARANTEED inside the engine (race-free, universal substrate
+     * integrity) — the host no longer runs recall-replay or issues any
+     * `memory.delete` in the compression path.
+     */
+    async memoryConsolidate(p) {
+        return this.call('memory.consolidate', p);
+    }
+    /**
+     * Recompute every memory's `consumed_by_user_lessons` counter to
+     * ground truth (CMP.1). A host runs this after a batch of
+     * compressions / deletions to confirm citation integrity survived
+     * the `derived_from` chain.
+     */
+    async memoryRecomputeCitations() {
+        return this.call('memory.recompute_citations', {});
+    }
+    async manifestAssemble(p) {
+        return this.call('manifest.assemble', p);
+    }
+    async taskLogPhase(p) {
+        return this.call('task.log_phase', p);
+    }
+    async taskGetLedger(p) {
+        return this.call('task.get_ledger', p);
+    }
+    // --- transport ------------------------------------------------------
+    /**
+     * Send a JSON-RPC request, await the response. Throws `RpcError` on
+     * engine-side errors; throws `Error` on socket close mid-call.
+     *
+     * The startup `ping` call passes through without re-entering
+     * `ensureConnected` to break the chicken-and-egg.
+     */
+    async call(method, params) {
+        if (method !== 'ping' || this.socket === null) {
+            await this.ensureConnected();
+        }
+        const id = this.nextId++;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, {
+                resolve: (v) => resolve(v),
+                reject,
+            });
+            const sock = this.socket;
+            if (!sock) {
+                this.pending.delete(id);
+                reject(new Error('engine connection not established'));
+                return;
+            }
+            const line = JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n';
+            sock.write(line);
+        });
+    }
+    /**
+     * Close the connection to the engine daemon. Does NOT kill the
+     * daemon — engine lifecycle is owned by `singleton.ts` (and by
+     * T.7's `engine kill` for explicit teardown). After close(), the
+     * next `call()` will re-acquire.
+     */
+    async close() {
+        const sock = this.socket;
+        if (!sock)
+            return;
+        return new Promise((resolve) => {
+            // If the socket is already closed, end() is a noop and `close`
+            // fires synchronously on the next tick.
+            sock.once('close', () => resolve());
+            sock.end();
+        });
+    }
+    /**
+     * Returns true if this client's last connection was the one that
+     * spawned the engine daemon. Useful for telemetry — production
+     * callers should not rely on this for correctness.
+     */
+    get didSpawnEngine() {
+        return this.spawnedByUs;
+    }
+    // --- internals ------------------------------------------------------
+    async ensureConnected() {
+        if (this.socket)
+            return;
+        if (this.startupAck)
+            return this.startupAck;
+        // Acquire or spawn. Singleton handles the lock, recheck, spawn,
+        // pidfile, and socket-wait — this module just consumes the result.
+        const { socket, spawnedByUs } = await acquireOrSpawnEngine();
+        this.socket = socket;
+        this.spawnedByUs = spawnedByUs;
+        // Line-framed JSON-RPC over the socket. `createInterface` strips
+        // '\n' and emits per-line events. Same plumbing as the legacy
+        // stdio path — only the underlying stream changed.
+        this.reader = createInterface({ input: socket });
+        this.reader.on('line', (line) => {
+            this.onLine(line);
+        });
+        socket.on('close', () => this.onClose('socket closed'));
+        socket.on('error', (err) => {
+            process.stderr.write(`[opensquid] engine socket error: ${err.message}\n`);
+        });
+        // Confirm liveness before returning. A successful ping proves the
+        // daemon is past rehydrate + ready to dispatch.
+        this.startupAck = this.call('ping', {})
+            .then(() => undefined)
+            .catch((e) => {
+            throw new Error(`engine handshake failed: ${e.message}`);
+        });
+        return this.startupAck;
+    }
+    onLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(trimmed);
+        }
+        catch (e) {
+            process.stderr.write(`[opensquid] failed to parse engine line: ${String(e)}\n`);
+            return;
+        }
+        const pending = this.pending.get(msg.id);
+        if (!pending) {
+            process.stderr.write(`[opensquid] response for unknown id=${String(msg.id)}\n`);
+            return;
+        }
+        this.pending.delete(msg.id);
+        if (msg.error) {
+            pending.reject(new RpcError(msg.error.message, msg.error.code, msg.error.data));
+        }
+        else {
+            pending.resolve(msg.result);
+        }
+    }
+    /**
+     * Clear connection state on close so the next call re-acquires.
+     * Mirrors the pre-T.4 behavior for subprocess exits — the daemon
+     * may restart out-of-band (kill -9, OOM, T.7 `engine kill`) and
+     * the next call should transparently respawn / reconnect.
+     */
+    onClose(reason) {
+        process.stderr.write(`[opensquid] engine connection closed: ${reason}\n`);
+        this.socket = null;
+        this.reader = null;
+        this.startupAck = null;
+        this.spawnedByUs = false;
+        for (const [, pending] of this.pending) {
+            pending.reject(new Error(`loop-engine connection lost: ${reason}`));
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/engine/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/engine/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,eAAe,EAAkB,MAAM,eAAe,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AA+BtD;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,IAAI,CAAS;IACb,IAAI,CAAW;IAC/B,YAAY,OAAe,EAAE,IAAY,EAAE,IAAc;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,CAAC,KAAK;IACb,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,QAAQ,EAAE,CAAC,KAAK;IAChB,yEAAyE;IACzE,iBAAiB,EAAE,CAAC,KAAK;IACzB,kCAAkC;IAClC,kBAAkB,EAAE,CAAC,KAAK;IAC1B,2BAA2B;IAC3B,SAAS,EAAE,CAAC,KAAK;IACjB,oDAAoD;IACpD,kBAAkB,EAAE,CAAC,KAAK;IAC1B,+BAA+B;IAC/B,iBAAiB,EAAE,CAAC,KAAK;CACjB,CAAC;AAcX;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,GAAkB,IAAI,CAAC;IAC7B,MAAM,GAAqB,IAAI,CAAC;IAChC,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,MAAM,GAAG,CAAC,CAAC;IACX,UAAU,GAAyB,IAAI,CAAC;IACxC,WAAW,GAAG,KAAK,CAAC;IAE5B,uEAAuE;IAEvE,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAAqB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAAoC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,CAAiB;QACnC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,CAInB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAIhB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,CAI3B;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,CAIrB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAMlB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAAqB;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,CAAiB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,CAIhB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAKlB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAAkC;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAAC,CAAiB;QACpC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,iBAAiB,CAAC,CAAoB;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,wBAAwB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,CAAyB;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,CAIlB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,CAAsB;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,uEAAuE;IAEvE;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAc,MAAc,EAAE,MAAe;QACrD,IAAI,MAAM,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAM,CAAC;gBAC/B,MAAM;aACP,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;YAC3E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,+DAA+D;YAC/D,wCAAwC;YACxC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,uEAAuE;IAE/D,KAAK,CAAC,eAAe;QAC3B,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QAE5C,gEAAgE;QAChE,mEAAmE;QACnE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,iEAAiE;QACjE,8DAA8D;QAC9D,mDAAmD;QACnD,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAU,EAAE,EAAE;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QAEH,kEAAkE;QAClE,gDAAgD;QAChD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;aACpC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aACrB,KAAK,CAAC,CAAC,CAAQ,EAAE,EAAE;YAClB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QACL,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,GAAoB,CAAC;QACzB,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAoB,CAAC;QAC/C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5B,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,OAAO,CAAC,MAAc;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,MAAM,IAAI,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/engine/config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Engine binary discovery + persisted-path management.
+ *
+ * Resolution chain (per T.1 audit §J + src.legacy precedent):
+ *   1. `OPENSQUID_ENGINE_BIN` env var — explicit override, always wins
+ *   2. `~/.opensquid/engine-config.json` `engine_bin` field — persisted choice
+ *   3. Bundled npm optional dep (`opensquid-engine-<platform>-<arch>`)
+ *      — returns `null` until npm stubs ship (follow-up track)
+ *   4. Auto-search dev paths under `~/projects/*` and `~/work/*`
+ *   5. `loop-engine` on `$PATH`
+ *   6. `null` — caller surfaces a helpful error
+ *
+ * First successful resolution from (4) or (5) is persisted to
+ * `~/.opensquid/engine-config.json` so the next session skips the search.
+ * Bundled-binary hits (3) are NOT persisted because the path is
+ * deterministic from the npm install layout and persisting it would
+ * point at a stale `node_modules/` path after upgrades.
+ *
+ * The persisted file is engine-specific so it doesn't collide with the
+ * existing `~/.opensquid/config.json` written by the chat-daemon stack.
+ *
+ * Imports `OPENSQUID_HOME` from `runtime/paths.ts` so the data root
+ * honors the `OPENSQUID_HOME` env override (tests + relocatable installs).
+ */
+export interface EngineConfig {
+    version: 1;
+    /** Last-known path to the loop-engine binary. */
+    engine_bin?: string;
+    /** ISO timestamp the engine_bin was last resolved via search. */
+    engine_bin_resolved_at?: string;
+}
+export declare function loadEngineConfig(): Promise<EngineConfig>;
+export declare function saveEngineConfig(config: EngineConfig): Promise<void>;
+/**
+ * Resolve the engine binary path using the priority chain above. Writes
+ * the resolved path back to config when discovered via search so the
+ * next session is instant. Returns `null` if no working binary could be
+ * located.
+ *
+ * **Re-resolution on every start** (T.7 / T.1.P): a persisted
+ * `engine_bin` that no longer points at an executable file is cleared
+ * from the config and the resolver falls through to bundled → dev →
+ * `$PATH`. This adds ~10-100ms (one extra `fs.stat`) but means a
+ * deleted / moved / freshly-rebuilt binary silently self-heals on the
+ * next start instead of failing loudly with `ENOENT`. Bundled hits
+ * are NOT persisted (deterministic from npm layout); dev-path + `$PATH`
+ * hits ARE persisted so subsequent sessions skip the search.
+ */
+export declare function resolveEngineBin(): Promise<string | null>;
+/**
+ * Set the engine binary path explicitly and persist. Validates that the
+ * path points at an executable file before writing.
+ */
+export declare function setEngineBin(binPath: string): Promise<{
+    resolved: string;
+}>;
+/**
+ * Forget the persisted engine binary path. Forces re-discovery on the
+ * next `resolveEngineBin` call.
+ */
+export declare function forgetEngineBin(): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/engine/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/engine/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAaH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAQD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAoC9D;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2C/D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAUjF;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrD"}