@plateforme-ai/lobster 2026.6.12

package/dist/src/state/store.js

@@ -0,0 +1,337 @@
+import os from "node:os";
+import path from "node:path";
+import { promises as fsp } from "node:fs";
+import { randomBytes } from "node:crypto";
+export function defaultStateDir(env) {
+    return ((env?.LOBSTER_STATE_DIR && String(env.LOBSTER_STATE_DIR).trim()) ||
+        path.join(os.homedir(), ".lobster", "state"));
+}
+export function keyToPath(stateDir, key) {
+    const safe = String(key)
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "_")
+        .replace(/_+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    if (!safe)
+        throw new Error("state key is empty/invalid");
+    return path.join(stateDir, `${safe}.json`);
+}
+export function stableStringify(value) {
+    return JSON.stringify(value, (_k, v) => {
+        if (v && typeof v === "object" && !Array.isArray(v)) {
+            return Object.fromEntries(Object.keys(v)
+                .sort()
+                .map((k) => [k, v[k]]));
+        }
+        return v;
+    });
+}
+function isDirectorySyncUnsupportedError(err) {
+    return [
+        "EACCES",
+        "EBADF",
+        "EINVAL",
+        "EISDIR",
+        "ENOSYS",
+        "ENOTSUP",
+        "EOPNOTSUPP",
+        "EPERM",
+    ].includes(err?.code);
+}
+async function syncParentDir(filePath) {
+    await syncDirectory(path.dirname(filePath));
+}
+async function syncDirectory(dir) {
+    let handle;
+    try {
+        handle = await fsp.open(dir, "r");
+    }
+    catch (err) {
+        if (isDirectorySyncUnsupportedError(err))
+            return;
+        throw err;
+    }
+    try {
+        await handle.sync();
+    }
+    catch (err) {
+        if (!isDirectorySyncUnsupportedError(err))
+            throw err;
+    }
+    finally {
+        if (handle)
+            await handle.close().catch(() => { });
+    }
+}
+async function syncCreatedDirectoryChain(firstCreated, finalDir) {
+    const final = path.resolve(finalDir);
+    let current = path.resolve(firstCreated);
+    await syncDirectory(path.dirname(current));
+    while (current !== final) {
+        await syncDirectory(current);
+        const relative = path.relative(current, final);
+        const next = relative.split(path.sep)[0];
+        if (!next || next === "..")
+            break;
+        current = path.join(current, next);
+    }
+}
+export async function ensureDirectory(dir) {
+    const created = await fsp.mkdir(dir, { recursive: true });
+    if (created)
+        await syncCreatedDirectoryChain(created, dir);
+}
+export function isJsonSyntaxError(err) {
+    return err instanceof SyntaxError;
+}
+function isLinkUnsupportedError(err) {
+    return ["ENOSYS", "ENOTSUP", "EOPNOTSUPP", "EPERM", "EXDEV"].includes(err?.code);
+}
+export function isAtomicExclusiveUnsupportedError(err) {
+    return err?.code === "ENOTSUP" && err?.cause && isLinkUnsupportedError(err.cause);
+}
+function isOptionalApprovalIndexPersistenceError(err) {
+    return (isAtomicExclusiveUnsupportedError(err) ||
+        ["EACCES", "EDQUOT", "EIO", "ENOSPC", "EPERM", "EROFS"].includes(err?.code));
+}
+/**
+ * Write a file atomically: stage to a sibling temp file, fsync, then rename
+ * over the target. `rename(2)` is atomic on a single filesystem, so a reader
+ * (or a crash) never observes a truncated/partial file — it sees either the
+ * complete old content or the complete new content. Plain `fsp.writeFile`
+ * truncates the target up front, leaving a corruption window on SIGKILL/OOM/
+ * power loss. New state files are private by default; existing file modes are
+ * preserved across replacement. The temp file is removed on any failed path.
+ */
+export async function writeFileAtomic(filePath, data, options = {}) {
+    const renameFile = options.renameFile ?? fsp.rename;
+    const syncDir = options.syncParentDir ?? syncParentDir;
+    const dir = path.dirname(filePath);
+    const tmpPath = path.join(dir, `.${path.basename(filePath)}.${randomBytes(6).toString("hex")}.tmp`);
+    let mode = 0o600;
+    let handle;
+    let cleanup = true;
+    try {
+        try {
+            mode = (await fsp.stat(filePath)).mode & 0o777;
+        }
+        catch (err) {
+            if (err?.code !== "ENOENT")
+                throw err;
+        }
+        handle = await fsp.open(tmpPath, "wx", mode);
+        await handle.writeFile(data, "utf8");
+        await handle.chmod(mode);
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        await renameFile(tmpPath, filePath);
+        await syncDir(filePath);
+        cleanup = false;
+    }
+    finally {
+        if (handle)
+            await handle.close().catch(() => { });
+        if (cleanup)
+            await fsp.rm(tmpPath, { force: true }).catch(() => { });
+    }
+}
+export async function writeFileAtomicExclusive(filePath, data, options = {}) {
+    const linkFile = options.linkFile ?? fsp.link;
+    const syncDir = options.syncParentDir ?? syncParentDir;
+    const dir = path.dirname(filePath);
+    const tmpPath = path.join(dir, `.${path.basename(filePath)}.${randomBytes(6).toString("hex")}.tmp`);
+    let handle;
+    try {
+        handle = await fsp.open(tmpPath, "wx", 0o600);
+        await handle.writeFile(data, "utf8");
+        await handle.chmod(0o600);
+        await handle.sync();
+        await handle.close();
+        handle = undefined;
+        try {
+            await linkFile(tmpPath, filePath);
+        }
+        catch (err) {
+            if (!isLinkUnsupportedError(err))
+                throw err;
+            const unsupported = new Error("Atomic exclusive file creation requires hard-link support on this filesystem");
+            unsupported.code = "ENOTSUP";
+            unsupported.cause = err;
+            throw unsupported;
+        }
+        try {
+            await fsp.unlink(tmpPath);
+            await syncDir(filePath);
+        }
+        catch (err) {
+            await fsp.unlink(filePath).catch(() => { });
+            await syncDir(filePath).catch(() => { });
+            throw err;
+        }
+    }
+    finally {
+        if (handle)
+            await handle.close().catch(() => { });
+        await fsp.rm(tmpPath, { force: true }).catch(() => { });
+    }
+}
+export async function readStateJson({ env, key }) {
+    const stateDir = defaultStateDir(env);
+    const filePath = keyToPath(stateDir, key);
+    try {
+        const text = await fsp.readFile(filePath, "utf8");
+        return JSON.parse(text);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function writeStateJson({ env, key, value }) {
+    const stateDir = defaultStateDir(env);
+    const filePath = keyToPath(stateDir, key);
+    await ensureDirectory(stateDir);
+    await writeFileAtomic(filePath, JSON.stringify(value, null, 2) + "\n");
+}
+export async function deleteStateJson({ env, key }) {
+    const stateDir = defaultStateDir(env);
+    const filePath = keyToPath(stateDir, key);
+    try {
+        await fsp.unlink(filePath);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return;
+        throw err;
+    }
+}
+function sanitizeApprovalId(approvalId) {
+    return approvalId.replace(/[^a-f0-9]/g, "");
+}
+/**
+ * Generate a short, human-friendly approval ID (8 hex chars).
+ * These are easy to copy/paste in chat interfaces where full
+ * base64url resume tokens are unwieldy.
+ */
+export function generateApprovalId() {
+    return randomBytes(4).toString("hex");
+}
+/**
+ * Write a reverse-index file that maps approvalId → stateKey.
+ * Call this after writeStateJson to enable short-ID resume.
+ */
+export async function writeApprovalIndex({ env, stateKey, approvalId, options, }) {
+    const stateDir = defaultStateDir(env);
+    const safe = sanitizeApprovalId(approvalId);
+    if (!safe)
+        return;
+    await ensureDirectory(stateDir);
+    const indexPath = path.join(stateDir, `approval_${safe}.json`);
+    await writeFileAtomicExclusive(indexPath, JSON.stringify({ stateKey, createdAt: new Date().toISOString() }) + "\n", options);
+}
+/**
+ * Create a unique approval ID index without ever overwriting an existing mapping.
+ */
+export async function createApprovalIndex({ env, stateKey, options, }) {
+    for (let attempt = 0; attempt < 16; attempt++) {
+        const approvalId = generateApprovalId();
+        try {
+            await writeApprovalIndex({ env, stateKey, approvalId, options });
+            return approvalId;
+        }
+        catch (err) {
+            if (err?.code === "EEXIST")
+                continue;
+            if (isOptionalApprovalIndexPersistenceError(err))
+                return null;
+            throw err;
+        }
+    }
+    throw new Error("Could not allocate a unique approval ID");
+}
+/**
+ * Look up a state key by short approval ID.
+ * Returns the stateKey string or null if not found.
+ */
+export async function findStateKeyByApprovalId({ env, approvalId, }) {
+    const stateDir = defaultStateDir(env);
+    const safe = sanitizeApprovalId(approvalId);
+    if (!safe)
+        return null;
+    const indexPath = path.join(stateDir, `approval_${safe}.json`);
+    try {
+        const text = await fsp.readFile(indexPath, "utf8");
+        const data = JSON.parse(text);
+        return typeof data?.stateKey === "string" ? data.stateKey : null;
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return null;
+        if (isJsonSyntaxError(err))
+            return null;
+        throw err;
+    }
+}
+/**
+ * Delete the approval ID index file (cleanup after resume or cancel).
+ */
+export async function deleteApprovalId({ env, approvalId, }) {
+    const stateDir = defaultStateDir(env);
+    const safe = sanitizeApprovalId(approvalId);
+    if (!safe)
+        return;
+    const indexPath = path.join(stateDir, `approval_${safe}.json`);
+    try {
+        await fsp.unlink(indexPath);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return;
+        throw err;
+    }
+}
+/**
+ * Clean up any approval index file that points to the given stateKey.
+ * Used when resuming via --token (where we don't know the approvalId).
+ * Scans index files in the state dir — O(n) but n is tiny in practice.
+ */
+export async function cleanupApprovalIndexByStateKey({ env, stateKey, }) {
+    const stateDir = defaultStateDir(env);
+    let files;
+    try {
+        files = await fsp.readdir(stateDir);
+    }
+    catch (err) {
+        if (err?.code === "ENOENT")
+            return;
+        throw err;
+    }
+    for (const file of files) {
+        if (!file.startsWith("approval_") || !file.endsWith(".json"))
+            continue;
+        try {
+            const text = await fsp.readFile(path.join(stateDir, file), "utf8");
+            const data = JSON.parse(text);
+            if (data?.stateKey === stateKey) {
+                await fsp.unlink(path.join(stateDir, file)).catch(() => { });
+                return; // one index per stateKey
+            }
+        }
+        catch {
+            /* skip corrupt files */
+        }
+    }
+}
+export async function diffAndStore({ env, key, value }) {
+    const before = await readStateJson({ env, key }).catch((err) => {
+        if (isJsonSyntaxError(err))
+            return null;
+        throw err;
+    });
+    const changed = stableStringify(before) !== stableStringify(value);
+    await writeStateJson({ env, key, value });
+    return { before, after: value, changed };
+}
+//# sourceMappingURL=store.js.map

package/dist/src/state/store.js.map

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

package/dist/src/token.js

@@ -0,0 +1,15 @@
+import { Buffer } from "node:buffer";
+export function encodeToken(obj) {
+    const json = JSON.stringify(obj);
+    return Buffer.from(json, "utf8").toString("base64url");
+}
+export function decodeToken(token) {
+    try {
+        const json = Buffer.from(String(token), "base64url").toString("utf8");
+        return JSON.parse(json);
+    }
+    catch (_err) {
+        throw new Error("Invalid token");
+    }
+}
+//# sourceMappingURL=token.js.map

package/dist/src/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,WAAW,CAAC,GAAG;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAK;IAC/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/src/validation.js

@@ -0,0 +1,38 @@
+import { Ajv } from "ajv";
+import { stableStringify } from "./state/store.js";
+export const sharedAjv = new Ajv({
+    allErrors: false,
+    strict: false,
+    // User-provided schemas may repeat `$id` across runs/resumes.
+    addUsedSchema: false,
+});
+/**
+ * Build a memoized `compile()` for a given Ajv instance.
+ *
+ * Calling `ajv.compile(schema)` per request leaks SchemaEnv / closure graphs
+ * that Ajv retains indefinitely (issue #96). Memoization
+ * eliminates the leak for the common case where the same schema is recompiled
+ * across calls.
+ *
+ * Cache key is the stable JSON serialization of the schema, which catches
+ * structurally-identical schemas across reloads even when keys are inserted
+ * in different orders.
+ *
+ * Each Ajv instance gets its own cache because compiled validators are not
+ * interchangeable across different Ajv configurations.
+ */
+export function createCompileCached(ajv) {
+    const cache = new Map();
+    return function compileCached(schema) {
+        const key = stableStringify(schema);
+        let validator = cache.get(key);
+        if (!validator) {
+            validator = ajv.compile(schema);
+            cache.set(key, validator);
+        }
+        return validator;
+    };
+}
+/** Memoized compile bound to the module-level `sharedAjv` instance. */
+export const compileCached = createCompileCached(sharedAjv);
+//# sourceMappingURL=validation.js.map

package/dist/src/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAyC,MAAM,KAAK,CAAC;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IAC/B,SAAS,EAAE,KAAK;IAChB,MAAM,EAAE,KAAK;IACb,8DAA8D;IAC9D,aAAa,EAAE,KAAK;CACrB,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAClD,OAAO,SAAS,aAAa,CAAC,MAAiB;QAC7C,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,aAAa,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC"}