@providerprotocol/agents 0.0.4 → 0.0.5

package/dist/{chunk-4ESYN66B.js → chunk-CEHXAE4Z.js}

@@ -1,3 +1,5 @@
+import { generateUUID } from './chunk-EKRXMSDX.js';
+
 // src/execution/loop.ts
 var DEFAULT_LOOP_OPTIONS = {
   maxIterations: Infinity
@@ -197,6 +199,39 @@ function loop(options = {}) {
   };
 }
 
-export { loop };
-//# sourceMappingURL=chunk-4ESYN66B.js.map
-//# sourceMappingURL=chunk-4ESYN66B.js.map
+// src/execution/tool-context.ts
+function injectToolContext(tools, context, options = {}) {
+  return tools.map((tool) => wrapToolWithContext(tool, context, options));
+}
+function wrapToolWithContext(tool, context, options) {
+  const originalRun = tool.run;
+  return {
+    ...tool,
+    run: async (params) => {
+      const toolContext = {
+        agentId: context.agent.id,
+        stateId: context.state.id,
+        toolCallId: generateUUID(),
+        // Generate unique ID for this call
+        onSubagentEvent: options.onSubagentEvent
+      };
+      if (originalRun.length > 1) {
+        return originalRun(params, toolContext);
+      }
+      return originalRun(params);
+    }
+  };
+}
+function isContextAwareTool(tool) {
+  return tool.run.length > 1;
+}
+function withToolContext(tool, handler) {
+  return {
+    ...tool,
+    run: handler
+  };
+}
+
+export { injectToolContext, isContextAwareTool, loop, withToolContext };
+//# sourceMappingURL=chunk-CEHXAE4Z.js.map
+//# sourceMappingURL=chunk-CEHXAE4Z.js.map

package/dist/chunk-CEHXAE4Z.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/execution/loop.ts","../src/execution/tool-context.ts"],"names":[],"mappings":"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","file":"chunk-CEHXAE4Z.js","sourcesContent":["import type { Turn, StreamEvent } from '@providerprotocol/ai';\nimport type {\n  ExecutionStrategy,\n  ExecutionContext,\n  ExecutionResult,\n  LoopOptions,\n  AgentStreamResult,\n  AgentStreamEvent,\n} from './types.ts';\n\nconst DEFAULT_LOOP_OPTIONS: Required<LoopOptions> = {\n  maxIterations: Infinity,\n};\n\n/**\n * Create a loop execution strategy.\n * The simplest strategy - equivalent to UPP's tool loop behavior.\n *\n * Behavior:\n * 1. Send input to LLM\n * 2. If response has tool calls, execute tools and loop\n * 3. Continue until no tool calls or maxIterations reached\n * 4. Return final response as UPP Turn\n *\n * @param options - Loop configuration options\n * @returns ExecutionStrategy\n */\nexport function loop(options: LoopOptions = {}): ExecutionStrategy {\n  const opts = { ...DEFAULT_LOOP_OPTIONS, ...options };\n\n  return {\n    name: 'loop',\n\n    async execute(context: ExecutionContext): Promise<ExecutionResult> {\n      const { llm, input, state, strategy, signal } = context;\n\n      // Add input message to state and set agentId in metadata\n      // This ensures checkpoints include the full conversation\n      let currentState = state\n        .withMessage(input)\n        .withMetadata('agentId', context.agent.id);\n      let iteration = 0;\n      let finalTurn: Turn | undefined;\n\n      // Messages for LLM generation (includes input we just added)\n      const inputMessages = [...currentState.messages];\n\n      while (true) {\n        iteration++;\n        currentState = currentState.withStep(iteration);\n\n        // Check abort signal\n        if (signal?.aborted) {\n          throw new Error('Execution aborted');\n        }\n\n        // Call strategy hooks\n        strategy.onStepStart?.(iteration, currentState);\n\n        // Generate response - llm.generate uses rest params, pass messages array\n        const turn = await llm.generate(inputMessages);\n        finalTurn = turn;\n\n        // Update state with messages from this turn\n        currentState = currentState.withMessages(turn.messages);\n\n        // Call action hook if there were tool calls\n        if (turn.response.hasToolCalls) {\n          strategy.onAct?.(iteration, turn.response.toolCalls ?? []);\n        }\n\n        // Call observe hook if there were tool executions\n        if (turn.toolExecutions && turn.toolExecutions.length > 0) {\n          strategy.onObserve?.(iteration, turn.toolExecutions);\n        }\n\n        // Call step end hook\n        strategy.onStepEnd?.(iteration, { turn, state: currentState });\n\n        // Save checkpoint after step completes (fire-and-forget, log errors)\n        if (context.checkpoints && context.sessionId) {\n          context.checkpoints.save(context.sessionId, currentState.toJSON()).catch((err) => {\n            console.error('[UAP] Checkpoint save failed:', err);\n          });\n        }\n\n        // Check stop condition\n        const shouldStop = await strategy.stopCondition?.(currentState);\n        if (shouldStop) {\n          break;\n        }\n\n        // Check if there are more tool calls to process\n        // UPP's llm.generate handles the tool loop internally,\n        // so we only need one iteration unless we're doing multi-step\n        if (!turn.response.hasToolCalls) {\n          break;\n        }\n\n        // Check iteration limit\n        if (opts.maxIterations !== Infinity && iteration >= opts.maxIterations) {\n          break;\n        }\n\n        // For next iteration, use the updated messages\n        inputMessages.length = 0;\n        inputMessages.push(...currentState.messages);\n      }\n\n      if (!finalTurn) {\n        throw new Error('No turn generated');\n      }\n\n      // Include sessionId in state metadata if checkpointing is enabled\n      // Per UAP spec Section 3.4: sessionId MUST be included in state.metadata\n      let finalState = currentState;\n      if (context.sessionId) {\n        finalState = currentState.withMetadata('sessionId', context.sessionId);\n      }\n\n      const result: ExecutionResult = {\n        turn: finalTurn,\n        state: finalState,\n      };\n\n      strategy.onComplete?.(result);\n\n      return result;\n    },\n\n    stream(context: ExecutionContext): AgentStreamResult {\n      const { llm, input, state, strategy, signal } = context;\n      const agentId = context.agent.id;\n\n      let aborted = false;\n      const abortController = new AbortController();\n\n      // Combine signals if one was provided\n      if (signal) {\n        signal.addEventListener('abort', () => abortController.abort());\n      }\n\n      let resolveResult: (result: ExecutionResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<ExecutionResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      async function* generateEvents(): AsyncGenerator<AgentStreamEvent> {\n        // Add input message to state and set agentId in metadata\n        // This ensures checkpoints include the full conversation\n        let currentState = state\n          .withMessage(input)\n          .withMetadata('agentId', context.agent.id);\n        let iteration = 0;\n        let finalTurn: Turn | undefined;\n\n        // Messages for LLM generation (includes input we just added)\n        const inputMessages = [...currentState.messages];\n\n        try {\n          while (!aborted) {\n            iteration++;\n            currentState = currentState.withStep(iteration);\n\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            strategy.onStepStart?.(iteration, currentState);\n\n            // Emit step start event\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_start',\n                step: iteration,\n                agentId,\n                data: { iteration },\n              },\n            };\n\n            // Stream the LLM response\n            const streamResult = llm.stream(inputMessages);\n\n            for await (const event of streamResult as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              // Yield UPP events\n              yield {\n                source: 'upp',\n                upp: event,\n              };\n            }\n\n            // Get the final turn from the stream\n            const turn = await streamResult.turn;\n            finalTurn = turn;\n\n            currentState = currentState.withMessages(turn.messages);\n\n            if (turn.response.hasToolCalls) {\n              strategy.onAct?.(iteration, turn.response.toolCalls ?? []);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'action',\n                  step: iteration,\n                  agentId,\n                  data: { toolCalls: turn.response.toolCalls },\n                },\n              };\n            }\n\n            if (turn.toolExecutions && turn.toolExecutions.length > 0) {\n              strategy.onObserve?.(iteration, turn.toolExecutions);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'observation',\n                  step: iteration,\n                  agentId,\n                  data: { observations: turn.toolExecutions },\n                },\n              };\n            }\n\n            strategy.onStepEnd?.(iteration, { turn, state: currentState });\n\n            // Save checkpoint after step completes (fire-and-forget, log errors)\n            if (context.checkpoints && context.sessionId) {\n              context.checkpoints.save(context.sessionId, currentState.toJSON()).catch((err) => {\n                console.error('[UAP] Checkpoint save failed:', err);\n              });\n            }\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_end',\n                step: iteration,\n                agentId,\n                data: { iteration },\n              },\n            };\n\n            const shouldStop = await strategy.stopCondition?.(currentState);\n            if (shouldStop) {\n              break;\n            }\n\n            if (!turn.response.hasToolCalls) {\n              break;\n            }\n\n            if (opts.maxIterations !== Infinity && iteration >= opts.maxIterations) {\n              break;\n            }\n\n            inputMessages.length = 0;\n            inputMessages.push(...currentState.messages);\n          }\n\n          if (!finalTurn) {\n            throw new Error('No turn generated');\n          }\n\n          // Include sessionId in state metadata if checkpointing is enabled\n          // Per UAP spec Section 3.4: sessionId MUST be included in state.metadata\n          let finalState = currentState;\n          if (context.sessionId) {\n            finalState = currentState.withMetadata('sessionId', context.sessionId);\n          }\n\n          const result: ExecutionResult = {\n            turn: finalTurn,\n            state: finalState,\n          };\n\n          strategy.onComplete?.(result);\n          resolveResult(result);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          strategy.onError?.(err, currentState);\n          rejectResult(err);\n          throw err;\n        }\n      }\n\n      const iterator = generateEvents();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n  };\n}\n","import type { Tool } from '@providerprotocol/ai';\nimport type {\n  ExecutionContext,\n  ToolExecutionContext,\n  OnSubagentEvent,\n  ContextAwareToolRun,\n} from './types.ts';\nimport { generateUUID } from '../utils/uuid.ts';\n\n/**\n * Options for tool context injection.\n */\nexport interface InjectToolContextOptions {\n  /** Callback for sub-agent events from tools */\n  onSubagentEvent?: OnSubagentEvent;\n}\n\n/**\n * Wrap tools to inject execution context when they support it.\n *\n * Per UAP-1.0 Section 8.4, tools that accept a second parameter\n * should receive execution context including agentId, stateId,\n * and sub-agent event callbacks.\n *\n * This enables:\n * - Sub-agent model/config inheritance\n * - Execution hierarchy tracking\n * - Sub-agent event propagation\n *\n * @param tools - Original tool array\n * @param context - Execution context from the agent\n * @param options - Additional options like event callbacks\n * @returns Wrapped tools with context injection\n *\n * @example\n * ```typescript\n * // In execution strategy\n * const wrappedTools = injectToolContext(tools, context, {\n *   onSubagentEvent: (event) => {\n *     // Handle sub-agent events\n *     yield { source: 'uap', uap: { type: event.type, ... } };\n *   },\n * });\n *\n * // Pass wrapped tools to LLM\n * const llmWithContext = llm({ model, tools: wrappedTools });\n * ```\n */\nexport function injectToolContext(\n  tools: Tool[],\n  context: ExecutionContext,\n  options: InjectToolContextOptions = {},\n): Tool[] {\n  return tools.map((tool) => wrapToolWithContext(tool, context, options));\n}\n\n/**\n * Wrap a single tool with context injection.\n */\nfunction wrapToolWithContext(\n  tool: Tool,\n  context: ExecutionContext,\n  options: InjectToolContextOptions,\n): Tool {\n  const originalRun = tool.run;\n\n  return {\n    ...tool,\n    run: async (params: Record<string, unknown>): Promise<unknown> => {\n      // Build execution context for this tool call\n      const toolContext: ToolExecutionContext = {\n        agentId: context.agent.id,\n        stateId: context.state.id,\n        toolCallId: generateUUID(), // Generate unique ID for this call\n        onSubagentEvent: options.onSubagentEvent,\n      };\n\n      // Check if tool accepts context (function has arity > 1)\n      // We detect this by checking if the function expects more than 1 parameter\n      if (originalRun.length > 1) {\n        // Tool expects context as second argument\n        return (originalRun as ContextAwareToolRun)(params, toolContext);\n      }\n\n      // Standard tool - just pass params\n      return originalRun(params);\n    },\n  };\n}\n\n/**\n * Check if a tool is context-aware (accepts second parameter).\n *\n * @param tool - Tool to check\n * @returns true if tool.run accepts more than one parameter\n */\nexport function isContextAwareTool(tool: Tool): boolean {\n  return tool.run.length > 1;\n}\n\n/**\n * Create a context-aware tool wrapper for existing tools.\n * This is useful when you want to add context support to a tool\n * that doesn't natively support it.\n *\n * @param tool - Original tool\n * @param handler - Function that receives params and context, returns result\n * @returns New tool with context support\n *\n * @example\n * ```typescript\n * const originalTool = { name: 'my_tool', run: async (p) => 'result', ... };\n *\n * const contextAware = withToolContext(originalTool, async (params, context) => {\n *   console.log('Agent ID:', context?.agentId);\n *   // Call original or do something with context\n *   return originalTool.run(params);\n * });\n * ```\n */\nexport function withToolContext(\n  tool: Tool,\n  handler: ContextAwareToolRun,\n): Tool {\n  return {\n    ...tool,\n    run: handler as Tool['run'],\n  };\n}\n"]}

package/dist/execution/index.d.ts

@@ -1,6 +1,7 @@
-import { L as LoopOptions, E as ExecutionStrategy, R as ReactOptions, P as PlanOptions } from '../types-D1egxttz.js';
-export { A as AgentStrategy, b as AgentStreamEvent, a as AgentStreamResult, h as ExecutionContext, i as ExecutionResult, G as GenerateResult, O as OnSubagentEvent, k as OrderedToolCall, f as SubagentEndEvent, g as SubagentEvent, c as SubagentEventBase, S as SubagentEventType, e as SubagentInnerEvent, d as SubagentStartEvent, T as ToolDependencyOptions, j as ToolWithDependencies, U as UAPEventType } from '../types-D1egxttz.js';
+import { L as LoopOptions, E as ExecutionStrategy, R as ReactOptions, P as PlanOptions } from '../types-DC8XeoaI.js';
+export { A as AgentStrategy, b as AgentStreamEvent, a as AgentStreamResult, C as ContextAwareToolRun, h as ExecutionContext, i as ExecutionResult, G as GenerateResult, O as OnSubagentEvent, l as OrderedToolCall, f as SubagentEndEvent, g as SubagentEvent, c as SubagentEventBase, S as SubagentEventType, e as SubagentInnerEvent, d as SubagentStartEvent, j as ToolDependencyOptions, T as ToolExecutionContext, k as ToolWithDependencies, U as UAPEventType } from '../types-DC8XeoaI.js';
 import { ToolCall, Tool } from '@providerprotocol/ai';
+export { I as InjectToolContextOptions, i as injectToolContext, a as isContextAwareTool, w as withToolContext } from '../tool-context-Cc_qNVud.js';
 import '../index-qsPwbY86.js';
 import '../types-2Vsthzyu.js';
 import '../types-DChRdQoX.js';
@@ -101,5 +102,67 @@ declare function hasToolDependencies(tools: Tool[]): boolean;
  * @returns true if any call has the `after` field set
  */
 declare function hasCallDependencies(toolCalls: ToolCall[]): boolean;
+/**
+ * Result of executing a tool call.
+ */
+interface ToolExecutionResult {
+    /** The tool call that was executed */
+    call: ToolCall;
+    /** The result from the tool */
+    result: unknown;
+    /** Whether the tool threw an error */
+    isError: boolean;
+    /** Error message if isError is true */
+    error?: string;
+    /** Execution duration in milliseconds */
+    duration: number;
+}
+/**
+ * Function type for executing a single tool call.
+ */
+type ToolExecutor = (call: ToolCall, tool: Tool) => Promise<unknown>;
+/**
+ * Execute tool calls respecting dependency ordering.
+ *
+ * This function takes tool calls, orders them using `orderToolCalls()`,
+ * and executes them respecting barriers (sequential tools) and
+ * dependencies (dependsOn, after).
+ *
+ * Per UAP-1.0 Sections 8.5 and 8.6:
+ * - Tools with `sequential: true` execute alone (barrier)
+ * - Tools with `dependsOn` wait for named tools to complete
+ * - Tool calls with `after` wait for specific call IDs to complete
+ *
+ * @param toolCalls - Tool calls from the model response
+ * @param tools - Tool definitions with potential dependencies
+ * @param executor - Function to execute a single tool call
+ * @returns Array of execution results in completion order
+ *
+ * @example
+ * ```typescript
+ * import { executeOrderedToolCalls } from '@providerprotocol/agents/execution';
+ *
+ * // Define tools with dependencies
+ * const readTool: ToolWithDependencies = {
+ *   name: 'read_file',
+ *   sequential: true, // Must complete before others
+ *   run: async (params) => readFile(params.path),
+ * };
+ *
+ * const processTool: ToolWithDependencies = {
+ *   name: 'process',
+ *   dependsOn: ['read_file'], // Wait for read_file
+ *   run: async (params) => process(params.data),
+ * };
+ *
+ * // Execute with ordering
+ * const results = await executeOrderedToolCalls(
+ *   turn.response.toolCalls,
+ *   [readTool, processTool],
+ *   async (call, tool) => tool.run(call.arguments),
+ * );
+ * ```
+ */
+declare function executeOrderedToolCalls(toolCalls: ToolCall[], tools: Tool[], executor: ToolExecutor): Promise<ToolExecutionResult[]>;
 
-export { type ExecutionGroup, ExecutionStrategy, LoopOptions, PlanOptions, ReactOptions, hasCallDependencies, hasToolDependencies, loop, orderToolCalls, plan, react };
+export { type ExecutionGroup, ExecutionStrategy, LoopOptions, PlanOptions, ReactOptions, type ToolExecutionResult, type ToolExecutor, executeOrderedToolCalls, hasCallDependencies, hasToolDependencies, loop, orderToolCalls, plan, react };

package/dist/execution/index.js

@@ -1,4 +1,4 @@
-export { loop } from '../chunk-4ESYN66B.js';
+export { injectToolContext, isContextAwareTool, loop, withToolContext } from '../chunk-CEHXAE4Z.js';
 import { generateUUID } from '../chunk-EKRXMSDX.js';
 import { UserMessage } from '@providerprotocol/ai';
 
@@ -673,7 +673,76 @@ function hasCallDependencies(toolCalls) {
   }
   return false;
 }
+async function executeOrderedToolCalls(toolCalls, tools, executor) {
+  if (toolCalls.length === 0) {
+    return [];
+  }
+  const toolMap = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    toolMap.set(tool.name, tool);
+  }
+  const groups = orderToolCalls(toolCalls, tools);
+  const results = [];
+  for (const group of groups) {
+    if (group.isBarrier) {
+      for (const call of group.calls) {
+        const tool = toolMap.get(call.toolName);
+        if (!tool) {
+          results.push({
+            call,
+            result: null,
+            isError: true,
+            error: `Tool not found: ${call.toolName}`,
+            duration: 0
+          });
+          continue;
+        }
+        const result = await executeOne(call, tool, executor);
+        results.push(result);
+      }
+    } else {
+      const groupResults = await Promise.all(
+        group.calls.map(async (call) => {
+          const tool = toolMap.get(call.toolName);
+          if (!tool) {
+            return {
+              call,
+              result: null,
+              isError: true,
+              error: `Tool not found: ${call.toolName}`,
+              duration: 0
+            };
+          }
+          return executeOne(call, tool, executor);
+        })
+      );
+      results.push(...groupResults);
+    }
+  }
+  return results;
+}
+async function executeOne(call, tool, executor) {
+  const startTime = Date.now();
+  try {
+    const result = await executor(call, tool);
+    return {
+      call,
+      result,
+      isError: false,
+      duration: Date.now() - startTime
+    };
+  } catch (error) {
+    const err = error instanceof Error ? error : new Error(String(error));
+    return {
+      call,
+      result: null,
+      isError: true,
+      error: err.message,
+      duration: Date.now() - startTime
+    };
+  }
+}
 
-export { hasCallDependencies, hasToolDependencies, orderToolCalls, plan, react };
+export { executeOrderedToolCalls, hasCallDependencies, hasToolDependencies, orderToolCalls, plan, react };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/execution/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/execution/react.ts","../../src/execution/plan.ts","../../src/execution/tool-ordering.ts"],"names":["UserMessage"],"mappings":"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","file":"index.js","sourcesContent":["import type { Turn, StreamEvent } from '@providerprotocol/ai';\nimport { UserMessage } from '@providerprotocol/ai';\nimport type {\n  ExecutionStrategy,\n  ExecutionContext,\n  ExecutionResult,\n  ReactOptions,\n  AgentStreamResult,\n  AgentStreamEvent,\n} from './types.ts';\n\nconst DEFAULT_REACT_OPTIONS: Required<ReactOptions> = {\n  maxSteps: Infinity,\n  reasoningPrompt: 'Think step by step about what you need to do next. Consider the current state, what tools are available, and what action would be most helpful.',\n};\n\n/**\n * Create a ReAct (Reason-Act-Observe) execution strategy.\n *\n * Behavior:\n * 1. Reason: LLM outputs reasoning about what to do next\n * 2. Act: LLM selects and executes tool(s)\n * 3. Observe: Tool results are formatted as observations\n * 4. Repeat until stop condition, no more actions, or maxSteps\n *\n * @param options - ReAct configuration options\n * @returns ExecutionStrategy\n */\nexport function react(options: ReactOptions = {}): ExecutionStrategy {\n  const opts = { ...DEFAULT_REACT_OPTIONS, ...options };\n\n  return {\n    name: 'react',\n\n    async execute(context: ExecutionContext): Promise<ExecutionResult> {\n      const { llm, input, state, strategy, signal } = context;\n\n      // Add input message to state and set agentId in metadata\n      // This ensures checkpoints include the full conversation\n      let currentState = state\n        .withMessage(input)\n        .withMetadata('agentId', context.agent.id);\n      let step = 0;\n      let finalTurn: Turn | undefined;\n\n      // Messages for LLM generation (includes input we just added)\n      const messages = [...currentState.messages];\n\n      while (true) {\n        step++;\n        currentState = currentState.withStep(step);\n\n        if (signal?.aborted) {\n          throw new Error('Execution aborted');\n        }\n\n        strategy.onStepStart?.(step, currentState);\n\n        // REASON PHASE: Ask LLM to think about what to do\n        const reasoningMessages = [\n          ...messages,\n          new UserMessage(opts.reasoningPrompt),\n        ];\n\n        const reasoningTurn = await llm.generate(reasoningMessages);\n\n        const reasoning = reasoningTurn.response.text;\n        currentState = currentState.withReasoning(reasoning);\n        strategy.onReason?.(step, reasoning);\n\n        // Add reasoning to conversation\n        messages.push(...reasoningTurn.messages);\n\n        // ACT PHASE: Execute with tools\n        const actionPrompt = new UserMessage(\n          'Based on your reasoning, take the appropriate action. Use tools if needed, or provide a final answer.',\n        );\n        messages.push(actionPrompt);\n\n        const actionTurn = await llm.generate(messages);\n        finalTurn = actionTurn;\n\n        // Update messages with action response\n        messages.push(...actionTurn.messages);\n        currentState = currentState.withMessages(actionTurn.messages);\n\n        // Handle tool calls\n        if (actionTurn.response.hasToolCalls) {\n          strategy.onAct?.(step, actionTurn.response.toolCalls ?? []);\n        }\n\n        // OBSERVE PHASE: Process tool results\n        if (actionTurn.toolExecutions && actionTurn.toolExecutions.length > 0) {\n          strategy.onObserve?.(step, actionTurn.toolExecutions);\n        }\n\n        strategy.onStepEnd?.(step, { turn: actionTurn, state: currentState });\n\n        // Check stop conditions\n        const shouldStop = await strategy.stopCondition?.(currentState);\n        if (shouldStop) {\n          break;\n        }\n\n        // No more tool calls means we're done\n        if (!actionTurn.response.hasToolCalls) {\n          break;\n        }\n\n        // Check step limit\n        if (opts.maxSteps !== Infinity && step >= opts.maxSteps) {\n          break;\n        }\n      }\n\n      if (!finalTurn) {\n        throw new Error('No turn generated');\n      }\n\n      // Include sessionId in state metadata if checkpointing is enabled\n      let finalState = currentState;\n      if (context.sessionId) {\n        finalState = currentState.withMetadata('sessionId', context.sessionId);\n      }\n\n      const result: ExecutionResult = {\n        turn: finalTurn,\n        state: finalState,\n      };\n\n      strategy.onComplete?.(result);\n\n      return result;\n    },\n\n    stream(context: ExecutionContext): AgentStreamResult {\n      const { llm, input, state, strategy, signal } = context;\n      const agentId = context.agent.id;\n\n      let aborted = false;\n      const abortController = new AbortController();\n\n      if (signal) {\n        signal.addEventListener('abort', () => abortController.abort());\n      }\n\n      let resolveResult: (result: ExecutionResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<ExecutionResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      async function* generateEvents(): AsyncGenerator<AgentStreamEvent> {\n        // Add input message to state and set agentId in metadata\n        // This ensures checkpoints include the full conversation\n        let currentState = state\n          .withMessage(input)\n          .withMetadata('agentId', context.agent.id);\n        let step = 0;\n        let finalTurn: Turn | undefined;\n\n        // Messages for LLM generation (includes input we just added)\n        const messages = [...currentState.messages];\n\n        try {\n          while (!aborted) {\n            step++;\n            currentState = currentState.withStep(step);\n\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            strategy.onStepStart?.(step, currentState);\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_start',\n                step,\n                agentId,\n                data: { phase: 'reasoning' },\n              },\n            };\n\n            // REASON PHASE\n            const reasoningMessages = [\n              ...messages,\n              new UserMessage(opts.reasoningPrompt),\n            ];\n\n            const reasoningStream = llm.stream(reasoningMessages);\n            let reasoningText = '';\n\n            for await (const event of reasoningStream as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              yield { source: 'upp', upp: event };\n\n              if (event.type === 'text_delta' && event.delta.text) {\n                reasoningText += event.delta.text;\n              }\n            }\n\n            const reasoningTurn = await reasoningStream.turn;\n            currentState = currentState.withReasoning(reasoningText || reasoningTurn.response.text);\n            strategy.onReason?.(step, reasoningText || reasoningTurn.response.text);\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'reasoning',\n                step,\n                agentId,\n                data: { reasoning: reasoningText || reasoningTurn.response.text },\n              },\n            };\n\n            messages.push(...reasoningTurn.messages);\n\n            // ACT PHASE\n            const actionPrompt = new UserMessage(\n              'Based on your reasoning, take the appropriate action. Use tools if needed, or provide a final answer.',\n            );\n            messages.push(actionPrompt);\n\n            const actionStream = llm.stream(messages);\n\n            for await (const event of actionStream as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              yield { source: 'upp', upp: event };\n            }\n\n            const actionTurn = await actionStream.turn;\n            finalTurn = actionTurn;\n\n            messages.push(...actionTurn.messages);\n            currentState = currentState.withMessages(actionTurn.messages);\n\n            if (actionTurn.response.hasToolCalls) {\n              strategy.onAct?.(step, actionTurn.response.toolCalls ?? []);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'action',\n                  step,\n                  agentId,\n                  data: { toolCalls: actionTurn.response.toolCalls },\n                },\n              };\n            }\n\n            if (actionTurn.toolExecutions && actionTurn.toolExecutions.length > 0) {\n              strategy.onObserve?.(step, actionTurn.toolExecutions);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'observation',\n                  step,\n                  agentId,\n                  data: { observations: actionTurn.toolExecutions },\n                },\n              };\n            }\n\n            strategy.onStepEnd?.(step, { turn: actionTurn, state: currentState });\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_end',\n                step,\n                agentId,\n                data: { phase: 'complete' },\n              },\n            };\n\n            const shouldStop = await strategy.stopCondition?.(currentState);\n            if (shouldStop) {\n              break;\n            }\n\n            if (!actionTurn.response.hasToolCalls) {\n              break;\n            }\n\n            if (opts.maxSteps !== Infinity && step >= opts.maxSteps) {\n              break;\n            }\n          }\n\n          if (!finalTurn) {\n            throw new Error('No turn generated');\n          }\n\n          // Include sessionId in state metadata if checkpointing is enabled\n          let finalState = currentState;\n          if (context.sessionId) {\n            finalState = currentState.withMetadata('sessionId', context.sessionId);\n          }\n\n          const result: ExecutionResult = {\n            turn: finalTurn,\n            state: finalState,\n          };\n\n          strategy.onComplete?.(result);\n          resolveResult(result);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          strategy.onError?.(err, currentState);\n          rejectResult(err);\n          throw err;\n        }\n      }\n\n      const iterator = generateEvents();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n  };\n}\n","import type { Turn, StreamEvent } from '@providerprotocol/ai';\nimport { UserMessage } from '@providerprotocol/ai';\nimport type { PlanStep } from '../state/index.ts';\nimport { generateUUID } from '../utils/uuid.ts';\nimport type {\n  ExecutionStrategy,\n  ExecutionContext,\n  ExecutionResult,\n  PlanOptions,\n  AgentStreamResult,\n  AgentStreamEvent,\n} from './types.ts';\n\nconst DEFAULT_PLAN_OPTIONS: Required<PlanOptions> = {\n  maxPlanSteps: Infinity,\n  allowReplan: true,\n  planSchema: {\n    type: 'object',\n    properties: {\n      steps: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            id: { type: 'string', description: 'Unique step identifier' },\n            description: { type: 'string', description: 'What this step does' },\n            tool: { type: 'string', description: 'Tool to use (if applicable)' },\n            dependsOn: {\n              type: 'array',\n              items: { type: 'string' },\n              description: 'IDs of steps this depends on',\n            },\n          },\n          required: ['id', 'description', 'dependsOn'],\n        },\n      },\n    },\n    required: ['steps'],\n  },\n};\n\nconst PLAN_PROMPT = `Create a detailed execution plan to accomplish the task.\nBreak it down into clear steps, specifying which tool to use for each step if applicable.\nInclude dependencies between steps (which steps must complete before others can start).\nReturn your plan as a JSON object with a \"steps\" array.`;\n\n/**\n * Create a plan-then-execute strategy.\n *\n * Behavior:\n * 1. Plan: LLM generates structured plan with steps and dependencies\n * 2. Execute: Execute each plan step respecting dependency order\n * 3. Replan: If a step fails and allowReplan is true, generate new plan\n *\n * @param options - Plan configuration options\n * @returns ExecutionStrategy\n */\nexport function plan(options: PlanOptions = {}): ExecutionStrategy {\n  const opts = { ...DEFAULT_PLAN_OPTIONS, ...options };\n\n  return {\n    name: 'plan',\n\n    async execute(context: ExecutionContext): Promise<ExecutionResult> {\n      const { llm, input, state, strategy, signal } = context;\n\n      // Add input message to state and set agentId in metadata\n      // This ensures checkpoints include the full conversation\n      let currentState = state\n        .withMessage(input)\n        .withMetadata('agentId', context.agent.id);\n      let step = 0;\n      let finalTurn: Turn | undefined;\n\n      // Messages for LLM generation (includes input we just added)\n      const messages = [...currentState.messages];\n\n      // PLANNING PHASE\n      step++;\n      currentState = currentState.withStep(step);\n\n      if (signal?.aborted) {\n        throw new Error('Execution aborted');\n      }\n\n      strategy.onStepStart?.(step, currentState);\n\n      // Generate the plan\n      const planMessages = [\n        ...messages,\n        new UserMessage(PLAN_PROMPT),\n      ];\n\n      const planTurn = await llm.generate(planMessages);\n\n      // Parse the plan from the response\n      let planData: { steps: Array<{ id: string; description: string; tool?: string; dependsOn: string[] }> };\n\n      try {\n        if (planTurn.data) {\n          planData = planTurn.data as typeof planData;\n        } else {\n          // Try to parse from text\n          const jsonMatch = planTurn.response.text.match(/\\{[\\s\\S]*\\}/);\n          if (jsonMatch) {\n            planData = JSON.parse(jsonMatch[0]) as typeof planData;\n          } else {\n            throw new Error('Could not parse plan from response');\n          }\n        }\n      } catch (err) {\n        throw new Error(`Failed to parse execution plan: ${err instanceof Error ? err.message : String(err)}`);\n      }\n\n      // Convert to PlanStep format\n      let planSteps: PlanStep[] = planData.steps.map((s) => ({\n        id: s.id || generateUUID(),\n        description: s.description,\n        tool: s.tool,\n        dependsOn: s.dependsOn || [],\n        status: 'pending' as const,\n      }));\n\n      // Apply maxPlanSteps limit\n      if (opts.maxPlanSteps !== Infinity && planSteps.length > opts.maxPlanSteps) {\n        planSteps = planSteps.slice(0, opts.maxPlanSteps);\n      }\n\n      currentState = currentState.withPlan(planSteps);\n      messages.push(...planTurn.messages);\n\n      strategy.onStepEnd?.(step, { turn: planTurn, state: currentState });\n\n      // EXECUTION PHASE\n      const completedSteps = new Set<string>();\n\n      // Execute steps in topological order\n      while (planSteps.some((s) => s.status === 'pending')) {\n        // Find next executable step (all dependencies completed)\n        const nextStep = planSteps.find(\n          (s) => s.status === 'pending'\n            && s.dependsOn.every((depId) => completedSteps.has(depId)),\n        );\n\n        if (!nextStep) {\n          // No step can be executed - either done or cyclic dependency\n          break;\n        }\n\n        step++;\n        currentState = currentState.withStep(step);\n\n        if (signal?.aborted) {\n          throw new Error('Execution aborted');\n        }\n\n        strategy.onStepStart?.(step, currentState);\n\n        // Update step status to in_progress\n        nextStep.status = 'in_progress';\n        currentState = currentState.withPlan([...planSteps]);\n\n        // Execute the step\n        const stepPrompt = new UserMessage(\n          `Execute step \"${nextStep.id}\": ${nextStep.description}${nextStep.tool ? ` using the ${nextStep.tool} tool` : ''}`,\n        );\n        messages.push(stepPrompt);\n\n        try {\n          const stepTurn = await llm.generate(messages);\n          finalTurn = stepTurn;\n\n          messages.push(...stepTurn.messages);\n          currentState = currentState.withMessages(stepTurn.messages);\n\n          if (stepTurn.response.hasToolCalls) {\n            strategy.onAct?.(step, stepTurn.response.toolCalls ?? []);\n          }\n\n          if (stepTurn.toolExecutions && stepTurn.toolExecutions.length > 0) {\n            strategy.onObserve?.(step, stepTurn.toolExecutions);\n          }\n\n          // Mark step as completed\n          nextStep.status = 'completed';\n          completedSteps.add(nextStep.id);\n          currentState = currentState.withPlan([...planSteps]);\n\n          strategy.onStepEnd?.(step, { turn: stepTurn, state: currentState });\n        } catch (err) {\n          nextStep.status = 'failed';\n          currentState = currentState.withPlan([...planSteps]);\n\n          if (opts.allowReplan) {\n            // Could implement replanning here\n            // For now, just continue and let the error propagate\n          }\n\n          throw err;\n        }\n\n        // Check stop condition\n        const shouldStop = await strategy.stopCondition?.(currentState);\n        if (shouldStop) {\n          break;\n        }\n      }\n\n      if (!finalTurn) {\n        finalTurn = planTurn; // Use plan turn if no execution happened\n      }\n\n      // Include sessionId in state metadata if checkpointing is enabled\n      let finalState = currentState;\n      if (context.sessionId) {\n        finalState = currentState.withMetadata('sessionId', context.sessionId);\n      }\n\n      const result: ExecutionResult = {\n        turn: finalTurn,\n        state: finalState,\n      };\n\n      strategy.onComplete?.(result);\n\n      return result;\n    },\n\n    stream(context: ExecutionContext): AgentStreamResult {\n      const { llm, input, state, strategy, signal } = context;\n      const agentId = context.agent.id;\n\n      let aborted = false;\n      const abortController = new AbortController();\n\n      if (signal) {\n        signal.addEventListener('abort', () => abortController.abort());\n      }\n\n      let resolveResult: (result: ExecutionResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<ExecutionResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      async function* generateEvents(): AsyncGenerator<AgentStreamEvent> {\n        // Add input message to state and set agentId in metadata\n        // This ensures checkpoints include the full conversation\n        let currentState = state\n          .withMessage(input)\n          .withMetadata('agentId', context.agent.id);\n        let step = 0;\n        let finalTurn: Turn | undefined;\n\n        // Messages for LLM generation (includes input we just added)\n        const messages = [...currentState.messages];\n\n        try {\n          // PLANNING PHASE\n          step++;\n          currentState = currentState.withStep(step);\n\n          if (abortController.signal.aborted) {\n            throw new Error('Execution aborted');\n          }\n\n          strategy.onStepStart?.(step, currentState);\n\n          yield {\n            source: 'uap',\n            uap: {\n              type: 'step_start',\n              step,\n              agentId,\n              data: { phase: 'planning' },\n            },\n          };\n\n          const planMessages = [\n            ...messages,\n            new UserMessage(PLAN_PROMPT),\n          ];\n\n          const planStream = llm.stream(planMessages);\n\n          for await (const event of planStream as AsyncIterable<StreamEvent>) {\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            yield { source: 'upp', upp: event };\n          }\n\n          const planTurn = await planStream.turn;\n\n          let planData: { steps: Array<{ id: string; description: string; tool?: string; dependsOn: string[] }> };\n\n          try {\n            if (planTurn.data) {\n              planData = planTurn.data as typeof planData;\n            } else {\n              const jsonMatch = planTurn.response.text.match(/\\{[\\s\\S]*\\}/);\n              if (jsonMatch) {\n                planData = JSON.parse(jsonMatch[0]) as typeof planData;\n              } else {\n                throw new Error('Could not parse plan from response');\n              }\n            }\n          } catch (err) {\n            throw new Error(`Failed to parse execution plan: ${err instanceof Error ? err.message : String(err)}`);\n          }\n\n          let planSteps: PlanStep[] = planData.steps.map((s) => ({\n            id: s.id || generateUUID(),\n            description: s.description,\n            tool: s.tool,\n            dependsOn: s.dependsOn || [],\n            status: 'pending' as const,\n          }));\n\n          if (opts.maxPlanSteps !== Infinity && planSteps.length > opts.maxPlanSteps) {\n            planSteps = planSteps.slice(0, opts.maxPlanSteps);\n          }\n\n          currentState = currentState.withPlan(planSteps);\n          messages.push(...planTurn.messages);\n\n          yield {\n            source: 'uap',\n            uap: {\n              type: 'plan_created',\n              step,\n              agentId,\n              data: { plan: planSteps },\n            },\n          };\n\n          strategy.onStepEnd?.(step, { turn: planTurn, state: currentState });\n\n          yield {\n            source: 'uap',\n            uap: {\n              type: 'step_end',\n              step,\n              agentId,\n              data: { phase: 'planning' },\n            },\n          };\n\n          // EXECUTION PHASE\n          const completedSteps = new Set<string>();\n\n          while (planSteps.some((s) => s.status === 'pending') && !aborted) {\n            const nextStep = planSteps.find(\n              (s) => s.status === 'pending'\n                && s.dependsOn.every((depId) => completedSteps.has(depId)),\n            );\n\n            if (!nextStep) {\n              break;\n            }\n\n            step++;\n            currentState = currentState.withStep(step);\n\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            strategy.onStepStart?.(step, currentState);\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'plan_step_start',\n                step,\n                agentId,\n                data: { planStep: nextStep },\n              },\n            };\n\n            nextStep.status = 'in_progress';\n            currentState = currentState.withPlan([...planSteps]);\n\n            const stepPrompt = new UserMessage(\n              `Execute step \"${nextStep.id}\": ${nextStep.description}${nextStep.tool ? ` using the ${nextStep.tool} tool` : ''}`,\n            );\n            messages.push(stepPrompt);\n\n            const stepStream = llm.stream(messages);\n\n            for await (const event of stepStream as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              yield { source: 'upp', upp: event };\n            }\n\n            const stepTurn = await stepStream.turn;\n            finalTurn = stepTurn;\n\n            messages.push(...stepTurn.messages);\n            currentState = currentState.withMessages(stepTurn.messages);\n\n            if (stepTurn.response.hasToolCalls) {\n              strategy.onAct?.(step, stepTurn.response.toolCalls ?? []);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'action',\n                  step,\n                  agentId,\n                  data: { toolCalls: stepTurn.response.toolCalls },\n                },\n              };\n            }\n\n            if (stepTurn.toolExecutions && stepTurn.toolExecutions.length > 0) {\n              strategy.onObserve?.(step, stepTurn.toolExecutions);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'observation',\n                  step,\n                  agentId,\n                  data: { observations: stepTurn.toolExecutions },\n                },\n              };\n            }\n\n            nextStep.status = 'completed';\n            completedSteps.add(nextStep.id);\n            currentState = currentState.withPlan([...planSteps]);\n\n            strategy.onStepEnd?.(step, { turn: stepTurn, state: currentState });\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'plan_step_end',\n                step,\n                agentId,\n                data: { planStep: nextStep },\n              },\n            };\n\n            const shouldStop = await strategy.stopCondition?.(currentState);\n            if (shouldStop) {\n              break;\n            }\n          }\n\n          if (!finalTurn) {\n            finalTurn = planTurn;\n          }\n\n          // Include sessionId in state metadata if checkpointing is enabled\n          let finalState = currentState;\n          if (context.sessionId) {\n            finalState = currentState.withMetadata('sessionId', context.sessionId);\n          }\n\n          const result: ExecutionResult = {\n            turn: finalTurn,\n            state: finalState,\n          };\n\n          strategy.onComplete?.(result);\n          resolveResult(result);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          strategy.onError?.(err, currentState);\n          rejectResult(err);\n          throw err;\n        }\n      }\n\n      const iterator = generateEvents();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n  };\n}\n","import type { Tool, ToolCall } from '@providerprotocol/ai';\nimport type { ToolWithDependencies, OrderedToolCall } from './types.ts';\n\n/**\n * Execution group - a set of tool calls that can execute in parallel.\n */\nexport interface ExecutionGroup {\n  /** Tool calls in this group */\n  calls: ToolCall[];\n  /** Whether this group contains a sequential tool (acts as barrier) */\n  isBarrier: boolean;\n}\n\n/**\n * Build a map of tool definitions by name for quick lookup.\n */\nfunction buildToolMap(tools: Tool[]): Map<string, ToolWithDependencies> {\n  const map = new Map<string, ToolWithDependencies>();\n  for (const tool of tools) {\n    map.set(tool.name, tool as ToolWithDependencies);\n  }\n  return map;\n}\n\n/**\n * Check if a tool call has an explicit dependency via model hint.\n */\nfunction getModelDependencies(call: ToolCall): string[] {\n  const orderedCall = call as OrderedToolCall;\n  return orderedCall.after ?? [];\n}\n\n/**\n * Order tool calls into execution groups respecting dependencies.\n *\n * This function takes a list of tool calls and the available tools,\n * then groups them for execution while respecting:\n * 1. Tool-level `sequential` flag (creates execution barriers)\n * 2. Tool-level `dependsOn` array (tool must wait for named tools)\n * 3. Model-driven `after` array on tool calls (call must wait for specific calls)\n *\n * @param toolCalls - Tool calls from the model response\n * @param tools - Tool definitions (may include dependency options)\n * @returns Ordered array of execution groups\n *\n * @example\n * ```typescript\n * const groups = orderToolCalls(turn.response.toolCalls, agent.tools);\n *\n * for (const group of groups) {\n *   if (group.isBarrier) {\n *     // Execute sequentially\n *     for (const call of group.calls) {\n *       await executeTool(call);\n *     }\n *   } else {\n *     // Execute in parallel\n *     await Promise.all(group.calls.map(executeTool));\n *   }\n * }\n * ```\n */\nexport function orderToolCalls(\n  toolCalls: ToolCall[],\n  tools: Tool[],\n): ExecutionGroup[] {\n  if (toolCalls.length === 0) {\n    return [];\n  }\n\n  const toolMap = buildToolMap(tools);\n  const groups: ExecutionGroup[] = [];\n\n  // Track completed tool calls and tool names\n  const completedCallIds = new Set<string>();\n  const completedToolNames = new Set<string>();\n\n  // Create a queue of pending calls\n  const pending = [...toolCalls];\n\n  while (pending.length > 0) {\n    const readyForExecution: ToolCall[] = [];\n    let hasSequential = false;\n\n    // Find all calls that can execute now\n    const stillPending: ToolCall[] = [];\n\n    for (const call of pending) {\n      const tool = toolMap.get(call.toolName);\n      const toolDependsOn = tool?.dependsOn ?? [];\n      const modelDependsOn = getModelDependencies(call);\n\n      // Check if tool-level dependencies are satisfied\n      const toolDepsOk = toolDependsOn.every(\n        (depName) => completedToolNames.has(depName),\n      );\n\n      // Check if model-level dependencies are satisfied\n      const modelDepsOk = modelDependsOn.every(\n        (depId) => completedCallIds.has(depId),\n      );\n\n      if (toolDepsOk && modelDepsOk) {\n        readyForExecution.push(call);\n        if (tool?.sequential) {\n          hasSequential = true;\n        }\n      } else {\n        stillPending.push(call);\n      }\n    }\n\n    // If nothing is ready but we have pending items, there's a cycle\n    if (readyForExecution.length === 0 && stillPending.length > 0) {\n      // Break the cycle by executing remaining items\n      // This is a fallback - ideally dependencies should be acyclic\n      groups.push({\n        calls: stillPending,\n        isBarrier: false,\n      });\n      break;\n    }\n\n    // If we have sequential tools, they form a barrier\n    // Process them one at a time\n    if (hasSequential) {\n      for (const call of readyForExecution) {\n        const tool = toolMap.get(call.toolName);\n        groups.push({\n          calls: [call],\n          isBarrier: tool?.sequential ?? false,\n        });\n        completedCallIds.add(call.toolCallId);\n        completedToolNames.add(call.toolName);\n      }\n    } else {\n      // Non-sequential tools can be grouped for parallel execution\n      groups.push({\n        calls: readyForExecution,\n        isBarrier: false,\n      });\n      for (const call of readyForExecution) {\n        completedCallIds.add(call.toolCallId);\n        completedToolNames.add(call.toolName);\n      }\n    }\n\n    // Update pending list\n    pending.length = 0;\n    pending.push(...stillPending);\n  }\n\n  return groups;\n}\n\n/**\n * Check if any tools have execution dependencies defined.\n *\n * @param tools - Tool definitions to check\n * @returns true if any tool has sequential or dependsOn set\n */\nexport function hasToolDependencies(tools: Tool[]): boolean {\n  for (const tool of tools) {\n    const t = tool as ToolWithDependencies;\n    if (t.sequential || (t.dependsOn && t.dependsOn.length > 0)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Check if any tool calls have model-driven dependencies.\n *\n * @param toolCalls - Tool calls to check\n * @returns true if any call has the `after` field set\n */\nexport function hasCallDependencies(toolCalls: ToolCall[]): boolean {\n  for (const call of toolCalls) {\n    const ordered = call as OrderedToolCall;\n    if (ordered.after && ordered.after.length > 0) {\n      return true;\n    }\n  }\n  return false;\n}\n"]}
+{"version":3,"sources":["../../src/execution/react.ts","../../src/execution/plan.ts","../../src/execution/tool-ordering.ts"],"names":["UserMessage"],"mappings":"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","file":"index.js","sourcesContent":["import type { Turn, StreamEvent } from '@providerprotocol/ai';\nimport { UserMessage } from '@providerprotocol/ai';\nimport type {\n  ExecutionStrategy,\n  ExecutionContext,\n  ExecutionResult,\n  ReactOptions,\n  AgentStreamResult,\n  AgentStreamEvent,\n} from './types.ts';\n\nconst DEFAULT_REACT_OPTIONS: Required<ReactOptions> = {\n  maxSteps: Infinity,\n  reasoningPrompt: 'Think step by step about what you need to do next. Consider the current state, what tools are available, and what action would be most helpful.',\n};\n\n/**\n * Create a ReAct (Reason-Act-Observe) execution strategy.\n *\n * Behavior:\n * 1. Reason: LLM outputs reasoning about what to do next\n * 2. Act: LLM selects and executes tool(s)\n * 3. Observe: Tool results are formatted as observations\n * 4. Repeat until stop condition, no more actions, or maxSteps\n *\n * @param options - ReAct configuration options\n * @returns ExecutionStrategy\n */\nexport function react(options: ReactOptions = {}): ExecutionStrategy {\n  const opts = { ...DEFAULT_REACT_OPTIONS, ...options };\n\n  return {\n    name: 'react',\n\n    async execute(context: ExecutionContext): Promise<ExecutionResult> {\n      const { llm, input, state, strategy, signal } = context;\n\n      // Add input message to state and set agentId in metadata\n      // This ensures checkpoints include the full conversation\n      let currentState = state\n        .withMessage(input)\n        .withMetadata('agentId', context.agent.id);\n      let step = 0;\n      let finalTurn: Turn | undefined;\n\n      // Messages for LLM generation (includes input we just added)\n      const messages = [...currentState.messages];\n\n      while (true) {\n        step++;\n        currentState = currentState.withStep(step);\n\n        if (signal?.aborted) {\n          throw new Error('Execution aborted');\n        }\n\n        strategy.onStepStart?.(step, currentState);\n\n        // REASON PHASE: Ask LLM to think about what to do\n        const reasoningMessages = [\n          ...messages,\n          new UserMessage(opts.reasoningPrompt),\n        ];\n\n        const reasoningTurn = await llm.generate(reasoningMessages);\n\n        const reasoning = reasoningTurn.response.text;\n        currentState = currentState.withReasoning(reasoning);\n        strategy.onReason?.(step, reasoning);\n\n        // Add reasoning to conversation\n        messages.push(...reasoningTurn.messages);\n\n        // ACT PHASE: Execute with tools\n        const actionPrompt = new UserMessage(\n          'Based on your reasoning, take the appropriate action. Use tools if needed, or provide a final answer.',\n        );\n        messages.push(actionPrompt);\n\n        const actionTurn = await llm.generate(messages);\n        finalTurn = actionTurn;\n\n        // Update messages with action response\n        messages.push(...actionTurn.messages);\n        currentState = currentState.withMessages(actionTurn.messages);\n\n        // Handle tool calls\n        if (actionTurn.response.hasToolCalls) {\n          strategy.onAct?.(step, actionTurn.response.toolCalls ?? []);\n        }\n\n        // OBSERVE PHASE: Process tool results\n        if (actionTurn.toolExecutions && actionTurn.toolExecutions.length > 0) {\n          strategy.onObserve?.(step, actionTurn.toolExecutions);\n        }\n\n        strategy.onStepEnd?.(step, { turn: actionTurn, state: currentState });\n\n        // Check stop conditions\n        const shouldStop = await strategy.stopCondition?.(currentState);\n        if (shouldStop) {\n          break;\n        }\n\n        // No more tool calls means we're done\n        if (!actionTurn.response.hasToolCalls) {\n          break;\n        }\n\n        // Check step limit\n        if (opts.maxSteps !== Infinity && step >= opts.maxSteps) {\n          break;\n        }\n      }\n\n      if (!finalTurn) {\n        throw new Error('No turn generated');\n      }\n\n      // Include sessionId in state metadata if checkpointing is enabled\n      let finalState = currentState;\n      if (context.sessionId) {\n        finalState = currentState.withMetadata('sessionId', context.sessionId);\n      }\n\n      const result: ExecutionResult = {\n        turn: finalTurn,\n        state: finalState,\n      };\n\n      strategy.onComplete?.(result);\n\n      return result;\n    },\n\n    stream(context: ExecutionContext): AgentStreamResult {\n      const { llm, input, state, strategy, signal } = context;\n      const agentId = context.agent.id;\n\n      let aborted = false;\n      const abortController = new AbortController();\n\n      if (signal) {\n        signal.addEventListener('abort', () => abortController.abort());\n      }\n\n      let resolveResult: (result: ExecutionResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<ExecutionResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      async function* generateEvents(): AsyncGenerator<AgentStreamEvent> {\n        // Add input message to state and set agentId in metadata\n        // This ensures checkpoints include the full conversation\n        let currentState = state\n          .withMessage(input)\n          .withMetadata('agentId', context.agent.id);\n        let step = 0;\n        let finalTurn: Turn | undefined;\n\n        // Messages for LLM generation (includes input we just added)\n        const messages = [...currentState.messages];\n\n        try {\n          while (!aborted) {\n            step++;\n            currentState = currentState.withStep(step);\n\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            strategy.onStepStart?.(step, currentState);\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_start',\n                step,\n                agentId,\n                data: { phase: 'reasoning' },\n              },\n            };\n\n            // REASON PHASE\n            const reasoningMessages = [\n              ...messages,\n              new UserMessage(opts.reasoningPrompt),\n            ];\n\n            const reasoningStream = llm.stream(reasoningMessages);\n            let reasoningText = '';\n\n            for await (const event of reasoningStream as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              yield { source: 'upp', upp: event };\n\n              if (event.type === 'text_delta' && event.delta.text) {\n                reasoningText += event.delta.text;\n              }\n            }\n\n            const reasoningTurn = await reasoningStream.turn;\n            currentState = currentState.withReasoning(reasoningText || reasoningTurn.response.text);\n            strategy.onReason?.(step, reasoningText || reasoningTurn.response.text);\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'reasoning',\n                step,\n                agentId,\n                data: { reasoning: reasoningText || reasoningTurn.response.text },\n              },\n            };\n\n            messages.push(...reasoningTurn.messages);\n\n            // ACT PHASE\n            const actionPrompt = new UserMessage(\n              'Based on your reasoning, take the appropriate action. Use tools if needed, or provide a final answer.',\n            );\n            messages.push(actionPrompt);\n\n            const actionStream = llm.stream(messages);\n\n            for await (const event of actionStream as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              yield { source: 'upp', upp: event };\n            }\n\n            const actionTurn = await actionStream.turn;\n            finalTurn = actionTurn;\n\n            messages.push(...actionTurn.messages);\n            currentState = currentState.withMessages(actionTurn.messages);\n\n            if (actionTurn.response.hasToolCalls) {\n              strategy.onAct?.(step, actionTurn.response.toolCalls ?? []);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'action',\n                  step,\n                  agentId,\n                  data: { toolCalls: actionTurn.response.toolCalls },\n                },\n              };\n            }\n\n            if (actionTurn.toolExecutions && actionTurn.toolExecutions.length > 0) {\n              strategy.onObserve?.(step, actionTurn.toolExecutions);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'observation',\n                  step,\n                  agentId,\n                  data: { observations: actionTurn.toolExecutions },\n                },\n              };\n            }\n\n            strategy.onStepEnd?.(step, { turn: actionTurn, state: currentState });\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_end',\n                step,\n                agentId,\n                data: { phase: 'complete' },\n              },\n            };\n\n            const shouldStop = await strategy.stopCondition?.(currentState);\n            if (shouldStop) {\n              break;\n            }\n\n            if (!actionTurn.response.hasToolCalls) {\n              break;\n            }\n\n            if (opts.maxSteps !== Infinity && step >= opts.maxSteps) {\n              break;\n            }\n          }\n\n          if (!finalTurn) {\n            throw new Error('No turn generated');\n          }\n\n          // Include sessionId in state metadata if checkpointing is enabled\n          let finalState = currentState;\n          if (context.sessionId) {\n            finalState = currentState.withMetadata('sessionId', context.sessionId);\n          }\n\n          const result: ExecutionResult = {\n            turn: finalTurn,\n            state: finalState,\n          };\n\n          strategy.onComplete?.(result);\n          resolveResult(result);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          strategy.onError?.(err, currentState);\n          rejectResult(err);\n          throw err;\n        }\n      }\n\n      const iterator = generateEvents();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n  };\n}\n","import type { Turn, StreamEvent } from '@providerprotocol/ai';\nimport { UserMessage } from '@providerprotocol/ai';\nimport type { PlanStep } from '../state/index.ts';\nimport { generateUUID } from '../utils/uuid.ts';\nimport type {\n  ExecutionStrategy,\n  ExecutionContext,\n  ExecutionResult,\n  PlanOptions,\n  AgentStreamResult,\n  AgentStreamEvent,\n} from './types.ts';\n\nconst DEFAULT_PLAN_OPTIONS: Required<PlanOptions> = {\n  maxPlanSteps: Infinity,\n  allowReplan: true,\n  planSchema: {\n    type: 'object',\n    properties: {\n      steps: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            id: { type: 'string', description: 'Unique step identifier' },\n            description: { type: 'string', description: 'What this step does' },\n            tool: { type: 'string', description: 'Tool to use (if applicable)' },\n            dependsOn: {\n              type: 'array',\n              items: { type: 'string' },\n              description: 'IDs of steps this depends on',\n            },\n          },\n          required: ['id', 'description', 'dependsOn'],\n        },\n      },\n    },\n    required: ['steps'],\n  },\n};\n\nconst PLAN_PROMPT = `Create a detailed execution plan to accomplish the task.\nBreak it down into clear steps, specifying which tool to use for each step if applicable.\nInclude dependencies between steps (which steps must complete before others can start).\nReturn your plan as a JSON object with a \"steps\" array.`;\n\n/**\n * Create a plan-then-execute strategy.\n *\n * Behavior:\n * 1. Plan: LLM generates structured plan with steps and dependencies\n * 2. Execute: Execute each plan step respecting dependency order\n * 3. Replan: If a step fails and allowReplan is true, generate new plan\n *\n * @param options - Plan configuration options\n * @returns ExecutionStrategy\n */\nexport function plan(options: PlanOptions = {}): ExecutionStrategy {\n  const opts = { ...DEFAULT_PLAN_OPTIONS, ...options };\n\n  return {\n    name: 'plan',\n\n    async execute(context: ExecutionContext): Promise<ExecutionResult> {\n      const { llm, input, state, strategy, signal } = context;\n\n      // Add input message to state and set agentId in metadata\n      // This ensures checkpoints include the full conversation\n      let currentState = state\n        .withMessage(input)\n        .withMetadata('agentId', context.agent.id);\n      let step = 0;\n      let finalTurn: Turn | undefined;\n\n      // Messages for LLM generation (includes input we just added)\n      const messages = [...currentState.messages];\n\n      // PLANNING PHASE\n      step++;\n      currentState = currentState.withStep(step);\n\n      if (signal?.aborted) {\n        throw new Error('Execution aborted');\n      }\n\n      strategy.onStepStart?.(step, currentState);\n\n      // Generate the plan\n      const planMessages = [\n        ...messages,\n        new UserMessage(PLAN_PROMPT),\n      ];\n\n      const planTurn = await llm.generate(planMessages);\n\n      // Parse the plan from the response\n      let planData: { steps: Array<{ id: string; description: string; tool?: string; dependsOn: string[] }> };\n\n      try {\n        if (planTurn.data) {\n          planData = planTurn.data as typeof planData;\n        } else {\n          // Try to parse from text\n          const jsonMatch = planTurn.response.text.match(/\\{[\\s\\S]*\\}/);\n          if (jsonMatch) {\n            planData = JSON.parse(jsonMatch[0]) as typeof planData;\n          } else {\n            throw new Error('Could not parse plan from response');\n          }\n        }\n      } catch (err) {\n        throw new Error(`Failed to parse execution plan: ${err instanceof Error ? err.message : String(err)}`);\n      }\n\n      // Convert to PlanStep format\n      let planSteps: PlanStep[] = planData.steps.map((s) => ({\n        id: s.id || generateUUID(),\n        description: s.description,\n        tool: s.tool,\n        dependsOn: s.dependsOn || [],\n        status: 'pending' as const,\n      }));\n\n      // Apply maxPlanSteps limit\n      if (opts.maxPlanSteps !== Infinity && planSteps.length > opts.maxPlanSteps) {\n        planSteps = planSteps.slice(0, opts.maxPlanSteps);\n      }\n\n      currentState = currentState.withPlan(planSteps);\n      messages.push(...planTurn.messages);\n\n      strategy.onStepEnd?.(step, { turn: planTurn, state: currentState });\n\n      // EXECUTION PHASE\n      const completedSteps = new Set<string>();\n\n      // Execute steps in topological order\n      while (planSteps.some((s) => s.status === 'pending')) {\n        // Find next executable step (all dependencies completed)\n        const nextStep = planSteps.find(\n          (s) => s.status === 'pending'\n            && s.dependsOn.every((depId) => completedSteps.has(depId)),\n        );\n\n        if (!nextStep) {\n          // No step can be executed - either done or cyclic dependency\n          break;\n        }\n\n        step++;\n        currentState = currentState.withStep(step);\n\n        if (signal?.aborted) {\n          throw new Error('Execution aborted');\n        }\n\n        strategy.onStepStart?.(step, currentState);\n\n        // Update step status to in_progress\n        nextStep.status = 'in_progress';\n        currentState = currentState.withPlan([...planSteps]);\n\n        // Execute the step\n        const stepPrompt = new UserMessage(\n          `Execute step \"${nextStep.id}\": ${nextStep.description}${nextStep.tool ? ` using the ${nextStep.tool} tool` : ''}`,\n        );\n        messages.push(stepPrompt);\n\n        try {\n          const stepTurn = await llm.generate(messages);\n          finalTurn = stepTurn;\n\n          messages.push(...stepTurn.messages);\n          currentState = currentState.withMessages(stepTurn.messages);\n\n          if (stepTurn.response.hasToolCalls) {\n            strategy.onAct?.(step, stepTurn.response.toolCalls ?? []);\n          }\n\n          if (stepTurn.toolExecutions && stepTurn.toolExecutions.length > 0) {\n            strategy.onObserve?.(step, stepTurn.toolExecutions);\n          }\n\n          // Mark step as completed\n          nextStep.status = 'completed';\n          completedSteps.add(nextStep.id);\n          currentState = currentState.withPlan([...planSteps]);\n\n          strategy.onStepEnd?.(step, { turn: stepTurn, state: currentState });\n        } catch (err) {\n          nextStep.status = 'failed';\n          currentState = currentState.withPlan([...planSteps]);\n\n          if (opts.allowReplan) {\n            // Could implement replanning here\n            // For now, just continue and let the error propagate\n          }\n\n          throw err;\n        }\n\n        // Check stop condition\n        const shouldStop = await strategy.stopCondition?.(currentState);\n        if (shouldStop) {\n          break;\n        }\n      }\n\n      if (!finalTurn) {\n        finalTurn = planTurn; // Use plan turn if no execution happened\n      }\n\n      // Include sessionId in state metadata if checkpointing is enabled\n      let finalState = currentState;\n      if (context.sessionId) {\n        finalState = currentState.withMetadata('sessionId', context.sessionId);\n      }\n\n      const result: ExecutionResult = {\n        turn: finalTurn,\n        state: finalState,\n      };\n\n      strategy.onComplete?.(result);\n\n      return result;\n    },\n\n    stream(context: ExecutionContext): AgentStreamResult {\n      const { llm, input, state, strategy, signal } = context;\n      const agentId = context.agent.id;\n\n      let aborted = false;\n      const abortController = new AbortController();\n\n      if (signal) {\n        signal.addEventListener('abort', () => abortController.abort());\n      }\n\n      let resolveResult: (result: ExecutionResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<ExecutionResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      async function* generateEvents(): AsyncGenerator<AgentStreamEvent> {\n        // Add input message to state and set agentId in metadata\n        // This ensures checkpoints include the full conversation\n        let currentState = state\n          .withMessage(input)\n          .withMetadata('agentId', context.agent.id);\n        let step = 0;\n        let finalTurn: Turn | undefined;\n\n        // Messages for LLM generation (includes input we just added)\n        const messages = [...currentState.messages];\n\n        try {\n          // PLANNING PHASE\n          step++;\n          currentState = currentState.withStep(step);\n\n          if (abortController.signal.aborted) {\n            throw new Error('Execution aborted');\n          }\n\n          strategy.onStepStart?.(step, currentState);\n\n          yield {\n            source: 'uap',\n            uap: {\n              type: 'step_start',\n              step,\n              agentId,\n              data: { phase: 'planning' },\n            },\n          };\n\n          const planMessages = [\n            ...messages,\n            new UserMessage(PLAN_PROMPT),\n          ];\n\n          const planStream = llm.stream(planMessages);\n\n          for await (const event of planStream as AsyncIterable<StreamEvent>) {\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            yield { source: 'upp', upp: event };\n          }\n\n          const planTurn = await planStream.turn;\n\n          let planData: { steps: Array<{ id: string; description: string; tool?: string; dependsOn: string[] }> };\n\n          try {\n            if (planTurn.data) {\n              planData = planTurn.data as typeof planData;\n            } else {\n              const jsonMatch = planTurn.response.text.match(/\\{[\\s\\S]*\\}/);\n              if (jsonMatch) {\n                planData = JSON.parse(jsonMatch[0]) as typeof planData;\n              } else {\n                throw new Error('Could not parse plan from response');\n              }\n            }\n          } catch (err) {\n            throw new Error(`Failed to parse execution plan: ${err instanceof Error ? err.message : String(err)}`);\n          }\n\n          let planSteps: PlanStep[] = planData.steps.map((s) => ({\n            id: s.id || generateUUID(),\n            description: s.description,\n            tool: s.tool,\n            dependsOn: s.dependsOn || [],\n            status: 'pending' as const,\n          }));\n\n          if (opts.maxPlanSteps !== Infinity && planSteps.length > opts.maxPlanSteps) {\n            planSteps = planSteps.slice(0, opts.maxPlanSteps);\n          }\n\n          currentState = currentState.withPlan(planSteps);\n          messages.push(...planTurn.messages);\n\n          yield {\n            source: 'uap',\n            uap: {\n              type: 'plan_created',\n              step,\n              agentId,\n              data: { plan: planSteps },\n            },\n          };\n\n          strategy.onStepEnd?.(step, { turn: planTurn, state: currentState });\n\n          yield {\n            source: 'uap',\n            uap: {\n              type: 'step_end',\n              step,\n              agentId,\n              data: { phase: 'planning' },\n            },\n          };\n\n          // EXECUTION PHASE\n          const completedSteps = new Set<string>();\n\n          while (planSteps.some((s) => s.status === 'pending') && !aborted) {\n            const nextStep = planSteps.find(\n              (s) => s.status === 'pending'\n                && s.dependsOn.every((depId) => completedSteps.has(depId)),\n            );\n\n            if (!nextStep) {\n              break;\n            }\n\n            step++;\n            currentState = currentState.withStep(step);\n\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            strategy.onStepStart?.(step, currentState);\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'plan_step_start',\n                step,\n                agentId,\n                data: { planStep: nextStep },\n              },\n            };\n\n            nextStep.status = 'in_progress';\n            currentState = currentState.withPlan([...planSteps]);\n\n            const stepPrompt = new UserMessage(\n              `Execute step \"${nextStep.id}\": ${nextStep.description}${nextStep.tool ? ` using the ${nextStep.tool} tool` : ''}`,\n            );\n            messages.push(stepPrompt);\n\n            const stepStream = llm.stream(messages);\n\n            for await (const event of stepStream as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              yield { source: 'upp', upp: event };\n            }\n\n            const stepTurn = await stepStream.turn;\n            finalTurn = stepTurn;\n\n            messages.push(...stepTurn.messages);\n            currentState = currentState.withMessages(stepTurn.messages);\n\n            if (stepTurn.response.hasToolCalls) {\n              strategy.onAct?.(step, stepTurn.response.toolCalls ?? []);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'action',\n                  step,\n                  agentId,\n                  data: { toolCalls: stepTurn.response.toolCalls },\n                },\n              };\n            }\n\n            if (stepTurn.toolExecutions && stepTurn.toolExecutions.length > 0) {\n              strategy.onObserve?.(step, stepTurn.toolExecutions);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'observation',\n                  step,\n                  agentId,\n                  data: { observations: stepTurn.toolExecutions },\n                },\n              };\n            }\n\n            nextStep.status = 'completed';\n            completedSteps.add(nextStep.id);\n            currentState = currentState.withPlan([...planSteps]);\n\n            strategy.onStepEnd?.(step, { turn: stepTurn, state: currentState });\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'plan_step_end',\n                step,\n                agentId,\n                data: { planStep: nextStep },\n              },\n            };\n\n            const shouldStop = await strategy.stopCondition?.(currentState);\n            if (shouldStop) {\n              break;\n            }\n          }\n\n          if (!finalTurn) {\n            finalTurn = planTurn;\n          }\n\n          // Include sessionId in state metadata if checkpointing is enabled\n          let finalState = currentState;\n          if (context.sessionId) {\n            finalState = currentState.withMetadata('sessionId', context.sessionId);\n          }\n\n          const result: ExecutionResult = {\n            turn: finalTurn,\n            state: finalState,\n          };\n\n          strategy.onComplete?.(result);\n          resolveResult(result);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          strategy.onError?.(err, currentState);\n          rejectResult(err);\n          throw err;\n        }\n      }\n\n      const iterator = generateEvents();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n  };\n}\n","import type { Tool, ToolCall } from '@providerprotocol/ai';\nimport type { ToolWithDependencies, OrderedToolCall } from './types.ts';\n\n/**\n * Execution group - a set of tool calls that can execute in parallel.\n */\nexport interface ExecutionGroup {\n  /** Tool calls in this group */\n  calls: ToolCall[];\n  /** Whether this group contains a sequential tool (acts as barrier) */\n  isBarrier: boolean;\n}\n\n/**\n * Build a map of tool definitions by name for quick lookup.\n */\nfunction buildToolMap(tools: Tool[]): Map<string, ToolWithDependencies> {\n  const map = new Map<string, ToolWithDependencies>();\n  for (const tool of tools) {\n    map.set(tool.name, tool as ToolWithDependencies);\n  }\n  return map;\n}\n\n/**\n * Check if a tool call has an explicit dependency via model hint.\n */\nfunction getModelDependencies(call: ToolCall): string[] {\n  const orderedCall = call as OrderedToolCall;\n  return orderedCall.after ?? [];\n}\n\n/**\n * Order tool calls into execution groups respecting dependencies.\n *\n * This function takes a list of tool calls and the available tools,\n * then groups them for execution while respecting:\n * 1. Tool-level `sequential` flag (creates execution barriers)\n * 2. Tool-level `dependsOn` array (tool must wait for named tools)\n * 3. Model-driven `after` array on tool calls (call must wait for specific calls)\n *\n * @param toolCalls - Tool calls from the model response\n * @param tools - Tool definitions (may include dependency options)\n * @returns Ordered array of execution groups\n *\n * @example\n * ```typescript\n * const groups = orderToolCalls(turn.response.toolCalls, agent.tools);\n *\n * for (const group of groups) {\n *   if (group.isBarrier) {\n *     // Execute sequentially\n *     for (const call of group.calls) {\n *       await executeTool(call);\n *     }\n *   } else {\n *     // Execute in parallel\n *     await Promise.all(group.calls.map(executeTool));\n *   }\n * }\n * ```\n */\nexport function orderToolCalls(\n  toolCalls: ToolCall[],\n  tools: Tool[],\n): ExecutionGroup[] {\n  if (toolCalls.length === 0) {\n    return [];\n  }\n\n  const toolMap = buildToolMap(tools);\n  const groups: ExecutionGroup[] = [];\n\n  // Track completed tool calls and tool names\n  const completedCallIds = new Set<string>();\n  const completedToolNames = new Set<string>();\n\n  // Create a queue of pending calls\n  const pending = [...toolCalls];\n\n  while (pending.length > 0) {\n    const readyForExecution: ToolCall[] = [];\n    let hasSequential = false;\n\n    // Find all calls that can execute now\n    const stillPending: ToolCall[] = [];\n\n    for (const call of pending) {\n      const tool = toolMap.get(call.toolName);\n      const toolDependsOn = tool?.dependsOn ?? [];\n      const modelDependsOn = getModelDependencies(call);\n\n      // Check if tool-level dependencies are satisfied\n      const toolDepsOk = toolDependsOn.every(\n        (depName) => completedToolNames.has(depName),\n      );\n\n      // Check if model-level dependencies are satisfied\n      const modelDepsOk = modelDependsOn.every(\n        (depId) => completedCallIds.has(depId),\n      );\n\n      if (toolDepsOk && modelDepsOk) {\n        readyForExecution.push(call);\n        if (tool?.sequential) {\n          hasSequential = true;\n        }\n      } else {\n        stillPending.push(call);\n      }\n    }\n\n    // If nothing is ready but we have pending items, there's a cycle\n    if (readyForExecution.length === 0 && stillPending.length > 0) {\n      // Break the cycle by executing remaining items\n      // This is a fallback - ideally dependencies should be acyclic\n      groups.push({\n        calls: stillPending,\n        isBarrier: false,\n      });\n      break;\n    }\n\n    // If we have sequential tools, they form a barrier\n    // Process them one at a time\n    if (hasSequential) {\n      for (const call of readyForExecution) {\n        const tool = toolMap.get(call.toolName);\n        groups.push({\n          calls: [call],\n          isBarrier: tool?.sequential ?? false,\n        });\n        completedCallIds.add(call.toolCallId);\n        completedToolNames.add(call.toolName);\n      }\n    } else {\n      // Non-sequential tools can be grouped for parallel execution\n      groups.push({\n        calls: readyForExecution,\n        isBarrier: false,\n      });\n      for (const call of readyForExecution) {\n        completedCallIds.add(call.toolCallId);\n        completedToolNames.add(call.toolName);\n      }\n    }\n\n    // Update pending list\n    pending.length = 0;\n    pending.push(...stillPending);\n  }\n\n  return groups;\n}\n\n/**\n * Check if any tools have execution dependencies defined.\n *\n * @param tools - Tool definitions to check\n * @returns true if any tool has sequential or dependsOn set\n */\nexport function hasToolDependencies(tools: Tool[]): boolean {\n  for (const tool of tools) {\n    const t = tool as ToolWithDependencies;\n    if (t.sequential || (t.dependsOn && t.dependsOn.length > 0)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Check if any tool calls have model-driven dependencies.\n *\n * @param toolCalls - Tool calls to check\n * @returns true if any call has the `after` field set\n */\nexport function hasCallDependencies(toolCalls: ToolCall[]): boolean {\n  for (const call of toolCalls) {\n    const ordered = call as OrderedToolCall;\n    if (ordered.after && ordered.after.length > 0) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Result of executing a tool call.\n */\nexport interface ToolExecutionResult {\n  /** The tool call that was executed */\n  call: ToolCall;\n  /** The result from the tool */\n  result: unknown;\n  /** Whether the tool threw an error */\n  isError: boolean;\n  /** Error message if isError is true */\n  error?: string;\n  /** Execution duration in milliseconds */\n  duration: number;\n}\n\n/**\n * Function type for executing a single tool call.\n */\nexport type ToolExecutor = (call: ToolCall, tool: Tool) => Promise<unknown>;\n\n/**\n * Execute tool calls respecting dependency ordering.\n *\n * This function takes tool calls, orders them using `orderToolCalls()`,\n * and executes them respecting barriers (sequential tools) and\n * dependencies (dependsOn, after).\n *\n * Per UAP-1.0 Sections 8.5 and 8.6:\n * - Tools with `sequential: true` execute alone (barrier)\n * - Tools with `dependsOn` wait for named tools to complete\n * - Tool calls with `after` wait for specific call IDs to complete\n *\n * @param toolCalls - Tool calls from the model response\n * @param tools - Tool definitions with potential dependencies\n * @param executor - Function to execute a single tool call\n * @returns Array of execution results in completion order\n *\n * @example\n * ```typescript\n * import { executeOrderedToolCalls } from '@providerprotocol/agents/execution';\n *\n * // Define tools with dependencies\n * const readTool: ToolWithDependencies = {\n *   name: 'read_file',\n *   sequential: true, // Must complete before others\n *   run: async (params) => readFile(params.path),\n * };\n *\n * const processTool: ToolWithDependencies = {\n *   name: 'process',\n *   dependsOn: ['read_file'], // Wait for read_file\n *   run: async (params) => process(params.data),\n * };\n *\n * // Execute with ordering\n * const results = await executeOrderedToolCalls(\n *   turn.response.toolCalls,\n *   [readTool, processTool],\n *   async (call, tool) => tool.run(call.arguments),\n * );\n * ```\n */\nexport async function executeOrderedToolCalls(\n  toolCalls: ToolCall[],\n  tools: Tool[],\n  executor: ToolExecutor,\n): Promise<ToolExecutionResult[]> {\n  if (toolCalls.length === 0) {\n    return [];\n  }\n\n  const toolMap = new Map<string, Tool>();\n  for (const tool of tools) {\n    toolMap.set(tool.name, tool);\n  }\n\n  const groups = orderToolCalls(toolCalls, tools);\n  const results: ToolExecutionResult[] = [];\n\n  for (const group of groups) {\n    if (group.isBarrier) {\n      // Sequential execution - one at a time\n      for (const call of group.calls) {\n        const tool = toolMap.get(call.toolName);\n        if (!tool) {\n          results.push({\n            call,\n            result: null,\n            isError: true,\n            error: `Tool not found: ${call.toolName}`,\n            duration: 0,\n          });\n          continue;\n        }\n\n        const result = await executeOne(call, tool, executor);\n        results.push(result);\n      }\n    } else {\n      // Parallel execution\n      const groupResults = await Promise.all(\n        group.calls.map(async (call) => {\n          const tool = toolMap.get(call.toolName);\n          if (!tool) {\n            return {\n              call,\n              result: null,\n              isError: true,\n              error: `Tool not found: ${call.toolName}`,\n              duration: 0,\n            };\n          }\n          return executeOne(call, tool, executor);\n        }),\n      );\n      results.push(...groupResults);\n    }\n  }\n\n  return results;\n}\n\n/**\n * Execute a single tool call with timing and error handling.\n */\nasync function executeOne(\n  call: ToolCall,\n  tool: Tool,\n  executor: ToolExecutor,\n): Promise<ToolExecutionResult> {\n  const startTime = Date.now();\n\n  try {\n    const result = await executor(call, tool);\n    return {\n      call,\n      result,\n      isError: false,\n      duration: Date.now() - startTime,\n    };\n  } catch (error) {\n    const err = error instanceof Error ? error : new Error(String(error));\n    return {\n      call,\n      result: null,\n      isError: true,\n      error: err.message,\n      duration: Date.now() - startTime,\n    };\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,11 +1,12 @@
-import { LLMOptions, ModelReference, LLMInstance, Tool, Message, Turn } from '@providerprotocol/ai';
+import { LLMOptions, ModelReference, LLMInstance, Tool, Message, Turn, JSONSchema } from '@providerprotocol/ai';
 import { A as AgentState } from './index-qsPwbY86.js';
-import { E as ExecutionStrategy, A as AgentStrategy, G as GenerateResult, a as AgentStreamResult } from './types-D1egxttz.js';
-export { b as AgentStreamEvent, O as OnSubagentEvent, f as SubagentEndEvent, g as SubagentEvent, c as SubagentEventBase, S as SubagentEventType, e as SubagentInnerEvent, d as SubagentStartEvent, U as UAPEventType } from './types-D1egxttz.js';
-import { M as Middleware } from './types-BiyEVOnf.js';
+import { E as ExecutionStrategy, A as AgentStrategy, G as GenerateResult, a as AgentStreamResult, T as ToolExecutionContext } from './types-DC8XeoaI.js';
+export { b as AgentStreamEvent, C as ContextAwareToolRun, O as OnSubagentEvent, f as SubagentEndEvent, g as SubagentEvent, c as SubagentEventBase, S as SubagentEventType, e as SubagentInnerEvent, d as SubagentStartEvent, U as UAPEventType } from './types-DC8XeoaI.js';
+import { M as Middleware } from './types-B9VuAOo6.js';
 import { C as CheckpointStore } from './types-DChRdQoX.js';
 export { b as CheckpointData, a as CheckpointMetadata, F as FileCheckpointOptions } from './types-DChRdQoX.js';
 export { ThreadNode, ThreadNodeJSON, ThreadTree, ThreadTreeJSON } from './thread-tree/index.js';
+export { I as InjectToolContextOptions, i as injectToolContext, a as isContextAwareTool, w as withToolContext } from './tool-context-Cc_qNVud.js';
 export { A as AgentStateInterface, a as AgentStateJSON, P as PlanStep, b as PlanStepStatus, S as SubagentExecutionTrace, c as SubagentExecutionTraceJSON, T as ToolExecutionTrace } from './types-2Vsthzyu.js';
 
 /**
@@ -98,4 +99,121 @@ interface Agent {
  */
 declare function agent(options: AgentOptions): Agent;
 
-export { type Agent, type AgentOptions, AgentState, AgentStrategy, AgentStreamResult, CheckpointStore, GenerateResult, agent };
+/**
+ * Sub-agent tool creation utilities.
+ *
+ * Per UAP-1.0 Section 8.7, implementations SHOULD provide helper utilities
+ * for creating sub-agent tools with event propagation.
+ *
+ * @example
+ * ```typescript
+ * import { agent } from '@providerprotocol/agents';
+ * import { createSubAgentTool } from '@providerprotocol/agents/subagent';
+ *
+ * // Create a sub-agent
+ * const explorer = agent({
+ *   model: anthropic('claude-haiku-4-20250514'),
+ *   tools: [Glob, Grep, Read],
+ *   system: 'You explore codebases.',
+ * });
+ *
+ * // Wrap as a tool with event propagation
+ * const explorerTool = createSubAgentTool({
+ *   agent: explorer,
+ *   name: 'explore_codebase',
+ *   description: 'Explore and find relevant code',
+ *   parameters: {
+ *     type: 'object',
+ *     properties: {
+ *       query: { type: 'string', description: 'What to find' },
+ *     },
+ *     required: ['query'],
+ *   },
+ *   buildPrompt: (params) => `Find: ${params.query}`,
+ *   subagentType: 'explorer',
+ * });
+ *
+ * // Use in parent agent
+ * const coder = agent({
+ *   model: anthropic('claude-sonnet-4-20250514'),
+ *   tools: [Bash, Write, explorerTool],
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for creating a sub-agent tool.
+ */
+interface CreateSubAgentToolOptions {
+    /** The sub-agent to expose as a tool */
+    agent: Agent;
+    /** Tool name (must be unique within parent agent's tools) */
+    name: string;
+    /** Tool description for the model */
+    description: string;
+    /** JSON Schema for tool parameters */
+    parameters: JSONSchema;
+    /** Convert tool parameters to a prompt for the sub-agent */
+    buildPrompt: (params: Record<string, unknown>) => string;
+    /**
+     * Identifier for the sub-agent type (used in events).
+     * Defaults to the tool name.
+     */
+    subagentType?: string;
+    /**
+     * Whether to stream the sub-agent execution.
+     * When true, inner events are forwarded to parent.
+     * Default: true
+     */
+    stream?: boolean;
+}
+/**
+ * Create a UPP Tool from a UAP Agent with full event propagation.
+ *
+ * Per UAP-1.0 Section 8.7, this helper:
+ * 1. Emits `subagent_start` before execution begins
+ * 2. Forwards inner events during streaming execution
+ * 3. Emits `subagent_end` after completion (success or failure)
+ * 4. Provides execution context to sub-agent for tracing
+ *
+ * The created tool accepts an optional `ToolExecutionContext` as a second
+ * parameter, which is injected by `injectToolContext()` during execution.
+ *
+ * @param options - Configuration for the sub-agent tool
+ * @returns A Tool that executes the sub-agent and propagates events
+ *
+ * @example
+ * ```typescript
+ * const summarizer = agent({
+ *   model: anthropic('claude-haiku-4-20250514'),
+ *   system: 'You summarize text concisely.',
+ * });
+ *
+ * const summarizerTool = createSubAgentTool({
+ *   agent: summarizer,
+ *   name: 'summarize',
+ *   description: 'Summarize the given text',
+ *   parameters: {
+ *     type: 'object',
+ *     properties: {
+ *       text: { type: 'string', description: 'Text to summarize' },
+ *       maxLength: { type: 'number', description: 'Max summary length' },
+ *     },
+ *     required: ['text'],
+ *   },
+ *   buildPrompt: (params) =>
+ *     `Summarize this in ${params.maxLength ?? 100} words:\n\n${params.text}`,
+ *   subagentType: 'summarizer',
+ * });
+ * ```
+ */
+declare function createSubAgentTool(options: CreateSubAgentToolOptions): Tool;
+/**
+ * Type for the run function of a sub-agent tool.
+ * Accepts params and optional execution context.
+ */
+type SubAgentToolRun = (params: Record<string, unknown>, context?: ToolExecutionContext) => Promise<string>;
+
+export { type Agent, type AgentOptions, AgentState, AgentStrategy, AgentStreamResult, CheckpointStore, type CreateSubAgentToolOptions, GenerateResult, type SubAgentToolRun, ToolExecutionContext, agent, createSubAgentTool };

package/dist/index.js

@@ -1,4 +1,5 @@
-import { loop } from './chunk-4ESYN66B.js';
+import { loop } from './chunk-CEHXAE4Z.js';
+export { injectToolContext, isContextAwareTool, withToolContext } from './chunk-CEHXAE4Z.js';
 import { AgentState } from './chunk-T47B3VAF.js';
 export { AgentState, ThreadNode, ThreadTree } from './chunk-T47B3VAF.js';
 import { generateUUID } from './chunk-EKRXMSDX.js';
@@ -185,24 +186,7 @@ function agent(options) {
       };
     },
     async ask(input, state) {
-      const normalizedInput = normalizeInput(input);
-      const result = await agentInstance.generate(normalizedInput, state);
-      const responseMessages = result.state.messages.slice(state.messages.length);
-      const finalState = state.withMessage(normalizedInput).withMessages(responseMessages).withStep(result.state.step);
-      let stateWithMetadata = finalState;
-      for (const [key, value] of Object.entries(result.state.metadata)) {
-        stateWithMetadata = stateWithMetadata.withMetadata(key, value);
-      }
-      for (const reasoning of result.state.reasoning) {
-        stateWithMetadata = stateWithMetadata.withReasoning(reasoning);
-      }
-      if (result.state.plan) {
-        stateWithMetadata = stateWithMetadata.withPlan([...result.state.plan]);
-      }
-      return {
-        turn: result.turn,
-        state: stateWithMetadata
-      };
+      return agentInstance.generate(input, state);
     },
     async query(input) {
       const initialState = AgentState.initial();
@@ -213,6 +197,123 @@ function agent(options) {
   return agentInstance;
 }
 
-export { agent };
+// src/subagent/index.ts
+function createSubAgentTool(options) {
+  const {
+    agent: agent2,
+    name,
+    description,
+    parameters,
+    buildPrompt,
+    subagentType = name,
+    stream: shouldStream = true
+  } = options;
+  return {
+    name,
+    description,
+    parameters,
+    run: async (params, context) => {
+      const subagentId = generateUUID();
+      const toolCallId = context?.toolCallId ?? generateUUID();
+      const emit = context?.onSubagentEvent;
+      const prompt = buildPrompt(params);
+      const startTime = Date.now();
+      const startEvent = {
+        type: "subagent_start",
+        subagentId,
+        subagentType,
+        parentToolCallId: toolCallId,
+        prompt,
+        timestamp: startTime
+      };
+      emit?.(startEvent);
+      try {
+        if (shouldStream) {
+          return await executeWithStreaming(
+            agent2,
+            prompt,
+            subagentId,
+            subagentType,
+            toolCallId,
+            emit
+          );
+        }
+        return await executeWithoutStreaming(
+          agent2,
+          prompt,
+          subagentId,
+          subagentType,
+          toolCallId,
+          emit
+        );
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        const endEvent = {
+          type: "subagent_end",
+          subagentId,
+          subagentType,
+          parentToolCallId: toolCallId,
+          success: false,
+          error: err.message,
+          timestamp: Date.now()
+        };
+        emit?.(endEvent);
+        throw err;
+      }
+    }
+  };
+}
+async function executeWithStreaming(agent2, prompt, subagentId, subagentType, toolCallId, emit) {
+  const stream = agent2.stream(prompt, AgentState.initial());
+  for await (const event of stream) {
+    emit?.({
+      type: "subagent_event",
+      subagentId,
+      subagentType,
+      parentToolCallId: toolCallId,
+      innerEvent: event
+    });
+  }
+  const result = await stream.result;
+  const endEvent = {
+    type: "subagent_end",
+    subagentId,
+    subagentType,
+    parentToolCallId: toolCallId,
+    success: true,
+    result: result.turn.response.text,
+    timestamp: Date.now(),
+    toolExecutions: result.turn.toolExecutions?.map((te) => ({
+      toolName: te.toolName,
+      arguments: te.arguments,
+      result: String(te.result)
+    })),
+    usage: result.turn.usage
+  };
+  emit?.(endEvent);
+  return result.turn.response.text;
+}
+async function executeWithoutStreaming(agent2, prompt, subagentId, subagentType, toolCallId, emit) {
+  const result = await agent2.generate(prompt, AgentState.initial());
+  const endEvent = {
+    type: "subagent_end",
+    subagentId,
+    subagentType,
+    parentToolCallId: toolCallId,
+    success: true,
+    result: result.turn.response.text,
+    timestamp: Date.now(),
+    toolExecutions: result.turn.toolExecutions?.map((te) => ({
+      toolName: te.toolName,
+      arguments: te.arguments,
+      result: String(te.result)
+    })),
+    usage: result.turn.usage
+  };
+  emit?.(endEvent);
+  return result.turn.response.text;
+}
+
+export { agent, createSubAgentTool };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/agent/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  llm,\n  UserMessage,\n} from '@providerprotocol/ai';\nimport type {\n  LLMInstance,\n  Message,\n  Turn,\n} from '@providerprotocol/ai';\nimport { generateUUID } from '../utils/uuid.ts';\nimport { AgentState } from '../state/index.ts';\nimport { loop } from '../execution/loop.ts';\nimport type {\n  ExecutionContext,\n  GenerateResult,\n  AgentStreamResult,\n  AgentStrategy,\n} from '../execution/types.ts';\nimport type { Middleware, MiddlewareContext } from '../middleware/types.ts';\nimport type { Agent, AgentOptions } from './types.ts';\n\n/**\n * Create an agent instance.\n *\n * @param options - Agent configuration\n * @returns Agent instance\n *\n * @example\n * ```typescript\n * import { agent, AgentState } from '@providerprotocol/agents';\n * import { anthropic } from '@providerprotocol/ai/anthropic';\n *\n * const coder = agent({\n *   model: anthropic('claude-sonnet-4-20250514'),\n *   tools: [Bash, Read, Write],\n *   system: 'You are a coding assistant.',\n * });\n *\n * const state = AgentState.initial();\n * const { turn, state: newState } = await coder.generate('Hello', state);\n * ```\n */\nexport function agent(options: AgentOptions): Agent {\n  const {\n    // UAP-specific options\n    execution = loop(),\n    middleware = [],\n    strategy = {},\n    checkpoints,\n    sessionId: providedSessionId,\n    _llmInstance,\n    // LLM options (passthrough to UPP)\n    model,\n    params = {},\n    config,\n    tools = [],\n    system,\n    structure,\n    toolStrategy,\n  } = options;\n\n  const agentId = generateUUID();\n  // Generate sessionId (UUIDv4) if checkpoints provided but no sessionId\n  // Per UAP spec Section 3.4: Session IDs MUST be UUIDv4\n  const sessionId = checkpoints ? (providedSessionId ?? generateUUID()) : providedSessionId;\n\n  // Create the LLM instance with full UPP passthrough (or use injected instance for testing)\n  const llmInstance: LLMInstance = _llmInstance ?? llm({\n    model,\n    params,\n    config,\n    system,\n    structure,\n    tools,\n    toolStrategy,\n  });\n\n  /**\n   * Normalize input to a Message.\n   */\n  function normalizeInput(input: string | Message): Message {\n    if (typeof input === 'string') {\n      return new UserMessage(input);\n    }\n    return input;\n  }\n\n  /**\n   * Run middleware before hooks.\n   */\n  async function runBeforeMiddleware(\n    middlewares: Middleware[],\n    context: MiddlewareContext,\n  ): Promise<MiddlewareContext> {\n    let currentContext = context;\n\n    for (const mw of middlewares) {\n      if (mw.before) {\n        const result = await mw.before(currentContext);\n        if (result) {\n          currentContext = result;\n        }\n      }\n    }\n\n    return currentContext;\n  }\n\n  /**\n   * Run middleware after hooks (in reverse order).\n   */\n  async function runAfterMiddleware(\n    middlewares: Middleware[],\n    context: MiddlewareContext,\n    result: GenerateResult,\n  ): Promise<GenerateResult> {\n    let currentResult = result;\n\n    // Run in reverse order\n    for (let i = middlewares.length - 1; i >= 0; i--) {\n      const mw = middlewares[i];\n      if (mw?.after) {\n        currentResult = await mw.after(context, currentResult);\n      }\n    }\n\n    return currentResult;\n  }\n\n  /**\n   * Run middleware error hooks (in reverse order).\n   */\n  async function runErrorMiddleware(\n    middlewares: Middleware[],\n    context: MiddlewareContext,\n    error: Error,\n  ): Promise<GenerateResult | undefined> {\n    // Run in reverse order\n    for (let i = middlewares.length - 1; i >= 0; i--) {\n      const mw = middlewares[i];\n      if (mw?.onError) {\n        const result = await mw.onError(context, error);\n        if (result) {\n          return result;\n        }\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Build execution context.\n   */\n  function buildExecutionContext(\n    input: Message,\n    state: AgentState,\n    resolvedStrategy: AgentStrategy,\n    signal?: AbortSignal,\n  ): ExecutionContext {\n    return {\n      agent: { id: agentId, system },\n      llm: llmInstance,\n      input,\n      state,\n      tools,\n      strategy: resolvedStrategy,\n      signal,\n      checkpoints,\n      sessionId,\n    };\n  }\n\n  const agentInstance: Agent = {\n    id: agentId,\n    model,\n    tools,\n    system,\n\n    async generate(\n      input: string | Message,\n      state: AgentState,\n    ): Promise<GenerateResult> {\n      const normalizedInput = normalizeInput(input);\n\n      // Create middleware context\n      const middlewareContext: MiddlewareContext = {\n        agent: { id: agentId, system },\n        input: normalizedInput,\n        state,\n        metadata: new Map(),\n      };\n\n      try {\n        // Run before middleware\n        const processedContext = await runBeforeMiddleware(middleware, middlewareContext);\n\n        // Build execution context\n        const executionContext = buildExecutionContext(\n          processedContext.input,\n          processedContext.state,\n          strategy,\n        );\n\n        // Execute strategy\n        const result = await execution.execute(executionContext);\n\n        // Run after middleware\n        const finalResult = await runAfterMiddleware(\n          middleware,\n          processedContext,\n          result,\n        );\n\n        return finalResult;\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n\n        // Try to recover with error middleware\n        const recovered = await runErrorMiddleware(middleware, middlewareContext, err);\n        if (recovered) {\n          return recovered;\n        }\n\n        throw err;\n      }\n    },\n\n    stream(\n      input: string | Message,\n      state: AgentState,\n    ): AgentStreamResult {\n      const normalizedInput = normalizeInput(input);\n\n      // Create middleware context\n      const middlewareContext: MiddlewareContext = {\n        agent: { id: agentId, system },\n        input: normalizedInput,\n        state,\n        metadata: new Map(),\n      };\n\n      // We need to run before middleware synchronously enough to get the context\n      // but streaming is inherently async. We'll handle this by wrapping the stream.\n      let aborted = false;\n      const abortController = new AbortController();\n\n      let resolveResult: (result: GenerateResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<GenerateResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      const createStream = async function* () {\n        try {\n          // Run before middleware\n          const processedContext = await runBeforeMiddleware(middleware, middlewareContext);\n\n          // Build execution context\n          const executionContext = buildExecutionContext(\n            processedContext.input,\n            processedContext.state,\n            strategy,\n            abortController.signal,\n          );\n\n          // Get the stream from the execution strategy\n          const streamResult = execution.stream(executionContext);\n\n          // Yield events from the stream\n          for await (const event of streamResult) {\n            if (aborted) {\n              break;\n            }\n            yield event;\n          }\n\n          // Get the final result\n          const result = await streamResult.result;\n\n          // Run after middleware\n          const finalResult = await runAfterMiddleware(\n            middleware,\n            processedContext,\n            result,\n          );\n\n          resolveResult(finalResult);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n\n          // Try to recover with error middleware\n          const recovered = await runErrorMiddleware(middleware, middlewareContext, err);\n          if (recovered) {\n            resolveResult(recovered);\n            return;\n          }\n\n          rejectResult(err);\n          throw err;\n        }\n      };\n\n      const iterator = createStream();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n\n    async ask(\n      input: string | Message,\n      state: AgentState,\n    ): Promise<GenerateResult> {\n      const normalizedInput = normalizeInput(input);\n\n      // Generate with original state - execution strategy adds input to LLM call\n      const result = await agentInstance.generate(normalizedInput, state);\n\n      // Build final state with correct message order:\n      // original messages + input + response messages from this turn\n      const responseMessages = result.state.messages.slice(state.messages.length);\n      const finalState = state\n        .withMessage(normalizedInput)\n        .withMessages(responseMessages)\n        .withStep(result.state.step);\n\n      // Preserve metadata from execution\n      let stateWithMetadata = finalState;\n      for (const [key, value] of Object.entries(result.state.metadata)) {\n        stateWithMetadata = stateWithMetadata.withMetadata(key, value);\n      }\n\n      // Preserve reasoning traces\n      for (const reasoning of result.state.reasoning) {\n        stateWithMetadata = stateWithMetadata.withReasoning(reasoning);\n      }\n\n      // Preserve plan if present\n      if (result.state.plan) {\n        stateWithMetadata = stateWithMetadata.withPlan([...result.state.plan]);\n      }\n\n      return {\n        turn: result.turn,\n        state: stateWithMetadata,\n      };\n    },\n\n    async query(input: string | Message): Promise<Turn> {\n      const initialState = AgentState.initial();\n      const result = await agentInstance.generate(input, initialState);\n      return result.turn;\n    },\n  };\n\n  return agentInstance;\n}\n\nexport type { Agent, AgentOptions } from './types.ts';\nexport type {\n  GenerateResult,\n  AgentStreamResult,\n  AgentStreamEvent,\n  UAPEventType,\n  AgentStrategy,\n  // Sub-agent event types (Section 8.7)\n  SubagentEventType,\n  SubagentEventBase,\n  SubagentStartEvent,\n  SubagentInnerEvent,\n  SubagentEndEvent,\n  SubagentEvent,\n  OnSubagentEvent,\n} from '../execution/types.ts';\n"]}
+{"version":3,"sources":["../src/agent/index.ts","../src/subagent/index.ts"],"names":["agent"],"mappings":";;;;;;;AA0CO,SAAS,MAAM,OAAA,EAA8B;AAClD,EAAA,MAAM;AAAA;AAAA,IAEJ,YAAY,IAAA,EAAK;AAAA,IACjB,aAAa,EAAC;AAAA,IACd,WAAW,EAAC;AAAA,IACZ,WAAA;AAAA,IACA,SAAA,EAAW,iBAAA;AAAA,IACX,YAAA;AAAA;AAAA,IAEA,KAAA;AAAA,IACA,SAAS,EAAC;AAAA,IACV,MAAA;AAAA,IACA,QAAQ,EAAC;AAAA,IACT,MAAA;AAAA,IACA,SAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,UAAU,YAAA,EAAa;AAG7B,EAAA,MAAM,SAAA,GAAY,WAAA,GAAe,iBAAA,IAAqB,YAAA,EAAa,GAAK,iBAAA;AAGxE,EAAA,MAAM,WAAA,GAA2B,gBAAgB,GAAA,CAAI;AAAA,IACnD,KAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,MAAA;AAAA,IACA,SAAA;AAAA,IACA,KAAA;AAAA,IACA;AAAA,GACD,CAAA;AAKD,EAAA,SAAS,eAAe,KAAA,EAAkC;AACxD,IAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,MAAA,OAAO,IAAI,YAAY,KAAK,CAAA;AAAA,IAC9B;AACA,IAAA,OAAO,KAAA;AAAA,EACT;AAKA,EAAA,eAAe,mBAAA,CACb,aACA,OAAA,EAC4B;AAC5B,IAAA,IAAI,cAAA,GAAiB,OAAA;AAErB,IAAA,KAAA,MAAW,MAAM,WAAA,EAAa;AAC5B,MAAA,IAAI,GAAG,MAAA,EAAQ;AACb,QAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,MAAA,CAAO,cAAc,CAAA;AAC7C,QAAA,IAAI,MAAA,EAAQ;AACV,UAAA,cAAA,GAAiB,MAAA;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,cAAA;AAAA,EACT;AAKA,EAAA,eAAe,kBAAA,CACb,WAAA,EACA,OAAA,EACA,MAAA,EACyB;AACzB,IAAA,IAAI,aAAA,GAAgB,MAAA;AAGpB,IAAA,KAAA,IAAS,IAAI,WAAA,CAAY,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,GAAG,CAAA,EAAA,EAAK;AAChD,MAAA,MAAM,EAAA,GAAK,YAAY,CAAC,CAAA;AACxB,MAAA,IAAI,IAAI,KAAA,EAAO;AACb,QAAA,aAAA,GAAgB,MAAM,EAAA,CAAG,KAAA,CAAM,OAAA,EAAS,aAAa,CAAA;AAAA,MACvD;AAAA,IACF;AAEA,IAAA,OAAO,aAAA;AAAA,EACT;AAKA,EAAA,eAAe,kBAAA,CACb,WAAA,EACA,OAAA,EACA,KAAA,EACqC;AAErC,IAAA,KAAA,IAAS,IAAI,WAAA,CAAY,MAAA,GAAS,CAAA,EAAG,CAAA,IAAK,GAAG,CAAA,EAAA,EAAK;AAChD,MAAA,MAAM,EAAA,GAAK,YAAY,CAAC,CAAA;AACxB,MAAA,IAAI,IAAI,OAAA,EAAS;AACf,QAAA,MAAM,MAAA,GAAS,MAAM,EAAA,CAAG,OAAA,CAAQ,SAAS,KAAK,CAAA;AAC9C,QAAA,IAAI,MAAA,EAAQ;AACV,UAAA,OAAO,MAAA;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAEA,IAAA,OAAO,MAAA;AAAA,EACT;AAKA,EAAA,SAAS,qBAAA,CACP,KAAA,EACA,KAAA,EACA,gBAAA,EACA,MAAA,EACkB;AAClB,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,EAAE,EAAA,EAAI,OAAA,EAAS,MAAA,EAAO;AAAA,MAC7B,GAAA,EAAK,WAAA;AAAA,MACL,KAAA;AAAA,MACA,KAAA;AAAA,MACA,KAAA;AAAA,MACA,QAAA,EAAU,gBAAA;AAAA,MACV,MAAA;AAAA,MACA,WAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAEA,EAAA,MAAM,aAAA,GAAuB;AAAA,IAC3B,EAAA,EAAI,OAAA;AAAA,IACJ,KAAA;AAAA,IACA,KAAA;AAAA,IACA,MAAA;AAAA,IAEA,MAAM,QAAA,CACJ,KAAA,EACA,KAAA,EACyB;AACzB,MAAA,MAAM,eAAA,GAAkB,eAAe,KAAK,CAAA;AAG5C,MAAA,MAAM,iBAAA,GAAuC;AAAA,QAC3C,KAAA,EAAO,EAAE,EAAA,EAAI,OAAA,EAAS,MAAA,EAAO;AAAA,QAC7B,KAAA,EAAO,eAAA;AAAA,QACP,KAAA;AAAA,QACA,QAAA,sBAAc,GAAA;AAAI,OACpB;AAEA,MAAA,IAAI;AAEF,QAAA,MAAM,gBAAA,GAAmB,MAAM,mBAAA,CAAoB,UAAA,EAAY,iBAAiB,CAAA;AAGhF,QAAA,MAAM,gBAAA,GAAmB,qBAAA;AAAA,UACvB,gBAAA,CAAiB,KAAA;AAAA,UACjB,gBAAA,CAAiB,KAAA;AAAA,UACjB;AAAA,SACF;AAGA,QAAA,MAAM,MAAA,GAAS,MAAM,SAAA,CAAU,OAAA,CAAQ,gBAAgB,CAAA;AAGvD,QAAA,MAAM,cAAc,MAAM,kBAAA;AAAA,UACxB,UAAA;AAAA,UACA,gBAAA;AAAA,UACA;AAAA,SACF;AAEA,QAAA,OAAO,WAAA;AAAA,MACT,SAAS,KAAA,EAAO;AACd,QAAA,MAAM,GAAA,GAAM,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAGpE,QAAA,MAAM,SAAA,GAAY,MAAM,kBAAA,CAAmB,UAAA,EAAY,mBAAmB,GAAG,CAAA;AAC7E,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,OAAO,SAAA;AAAA,QACT;AAEA,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF,CAAA;AAAA,IAEA,MAAA,CACE,OACA,KAAA,EACmB;AACnB,MAAA,MAAM,eAAA,GAAkB,eAAe,KAAK,CAAA;AAG5C,MAAA,MAAM,iBAAA,GAAuC;AAAA,QAC3C,KAAA,EAAO,EAAE,EAAA,EAAI,OAAA,EAAS,MAAA,EAAO;AAAA,QAC7B,KAAA,EAAO,eAAA;AAAA,QACP,KAAA;AAAA,QACA,QAAA,sBAAc,GAAA;AAAI,OACpB;AAIA,MAAA,IAAI,OAAA,GAAU,KAAA;AACd,MAAA,MAAM,eAAA,GAAkB,IAAI,eAAA,EAAgB;AAE5C,MAAA,IAAI,aAAA;AACJ,MAAA,IAAI,YAAA;AAEJ,MAAA,MAAM,aAAA,GAAgB,IAAI,OAAA,CAAwB,CAAC,SAAS,MAAA,KAAW;AACrE,QAAA,aAAA,GAAgB,OAAA;AAChB,QAAA,YAAA,GAAe,MAAA;AAAA,MACjB,CAAC,CAAA;AAED,MAAA,MAAM,eAAe,mBAAmB;AACtC,QAAA,IAAI;AAEF,UAAA,MAAM,gBAAA,GAAmB,MAAM,mBAAA,CAAoB,UAAA,EAAY,iBAAiB,CAAA;AAGhF,UAAA,MAAM,gBAAA,GAAmB,qBAAA;AAAA,YACvB,gBAAA,CAAiB,KAAA;AAAA,YACjB,gBAAA,CAAiB,KAAA;AAAA,YACjB,QAAA;AAAA,YACA,eAAA,CAAgB;AAAA,WAClB;AAGA,UAAA,MAAM,YAAA,GAAe,SAAA,CAAU,MAAA,CAAO,gBAAgB,CAAA;AAGtD,UAAA,WAAA,MAAiB,SAAS,YAAA,EAAc;AACtC,YAAA,IAAI,OAAA,EAAS;AACX,cAAA;AAAA,YACF;AACA,YAAA,MAAM,KAAA;AAAA,UACR;AAGA,UAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa,MAAA;AAGlC,UAAA,MAAM,cAAc,MAAM,kBAAA;AAAA,YACxB,UAAA;AAAA,YACA,gBAAA;AAAA,YACA;AAAA,WACF;AAEA,UAAA,aAAA,CAAc,WAAW,CAAA;AAAA,QAC3B,SAAS,KAAA,EAAO;AACd,UAAA,MAAM,GAAA,GAAM,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAGpE,UAAA,MAAM,SAAA,GAAY,MAAM,kBAAA,CAAmB,UAAA,EAAY,mBAAmB,GAAG,CAAA;AAC7E,UAAA,IAAI,SAAA,EAAW;AACb,YAAA,aAAA,CAAc,SAAS,CAAA;AACvB,YAAA;AAAA,UACF;AAEA,UAAA,YAAA,CAAa,GAAG,CAAA;AAChB,UAAA,MAAM,GAAA;AAAA,QACR;AAAA,MACF,CAAA;AAEA,MAAA,MAAM,WAAW,YAAA,EAAa;AAE9B,MAAA,OAAO;AAAA,QACL,CAAC,MAAA,CAAO,aAAa,CAAA,GAAI;AACvB,UAAA,OAAO,QAAA;AAAA,QACT,CAAA;AAAA,QACA,MAAA,EAAQ,aAAA;AAAA,QACR,KAAA,GAAQ;AACN,UAAA,OAAA,GAAU,IAAA;AACV,UAAA,eAAA,CAAgB,KAAA,EAAM;AAAA,QACxB;AAAA,OACF;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,GAAA,CACJ,KAAA,EACA,KAAA,EACyB;AAQzB,MAAA,OAAO,aAAA,CAAc,QAAA,CAAS,KAAA,EAAO,KAAK,CAAA;AAAA,IAC5C,CAAA;AAAA,IAEA,MAAM,MAAM,KAAA,EAAwC;AAClD,MAAA,MAAM,YAAA,GAAe,WAAW,OAAA,EAAQ;AACxC,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc,QAAA,CAAS,OAAO,YAAY,CAAA;AAC/D,MAAA,OAAO,MAAA,CAAO,IAAA;AAAA,IAChB;AAAA,GACF;AAEA,EAAA,OAAO,aAAA;AACT;;;AC3NO,SAAS,mBAAmB,OAAA,EAA0C;AAC3E,EAAA,MAAM;AAAA,IACJ,KAAA,EAAAA,MAAAA;AAAA,IACA,IAAA;AAAA,IACA,WAAA;AAAA,IACA,UAAA;AAAA,IACA,WAAA;AAAA,IACA,YAAA,GAAe,IAAA;AAAA,IACf,QAAQ,YAAA,GAAe;AAAA,GACzB,GAAI,OAAA;AAEJ,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,WAAA;AAAA,IACA,UAAA;AAAA,IACA,GAAA,EAAK,OACH,MAAA,EACA,OAAA,KACoB;AACpB,MAAA,MAAM,aAAa,YAAA,EAAa;AAChC,MAAA,MAAM,UAAA,GAAa,OAAA,EAAS,UAAA,IAAc,YAAA,EAAa;AACvD,MAAA,MAAM,OAAO,OAAA,EAAS,eAAA;AACtB,MAAA,MAAM,MAAA,GAAS,YAAY,MAAM,CAAA;AACjC,MAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAG3B,MAAA,MAAM,UAAA,GAAiC;AAAA,QACrC,IAAA,EAAM,gBAAA;AAAA,QACN,UAAA;AAAA,QACA,YAAA;AAAA,QACA,gBAAA,EAAkB,UAAA;AAAA,QAClB,MAAA;AAAA,QACA,SAAA,EAAW;AAAA,OACb;AACA,MAAA,IAAA,GAAO,UAAU,CAAA;AAEjB,MAAA,IAAI;AACF,QAAA,IAAI,YAAA,EAAc;AAChB,UAAA,OAAO,MAAM,oBAAA;AAAA,YACXA,MAAAA;AAAA,YACA,MAAA;AAAA,YACA,UAAA;AAAA,YACA,YAAA;AAAA,YACA,UAAA;AAAA,YACA;AAAA,WACF;AAAA,QACF;AACA,QAAA,OAAO,MAAM,uBAAA;AAAA,UACXA,MAAAA;AAAA,UACA,MAAA;AAAA,UACA,UAAA;AAAA,UACA,YAAA;AAAA,UACA,UAAA;AAAA,UACA;AAAA,SACF;AAAA,MACF,SAAS,KAAA,EAAO;AACd,QAAA,MAAM,GAAA,GAAM,iBAAiB,KAAA,GAAQ,KAAA,GAAQ,IAAI,KAAA,CAAM,MAAA,CAAO,KAAK,CAAC,CAAA;AAGpE,QAAA,MAAM,QAAA,GAA6B;AAAA,UACjC,IAAA,EAAM,cAAA;AAAA,UACN,UAAA;AAAA,UACA,YAAA;AAAA,UACA,gBAAA,EAAkB,UAAA;AAAA,UAClB,OAAA,EAAS,KAAA;AAAA,UACT,OAAO,GAAA,CAAI,OAAA;AAAA,UACX,SAAA,EAAW,KAAK,GAAA;AAAI,SACtB;AACA,QAAA,IAAA,GAAO,QAAQ,CAAA;AAEf,QAAA,MAAM,GAAA;AAAA,MACR;AAAA,IACF;AAAA,GACF;AACF;AAKA,eAAe,qBACbA,MAAAA,EACA,MAAA,EACA,UAAA,EACA,YAAA,EACA,YACA,IAAA,EACiB;AACjB,EAAA,MAAM,SAASA,MAAAA,CAAM,MAAA,CAAO,MAAA,EAAQ,UAAA,CAAW,SAAS,CAAA;AAGxD,EAAA,WAAA,MAAiB,SAAS,MAAA,EAAQ;AAChC,IAAA,IAAA,GAAO;AAAA,MACL,IAAA,EAAM,gBAAA;AAAA,MACN,UAAA;AAAA,MACA,YAAA;AAAA,MACA,gBAAA,EAAkB,UAAA;AAAA,MAClB,UAAA,EAAY;AAAA,KACb,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,MAAA;AAG5B,EAAA,MAAM,QAAA,GAA6B;AAAA,IACjC,IAAA,EAAM,cAAA;AAAA,IACN,UAAA;AAAA,IACA,YAAA;AAAA,IACA,gBAAA,EAAkB,UAAA;AAAA,IAClB,OAAA,EAAS,IAAA;AAAA,IACT,MAAA,EAAQ,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,IAAA;AAAA,IAC7B,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,IACpB,gBAAgB,MAAA,CAAO,IAAA,CAAK,cAAA,EAAgB,GAAA,CAAI,CAAC,EAAA,MAAQ;AAAA,MACvD,UAAU,EAAA,CAAG,QAAA;AAAA,MACb,WAAW,EAAA,CAAG,SAAA;AAAA,MACd,MAAA,EAAQ,MAAA,CAAO,EAAA,CAAG,MAAM;AAAA,KAC1B,CAAE,CAAA;AAAA,IACF,KAAA,EAAO,OAAO,IAAA,CAAK;AAAA,GACrB;AACA,EAAA,IAAA,GAAO,QAAQ,CAAA;AAEf,EAAA,OAAO,MAAA,CAAO,KAAK,QAAA,CAAS,IAAA;AAC9B;AAKA,eAAe,wBACbA,MAAAA,EACA,MAAA,EACA,UAAA,EACA,YAAA,EACA,YACA,IAAA,EACiB;AACjB,EAAA,MAAM,SAAS,MAAMA,MAAAA,CAAM,SAAS,MAAA,EAAQ,UAAA,CAAW,SAAS,CAAA;AAGhE,EAAA,MAAM,QAAA,GAA6B;AAAA,IACjC,IAAA,EAAM,cAAA;AAAA,IACN,UAAA;AAAA,IACA,YAAA;AAAA,IACA,gBAAA,EAAkB,UAAA;AAAA,IAClB,OAAA,EAAS,IAAA;AAAA,IACT,MAAA,EAAQ,MAAA,CAAO,IAAA,CAAK,QAAA,CAAS,IAAA;AAAA,IAC7B,SAAA,EAAW,KAAK,GAAA,EAAI;AAAA,IACpB,gBAAgB,MAAA,CAAO,IAAA,CAAK,cAAA,EAAgB,GAAA,CAAI,CAAC,EAAA,MAAQ;AAAA,MACvD,UAAU,EAAA,CAAG,QAAA;AAAA,MACb,WAAW,EAAA,CAAG,SAAA;AAAA,MACd,MAAA,EAAQ,MAAA,CAAO,EAAA,CAAG,MAAM;AAAA,KAC1B,CAAE,CAAA;AAAA,IACF,KAAA,EAAO,OAAO,IAAA,CAAK;AAAA,GACrB;AACA,EAAA,IAAA,GAAO,QAAQ,CAAA;AAEf,EAAA,OAAO,MAAA,CAAO,KAAK,QAAA,CAAS,IAAA;AAC9B","file":"index.js","sourcesContent":["import {\n  llm,\n  UserMessage,\n} from '@providerprotocol/ai';\nimport type {\n  LLMInstance,\n  Message,\n  Turn,\n} from '@providerprotocol/ai';\nimport { generateUUID } from '../utils/uuid.ts';\nimport { AgentState } from '../state/index.ts';\nimport { loop } from '../execution/loop.ts';\nimport type {\n  ExecutionContext,\n  GenerateResult,\n  AgentStreamResult,\n  AgentStrategy,\n} from '../execution/types.ts';\nimport type { Middleware, MiddlewareContext } from '../middleware/types.ts';\nimport type { Agent, AgentOptions } from './types.ts';\n\n/**\n * Create an agent instance.\n *\n * @param options - Agent configuration\n * @returns Agent instance\n *\n * @example\n * ```typescript\n * import { agent, AgentState } from '@providerprotocol/agents';\n * import { anthropic } from '@providerprotocol/ai/anthropic';\n *\n * const coder = agent({\n *   model: anthropic('claude-sonnet-4-20250514'),\n *   tools: [Bash, Read, Write],\n *   system: 'You are a coding assistant.',\n * });\n *\n * const state = AgentState.initial();\n * const { turn, state: newState } = await coder.generate('Hello', state);\n * ```\n */\nexport function agent(options: AgentOptions): Agent {\n  const {\n    // UAP-specific options\n    execution = loop(),\n    middleware = [],\n    strategy = {},\n    checkpoints,\n    sessionId: providedSessionId,\n    _llmInstance,\n    // LLM options (passthrough to UPP)\n    model,\n    params = {},\n    config,\n    tools = [],\n    system,\n    structure,\n    toolStrategy,\n  } = options;\n\n  const agentId = generateUUID();\n  // Generate sessionId (UUIDv4) if checkpoints provided but no sessionId\n  // Per UAP spec Section 3.4: Session IDs MUST be UUIDv4\n  const sessionId = checkpoints ? (providedSessionId ?? generateUUID()) : providedSessionId;\n\n  // Create the LLM instance with full UPP passthrough (or use injected instance for testing)\n  const llmInstance: LLMInstance = _llmInstance ?? llm({\n    model,\n    params,\n    config,\n    system,\n    structure,\n    tools,\n    toolStrategy,\n  });\n\n  /**\n   * Normalize input to a Message.\n   */\n  function normalizeInput(input: string | Message): Message {\n    if (typeof input === 'string') {\n      return new UserMessage(input);\n    }\n    return input;\n  }\n\n  /**\n   * Run middleware before hooks.\n   */\n  async function runBeforeMiddleware(\n    middlewares: Middleware[],\n    context: MiddlewareContext,\n  ): Promise<MiddlewareContext> {\n    let currentContext = context;\n\n    for (const mw of middlewares) {\n      if (mw.before) {\n        const result = await mw.before(currentContext);\n        if (result) {\n          currentContext = result;\n        }\n      }\n    }\n\n    return currentContext;\n  }\n\n  /**\n   * Run middleware after hooks (in reverse order).\n   */\n  async function runAfterMiddleware(\n    middlewares: Middleware[],\n    context: MiddlewareContext,\n    result: GenerateResult,\n  ): Promise<GenerateResult> {\n    let currentResult = result;\n\n    // Run in reverse order\n    for (let i = middlewares.length - 1; i >= 0; i--) {\n      const mw = middlewares[i];\n      if (mw?.after) {\n        currentResult = await mw.after(context, currentResult);\n      }\n    }\n\n    return currentResult;\n  }\n\n  /**\n   * Run middleware error hooks (in reverse order).\n   */\n  async function runErrorMiddleware(\n    middlewares: Middleware[],\n    context: MiddlewareContext,\n    error: Error,\n  ): Promise<GenerateResult | undefined> {\n    // Run in reverse order\n    for (let i = middlewares.length - 1; i >= 0; i--) {\n      const mw = middlewares[i];\n      if (mw?.onError) {\n        const result = await mw.onError(context, error);\n        if (result) {\n          return result;\n        }\n      }\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Build execution context.\n   */\n  function buildExecutionContext(\n    input: Message,\n    state: AgentState,\n    resolvedStrategy: AgentStrategy,\n    signal?: AbortSignal,\n  ): ExecutionContext {\n    return {\n      agent: { id: agentId, system },\n      llm: llmInstance,\n      input,\n      state,\n      tools,\n      strategy: resolvedStrategy,\n      signal,\n      checkpoints,\n      sessionId,\n    };\n  }\n\n  const agentInstance: Agent = {\n    id: agentId,\n    model,\n    tools,\n    system,\n\n    async generate(\n      input: string | Message,\n      state: AgentState,\n    ): Promise<GenerateResult> {\n      const normalizedInput = normalizeInput(input);\n\n      // Create middleware context\n      const middlewareContext: MiddlewareContext = {\n        agent: { id: agentId, system },\n        input: normalizedInput,\n        state,\n        metadata: new Map(),\n      };\n\n      try {\n        // Run before middleware\n        const processedContext = await runBeforeMiddleware(middleware, middlewareContext);\n\n        // Build execution context\n        const executionContext = buildExecutionContext(\n          processedContext.input,\n          processedContext.state,\n          strategy,\n        );\n\n        // Execute strategy\n        const result = await execution.execute(executionContext);\n\n        // Run after middleware\n        const finalResult = await runAfterMiddleware(\n          middleware,\n          processedContext,\n          result,\n        );\n\n        return finalResult;\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n\n        // Try to recover with error middleware\n        const recovered = await runErrorMiddleware(middleware, middlewareContext, err);\n        if (recovered) {\n          return recovered;\n        }\n\n        throw err;\n      }\n    },\n\n    stream(\n      input: string | Message,\n      state: AgentState,\n    ): AgentStreamResult {\n      const normalizedInput = normalizeInput(input);\n\n      // Create middleware context\n      const middlewareContext: MiddlewareContext = {\n        agent: { id: agentId, system },\n        input: normalizedInput,\n        state,\n        metadata: new Map(),\n      };\n\n      // We need to run before middleware synchronously enough to get the context\n      // but streaming is inherently async. We'll handle this by wrapping the stream.\n      let aborted = false;\n      const abortController = new AbortController();\n\n      let resolveResult: (result: GenerateResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<GenerateResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      const createStream = async function* () {\n        try {\n          // Run before middleware\n          const processedContext = await runBeforeMiddleware(middleware, middlewareContext);\n\n          // Build execution context\n          const executionContext = buildExecutionContext(\n            processedContext.input,\n            processedContext.state,\n            strategy,\n            abortController.signal,\n          );\n\n          // Get the stream from the execution strategy\n          const streamResult = execution.stream(executionContext);\n\n          // Yield events from the stream\n          for await (const event of streamResult) {\n            if (aborted) {\n              break;\n            }\n            yield event;\n          }\n\n          // Get the final result\n          const result = await streamResult.result;\n\n          // Run after middleware\n          const finalResult = await runAfterMiddleware(\n            middleware,\n            processedContext,\n            result,\n          );\n\n          resolveResult(finalResult);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n\n          // Try to recover with error middleware\n          const recovered = await runErrorMiddleware(middleware, middlewareContext, err);\n          if (recovered) {\n            resolveResult(recovered);\n            return;\n          }\n\n          rejectResult(err);\n          throw err;\n        }\n      };\n\n      const iterator = createStream();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n\n    async ask(\n      input: string | Message,\n      state: AgentState,\n    ): Promise<GenerateResult> {\n      // Per UAP-1.0 Section 4.6: ask() is a convenience method for multi-turn execution.\n      // The execution strategy handles adding input to state and appending response.\n      // We delegate directly to generate() to:\n      // 1. Preserve middleware before() modifications (e.g., context pruning via withContext)\n      // 2. Preserve middleware after() modifications\n      // 3. Avoid message duplication (strategy already adds input)\n      // 4. Return the correctly built state from the execution pipeline\n      return agentInstance.generate(input, state);\n    },\n\n    async query(input: string | Message): Promise<Turn> {\n      const initialState = AgentState.initial();\n      const result = await agentInstance.generate(input, initialState);\n      return result.turn;\n    },\n  };\n\n  return agentInstance;\n}\n\nexport type { Agent, AgentOptions } from './types.ts';\nexport type {\n  GenerateResult,\n  AgentStreamResult,\n  AgentStreamEvent,\n  UAPEventType,\n  AgentStrategy,\n  // Sub-agent event types (Section 8.7)\n  SubagentEventType,\n  SubagentEventBase,\n  SubagentStartEvent,\n  SubagentInnerEvent,\n  SubagentEndEvent,\n  SubagentEvent,\n  OnSubagentEvent,\n} from '../execution/types.ts';\n","/**\n * Sub-agent tool creation utilities.\n *\n * Per UAP-1.0 Section 8.7, implementations SHOULD provide helper utilities\n * for creating sub-agent tools with event propagation.\n *\n * @example\n * ```typescript\n * import { agent } from '@providerprotocol/agents';\n * import { createSubAgentTool } from '@providerprotocol/agents/subagent';\n *\n * // Create a sub-agent\n * const explorer = agent({\n *   model: anthropic('claude-haiku-4-20250514'),\n *   tools: [Glob, Grep, Read],\n *   system: 'You explore codebases.',\n * });\n *\n * // Wrap as a tool with event propagation\n * const explorerTool = createSubAgentTool({\n *   agent: explorer,\n *   name: 'explore_codebase',\n *   description: 'Explore and find relevant code',\n *   parameters: {\n *     type: 'object',\n *     properties: {\n *       query: { type: 'string', description: 'What to find' },\n *     },\n *     required: ['query'],\n *   },\n *   buildPrompt: (params) => `Find: ${params.query}`,\n *   subagentType: 'explorer',\n * });\n *\n * // Use in parent agent\n * const coder = agent({\n *   model: anthropic('claude-sonnet-4-20250514'),\n *   tools: [Bash, Write, explorerTool],\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { Tool, JSONSchema } from '@providerprotocol/ai';\nimport type { Agent } from '../agent/types.ts';\nimport type {\n  ToolExecutionContext,\n  SubagentEvent,\n  SubagentStartEvent,\n  SubagentEndEvent,\n} from '../execution/types.ts';\nimport { AgentState } from '../state/index.ts';\nimport { generateUUID } from '../utils/uuid.ts';\n\n/**\n * Options for creating a sub-agent tool.\n */\nexport interface CreateSubAgentToolOptions {\n  /** The sub-agent to expose as a tool */\n  agent: Agent;\n  /** Tool name (must be unique within parent agent's tools) */\n  name: string;\n  /** Tool description for the model */\n  description: string;\n  /** JSON Schema for tool parameters */\n  parameters: JSONSchema;\n  /** Convert tool parameters to a prompt for the sub-agent */\n  buildPrompt: (params: Record<string, unknown>) => string;\n  /**\n   * Identifier for the sub-agent type (used in events).\n   * Defaults to the tool name.\n   */\n  subagentType?: string;\n  /**\n   * Whether to stream the sub-agent execution.\n   * When true, inner events are forwarded to parent.\n   * Default: true\n   */\n  stream?: boolean;\n}\n\n/**\n * Create a UPP Tool from a UAP Agent with full event propagation.\n *\n * Per UAP-1.0 Section 8.7, this helper:\n * 1. Emits `subagent_start` before execution begins\n * 2. Forwards inner events during streaming execution\n * 3. Emits `subagent_end` after completion (success or failure)\n * 4. Provides execution context to sub-agent for tracing\n *\n * The created tool accepts an optional `ToolExecutionContext` as a second\n * parameter, which is injected by `injectToolContext()` during execution.\n *\n * @param options - Configuration for the sub-agent tool\n * @returns A Tool that executes the sub-agent and propagates events\n *\n * @example\n * ```typescript\n * const summarizer = agent({\n *   model: anthropic('claude-haiku-4-20250514'),\n *   system: 'You summarize text concisely.',\n * });\n *\n * const summarizerTool = createSubAgentTool({\n *   agent: summarizer,\n *   name: 'summarize',\n *   description: 'Summarize the given text',\n *   parameters: {\n *     type: 'object',\n *     properties: {\n *       text: { type: 'string', description: 'Text to summarize' },\n *       maxLength: { type: 'number', description: 'Max summary length' },\n *     },\n *     required: ['text'],\n *   },\n *   buildPrompt: (params) =>\n *     `Summarize this in ${params.maxLength ?? 100} words:\\n\\n${params.text}`,\n *   subagentType: 'summarizer',\n * });\n * ```\n */\nexport function createSubAgentTool(options: CreateSubAgentToolOptions): Tool {\n  const {\n    agent,\n    name,\n    description,\n    parameters,\n    buildPrompt,\n    subagentType = name,\n    stream: shouldStream = true,\n  } = options;\n\n  return {\n    name,\n    description,\n    parameters,\n    run: async (\n      params: Record<string, unknown>,\n      context?: ToolExecutionContext,\n    ): Promise<string> => {\n      const subagentId = generateUUID();\n      const toolCallId = context?.toolCallId ?? generateUUID();\n      const emit = context?.onSubagentEvent;\n      const prompt = buildPrompt(params);\n      const startTime = Date.now();\n\n      // Emit start event\n      const startEvent: SubagentStartEvent = {\n        type: 'subagent_start',\n        subagentId,\n        subagentType,\n        parentToolCallId: toolCallId,\n        prompt,\n        timestamp: startTime,\n      };\n      emit?.(startEvent);\n\n      try {\n        if (shouldStream) {\n          return await executeWithStreaming(\n            agent,\n            prompt,\n            subagentId,\n            subagentType,\n            toolCallId,\n            emit,\n          );\n        }\n        return await executeWithoutStreaming(\n          agent,\n          prompt,\n          subagentId,\n          subagentType,\n          toolCallId,\n          emit,\n        );\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n\n        // Emit end event with error\n        const endEvent: SubagentEndEvent = {\n          type: 'subagent_end',\n          subagentId,\n          subagentType,\n          parentToolCallId: toolCallId,\n          success: false,\n          error: err.message,\n          timestamp: Date.now(),\n        };\n        emit?.(endEvent);\n\n        throw err;\n      }\n    },\n  };\n}\n\n/**\n * Execute sub-agent with streaming and forward events.\n */\nasync function executeWithStreaming(\n  agent: Agent,\n  prompt: string,\n  subagentId: string,\n  subagentType: string,\n  toolCallId: string,\n  emit?: (event: SubagentEvent) => void,\n): Promise<string> {\n  const stream = agent.stream(prompt, AgentState.initial());\n\n  // Forward inner events\n  for await (const event of stream) {\n    emit?.({\n      type: 'subagent_event',\n      subagentId,\n      subagentType,\n      parentToolCallId: toolCallId,\n      innerEvent: event,\n    });\n  }\n\n  const result = await stream.result;\n\n  // Emit end event\n  const endEvent: SubagentEndEvent = {\n    type: 'subagent_end',\n    subagentId,\n    subagentType,\n    parentToolCallId: toolCallId,\n    success: true,\n    result: result.turn.response.text,\n    timestamp: Date.now(),\n    toolExecutions: result.turn.toolExecutions?.map((te) => ({\n      toolName: te.toolName,\n      arguments: te.arguments as Record<string, unknown>,\n      result: String(te.result),\n    })),\n    usage: result.turn.usage,\n  };\n  emit?.(endEvent);\n\n  return result.turn.response.text;\n}\n\n/**\n * Execute sub-agent without streaming (simpler, but no inner events).\n */\nasync function executeWithoutStreaming(\n  agent: Agent,\n  prompt: string,\n  subagentId: string,\n  subagentType: string,\n  toolCallId: string,\n  emit?: (event: SubagentEvent) => void,\n): Promise<string> {\n  const result = await agent.generate(prompt, AgentState.initial());\n\n  // Emit end event\n  const endEvent: SubagentEndEvent = {\n    type: 'subagent_end',\n    subagentId,\n    subagentType,\n    parentToolCallId: toolCallId,\n    success: true,\n    result: result.turn.response.text,\n    timestamp: Date.now(),\n    toolExecutions: result.turn.toolExecutions?.map((te) => ({\n      toolName: te.toolName,\n      arguments: te.arguments as Record<string, unknown>,\n      result: String(te.result),\n    })),\n    usage: result.turn.usage,\n  };\n  emit?.(endEvent);\n\n  return result.turn.response.text;\n}\n\n/**\n * Type for the run function of a sub-agent tool.\n * Accepts params and optional execution context.\n */\nexport type SubAgentToolRun = (\n  params: Record<string, unknown>,\n  context?: ToolExecutionContext,\n) => Promise<string>;\n"]}

package/dist/middleware/index.d.ts

@@ -1,9 +1,9 @@
-import { L as LoggingOptions, M as Middleware } from '../types-BiyEVOnf.js';
-export { a as MiddlewareContext } from '../types-BiyEVOnf.js';
+import { L as LoggingOptions, M as Middleware } from '../types-B9VuAOo6.js';
+export { a as MiddlewareContext } from '../types-B9VuAOo6.js';
 import '@providerprotocol/ai';
 import '../index-qsPwbY86.js';
 import '../types-2Vsthzyu.js';
-import '../types-D1egxttz.js';
+import '../types-DC8XeoaI.js';
 import '../types-DChRdQoX.js';
 
 /**

package/dist/tool-context-Cc_qNVud.d.ts

@@ -0,0 +1,72 @@
+import { Tool } from '@providerprotocol/ai';
+import { h as ExecutionContext, O as OnSubagentEvent, C as ContextAwareToolRun } from './types-DC8XeoaI.js';
+
+/**
+ * Options for tool context injection.
+ */
+interface InjectToolContextOptions {
+    /** Callback for sub-agent events from tools */
+    onSubagentEvent?: OnSubagentEvent;
+}
+/**
+ * Wrap tools to inject execution context when they support it.
+ *
+ * Per UAP-1.0 Section 8.4, tools that accept a second parameter
+ * should receive execution context including agentId, stateId,
+ * and sub-agent event callbacks.
+ *
+ * This enables:
+ * - Sub-agent model/config inheritance
+ * - Execution hierarchy tracking
+ * - Sub-agent event propagation
+ *
+ * @param tools - Original tool array
+ * @param context - Execution context from the agent
+ * @param options - Additional options like event callbacks
+ * @returns Wrapped tools with context injection
+ *
+ * @example
+ * ```typescript
+ * // In execution strategy
+ * const wrappedTools = injectToolContext(tools, context, {
+ *   onSubagentEvent: (event) => {
+ *     // Handle sub-agent events
+ *     yield { source: 'uap', uap: { type: event.type, ... } };
+ *   },
+ * });
+ *
+ * // Pass wrapped tools to LLM
+ * const llmWithContext = llm({ model, tools: wrappedTools });
+ * ```
+ */
+declare function injectToolContext(tools: Tool[], context: ExecutionContext, options?: InjectToolContextOptions): Tool[];
+/**
+ * Check if a tool is context-aware (accepts second parameter).
+ *
+ * @param tool - Tool to check
+ * @returns true if tool.run accepts more than one parameter
+ */
+declare function isContextAwareTool(tool: Tool): boolean;
+/**
+ * Create a context-aware tool wrapper for existing tools.
+ * This is useful when you want to add context support to a tool
+ * that doesn't natively support it.
+ *
+ * @param tool - Original tool
+ * @param handler - Function that receives params and context, returns result
+ * @returns New tool with context support
+ *
+ * @example
+ * ```typescript
+ * const originalTool = { name: 'my_tool', run: async (p) => 'result', ... };
+ *
+ * const contextAware = withToolContext(originalTool, async (params, context) => {
+ *   console.log('Agent ID:', context?.agentId);
+ *   // Call original or do something with context
+ *   return originalTool.run(params);
+ * });
+ * ```
+ */
+declare function withToolContext(tool: Tool, handler: ContextAwareToolRun): Tool;
+
+export { type InjectToolContextOptions as I, isContextAwareTool as a, injectToolContext as i, withToolContext as w };

package/dist/{types-BiyEVOnf.d.ts → types-B9VuAOo6.d.ts}

@@ -1,6 +1,6 @@
 import { Message } from '@providerprotocol/ai';
 import { A as AgentState } from './index-qsPwbY86.js';
-import { G as GenerateResult } from './types-D1egxttz.js';
+import { G as GenerateResult } from './types-DC8XeoaI.js';
 
 /**
  * Forward declaration of Agent for use in MiddlewareContext.

package/dist/{types-D1egxttz.d.ts → types-DC8XeoaI.d.ts}

@@ -266,5 +266,43 @@ type SubagentEvent = SubagentStartEvent | SubagentInnerEvent | SubagentEndEvent;
  * Tools that spawn sub-agents SHOULD accept this callback.
  */
 type OnSubagentEvent = (event: SubagentEvent) => void;
+/**
+ * Context injected into tools during execution.
+ * Per UAP-1.0 Section 8.4, ExecutionStrategy MUST inject this context
+ * when invoking tools that accept a second parameter.
+ *
+ * @see UAP-1.0 Spec Section 8.4
+ */
+interface ToolExecutionContext {
+    /** Agent instance ID */
+    agentId: string;
+    /** Current state snapshot ID */
+    stateId: string;
+    /** Tool call ID from the model response */
+    toolCallId: string;
+    /** Callback for sub-agent events */
+    onSubagentEvent?: OnSubagentEvent;
+}
+/**
+ * Type for a tool that accepts execution context as a second parameter.
+ * Tools can optionally accept this context for sub-agent inheritance
+ * and event propagation.
+ *
+ * @example
+ * ```typescript
+ * const contextAwareTool: Tool = {
+ *   name: 'my_tool',
+ *   description: 'Tool that uses execution context',
+ *   parameters: { ... },
+ *   run: async (params, context?: ToolExecutionContext) => {
+ *     if (context?.onSubagentEvent) {
+ *       // Can propagate sub-agent events
+ *     }
+ *     return 'result';
+ *   },
+ * };
+ * ```
+ */
+type ContextAwareToolRun = (params: Record<string, unknown>, context?: ToolExecutionContext) => Promise<unknown>;
 
-export type { AgentStrategy as A, ExecutionStrategy as E, GenerateResult as G, LoopOptions as L, OnSubagentEvent as O, PlanOptions as P, ReactOptions as R, SubagentEventType as S, ToolDependencyOptions as T, UAPEventType as U, AgentStreamResult as a, AgentStreamEvent as b, SubagentEventBase as c, SubagentStartEvent as d, SubagentInnerEvent as e, SubagentEndEvent as f, SubagentEvent as g, ExecutionContext as h, ExecutionResult as i, ToolWithDependencies as j, OrderedToolCall as k };
+export type { AgentStrategy as A, ContextAwareToolRun as C, ExecutionStrategy as E, GenerateResult as G, LoopOptions as L, OnSubagentEvent as O, PlanOptions as P, ReactOptions as R, SubagentEventType as S, ToolExecutionContext as T, UAPEventType as U, AgentStreamResult as a, AgentStreamEvent as b, SubagentEventBase as c, SubagentStartEvent as d, SubagentInnerEvent as e, SubagentEndEvent as f, SubagentEvent as g, ExecutionContext as h, ExecutionResult as i, ToolDependencyOptions as j, ToolWithDependencies as k, OrderedToolCall as l };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@providerprotocol/agents",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Unified Agent Protocol (UAP) 1.0 implementation for @providerprotocol/ai",
   "type": "module",
   "author": {

package/dist/chunk-4ESYN66B.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/execution/loop.ts"],"names":[],"mappings":"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","file":"chunk-4ESYN66B.js","sourcesContent":["import type { Turn, StreamEvent } from '@providerprotocol/ai';\nimport type {\n  ExecutionStrategy,\n  ExecutionContext,\n  ExecutionResult,\n  LoopOptions,\n  AgentStreamResult,\n  AgentStreamEvent,\n} from './types.ts';\n\nconst DEFAULT_LOOP_OPTIONS: Required<LoopOptions> = {\n  maxIterations: Infinity,\n};\n\n/**\n * Create a loop execution strategy.\n * The simplest strategy - equivalent to UPP's tool loop behavior.\n *\n * Behavior:\n * 1. Send input to LLM\n * 2. If response has tool calls, execute tools and loop\n * 3. Continue until no tool calls or maxIterations reached\n * 4. Return final response as UPP Turn\n *\n * @param options - Loop configuration options\n * @returns ExecutionStrategy\n */\nexport function loop(options: LoopOptions = {}): ExecutionStrategy {\n  const opts = { ...DEFAULT_LOOP_OPTIONS, ...options };\n\n  return {\n    name: 'loop',\n\n    async execute(context: ExecutionContext): Promise<ExecutionResult> {\n      const { llm, input, state, strategy, signal } = context;\n\n      // Add input message to state and set agentId in metadata\n      // This ensures checkpoints include the full conversation\n      let currentState = state\n        .withMessage(input)\n        .withMetadata('agentId', context.agent.id);\n      let iteration = 0;\n      let finalTurn: Turn | undefined;\n\n      // Messages for LLM generation (includes input we just added)\n      const inputMessages = [...currentState.messages];\n\n      while (true) {\n        iteration++;\n        currentState = currentState.withStep(iteration);\n\n        // Check abort signal\n        if (signal?.aborted) {\n          throw new Error('Execution aborted');\n        }\n\n        // Call strategy hooks\n        strategy.onStepStart?.(iteration, currentState);\n\n        // Generate response - llm.generate uses rest params, pass messages array\n        const turn = await llm.generate(inputMessages);\n        finalTurn = turn;\n\n        // Update state with messages from this turn\n        currentState = currentState.withMessages(turn.messages);\n\n        // Call action hook if there were tool calls\n        if (turn.response.hasToolCalls) {\n          strategy.onAct?.(iteration, turn.response.toolCalls ?? []);\n        }\n\n        // Call observe hook if there were tool executions\n        if (turn.toolExecutions && turn.toolExecutions.length > 0) {\n          strategy.onObserve?.(iteration, turn.toolExecutions);\n        }\n\n        // Call step end hook\n        strategy.onStepEnd?.(iteration, { turn, state: currentState });\n\n        // Save checkpoint after step completes (fire-and-forget, log errors)\n        if (context.checkpoints && context.sessionId) {\n          context.checkpoints.save(context.sessionId, currentState.toJSON()).catch((err) => {\n            console.error('[UAP] Checkpoint save failed:', err);\n          });\n        }\n\n        // Check stop condition\n        const shouldStop = await strategy.stopCondition?.(currentState);\n        if (shouldStop) {\n          break;\n        }\n\n        // Check if there are more tool calls to process\n        // UPP's llm.generate handles the tool loop internally,\n        // so we only need one iteration unless we're doing multi-step\n        if (!turn.response.hasToolCalls) {\n          break;\n        }\n\n        // Check iteration limit\n        if (opts.maxIterations !== Infinity && iteration >= opts.maxIterations) {\n          break;\n        }\n\n        // For next iteration, use the updated messages\n        inputMessages.length = 0;\n        inputMessages.push(...currentState.messages);\n      }\n\n      if (!finalTurn) {\n        throw new Error('No turn generated');\n      }\n\n      // Include sessionId in state metadata if checkpointing is enabled\n      // Per UAP spec Section 3.4: sessionId MUST be included in state.metadata\n      let finalState = currentState;\n      if (context.sessionId) {\n        finalState = currentState.withMetadata('sessionId', context.sessionId);\n      }\n\n      const result: ExecutionResult = {\n        turn: finalTurn,\n        state: finalState,\n      };\n\n      strategy.onComplete?.(result);\n\n      return result;\n    },\n\n    stream(context: ExecutionContext): AgentStreamResult {\n      const { llm, input, state, strategy, signal } = context;\n      const agentId = context.agent.id;\n\n      let aborted = false;\n      const abortController = new AbortController();\n\n      // Combine signals if one was provided\n      if (signal) {\n        signal.addEventListener('abort', () => abortController.abort());\n      }\n\n      let resolveResult: (result: ExecutionResult) => void;\n      let rejectResult: (error: Error) => void;\n\n      const resultPromise = new Promise<ExecutionResult>((resolve, reject) => {\n        resolveResult = resolve;\n        rejectResult = reject;\n      });\n\n      async function* generateEvents(): AsyncGenerator<AgentStreamEvent> {\n        // Add input message to state and set agentId in metadata\n        // This ensures checkpoints include the full conversation\n        let currentState = state\n          .withMessage(input)\n          .withMetadata('agentId', context.agent.id);\n        let iteration = 0;\n        let finalTurn: Turn | undefined;\n\n        // Messages for LLM generation (includes input we just added)\n        const inputMessages = [...currentState.messages];\n\n        try {\n          while (!aborted) {\n            iteration++;\n            currentState = currentState.withStep(iteration);\n\n            if (abortController.signal.aborted) {\n              throw new Error('Execution aborted');\n            }\n\n            strategy.onStepStart?.(iteration, currentState);\n\n            // Emit step start event\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_start',\n                step: iteration,\n                agentId,\n                data: { iteration },\n              },\n            };\n\n            // Stream the LLM response\n            const streamResult = llm.stream(inputMessages);\n\n            for await (const event of streamResult as AsyncIterable<StreamEvent>) {\n              if (abortController.signal.aborted) {\n                throw new Error('Execution aborted');\n              }\n\n              // Yield UPP events\n              yield {\n                source: 'upp',\n                upp: event,\n              };\n            }\n\n            // Get the final turn from the stream\n            const turn = await streamResult.turn;\n            finalTurn = turn;\n\n            currentState = currentState.withMessages(turn.messages);\n\n            if (turn.response.hasToolCalls) {\n              strategy.onAct?.(iteration, turn.response.toolCalls ?? []);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'action',\n                  step: iteration,\n                  agentId,\n                  data: { toolCalls: turn.response.toolCalls },\n                },\n              };\n            }\n\n            if (turn.toolExecutions && turn.toolExecutions.length > 0) {\n              strategy.onObserve?.(iteration, turn.toolExecutions);\n\n              yield {\n                source: 'uap',\n                uap: {\n                  type: 'observation',\n                  step: iteration,\n                  agentId,\n                  data: { observations: turn.toolExecutions },\n                },\n              };\n            }\n\n            strategy.onStepEnd?.(iteration, { turn, state: currentState });\n\n            // Save checkpoint after step completes (fire-and-forget, log errors)\n            if (context.checkpoints && context.sessionId) {\n              context.checkpoints.save(context.sessionId, currentState.toJSON()).catch((err) => {\n                console.error('[UAP] Checkpoint save failed:', err);\n              });\n            }\n\n            yield {\n              source: 'uap',\n              uap: {\n                type: 'step_end',\n                step: iteration,\n                agentId,\n                data: { iteration },\n              },\n            };\n\n            const shouldStop = await strategy.stopCondition?.(currentState);\n            if (shouldStop) {\n              break;\n            }\n\n            if (!turn.response.hasToolCalls) {\n              break;\n            }\n\n            if (opts.maxIterations !== Infinity && iteration >= opts.maxIterations) {\n              break;\n            }\n\n            inputMessages.length = 0;\n            inputMessages.push(...currentState.messages);\n          }\n\n          if (!finalTurn) {\n            throw new Error('No turn generated');\n          }\n\n          // Include sessionId in state metadata if checkpointing is enabled\n          // Per UAP spec Section 3.4: sessionId MUST be included in state.metadata\n          let finalState = currentState;\n          if (context.sessionId) {\n            finalState = currentState.withMetadata('sessionId', context.sessionId);\n          }\n\n          const result: ExecutionResult = {\n            turn: finalTurn,\n            state: finalState,\n          };\n\n          strategy.onComplete?.(result);\n          resolveResult(result);\n        } catch (error) {\n          const err = error instanceof Error ? error : new Error(String(error));\n          strategy.onError?.(err, currentState);\n          rejectResult(err);\n          throw err;\n        }\n      }\n\n      const iterator = generateEvents();\n\n      return {\n        [Symbol.asyncIterator]() {\n          return iterator;\n        },\n        result: resultPromise,\n        abort() {\n          aborted = true;\n          abortController.abort();\n        },\n      };\n    },\n  };\n}\n"]}