opensquid 0.5.441 → 0.5.449

package/dist/engine/types.d.ts

@@ -1,402 +0,0 @@
-/**
- * Wire-shape types for loop-engine JSON-RPC.
- *
- * Mirrors the shapes defined in engine/src/serve.rs at HEAD (engine v0.5.4).
- * Drift-corrected per T.1 audit findings (B, D, E, G):
- *   - LessonCreateParams gets v1.1 (`pack_id`, `seed_as_promoted`) +
- *     v1.2 (`external_id`) fields.
- *   - LessonCreateResult.authored_by output is `'user' | 'pack' | 'agent'`
- *     (not `'llm'` — engine renders Llm as `"agent"` on the wire per
- *     `authorship_str()` in serve.rs:830-836).
- *   - MemorySearchParams includes `mode: 'semantic' | 'text' | 'hybrid'`
- *     (engine does server-side RRF fusion in `'hybrid'` mode).
- *   - MemorySearchHit field is `similarity` (NOT `score`); `source` is
- *     optional and present only on hybrid results.
- *   - ManifestAssembleParams defaults `statuses` to `["active"]` which is
- *     unreachable via the public API per T.1.HH — opensquid MUST always
- *     pass an explicit `statuses: ["promoted"]` or `["pending","promoted"]`.
- *
- * No runtime code lives here — pure type module.
- */
-/** MemoryScope wire shape (engine `MemoryScope` serde). */
-export type MemoryScope = 'user' | 'global' | {
-    team: string;
-} | {
-    skill: string;
-} | {
-    project: string;
-};
-/** Scope filter for memory search/list (engine `ScopeFilterWire` serde). */
-export type ScopeFilterWire = {
-    kind: 'exact';
-    scope: MemoryScope;
-} | {
-    kind: 'kind';
-    kind_name: 'user' | 'team' | 'skill' | 'project' | 'global';
-} | {
-    kind: 'any_of';
-    scopes: MemoryScope[];
-};
-/**
- * Memory provenance block. All fields optional; engine YAML omits absent
- * fields via `skip_serializing_if`, so partial blocks round-trip cleanly.
- *
- * Privacy: `session_id` is opaque (hashed first 8 chars); `cwd_basename`
- * is the last path segment only.
- */
-export interface MemoryOrigin {
-    host?: string;
-    session_id?: string;
-    model?: string;
-    cwd_basename?: string;
-    written_at?: string;
-}
-/**
- * Engine `LessonCreateParams` per serve.rs:317-344 (v1.1 + v1.2 surface).
- *
- * Validation rules enforced server-side:
- *  - `authored_by === 'pack'` AND missing/empty `pack_id` → -32602
- *  - `seed_as_promoted: true` AND `authored_by !== 'pack'` → -32602
- *
- * Wire INPUT: anything other than `'user' | 'pack'` for `authored_by`
- * silently maps to `Llm` (engine default).
- */
-export interface LessonCreateParams {
-    description: string;
-    body: string;
-    evidence?: string[];
-    authored_by?: 'user' | 'pack';
-    /** Required when `authored_by === 'pack'`. */
-    pack_id?: string;
-    /** v1.2 UPSERT lookup key; pack-authored only. */
-    external_id?: string;
-    /** v1.1 gate bypass; pack-authored only. */
-    seed_as_promoted?: boolean;
-}
-/**
- * Engine `LessonCreateResult` per serve.rs:458-473.
- * Wire OUTPUT: `Llm → "agent"` (NOT `"llm"`).
- */
-export interface LessonCreateResult {
-    id: string;
-    status: 'pending' | 'promoted';
-    authored_by: 'user' | 'pack' | 'agent';
-    pack_id?: string;
-    external_id?: string;
-    created_at: string;
-    /** v1.2: true on UPSERT hit (existing row reused). */
-    updated: boolean;
-}
-export interface LessonRecallHit {
-    kind: 'lesson';
-    id: string;
-    description: string;
-    status: string;
-    body_preview: string;
-    similarity: number;
-    applied_count: number;
-}
-export interface LessonRecallResult {
-    query: string;
-    returned: number;
-    results: LessonRecallHit[];
-}
-export interface LessonListRow {
-    id: string;
-    description: string;
-    status: string;
-    authored_by: string;
-    pack_id: string | null;
-    external_id: string | null;
-    applied_count: number;
-    thumbs_up_count: number;
-    thumbs_down_count: number;
-    created_at: string;
-    updated_at: string | null;
-}
-export interface LessonListResult {
-    total: number;
-    limit: number;
-    offset: number;
-    returned: number;
-    results: LessonListRow[];
-}
-/**
- * Engine `MemorySearchParams` per serve.rs:935-967.
- *
- * `mode: 'hybrid'` is the load-bearing v0.5 addition — engine fuses
- * semantic + text via Cormack et al. 2009 RRF (k=60) SERVER-SIDE,
- * eliminating the need for a TS-side lexical leg (T.1.B + T.1.JJ).
- */
-export interface MemorySearchParams {
-    query: string;
-    limit?: number;
-    include_body?: boolean;
-    scope_filter?: ScopeFilterWire;
-    mode?: 'semantic' | 'text' | 'hybrid';
-    /** Clamped to [0, 1] server-side. Applied to RAW scores BEFORE RRF merge. */
-    min_similarity?: number;
-}
-export interface MemorySearchHit {
-    kind: 'memory';
-    id: string;
-    description: string;
-    /** 240-char preview by default; FULL body when `include_body: true`. */
-    body_preview: string;
-    /** Rounded to 3 decimals. Engine field is `similarity` — NOT `score`. */
-    similarity: number;
-    /** Present only in hybrid mode. */
-    source?: 'semantic' | 'text' | 'both';
-}
-export interface MemorySearchResult {
-    query: string;
-    returned: number;
-    results: MemorySearchHit[];
-}
-/**
- * Engine `ManifestAssembleParams` per serve.rs:1363-1390.
- *
- * `statuses` default is `["active"]` — UNREACHABLE via public lesson API
- * (T.1.HH). Always pass `["promoted"]` or `["pending","promoted"]`.
- *
- * `record_applied` default is `true` — SIDE EFFECT: bumps `applied_count`
- * + `last_applied_at` per surfaced lesson. This is the path lessons
- * accumulate toward gate's `min_applied_count >= 3`. Pass `false` for
- * read-only callers.
- */
-export interface ManifestAssembleParams {
-    statuses?: ('pending' | 'active' | 'promoted' | 'superseded' | 'discarded')[];
-    lesson_limit?: number;
-    body_preview_len?: number;
-    annotate_with_gate?: boolean;
-    record_applied?: boolean;
-    memory_query?: string;
-    memory_limit?: number;
-    memory_scope_filter?: ScopeFilterWire;
-}
-export interface ManifestActiveLesson {
-    id: string;
-    description: string;
-    status: string;
-    body_preview: string;
-    applied_count: number;
-    last_applied_at: string | null;
-    target_skill: string | null;
-    gate?: {
-        kind: 'promote' | 'block';
-        reason_count: number;
-    };
-}
-export interface ManifestMemory {
-    id: string;
-    description: string;
-    body_preview: string;
-    similarity: number;
-}
-export interface ManifestAssembleResult {
-    active_lessons: ManifestActiveLesson[];
-    memories: ManifestMemory[];
-    /** v1.4 returns empty arrays — deferred to a later engine release. */
-    active_skills: unknown[];
-    active_personas: unknown[];
-    active_teams: unknown[];
-    assembly_stats: {
-        assembled_at: string;
-        total_listed: number;
-        skipped_count: number;
-        gate_skip_count: number;
-        record_applied_failures: number;
-        memories_returned: number | null;
-        memory_search_failures: number;
-        session_section_skips: number;
-    };
-}
-export interface CreateMemoryResult {
-    id: string;
-    description: string;
-    created_at: string;
-    scope: MemoryScope;
-    origin?: MemoryOrigin | null;
-}
-export interface GetMemoryResult {
-    id: string;
-    description: string;
-    /** FULL body, no truncation. */
-    content: string;
-    created_at: string;
-    scope: MemoryScope;
-    origin?: MemoryOrigin | null;
-    /**
-     * Reverse-citation count enforcing user-immunity (T.1.E -32003).
-     * A host MUST check this is `0` before force-deleting (force bypasses
-     * the engine guard). Added to `memory.get` for CMP.4's per-predecessor
-     * immunity gate.
-     */
-    consumed_by_user_lessons: number;
-    /** Predecessor ids when this is a compressed memory; `[]` for raw. */
-    derived_from: string[];
-}
-export interface MemoryListRow {
-    id: string;
-    description: string;
-    scope: MemoryScope;
-    origin: MemoryOrigin | null;
-    created_at: string;
-    updated_at: string | null;
-    /** Reverse-citation count enforcing user-immunity (T.1.E -32003). */
-    consumed_by_user_lessons: number;
-}
-export interface MemoryListResult {
-    total: number;
-    limit: number;
-    offset: number;
-    returned: number;
-    results: MemoryListRow[];
-}
-export interface TaskLogPhaseResult {
-    ok: true;
-    task_id: string;
-    phase: string;
-    newly_recorded: boolean;
-}
-export interface TaskGetLedgerResult {
-    task_id: string;
-    phases_logged: string[];
-    entries: {
-        phase: string;
-        logged_at: string;
-        note: string | null;
-    }[];
-}
-export interface LessonPromoteResult {
-    ok: true;
-    id: string;
-    gate: 'passed';
-    status: 'promoted';
-    from: string;
-    /**
-     * Cited MEMORY ids from the promoted lesson's causal narrative (the
-     * `EvidenceRef::Memory` evidence refs; quote refs excluded). The
-     * compression-candidate collector (CMP.3) nominates these as
-     * compression candidates. May be `[]` (a lesson with no memory
-     * citations). Added in engine commit "lesson.promote returns
-     * cited_memory_ids".
-     */
-    cited_memory_ids?: string[];
-}
-export interface LessonDiscardResult {
-    ok: true;
-    id: string;
-    status: 'discarded';
-    from: string;
-    reason?: string;
-}
-export interface LessonCaptureFeedbackResult {
-    ok: true;
-    id: string;
-    status: string;
-    thumbs_up_count: number;
-    thumbs_down_count: number;
-    external_signal_sources: string[];
-}
-export interface LessonSupersedeResult {
-    ok: true;
-    old_id: string;
-    new_id: string;
-    old_status: string;
-}
-export interface MemoryUpdateResult {
-    ok: true;
-    id: string;
-    description: string;
-    created_at: string;
-    updated_at: string;
-    scope: MemoryScope;
-    origin?: MemoryOrigin | null;
-}
-export interface MemoryDeleteResult {
-    ok: true;
-    id: string;
-    forced: boolean;
-}
-/**
- * Engine `memory.compress` params per serve.rs `MemoryCompressParams`.
- *
- * `ids` is the explicit compression window — the host (which owns the
- * satisfaction probe + candidate collection) decides what to compress;
- * the engine never auto-selects. `max_tokens` / `temperature` default
- * to the engine's `CompressionConfig::default` when omitted.
- */
-export interface CompressParams {
-    ids: string[];
-    max_tokens?: number;
-    temperature?: number;
-}
-/**
- * Engine `memory.compress` result — the new compressed memory `Mc`.
- *
- * `derived_from` carries the predecessor ids (the trace the engine
- * chases via `get_by_id_chasing_derived_from` so recall still surfaces
- * `Mc` after predecessors are deleted). `consumed_by_user_lessons` is
- * the SUM across predecessors — `> 0` means the gist inherited a
- * user-lesson citation and the predecessors are user-immune.
- */
-export interface CompressResult {
-    id: string;
-    description: string;
-    derived_from: string[];
-    consumed_by_user_lessons: number;
-}
-/**
- * Engine `memory.recompute_citations` result — drift stats from a
- * citation-counter recompute sweep. `counters_repaired > 0` means the
- * live state had drifted from ground truth; `orphan_citations > 0`
- * means a cited memory + its forward `derived_from` successors are all
- * gone (audit-trail integrity compromised — the host should investigate).
- */
-export interface RecomputeCitationsResult {
-    lessons_scanned: number;
-    memories_recomputed: number;
-    counters_repaired: number;
-    orphan_citations: number;
-}
-/**
- * Engine `memory.consolidate` params per serve.rs
- * `MemoryConsolidateParams`.
- *
- * `ids` is the explicit window (the host decides what to consolidate).
- * `recall_k` is the recall-replay top-k the engine uses to VERIFY that
- * the minted `Mc` preserves each predecessor's recall before any
- * deletion; defaults to the engine's `DEFAULT_CONSOLIDATE_RECALL_K`.
- * `max_tokens` / `temperature` tune the internal compression step.
- */
-export interface ConsolidateParams {
-    ids: string[];
-    max_tokens?: number;
-    temperature?: number;
-    recall_k?: number;
-}
-/**
- * Engine `memory.consolidate` result — the atomic verify+gated-delete
- * outcome. The engine GUARANTEES the D2 safety contract (verify +
- * immunity + fail-closed) internally; this is the report.
- *
- * - `mc_id`: the minted compressed memory. `null` only if compression
- *   itself failed (no `Mc` exists). Present even when `verified` is
- *   `false` — `Mc` then sits alongside the (undeleted) predecessors.
- * - `deleted`: predecessor ids force-deleted. Non-empty ONLY when
- *   `verified === true` (and excludes any user-cited predecessor).
- * - `kept_immune`: predecessors KEPT because they are user-cited
- *   (`consumed_by_user_lessons > 0`); the `derived_from` chain still
- *   links them to `Mc`.
- * - `verified`: the recall-replay gate passed for ALL predecessors AND
- *   compression succeeded. `false` ⇒ fail-closed (nothing deleted); the
- *   host surfaces a drift event.
- */
-export interface ConsolidateResult {
-    mc_id: string | null;
-    deleted: string[];
-    kept_immune: string[];
-    verified: boolean;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/engine/types.js

@@ -1,22 +0,0 @@
-/**
- * Wire-shape types for loop-engine JSON-RPC.
- *
- * Mirrors the shapes defined in engine/src/serve.rs at HEAD (engine v0.5.4).
- * Drift-corrected per T.1 audit findings (B, D, E, G):
- *   - LessonCreateParams gets v1.1 (`pack_id`, `seed_as_promoted`) +
- *     v1.2 (`external_id`) fields.
- *   - LessonCreateResult.authored_by output is `'user' | 'pack' | 'agent'`
- *     (not `'llm'` — engine renders Llm as `"agent"` on the wire per
- *     `authorship_str()` in serve.rs:830-836).
- *   - MemorySearchParams includes `mode: 'semantic' | 'text' | 'hybrid'`
- *     (engine does server-side RRF fusion in `'hybrid'` mode).
- *   - MemorySearchHit field is `similarity` (NOT `score`); `source` is
- *     optional and present only on hybrid results.
- *   - ManifestAssembleParams defaults `statuses` to `["active"]` which is
- *     unreachable via the public API per T.1.HH — opensquid MUST always
- *     pass an explicit `statuses: ["promoted"]` or `["pending","promoted"]`.
- *
- * No runtime code lives here — pure type module.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/engine-binary-resolver.js

@@ -1,110 +0,0 @@
-/**
- * Bundled-binary resolver for the loop-engine subprocess (v0.6c).
- *
- * Pattern: esbuild / biomejs / swc — main opensquid package declares 6
- * platform-specific packages as `optionalDependencies`; each one ships
- * a single binary at `bin/loop-engine` (or `.exe` on Windows). npm's
- * `os`/`cpu` fields cause the wrong-platform packages to skip install,
- * so on any given host exactly one optional dep is present and provides
- * the right binary.
- *
- * Runtime path:
- *   1. Map `(process.platform, process.arch)` → optional-dep name.
- *   2. Try `createRequire(import.meta.url).resolve(...)` on that
- *      package's `bin/loop-engine`. Returns absolute path if installed.
- *   3. If not installed (npm `--no-optional`, wrong-platform install,
- *      local pre-publish dev), return `null`. Caller falls back to the
- *      pre-existing discovery chain in `config.ts`.
- *
- * Why a separate module: the resolver is pure (no fs writes, no async),
- * and isolating it makes it trivially unit-testable + future
- * postinstall-script-friendly. Keeps `config.ts` focused on the legacy
- * env/config/path chain.
- */
-import { createRequire } from "node:module";
-import * as path from "node:path";
-/**
- * Supported targets and their optional-dep package names. Stays in sync
- * with `optionalDependencies` in the main package.json and with the
- * matrix in `loop-engine/.github/workflows/release.yml`. If you change
- * any of those, change all three.
- */
-const PACKAGE_FOR_PLATFORM = {
-    "darwin-x64": "opensquid-engine-darwin-x64",
-    "darwin-arm64": "opensquid-engine-darwin-arm64",
-    "linux-x64": "opensquid-engine-linux-x64",
-    "linux-arm64": "opensquid-engine-linux-arm64",
-    "win32-x64": "opensquid-engine-win32-x64",
-    "win32-arm64": "opensquid-engine-win32-arm64",
-};
-const BIN_NAME_FOR_PLATFORM = {
-    "darwin-x64": "loop-engine",
-    "darwin-arm64": "loop-engine",
-    "linux-x64": "loop-engine",
-    "linux-arm64": "loop-engine",
-    "win32-x64": "loop-engine.exe",
-    "win32-arm64": "loop-engine.exe",
-};
-/**
- * Compute the (platform, arch) tuple for the current process. Wrapped
- * for unit testability — tests inject a synthetic probe.
- */
-export function currentPlatform() {
-    return { platform: process.platform, arch: process.arch };
-}
-/**
- * Look up the optional-dep package name for a given platform. Returns
- * `null` when the (platform, arch) pair isn't in the supported matrix.
- */
-export function packageForPlatform(probe) {
-    const key = `${probe.platform}-${probe.arch}`;
-    return PACKAGE_FOR_PLATFORM[key] ?? null;
-}
-/**
- * Look up the binary filename for a given platform (`.exe` on Windows).
- */
-export function binaryNameForPlatform(probe) {
-    const key = `${probe.platform}-${probe.arch}`;
-    return BIN_NAME_FOR_PLATFORM[key] ?? null;
-}
-/**
- * Resolve the bundled binary path via the optional-dep mechanism.
- *
- * Returns `null` when:
- *   - the current (platform, arch) isn't in the supported matrix,
- *   - the optional dep isn't installed (pre-publish dev, npm
- *     `--no-optional`, wrong-platform install), or
- *   - the dep is installed but the expected `bin/<name>` file is missing
- *     (broken publish — diagnostic-only; caller falls through).
- *
- * Resolution is synchronous + side-effect-free. Safe to call before any
- * async work in the spawn path.
- */
-export function resolveBundledEngineBin(probe = currentPlatform()) {
-    const pkg = packageForPlatform(probe);
-    const binName = binaryNameForPlatform(probe);
-    if (!pkg || !binName)
-        return null;
-    // createRequire(import.meta.url) gives us a node-resolution function
-    // anchored at this file's location — which is what we want since the
-    // optional deps are installed alongside the main package's node_modules.
-    const req = createRequire(import.meta.url);
-    try {
-        // We resolve the package's package.json (always present) and append
-        // the binary path. Resolving `${pkg}/bin/<name>` directly would
-        // require the binary to be listed in `exports` or `bin`, which we
-        // intentionally don't do (the binary is opaque to node's loader).
-        const pkgJson = req.resolve(`${pkg}/package.json`);
-        // pkgJson = /absolute/path/to/node_modules/<pkg>/package.json
-        // binary  = /absolute/path/to/node_modules/<pkg>/bin/<name>
-        // v0.6c audit fix (H1): use path.join not string slice. On Windows
-        // require.resolve returns `\` separators; slicing on "/package.json".length
-        // would silently mis-strip the suffix and concatenating with "/bin/..."
-        // would mix separators. path.dirname + path.join is the portable primitive.
-        return path.join(path.dirname(pkgJson), "bin", binName);
-    }
-    catch {
-        // MODULE_NOT_FOUND — optional dep wasn't installed for this host.
-        return null;
-    }
-}

package/dist/engine-binary-resolver.test.js

@@ -1,61 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { binaryNameForPlatform, currentPlatform, packageForPlatform, resolveBundledEngineBin, } from "./engine-binary-resolver.js";
-describe("packageForPlatform", () => {
-    it("maps darwin-arm64 → opensquid-engine-darwin-arm64", () => {
-        expect(packageForPlatform({ platform: "darwin", arch: "arm64" })).toBe("opensquid-engine-darwin-arm64");
-    });
-    it("maps darwin-x64 → opensquid-engine-darwin-x64", () => {
-        expect(packageForPlatform({ platform: "darwin", arch: "x64" })).toBe("opensquid-engine-darwin-x64");
-    });
-    it("maps linux-x64 → opensquid-engine-linux-x64", () => {
-        expect(packageForPlatform({ platform: "linux", arch: "x64" })).toBe("opensquid-engine-linux-x64");
-    });
-    it("maps linux-arm64 → opensquid-engine-linux-arm64", () => {
-        expect(packageForPlatform({ platform: "linux", arch: "arm64" })).toBe("opensquid-engine-linux-arm64");
-    });
-    it("maps win32-x64 → opensquid-engine-win32-x64", () => {
-        expect(packageForPlatform({ platform: "win32", arch: "x64" })).toBe("opensquid-engine-win32-x64");
-    });
-    it("maps win32-arm64 → opensquid-engine-win32-arm64", () => {
-        expect(packageForPlatform({ platform: "win32", arch: "arm64" })).toBe("opensquid-engine-win32-arm64");
-    });
-    it("returns null for unsupported platform (freebsd)", () => {
-        expect(packageForPlatform({ platform: "freebsd", arch: "x64" })).toBeNull();
-    });
-    it("returns null for unsupported arch (ppc64)", () => {
-        expect(packageForPlatform({ platform: "linux", arch: "ppc64" })).toBeNull();
-    });
-});
-describe("binaryNameForPlatform", () => {
-    it("returns loop-engine on unix", () => {
-        expect(binaryNameForPlatform({ platform: "darwin", arch: "arm64" })).toBe("loop-engine");
-        expect(binaryNameForPlatform({ platform: "linux", arch: "x64" })).toBe("loop-engine");
-    });
-    it("returns loop-engine.exe on windows", () => {
-        expect(binaryNameForPlatform({ platform: "win32", arch: "x64" })).toBe("loop-engine.exe");
-        expect(binaryNameForPlatform({ platform: "win32", arch: "arm64" })).toBe("loop-engine.exe");
-    });
-    it("returns null for unsupported platform", () => {
-        expect(binaryNameForPlatform({ platform: "aix", arch: "x64" })).toBeNull();
-    });
-});
-describe("currentPlatform", () => {
-    it("returns the live process platform + arch", () => {
-        const probe = currentPlatform();
-        expect(probe.platform).toBe(process.platform);
-        expect(probe.arch).toBe(process.arch);
-    });
-});
-describe("resolveBundledEngineBin", () => {
-    it("returns null for unsupported platform (no map entry → no resolve attempt)", () => {
-        expect(resolveBundledEngineBin({ platform: "haiku", arch: "x64" })).toBeNull();
-    });
-    it("returns null when the optional dep isn't installed for the current platform", () => {
-        // Pre-publish: none of the opensquid-engine-* packages exist in
-        // node_modules. The resolver must not throw — it must return null
-        // so callers fall through to the legacy discovery chain. After
-        // publish, this assertion would flip; the test stays correct as a
-        // pre-publish guarantee.
-        expect(resolveBundledEngineBin()).toBeNull();
-    });
-});

package/dist/engine-cli.js

@@ -1,60 +0,0 @@
-/**
- * `opensquid engine <subcommand>` — engine binary management.
- *
- * Subcommands:
- *   doctor             — show the resolved engine binary + how it was
- *                        discovered (env / config / search / PATH)
- *   set-path <path>    — persist an explicit engine binary path in
- *                        ~/.opensquid/config.json
- *   forget             — clear the persisted path; force re-discovery
- *                        on next start
- */
-import { forgetEngineBin, loadConfig, resolveEngineBin, setEngineBin } from "./config.js";
-export class EngineCliError extends Error {
-    hint;
-    constructor(message, hint) {
-        super(message);
-        this.hint = hint;
-        this.name = "EngineCliError";
-    }
-}
-async function cmdDoctor() {
-    console.log(`[opensquid engine doctor]`);
-    const env = process.env.OPENSQUID_ENGINE_BIN?.trim();
-    console.log(`  env OPENSQUID_ENGINE_BIN: ${env ?? "(unset)"}`);
-    const config = await loadConfig();
-    console.log(`  config.engine_bin:        ${config.engine_bin ?? "(unset)"}`);
-    if (config.engine_bin_resolved_at) {
-        console.log(`  resolved at:              ${config.engine_bin_resolved_at}`);
-    }
-    const resolved = await resolveEngineBin();
-    console.log(`  resolved binary:          ${resolved ?? "(none — not found)"}`);
-    if (!resolved) {
-        console.log(`  hint: run \`opensquid engine set-path <path>\` to fix.`);
-    }
-}
-async function cmdSetPath(args) {
-    const target = args[0];
-    if (!target) {
-        throw new EngineCliError("usage: opensquid engine set-path <path>", "pass the path to a loop-engine release binary");
-    }
-    const res = await setEngineBin(target);
-    console.log(`[opensquid engine set-path] persisted: ${res.resolved}`);
-}
-async function cmdForget() {
-    await forgetEngineBin();
-    console.log(`[opensquid engine forget] cleared persisted engine_bin`);
-}
-export async function runEngineCli(cmd, argv) {
-    switch (cmd) {
-        case "doctor":
-            await cmdDoctor();
-            return;
-        case "set-path":
-            await cmdSetPath(argv);
-            return;
-        case "forget":
-            await cmdForget();
-            return;
-    }
-}