@producible/cereworker-core 26.520.1

package/dist/task-store.js

@@ -0,0 +1,141 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { nanoid } from 'nanoid';
+import { createLogger } from './logger.js';
+import { appendJsonLine, ensureDir, readJsonLines, resolveStoreBasePath, withTextStoreLock, writeJsonFileAtomic, } from './text-store.js';
+const log = createLogger('task-store');
+const DEFAULT_DB_PATH = join(homedir(), '.cereworker', 'tasks');
+export class TaskStore {
+    inMemory;
+    baseDir;
+    definitionsPath;
+    runsDir;
+    memoryTasks = new Map();
+    memoryRuns = new Map();
+    definitionsCache = null;
+    definitionsCacheMtimeMs = null;
+    constructor(basePath) {
+        this.inMemory = basePath === ':memory:';
+        this.baseDir = this.inMemory ? null : resolveStoreBasePath(basePath ?? DEFAULT_DB_PATH);
+        this.definitionsPath = this.baseDir ? join(this.baseDir, 'definitions.json') : null;
+        this.runsDir = this.baseDir ? join(this.baseDir, 'runs') : null;
+        if (this.baseDir) {
+            ensureDir(this.baseDir);
+            ensureDir(this.runsDir);
+        }
+    }
+    list() {
+        if (this.inMemory) {
+            return Array.from(this.memoryTasks.values()).map((task) => ({ ...task }));
+        }
+        const file = this.readDefinitionsFile();
+        return file.tasks.map((task) => ({ ...task }));
+    }
+    get(taskId) {
+        if (this.inMemory) {
+            const task = this.memoryTasks.get(taskId);
+            return task ? { ...task } : undefined;
+        }
+        const file = this.readDefinitionsFile();
+        const task = file.tasks.find((entry) => entry.id === taskId);
+        return task ? { ...task } : undefined;
+    }
+    upsert(task) {
+        if (this.inMemory) {
+            this.memoryTasks.set(task.id, { ...task });
+            return { ...task };
+        }
+        return withTextStoreLock(this.baseDir, () => {
+            const file = this.readDefinitionsFile();
+            const index = file.tasks.findIndex((existing) => existing.id === task.id);
+            if (index >= 0) {
+                file.tasks[index] = { ...task };
+            }
+            else {
+                file.tasks.push({ ...task });
+            }
+            this.writeDefinitionsFile(file.tasks);
+            return { ...task };
+        });
+    }
+    remove(taskId) {
+        if (this.inMemory)
+            return this.memoryTasks.delete(taskId);
+        return withTextStoreLock(this.baseDir, () => {
+            const file = this.readDefinitionsFile();
+            const filtered = file.tasks.filter((task) => task.id !== taskId);
+            if (filtered.length === file.tasks.length)
+                return false;
+            this.writeDefinitionsFile(filtered);
+            return true;
+        });
+    }
+    appendRun(taskId, run) {
+        const record = {
+            id: nanoid(12),
+            taskId,
+            ...run,
+        };
+        if (this.inMemory) {
+            const rows = this.memoryRuns.get(taskId) ?? [];
+            rows.push(record);
+            this.memoryRuns.set(taskId, rows);
+            return record;
+        }
+        withTextStoreLock(this.baseDir, () => {
+            appendJsonLine(this.getRunPath(taskId), record);
+        });
+        return record;
+    }
+    listRuns(taskId) {
+        if (this.inMemory)
+            return [...(this.memoryRuns.get(taskId) ?? [])];
+        return readJsonLines(this.getRunPath(taskId));
+    }
+    getRunPath(taskId) {
+        return join(this.runsDir ?? dirname(DEFAULT_DB_PATH), `${taskId}.jsonl`);
+    }
+    readDefinitionsFile() {
+        if (!this.definitionsPath || !existsSync(this.definitionsPath)) {
+            this.definitionsCache = { tasks: [] };
+            this.definitionsCacheMtimeMs = null;
+            return { tasks: [] };
+        }
+        try {
+            const stat = statSync(this.definitionsPath);
+            if (this.definitionsCache && this.definitionsCacheMtimeMs === stat.mtimeMs) {
+                return {
+                    tasks: this.definitionsCache.tasks.map((task) => ({ ...task })),
+                };
+            }
+            const raw = JSON.parse(readFileSync(this.definitionsPath, 'utf-8'));
+            if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+                return { tasks: [] };
+            const tasks = Array.isArray(raw.tasks)
+                ? (raw.tasks ?? [])
+                : [];
+            this.definitionsCache = { tasks: tasks.map((task) => ({ ...task })) };
+            this.definitionsCacheMtimeMs = stat.mtimeMs;
+            return { tasks };
+        }
+        catch (error) {
+            log.warn('Failed to read task definitions', { error: String(error) });
+            return { tasks: [] };
+        }
+    }
+    writeDefinitionsFile(tasks) {
+        writeJsonFileAtomic(this.definitionsPath, { tasks });
+        try {
+            this.definitionsCache = { tasks: tasks.map((task) => ({ ...task })) };
+            this.definitionsCacheMtimeMs = existsSync(this.definitionsPath)
+                ? statSync(this.definitionsPath).mtimeMs
+                : null;
+        }
+        catch {
+            this.definitionsCache = null;
+            this.definitionsCacheMtimeMs = null;
+        }
+    }
+}
+//# sourceMappingURL=task-store.js.map

package/dist/task-store.js.map

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

package/dist/text-store.d.ts

@@ -0,0 +1,18 @@
+export interface TextStoreLockOptions {
+    timeoutMs?: number;
+    pollMs?: number;
+    staleMs?: number;
+}
+export declare function resolveStoreBasePath(path: string): string;
+export declare function ensureDir(path: string): void;
+export declare function withTextStoreLock<T>(targetPath: string, fn: () => T, options?: TextStoreLockOptions): T;
+export declare function writeTextFileAtomic(path: string, content: string): void;
+export declare function writeJsonFileAtomic(path: string, value: unknown): void;
+export declare function readJsonFile<T>(path: string, fallback: T): T;
+export declare function appendJsonLine(path: string, value: unknown): void;
+export declare function readJsonLines<T>(path: string): T[];
+export declare function writeJsonLines(path: string, rows: unknown[]): void;
+export declare function uniqueBackupPath(path: string): string;
+export declare function readFileHeader(path: string, bytes: number): Buffer;
+export declare function joinJsonlPath(dir: string, filename: string): string;
+//# sourceMappingURL=text-store.d.ts.map

package/dist/text-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-store.d.ts","sourceRoot":"","sources":["../src/text-store.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI5C;AAgFD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,CAAC,CA+B3G;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAgBvE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAEtE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAO5D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAGjE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAclD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAKlE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/text-store.js

@@ -0,0 +1,212 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { hostname, homedir } from 'node:os';
+import { dirname, extname, join, resolve } from 'node:path';
+import { createLogger } from './logger.js';
+const log = createLogger('text-store');
+const DEFAULT_LOCK_TIMEOUT_MS = 2_000;
+const DEFAULT_LOCK_POLL_MS = 100;
+const DEFAULT_LOCK_STALE_MS = 30_000;
+const LOCK_OWNER_FILE = 'owner.json';
+function expandHome(path) {
+    return path.replace(/^~(?=\/|$)/, homedir());
+}
+export function resolveStoreBasePath(path) {
+    const resolved = resolve(expandHome(path));
+    if (existsSync(resolved) && statSync(resolved).isDirectory()) {
+        return resolved;
+    }
+    return extname(resolved) ? dirname(resolved) : resolved;
+}
+export function ensureDir(path) {
+    if (!existsSync(path)) {
+        mkdirSync(path, { recursive: true });
+    }
+}
+function sleepMs(ms) {
+    if (ms <= 0)
+        return;
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+function getLockDir(path) {
+    return `${path}.lock`;
+}
+function getLockOwnerPath(lockDir) {
+    return join(lockDir, LOCK_OWNER_FILE);
+}
+function readLockOwner(lockDir) {
+    return readJsonFile(getLockOwnerPath(lockDir), null);
+}
+function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ESRCH')
+            return false;
+        return true;
+    }
+}
+function tryAcquireLock(lockDir, targetPath) {
+    try {
+        mkdirSync(lockDir);
+        try {
+            writeFileSync(getLockOwnerPath(lockDir), JSON.stringify({
+                pid: process.pid,
+                hostname: hostname(),
+                acquiredAt: Date.now(),
+                targetPath,
+            }, null, 2) + '\n', 'utf-8');
+        }
+        catch (error) {
+            rmSync(lockDir, { recursive: true, force: true });
+            throw error;
+        }
+        return true;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'EEXIST')
+            return false;
+        throw error;
+    }
+}
+function tryReleaseStaleLock(lockDir, staleMs) {
+    if (!existsSync(lockDir))
+        return false;
+    const owner = readLockOwner(lockDir);
+    if (!owner) {
+        const ageMs = Date.now() - statSync(lockDir).mtimeMs;
+        if (ageMs < staleMs)
+            return false;
+        rmSync(lockDir, { recursive: true, force: true });
+        log.warn('Removed stale text-store lock without owner metadata', { lockDir, ageMs: Math.round(ageMs) });
+        return true;
+    }
+    const ageMs = Date.now() - owner.acquiredAt;
+    if (ageMs < staleMs)
+        return false;
+    if (owner.hostname !== hostname())
+        return false;
+    if (isProcessAlive(owner.pid))
+        return false;
+    rmSync(lockDir, { recursive: true, force: true });
+    log.warn('Removed stale text-store lock', {
+        lockDir,
+        targetPath: owner.targetPath,
+        pid: owner.pid,
+        ageMs: Math.round(ageMs),
+    });
+    return true;
+}
+export function withTextStoreLock(targetPath, fn, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_LOCK_TIMEOUT_MS;
+    const pollMs = options.pollMs ?? DEFAULT_LOCK_POLL_MS;
+    const staleMs = options.staleMs ?? DEFAULT_LOCK_STALE_MS;
+    const startedAt = Date.now();
+    const lockDir = getLockDir(targetPath);
+    ensureDir(dirname(lockDir));
+    let waitLogged = false;
+    while (!tryAcquireLock(lockDir, targetPath)) {
+        if (tryReleaseStaleLock(lockDir, staleMs)) {
+            continue;
+        }
+        const elapsedMs = Date.now() - startedAt;
+        if (!waitLogged) {
+            log.debug('Waiting for text-store lock', { targetPath, lockDir });
+            waitLogged = true;
+        }
+        if (elapsedMs >= timeoutMs) {
+            log.warn('Text-store lock timed out', { targetPath, lockDir, timeoutMs });
+            throw new Error(`Text store busy: ${targetPath}`);
+        }
+        sleepMs(Math.min(pollMs, timeoutMs - elapsedMs));
+    }
+    try {
+        return fn();
+    }
+    finally {
+        rmSync(lockDir, { recursive: true, force: true });
+    }
+}
+export function writeTextFileAtomic(path, content) {
+    ensureDir(dirname(path));
+    const tempPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    writeFileSync(tempPath, content, 'utf-8');
+    try {
+        renameSync(tempPath, path);
+    }
+    catch (error) {
+        const code = error.code;
+        if ((code === 'EEXIST' || code === 'EPERM' || code === 'ENOTEMPTY') && existsSync(path)) {
+            rmSync(path, { force: true });
+            renameSync(tempPath, path);
+            return;
+        }
+        rmSync(tempPath, { force: true });
+        throw error;
+    }
+}
+export function writeJsonFileAtomic(path, value) {
+    writeTextFileAtomic(path, JSON.stringify(value, null, 2) + '\n');
+}
+export function readJsonFile(path, fallback) {
+    if (!existsSync(path))
+        return fallback;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return fallback;
+    }
+}
+export function appendJsonLine(path, value) {
+    ensureDir(dirname(path));
+    appendFileSync(path, JSON.stringify(value) + '\n', 'utf-8');
+}
+export function readJsonLines(path) {
+    if (!existsSync(path))
+        return [];
+    const content = readFileSync(path, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content
+        .split('\n')
+        .map((line) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        }
+    })
+        .filter((value) => value !== null);
+}
+export function writeJsonLines(path, rows) {
+    const content = rows.length > 0
+        ? rows.map((row) => JSON.stringify(row)).join('\n') + '\n'
+        : '';
+    writeTextFileAtomic(path, content);
+}
+export function uniqueBackupPath(path) {
+    let candidate = `${path}.bak`;
+    let counter = 1;
+    while (existsSync(candidate)) {
+        candidate = `${path}.bak.${counter}`;
+        counter++;
+    }
+    return candidate;
+}
+export function readFileHeader(path, bytes) {
+    if (!existsSync(path))
+        return Buffer.alloc(0);
+    const content = readFileSync(path);
+    return content.subarray(0, Math.min(bytes, content.length));
+}
+export function joinJsonlPath(dir, filename) {
+    return join(dir, filename);
+}
+//# sourceMappingURL=text-store.js.map

package/dist/text-store.js.map

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

package/dist/tool-runtime.d.ts

@@ -0,0 +1,76 @@
+import type { ToolCall, ToolResult } from './types.js';
+import type { ToolDefinition } from './orchestrator.js';
+export type ToolRuntimeEngine = 'legacy' | 'enhanced';
+export type ToolLoopDetectorKind = 'generic_repeat' | 'known_poll_no_progress' | 'global_circuit_breaker' | 'ping_pong';
+export interface ToolLoopDetectionConfig {
+    enabled: boolean;
+    historySize: number;
+    warningThreshold: number;
+    criticalThreshold: number;
+    globalCircuitBreakerThreshold: number;
+    detectors: {
+        genericRepeat: boolean;
+        knownPollNoProgress: boolean;
+        pingPong: boolean;
+    };
+}
+export interface ToolRuntimeConfig {
+    engine: ToolRuntimeEngine;
+    maxResultChars: number;
+    loopDetection: ToolLoopDetectionConfig;
+}
+export interface ToolExecutionContext {
+    callId: string;
+    toolName: string;
+    conversationId?: string;
+    sessionKey?: string;
+    scopeKey?: string;
+    turnId?: string;
+    attempt?: number;
+    ingress?: {
+        channelId?: string;
+        routeTo?: string;
+        senderId?: string;
+        senderName?: string;
+        sessionId?: string;
+        threadId?: string;
+        replyToId?: string;
+        timestamp?: number;
+    };
+    runtimeEngine: ToolRuntimeEngine;
+    abortSignal?: AbortSignal;
+}
+export interface ToolExecutionValue {
+    output?: string;
+    isError?: boolean;
+    details?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    truncated?: boolean;
+    synthetic?: boolean;
+    warnings?: string[];
+    content?: unknown[];
+    status?: string;
+}
+export interface ToolRuntimeExecution {
+    toolName: string;
+    result: ToolResult;
+}
+export declare class ToolRuntime {
+    private config;
+    private historyByScope;
+    constructor(config?: Partial<ToolRuntimeConfig>);
+    getConfig(): ToolRuntimeConfig;
+    execute(params: {
+        toolCall: ToolCall;
+        tools: Map<string, ToolDefinition> | Record<string, ToolDefinition>;
+        conversationId?: string;
+        sessionKey?: string;
+        scopeKey?: string;
+        turnId?: string;
+        attempt?: number;
+        ingress?: ToolExecutionContext['ingress'];
+        abortSignal?: AbortSignal;
+    }): Promise<ToolRuntimeExecution>;
+    private recordToolOutcome;
+}
+//# sourceMappingURL=tool-runtime.d.ts.map

package/dist/tool-runtime.d.ts.map

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