groundswell 0.0.1 → 0.0.3

package/dist/tools/introspection.js

@@ -0,0 +1,324 @@
+/**
+ * Introspection Tools - Standard tools for agents to inspect their workflow hierarchy
+ *
+ * These tools allow agents to understand their position in the workflow tree,
+ * access prior outputs, check cache status, and request dynamic workflow spawning.
+ */
+import { getExecutionContext } from '../core/context.js';
+import { defaultCache } from '../cache/index.js';
+// ============================================================================
+// Tool Definitions (Anthropic Tool format)
+// ============================================================================
+/**
+ * Tool: inspect_current_node
+ * Returns information about the current workflow node
+ */
+export const inspectCurrentNodeTool = {
+    name: 'inspect_current_node',
+    description: 'Get information about the current workflow node including ID, name, status, and parent reference',
+    input_schema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+};
+/**
+ * Tool: read_ancestor_chain
+ * Returns all ancestor nodes from current position up to root
+ */
+export const readAncestorChainTool = {
+    name: 'read_ancestor_chain',
+    description: 'Get all ancestor nodes from current position up to the root workflow',
+    input_schema: {
+        type: 'object',
+        properties: {
+            maxDepth: {
+                type: 'number',
+                description: 'Maximum ancestors to return (default: all)',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Tool: list_siblings_children
+ * Returns sibling or child nodes relative to current position
+ */
+export const listSiblingsChildrenTool = {
+    name: 'list_siblings_children',
+    description: 'List sibling or child nodes relative to current position',
+    input_schema: {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                enum: ['siblings', 'children'],
+                description: 'Type of nodes to list',
+            },
+        },
+        required: ['type'],
+    },
+};
+/**
+ * Tool: inspect_prior_outputs
+ * Returns outputs from prior steps or prompt executions
+ */
+export const inspectPriorOutputsTool = {
+    name: 'inspect_prior_outputs',
+    description: 'Get outputs from prior steps or prompt executions',
+    input_schema: {
+        type: 'object',
+        properties: {
+            nodeId: {
+                type: 'string',
+                description: 'Specific node ID to inspect (default: most recent)',
+            },
+            count: {
+                type: 'number',
+                description: 'Number of prior outputs to return (default: 1)',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Tool: inspect_cache_status
+ * Checks if a prompt response is cached
+ */
+export const inspectCacheStatusTool = {
+    name: 'inspect_cache_status',
+    description: 'Check if a prompt response is cached',
+    input_schema: {
+        type: 'object',
+        properties: {
+            promptHash: {
+                type: 'string',
+                description: 'Hash of the prompt to check',
+            },
+        },
+        required: ['promptHash'],
+    },
+};
+/**
+ * Tool: request_spawn_workflow
+ * Requests to spawn a new child workflow dynamically
+ */
+export const requestSpawnWorkflowTool = {
+    name: 'request_spawn_workflow',
+    description: 'Request to spawn a new child workflow dynamically',
+    input_schema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Name for the new workflow',
+            },
+            description: {
+                type: 'string',
+                description: 'Description of what the workflow should do',
+            },
+        },
+        required: ['name', 'description'],
+    },
+};
+// ============================================================================
+// Tool Handlers
+// ============================================================================
+/**
+ * Calculate depth of a node in the tree
+ */
+function calculateDepth(node) {
+    let depth = 0;
+    let current = node.parent;
+    while (current) {
+        depth++;
+        current = current.parent;
+    }
+    return depth;
+}
+/**
+ * Handler for inspect_current_node
+ */
+export async function handleInspectCurrentNode() {
+    const ctx = getExecutionContext();
+    if (!ctx) {
+        throw new Error('Not in workflow context - cannot inspect current node');
+    }
+    const node = ctx.workflowNode;
+    const depth = calculateDepth(node);
+    return {
+        id: node.id,
+        name: node.name,
+        status: node.status,
+        parentId: node.parent?.id,
+        parentName: node.parent?.name,
+        childCount: node.children.length,
+        depth,
+    };
+}
+/**
+ * Handler for read_ancestor_chain
+ */
+export async function handleReadAncestorChain(input) {
+    const ctx = getExecutionContext();
+    if (!ctx) {
+        throw new Error('Not in workflow context - cannot read ancestor chain');
+    }
+    const ancestors = [];
+    let current = ctx.workflowNode.parent;
+    let depth = 1;
+    const maxDepth = input.maxDepth ?? Infinity;
+    while (current && depth <= maxDepth) {
+        ancestors.push({
+            id: current.id,
+            name: current.name,
+            status: current.status,
+            depth,
+        });
+        current = current.parent;
+        depth++;
+    }
+    return {
+        ancestors,
+        totalDepth: calculateDepth(ctx.workflowNode),
+    };
+}
+/**
+ * Handler for list_siblings_children
+ */
+export async function handleListSiblingsChildren(input) {
+    const ctx = getExecutionContext();
+    if (!ctx) {
+        throw new Error('Not in workflow context - cannot list siblings/children');
+    }
+    const node = ctx.workflowNode;
+    let nodes;
+    if (input.type === 'children') {
+        nodes = node.children;
+    }
+    else {
+        // Get siblings (other children of parent, excluding self)
+        nodes = node.parent?.children.filter((n) => n.id !== node.id) ?? [];
+    }
+    return {
+        type: input.type,
+        nodes: nodes.map((n) => ({
+            id: n.id,
+            name: n.name,
+            status: n.status,
+        })),
+    };
+}
+/**
+ * Handler for inspect_prior_outputs
+ */
+export async function handleInspectPriorOutputs(input) {
+    const ctx = getExecutionContext();
+    if (!ctx) {
+        throw new Error('Not in workflow context - cannot inspect prior outputs');
+    }
+    const count = input.count ?? 1;
+    const node = ctx.workflowNode;
+    // Get completed children nodes
+    const completedNodes = node.parent?.children
+        .filter((n) => n.status === 'completed' && n.id !== node.id)
+        .slice(-count) ?? [];
+    // If specific nodeId requested, filter to just that
+    if (input.nodeId) {
+        const specific = completedNodes.find((n) => n.id === input.nodeId);
+        if (!specific) {
+            return [];
+        }
+        return [
+            {
+                nodeId: specific.id,
+                nodeName: specific.name,
+                status: specific.status,
+                events: specific.events,
+            },
+        ];
+    }
+    return completedNodes.map((n) => ({
+        nodeId: n.id,
+        nodeName: n.name,
+        status: n.status,
+        events: n.events,
+    }));
+}
+/**
+ * Handler for inspect_cache_status
+ */
+export async function handleInspectCacheStatus(input) {
+    const exists = defaultCache.has(input.promptHash);
+    return {
+        exists,
+        key: input.promptHash,
+    };
+}
+/**
+ * Handler for request_spawn_workflow
+ * Note: This creates a spawn request that must be handled by the workflow orchestrator
+ */
+export async function handleRequestSpawnWorkflow(input) {
+    const ctx = getExecutionContext();
+    if (!ctx) {
+        throw new Error('Not in workflow context - cannot request spawn');
+    }
+    // Create a spawn request ID
+    const requestId = `spawn-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    // Return the request - actual spawning is handled by the orchestrator
+    return {
+        name: input.name,
+        description: input.description,
+        requestId,
+        status: 'pending',
+    };
+}
+// ============================================================================
+// Tool Bundle and Registration
+// ============================================================================
+/**
+ * All introspection tools bundled together
+ */
+export const INTROSPECTION_TOOLS = [
+    inspectCurrentNodeTool,
+    readAncestorChainTool,
+    listSiblingsChildrenTool,
+    inspectPriorOutputsTool,
+    inspectCacheStatusTool,
+    requestSpawnWorkflowTool,
+];
+/**
+ * Map of tool names to handlers
+ */
+export const INTROSPECTION_HANDLERS = {
+    inspect_current_node: handleInspectCurrentNode,
+    read_ancestor_chain: handleReadAncestorChain,
+    list_siblings_children: handleListSiblingsChildren,
+    inspect_prior_outputs: handleInspectPriorOutputs,
+    inspect_cache_status: handleInspectCacheStatus,
+    request_spawn_workflow: handleRequestSpawnWorkflow,
+};
+/**
+ * Register all introspection tools with an MCP handler
+ * @param handler MCP handler to register tools with
+ */
+export function registerIntrospectionTools(handler) {
+    for (const [name, executor] of Object.entries(INTROSPECTION_HANDLERS)) {
+        handler.registerTool(name, executor);
+    }
+}
+/**
+ * Execute an introspection tool by name
+ * @param toolName Name of the tool to execute
+ * @param input Tool input
+ * @returns Tool result
+ */
+export async function executeIntrospectionTool(toolName, input) {
+    const handler = INTROSPECTION_HANDLERS[toolName];
+    if (!handler) {
+        throw new Error(`Unknown introspection tool: ${toolName}`);
+    }
+    return handler(input);
+}
+//# sourceMappingURL=introspection.js.map

package/dist/tools/introspection.js.map

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

package/dist/types/agent.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Agent configuration and override types
+ * All properties map 1:1 to Anthropic SDK
+ */
+import type { Tool, MCPServer, Skill, AgentHooks } from './sdk-primitives.js';
+/**
+ * Configuration for creating an Agent instance
+ * All Anthropic SDK properties pass through unchanged
+ */
+export interface AgentConfig {
+    /** Human-readable name for the agent */
+    name?: string;
+    /** System prompt for the agent */
+    system?: string;
+    /** Tools available to the agent */
+    tools?: Tool[];
+    /** MCP servers to connect */
+    mcps?: MCPServer[];
+    /** Skills to load */
+    skills?: Skill[];
+    /** Lifecycle hooks */
+    hooks?: AgentHooks;
+    /** Environment variables for agent execution */
+    env?: Record<string, string>;
+    /** Enable reflection capability for this agent */
+    enableReflection?: boolean;
+    /** Enable caching of prompt responses */
+    enableCache?: boolean;
+    /** Model to use (defaults to claude-sonnet-4-20250514) */
+    model?: string;
+    /** Maximum tokens for responses */
+    maxTokens?: number;
+    /** Temperature for response generation */
+    temperature?: number;
+}
+/**
+ * Overrides that can be applied at the prompt level
+ * Takes precedence over AgentConfig values
+ */
+export interface PromptOverrides {
+    /** Override system prompt for this prompt */
+    system?: string;
+    /** Override tools for this prompt */
+    tools?: Tool[];
+    /** Override MCPs for this prompt */
+    mcps?: MCPServer[];
+    /** Override skills for this prompt */
+    skills?: Skill[];
+    /** Override hooks for this prompt */
+    hooks?: AgentHooks;
+    /** Override environment variables */
+    env?: Record<string, string>;
+    /** Override temperature */
+    temperature?: number;
+    /** Override max tokens */
+    maxTokens?: number;
+    /** Stop sequences to use */
+    stop?: string[];
+    /** Disable cache for this prompt */
+    disableCache?: boolean;
+    /** Enable reflection for this prompt */
+    enableReflection?: boolean;
+    /** Override model for this prompt */
+    model?: string;
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,mCAAmC;IACnC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf,6BAA6B;IAC7B,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAEnB,qBAAqB;IACrB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAEjB,sBAAsB;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf,oCAAoC;IACpC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IAEnB,sCAAsC;IACtC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IAEjB,qCAAqC;IACrC,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types/agent.js

@@ -0,0 +1,6 @@
+/**
+ * Agent configuration and override types
+ * All properties map 1:1 to Anthropic SDK
+ */
+export {};
+//# 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":"AAAA;;;GAGG"}

package/dist/types/decorators.d.ts

@@ -0,0 +1,31 @@
+import type { ErrorMergeStrategy } from './error-strategy.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) */
+    trackTiming?: boolean;
+    /** If true, log message at step start */
+    logStart?: boolean;
+    /** If true, log message at step end */
+    logFinish?: boolean;
+}
+/**
+ * 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;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;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,87 @@
+import type { WorkflowNode } from './workflow.js';
+import type { WorkflowError } from './error.js';
+import type { TokenUsage } from './sdk-primitives.js';
+/**
+ * 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: 'stepEnd';
+    node: WorkflowNode;
+    step: string;
+    duration: number;
+} | {
+    type: 'error';
+    node: WorkflowNode;
+    error: WorkflowError;
+} | {
+    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":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,aAAa,GAErB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAE3C;IACE,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;CACpB,GACD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,GAED;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;CACpB,GAED;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;CACpB,GAED;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,YAAY,CAAC;CACpB,GACD;IACE,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,YAAY,CAAC;CACpB,GAED;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;CACpB,CAAC"}

package/dist/types/events.js

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

package/dist/types/events.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,15 @@
+export type { WorkflowStatus, WorkflowNode } from './workflow.js';
+export type { LogLevel, LogEntry } from './logging.js';
+export type { SerializedWorkflowState, StateFieldMetadata } from './snapshot.js';
+export type { WorkflowError } from './error.js';
+export type { WorkflowEvent } from './events.js';
+export type { WorkflowObserver } from './observer.js';
+export type { StepOptions, TaskOptions } from './decorators.js';
+export type { ErrorMergeStrategy } from './error-strategy.js';
+export type { Tool, ToolResult, MCPServer, Skill, HookHandler, PreToolUseContext, PostToolUseContext, SessionStartContext, SessionEndContext, AgentHooks, TokenUsage, } from './sdk-primitives.js';
+export type { AgentConfig, PromptOverrides } from './agent.js';
+export type { PromptConfig } from './prompt.js';
+export type { WorkflowContext, WorkflowConfig, WorkflowResult, EventTreeHandle, EventNode, EventMetrics, AgentLike, PromptLike, } from './workflow-context.js';
+export type { ReflectionAPI, ReflectionConfig, ReflectionContext, ReflectionResult, ReflectionEntry, } from './reflection.js';
+export { DEFAULT_REFLECTION_CONFIG, createReflectionConfig, } from './reflection.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjF,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,YAAY,EACV,IAAI,EACJ,UAAU,EACV,SAAS,EACT,KAAK,EACL,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG/D,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,SAAS,EACT,YAAY,EACZ,SAAS,EACT,UAAU,GACX,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export { DEFAULT_REFLECTION_CONFIG, createReflectionConfig, } from './reflection.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAmDA,OAAO,EACL,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}