@providerprotocol/agents 0.0.4 → 0.0.6

package/README.md

@@ -11,6 +11,9 @@ A powerful, flexible agent framework implementing the Unified Agent Protocol (UA
 - **Streaming** - Full streaming support with UAP and UPP events
 - **Checkpointing** - Built-in session persistence and recovery
 - **Thread Trees** - Branching conversation support
+- **Sub-Agent Tools** - Helper utilities for creating tools that spawn sub-agents with event propagation
+- **Tool Context Injection** - Pass execution context (agentId, stateId, toolCallId) to tools
+- **Tool Ordering** - Execute tool calls respecting dependencies and sequential barriers
 - **Type-Safe** - 100% TypeScript with full type inference
 
 ## Installation

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

@@ -1,3 +1,5 @@
+import { generateUUID } from './chunk-EKRXMSDX.js';
+
 // src/execution/loop.ts
 var DEFAULT_LOOP_OPTIONS = {
   maxIterations: Infinity
@@ -197,6 +199,203 @@ 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
+  };
+}
+
+// src/execution/tool-ordering.ts
+function buildToolMap(tools) {
+  const map = /* @__PURE__ */ new Map();
+  for (const tool of tools) {
+    map.set(tool.name, tool);
+  }
+  return map;
+}
+function getModelDependencies(call) {
+  const orderedCall = call;
+  return orderedCall.after ?? [];
+}
+function orderToolCalls(toolCalls, tools) {
+  if (toolCalls.length === 0) {
+    return [];
+  }
+  const toolMap = buildToolMap(tools);
+  const groups = [];
+  const completedCallIds = /* @__PURE__ */ new Set();
+  const completedToolNames = /* @__PURE__ */ new Set();
+  const pending = [...toolCalls];
+  while (pending.length > 0) {
+    const readyForExecution = [];
+    let hasSequential = false;
+    const stillPending = [];
+    for (const call of pending) {
+      const tool = toolMap.get(call.toolName);
+      const toolDependsOn = tool?.dependsOn ?? [];
+      const modelDependsOn = getModelDependencies(call);
+      const toolDepsOk = toolDependsOn.every(
+        (depName) => completedToolNames.has(depName)
+      );
+      const modelDepsOk = modelDependsOn.every(
+        (depId) => completedCallIds.has(depId)
+      );
+      if (toolDepsOk && modelDepsOk) {
+        readyForExecution.push(call);
+        if (tool?.sequential) {
+          hasSequential = true;
+        }
+      } else {
+        stillPending.push(call);
+      }
+    }
+    if (readyForExecution.length === 0 && stillPending.length > 0) {
+      groups.push({
+        calls: stillPending,
+        isBarrier: false
+      });
+      break;
+    }
+    if (hasSequential) {
+      for (const call of readyForExecution) {
+        const tool = toolMap.get(call.toolName);
+        groups.push({
+          calls: [call],
+          isBarrier: tool?.sequential ?? false
+        });
+        completedCallIds.add(call.toolCallId);
+        completedToolNames.add(call.toolName);
+      }
+    } else {
+      groups.push({
+        calls: readyForExecution,
+        isBarrier: false
+      });
+      for (const call of readyForExecution) {
+        completedCallIds.add(call.toolCallId);
+        completedToolNames.add(call.toolName);
+      }
+    }
+    pending.length = 0;
+    pending.push(...stillPending);
+  }
+  return groups;
+}
+function hasToolDependencies(tools) {
+  for (const tool of tools) {
+    const t = tool;
+    if (t.sequential || t.dependsOn && t.dependsOn.length > 0) {
+      return true;
+    }
+  }
+  return false;
+}
+function hasCallDependencies(toolCalls) {
+  for (const call of toolCalls) {
+    const ordered = call;
+    if (ordered.after && ordered.after.length > 0) {
+      return true;
+    }
+  }
+  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 { executeOrderedToolCalls, hasCallDependencies, hasToolDependencies, injectToolContext, isContextAwareTool, loop, orderToolCalls, withToolContext };
+//# sourceMappingURL=chunk-72YPNBK3.js.map
+//# sourceMappingURL=chunk-72YPNBK3.js.map

package/dist/chunk-72YPNBK3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/execution/loop.ts","../src/execution/tool-context.ts","../src/execution/tool-ordering.ts"],"names":[],"mappings":"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","file":"chunk-72YPNBK3.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","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/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 { ToolCall, Tool } from '@providerprotocol/ai';
+import { L as LoopOptions, E as ExecutionStrategy, R as ReactOptions, P as PlanOptions } from '../types-ClFW1Bjr.js';
+export { A as AgentStrategy, b as AgentStreamEvent, a as AgentStreamResult, C as ContextAwareToolRun, i as ExecutionContext, k 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, m as ToolDependencyOptions, T as ToolExecutionContext, n as ToolWithDependencies, U as UAPEventType } from '../types-ClFW1Bjr.js';
+export { E as ExecutionGroup, I as InjectToolContextOptions, T as ToolExecutionResult, c as ToolExecutor, e as executeOrderedToolCalls, h as hasCallDependencies, b as hasToolDependencies, i as injectToolContext, a as isContextAwareTool, o as orderToolCalls, w as withToolContext } from '../tool-ordering-BQCRKVKf.js';
+import '@providerprotocol/ai';
 import '../index-qsPwbY86.js';
 import '../types-2Vsthzyu.js';
 import '../types-DChRdQoX.js';
@@ -47,59 +48,4 @@ declare function react(options?: ReactOptions): ExecutionStrategy;
  */
 declare function plan(options?: PlanOptions): ExecutionStrategy;
 
-/**
- * Execution group - a set of tool calls that can execute in parallel.
- */
-interface ExecutionGroup {
-    /** Tool calls in this group */
-    calls: ToolCall[];
-    /** Whether this group contains a sequential tool (acts as barrier) */
-    isBarrier: boolean;
-}
-/**
- * Order tool calls into execution groups respecting dependencies.
- *
- * This function takes a list of tool calls and the available tools,
- * then groups them for execution while respecting:
- * 1. Tool-level `sequential` flag (creates execution barriers)
- * 2. Tool-level `dependsOn` array (tool must wait for named tools)
- * 3. Model-driven `after` array on tool calls (call must wait for specific calls)
- *
- * @param toolCalls - Tool calls from the model response
- * @param tools - Tool definitions (may include dependency options)
- * @returns Ordered array of execution groups
- *
- * @example
- * ```typescript
- * const groups = orderToolCalls(turn.response.toolCalls, agent.tools);
- *
- * for (const group of groups) {
- *   if (group.isBarrier) {
- *     // Execute sequentially
- *     for (const call of group.calls) {
- *       await executeTool(call);
- *     }
- *   } else {
- *     // Execute in parallel
- *     await Promise.all(group.calls.map(executeTool));
- *   }
- * }
- * ```
- */
-declare function orderToolCalls(toolCalls: ToolCall[], tools: Tool[]): ExecutionGroup[];
-/**
- * Check if any tools have execution dependencies defined.
- *
- * @param tools - Tool definitions to check
- * @returns true if any tool has sequential or dependsOn set
- */
-declare function hasToolDependencies(tools: Tool[]): boolean;
-/**
- * Check if any tool calls have model-driven dependencies.
- *
- * @param toolCalls - Tool calls to check
- * @returns true if any call has the `after` field set
- */
-declare function hasCallDependencies(toolCalls: ToolCall[]): boolean;
-
-export { type ExecutionGroup, ExecutionStrategy, LoopOptions, PlanOptions, ReactOptions, hasCallDependencies, hasToolDependencies, loop, orderToolCalls, plan, react };
+export { ExecutionStrategy, LoopOptions, PlanOptions, ReactOptions, loop, plan, react };

package/dist/execution/index.js

@@ -1,4 +1,4 @@
-export { loop } from '../chunk-4ESYN66B.js';
+export { executeOrderedToolCalls, hasCallDependencies, hasToolDependencies, injectToolContext, isContextAwareTool, loop, orderToolCalls, withToolContext } from '../chunk-72YPNBK3.js';
 import { generateUUID } from '../chunk-EKRXMSDX.js';
 import { UserMessage } from '@providerprotocol/ai';
 
@@ -579,101 +579,6 @@ function plan(options = {}) {
   };
 }
 
-// src/execution/tool-ordering.ts
-function buildToolMap(tools) {
-  const map = /* @__PURE__ */ new Map();
-  for (const tool of tools) {
-    map.set(tool.name, tool);
-  }
-  return map;
-}
-function getModelDependencies(call) {
-  const orderedCall = call;
-  return orderedCall.after ?? [];
-}
-function orderToolCalls(toolCalls, tools) {
-  if (toolCalls.length === 0) {
-    return [];
-  }
-  const toolMap = buildToolMap(tools);
-  const groups = [];
-  const completedCallIds = /* @__PURE__ */ new Set();
-  const completedToolNames = /* @__PURE__ */ new Set();
-  const pending = [...toolCalls];
-  while (pending.length > 0) {
-    const readyForExecution = [];
-    let hasSequential = false;
-    const stillPending = [];
-    for (const call of pending) {
-      const tool = toolMap.get(call.toolName);
-      const toolDependsOn = tool?.dependsOn ?? [];
-      const modelDependsOn = getModelDependencies(call);
-      const toolDepsOk = toolDependsOn.every(
-        (depName) => completedToolNames.has(depName)
-      );
-      const modelDepsOk = modelDependsOn.every(
-        (depId) => completedCallIds.has(depId)
-      );
-      if (toolDepsOk && modelDepsOk) {
-        readyForExecution.push(call);
-        if (tool?.sequential) {
-          hasSequential = true;
-        }
-      } else {
-        stillPending.push(call);
-      }
-    }
-    if (readyForExecution.length === 0 && stillPending.length > 0) {
-      groups.push({
-        calls: stillPending,
-        isBarrier: false
-      });
-      break;
-    }
-    if (hasSequential) {
-      for (const call of readyForExecution) {
-        const tool = toolMap.get(call.toolName);
-        groups.push({
-          calls: [call],
-          isBarrier: tool?.sequential ?? false
-        });
-        completedCallIds.add(call.toolCallId);
-        completedToolNames.add(call.toolName);
-      }
-    } else {
-      groups.push({
-        calls: readyForExecution,
-        isBarrier: false
-      });
-      for (const call of readyForExecution) {
-        completedCallIds.add(call.toolCallId);
-        completedToolNames.add(call.toolName);
-      }
-    }
-    pending.length = 0;
-    pending.push(...stillPending);
-  }
-  return groups;
-}
-function hasToolDependencies(tools) {
-  for (const tool of tools) {
-    const t = tool;
-    if (t.sequential || t.dependsOn && t.dependsOn.length > 0) {
-      return true;
-    }
-  }
-  return false;
-}
-function hasCallDependencies(toolCalls) {
-  for (const call of toolCalls) {
-    const ordered = call;
-    if (ordered.after && ordered.after.length > 0) {
-      return true;
-    }
-  }
-  return false;
-}
-
-export { hasCallDependencies, hasToolDependencies, orderToolCalls, plan, react };
+export { plan, react };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map