groundswell 0.0.2 → 1.0.0

package/dist/types/agent.d.ts.map

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

package/dist/types/agent.js

@@ -0,0 +1,423 @@
+/**
+ * Agent configuration and override types
+ * All properties map 1:1 to Anthropic SDK
+ */
+import { z } from 'zod';
+// ========================
+// Error Code Constants
+// ========================
+/**
+ * Standard error codes for agent responses
+ *
+ * All error codes use SCREAMING_SNAKE_CASE convention.
+ *
+ * Per PRD 6.6: Use `INVALID_RESPONSE_FORMAT` for responses that
+ * don't conform to the AgentResponse schema. Validation failures
+ * should be treated as errors with this code.
+ *
+ * @see {@link AgentErrorDetails} for error details structure
+ * @see {@link createErrorResponse} for factory function
+ *
+ * @example
+ * ```ts
+ * import { AGENT_ERROR_CODES, createErrorResponse } from 'groundswell';
+ *
+ * const error = createErrorResponse(
+ *   AGENT_ERROR_CODES.VALIDATION_FAILED,
+ *   'Invalid input',
+ *   { field: 'email', value: 'not-an-email' }
+ * );
+ * ```
+ */
+export const AGENT_ERROR_CODES = {
+    /**
+     * Response not valid JSON or doesn't match AgentResponse schema
+     *
+     * Per PRD 6.6: Invalid responses must be treated as errors with this code.
+     * Use when response validation fails during parsing or schema checking.
+     */
+    INVALID_RESPONSE_FORMAT: 'INVALID_RESPONSE_FORMAT',
+    /**
+     * Input validation failed
+     *
+     * Use when the provided inputs fail validation checks (e.g., wrong type,
+     * missing required fields, out-of-range values).
+     */
+    VALIDATION_FAILED: 'VALIDATION_FAILED',
+    /**
+     * Agent execution failed
+     *
+     * Use when the agent execution fails for reasons unrelated to validation
+     * or API requests (e.g., compilation errors, runtime exceptions).
+     */
+    EXECUTION_FAILED: 'EXECUTION_FAILED',
+    /**
+     * API request to LLM provider failed
+     *
+     * Use when the HTTP request to the LLM provider fails (e.g., network errors,
+     * timeout, rate limiting, provider-side errors).
+     */
+    API_REQUEST_FAILED: 'API_REQUEST_FAILED',
+    /**
+     * Tool execution failed
+     *
+     * Use when a tool/function invocation fails during agent execution
+     * (e.g., tool not found, tool returned error, tool timeout).
+     */
+    TOOL_EXECUTION_FAILED: 'TOOL_EXECUTION_FAILED',
+    /**
+     * Internal validation or system error
+     *
+     * Use when an internal validation fails or a system error occurs.
+     * This indicates a bug in the code (e.g., factory helper produced invalid response).
+     * Non-recoverable because retrying with the same inputs will produce the same error.
+     *
+     * Per PRD 6.6: Internal validation failures should return this error code.
+     */
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    /**
+     * Invalid harness/provider configuration
+     *
+     * Use when a harness receives a configuration it cannot honour — e.g. a model
+     * provider it cannot run (ClaudeCodeHarness only runs anthropic/* per PRD §7.8).
+     * Non-recoverable: the caller must select a different harness or model, not retry.
+     */
+    CONFIG_ERROR: 'CONFIG_ERROR',
+};
+// ========================
+// Factory Functions
+// ========================
+/**
+ * Creates a success response with data and metadata.
+ *
+ * ## PRD 6.4 Compliance
+ *
+ * The returned response satisfies all PRD 6.4 requirements:
+ * - Strict JSON parseable by `JSON.parse()` (PRD 6.4.1)
+ * - No prose wrapping - pure JSON structure (PRD 6.4.2)
+ * - Consistent with AgentResponse interface (PRD 6.4.3)
+ * - Uses null instead of undefined (PRD 6.4.4)
+ *
+ * @template T - The type of the response data
+ * @param data - The response data to return
+ * @param metadata - Response metadata including agentId and timestamp
+ * @returns A success AgentResponse with status 'success', provided data, null error
+ *
+ * @example <caption>Basic success response (PRD 6.5)</caption>
+ * ```ts
+ * const response = createSuccessResponse(
+ *   { result: 'Task completed', artifacts: ['file1.ts', 'file2.ts'] },
+ *   { agentId: 'agent-abc123', timestamp: 1706140800000, duration: 1523 }
+ * );
+ *
+ * // Guaranteed to be valid JSON (PRD 6.4.1)
+ * const jsonString = JSON.stringify(response);
+ * const parsed = JSON.parse(jsonString); // Always valid
+ * ```
+ *
+ * @example <caption>Success response with execution metadata</caption>
+ * ```ts
+ * const response = createSuccessResponse(
+ *   { items: [1, 2, 3] },
+ *   {
+ *     agentId: 'agent-123',
+ *     timestamp: Date.now(),
+ *     duration: 1523,
+ *     requestId: 'req-abc123'
+ *   }
+ * );
+ * ```
+ */
+export function createSuccessResponse(data, metadata) {
+    return {
+        status: 'success',
+        data,
+        error: null,
+        metadata,
+    };
+}
+/**
+ * Creates an error response with error details.
+ *
+ * ## PRD 6.4 Compliance
+ *
+ * Per PRD 6.4.5: Failed operations must still return valid JSON with
+ * status 'error' and populated error field. This function ensures all
+ * error responses conform to the AgentResponse schema.
+ *
+ * The error code should use SCREAMING_SNAKE_CASE convention and ideally
+ * be one of the standard codes from {@link AGENT_ERROR_CODES}.
+ *
+ * @param code - Machine-readable error code (SCREAMING_SNAKE_CASE)
+ * @param message - Human-readable error message
+ * @param details - Optional additional error context (use null instead of undefined per PRD 6.4.4)
+ * @param recoverable - Whether the error is recoverable (default: false)
+ * @returns An error AgentResponse with null data, populated error field
+ *
+ * @example <caption>Error response (PRD 6.5)</caption>
+ * ```ts
+ * const response = createErrorResponse(
+ *   'EXECUTION_FAILED',
+ *   'Failed to compile TypeScript files',
+ *   {
+ *     failedFiles: ['src/index.ts'],
+ *     compilerErrors: ['TS2307: Cannot find module \\'foo\\'']
+ *   },
+ *   true
+ * );
+ * ```
+ *
+ * @example <caption>Using standard error codes</caption>
+ * ```ts
+ * import { AGENT_ERROR_CODES, createErrorResponse } from 'groundswell';
+ *
+ * const response = createErrorResponse(
+ *   AGENT_ERROR_CODES.VALIDATION_FAILED,
+ *   'Invalid input',
+ *   { field: 'email', value: 'not-an-email' },
+ *   false
+ * );
+ * ```
+ */
+export function createErrorResponse(code, message, details, recoverable = false) {
+    return {
+        status: 'error',
+        data: null,
+        error: {
+            code,
+            message,
+            details: details ?? null,
+            recoverable,
+        },
+        metadata: {
+            agentId: 'unknown',
+            timestamp: Date.now(),
+        },
+    };
+}
+/**
+ * Creates a partial response for streaming/incremental results.
+ *
+ * ## PRD 6.4 Compliance
+ *
+ * Per PRD 6.4.3: Consistent Structure - partial responses conform to
+ * the AgentResponse interface with status 'partial'.
+ *
+ * Partial responses are used for streaming or incremental results where
+ * the agent has not yet completed the full request. They contain intermediate
+ * progress data that may be updated in subsequent responses.
+ *
+ * @template T - The type of the partial response data
+ * @param data - The partial response data with progress information
+ * @returns A partial AgentResponse with status 'partial', data, null error
+ *
+ * @example <caption>Partial response (PRD 6.5)</caption>
+ * ```ts
+ * const response = createPartialResponse({
+ *   completedSteps: 3,
+ *   totalSteps: 5,
+ *   intermediateResult: { progress: 'processing file2.ts' }
+ * });
+ *
+ * // Later, send another partial response with updated progress
+ * const updatedResponse = createPartialResponse({
+ *   completedSteps: 4,
+ *   totalSteps: 5,
+ *   intermediateResult: { progress: 'processing file3.ts' }
+ * });
+ * ```
+ *
+ * @example <caption>Streaming data chunks</caption>
+ * ```ts
+ * const chunk = createPartialResponse({
+ *   chunk: 'Hello',
+ *   isComplete: false
+ * });
+ * ```
+ */
+export function createPartialResponse(data) {
+    return {
+        status: 'partial',
+        data,
+        error: null,
+        metadata: {
+            agentId: 'unknown',
+            timestamp: Date.now(),
+        },
+    };
+}
+// ========================
+// Type Guards
+// ========================
+/**
+ * Type guard for success responses.
+ * Narrows the type to SuccessResponse<T> where data is T (not null).
+ *
+ * @param response - The response to check
+ * @returns True if the response status is 'success'
+ *
+ * @example
+ * ```ts
+ * if (isSuccess(response)) {
+ *   console.log(response.data); // TypeScript knows data is T
+ * }
+ * ```
+ */
+export function isSuccess(response) {
+    return response.status === 'success';
+}
+/**
+ * Type guard for error responses.
+ * Narrows the type to ErrorResponse where error is AgentErrorDetails (not null).
+ *
+ * @param response - The response to check
+ * @returns True if the response status is 'error'
+ *
+ * @example
+ * ```ts
+ * if (isError(response)) {
+ *   console.log(response.error.code); // TypeScript knows error exists
+ * }
+ * ```
+ */
+export function isError(response) {
+    return response.status === 'error';
+}
+/**
+ * Type guard for partial responses.
+ * Narrows the type to PartialResponse<T>.
+ *
+ * @param response - The response to check
+ * @returns True if the response status is 'partial'
+ *
+ * @example
+ * ```ts
+ * if (isPartial(response)) {
+ *   console.log('Partial result:', response.data);
+ * }
+ * ```
+ */
+export function isPartial(response) {
+    return response.status === 'partial';
+}
+// ========================
+// Zod Schema Definitions
+// ========================
+/**
+ * Zod schema for AgentResponseStatus enum
+ * Validates status values: 'success' | 'error' | 'partial'
+ *
+ * @example
+ * ```ts
+ * AgentResponseStatusSchema.parse('success'); // ✓
+ * AgentResponseStatusSchema.parse('invalid'); // ✗ ZodError
+ * ```
+ */
+export const AgentResponseStatusSchema = z.enum(['success', 'error', 'partial']);
+/**
+ * Zod schema for AgentErrorDetails interface
+ * Validates error details with null-over-undefined handling
+ *
+ * Per PRD 6.4.4: Use null for absent values, not undefined
+ */
+export const AgentErrorDetailsSchema = z.object({
+    /** Machine-readable error code (SCREAMING_SNAKE_CASE) */
+    code: z.string(),
+    /** Human-readable error description */
+    message: z.string(),
+    /** Additional error context - null if no details (PRD 6.4.4) */
+    details: z.record(z.string(), z.unknown()).nullable(),
+    /** Whether the error is recoverable (can retry) */
+    recoverable: z.boolean(),
+});
+/**
+ * Zod schema for AgentResponseMetadata interface
+ * Validates response metadata including agent ID and timestamp
+ */
+export const AgentResponseMetadataSchema = z.object({
+    /** Agent identifier */
+    agentId: z.string(),
+    /** Unix timestamp in milliseconds */
+    timestamp: z.number(),
+    /** Execution duration in milliseconds (optional) */
+    duration: z.number().optional(),
+    /** Request correlation ID (optional) */
+    requestId: z.string().optional(),
+    /** Token usage from API (optional - passthrough for complex type) */
+    usage: z.unknown().optional(),
+    /** Number of tool invocations (optional) */
+    toolCalls: z.number().optional(),
+});
+/**
+ * Zod schema factory for AgentResponse<T> discriminated union
+ * Creates a schema that validates responses based on status discriminator
+ *
+ * @template T - The Zod schema for the data type
+ * @param dataSchema - Zod schema for the response data
+ * @returns A discriminated union schema for AgentResponse
+ *
+ * @example
+ * ```ts
+ * // Create schema for string responses
+ * const StringResponseSchema = AgentResponseSchema(z.object({ result: z.string() }));
+ *
+ * // Validate a success response
+ * const result = StringResponseSchema.safeParse({
+ *   status: 'success',
+ *   data: { result: 'hello' },
+ *   error: null,
+ *   metadata: { agentId: 'test', timestamp: Date.now() }
+ * });
+ * ```
+ */
+export function AgentResponseSchema(dataSchema) {
+    const successSchema = z.object({
+        status: z.literal('success'),
+        data: dataSchema,
+        error: z.null(), // PRD 6.4.4: null not undefined
+        metadata: AgentResponseMetadataSchema.optional(),
+    });
+    const errorSchema = z.object({
+        status: z.literal('error'),
+        data: z.null(), // PRD 6.4.4: null not undefined
+        error: AgentErrorDetailsSchema,
+        metadata: AgentResponseMetadataSchema.optional(),
+    });
+    const partialSchema = z.object({
+        status: z.literal('partial'),
+        data: dataSchema,
+        error: z.null(), // PRD 6.4.4: null not undefined
+        metadata: AgentResponseMetadataSchema.optional(),
+    });
+    return z.discriminatedUnion('status', [successSchema, errorSchema, partialSchema]).superRefine((data, ctx) => {
+        // Runtime validation: ensure consistency between status and data/error fields
+        if (data.status === 'success') {
+            if (data.error !== null) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: "Invalid state: status='success' but error is non-null (must be null)",
+                    path: ['error'],
+                });
+            }
+        }
+        else if (data.status === 'error') {
+            if (data.data !== null) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: "Invalid state: status='error' but data is non-null (must be null)",
+                    path: ['data'],
+                });
+            }
+        }
+        else if (data.status === 'partial') {
+            if (data.error !== null) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: "Invalid state: status='partial' but error is non-null (must be null)",
+                    path: ['error'],
+                });
+            }
+        }
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

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

package/dist/types/decorators.d.ts

@@ -0,0 +1,40 @@
+import type { ErrorMergeStrategy } from './error-strategy.js';
+import type { ErrorCriterion } from './restart.js';
+/**
+ * Configuration options for @Step decorator
+ */
+export interface StepOptions {
+    /** Custom step name (defaults to method name) */
+    name?: string;
+    /** If true, capture state snapshot after step completion */
+    snapshotState?: boolean;
+    /** Track and emit step duration (default: true, tracked unless explicitly set to false) */
+    trackTiming?: boolean;
+    /** If true, log message at step start */
+    logStart?: boolean;
+    /** If true, log message at step end */
+    logFinish?: boolean;
+    /** If true, step can be restarted on failure (default: false) */
+    restartable?: boolean;
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Delay between retry attempts in milliseconds (default: 1000) */
+    retryDelayMs?: number;
+    /** Error criteria that trigger retry attempts (default: all errors if restartable) */
+    retryOn?: ErrorCriterion[];
+}
+/**
+ * Configuration options for @Task decorator
+ *
+ * @note The decorator uses lenient validation - non-Workflow returns are
+ *       silently skipped. See the @Task decorator JSDoc for details.
+ */
+export interface TaskOptions {
+    /** Custom task name (defaults to method name) */
+    name?: string;
+    /** If true, run returned workflows concurrently */
+    concurrent?: boolean;
+    /** Strategy for merging errors from concurrent task execution */
+    errorMergeStrategy?: ErrorMergeStrategy;
+}
+//# sourceMappingURL=decorators.d.ts.map

package/dist/types/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/types/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC"}

package/dist/types/decorators.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decorators.js.map

package/dist/types/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/types/decorators.ts"],"names":[],"mappings":""}

package/dist/types/error-strategy.d.ts

@@ -0,0 +1,13 @@
+import type { WorkflowError } from './error.js';
+/**
+ * Strategy for merging multiple errors from concurrent operations
+ */
+export interface ErrorMergeStrategy {
+    /** Enable error merging (default: false, first error wins) */
+    enabled: boolean;
+    /** Maximum depth to merge errors */
+    maxMergeDepth?: number;
+    /** Custom function to combine multiple errors */
+    combine?(errors: WorkflowError[]): WorkflowError;
+}
+//# sourceMappingURL=error-strategy.d.ts.map

package/dist/types/error-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-strategy.d.ts","sourceRoot":"","sources":["../../src/types/error-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,OAAO,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC;CAClD"}

package/dist/types/error-strategy.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-strategy.js.map

package/dist/types/error-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-strategy.js","sourceRoot":"","sources":["../../src/types/error-strategy.ts"],"names":[],"mappings":""}

package/dist/types/error.d.ts

@@ -0,0 +1,20 @@
+import type { LogEntry } from './logging.js';
+import type { SerializedWorkflowState } from './snapshot.js';
+/**
+ * Rich error object containing workflow context
+ */
+export interface WorkflowError {
+    /** Error message */
+    message: string;
+    /** Original thrown error */
+    original: unknown;
+    /** ID of workflow where error occurred */
+    workflowId: string;
+    /** Stack trace if available */
+    stack?: string;
+    /** State snapshot at time of error */
+    state: SerializedWorkflowState;
+    /** Logs from the failing workflow node */
+    logs: LogEntry[];
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/types/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB"}

package/dist/types/error.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error.js.map

package/dist/types/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/types/error.ts"],"names":[],"mappings":""}

package/dist/types/events.d.ts

@@ -0,0 +1,113 @@
+import type { WorkflowNode } from './workflow.js';
+import type { WorkflowError } from './error.js';
+import type { TokenUsage } from './sdk-primitives.js';
+import type { RestartAnalysis } from './restart.js';
+import type { SerializedWorkflowState } from './snapshot.js';
+import type { AgentResponse } from './agent.js';
+import type { z } from 'zod';
+/**
+ * Discriminated union of all workflow events
+ */
+export type WorkflowEvent = {
+    type: 'childAttached';
+    parentId: string;
+    child: WorkflowNode;
+} | {
+    type: 'childDetached';
+    parentId: string;
+    childId: string;
+} | {
+    type: 'stateSnapshot';
+    node: WorkflowNode;
+} | {
+    type: 'stepStart';
+    node: WorkflowNode;
+    step: string;
+} | {
+    type: 'stepRetry';
+    node: WorkflowNode;
+    stepName: string;
+    retryCount: number;
+    analysis: RestartAnalysis;
+    error: WorkflowError;
+    timestamp: number;
+} | {
+    type: 'stepRestarted';
+    node: WorkflowNode;
+    stepName: string;
+    retryCount: number;
+    restoredState: SerializedWorkflowState;
+    timestamp: number;
+} | {
+    type: 'stepEnd';
+    node: WorkflowNode;
+    step: string;
+    duration: number;
+} | {
+    type: 'error';
+    node: WorkflowNode;
+    error: WorkflowError;
+} | {
+    type: 'invalidResponse';
+    node: WorkflowNode;
+    response: AgentResponse<unknown>;
+    agentId: string;
+    errors: z.ZodError;
+    timestamp: number;
+} | {
+    type: 'taskStart';
+    node: WorkflowNode;
+    task: string;
+} | {
+    type: 'taskEnd';
+    node: WorkflowNode;
+    task: string;
+} | {
+    type: 'treeUpdated';
+    root: WorkflowNode;
+} | {
+    type: 'agentPromptStart';
+    agentId: string;
+    agentName: string;
+    promptId: string;
+    node: WorkflowNode;
+} | {
+    type: 'agentPromptEnd';
+    agentId: string;
+    agentName: string;
+    promptId: string;
+    node: WorkflowNode;
+    duration: number;
+    tokenUsage?: TokenUsage;
+} | {
+    type: 'toolInvocation';
+    toolName: string;
+    input: unknown;
+    output: unknown;
+    duration: number;
+    node: WorkflowNode;
+} | {
+    type: 'mcpEvent';
+    serverName: string;
+    event: string;
+    payload?: unknown;
+    node: WorkflowNode;
+} | {
+    type: 'reflectionStart';
+    level: 'workflow' | 'agent' | 'prompt';
+    node: WorkflowNode;
+} | {
+    type: 'reflectionEnd';
+    level: 'workflow' | 'agent' | 'prompt';
+    success: boolean;
+    node: WorkflowNode;
+} | {
+    type: 'cacheHit';
+    key: string;
+    node: WorkflowNode;
+} | {
+    type: 'cacheMiss';
+    key: string;
+    node: WorkflowNode;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/types/events.d.ts.map

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