@defai.digital/contracts 13.3.0 → 13.4.0

package/dist/parallel-execution/v1/schema.d.ts.map

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

package/dist/parallel-execution/v1/schema.js

@@ -0,0 +1,489 @@
+/**
+ * Parallel Agent Execution Contracts v1
+ *
+ * Schemas for executing multiple agents concurrently with DAG-based
+ * dependency management and result aggregation.
+ *
+ * This enables orchestrated multi-agent workflows where independent
+ * agents execute in parallel while respecting dependencies.
+ */
+import { z } from 'zod';
+import { LIMIT_PARALLEL_CONCURRENT, TIMEOUT_WORKFLOW_STEP, TIMEOUT_WORKFLOW_MAX, PRIORITY_DEFAULT, PRIORITY_MAX, } from '../../constants.js';
+// ============================================================================
+// Failure Strategy & Result Aggregation
+// ============================================================================
+/**
+ * Strategy for handling failures in parallel execution
+ *
+ * - failFast: Cancel remaining tasks and fail immediately on first error
+ * - failSafe: Wait for all tasks to complete, then report all errors
+ * - continueOnError: Log errors but continue execution, exclude failed from results
+ */
+export const AgentFailureStrategySchema = z.enum([
+    'failFast',
+    'failSafe',
+    'continueOnError',
+]);
+/**
+ * Strategy for aggregating results from parallel agent execution
+ *
+ * - merge: Combine all outputs into a single object (INV-APE-004)
+ * - list: Return array of individual agent results
+ * - firstSuccess: Return first successful result
+ * - custom: Use custom aggregation function
+ */
+export const ResultAggregationStrategySchema = z.enum([
+    'merge',
+    'list',
+    'firstSuccess',
+    'custom',
+]);
+// ============================================================================
+// Configuration Schemas
+// ============================================================================
+/**
+ * Configuration for parallel agent execution
+ *
+ * Invariants:
+ * - INV-APE-001: Concurrent agents MUST NOT exceed maxConcurrentAgents
+ * - INV-APE-005: Timeout enforced per-agent independently
+ */
+export const AgentParallelExecutionConfigSchema = z.object({
+    /**
+     * Maximum number of agents to execute concurrently
+     * INV-APE-001: Enforced during execution
+     */
+    maxConcurrentAgents: z.number()
+        .int()
+        .min(1)
+        .max(10)
+        .default(LIMIT_PARALLEL_CONCURRENT),
+    /**
+     * Timeout per agent in milliseconds
+     * INV-APE-005: Each agent has independent timeout
+     */
+    agentTimeout: z.number()
+        .int()
+        .min(1000)
+        .max(TIMEOUT_WORKFLOW_MAX)
+        .default(TIMEOUT_WORKFLOW_STEP),
+    /**
+     * Timeout for entire parallel group in milliseconds
+     */
+    groupTimeout: z.number()
+        .int()
+        .min(1000)
+        .max(TIMEOUT_WORKFLOW_MAX)
+        .optional(),
+    /**
+     * Strategy when one agent fails
+     */
+    failureStrategy: AgentFailureStrategySchema.default('failSafe'),
+    /**
+     * Strategy for combining results
+     * INV-APE-004: Result aggregation follows configured strategy
+     */
+    resultAggregation: ResultAggregationStrategySchema.default('merge'),
+    /**
+     * Whether to enable checkpointing during parallel execution
+     */
+    enableCheckpointing: z.boolean().default(false),
+    /**
+     * Whether to share context between agents (read-only)
+     * INV-APE-003: Shared context immutable during parallel execution
+     */
+    shareContext: z.boolean().default(true),
+});
+// ============================================================================
+// Task Schemas
+// ============================================================================
+/**
+ * A single task in a parallel agent execution
+ *
+ * Invariants:
+ * - INV-APE-002: Dependencies honored (DAG ordering)
+ */
+export const AgentParallelTaskSchema = z.object({
+    /**
+     * Unique identifier for this task
+     */
+    taskId: z.string().uuid(),
+    /**
+     * Agent ID to execute
+     */
+    agentId: z.string().min(1).max(50),
+    /**
+     * Input data for the agent
+     */
+    input: z.unknown(),
+    /**
+     * Task IDs this task depends on (must complete first)
+     * INV-APE-002: Forms DAG for execution ordering
+     */
+    dependencies: z.array(z.string().uuid()).default([]),
+    /**
+     * Execution priority (higher = earlier in same layer)
+     */
+    priority: z.number().int().min(0).max(PRIORITY_MAX).default(PRIORITY_DEFAULT),
+    /**
+     * Optional timeout override for this specific task
+     */
+    timeout: z.number().int().min(1000).max(TIMEOUT_WORKFLOW_MAX).optional(),
+    /**
+     * Optional provider override for this task
+     */
+    provider: z.string().max(50).optional(),
+    /**
+     * Optional model override for this task
+     */
+    model: z.string().max(100).optional(),
+    /**
+     * Task metadata for tracking/debugging
+     */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// ============================================================================
+// Result Schemas
+// ============================================================================
+/**
+ * Status of a parallel task execution
+ */
+export const AgentParallelTaskStatusSchema = z.enum([
+    'pending',
+    'queued',
+    'running',
+    'completed',
+    'failed',
+    'cancelled',
+    'timeout',
+    'skipped',
+]);
+/**
+ * Result of a single task in parallel execution
+ */
+export const AgentParallelTaskResultSchema = z.object({
+    /**
+     * Task identifier
+     */
+    taskId: z.string().uuid(),
+    /**
+     * Agent that was executed
+     */
+    agentId: z.string(),
+    /**
+     * Final status
+     */
+    status: AgentParallelTaskStatusSchema,
+    /**
+     * Whether execution succeeded
+     */
+    success: z.boolean(),
+    /**
+     * Output from the agent
+     */
+    output: z.unknown().optional(),
+    /**
+     * Error message if failed
+     */
+    error: z.string().optional(),
+    /**
+     * Error code if failed
+     */
+    errorCode: z.string().optional(),
+    /**
+     * Execution duration in milliseconds
+     */
+    durationMs: z.number().int().min(0),
+    /**
+     * Number of retries attempted
+     */
+    retryCount: z.number().int().min(0).default(0),
+    /**
+     * Execution layer in DAG
+     */
+    layer: z.number().int().min(0).optional(),
+    /**
+     * Start timestamp
+     */
+    startedAt: z.string().datetime().optional(),
+    /**
+     * Completion timestamp
+     */
+    completedAt: z.string().datetime().optional(),
+});
+/**
+ * Result of parallel agent group execution
+ */
+export const AgentParallelGroupResultSchema = z.object({
+    /**
+     * Unique identifier for this execution group
+     */
+    groupId: z.string().uuid(),
+    /**
+     * Results for each task
+     */
+    taskResults: z.array(AgentParallelTaskResultSchema),
+    /**
+     * Aggregated output based on strategy
+     */
+    aggregatedOutput: z.unknown().optional(),
+    /**
+     * Whether all tasks succeeded
+     */
+    allSucceeded: z.boolean(),
+    /**
+     * List of failed task IDs
+     */
+    failedTasks: z.array(z.string().uuid()),
+    /**
+     * List of cancelled task IDs
+     */
+    cancelledTasks: z.array(z.string().uuid()).optional(),
+    /**
+     * List of skipped task IDs (due to dependency failures)
+     */
+    skippedTasks: z.array(z.string().uuid()).optional(),
+    /**
+     * Total execution duration in milliseconds
+     */
+    totalDurationMs: z.number().int().min(0),
+    /**
+     * Number of tasks executed
+     */
+    tasksExecuted: z.number().int().min(0),
+    /**
+     * Number of tasks skipped
+     */
+    tasksSkipped: z.number().int().min(0).default(0),
+    /**
+     * Number of execution layers in DAG
+     */
+    layerCount: z.number().int().min(0).optional(),
+    /**
+     * Maximum concurrent tasks reached
+     */
+    peakConcurrency: z.number().int().min(0).optional(),
+    /**
+     * Configuration used
+     */
+    config: AgentParallelExecutionConfigSchema.optional(),
+    /**
+     * Start timestamp
+     */
+    startedAt: z.string().datetime(),
+    /**
+     * Completion timestamp
+     */
+    completedAt: z.string().datetime(),
+});
+// ============================================================================
+// Execution Plan Schemas
+// ============================================================================
+/**
+ * Execution layer in DAG - tasks at same level can run in parallel
+ */
+export const ExecutionLayerSchema = z.object({
+    /**
+     * Layer index (0 = first layer, no dependencies)
+     */
+    index: z.number().int().min(0),
+    /**
+     * Tasks in this layer (can run in parallel)
+     */
+    tasks: z.array(AgentParallelTaskSchema),
+    /**
+     * Total tasks in layer
+     */
+    taskCount: z.number().int().min(0),
+});
+/**
+ * Execution plan built from DAG analysis
+ */
+export const ExecutionPlanSchema = z.object({
+    /**
+     * Unique plan identifier
+     */
+    planId: z.string().uuid(),
+    /**
+     * Execution layers (in order)
+     */
+    layers: z.array(ExecutionLayerSchema),
+    /**
+     * Total tasks in plan
+     */
+    totalTasks: z.number().int().min(0),
+    /**
+     * Total layers in plan
+     */
+    totalLayers: z.number().int().min(0),
+    /**
+     * Maximum parallelism (max tasks in any layer)
+     */
+    maxParallelism: z.number().int().min(0),
+    /**
+     * Whether plan has any circular dependencies (invalid)
+     */
+    hasCycles: z.boolean(),
+    /**
+     * Plan creation timestamp
+     */
+    createdAt: z.string().datetime(),
+});
+// ============================================================================
+// Request/Response Schemas
+// ============================================================================
+/**
+ * Request to execute agents in parallel
+ */
+export const ParallelExecutionRequestSchema = z.object({
+    /**
+     * Tasks to execute
+     */
+    tasks: z.array(AgentParallelTaskSchema).min(1).max(100),
+    /**
+     * Execution configuration
+     */
+    config: AgentParallelExecutionConfigSchema.optional(),
+    /**
+     * Shared context for all agents (read-only)
+     * INV-APE-003: Immutable during execution
+     */
+    sharedContext: z.record(z.string(), z.unknown()).optional(),
+    /**
+     * Session ID for tracking
+     */
+    sessionId: z.string().uuid().optional(),
+    /**
+     * Idempotency key for safe retries
+     */
+    idempotencyKey: z.string().uuid().optional(),
+});
+/**
+ * Request to preview execution plan without executing
+ */
+export const PreviewPlanRequestSchema = z.object({
+    /**
+     * Tasks to plan
+     */
+    tasks: z.array(AgentParallelTaskSchema).min(1).max(100),
+    /**
+     * Optional config to apply
+     */
+    config: AgentParallelExecutionConfigSchema.optional(),
+});
+// ============================================================================
+// Context Schemas
+// ============================================================================
+/**
+ * Shared context passed to all parallel agents
+ * INV-APE-003: This context is immutable during execution
+ */
+export const SharedContextSchema = z.object({
+    /**
+     * Context data (immutable during execution)
+     */
+    data: z.record(z.string(), z.unknown()),
+    /**
+     * When context was created
+     */
+    createdAt: z.string().datetime(),
+    /**
+     * Context version for debugging
+     */
+    version: z.string().default('1'),
+});
+// ============================================================================
+// Error Codes
+// ============================================================================
+export const ParallelExecutionErrorCodes = {
+    /** Circular dependency detected in task graph */
+    CIRCULAR_DEPENDENCY: 'PARALLEL_CIRCULAR_DEPENDENCY',
+    /** Maximum concurrency exceeded */
+    CONCURRENCY_EXCEEDED: 'PARALLEL_CONCURRENCY_EXCEEDED',
+    /** Group timeout exceeded */
+    GROUP_TIMEOUT: 'PARALLEL_GROUP_TIMEOUT',
+    /** Task timeout exceeded */
+    TASK_TIMEOUT: 'PARALLEL_TASK_TIMEOUT',
+    /** Task execution failed */
+    TASK_FAILED: 'PARALLEL_TASK_FAILED',
+    /** Agent not found */
+    AGENT_NOT_FOUND: 'PARALLEL_AGENT_NOT_FOUND',
+    /** Dependency failed, task skipped */
+    DEPENDENCY_FAILED: 'PARALLEL_DEPENDENCY_FAILED',
+    /** Execution cancelled */
+    CANCELLED: 'PARALLEL_CANCELLED',
+    /** Invalid execution plan */
+    INVALID_PLAN: 'PARALLEL_INVALID_PLAN',
+    /** Context modification attempted */
+    CONTEXT_MUTATION: 'PARALLEL_CONTEXT_MUTATION',
+};
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Validates parallel execution configuration
+ */
+export function validateAgentParallelExecutionConfig(data) {
+    return AgentParallelExecutionConfigSchema.parse(data);
+}
+/**
+ * Safely validates parallel execution configuration
+ */
+export function safeValidateAgentParallelExecutionConfig(data) {
+    const result = AgentParallelExecutionConfigSchema.safeParse(data);
+    if (result.success)
+        return { success: true, data: result.data };
+    return { success: false, error: result.error };
+}
+/**
+ * Validates a parallel task
+ */
+export function validateAgentParallelTask(data) {
+    return AgentParallelTaskSchema.parse(data);
+}
+/**
+ * Validates parallel execution request
+ */
+export function validateParallelExecutionRequest(data) {
+    return ParallelExecutionRequestSchema.parse(data);
+}
+/**
+ * Validates execution plan
+ */
+export function validateExecutionPlan(data) {
+    return ExecutionPlanSchema.parse(data);
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Creates default parallel execution configuration
+ */
+export function createDefaultAgentParallelExecutionConfig() {
+    return AgentParallelExecutionConfigSchema.parse({});
+}
+/**
+ * Creates a parallel task with defaults
+ */
+export function createAgentParallelTask(agentId, input, options) {
+    return AgentParallelTaskSchema.parse({
+        taskId: crypto.randomUUID(),
+        agentId,
+        input,
+        ...options,
+    });
+}
+/**
+ * Creates a shared context with immutability marker
+ * INV-APE-003: Shared context is frozen for immutability during parallel execution
+ */
+export function createSharedContext(data) {
+    const context = SharedContextSchema.parse({
+        data: { ...data },
+        createdAt: new Date().toISOString(),
+    });
+    // Freeze data after parsing to ensure immutability
+    Object.freeze(context.data);
+    return Object.freeze(context);
+}
+//# sourceMappingURL=schema.js.map

package/dist/parallel-execution/v1/schema.js.map

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

package/dist/provider/v1/port.d.ts

@@ -47,8 +47,8 @@ export declare const ProviderRequestSchema: z.ZodObject<{
         content: string;
     }[];
     model: string;
-    maxTokens?: number | undefined;
     systemPrompt?: string | undefined;
+    maxTokens?: number | undefined;
     temperature?: number | undefined;
 }, {
     requestId: string;
@@ -57,8 +57,8 @@ export declare const ProviderRequestSchema: z.ZodObject<{
         content: string;
     }[];
     model: string;
-    maxTokens?: number | undefined;
     systemPrompt?: string | undefined;
+    maxTokens?: number | undefined;
     temperature?: number | undefined;
 }>;
 /**

package/dist/research/v1/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Research Domain Contracts v1
+ */
+export * from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/research/v1/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/research/v1/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}

package/dist/research/v1/index.js

@@ -0,0 +1,5 @@
+/**
+ * Research Domain Contracts v1
+ */
+export * from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/research/v1/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/research/v1/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC"}