@nguyenthdat/opencode-memory 0.2.0

package/dist/shared-markdown.d.ts

@@ -0,0 +1,11 @@
+import type { MemoryRecord, SharedMemoryRecord } from "./contracts.js";
+export declare const SHARED_MEMORY_RELATIVE_DIR = ".opencode/memory";
+export declare function loadSharedMemories(worktree: string): Promise<{
+    records: SharedMemoryRecord[];
+    signature: string;
+}>;
+export declare function parseSharedMemory(source: string, input: string): SharedMemoryRecord;
+export declare function writeSharedMemory(worktree: string, memory: MemoryRecord): Promise<string>;
+export declare function ensureRealDirectory(path: string): Promise<void>;
+export declare function isPathWithin(root: string, candidate: string): boolean;
+//# sourceMappingURL=shared-markdown.d.ts.map

package/dist/shared-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-markdown.d.ts","sourceRoot":"","sources":["../opencode-memory/src/shared-markdown.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGvE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAI7D,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAiD/D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAiDnF;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAsC/F;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUrE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGrE"}

package/dist/shared-markdown.js

@@ -0,0 +1,178 @@
+import { createHash } from "node:crypto";
+import { lstat, readFile, readdir, realpath, rename, stat, writeFile, mkdir, } from "node:fs/promises";
+import { isAbsolute, relative, resolve } from "node:path";
+import YAML from "yaml";
+import { MEMORY_KINDS } from "./contracts.js";
+export const SHARED_MEMORY_RELATIVE_DIR = ".opencode/memory";
+const MAX_SHARED_FILES = 200;
+const MAX_SHARED_FILE_BYTES = 64 * 1_024;
+export async function loadSharedMemories(worktree) {
+    const directory = resolve(worktree, SHARED_MEMORY_RELATIVE_DIR);
+    const canonicalRoot = await realpath(worktree);
+    let entries;
+    try {
+        const directoryInfo = await lstat(directory);
+        if (directoryInfo.isSymbolicLink() || !directoryInfo.isDirectory()) {
+            throw new Error("Shared memory directory must be a real directory, not a symlink");
+        }
+        const canonicalDirectory = await realpath(directory);
+        if (!isPathWithin(canonicalRoot, canonicalDirectory)) {
+            throw new Error("Shared memory directory escaped the project worktree");
+        }
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return { records: [], signature: createHash("sha256").digest("hex") };
+        }
+        throw error;
+    }
+    const names = entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+        .map((entry) => entry.name)
+        .sort();
+    if (names.length > MAX_SHARED_FILES) {
+        throw new Error(`At most ${MAX_SHARED_FILES} shared memory files are allowed`);
+    }
+    const hash = createHash("sha256");
+    const records = [];
+    for (const name of names) {
+        const path = resolve(directory, name);
+        const linkInfo = await lstat(path);
+        if (linkInfo.isSymbolicLink() || !linkInfo.isFile()) {
+            throw new Error(`Shared memory must be a regular file: ${name}`);
+        }
+        const canonicalPath = await realpath(path);
+        if (!isPathWithin(canonicalRoot, canonicalPath)) {
+            throw new Error(`Shared memory file escaped the project worktree: ${name}`);
+        }
+        const info = await stat(canonicalPath);
+        if (info.size > MAX_SHARED_FILE_BYTES) {
+            throw new Error(`Shared memory file exceeds ${MAX_SHARED_FILE_BYTES} bytes: ${name}`);
+        }
+        const source = `${SHARED_MEMORY_RELATIVE_DIR}/${name}`;
+        const content = await readFile(canonicalPath, "utf8");
+        hash.update(source).update("\0").update(content).update("\0");
+        records.push(parseSharedMemory(source, content));
+    }
+    return { records, signature: hash.digest("hex") };
+}
+export function parseSharedMemory(source, input) {
+    if (!input.startsWith("---\n")) {
+        throw new Error(`Shared memory is missing YAML frontmatter: ${source}`);
+    }
+    const end = input.indexOf("\n---\n", 4);
+    if (end < 0) {
+        throw new Error(`Shared memory has malformed YAML frontmatter: ${source}`);
+    }
+    const metadata = YAML.parse(input.slice(4, end));
+    const content = input.slice(end + 5).trim();
+    if (!isObject(metadata))
+        throw new Error(`Invalid shared memory: ${source}`);
+    const allowed = new Set([
+        "schema_version",
+        "id",
+        "title",
+        "kind",
+        "importance",
+        "tags",
+        "code_paths",
+        "updated_at_ms",
+    ]);
+    if (Object.keys(metadata).some((key) => !allowed.has(key))) {
+        throw new Error(`Shared memory has unknown fields: ${source}`);
+    }
+    if (metadata.schema_version !== 1 ||
+        typeof metadata.title !== "string" ||
+        metadata.title.length === 0 ||
+        metadata.title.length > 160 ||
+        !MEMORY_KINDS.includes(metadata.kind) ||
+        typeof metadata.importance !== "number" ||
+        metadata.importance < 0 ||
+        metadata.importance > 1 ||
+        !isStringArray(metadata.tags, 12, 64) ||
+        !isStringArray(metadata.code_paths, 12, 512) ||
+        content.length === 0 ||
+        content.length > 6_000) {
+        throw new Error(`Shared memory fields are invalid: ${source}`);
+    }
+    return {
+        source,
+        title: metadata.title,
+        content,
+        kind: metadata.kind,
+        importance: metadata.importance,
+        tags: metadata.tags,
+        code_paths: metadata.code_paths,
+    };
+}
+export async function writeSharedMemory(worktree, memory) {
+    const canonicalRoot = await realpath(worktree);
+    const opencodeDirectory = resolve(canonicalRoot, ".opencode");
+    await ensureRealDirectory(opencodeDirectory);
+    const directory = resolve(opencodeDirectory, "memory");
+    await ensureRealDirectory(directory);
+    const canonicalDirectory = await realpath(directory);
+    if (!isPathWithin(canonicalRoot, canonicalDirectory)) {
+        throw new Error("Shared memory directory escaped the project worktree");
+    }
+    const destination = resolve(directory, `${memory.id}.md`);
+    try {
+        const destinationInfo = await lstat(destination);
+        if (destinationInfo.isSymbolicLink() || !destinationInfo.isFile()) {
+            throw new Error("Shared memory destination must be a regular file");
+        }
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "ENOENT")
+            throw error;
+    }
+    const relativePath = relative(canonicalRoot, destination).replaceAll("\\", "/");
+    if (!relativePath.startsWith(`${SHARED_MEMORY_RELATIVE_DIR}/`)) {
+        throw new Error("Shared memory destination escaped the project directory");
+    }
+    const frontmatter = YAML.stringify({
+        schema_version: 1,
+        id: memory.id,
+        title: memory.title,
+        kind: memory.kind,
+        importance: memory.importance,
+        tags: memory.tags,
+        code_paths: memory.code_anchors.map((anchor) => anchor.path),
+        updated_at_ms: memory.updated_at_ms,
+    });
+    const output = `---\n${frontmatter}---\n\n${memory.content.trim()}\n`;
+    const temporary = `${destination}.tmp-${process.pid}-${Date.now()}`;
+    await writeFile(temporary, output, { encoding: "utf8", flag: "wx", mode: 0o600 });
+    await rename(temporary, destination);
+    return relativePath;
+}
+export async function ensureRealDirectory(path) {
+    try {
+        const info = await lstat(path);
+        if (info.isSymbolicLink() || !info.isDirectory()) {
+            throw new Error(`Expected a real directory, not a symlink: ${path}`);
+        }
+    }
+    catch (error) {
+        if (!isNodeError(error) || error.code !== "ENOENT")
+            throw error;
+        await mkdir(path, { recursive: false, mode: 0o700 });
+    }
+}
+export function isPathWithin(root, candidate) {
+    const path = relative(root, candidate);
+    return path === "" || (!path.startsWith("..") && !isAbsolute(path));
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isStringArray(value, maxItems, maxLength) {
+    return (Array.isArray(value) &&
+        value.length <= maxItems &&
+        value.every((item) => typeof item === "string" && item.length > 0 && item.length <= maxLength));
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=shared-markdown.js.map

package/dist/shared-markdown.js.map

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

package/dist/sidecar-client.d.ts

@@ -0,0 +1,39 @@
+import type { ChildProcessWithoutNullStreams } from "node:child_process";
+import type { MemoryMethod } from "./protocol.js";
+export declare const REQUEST_TIMEOUT_MS = 300000;
+export declare const INITIALIZATION_TIMEOUT_MS: number;
+export declare const MAX_REQUEST_BYTES: number;
+export declare const MAX_RESPONSE_BYTES: number;
+export type SpawnFn = (binary: string, args: string[], opts: {
+    cwd: string;
+    detached: boolean;
+    env: NodeJS.ProcessEnv | undefined;
+    stdio: ["pipe", "pipe", "pipe"];
+}) => ChildProcessWithoutNullStreams;
+export declare function resolveNativeMemoryBinary(root: string): string;
+export declare class NativeMemoryClient {
+    private readonly root;
+    private readonly worktree;
+    private process;
+    private disposed;
+    private nextID;
+    private pending;
+    private generation;
+    private handshake;
+    private readonly spawnFn;
+    private readonly usingSpawnOverride;
+    private readonly requestTimeoutMs;
+    constructor(root: string, worktree: string, spawnOverride?: SpawnFn, requestTimeoutMs?: number);
+    request<T>(method: MemoryMethod, params?: unknown, signal?: AbortSignal): Promise<T>;
+    dispose(): Promise<void>;
+    private sendRequest;
+    private waitForHandshake;
+    private ensureHandshake;
+    private start;
+    private handleFrame;
+    private finishPending;
+    private rejectGeneration;
+    private failProcess;
+    private isCurrentAndRunning;
+}
+//# sourceMappingURL=sidecar-client.d.ts.map

package/dist/sidecar-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar-client.d.ts","sourceRoot":"","sources":["../opencode-memory/src/sidecar-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAOzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C,eAAO,MAAM,yBAAyB,QAAc,CAAC;AACrD,eAAO,MAAM,iBAAiB,QAAW,CAAC;AAC1C,eAAO,MAAM,kBAAkB,QAAW,CAAC;AAe3C,MAAM,MAAM,OAAO,GAAG,CACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE;IACJ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,KACE,8BAA8B,CAAC;AAEpC,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA4B9D;AAwBD,qBAAa,kBAAkB;IAY3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAZ3B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAA8D;IAC7E,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAGvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EACjC,aAAa,CAAC,EAAE,OAAO,EACvB,gBAAgB,CAAC,EAAE,MAAM;IASrB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAE,OAAY,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA8BxF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2C9B,OAAO,CAAC,WAAW;YA4DL,gBAAgB;IAkC9B,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,KAAK;IA6Eb,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/sidecar-client.js

@@ -0,0 +1,397 @@
+import { spawn as nodeSpawn } from "node:child_process";
+import { existsSync, realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve } from "node:path";
+import { decodeResponse, DelimitedFrameDecoder, encodeRequest } from "./protocol.js";
+const MiB = 1024 * 1024;
+export const REQUEST_TIMEOUT_MS = 300_000;
+export const INITIALIZATION_TIMEOUT_MS = 30 * 60_000;
+export const MAX_REQUEST_BYTES = 32 * MiB;
+export const MAX_RESPONSE_BYTES = 32 * MiB;
+const MAX_STDERR_BYTES = 8_192;
+const MAX_HANDSHAKE_RESTARTS = 1;
+const SUPPORTED_RPC_VERSION = 2;
+const require = createRequire(import.meta.url);
+const NATIVE_PACKAGES = {
+    "darwin-arm64": "@nguyenthdat/opencode-memory-darwin-arm64",
+    "darwin-x64": "@nguyenthdat/opencode-memory-darwin-x64",
+    "linux-arm64": "@nguyenthdat/opencode-memory-linux-arm64-gnu",
+    "linux-x64": "@nguyenthdat/opencode-memory-linux-x64-gnu",
+    "win32-x64": "@nguyenthdat/opencode-memory-win32-x64-msvc",
+};
+export function resolveNativeMemoryBinary(root) {
+    const override = process.env.OPENCODE_NATIVE_MEMORY_BIN;
+    const binaryName = process.platform === "win32" ? "opencode-memory.exe" : "opencode-memory";
+    const packaged = resolvePackagedBinary(binaryName);
+    const candidates = override
+        ? [resolve(override)]
+        : [
+            resolve(root, "target", "release", binaryName),
+            resolve(root, "target", "debug", binaryName),
+            ...(packaged ? [packaged] : []),
+        ];
+    for (const candidate of candidates) {
+        if (!existsSync(candidate))
+            continue;
+        const binary = realpathSync(candidate);
+        if (!override && process.platform !== "win32") {
+            const library = resolve(binary, "..", "memory-libs", process.platform === "darwin" ? "libzvec_c_api.dylib" : "libzvec_c_api.so");
+            if (!existsSync(library))
+                continue;
+        }
+        return binary;
+    }
+    throw new Error(`Native memory binary was not found. Reinstall with optional dependencies or run \`bun run build:native:release\`. Checked: ${candidates.join(", ")}`);
+}
+function resolvePackagedBinary(binaryName) {
+    const packageName = NATIVE_PACKAGES[`${process.platform}-${process.arch}`];
+    if (!packageName)
+        return undefined;
+    try {
+        return require.resolve(`${packageName}/bin/${binaryName}`);
+    }
+    catch {
+        return undefined;
+    }
+}
+class ProcessReplacedError extends Error {
+}
+export class NativeMemoryClient {
+    root;
+    worktree;
+    process;
+    disposed = false;
+    nextID = 1;
+    pending = new Map();
+    generation = 0;
+    handshake;
+    spawnFn;
+    usingSpawnOverride;
+    requestTimeoutMs;
+    constructor(root, worktree, spawnOverride, requestTimeoutMs) {
+        this.root = root;
+        this.worktree = worktree;
+        this.spawnFn = spawnOverride ?? nodeSpawn;
+        this.usingSpawnOverride = spawnOverride !== undefined;
+        this.requestTimeoutMs = requestTimeoutMs ?? REQUEST_TIMEOUT_MS;
+    }
+    // ---- Public API ---------------------------------------------------------
+    async request(method, params = {}, signal) {
+        if (this.disposed)
+            throw new Error("Native memory client is disposed");
+        if (signal?.aborted)
+            throw new Error("Native memory request was cancelled");
+        if (method === "shutdown") {
+            return await this.sendRequest(this.start(), method, params, signal);
+        }
+        for (let restart = 0; restart <= MAX_HANDSHAKE_RESTARTS; restart += 1) {
+            const process = this.start();
+            try {
+                await this.waitForHandshake(process, signal);
+            }
+            catch (error) {
+                if (error instanceof ProcessReplacedError) {
+                    if (restart < MAX_HANDSHAKE_RESTARTS)
+                        continue;
+                    throw new Error("Native memory sidecar exited repeatedly during protocol handshake");
+                }
+                throw error;
+            }
+            if (signal?.aborted)
+                throw new Error("Native memory request was cancelled");
+            if (!this.isCurrentAndRunning(process)) {
+                if (restart < MAX_HANDSHAKE_RESTARTS)
+                    continue;
+                throw new Error("Native memory sidecar exited repeatedly during protocol handshake");
+            }
+            return await this.sendRequest(process, method, params, signal);
+        }
+        throw new Error("Native memory handshake retry limit was exhausted");
+    }
+    async dispose() {
+        this.disposed = true;
+        const ps = this.process;
+        if (!ps)
+            return;
+        // If process already exited, just clean up
+        if (ps.child.exitCode !== null || ps.child.signalCode !== null) {
+            this.process = undefined;
+            this.rejectGeneration(ps.generation, new Error("Native memory client stopped"));
+            return;
+        }
+        // Register close before sending shutdown to avoid missing the event
+        const closePromise = new Promise((resolveClose) => {
+            ps.child.once("close", () => resolveClose());
+        });
+        const forceKill = setTimeout(() => {
+            stopProcessTree(ps.child, "SIGKILL");
+        }, 1_000);
+        forceKill.unref?.();
+        // Send shutdown through internal path, bypassing disposed check
+        try {
+            await this.sendRequest(ps, "shutdown", {});
+        }
+        catch {
+            // Process teardown below is authoritative.
+        }
+        ps.child.stdin.end();
+        try {
+            await closePromise;
+        }
+        finally {
+            clearTimeout(forceKill);
+            if (this.process === ps) {
+                this.process = undefined;
+            }
+            this.rejectGeneration(ps.generation, new Error("Native memory client stopped"));
+        }
+    }
+    // ---- Internal: sending requests to a captured process --------------------
+    sendRequest(process, method, params = {}, signal, timeoutMs = this.requestTimeoutMs) {
+        if (!this.isCurrentAndRunning(process)) {
+            throw new ProcessReplacedError("Native memory process changed before the request was sent");
+        }
+        if (signal?.aborted)
+            throw new Error("Native memory request was cancelled");
+        const id = this.nextID++;
+        const payload = encodeRequest(id, method, params);
+        const payloadBytes = payload.byteLength;
+        if (payloadBytes > MAX_REQUEST_BYTES) {
+            throw new Error(`Native memory request payload exceeds ${MAX_REQUEST_BYTES} bytes (was ${payloadBytes})`);
+        }
+        return new Promise((resolveRequest, rejectRequest) => {
+            const timeout = timeoutMs;
+            const timer = setTimeout(() => {
+                const active = this.pending.get(id);
+                if (!active)
+                    return;
+                this.finishPending(id, active);
+                rejectRequest(new Error(`Native memory ${method} timed out after ${timeout} ms`));
+            }, timeout);
+            timer.unref?.();
+            const entry = {
+                resolve: (value) => resolveRequest(value),
+                reject: rejectRequest,
+                timer,
+                signal,
+                generation: process.generation,
+            };
+            if (signal) {
+                entry.abort = () => {
+                    if (!this.pending.delete(id))
+                        return;
+                    clearTimeout(timer);
+                    rejectRequest(new Error(`Native memory ${method} was cancelled`));
+                };
+                signal.addEventListener("abort", entry.abort, { once: true });
+            }
+            this.pending.set(id, entry);
+            process.child.stdin.write(payload, (error) => {
+                if (!error)
+                    return;
+                const active = this.pending.get(id);
+                if (!active)
+                    return;
+                this.finishPending(id, active);
+                active.reject(new Error(`Cannot write native memory request: ${error.message}`));
+            });
+        });
+    }
+    // ---- Internal: handshake ------------------------------------------------
+    async waitForHandshake(process, signal) {
+        if (signal?.aborted) {
+            throw new Error("Native memory request was cancelled");
+        }
+        const handshake = this.ensureHandshake(process);
+        if (!signal) {
+            await handshake.promise;
+            return;
+        }
+        let onAbort;
+        const abortPromise = new Promise((_, reject) => {
+            if (signal.aborted) {
+                reject(new Error("Native memory request was cancelled"));
+                return;
+            }
+            onAbort = () => {
+                reject(new Error("Native memory request was cancelled"));
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+        });
+        try {
+            await Promise.race([handshake.promise, abortPromise]);
+        }
+        finally {
+            if (onAbort) {
+                signal.removeEventListener("abort", onAbort);
+            }
+        }
+    }
+    ensureHandshake(process) {
+        if (this.handshake?.generation === process.generation) {
+            return this.handshake;
+        }
+        const handshake = {
+            generation: process.generation,
+            promise: Promise.resolve(),
+        };
+        this.handshake = handshake;
+        handshake.promise = Promise.resolve().then(async () => {
+            const status = await this.sendRequest(process, "status", {}, undefined, INITIALIZATION_TIMEOUT_MS);
+            const protocolVer = status.rpc_protocol_version;
+            if (protocolVer !== SUPPORTED_RPC_VERSION) {
+                if (protocolVer === undefined || protocolVer === null) {
+                    throw new Error(`Native memory backend does not report its RPC protocol version. ` +
+                        `Run \`bun run build:native:release\` to rebuild the binary.`);
+                }
+                throw new Error(`Native memory RPC protocol version mismatch: ` +
+                    `client supports ${SUPPORTED_RPC_VERSION}, backend reports ${protocolVer}. ` +
+                    `Run \`bun run build:native:release\` to rebuild the binary.`);
+            }
+        });
+        return handshake;
+    }
+    // ---- Internal: process management ---------------------------------------
+    start() {
+        if (this.process && this.isCurrentAndRunning(this.process))
+            return this.process;
+        const binary = this.usingSpawnOverride
+            ? (process.env.OPENCODE_NATIVE_MEMORY_BIN ??
+                resolve(this.root, "target", "release", "opencode-memory"))
+            : resolveNativeMemoryBinary(this.root);
+        const child = this.spawnFn(binary, [], {
+            cwd: this.worktree,
+            detached: process.platform !== "win32",
+            env: {
+                ...process.env,
+                OPENCODE_MEMORY_PROJECT_ROOT: this.worktree,
+            },
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        this.generation += 1;
+        const gen = this.generation;
+        this.process = { child, generation: gen };
+        this.handshake = undefined;
+        const frameDecoder = new DelimitedFrameDecoder(MAX_RESPONSE_BYTES);
+        let stderr = "";
+        const processState = this.process;
+        child.stdout.on("data", (chunk) => {
+            try {
+                for (const frame of frameDecoder.push(chunk)) {
+                    this.handleFrame(frame, gen, processState);
+                }
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                this.failProcess(processState, new Error(detail));
+            }
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr = `${stderr}${chunk.toString("utf8")}`.slice(-MAX_STDERR_BYTES);
+        });
+        child.stdin.on("error", (error) => {
+            this.failProcess(processState, new Error(`Native memory stdin failed: ${error.message}`));
+        });
+        child.once("error", (error) => {
+            const hint = error.code === "ENOENT" ? "Run `bun run memory:build:release`." : error.message;
+            this.failProcess(processState, new Error(`Native memory failed to start: ${hint}`));
+        });
+        child.once("exit", (code, signal) => {
+            if (this.process?.generation === gen)
+                this.process = undefined;
+            if (this.handshake?.generation === gen)
+                this.handshake = undefined;
+            this.rejectGeneration(gen, new ProcessReplacedError(`Native memory exited with ${code ?? signal ?? "unknown status"}`));
+        });
+        child.once("close", (code, signal) => {
+            if (this.process?.generation !== gen)
+                return;
+            this.process = undefined;
+            if (this.disposed && code === 0)
+                return;
+            const detail = stderr.trim();
+            this.rejectGeneration(gen, new Error(`Native memory exited with ${code ?? signal ?? "unknown status"}${detail ? `: ${detail}` : ""}`));
+        });
+        return processState;
+    }
+    // ---- Internal: Protobuf frame handling (generation-aware) ---------------
+    handleFrame(frame, gen, process) {
+        let response;
+        try {
+            response = decodeResponse(frame);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            this.failProcess(process, new Error(`Native memory returned invalid Protobuf: ${detail}`));
+            return;
+        }
+        // An id=0 error applies to the whole protocol generation.
+        if (response.id === 0) {
+            this.failProcess(process, new Error(response.error || "Native memory protocol error"));
+            return;
+        }
+        if (!Number.isSafeInteger(response.id) || typeof response.ok !== "boolean") {
+            this.failProcess(process, new Error("Native memory returned an invalid response"));
+            return;
+        }
+        const pending = this.pending.get(response.id);
+        // Only resolve/reject if the pending belongs to this generation
+        if (!pending || pending.generation !== gen)
+            return;
+        this.finishPending(response.id, pending);
+        if (response.ok)
+            pending.resolve(response.result);
+        else
+            pending.reject(new Error(response.error || "Native memory operation failed"));
+    }
+    finishPending(id, pending) {
+        this.pending.delete(id);
+        clearTimeout(pending.timer);
+        if (pending.signal && pending.abort) {
+            pending.signal.removeEventListener("abort", pending.abort);
+        }
+    }
+    rejectGeneration(gen, error) {
+        for (const [id, pending] of this.pending) {
+            if (pending.generation !== gen)
+                continue;
+            this.finishPending(id, pending);
+            pending.reject(error);
+        }
+    }
+    failProcess(process, error) {
+        if (this.process?.generation === process.generation)
+            this.process = undefined;
+        if (this.handshake?.generation === process.generation)
+            this.handshake = undefined;
+        this.rejectGeneration(process.generation, error);
+        stopProcessTree(process.child, "SIGTERM");
+    }
+    isCurrentAndRunning(process) {
+        return (this.process?.generation === process.generation &&
+            process.child.exitCode === null &&
+            process.child.signalCode === null);
+    }
+}
+function stopProcessTree(child, signal) {
+    if (!child.pid)
+        return;
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    if (process.platform !== "win32") {
+        try {
+            process.kill(-child.pid, signal);
+            return;
+        }
+        catch {
+            // Fall back to the direct child.
+        }
+    }
+    try {
+        child.kill(signal);
+    }
+    catch {
+        // Process already exited.
+    }
+}
+//# sourceMappingURL=sidecar-client.js.map