toolcraft 0.0.23 → 0.0.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolcraft",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,18 +39,18 @@
     "test": "cd ../.. && vitest run packages/toolcraft/src",
     "test:unit": "cd ../.. && vitest run packages/toolcraft/src",
     "lint": "cd ../.. && eslint packages/toolcraft/src --ext ts && tsc -p packages/toolcraft/tsconfig.json --noEmit",
-    "prepack": "node ../../scripts/manage-bundled-workspace-deps.mjs prepare . @poe-code/design-system @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/file-lock @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client mcp-oauth auth-store",
-    "postpack": "node ../../scripts/manage-bundled-workspace-deps.mjs cleanup . @poe-code/design-system @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/file-lock @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client mcp-oauth auth-store"
+    "prepack": "node ../../scripts/manage-bundled-workspace-deps.mjs prepare . @poe-code/design-system @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client mcp-oauth auth-store",
+    "postpack": "node ../../scripts/manage-bundled-workspace-deps.mjs cleanup . @poe-code/design-system @poe-code/agent-mcp-config @poe-code/agent-human-in-loop @poe-code/task-list @poe-code/agent-defs @poe-code/config-mutations @poe-code/process-runner tiny-mcp-client mcp-oauth auth-store"
   },
   "dependencies": {
     "@clack/core": "^1.0.0",
     "@clack/prompts": "^1.0.0",
+    "toolcraft-schema": "0.0.25",
     "commander": "^14.0.3",
     "jose": "^6.1.2",
     "jsonc-parser": "^3.3.1",
     "smol-toml": "^1.3.0",
     "tiny-stdio-mcp-server": "^0.1.0",
-    "toolcraft-schema": "^0.0.23",
     "yaml": "^2.8.2"
   },
   "files": [
@@ -69,7 +69,6 @@
     "@poe-code/agent-mcp-config",
     "@poe-code/agent-human-in-loop",
     "@poe-code/task-list",
-    "@poe-code/file-lock",
     "@poe-code/agent-defs",
     "@poe-code/config-mutations",
     "@poe-code/process-runner",
@@ -78,16 +77,15 @@
     "auth-store"
   ],
   "optionalDependencies": {
-    "@poe-code/agent-defs": "*",
-    "@poe-code/agent-human-in-loop": "*",
+    "@poe-code/design-system": "^0.0.2",
     "@poe-code/agent-mcp-config": "*",
+    "@poe-code/agent-human-in-loop": "*",
+    "@poe-code/task-list": "*",
+    "@poe-code/agent-defs": "*",
     "@poe-code/config-mutations": "*",
-    "@poe-code/design-system": "^0.0.2",
-    "@poe-code/file-lock": "*",
     "@poe-code/process-runner": "*",
-    "@poe-code/task-list": "*",
-    "auth-store": "*",
+    "tiny-mcp-client": "*",
     "mcp-oauth": "*",
-    "tiny-mcp-client": "*"
+    "auth-store": "*"
   }
 }

package/node_modules/@poe-code/file-lock/README.md

@@ -1,52 +0,0 @@
-# @poe-code/file-lock
-
-Atomic file locking built on lockfile creation with `open(..., "wx")` and timestamped stale cleanup.
-
-It creates a sibling lockfile at `<filePath>.lock`, retries with bounded backoff when the lock is already held, and automatically reclaims stale locks. Locks from the current host are reclaimed immediately when their recorded process is no longer running; other locks fall back to the lockfile timestamp and `staleMs`.
-
-## Public API
-
-### `acquireFileLock(filePath, options?)`
-
-```ts
-function acquireFileLock(
-  filePath: string,
-  options?: FileLockOptions
-): Promise<ReleaseLock>;
-```
-
-Attempts to acquire an exclusive lock for `filePath` and resolves to an async release function. If the lock already exists, acquisition retries until it succeeds, the lock is considered stale and cleaned up, the provided abort signal fires, or retries are exhausted. When retries are exhausted, it throws `LockTimeoutError`.
-
-## Options
-
-| Option | Type | Default | Behavior |
-| --- | --- | --- | --- |
-| `staleMs` | `number` | `1_000` | Lockfile age in milliseconds after which an existing lock is treated as stale and removed when live local PID metadata does not prove the owner is still running. |
-| `retries` | `number` | `20` | Number of retry attempts after the initial acquire attempt. |
-| `minTimeout` | `number` | `25` | Minimum retry backoff in milliseconds. |
-| `maxTimeout` | `number` | `250` | Maximum retry backoff in milliseconds. |
-| `isPidRunning` | `(pid: number) => boolean` | `process.kill(pid, 0)` check | Injectable process liveness check used to reclaim dead local lock owners. |
-| `signal` | `AbortSignal` | none | Cancels acquisition while waiting between retries and rejects with an abort error. |
-| `fs` | `FileLockFs` | `node:fs/promises` adapter | Injectable filesystem used for lock creation, metadata reading, inspection, and deletion. |
-
-## Env vars
-
-None.
-
-## Usage
-
-```ts
-import { acquireFileLock } from "@poe-code/file-lock";
-
-const release = await acquireFileLock("/repo/workflow.md");
-
-try {
-  // Do work while holding the lock.
-} finally {
-  await release();
-}
-```
-
-## Notes
-
-`@poe-code/agent-harness-tools` re-exports `acquireFileLock` as `lockWorkflow`.

package/node_modules/@poe-code/file-lock/dist/index.d.ts

@@ -1 +0,0 @@
-export { acquireFileLock, LockTimeoutError, type FileLockFs, type FileLockOptions, type ReleaseLock } from "./lock.js";

package/node_modules/@poe-code/file-lock/dist/index.js

@@ -1 +0,0 @@
-export { acquireFileLock, LockTimeoutError } from "./lock.js";

package/node_modules/@poe-code/file-lock/dist/lock.d.ts

@@ -1,27 +0,0 @@
-export interface FileLockFs {
-    open(path: string, flags: string): Promise<{
-        close(): Promise<void>;
-        writeFile(data: string, options?: BufferEncoding | {
-            encoding?: BufferEncoding;
-        }): Promise<void>;
-    }>;
-    stat(path: string): Promise<{
-        mtimeMs: number;
-    }>;
-    readFile?(path: string, encoding: BufferEncoding): Promise<string>;
-    unlink(path: string): Promise<void>;
-}
-export interface FileLockOptions {
-    staleMs?: number;
-    retries?: number;
-    minTimeout?: number;
-    maxTimeout?: number;
-    fs?: FileLockFs;
-    isPidRunning?: (pid: number) => boolean;
-    signal?: AbortSignal;
-}
-export type ReleaseLock = () => Promise<void>;
-export declare class LockTimeoutError extends Error {
-    constructor(message: string);
-}
-export declare function acquireFileLock(filePath: string, options?: FileLockOptions): Promise<ReleaseLock>;

package/node_modules/@poe-code/file-lock/dist/lock.js

@@ -1,203 +0,0 @@
-import * as fsPromises from "node:fs/promises";
-import * as os from "node:os";
-export class LockTimeoutError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = "LockTimeoutError";
-    }
-}
-function createAbortError() {
-    const error = new Error("The operation was aborted.");
-    error.name = "AbortError";
-    return error;
-}
-function throwIfAborted(signal) {
-    if (signal?.aborted) {
-        throw createAbortError();
-    }
-}
-function sleep(ms, signal) {
-    if (!signal) {
-        return new Promise((resolve) => setTimeout(resolve, ms));
-    }
-    if (signal.aborted) {
-        return Promise.reject(createAbortError());
-    }
-    return new Promise((resolve, reject) => {
-        const timeoutId = setTimeout(() => {
-            signal.removeEventListener("abort", onAbort);
-            resolve();
-        }, ms);
-        const onAbort = () => {
-            clearTimeout(timeoutId);
-            signal.removeEventListener("abort", onAbort);
-            reject(createAbortError());
-        };
-        signal.addEventListener("abort", onAbort, { once: true });
-    });
-}
-function backoff(attempt, minTimeout, maxTimeout) {
-    const delay = Math.min(maxTimeout, minTimeout * 2 ** attempt);
-    return delay + Math.random() * delay * 0.1;
-}
-function hasErrorCode(error, code) {
-    return (!!error &&
-        typeof error === "object" &&
-        "code" in error &&
-        error.code === code);
-}
-function hasAnyErrorCode(error, codes) {
-    return codes.some((code) => hasErrorCode(error, code));
-}
-function isPidRunning(pid) {
-    try {
-        process.kill(pid, 0);
-        return true;
-    }
-    catch (error) {
-        return !hasErrorCode(error, "ESRCH");
-    }
-}
-function createDefaultFs() {
-    return {
-        open: (path, flags) => fsPromises.open(path, flags),
-        readFile: (path, encoding) => fsPromises.readFile(path, encoding),
-        stat: fsPromises.stat,
-        unlink: fsPromises.unlink
-    };
-}
-async function removeLockFile(fs, lockPath, signal) {
-    for (let attempt = 0; attempt <= 4; attempt += 1) {
-        throwIfAborted(signal);
-        try {
-            await fs.unlink(lockPath);
-            return;
-        }
-        catch (error) {
-            if (hasErrorCode(error, "ENOENT")) {
-                return;
-            }
-            if (!hasAnyErrorCode(error, ["EPERM", "EBUSY"]) || attempt === 4) {
-                throw error;
-            }
-        }
-        await sleep(25 * 2 ** attempt, signal);
-    }
-}
-function parseLockMetadata(content) {
-    try {
-        const parsed = JSON.parse(content);
-        if (!parsed || typeof parsed !== "object" || !("host" in parsed) || !("pid" in parsed)) {
-            return undefined;
-        }
-        const { host, pid } = parsed;
-        if (typeof host === "string" && typeof pid === "number" && Number.isSafeInteger(pid) && pid > 0) {
-            return {
-                host,
-                pid
-            };
-        }
-    }
-    catch (ignoredError) {
-        void ignoredError;
-    }
-    return undefined;
-}
-async function readLockMetadata(fs, lockPath) {
-    if (!fs.readFile) {
-        return undefined;
-    }
-    try {
-        return parseLockMetadata(await fs.readFile(lockPath, "utf8"));
-    }
-    catch (error) {
-        if (hasErrorCode(error, "ENOENT")) {
-            return null;
-        }
-        return undefined;
-    }
-}
-async function shouldReclaimLock(options) {
-    const metadata = await readLockMetadata(options.fs, options.lockPath);
-    if (metadata === null) {
-        return "missing";
-    }
-    if (metadata?.host === os.hostname()) {
-        return !options.isPidRunning(metadata.pid);
-    }
-    return Date.now() - options.stat.mtimeMs > options.staleMs;
-}
-async function writeLockMetadata(handle) {
-    try {
-        await handle.writeFile(JSON.stringify({ pid: process.pid, host: os.hostname(), acquiredAt: new Date().toISOString() }), { encoding: "utf8" });
-    }
-    catch (ignoredError) {
-        void ignoredError;
-    }
-    try {
-        await handle.close();
-    }
-    catch (ignoredError) {
-        void ignoredError;
-    }
-}
-export async function acquireFileLock(filePath, options = {}) {
-    const fs = options.fs ?? createDefaultFs();
-    const retries = options.retries ?? 20;
-    const minTimeout = options.minTimeout ?? 25;
-    const maxTimeout = options.maxTimeout ?? 250;
-    const staleMs = options.staleMs ?? 1_000;
-    const pidIsRunning = options.isPidRunning ?? isPidRunning;
-    const lockPath = `${filePath}.lock`;
-    let attempt = 0;
-    while (attempt <= retries) {
-        throwIfAborted(options.signal);
-        try {
-            const handle = await fs.open(lockPath, "wx");
-            await writeLockMetadata(handle);
-            let released = false;
-            return async () => {
-                if (released) {
-                    return;
-                }
-                released = true;
-                await removeLockFile(fs, lockPath, options.signal);
-            };
-        }
-        catch (error) {
-            if (!hasErrorCode(error, "EEXIST")) {
-                throw error;
-            }
-        }
-        let stat;
-        try {
-            stat = await fs.stat(lockPath);
-        }
-        catch (statError) {
-            if (hasErrorCode(statError, "ENOENT")) {
-                continue;
-            }
-            throw statError;
-        }
-        const reclaimLock = await shouldReclaimLock({
-            fs,
-            isPidRunning: pidIsRunning,
-            lockPath,
-            staleMs,
-            stat
-        });
-        if (reclaimLock === "missing") {
-            continue;
-        }
-        if (reclaimLock) {
-            await removeLockFile(fs, lockPath, options.signal);
-            continue;
-        }
-        if (attempt >= retries) {
-            break;
-        }
-        await sleep(backoff(attempt, minTimeout, maxTimeout), options.signal);
-        attempt += 1;
-    }
-    throw new LockTimeoutError(`Failed to acquire lock on "${filePath}".`);
-}

package/node_modules/@poe-code/file-lock/package.json

@@ -1,23 +0,0 @@
-{
-  "name": "@poe-code/file-lock",
-  "version": "0.0.1",
-  "private": true,
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "build": "tsc",
-    "test": "cd ../.. && vitest run packages/file-lock/src",
-    "test:unit": "cd ../.. && vitest run packages/file-lock/src"
-  },
-  "files": [
-    "dist"
-  ],
-  "dependencies": {}
-}