opencode-stm 0.0.0-stage → 0.2.0

package/dist/src/sdk.d.ts

@@ -0,0 +1,50 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+export type Client = PluginInput["client"];
+export type SdkResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: string;
+};
+export type SessionInfo = {
+    id: string;
+    title: string;
+    parentID?: string;
+};
+export declare const MESSAGE_PAGE_LIMIT = 8;
+export declare function readSession(client: Client, sessionID: string, signal?: AbortSignal): Promise<SdkResult<SessionInfo>>;
+export declare function writeTitle(client: Client, sessionID: string, title: string, signal?: AbortSignal): Promise<SdkResult<{
+    id: string;
+}>>;
+export type PagePart = {
+    id?: string;
+    type?: string;
+    text?: string;
+    synthetic?: boolean;
+    ignored?: boolean;
+    tool?: string;
+    messageID?: string;
+    [key: string]: unknown;
+};
+export type PageMessage = {
+    info: {
+        id: string;
+        sessionID: string;
+        role: string;
+        summary?: unknown;
+    };
+    parts: PagePart[];
+};
+export type PageResult = {
+    items: PageMessage[];
+    nextCursor: string | null;
+};
+export declare function page(client: Client, sessionID: string, cursor: string | undefined, signal?: AbortSignal): Promise<SdkResult<PageResult>>;
+export type RootCache = {
+    isRoot(sessionID: string, signal?: AbortSignal): Promise<SdkResult<boolean>>;
+    remember(sessionID: string, value: boolean): void;
+    invalidate(sessionID: string): void;
+    clear(): void;
+};
+export declare function createRootCache(client: Client, max?: number): RootCache;

package/dist/src/sdk.js

@@ -0,0 +1,101 @@
+export const MESSAGE_PAGE_LIMIT = 8;
+export async function readSession(client, sessionID, signal) {
+    try {
+        const result = await client.session.get({ path: { id: sessionID }, signal });
+        if (result.error !== undefined && result.error !== null) {
+            return { ok: false, reason: "sdk: session read rejected" };
+        }
+        const data = result.data;
+        if (data === undefined || data.id !== sessionID || typeof data.title !== "string") {
+            return { ok: false, reason: "sdk: session read returned unexpected data" };
+        }
+        return {
+            ok: true,
+            value: data.parentID === undefined
+                ? { id: data.id, title: data.title }
+                : { id: data.id, title: data.title, parentID: data.parentID },
+        };
+    }
+    catch {
+        return { ok: false, reason: "sdk: session read failed" };
+    }
+}
+export async function writeTitle(client, sessionID, title, signal) {
+    try {
+        const result = await client.session.update({ path: { id: sessionID }, body: { title }, signal });
+        if (result.error !== undefined && result.error !== null) {
+            return { ok: false, reason: "sdk: title update rejected" };
+        }
+        const data = result.data;
+        if (data === undefined || data.id !== sessionID) {
+            return { ok: false, reason: "sdk: title update returned unexpected data" };
+        }
+        return { ok: true, value: { id: data.id } };
+    }
+    catch {
+        return { ok: false, reason: "sdk: title update failed" };
+    }
+}
+export async function page(client, sessionID, cursor, signal) {
+    // The published v1 query type omits `before`; the 1.18.35 runtime accepts it.
+    // Keep this single additive cast here so no other module depends on the gap.
+    const query = {
+        limit: MESSAGE_PAGE_LIMIT,
+        ...(cursor === undefined ? {} : { before: cursor }),
+    };
+    try {
+        const result = await client.session.messages({ path: { id: sessionID }, query, signal });
+        if (result.error !== undefined && result.error !== null) {
+            return { ok: false, reason: "sdk: message page rejected" };
+        }
+        if (!Array.isArray(result.data)) {
+            return { ok: false, reason: "sdk: message page returned unexpected data" };
+        }
+        const header = result.response?.headers?.get("x-next-cursor") ?? null;
+        return {
+            ok: true,
+            value: { items: result.data, nextCursor: header !== null && header.length > 0 ? header : null },
+        };
+    }
+    catch {
+        return { ok: false, reason: "sdk: message page failed" };
+    }
+}
+export function createRootCache(client, max = 256) {
+    const entries = new Map();
+    const insert = (sessionID, value) => {
+        entries.delete(sessionID);
+        entries.set(sessionID, value);
+        while (entries.size > max) {
+            const oldest = entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            entries.delete(oldest);
+        }
+    };
+    return {
+        async isRoot(sessionID, signal) {
+            const cached = entries.get(sessionID);
+            if (cached !== undefined) {
+                insert(sessionID, cached);
+                return { ok: true, value: cached };
+            }
+            const read = await readSession(client, sessionID, signal);
+            if (!read.ok)
+                return { ok: false, reason: read.reason };
+            const isRoot = read.value.parentID === undefined;
+            insert(sessionID, isRoot);
+            return { ok: true, value: isRoot };
+        },
+        remember(sessionID, value) {
+            insert(sessionID, value);
+        },
+        invalidate(sessionID) {
+            entries.delete(sessionID);
+        },
+        clear() {
+            entries.clear();
+        },
+    };
+}
+//# sourceMappingURL=sdk.js.map

package/dist/src/sdk.js.map

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

package/dist/src/state.d.ts

@@ -0,0 +1,70 @@
+export declare const STATE_SCHEMA_VERSION = 1;
+export declare const FRONTIER_MAX = 64;
+export declare const ANCHOR_MAX = 32;
+export type LockReason = "none" | "manual" | "external" | "non-default-title" | "historical" | "unreadable-state" | "invalid-config";
+export type ReviewState = {
+    id: string;
+    remindersSent: number;
+    nextTriggerAt: number;
+};
+export type AnchorState = {
+    reviewID: string;
+    reminderIndex: number;
+    anchorMessageID: string;
+    partID: string;
+    obsolete: boolean;
+};
+export type SessionMeta = {
+    schemaVersion: 1;
+    activity: number;
+    baselineMessageID: string | null;
+    frontier: string[];
+    review: ReviewState | null;
+    anchors: AnchorState[];
+    locked: boolean;
+    lockReason: LockReason;
+    titleDigest: string | null;
+};
+export declare function initialMeta(): SessionMeta;
+export declare function hashSessionID(sessionID: string): string;
+export declare function hashTitle(title: string): string;
+export declare function resolveStateDir(env: NodeJS.ProcessEnv, home: string): string;
+export declare function parseMeta(value: unknown): SessionMeta | null;
+export type LoadResult = {
+    ok: true;
+    value: SessionMeta | null;
+} | {
+    ok: false;
+    reason: string;
+};
+export type SaveResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export type UpdateResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: string;
+};
+export type StateStoreOptions = {
+    stateDir: string;
+    now?: () => number;
+};
+export interface StateStore {
+    load(sessionID: string): Promise<LoadResult>;
+    save(sessionID: string, meta: SessionMeta): Promise<SaveResult>;
+    update<T>(sessionID: string, fn: (current: SessionMeta | null) => {
+        next: SessionMeta;
+        result: T;
+    }): Promise<UpdateResult<T>>;
+    removeOwned(sessionID: string): Promise<void>;
+}
+export type OperationGuard = {
+    run<T>(key: string, fn: () => Promise<T>): Promise<T>;
+};
+export declare function createOperationGuard(): OperationGuard;
+export declare function createStateStore(options: StateStoreOptions): StateStore;

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":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACvI,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAA;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAC9B,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAA;AAiC5B,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,aAAa,EAAE,oBAAoB;QACnC,QAAQ,EAAE,CAAC;QACX,iBAAiB,EAAE,IAAI;QACvB,QAAQ,EAAE,EAAE;QACZ,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,IAAI;KAClB,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAsB,EAAE,IAAY;IAClE,MAAM,GAAG,GAAG,GAAG,CAAC,cAAc,CAAA;IAC9B,MAAM,IAAI,GAAG,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACzG,OAAO,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,KAA8B,EAAE,IAAuB;IAC1E,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACjC,OAAO,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAA;AACnF,CAAC;AAED,MAAM,YAAY,GAA0B;IAC1C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB;CACtG,CAAA;AAED,MAAM,SAAS,GAAG;IAChB,eAAe,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa;CAChH,CAAA;AACV,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,eAAe,CAAU,CAAA;AACrE,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAA;AAEnG,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAClC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,KAAK,CAAA;IAClD,OAAO,CACL,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAC5B,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC;QACpC,KAAK,CAAC,aAAwB,IAAI,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC;QACpC,KAAK,CAAC,aAAwB,IAAI,CAAC,CACrC,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAClC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC;QAAE,OAAO,KAAK,CAAA;IAClD,OAAO,CACL,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAClC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC;QACpC,KAAK,CAAC,aAAwB,IAAI,CAAC;QACpC,OAAO,KAAK,CAAC,eAAe,KAAK,QAAQ;QACzC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,OAAO,KAAK,CAAC,QAAQ,KAAK,SAAS,CACpC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACjC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/C,IAAI,KAAK,CAAC,aAAa,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAA;IAC7D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAK,KAAK,CAAC,QAAmB,GAAG,CAAC;QAAE,OAAO,IAAI,CAAA;IACpF,IAAI,CAAC,CAAC,KAAK,CAAC,iBAAiB,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,iBAAiB,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IACnG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,YAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IACpJ,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAA;IACxE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1H,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAClD,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAwB,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/G,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IACvF,OAAO,KAAoB,CAAA;AAC7B,CAAC;AAgBD,MAAM,UAAU,oBAAoB;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC9C,OAAO;QACL,GAAG,CAAI,GAAW,EAAE,EAAoB;YACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;YACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CACtB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;YACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACpB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBAClB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;oBAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChD,CAAC,CAAC,CAAA;YACF,OAAO,MAAM,CAAA;QACf,CAAC;KACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAA0B;IACzD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAA;IAEnD,SAAS,OAAO,CAAI,GAAW,EAAE,IAAsB;QACrD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QACzD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CACtB,GAAG,EAAE,CAAC,SAAS,EACf,GAAG,EAAE,CAAC,SAAS,CAChB,CAAA;QACD,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QACzB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;YAClB,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;gBAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1D,CAAC,CAAC,CAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC;IAED,SAAS,KAAK,CAAC,SAAiB;QAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;QACrC,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,OAAO,CAAC;YAC5C,IAAI,EAAE,GAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,MAAM,CAAC;SACzF,CAAA;IACH,CAAC;IAED,SAAS,SAAS;QAChB,0EAA0E;QAC1E,2EAA2E;QAC3E,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC7D,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,MAAM,cAAe,SAAQ,KAAK;QACX;QAArB,YAAqB,MAAc;YACjC,KAAK,CAAC,MAAM,CAAC,CAAA;YADM,WAAM,GAAN,MAAM,CAAQ;QAEnC,CAAC;KACF;IAED,SAAS,YAAY,CAAI,SAAiB,EAAE,EAAW;QACrD,IAAI,MAAc,CAAA;QAClB,IAAI,CAAC;YACH,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,IAAI,cAAc,CAAC,wBAAwB,CAAC,CAAA;YAC1G,MAAM,IAAI,cAAc,CAAC,yBAAyB,CAAC,CAAA;QACrD,CAAC;QACD,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,MAAM,CAAC,CAAA;YACjB,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;IAED,SAAS,YAAY,CAAC,SAAiB;QACrC,IAAI,IAAY,CAAA;QAChB,IAAI,CAAC;YACH,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;YACxF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;QACnD,CAAC;QACD,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAA;QACjE,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAA;QAClF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;IAClC,CAAC;IAED,SAAS,aAAa,CAAC,SAAiB,EAAE,IAAiB;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAA;QACpC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;YACrC,IAAI,CAAC;gBACH,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;gBACrB,SAAS,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC1C,SAAS,CAAC,EAAE,CAAC,CAAA;YACf,CAAC;oBAAS,CAAC;gBACT,SAAS,CAAC,EAAE,CAAC,CAAA;YACf,CAAC;YACD,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAA;YACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;QACrB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAA;QACpD,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS;YACZ,OAAO,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;gBACnC,IAAI,CAAC;oBACH,SAAS,EAAE,CAAA;gBACb,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAA;gBAC9D,CAAC;gBACD,IAAI,CAAC;oBACH,OAAO,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA;gBAC/D,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,cAAc;wBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;oBAC/E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;gBAC/C,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,IAAI;YAClB,OAAO,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;gBACnC,IAAI,CAAC;oBACH,SAAS,EAAE,CAAA;gBACb,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAA;gBAC9D,CAAC;gBACD,IAAI,CAAC;oBACH,OAAO,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAA;gBACtE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,cAAc;wBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;oBAC/E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;gBAC/C,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,CAAI,SAAiB,EAAE,EAAqE;YAChG,OAAO,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;gBACnC,IAAI,CAAC;oBACH,SAAS,EAAE,CAAA;gBACb,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,EAAE,CAAA;gBAC9D,CAAC;gBACD,IAAI,CAAC;oBACH,OAAO,YAAY,CAAkB,SAAS,EAAE,GAAG,EAAE;wBACnD,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;wBACvC,IAAI,CAAC,OAAO,CAAC,EAAE;4BAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAA;wBAC7D,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;wBAC1C,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;wBAC5C,IAAI,CAAC,KAAK,CAAC,EAAE;4BAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;wBACzD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;oBACpC,CAAC,CAAC,CAAA;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,KAAK,YAAY,cAAc;wBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;oBAC/E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAA;gBAC/C,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,WAAW,CAAC,SAAS;YACzB,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,uEAAuE;YACzE,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

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>;