agentrix 0.0.1

package/dist/core/task-store.js

@@ -0,0 +1,105 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+function toError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    return new Error(String(error));
+}
+async function removeFile(path) {
+    try {
+        await rm(path, { force: true });
+    }
+    catch (error) {
+        const err = toError(error);
+        if (err.code !== 'ENOENT') {
+            throw err;
+        }
+    }
+}
+async function ensureDirectory(path) {
+    await mkdir(path, { recursive: true });
+}
+async function writeAtomicJSON({ filePath, payload }) {
+    const directory = dirname(filePath);
+    await ensureDirectory(directory);
+    const tmpPath = join(directory, `.${randomUUID()}.tmp`);
+    try {
+        await writeFile(tmpPath, payload, 'utf8');
+        await rename(tmpPath, filePath);
+    }
+    catch (error) {
+        await removeFile(tmpPath).catch(() => { });
+        throw error;
+    }
+}
+export function createTaskStore({ root, filename = 'tasks.json', logger = console, now = () => new Date(), }) {
+    if (typeof root !== 'string' || !root.trim()) {
+        throw new Error('Task store root directory is required');
+    }
+    const resolvedRoot = resolve(root);
+    const storageDirectory = join(resolvedRoot, '.agentrix');
+    const filePath = join(storageDirectory, filename);
+    let writeQueue = Promise.resolve();
+    async function loadSnapshot() {
+        try {
+            const raw = await readFile(filePath, 'utf8');
+            if (!raw.trim()) {
+                return [];
+            }
+            const parsed = JSON.parse(raw);
+            if (parsed && Array.isArray(parsed.tasks)) {
+                return parsed.tasks;
+            }
+            if (Array.isArray(parsed)) {
+                return parsed;
+            }
+            return [];
+        }
+        catch (error) {
+            const err = toError(error);
+            if (err.code === 'ENOENT') {
+                return [];
+            }
+            logger?.warn?.('[agentrix] Failed to load persisted tasks snapshot:', err.message || err);
+            return [];
+        }
+    }
+    async function saveSnapshot(tasks) {
+        const snapshot = {
+            version: 1,
+            generatedAt: now().toISOString(),
+            tasks: Array.isArray(tasks) ? tasks : [],
+        };
+        const payload = `${JSON.stringify(snapshot, null, 2)}\n`;
+        const task = writeQueue.then(async () => {
+            await writeAtomicJSON({ filePath, payload });
+        });
+        const placeholder = task.catch(() => { });
+        writeQueue = placeholder;
+        try {
+            await task;
+        }
+        catch (error) {
+            logger?.error?.('[agentrix] Failed to persist tasks snapshot:', error);
+            throw error;
+        }
+        finally {
+            if (writeQueue === placeholder) {
+                writeQueue = Promise.resolve();
+            }
+        }
+    }
+    return {
+        loadSnapshot,
+        saveSnapshot,
+        get filePath() {
+            return filePath;
+        },
+        get directory() {
+            return storageDirectory;
+        },
+    };
+}
+//# sourceMappingURL=task-store.js.map

package/dist/core/task-store.js.map

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

package/dist/core/tasks.d.ts

@@ -0,0 +1,62 @@
+declare function getTasksSnapshot(): unknown[];
+declare function schedulePersistence(immediate?: boolean): Promise<void>;
+declare function ensureStep(task: {
+    steps?: unknown[];
+}, id: string, label?: string): unknown;
+declare function mutateTask(task: unknown, mutator: (task: unknown) => void): void;
+declare function createProgressController(task: unknown): unknown;
+declare function pruneExpiredTasks(): void;
+export declare function runTask(config: {
+    type: string;
+    title?: string;
+    metadata?: unknown;
+}, handler: (context: unknown) => Promise<unknown>): {
+    id: string;
+    task: unknown;
+};
+export declare function listTasks(): unknown[];
+declare function normaliseTimestamp(value: unknown, fallbackIso: string): {
+    iso: string;
+    changed: boolean;
+};
+declare function normaliseLogEntry(entry: unknown, fallbackIso: string): {
+    id: string;
+    message: string;
+    timestamp: string;
+} | null;
+declare function normaliseStepSnapshot(stepInput: unknown, { nowIso }: {
+    nowIso: string;
+}): {
+    step: unknown;
+    changed: boolean;
+} | null;
+declare function rehydratePersistedTask(rawTask: unknown, context: unknown): unknown;
+export declare function configureTaskPersistence({ loadSnapshot, saveSnapshot, debounceMs, restartTaskMessage, restartStepMessage, restartReason, defaultFailureMessage, logger, }?: {
+    loadSnapshot?: () => Promise<unknown>;
+    saveSnapshot?: (snapshot: unknown) => Promise<void>;
+    debounceMs?: number;
+    restartTaskMessage?: string;
+    restartStepMessage?: string;
+    restartReason?: string;
+    defaultFailureMessage?: string;
+    logger?: Console;
+}): Promise<void>;
+export declare function getPersistedTasksSnapshot(): unknown[];
+export declare function flushTaskPersistence(): Promise<void>;
+export declare function getTaskById(taskId: string): unknown;
+export declare const _internals: {
+    tasks: Map<any, any>;
+    ensureStep: typeof ensureStep;
+    mutateTask: typeof mutateTask;
+    createProgressController: typeof createProgressController;
+    pruneExpiredTasks: typeof pruneExpiredTasks;
+    COMPLETED_TASK_TTL_MS: number;
+    schedulePersistence: typeof schedulePersistence;
+    getTasksSnapshot: typeof getTasksSnapshot;
+    normaliseTimestamp: typeof normaliseTimestamp;
+    normaliseLogEntry: typeof normaliseLogEntry;
+    normaliseStepSnapshot: typeof normaliseStepSnapshot;
+    rehydratePersistedTask: typeof rehydratePersistedTask;
+};
+export {};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/core/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/core/tasks.ts"],"names":[],"mappings":"AAiCA,iBAAS,gBAAgB,cAExB;AAoBD,iBAAS,mBAAmB,CAAC,SAAS,UAAQ,iBAkD7C;AA4BD,iBAAS,UAAU,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;CAAE,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAoBpF;AAED,iBAAS,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAkBzE;AAED,iBAAS,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAwDxD;AAED,iBAAS,iBAAiB,SA2BzB;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAkFpK;AAED,wBAAgB,SAAS,cAGxB;AAED,iBAAS,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAWlG;AAED,iBAAS,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAazH;AAED,iBAAS,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAoD7H;AAED,iBAAS,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CA2H3E;AAED,wBAAsB,wBAAwB,CAAC,EAC7C,YAAY,EACZ,YAAY,EACZ,UAAgB,EAChB,kBAAmF,EACnF,kBAAmE,EACnE,aAAiC,EACjC,qBAAsC,EACtC,MAAgB,GACjB,GAAE;IACD,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;CACb,iBA+DL;AAED,wBAAgB,yBAAyB,cAExC;AAED,wBAAsB,oBAAoB,kBAEzC;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,WAMzC;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAatB,CAAC"}