@providerprotocol/agents 0.0.1 → 0.0.3

package/dist/chunk-PHI5ULBV.js

@@ -0,0 +1,427 @@
+import { generateUUID } from './chunk-EKRXMSDX.js';
+import { UserMessage, AssistantMessage, ToolResultMessage } from '@providerprotocol/ai';
+
+// src/state/types.ts
+var UAP_VERSION = "1.0.0";
+
+// src/state/index.ts
+var AgentState = class _AgentState {
+  id;
+  messages;
+  step;
+  metadata;
+  reasoning;
+  plan;
+  subagentTraces;
+  constructor(id, messages, step, metadata, reasoning, plan, subagentTraces) {
+    this.id = id;
+    this.messages = messages;
+    this.step = step;
+    this.metadata = metadata;
+    this.reasoning = reasoning;
+    this.plan = plan;
+    this.subagentTraces = subagentTraces;
+  }
+  /**
+   * Create an initial empty state.
+   */
+  static initial() {
+    return new _AgentState(
+      generateUUID(),
+      [],
+      0,
+      {},
+      [],
+      void 0,
+      []
+    );
+  }
+  /**
+   * Return new state with a message added.
+   */
+  withMessage(message) {
+    return new _AgentState(
+      generateUUID(),
+      [...this.messages, message],
+      this.step,
+      this.metadata,
+      this.reasoning,
+      this.plan,
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with messages added.
+   */
+  withMessages(messages) {
+    return new _AgentState(
+      generateUUID(),
+      [...this.messages, ...messages],
+      this.step,
+      this.metadata,
+      this.reasoning,
+      this.plan,
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with context replaced (all messages).
+   * Use for context window management (pruning, summarization).
+   */
+  withContext(messages) {
+    return new _AgentState(
+      generateUUID(),
+      [...messages],
+      this.step,
+      this.metadata,
+      this.reasoning,
+      this.plan,
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with updated step number.
+   */
+  withStep(step) {
+    return new _AgentState(
+      generateUUID(),
+      this.messages,
+      step,
+      this.metadata,
+      this.reasoning,
+      this.plan,
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with metadata entry added/updated.
+   */
+  withMetadata(key, value) {
+    return new _AgentState(
+      generateUUID(),
+      this.messages,
+      this.step,
+      { ...this.metadata, [key]: value },
+      this.reasoning,
+      this.plan,
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with reasoning trace added.
+   */
+  withReasoning(reasoning) {
+    return new _AgentState(
+      generateUUID(),
+      this.messages,
+      this.step,
+      this.metadata,
+      [...this.reasoning, reasoning],
+      this.plan,
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with plan set.
+   */
+  withPlan(plan) {
+    return new _AgentState(
+      generateUUID(),
+      this.messages,
+      this.step,
+      this.metadata,
+      this.reasoning,
+      [...plan],
+      this.subagentTraces
+    );
+  }
+  /**
+   * Return new state with sub-agent trace added.
+   * Per UAP spec Section 8.8.
+   */
+  withSubagentTrace(trace) {
+    return new _AgentState(
+      generateUUID(),
+      this.messages,
+      this.step,
+      this.metadata,
+      this.reasoning,
+      this.plan,
+      [...this.subagentTraces, trace]
+    );
+  }
+  /**
+   * Serialize state to JSON for persistence.
+   */
+  toJSON() {
+    return {
+      version: UAP_VERSION,
+      id: this.id,
+      messages: this.messages.map((msg) => serializeMessage(msg)),
+      step: this.step,
+      metadata: { ...this.metadata },
+      reasoning: [...this.reasoning],
+      plan: this.plan ? this.plan.map((s) => ({ ...s })) : void 0,
+      subagentTraces: this.subagentTraces.length > 0 ? this.subagentTraces.map((t) => ({ ...t })) : void 0
+    };
+  }
+  /**
+   * Deserialize state from JSON.
+   */
+  static fromJSON(json) {
+    if (json.version !== UAP_VERSION) {
+      throw new Error(`Unsupported UAP version: ${json.version}. Expected: ${UAP_VERSION}`);
+    }
+    return new _AgentState(
+      json.id,
+      json.messages.map((msg) => deserializeMessage(msg)),
+      json.step,
+      json.metadata,
+      json.reasoning,
+      json.plan ? json.plan.map((s) => ({ ...s })) : void 0,
+      json.subagentTraces ? json.subagentTraces.map((t) => ({ ...t })) : []
+    );
+  }
+};
+function serializeMessage(message) {
+  if (message instanceof UserMessage) {
+    return {
+      role: "user",
+      content: message.content,
+      metadata: message.metadata
+    };
+  }
+  if (message instanceof AssistantMessage) {
+    return {
+      role: "assistant",
+      content: {
+        content: message.content,
+        toolCalls: message.toolCalls
+      },
+      metadata: message.metadata
+    };
+  }
+  if (message instanceof ToolResultMessage) {
+    return {
+      role: "tool_result",
+      content: message.results,
+      metadata: message.metadata
+    };
+  }
+  throw new Error(`Unknown message type: ${typeof message}`);
+}
+function deserializeMessage(json) {
+  switch (json.role) {
+    case "user":
+      return new UserMessage(
+        json.content,
+        { metadata: json.metadata }
+      );
+    case "assistant": {
+      const assistantContent = json.content;
+      return new AssistantMessage(
+        assistantContent.content,
+        assistantContent.toolCalls,
+        { metadata: json.metadata }
+      );
+    }
+    case "tool_result":
+      return new ToolResultMessage(
+        json.content,
+        { metadata: json.metadata }
+      );
+    default:
+      throw new Error(`Unknown message role: ${json.role}`);
+  }
+}
+
+// src/thread-tree/index.ts
+var ThreadNode = class _ThreadNode {
+  /** Node ID (UUIDv4) */
+  id;
+  /** Parent node ID (null for root) */
+  parentId;
+  /** State snapshot at this node */
+  state;
+  /** Optional branch name */
+  name;
+  /** Child node IDs */
+  children;
+  constructor(id, parentId, state, name, children = []) {
+    this.id = id;
+    this.parentId = parentId;
+    this.state = state;
+    this.name = name;
+    this.children = children;
+  }
+  /**
+   * Serialize to JSON.
+   */
+  toJSON() {
+    return {
+      id: this.id,
+      parentId: this.parentId,
+      state: this.state.toJSON(),
+      name: this.name,
+      children: [...this.children]
+    };
+  }
+  /**
+   * Deserialize from JSON.
+   */
+  static fromJSON(json) {
+    return new _ThreadNode(
+      json.id,
+      json.parentId,
+      AgentState.fromJSON(json.state),
+      json.name,
+      [...json.children]
+    );
+  }
+};
+var ThreadTree = class _ThreadTree {
+  /** Root node */
+  root;
+  /** Currently active node */
+  currentNode;
+  /** All nodes by ID */
+  nodes;
+  constructor(root) {
+    if (root) {
+      this.root = root;
+      this.currentNode = root;
+      this.nodes = /* @__PURE__ */ new Map([[root.id, root]]);
+    } else {
+      const rootNode = new ThreadNode(
+        generateUUID(),
+        null,
+        AgentState.initial(),
+        "root"
+      );
+      this.root = rootNode;
+      this.currentNode = rootNode;
+      this.nodes = /* @__PURE__ */ new Map([[rootNode.id, rootNode]]);
+    }
+  }
+  /**
+   * Get the currently active node.
+   */
+  get current() {
+    return this.currentNode;
+  }
+  /**
+   * Create a branch from a node.
+   *
+   * @param fromId - ID of the node to branch from
+   * @param name - Optional name for the branch
+   * @returns ID of the new node
+   */
+  branch(fromId, name) {
+    const parent = this.nodes.get(fromId);
+    if (!parent) {
+      throw new Error(`Node not found: ${fromId}`);
+    }
+    const newNode = new ThreadNode(
+      generateUUID(),
+      fromId,
+      parent.state,
+      // Copy parent's state
+      name
+    );
+    parent.children.push(newNode.id);
+    this.nodes.set(newNode.id, newNode);
+    return newNode.id;
+  }
+  /**
+   * Switch to a different node.
+   *
+   * @param nodeId - ID of the node to switch to
+   */
+  checkout(nodeId) {
+    const node = this.nodes.get(nodeId);
+    if (!node) {
+      throw new Error(`Node not found: ${nodeId}`);
+    }
+    this.currentNode = node;
+  }
+  /**
+   * Get the AgentState representing the full history from root to current node.
+   * Since nodes store full state snapshots, this returns the current node's state.
+   *
+   * @returns AgentState with combined history
+   */
+  history() {
+    return this.currentNode.state.withMetadata("_threadTreeNodeId", this.currentNode.id);
+  }
+  /**
+   * Get all leaf nodes (nodes with no children).
+   *
+   * @returns Array of leaf node IDs
+   */
+  getLeaves() {
+    const leaves = [];
+    for (const [id, node] of this.nodes) {
+      if (node.children.length === 0) {
+        leaves.push(id);
+      }
+    }
+    return leaves;
+  }
+  /**
+   * Get all branch names.
+   *
+   * @returns Map of node IDs to branch names
+   */
+  getBranches() {
+    const branches = /* @__PURE__ */ new Map();
+    for (const [id, node] of this.nodes) {
+      if (node.name) {
+        branches.set(id, node.name);
+      }
+    }
+    return branches;
+  }
+  /**
+   * Serialize to JSON.
+   */
+  toJSON() {
+    const nodes = [];
+    for (const node of this.nodes.values()) {
+      nodes.push(node.toJSON());
+    }
+    return {
+      rootId: this.root.id,
+      currentId: this.currentNode.id,
+      nodes
+    };
+  }
+  /**
+   * Deserialize from JSON.
+   */
+  static fromJSON(json) {
+    const nodesMap = /* @__PURE__ */ new Map();
+    for (const nodeJson of json.nodes) {
+      const node = ThreadNode.fromJSON(nodeJson);
+      nodesMap.set(node.id, node);
+    }
+    const root = nodesMap.get(json.rootId);
+    const current = nodesMap.get(json.currentId);
+    if (!root) {
+      throw new Error(`Root node not found: ${json.rootId}`);
+    }
+    if (!current) {
+      throw new Error(`Current node not found: ${json.currentId}`);
+    }
+    const tree = new _ThreadTree(root);
+    tree.nodes.clear();
+    for (const [id, node] of nodesMap) {
+      tree.nodes.set(id, node);
+    }
+    tree.checkout(current.id);
+    return tree;
+  }
+};
+
+export { AgentState, ThreadNode, ThreadTree };
+//# sourceMappingURL=chunk-PHI5ULBV.js.map
+//# sourceMappingURL=chunk-PHI5ULBV.js.map

package/dist/chunk-PHI5ULBV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/state/types.ts","../src/state/index.ts","../src/thread-tree/index.ts"],"names":[],"mappings":"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","file":"chunk-PHI5ULBV.js","sourcesContent":["import type { Message, MessageMetadata, TokenUsage } from '@providerprotocol/ai';\n\n/**\n * Status of a plan step during execution.\n */\nexport type PlanStepStatus = 'pending' | 'in_progress' | 'completed' | 'failed';\n\n/**\n * A single tool execution trace from a sub-agent.\n * Per UAP spec Section 8.8.\n */\nexport interface ToolExecutionTrace {\n  /** Name of the tool */\n  toolName: string;\n  /** Tool call ID */\n  toolCallId?: string;\n  /** Arguments passed to the tool */\n  arguments: Record<string, unknown>;\n  /** Tool result */\n  result: string;\n  /** Whether the tool errored */\n  isError?: boolean;\n  /** Execution time in milliseconds */\n  duration?: number;\n}\n\n/**\n * Sub-agent execution trace for checkpoint persistence.\n * Per UAP spec Section 8.8.\n */\nexport interface SubagentExecutionTrace {\n  /** Unique ID of the sub-agent instance */\n  subagentId: string;\n  /** Type/name of the sub-agent */\n  subagentType: string;\n  /** Tool call ID that spawned this sub-agent */\n  parentToolCallId: string;\n  /** The task given to the sub-agent */\n  prompt: string;\n  /** Start timestamp (ms since epoch) */\n  startTime: number;\n  /** End timestamp (ms since epoch) */\n  endTime: number;\n  /** Whether execution succeeded */\n  success: boolean;\n  /** Sub-agent's response (if successful) */\n  result?: string;\n  /** Error message (if failed) */\n  error?: string;\n  /** Tools used by sub-agent */\n  toolExecutions?: ToolExecutionTrace[];\n  /** Token usage for sub-agent */\n  usage?: TokenUsage;\n}\n\n/**\n * Serialized form of SubagentExecutionTrace.\n */\nexport interface SubagentExecutionTraceJSON {\n  subagentId: string;\n  subagentType: string;\n  parentToolCallId: string;\n  prompt: string;\n  startTime: number;\n  endTime: number;\n  success: boolean;\n  result?: string;\n  error?: string;\n  toolExecutions?: ToolExecutionTrace[];\n  usage?: TokenUsage;\n}\n\n/**\n * A single step in an execution plan.\n */\nexport interface PlanStep {\n  /** Unique step identifier */\n  id: string;\n  /** Description of what this step does */\n  description: string;\n  /** Tool to use (if applicable) */\n  tool?: string;\n  /** IDs of steps this depends on */\n  dependsOn: string[];\n  /** Current status */\n  status: PlanStepStatus;\n}\n\n/**\n * Serialized form of a PlanStep.\n */\nexport interface PlanStepJSON {\n  id: string;\n  description: string;\n  tool?: string;\n  dependsOn: string[];\n  status: PlanStepStatus;\n}\n\n/**\n * Serialized form of AgentState for persistence.\n */\nexport interface AgentStateJSON {\n  /** UAP version */\n  version: string;\n  /** State snapshot ID */\n  id: string;\n  /** Serialized messages */\n  messages: MessageJSON[];\n  /** Current step number */\n  step: number;\n  /** User-defined metadata */\n  metadata: Record<string, unknown>;\n  /** Reasoning traces (for ReAct) */\n  reasoning: string[];\n  /** Execution plan (for Plan strategy) */\n  plan?: PlanStepJSON[];\n  /** Sub-agent execution traces (per UAP spec Section 8.8) */\n  subagentTraces?: SubagentExecutionTraceJSON[];\n}\n\n/**\n * Serialized form of a Message.\n * This preserves the UPP Message structure for serialization.\n */\nexport interface MessageJSON {\n  role: 'user' | 'assistant' | 'tool_result';\n  content: unknown;\n  metadata?: MessageMetadata;\n}\n\n/**\n * Interface for AgentState operations.\n * All operations return new instances (immutable).\n */\nexport interface AgentStateInterface {\n  /** State snapshot ID (UUIDv4) */\n  readonly id: string;\n  /** Conversation history (UPP Messages) */\n  readonly messages: readonly Message[];\n  /** Current step number */\n  readonly step: number;\n  /** User-defined metadata */\n  readonly metadata: Readonly<Record<string, unknown>>;\n  /** Reasoning traces (for ReAct) */\n  readonly reasoning: readonly string[];\n  /** Execution plan (for Plan strategy) */\n  readonly plan: readonly PlanStep[] | undefined;\n  /** Sub-agent execution traces (per UAP spec Section 8.8) */\n  readonly subagentTraces: readonly SubagentExecutionTrace[];\n\n  /** Return new state with message added */\n  withMessage(message: Message): AgentStateInterface;\n  /** Return new state with messages added */\n  withMessages(messages: Message[]): AgentStateInterface;\n  /** Return new state with context replaced (all messages) */\n  withContext(messages: Message[]): AgentStateInterface;\n  /** Return new state with updated step */\n  withStep(step: number): AgentStateInterface;\n  /** Return new state with metadata entry */\n  withMetadata(key: string, value: unknown): AgentStateInterface;\n  /** Return new state with reasoning added */\n  withReasoning(reasoning: string): AgentStateInterface;\n  /** Return new state with plan set */\n  withPlan(plan: PlanStep[]): AgentStateInterface;\n  /** Return new state with sub-agent trace added */\n  withSubagentTrace(trace: SubagentExecutionTrace): AgentStateInterface;\n  /** Serialize to JSON */\n  toJSON(): AgentStateJSON;\n}\n\n/** UAP version for serialization */\nexport const UAP_VERSION = '1.0.0';\n","import type {\n  Message,\n  UserContent,\n  AssistantContent,\n  ToolCall,\n  ToolResult,\n} from '@providerprotocol/ai';\nimport { UserMessage, AssistantMessage, ToolResultMessage } from '@providerprotocol/ai';\nimport { generateUUID } from '../utils/uuid.ts';\nimport type {\n  AgentStateInterface,\n  AgentStateJSON,\n  PlanStep,\n  MessageJSON,\n  SubagentExecutionTrace,\n} from './types.ts';\nimport { UAP_VERSION } from './types.ts';\n\n/**\n * Immutable agent state snapshot.\n * All operations return new instances - the original state is never mutated.\n */\nexport class AgentState implements AgentStateInterface {\n  readonly id: string;\n\n  readonly messages: readonly Message[];\n\n  readonly step: number;\n\n  readonly metadata: Readonly<Record<string, unknown>>;\n\n  readonly reasoning: readonly string[];\n\n  readonly plan: readonly PlanStep[] | undefined;\n\n  readonly subagentTraces: readonly SubagentExecutionTrace[];\n\n  private constructor(\n    id: string,\n    messages: readonly Message[],\n    step: number,\n    metadata: Readonly<Record<string, unknown>>,\n    reasoning: readonly string[],\n    plan: readonly PlanStep[] | undefined,\n    subagentTraces: readonly SubagentExecutionTrace[],\n  ) {\n    this.id = id;\n    this.messages = messages;\n    this.step = step;\n    this.metadata = metadata;\n    this.reasoning = reasoning;\n    this.plan = plan;\n    this.subagentTraces = subagentTraces;\n  }\n\n  /**\n   * Create an initial empty state.\n   */\n  static initial(): AgentState {\n    return new AgentState(\n      generateUUID(),\n      [],\n      0,\n      {},\n      [],\n      undefined,\n      [],\n    );\n  }\n\n  /**\n   * Return new state with a message added.\n   */\n  withMessage(message: Message): AgentState {\n    return new AgentState(\n      generateUUID(),\n      [...this.messages, message],\n      this.step,\n      this.metadata,\n      this.reasoning,\n      this.plan,\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with messages added.\n   */\n  withMessages(messages: Message[]): AgentState {\n    return new AgentState(\n      generateUUID(),\n      [...this.messages, ...messages],\n      this.step,\n      this.metadata,\n      this.reasoning,\n      this.plan,\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with context replaced (all messages).\n   * Use for context window management (pruning, summarization).\n   */\n  withContext(messages: Message[]): AgentState {\n    return new AgentState(\n      generateUUID(),\n      [...messages],\n      this.step,\n      this.metadata,\n      this.reasoning,\n      this.plan,\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with updated step number.\n   */\n  withStep(step: number): AgentState {\n    return new AgentState(\n      generateUUID(),\n      this.messages,\n      step,\n      this.metadata,\n      this.reasoning,\n      this.plan,\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with metadata entry added/updated.\n   */\n  withMetadata(key: string, value: unknown): AgentState {\n    return new AgentState(\n      generateUUID(),\n      this.messages,\n      this.step,\n      { ...this.metadata, [key]: value },\n      this.reasoning,\n      this.plan,\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with reasoning trace added.\n   */\n  withReasoning(reasoning: string): AgentState {\n    return new AgentState(\n      generateUUID(),\n      this.messages,\n      this.step,\n      this.metadata,\n      [...this.reasoning, reasoning],\n      this.plan,\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with plan set.\n   */\n  withPlan(plan: PlanStep[]): AgentState {\n    return new AgentState(\n      generateUUID(),\n      this.messages,\n      this.step,\n      this.metadata,\n      this.reasoning,\n      [...plan],\n      this.subagentTraces,\n    );\n  }\n\n  /**\n   * Return new state with sub-agent trace added.\n   * Per UAP spec Section 8.8.\n   */\n  withSubagentTrace(trace: SubagentExecutionTrace): AgentState {\n    return new AgentState(\n      generateUUID(),\n      this.messages,\n      this.step,\n      this.metadata,\n      this.reasoning,\n      this.plan,\n      [...this.subagentTraces, trace],\n    );\n  }\n\n  /**\n   * Serialize state to JSON for persistence.\n   */\n  toJSON(): AgentStateJSON {\n    return {\n      version: UAP_VERSION,\n      id: this.id,\n      messages: this.messages.map((msg) => serializeMessage(msg)),\n      step: this.step,\n      metadata: { ...this.metadata },\n      reasoning: [...this.reasoning],\n      plan: this.plan ? this.plan.map((s) => ({ ...s })) : undefined,\n      subagentTraces: this.subagentTraces.length > 0\n        ? this.subagentTraces.map((t) => ({ ...t }))\n        : undefined,\n    };\n  }\n\n  /**\n   * Deserialize state from JSON.\n   */\n  static fromJSON(json: AgentStateJSON): AgentState {\n    if (json.version !== UAP_VERSION) {\n      throw new Error(`Unsupported UAP version: ${json.version}. Expected: ${UAP_VERSION}`);\n    }\n\n    return new AgentState(\n      json.id,\n      json.messages.map((msg) => deserializeMessage(msg)),\n      json.step,\n      json.metadata,\n      json.reasoning,\n      json.plan ? json.plan.map((s) => ({ ...s })) : undefined,\n      json.subagentTraces ? json.subagentTraces.map((t) => ({ ...t })) : [],\n    );\n  }\n}\n\n/**\n * Serialize a UPP Message to JSON.\n */\nfunction serializeMessage(message: Message): MessageJSON {\n  if (message instanceof UserMessage) {\n    return {\n      role: 'user',\n      content: message.content,\n      metadata: message.metadata,\n    };\n  }\n  if (message instanceof AssistantMessage) {\n    return {\n      role: 'assistant',\n      content: {\n        content: message.content,\n        toolCalls: message.toolCalls,\n      },\n      metadata: message.metadata,\n    };\n  }\n  if (message instanceof ToolResultMessage) {\n    return {\n      role: 'tool_result',\n      content: message.results,\n      metadata: message.metadata,\n    };\n  }\n  throw new Error(`Unknown message type: ${typeof message}`);\n}\n\n/**\n * Deserialize a JSON message to UPP Message.\n */\nfunction deserializeMessage(json: MessageJSON): Message {\n  switch (json.role) {\n    case 'user':\n      return new UserMessage(\n        json.content as string | UserContent[],\n        { metadata: json.metadata },\n      );\n    case 'assistant': {\n      const assistantContent = json.content as {\n        content: string | AssistantContent[];\n        toolCalls?: ToolCall[];\n      };\n      return new AssistantMessage(\n        assistantContent.content,\n        assistantContent.toolCalls,\n        { metadata: json.metadata },\n      );\n    }\n    case 'tool_result':\n      return new ToolResultMessage(\n        json.content as ToolResult[],\n        { metadata: json.metadata },\n      );\n    default:\n      throw new Error(`Unknown message role: ${json.role}`);\n  }\n}\n\nexport type {\n  AgentStateInterface,\n  AgentStateJSON,\n  PlanStep,\n  PlanStepStatus,\n  SubagentExecutionTrace,\n  SubagentExecutionTraceJSON,\n  ToolExecutionTrace,\n} from './types.ts';\n","import { generateUUID } from '../utils/uuid.ts';\nimport { AgentState } from '../state/index.ts';\nimport type { ThreadNodeJSON, ThreadTreeJSON } from './types.ts';\n\n/**\n * A node in the thread tree representing a conversation state snapshot.\n */\nexport class ThreadNode {\n  /** Node ID (UUIDv4) */\n  readonly id: string;\n\n  /** Parent node ID (null for root) */\n  readonly parentId: string | null;\n\n  /** State snapshot at this node */\n  state: AgentState;\n\n  /** Optional branch name */\n  name?: string;\n\n  /** Child node IDs */\n  readonly children: string[];\n\n  constructor(\n    id: string,\n    parentId: string | null,\n    state: AgentState,\n    name?: string,\n    children: string[] = [],\n  ) {\n    this.id = id;\n    this.parentId = parentId;\n    this.state = state;\n    this.name = name;\n    this.children = children;\n  }\n\n  /**\n   * Serialize to JSON.\n   */\n  toJSON(): ThreadNodeJSON {\n    return {\n      id: this.id,\n      parentId: this.parentId,\n      state: this.state.toJSON(),\n      name: this.name,\n      children: [...this.children],\n    };\n  }\n\n  /**\n   * Deserialize from JSON.\n   */\n  static fromJSON(json: ThreadNodeJSON): ThreadNode {\n    return new ThreadNode(\n      json.id,\n      json.parentId,\n      AgentState.fromJSON(json.state),\n      json.name,\n      [...json.children],\n    );\n  }\n}\n\n/**\n * A tree-structured collection of conversation threads with parent-child relationships.\n * Enables branching conversations and easy switching between alternative paths.\n */\nexport class ThreadTree {\n  /** Root node */\n  readonly root: ThreadNode;\n\n  /** Currently active node */\n  private currentNode: ThreadNode;\n\n  /** All nodes by ID */\n  readonly nodes: Map<string, ThreadNode>;\n\n  constructor(root?: ThreadNode) {\n    if (root) {\n      this.root = root;\n      this.currentNode = root;\n      this.nodes = new Map([[root.id, root]]);\n    } else {\n      const rootNode = new ThreadNode(\n        generateUUID(),\n        null,\n        AgentState.initial(),\n        'root',\n      );\n      this.root = rootNode;\n      this.currentNode = rootNode;\n      this.nodes = new Map([[rootNode.id, rootNode]]);\n    }\n  }\n\n  /**\n   * Get the currently active node.\n   */\n  get current(): ThreadNode {\n    return this.currentNode;\n  }\n\n  /**\n   * Create a branch from a node.\n   *\n   * @param fromId - ID of the node to branch from\n   * @param name - Optional name for the branch\n   * @returns ID of the new node\n   */\n  branch(fromId: string, name?: string): string {\n    const parent = this.nodes.get(fromId);\n    if (!parent) {\n      throw new Error(`Node not found: ${fromId}`);\n    }\n\n    const newNode = new ThreadNode(\n      generateUUID(),\n      fromId,\n      parent.state, // Copy parent's state\n      name,\n    );\n\n    // Add to parent's children\n    parent.children.push(newNode.id);\n\n    // Add to nodes map\n    this.nodes.set(newNode.id, newNode);\n\n    return newNode.id;\n  }\n\n  /**\n   * Switch to a different node.\n   *\n   * @param nodeId - ID of the node to switch to\n   */\n  checkout(nodeId: string): void {\n    const node = this.nodes.get(nodeId);\n    if (!node) {\n      throw new Error(`Node not found: ${nodeId}`);\n    }\n\n    this.currentNode = node;\n  }\n\n  /**\n   * Get the AgentState representing the full history from root to current node.\n   * Since nodes store full state snapshots, this returns the current node's state.\n   *\n   * @returns AgentState with combined history\n   */\n  history(): AgentState {\n    return this.currentNode.state\n      .withMetadata('_threadTreeNodeId', this.currentNode.id);\n  }\n\n  /**\n   * Get all leaf nodes (nodes with no children).\n   *\n   * @returns Array of leaf node IDs\n   */\n  getLeaves(): string[] {\n    const leaves: string[] = [];\n\n    for (const [id, node] of this.nodes) {\n      if (node.children.length === 0) {\n        leaves.push(id);\n      }\n    }\n\n    return leaves;\n  }\n\n  /**\n   * Get all branch names.\n   *\n   * @returns Map of node IDs to branch names\n   */\n  getBranches(): Map<string, string | undefined> {\n    const branches = new Map<string, string | undefined>();\n\n    for (const [id, node] of this.nodes) {\n      if (node.name) {\n        branches.set(id, node.name);\n      }\n    }\n\n    return branches;\n  }\n\n  /**\n   * Serialize to JSON.\n   */\n  toJSON(): ThreadTreeJSON {\n    const nodes: ThreadNodeJSON[] = [];\n\n    for (const node of this.nodes.values()) {\n      nodes.push(node.toJSON());\n    }\n\n    return {\n      rootId: this.root.id,\n      currentId: this.currentNode.id,\n      nodes,\n    };\n  }\n\n  /**\n   * Deserialize from JSON.\n   */\n  static fromJSON(json: ThreadTreeJSON): ThreadTree {\n    // First, create all nodes\n    const nodesMap = new Map<string, ThreadNode>();\n\n    for (const nodeJson of json.nodes) {\n      const node = ThreadNode.fromJSON(nodeJson);\n      nodesMap.set(node.id, node);\n    }\n\n    // Find root and current nodes\n    const root = nodesMap.get(json.rootId);\n    const current = nodesMap.get(json.currentId);\n\n    if (!root) {\n      throw new Error(`Root node not found: ${json.rootId}`);\n    }\n\n    if (!current) {\n      throw new Error(`Current node not found: ${json.currentId}`);\n    }\n\n    // Create tree with root\n    const tree = new ThreadTree(root);\n\n    // Replace the nodes map\n    tree.nodes.clear();\n    for (const [id, node] of nodesMap) {\n      tree.nodes.set(id, node);\n    }\n\n    // Set current node\n    tree.checkout(current.id);\n\n    return tree;\n  }\n}\n\nexport type { ThreadNodeJSON, ThreadTreeJSON } from './types.ts';\n"]}

package/dist/execution/index.d.ts

@@ -0,0 +1,105 @@
+import { L as LoopOptions, E as ExecutionStrategy, R as ReactOptions, P as PlanOptions } from '../types-DR02gtFv.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-DR02gtFv.js';
+import { ToolCall, Tool } from '@providerprotocol/ai';
+import '../index-qsPwbY86.js';
+import '../types-2Vsthzyu.js';
+import '../types-BhX9uD_d.js';
+
+/**
+ * Create a loop execution strategy.
+ * The simplest strategy - equivalent to UPP's tool loop behavior.
+ *
+ * Behavior:
+ * 1. Send input to LLM
+ * 2. If response has tool calls, execute tools and loop
+ * 3. Continue until no tool calls or maxIterations reached
+ * 4. Return final response as UPP Turn
+ *
+ * @param options - Loop configuration options
+ * @returns ExecutionStrategy
+ */
+declare function loop(options?: LoopOptions): ExecutionStrategy;
+
+/**
+ * Create a ReAct (Reason-Act-Observe) execution strategy.
+ *
+ * Behavior:
+ * 1. Reason: LLM outputs reasoning about what to do next
+ * 2. Act: LLM selects and executes tool(s)
+ * 3. Observe: Tool results are formatted as observations
+ * 4. Repeat until stop condition, no more actions, or maxSteps
+ *
+ * @param options - ReAct configuration options
+ * @returns ExecutionStrategy
+ */
+declare function react(options?: ReactOptions): ExecutionStrategy;
+
+/**
+ * Create a plan-then-execute strategy.
+ *
+ * Behavior:
+ * 1. Plan: LLM generates structured plan with steps and dependencies
+ * 2. Execute: Execute each plan step respecting dependency order
+ * 3. Replan: If a step fails and allowReplan is true, generate new plan
+ *
+ * @param options - Plan configuration options
+ * @returns 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 };