@defai.digital/agent-domain 13.0.3

package/dist/stub-checkpoint.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Stub Checkpoint Implementation
+ *
+ * Provides minimal checkpoint storage and manager for when no real
+ * implementation is provided via AgentDomainConfig factories.
+ *
+ * Uses in-memory storage (data lost between invocations).
+ * For production use, provide real implementations via config.
+ */
+import type { CheckpointStorageFactory, CheckpointManagerFactory } from './types.js';
+/**
+ * Stub checkpoint storage factory
+ */
+export declare const stubCheckpointStorageFactory: CheckpointStorageFactory;
+/**
+ * Stub checkpoint manager factory
+ */
+export declare const stubCheckpointManagerFactory: CheckpointManagerFactory;
+/**
+ * Reset the warning flag (for testing)
+ */
+export declare function resetCheckpointStubWarning(): void;
+//# sourceMappingURL=stub-checkpoint.d.ts.map

package/dist/stub-checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-checkpoint.d.ts","sourceRoot":"","sources":["../src/stub-checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAIV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AA0IpB;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,wBAS1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,wBAO1C,CAAC;AAEF;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD"}

package/dist/stub-checkpoint.js

@@ -0,0 +1,137 @@
+/**
+ * Stub Checkpoint Implementation
+ *
+ * Provides minimal checkpoint storage and manager for when no real
+ * implementation is provided via AgentDomainConfig factories.
+ *
+ * Uses in-memory storage (data lost between invocations).
+ * For production use, provide real implementations via config.
+ */
+let _warnedOnce = false;
+/**
+ * In-memory checkpoint storage (stub)
+ */
+function createInMemoryCheckpointStorage() {
+    const checkpoints = new Map();
+    return {
+        async save(checkpoint) {
+            checkpoints.set(checkpoint.checkpointId, { ...checkpoint });
+        },
+        async load(checkpointId) {
+            return checkpoints.get(checkpointId) ?? null;
+        },
+        async loadLatest(agentId, sessionId) {
+            let latest = null;
+            let latestTime = 0;
+            for (const cp of checkpoints.values()) {
+                if (cp.agentId !== agentId)
+                    continue;
+                if (sessionId !== undefined && cp.sessionId !== sessionId)
+                    continue;
+                const time = new Date(cp.createdAt).getTime();
+                if (time > latestTime) {
+                    latestTime = time;
+                    latest = cp;
+                }
+            }
+            return latest;
+        },
+        async list(agentId, sessionId) {
+            const results = [];
+            for (const cp of checkpoints.values()) {
+                if (cp.agentId !== agentId)
+                    continue;
+                if (sessionId !== undefined && cp.sessionId !== sessionId)
+                    continue;
+                results.push({ ...cp });
+            }
+            return results.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        },
+        async delete(checkpointId) {
+            return checkpoints.delete(checkpointId);
+        },
+        async deleteExpired() {
+            const now = Date.now();
+            let count = 0;
+            for (const [id, cp] of checkpoints.entries()) {
+                if (cp.expiresAt && new Date(cp.expiresAt).getTime() < now) {
+                    checkpoints.delete(id);
+                    count++;
+                }
+            }
+            return count;
+        },
+    };
+}
+/**
+ * Creates a stub checkpoint manager
+ */
+function createStubCheckpointManager(agentId, sessionId, storage, config) {
+    return {
+        getConfig() {
+            return { ...config };
+        },
+        shouldCheckpoint(stepIndex) {
+            if (!config.enabled)
+                return false;
+            return (stepIndex + 1) % config.intervalSteps === 0;
+        },
+        async createCheckpoint(stepIndex, stepId, previousOutputs, metadata) {
+            const now = new Date();
+            const checkpoint = {
+                checkpointId: crypto.randomUUID(),
+                agentId,
+                sessionId,
+                stepIndex,
+                stepId,
+                previousOutputs: { ...previousOutputs },
+                metadata,
+                createdAt: now.toISOString(),
+                expiresAt: config.retentionHours
+                    ? new Date(now.getTime() + config.retentionHours * 3600 * 1000).toISOString()
+                    : undefined,
+            };
+            await storage.save(checkpoint);
+            return checkpoint;
+        },
+        async getLatestCheckpoint() {
+            return storage.loadLatest(agentId, sessionId);
+        },
+        async getResumeContext(checkpointId) {
+            const checkpoint = await storage.load(checkpointId);
+            if (!checkpoint)
+                return null;
+            return {
+                startFromStep: checkpoint.stepIndex + 1,
+                previousOutputs: { ...checkpoint.previousOutputs },
+            };
+        },
+        async cleanup() {
+            return storage.deleteExpired();
+        },
+    };
+}
+/**
+ * Stub checkpoint storage factory
+ */
+export const stubCheckpointStorageFactory = () => {
+    if (!_warnedOnce) {
+        console.warn('[agent-domain] Using stub checkpoint storage. ' +
+            'For persistent checkpoints, provide checkpointStorageFactory in config.');
+        _warnedOnce = true;
+    }
+    return createInMemoryCheckpointStorage();
+};
+/**
+ * Stub checkpoint manager factory
+ */
+export const stubCheckpointManagerFactory = (agentId, sessionId, storage, config) => {
+    return createStubCheckpointManager(agentId, sessionId, storage, config);
+};
+/**
+ * Reset the warning flag (for testing)
+ */
+export function resetCheckpointStubWarning() {
+    _warnedOnce = false;
+}
+//# sourceMappingURL=stub-checkpoint.js.map

package/dist/stub-checkpoint.js.map

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

package/dist/stub-delegation-tracker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Stub Delegation Tracker Implementation
+ *
+ * Provides a minimal delegation tracker for when no real implementation
+ * is provided via AgentDomainConfig.delegationTrackerFactory.
+ *
+ * This stub:
+ * - Logs a warning on first use
+ * - Allows delegations within depth limits
+ * - Tracks basic context and history
+ *
+ * For production use, provide a real implementation via config.
+ */
+import type { DelegationTrackerFactory } from './types.js';
+/**
+ * Stub delegation tracker factory
+ *
+ * Use this as a fallback when no factory is provided in config.
+ */
+export declare const stubDelegationTrackerFactory: DelegationTrackerFactory;
+/**
+ * Reset the warning flag (for testing)
+ */
+export declare function resetStubWarning(): void;
+//# sourceMappingURL=stub-delegation-tracker.d.ts.map

package/dist/stub-delegation-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-delegation-tracker.d.ts","sourceRoot":"","sources":["../src/stub-delegation-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAYH,OAAO,KAAK,EAAyB,wBAAwB,EAAE,MAAM,YAAY,CAAC;AA2HlF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,wBACd,CAAC;AAE9B;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/stub-delegation-tracker.js

@@ -0,0 +1,118 @@
+/**
+ * Stub Delegation Tracker Implementation
+ *
+ * Provides a minimal delegation tracker for when no real implementation
+ * is provided via AgentDomainConfig.delegationTrackerFactory.
+ *
+ * This stub:
+ * - Logs a warning on first use
+ * - Allows delegations within depth limits
+ * - Tracks basic context and history
+ *
+ * For production use, provide a real implementation via config.
+ */
+import { createRootDelegationContext, DelegationErrorCodes, } from '@defai.digital/contracts';
+let _warnedOnce = false;
+/**
+ * Creates a stub delegation tracker
+ *
+ * This is used when no delegationTrackerFactory is provided in config.
+ * It provides basic functionality but logs a warning.
+ */
+function createStubDelegationTracker(agentId, parentContext, maxDepth) {
+    // Warn once about stub usage
+    if (!_warnedOnce) {
+        console.warn('[agent-domain] Using stub delegation tracker. ' +
+            'For full delegation support, provide delegationTrackerFactory in AgentDomainConfig.');
+        _warnedOnce = true;
+    }
+    // Initialize context
+    let context;
+    if (parentContext) {
+        // Create child context
+        context = {
+            ...parentContext,
+            currentDepth: parentContext.currentDepth + 1,
+            delegationChain: [...parentContext.delegationChain, agentId],
+        };
+    }
+    else {
+        // Create root context
+        context = createRootDelegationContext(agentId, crypto.randomUUID(), maxDepth);
+    }
+    const delegationHistory = [];
+    return {
+        getContext() {
+            return { ...context };
+        },
+        canDelegate(toAgentId) {
+            // INV-DT-001: Check depth limit
+            if (context.currentDepth >= context.maxDepth) {
+                return {
+                    allowed: false,
+                    reason: DelegationErrorCodes.MAX_DEPTH_EXCEEDED,
+                    message: `Maximum delegation depth ${context.maxDepth} reached`,
+                };
+            }
+            // INV-DT-002: Check for circular delegation
+            if (context.delegationChain.includes(toAgentId)) {
+                return {
+                    allowed: false,
+                    reason: DelegationErrorCodes.CIRCULAR_DELEGATION,
+                    message: `Cannot delegate to ${toAgentId} - already in delegation chain`,
+                };
+            }
+            return {
+                allowed: true,
+                reason: 'ALLOWED',
+                message: `Delegation to ${toAgentId} is allowed`,
+            };
+        },
+        createDelegationRequest(toAgentId, task, input, timeout) {
+            const checkResult = this.canDelegate(toAgentId);
+            if (!checkResult.allowed) {
+                return null;
+            }
+            return {
+                fromAgentId: agentId,
+                toAgentId,
+                task,
+                input,
+                timeout,
+                context,
+            };
+        },
+        createChildContext(toAgentId) {
+            return {
+                ...context,
+                currentDepth: context.currentDepth + 1,
+                delegationChain: [...context.delegationChain, toAgentId],
+            };
+        },
+        recordResult(result) {
+            delegationHistory.push(result);
+        },
+        getHistory() {
+            return [...delegationHistory];
+        },
+        isRoot() {
+            return context.currentDepth === 0;
+        },
+        getRemainingDepth() {
+            return context.maxDepth - context.currentDepth;
+        },
+    };
+}
+/**
+ * Stub delegation tracker factory
+ *
+ * Use this as a fallback when no factory is provided in config.
+ */
+export const stubDelegationTrackerFactory = createStubDelegationTracker;
+/**
+ * Reset the warning flag (for testing)
+ */
+export function resetStubWarning() {
+    _warnedOnce = false;
+}
+//# sourceMappingURL=stub-delegation-tracker.js.map

package/dist/stub-delegation-tracker.js.map

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

package/dist/stub-parallel-executor.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Stub Parallel Executor Implementation
+ *
+ * Provides minimal parallel execution for when no real implementation
+ * is provided via AgentDomainConfig factories.
+ *
+ * This stub executes steps sequentially (not actually in parallel).
+ * For real parallel execution, provide parallelExecutorFactory in config.
+ */
+import type { ParallelExecutorFactory } from './types.js';
+/**
+ * Stub parallel executor factory
+ */
+export declare const stubParallelExecutorFactory: ParallelExecutorFactory;
+/**
+ * Reset the warning flag (for testing)
+ */
+export declare function resetParallelStubWarning(): void;
+//# sourceMappingURL=stub-parallel-executor.d.ts.map

package/dist/stub-parallel-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-parallel-executor.d.ts","sourceRoot":"","sources":["../src/stub-parallel-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,KAAK,EAKV,uBAAuB,EACxB,MAAM,YAAY,CAAC;AA6LpB;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,uBAEzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/stub-parallel-executor.js

@@ -0,0 +1,176 @@
+/**
+ * Stub Parallel Executor Implementation
+ *
+ * Provides minimal parallel execution for when no real implementation
+ * is provided via AgentDomainConfig factories.
+ *
+ * This stub executes steps sequentially (not actually in parallel).
+ * For real parallel execution, provide parallelExecutorFactory in config.
+ */
+import { createDefaultParallelExecutionConfig, TIMEOUT_ORCHESTRATION_EXECUTION, } from '@defai.digital/contracts';
+let _warnedOnce = false;
+/**
+ * Creates a stub parallel executor that executes steps sequentially
+ */
+function createStubParallelExecutor(config = {}) {
+    if (!_warnedOnce) {
+        console.warn('[agent-domain] Using stub parallel executor (sequential execution). ' +
+            'For real parallel execution, provide parallelExecutorFactory in config.');
+        _warnedOnce = true;
+    }
+    const cfg = { ...createDefaultParallelExecutionConfig(), ...config };
+    let cancelled = false;
+    return {
+        getConfig() {
+            return { ...cfg };
+        },
+        async executeGroup(steps, executor, previousOutputs = {}) {
+            const startTime = Date.now();
+            const stepResults = [];
+            const outputs = { ...previousOutputs };
+            let failedCount = 0;
+            let cancelledCount = 0;
+            // Build execution layers (respecting dependencies)
+            const layers = this.buildExecutionLayers(steps);
+            // Execute layers sequentially (stub doesn't do real parallelism)
+            for (const layer of layers) {
+                if (cancelled) {
+                    // Mark remaining steps as cancelled
+                    for (const step of layer) {
+                        stepResults.push({
+                            stepId: step.stepId,
+                            success: false,
+                            cancelled: true,
+                            durationMs: 0,
+                        });
+                        cancelledCount++;
+                    }
+                    continue;
+                }
+                // Execute steps in layer sequentially
+                for (const step of layer) {
+                    if (cancelled) {
+                        stepResults.push({
+                            stepId: step.stepId,
+                            success: false,
+                            cancelled: true,
+                            durationMs: 0,
+                        });
+                        cancelledCount++;
+                        continue;
+                    }
+                    const stepStart = Date.now();
+                    // Create cancellable timeout to prevent timer leaks
+                    let timeoutId;
+                    const stepTimeoutMs = cfg.groupTimeoutMs ?? TIMEOUT_ORCHESTRATION_EXECUTION;
+                    const timeoutPromise = new Promise((_, reject) => {
+                        timeoutId = setTimeout(() => { reject(new Error('Step timed out')); }, stepTimeoutMs);
+                    });
+                    try {
+                        const output = await Promise.race([
+                            executor(step, outputs),
+                            timeoutPromise,
+                        ]);
+                        // Clean up timeout
+                        if (timeoutId !== undefined) {
+                            clearTimeout(timeoutId);
+                        }
+                        outputs[step.stepId] = output;
+                        stepResults.push({
+                            stepId: step.stepId,
+                            success: true,
+                            output,
+                            durationMs: Date.now() - stepStart,
+                        });
+                    }
+                    catch (error) {
+                        // Clean up timeout on error too
+                        if (timeoutId !== undefined) {
+                            clearTimeout(timeoutId);
+                        }
+                        const result = {
+                            stepId: step.stepId,
+                            success: false,
+                            error: error instanceof Error ? error.message : 'Unknown error',
+                            durationMs: Date.now() - stepStart,
+                        };
+                        stepResults.push(result);
+                        failedCount++;
+                        // If step is critical (not parallel) and failFast strategy, stop execution
+                        if (!step.parallel && cfg.failureStrategy === 'failFast') {
+                            cancelled = true;
+                        }
+                    }
+                }
+            }
+            return {
+                stepResults,
+                totalDurationMs: Date.now() - startTime,
+                allSucceeded: failedCount === 0 && cancelledCount === 0,
+                failedCount,
+                cancelledCount,
+            };
+        },
+        buildExecutionLayers(steps) {
+            // Simple topological sort based on dependencies
+            const layers = [];
+            const completed = new Set();
+            const remaining = [...steps];
+            // Guard against infinite loops with max iteration limit
+            const maxIterations = steps.length + 1;
+            let iterations = 0;
+            while (remaining.length > 0 && iterations < maxIterations) {
+                iterations++;
+                // Find steps with all dependencies satisfied
+                const ready = [];
+                const stillWaiting = [];
+                for (const step of remaining) {
+                    const deps = step.dependencies ?? [];
+                    if (deps.every((dep) => completed.has(dep))) {
+                        ready.push(step);
+                    }
+                    else {
+                        stillWaiting.push(step);
+                    }
+                }
+                if (ready.length === 0 && stillWaiting.length > 0) {
+                    // Circular dependency or missing dependency - execute remaining steps
+                    const unresolvableSteps = stillWaiting.map((s) => s.stepId).join(', ');
+                    console.warn(`[buildExecutionLayers] Circular or unresolvable dependencies detected. ` +
+                        `Unresolvable steps: ${unresolvableSteps}`);
+                    layers.push(stillWaiting);
+                    break;
+                }
+                if (ready.length > 0) {
+                    layers.push(ready);
+                    for (const step of ready) {
+                        completed.add(step.stepId);
+                    }
+                }
+                remaining.length = 0;
+                remaining.push(...stillWaiting);
+            }
+            if (iterations >= maxIterations) {
+                console.error(`[buildExecutionLayers] Max iterations (${maxIterations}) reached. ` +
+                    `This indicates a bug in the algorithm or malformed input.`);
+            }
+            return layers;
+        },
+        cancel() {
+            cancelled = true;
+        },
+    };
+}
+/**
+ * Stub parallel executor factory
+ */
+export const stubParallelExecutorFactory = (config) => {
+    return createStubParallelExecutor(config);
+};
+/**
+ * Reset the warning flag (for testing)
+ */
+export function resetParallelStubWarning() {
+    _warnedOnce = false;
+}
+//# sourceMappingURL=stub-parallel-executor.js.map

package/dist/stub-parallel-executor.js.map

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