@ddse/acm-runtime 0.5.0

package/dist/src/checkpoint.js

@@ -0,0 +1,200 @@
+/**
+ * Schema version for checkpoint compatibility
+ */
+export const CHECKPOINT_VERSION = '1.0.0';
+/**
+ * Create a checkpoint from current execution state
+ */
+export function createCheckpoint(runId, state) {
+    const id = `checkpoint-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    return {
+        id,
+        runId,
+        ts: Date.now(),
+        version: CHECKPOINT_VERSION,
+        state: {
+            ...state,
+            // Ensure executed is a plain array (not Set)
+            executed: Array.isArray(state.executed) ? state.executed : Array.from(state.executed),
+            // Deep clone to prevent mutation
+            outputs: JSON.parse(JSON.stringify(state.outputs)),
+            executionRecords: state.executionRecords
+                ? JSON.parse(JSON.stringify(state.executionRecords))
+                : undefined,
+            ledger: JSON.parse(JSON.stringify(state.ledger)),
+        },
+    };
+}
+/**
+ * Validate checkpoint compatibility
+ */
+export function validateCheckpoint(checkpoint) {
+    if (!checkpoint.version) {
+        console.warn('Checkpoint missing version field');
+        return false;
+    }
+    const [major] = checkpoint.version.split('.');
+    const [currentMajor] = CHECKPOINT_VERSION.split('.');
+    if (major !== currentMajor) {
+        console.error(`Checkpoint version ${checkpoint.version} incompatible with current version ${CHECKPOINT_VERSION}`);
+        return false;
+    }
+    // Validate required fields
+    if (!checkpoint.id || !checkpoint.runId || !checkpoint.state) {
+        console.error('Checkpoint missing required fields');
+        return false;
+    }
+    const { state } = checkpoint;
+    if (!state.goal || !state.context || !state.plan || !state.ledger) {
+        console.error('Checkpoint state missing required fields');
+        return false;
+    }
+    return true;
+}
+/**
+ * In-memory checkpoint store (for testing and simple use cases)
+ */
+export class MemoryCheckpointStore {
+    checkpoints = new Map();
+    async put(runId, checkpoint) {
+        if (!this.checkpoints.has(runId)) {
+            this.checkpoints.set(runId, []);
+        }
+        this.checkpoints.get(runId).push(checkpoint);
+    }
+    async get(runId, checkpointId) {
+        const checkpoints = this.checkpoints.get(runId);
+        if (!checkpoints || checkpoints.length === 0) {
+            return null;
+        }
+        if (checkpointId) {
+            return checkpoints.find(c => c.id === checkpointId) || null;
+        }
+        // Return latest checkpoint
+        return checkpoints[checkpoints.length - 1];
+    }
+    async list(runId) {
+        const checkpoints = this.checkpoints.get(runId) || [];
+        return checkpoints.map(c => ({
+            id: c.id,
+            runId: c.runId,
+            ts: c.ts,
+            version: c.version,
+            tasksCompleted: c.state.executed.length,
+        }));
+    }
+    async prune(runId, keepLast) {
+        const checkpoints = this.checkpoints.get(runId);
+        if (!checkpoints || checkpoints.length <= keepLast) {
+            return;
+        }
+        // Sort by timestamp and keep only the last N
+        checkpoints.sort((a, b) => a.ts - b.ts);
+        this.checkpoints.set(runId, checkpoints.slice(-keepLast));
+    }
+    /**
+     * Clear all checkpoints (for testing)
+     */
+    clear() {
+        this.checkpoints.clear();
+    }
+}
+/**
+ * File-based checkpoint store
+ */
+export class FileCheckpointStore {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async put(runId, checkpoint) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const dirPath = path.join(this.basePath, runId);
+        await fs.mkdir(dirPath, { recursive: true });
+        const filePath = path.join(dirPath, `${checkpoint.id}.json`);
+        await fs.writeFile(filePath, JSON.stringify(checkpoint, null, 2), 'utf-8');
+    }
+    async get(runId, checkpointId) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const dirPath = path.join(this.basePath, runId);
+        try {
+            if (checkpointId) {
+                const filePath = path.join(dirPath, `${checkpointId}.json`);
+                const content = await fs.readFile(filePath, 'utf-8');
+                return JSON.parse(content);
+            }
+            // Get latest checkpoint
+            const files = await fs.readdir(dirPath);
+            const jsonFiles = files.filter(f => f.endsWith('.json'));
+            if (jsonFiles.length === 0) {
+                return null;
+            }
+            // Sort by timestamp in filename
+            jsonFiles.sort();
+            const latestFile = jsonFiles[jsonFiles.length - 1];
+            const filePath = path.join(dirPath, latestFile);
+            const content = await fs.readFile(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return null;
+            }
+            throw err;
+        }
+    }
+    async list(runId) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const dirPath = path.join(this.basePath, runId);
+        try {
+            const files = await fs.readdir(dirPath);
+            const jsonFiles = files.filter(f => f.endsWith('.json'));
+            const metadata = [];
+            for (const file of jsonFiles) {
+                const filePath = path.join(dirPath, file);
+                const content = await fs.readFile(filePath, 'utf-8');
+                const checkpoint = JSON.parse(content);
+                metadata.push({
+                    id: checkpoint.id,
+                    runId: checkpoint.runId,
+                    ts: checkpoint.ts,
+                    version: checkpoint.version,
+                    tasksCompleted: checkpoint.state.executed.length,
+                });
+            }
+            return metadata.sort((a, b) => a.ts - b.ts);
+        }
+        catch (err) {
+            if (err.code === 'ENOENT') {
+                return [];
+            }
+            throw err;
+        }
+    }
+    async prune(runId, keepLast) {
+        const fs = await import('fs/promises');
+        const path = await import('path');
+        const dirPath = path.join(this.basePath, runId);
+        try {
+            const metadata = await this.list(runId);
+            if (metadata.length <= keepLast) {
+                return;
+            }
+            // Delete oldest checkpoints
+            const toDelete = metadata.slice(0, metadata.length - keepLast);
+            for (const meta of toDelete) {
+                const filePath = path.join(dirPath, `${meta.id}.json`);
+                await fs.unlink(filePath);
+            }
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
+            }
+        }
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/src/checkpoint.js.map

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

package/dist/src/execution-transcript.d.ts

@@ -0,0 +1,30 @@
+import type { StreamSink } from '@ddse/acm-sdk';
+import type { MemoryLedger } from './ledger.js';
+import type { TaskNarrative } from './executor.js';
+export type ExecutionTranscriptEvent = {
+    type: 'nucleus-reasoning';
+    taskId?: string;
+    planId?: string;
+    reasoning: string;
+} | {
+    type: 'task-completed';
+    taskId: string;
+    output: any;
+    narrative?: TaskNarrative;
+} | {
+    type: 'goal-summary';
+    goalId: string;
+    planId: string;
+    summary?: string;
+};
+export declare class ExecutionTranscript {
+    private stream?;
+    private onEvent?;
+    constructor(options?: {
+        stream?: StreamSink;
+        onEvent?: (event: ExecutionTranscriptEvent) => void;
+    });
+    attach(ledger: MemoryLedger): void;
+    private handleEntry;
+}
+//# sourceMappingURL=execution-transcript.d.ts.map

package/dist/src/execution-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-transcript.d.ts","sourceRoot":"","sources":["../../src/execution-transcript.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,wBAAwB,GAChC;IACE,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAQN,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,OAAO,CAAC,CAA4C;gBAEhD,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAA;KAAO;IAKtG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAmBlC,OAAO,CAAC,WAAW;CASpB"}

package/dist/src/execution-transcript.js

@@ -0,0 +1,70 @@
+export class ExecutionTranscript {
+    stream;
+    onEvent;
+    constructor(options = {}) {
+        this.stream = options.stream;
+        this.onEvent = options.onEvent;
+    }
+    attach(ledger) {
+        const target = ledger;
+        if (!target.__executionTranscriptHandlers) {
+            target.__executionTranscriptHandlers = [];
+            const originalAppend = ledger.append.bind(ledger);
+            ledger.append = (type, details, computeDigest = true) => {
+                const entry = originalAppend(type, details, computeDigest);
+                for (const handler of target.__executionTranscriptHandlers) {
+                    handler(entry);
+                }
+                return entry;
+            };
+        }
+        target.__executionTranscriptHandlers.push(entry => this.handleEntry(entry));
+    }
+    handleEntry(entry) {
+        const event = mapLedgerEntry(entry);
+        if (!event) {
+            return;
+        }
+        this.stream?.emit('transcript', event);
+        this.onEvent?.(event);
+    }
+}
+function mapLedgerEntry(entry) {
+    switch (entry.type) {
+        case 'NUCLEUS_INFERENCE': {
+            const reasoning = typeof entry.details?.reasoning === 'string' ? entry.details.reasoning.trim() : '';
+            if (!reasoning) {
+                return undefined;
+            }
+            return {
+                type: 'nucleus-reasoning',
+                taskId: entry.details?.nucleus?.taskId,
+                planId: entry.details?.nucleus?.planId,
+                reasoning,
+            };
+        }
+        case 'TASK_END': {
+            const taskId = entry.details?.taskId;
+            if (!taskId) {
+                return undefined;
+            }
+            return {
+                type: 'task-completed',
+                taskId,
+                output: entry.details?.output,
+                narrative: entry.details?.narrative,
+            };
+        }
+        case 'GOAL_SUMMARY': {
+            return {
+                type: 'goal-summary',
+                goalId: entry.details?.goalId,
+                planId: entry.details?.planId,
+                summary: entry.details?.summary,
+            };
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=execution-transcript.js.map

package/dist/src/execution-transcript.js.map

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

package/dist/src/executor.d.ts

@@ -0,0 +1,49 @@
+import { type CapabilityRegistry, type Context, type Goal, type LedgerEntry, ExternalContextProviderAdapter, type NucleusConfig, type NucleusFactory, type PostcheckResult, type Plan, type PolicyEngine, type StreamSink, type ToolRegistry } from '@ddse/acm-sdk';
+import { MemoryLedger } from './ledger.js';
+export type TaskNarrative = {
+    reasoning?: string[];
+    postcheck?: {
+        status: PostcheckResult['status'];
+        reason?: string;
+    };
+};
+export type TaskExecutionRecord = {
+    output: any;
+    narrative?: TaskNarrative;
+};
+export type ExecutePlanOptions = {
+    goal: Goal;
+    context: Context;
+    plan: Plan;
+    capabilityRegistry: CapabilityRegistry;
+    toolRegistry: ToolRegistry;
+    policy?: PolicyEngine;
+    verify?: (taskId: string, output: any, expressions: string[]) => Promise<boolean>;
+    stream?: StreamSink;
+    ledger?: MemoryLedger;
+    nucleusFactory: NucleusFactory;
+    nucleusConfig: {
+        llmCall: NucleusConfig['llmCall'];
+        hooks?: NucleusConfig['hooks'];
+        allowedTools?: string[];
+    };
+    contextProvider?: ExternalContextProviderAdapter;
+};
+export type ExecutePlanResult = {
+    outputsByTask: Record<string, TaskExecutionRecord>;
+    ledger: readonly LedgerEntry[];
+    goalSummary?: string;
+};
+export declare function executePlan(options: ExecutePlanOptions): Promise<ExecutePlanResult>;
+export declare function buildTaskNarrative(ledger: MemoryLedger, baselineIndex: number, taskId: string, postcheck: PostcheckResult): TaskNarrative | undefined;
+export declare function synthesizeGoalSummary(options: {
+    goal: Goal;
+    plan: Plan;
+    executionRecords: Record<string, TaskExecutionRecord>;
+    context: Context;
+    nucleusFactory: NucleusFactory;
+    nucleusConfig: ExecutePlanOptions['nucleusConfig'];
+    ledger: MemoryLedger;
+    stream?: StreamSink;
+}): Promise<string | undefined>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/src/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/executor.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,WAAW,EAChB,8BAA8B,EAC9B,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,IAAI,EACT,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE;QACV,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,GAAG,CAAC;IACZ,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE;QACb,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;QAClC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,eAAe,CAAC,EAAE,8BAA8B,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACnD,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiTzF;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,eAAe,GACzB,aAAa,GAAG,SAAS,CA0B3B;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2D9B"}