opencode-stm 0.0.0-stage → 0.1.0

package/dist/src/state.js

@@ -0,0 +1,278 @@
+import { createHash, randomUUID } from "node:crypto";
+import { chmodSync, closeSync, fchmodSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, rmSync, writeSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+export const STATE_SCHEMA_VERSION = 1;
+export const FRONTIER_MAX = 64;
+export const ANCHOR_MAX = 32;
+export function initialMeta() {
+    return {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        activity: 0,
+        baselineMessageID: null,
+        frontier: [],
+        review: null,
+        anchors: [],
+        locked: false,
+        lockReason: "none",
+        titleDigest: null,
+    };
+}
+export function hashSessionID(sessionID) {
+    return createHash("sha256").update(sessionID, "utf8").digest("hex");
+}
+export function hashTitle(title) {
+    return createHash("sha256").update(title, "utf8").digest("hex");
+}
+export function resolveStateDir(env, home) {
+    const xdg = env.XDG_STATE_HOME;
+    const base = xdg !== undefined && xdg.length > 0 && isAbsolute(xdg) ? xdg : join(home, ".local", "state");
+    return join(base, "opencode-stm");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasOnlyKeys(value, keys) {
+    const actual = Object.keys(value);
+    return actual.length === keys.length && actual.every((key) => keys.includes(key));
+}
+const LOCK_REASONS = [
+    "none", "manual", "external", "non-default-title", "historical", "unreadable-state", "invalid-config",
+];
+const META_KEYS = [
+    "schemaVersion", "activity", "baselineMessageID", "frontier", "review", "anchors", "locked", "lockReason", "titleDigest",
+];
+const REVIEW_KEYS = ["id", "remindersSent", "nextTriggerAt"];
+const ANCHOR_KEYS = ["reviewID", "reminderIndex", "anchorMessageID", "partID", "obsolete"];
+function isReviewState(value) {
+    if (!isRecord(value))
+        return false;
+    if (!hasOnlyKeys(value, REVIEW_KEYS))
+        return false;
+    return (typeof value.id === "string" &&
+        Number.isInteger(value.remindersSent) &&
+        value.remindersSent >= 0 &&
+        Number.isInteger(value.nextTriggerAt) &&
+        value.nextTriggerAt >= 0);
+}
+function isAnchorState(value) {
+    if (!isRecord(value))
+        return false;
+    if (!hasOnlyKeys(value, ANCHOR_KEYS))
+        return false;
+    return (typeof value.reviewID === "string" &&
+        Number.isInteger(value.reminderIndex) &&
+        value.reminderIndex >= 0 &&
+        typeof value.anchorMessageID === "string" &&
+        typeof value.partID === "string" &&
+        typeof value.obsolete === "boolean");
+}
+export function parseMeta(value) {
+    if (!isRecord(value))
+        return null;
+    if (!hasOnlyKeys(value, META_KEYS))
+        return null;
+    if (value.schemaVersion !== STATE_SCHEMA_VERSION)
+        return null;
+    if (!Number.isInteger(value.activity) || value.activity < 0)
+        return null;
+    if (!(value.baselineMessageID === null || typeof value.baselineMessageID === "string"))
+        return null;
+    if (!Array.isArray(value.frontier) || value.frontier.length > FRONTIER_MAX || !value.frontier.every((item) => typeof item === "string"))
+        return null;
+    if (!(value.review === null || isReviewState(value.review)))
+        return null;
+    if (!Array.isArray(value.anchors) || value.anchors.length > ANCHOR_MAX || !value.anchors.every(isAnchorState))
+        return null;
+    if (typeof value.locked !== "boolean")
+        return null;
+    if (typeof value.lockReason !== "string" || !LOCK_REASONS.includes(value.lockReason))
+        return null;
+    if (!(value.titleDigest === null || typeof value.titleDigest === "string"))
+        return null;
+    return value;
+}
+export function createOperationGuard() {
+    const tails = new Map();
+    return {
+        run(key, fn) {
+            const previous = tails.get(key) ?? Promise.resolve();
+            const result = previous.then(fn, fn);
+            const tail = result.then(() => undefined, () => undefined);
+            tails.set(key, tail);
+            void tail.then(() => {
+                if (tails.get(key) === tail)
+                    tails.delete(key);
+            });
+            return result;
+        },
+    };
+}
+export function createStateStore(options) {
+    const queueTails = new Map();
+    function enqueue(key, task) {
+        const previous = queueTails.get(key) ?? Promise.resolve();
+        const result = previous.then(task, task);
+        const tail = result.then(() => undefined, () => undefined);
+        queueTails.set(key, tail);
+        void tail.then(() => {
+            if (queueTails.get(key) === tail)
+                queueTails.delete(key);
+        });
+        return result;
+    }
+    function paths(sessionID) {
+        const name = hashSessionID(sessionID);
+        return {
+            file: join(options.stateDir, `${name}.json`),
+            lock: join(options.stateDir, `${name}.lock`),
+            temp: () => join(options.stateDir, `${name}.${process.pid}.${randomUUID()}.tmp`),
+        };
+    }
+    function ensureDir() {
+        // Fails closed: a directory that cannot be created or locked to mode 0700
+        // must disable persistence instead of falling back to permissive defaults.
+        mkdirSync(options.stateDir, { recursive: true, mode: 0o700 });
+        chmodSync(options.stateDir, 0o700);
+    }
+    class StoreLockError extends Error {
+        reason;
+        constructor(reason) {
+            super(reason);
+            this.reason = reason;
+        }
+    }
+    function withFileLock(sessionID, fn) {
+        let lockFd;
+        try {
+            lockFd = openSync(paths(sessionID).lock, "wx", 0o600);
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                throw new StoreLockError("state: lock contention");
+            throw new StoreLockError("state: lock unavailable");
+        }
+        try {
+            return fn();
+        }
+        finally {
+            closeSync(lockFd);
+            rmSync(paths(sessionID).lock, { force: true });
+        }
+    }
+    function readUnlocked(sessionID) {
+        let text;
+        try {
+            text = readFileSync(paths(sessionID).file, "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return { ok: true, value: null };
+            return { ok: false, reason: "state: unreadable" };
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            return { ok: false, reason: "state: malformed or unsupported" };
+        }
+        const meta = parseMeta(parsed);
+        if (meta === null)
+            return { ok: false, reason: "state: malformed or unsupported" };
+        return { ok: true, value: meta };
+    }
+    function writeUnlocked(sessionID, meta) {
+        const temp = paths(sessionID).temp();
+        try {
+            const fd = openSync(temp, "w", 0o600);
+            try {
+                fchmodSync(fd, 0o600);
+                writeSync(fd, `${JSON.stringify(meta)}\n`);
+                fsyncSync(fd);
+            }
+            finally {
+                closeSync(fd);
+            }
+            renameSync(temp, paths(sessionID).file);
+            return { ok: true };
+        }
+        catch {
+            rmSync(temp, { force: true });
+            return { ok: false, reason: "state: save failed" };
+        }
+    }
+    return {
+        load(sessionID) {
+            return enqueue(sessionID, async () => {
+                try {
+                    ensureDir();
+                }
+                catch {
+                    return { ok: false, reason: "state: directory unavailable" };
+                }
+                try {
+                    return withFileLock(sessionID, () => readUnlocked(sessionID));
+                }
+                catch (error) {
+                    if (error instanceof StoreLockError)
+                        return { ok: false, reason: error.reason };
+                    return { ok: false, reason: "state: failed" };
+                }
+            });
+        },
+        save(sessionID, meta) {
+            return enqueue(sessionID, async () => {
+                try {
+                    ensureDir();
+                }
+                catch {
+                    return { ok: false, reason: "state: directory unavailable" };
+                }
+                try {
+                    return withFileLock(sessionID, () => writeUnlocked(sessionID, meta));
+                }
+                catch (error) {
+                    if (error instanceof StoreLockError)
+                        return { ok: false, reason: error.reason };
+                    return { ok: false, reason: "state: failed" };
+                }
+            });
+        },
+        update(sessionID, fn) {
+            return enqueue(sessionID, async () => {
+                try {
+                    ensureDir();
+                }
+                catch {
+                    return { ok: false, reason: "state: directory unavailable" };
+                }
+                try {
+                    return withFileLock(sessionID, () => {
+                        const current = readUnlocked(sessionID);
+                        if (!current.ok)
+                            return { ok: false, reason: current.reason };
+                        const { next, result } = fn(current.value);
+                        const saved = writeUnlocked(sessionID, next);
+                        if (!saved.ok)
+                            return { ok: false, reason: saved.reason };
+                        return { ok: true, value: result };
+                    });
+                }
+                catch (error) {
+                    if (error instanceof StoreLockError)
+                        return { ok: false, reason: error.reason };
+                    return { ok: false, reason: "state: failed" };
+                }
+            });
+        },
+        async removeOwned(sessionID) {
+            try {
+                rmSync(paths(sessionID).file, { force: true });
+            }
+            catch {
+                // Session lifecycle cleanup is best effort; stale metadata is allowed.
+            }
+        },
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/src/state.js.map

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

package/dist/src/tools.d.ts

@@ -0,0 +1,33 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import type { StmConfig } from "./config.js";
+import { type SessionMeta, type StateStore, type OperationGuard } from "./state.js";
+import { type Client, type RootCache } from "./sdk.js";
+import { type TranscriptQueue } from "./transcript.js";
+export declare const TITLE_MAX_CODE_POINTS = 120;
+export type TitleValidation = {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function validateTitle(raw: string): TitleValidation;
+export type StmServices = {
+    client: Client;
+    config: StmConfig;
+    state: StateStore;
+    queue: TranscriptQueue;
+    roots: RootCache;
+    guard: OperationGuard;
+    blocked: Map<string, Set<string>>;
+    now: () => number;
+};
+export declare function establishBaseline(services: StmServices, sessionID: string, signal?: AbortSignal, knownTitle?: string): Promise<{
+    ok: true;
+    meta: SessionMeta;
+} | {
+    ok: false;
+    reason: string;
+}>;
+export declare function createCurrentTools(services: StmServices): Record<string, ToolDefinition>;
+export declare function createHistoricalTools(services: StmServices): Record<string, ToolDefinition>;