@providerprotocol/agents 0.0.2 → 0.0.3

package/dist/checkpoint/index.d.ts

@@ -0,0 +1,43 @@
+import { F as FileCheckpointOptions, C as CheckpointStore } from '../types-BhX9uD_d.js';
+export { b as CheckpointData, a as CheckpointMetadata } from '../types-BhX9uD_d.js';
+import '../types-2Vsthzyu.js';
+import '@providerprotocol/ai';
+
+/**
+ * File-based Checkpoint Store
+ *
+ * Reference implementation of CheckpointStore using the filesystem.
+ *
+ * @see UAP-1.0 Spec Section 12.4.3
+ */
+
+/**
+ * Create a file-based checkpoint store.
+ *
+ * Stores checkpoints as JSON files in a directory structure:
+ * ```
+ * {dir}/
+ *   {sessionId}/
+ *     checkpoint.json   # Latest state
+ *     metadata.json     # Session metadata
+ * ```
+ *
+ * @param options - Configuration options
+ * @returns CheckpointStore implementation
+ *
+ * @example
+ * ```typescript
+ * import { fileCheckpoints } from '@providerprotocol/agents/checkpoint';
+ *
+ * const store = fileCheckpoints({ dir: './my-checkpoints' });
+ *
+ * // Save a checkpoint
+ * await store.save('session-123', state.toJSON());
+ *
+ * // Load a checkpoint
+ * const saved = await store.load('session-123');
+ * ```
+ */
+declare function fileCheckpoints(options?: FileCheckpointOptions): CheckpointStore;
+
+export { CheckpointStore, FileCheckpointOptions, fileCheckpoints };

package/dist/checkpoint/index.js

@@ -0,0 +1,64 @@
+import { generateUUID } from '../chunk-EKRXMSDX.js';
+import { mkdir, readdir, rm, readFile, writeFile } from 'fs/promises';
+import { join } from 'path';
+
+var DEFAULT_DIR = ".checkpoints";
+function fileCheckpoints(options = {}) {
+  const dir = options.dir ?? DEFAULT_DIR;
+  async function ensureSessionDir(sessionId) {
+    const sessionDir = join(dir, sessionId);
+    await mkdir(sessionDir, { recursive: true });
+    return sessionDir;
+  }
+  function getPaths(sessionId) {
+    const sessionDir = join(dir, sessionId);
+    return {
+      checkpointPath: join(sessionDir, "checkpoint.json"),
+      metadataPath: join(sessionDir, "metadata.json")
+    };
+  }
+  return {
+    async save(sessionId, state) {
+      await ensureSessionDir(sessionId);
+      const { checkpointPath, metadataPath } = getPaths(sessionId);
+      const metadata = {
+        sessionId,
+        checkpointId: generateUUID(),
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        step: state.step,
+        agentId: state.metadata.agentId ?? "unknown"
+      };
+      await writeFile(checkpointPath, JSON.stringify(state, null, 2), "utf-8");
+      await writeFile(metadataPath, JSON.stringify(metadata, null, 2), "utf-8");
+    },
+    async load(sessionId) {
+      const { checkpointPath } = getPaths(sessionId);
+      try {
+        const content = await readFile(checkpointPath, "utf-8");
+        return JSON.parse(content);
+      } catch {
+        return null;
+      }
+    },
+    async delete(sessionId) {
+      const sessionDir = join(dir, sessionId);
+      try {
+        await rm(sessionDir, { recursive: true, force: true });
+      } catch {
+      }
+    },
+    async list() {
+      try {
+        await mkdir(dir, { recursive: true });
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+      } catch {
+        return [];
+      }
+    }
+  };
+}
+
+export { fileCheckpoints };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/checkpoint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/checkpoint/file.ts"],"names":[],"mappings":";;;;AAcA,IAAM,WAAA,GAAc,cAAA;AA6Bb,SAAS,eAAA,CAAgB,OAAA,GAAiC,EAAC,EAAoB;AACpF,EAAA,MAAM,GAAA,GAAM,QAAQ,GAAA,IAAO,WAAA;AAK3B,EAAA,eAAe,iBAAiB,SAAA,EAAoC;AAClE,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,GAAA,EAAK,SAAS,CAAA;AACtC,IAAA,MAAM,KAAA,CAAM,UAAA,EAAY,EAAE,SAAA,EAAW,MAAM,CAAA;AAC3C,IAAA,OAAO,UAAA;AAAA,EACT;AAKA,EAAA,SAAS,SAAS,SAAA,EAAqE;AACrF,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,GAAA,EAAK,SAAS,CAAA;AACtC,IAAA,OAAO;AAAA,MACL,cAAA,EAAgB,IAAA,CAAK,UAAA,EAAY,iBAAiB,CAAA;AAAA,MAClD,YAAA,EAAc,IAAA,CAAK,UAAA,EAAY,eAAe;AAAA,KAChD;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,MAAM,IAAA,CAAK,SAAA,EAAmB,KAAA,EAAsC;AAClE,MAAA,MAAM,iBAAiB,SAAS,CAAA;AAChC,MAAA,MAAM,EAAE,cAAA,EAAgB,YAAA,EAAa,GAAI,SAAS,SAAS,CAAA;AAG3D,MAAA,MAAM,QAAA,GAA+B;AAAA,QACnC,SAAA;AAAA,QACA,cAAc,YAAA,EAAa;AAAA,QAC3B,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA,EAAY;AAAA,QAClC,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ,OAAA,EAAS,KAAA,CAAM,QAAA,CAAS,OAAA,IAAqB;AAAA,OAC/C;AAGA,MAAA,MAAM,SAAA,CAAU,gBAAgB,IAAA,CAAK,SAAA,CAAU,OAAO,IAAA,EAAM,CAAC,GAAG,OAAO,CAAA;AACvE,MAAA,MAAM,SAAA,CAAU,cAAc,IAAA,CAAK,SAAA,CAAU,UAAU,IAAA,EAAM,CAAC,GAAG,OAAO,CAAA;AAAA,IAC1E,CAAA;AAAA,IAEA,MAAM,KAAK,SAAA,EAAmD;AAC5D,MAAA,MAAM,EAAE,cAAA,EAAe,GAAI,QAAA,CAAS,SAAS,CAAA;AAE7C,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,GAAU,MAAM,QAAA,CAAS,cAAA,EAAgB,OAAO,CAAA;AACtD,QAAA,OAAO,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,MAC3B,CAAA,CAAA,MAAQ;AAEN,QAAA,OAAO,IAAA;AAAA,MACT;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,OAAO,SAAA,EAAkC;AAC7C,MAAA,MAAM,UAAA,GAAa,IAAA,CAAK,GAAA,EAAK,SAAS,CAAA;AACtC,MAAA,IAAI;AACF,QAAA,MAAM,GAAG,UAAA,EAAY,EAAE,WAAW,IAAA,EAAM,KAAA,EAAO,MAAM,CAAA;AAAA,MACvD,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF,CAAA;AAAA,IAEA,MAAM,IAAA,GAA0B;AAC9B,MAAA,IAAI;AAEF,QAAA,MAAM,KAAA,CAAM,GAAA,EAAK,EAAE,SAAA,EAAW,MAAM,CAAA;AAEpC,QAAA,MAAM,UAAU,MAAM,OAAA,CAAQ,KAAK,EAAE,aAAA,EAAe,MAAM,CAAA;AAC1D,QAAA,OAAO,OAAA,CACJ,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,WAAA,EAAa,CAAA,CACrC,GAAA,CAAI,CAAC,KAAA,KAAU,KAAA,CAAM,IAAI,CAAA;AAAA,MAC9B,CAAA,CAAA,MAAQ;AACN,QAAA,OAAO,EAAC;AAAA,MACV;AAAA,IACF;AAAA,GACF;AACF","file":"index.js","sourcesContent":["/**\n * File-based Checkpoint Store\n *\n * Reference implementation of CheckpointStore using the filesystem.\n *\n * @see UAP-1.0 Spec Section 12.4.3\n */\n\nimport { mkdir, readdir, readFile, rm, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { AgentStateJSON } from '../state/types.ts';\nimport type { CheckpointStore, FileCheckpointOptions, CheckpointMetadata } from './types.ts';\nimport { generateUUID } from '../utils/uuid.ts';\n\nconst DEFAULT_DIR = '.checkpoints';\n\n/**\n * Create a file-based checkpoint store.\n *\n * Stores checkpoints as JSON files in a directory structure:\n * ```\n * {dir}/\n *   {sessionId}/\n *     checkpoint.json   # Latest state\n *     metadata.json     # Session metadata\n * ```\n *\n * @param options - Configuration options\n * @returns CheckpointStore implementation\n *\n * @example\n * ```typescript\n * import { fileCheckpoints } from '@providerprotocol/agents/checkpoint';\n *\n * const store = fileCheckpoints({ dir: './my-checkpoints' });\n *\n * // Save a checkpoint\n * await store.save('session-123', state.toJSON());\n *\n * // Load a checkpoint\n * const saved = await store.load('session-123');\n * ```\n */\nexport function fileCheckpoints(options: FileCheckpointOptions = {}): CheckpointStore {\n  const dir = options.dir ?? DEFAULT_DIR;\n\n  /**\n   * Ensure session directory exists.\n   */\n  async function ensureSessionDir(sessionId: string): Promise<string> {\n    const sessionDir = join(dir, sessionId);\n    await mkdir(sessionDir, { recursive: true });\n    return sessionDir;\n  }\n\n  /**\n   * Get paths for checkpoint files.\n   */\n  function getPaths(sessionId: string): { checkpointPath: string; metadataPath: string } {\n    const sessionDir = join(dir, sessionId);\n    return {\n      checkpointPath: join(sessionDir, 'checkpoint.json'),\n      metadataPath: join(sessionDir, 'metadata.json'),\n    };\n  }\n\n  return {\n    async save(sessionId: string, state: AgentStateJSON): Promise<void> {\n      await ensureSessionDir(sessionId);\n      const { checkpointPath, metadataPath } = getPaths(sessionId);\n\n      // Build metadata\n      const metadata: CheckpointMetadata = {\n        sessionId,\n        checkpointId: generateUUID(),\n        timestamp: new Date().toISOString(),\n        step: state.step,\n        agentId: state.metadata.agentId as string ?? 'unknown',\n      };\n\n      // Write checkpoint first, then metadata (sequential to avoid race conditions)\n      await writeFile(checkpointPath, JSON.stringify(state, null, 2), 'utf-8');\n      await writeFile(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');\n    },\n\n    async load(sessionId: string): Promise<AgentStateJSON | null> {\n      const { checkpointPath } = getPaths(sessionId);\n\n      try {\n        const content = await readFile(checkpointPath, 'utf-8');\n        return JSON.parse(content) as AgentStateJSON;\n      } catch {\n        // File doesn't exist or is invalid\n        return null;\n      }\n    },\n\n    async delete(sessionId: string): Promise<void> {\n      const sessionDir = join(dir, sessionId);\n      try {\n        await rm(sessionDir, { recursive: true, force: true });\n      } catch {\n        // Directory might not exist, ignore\n      }\n    },\n\n    async list(): Promise<string[]> {\n      try {\n        // Ensure base directory exists\n        await mkdir(dir, { recursive: true });\n\n        const entries = await readdir(dir, { withFileTypes: true });\n        return entries\n          .filter((entry) => entry.isDirectory())\n          .map((entry) => entry.name);\n      } catch {\n        return [];\n      }\n    },\n  };\n}\n"]}

package/{src/execution/loop.ts → dist/chunk-4ESYN66B.js}

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

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

@@ -0,0 +1 @@
+{"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"]}

package/dist/chunk-EKRXMSDX.js

@@ -0,0 +1,8 @@
+// src/utils/uuid.ts
+function generateUUID() {
+  return globalThis.crypto.randomUUID();
+}
+
+export { generateUUID };
+//# sourceMappingURL=chunk-EKRXMSDX.js.map
+//# sourceMappingURL=chunk-EKRXMSDX.js.map

package/dist/chunk-EKRXMSDX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/uuid.ts"],"names":[],"mappings":";AAIO,SAAS,YAAA,GAAuB;AACrC,EAAA,OAAO,UAAA,CAAW,OAAO,UAAA,EAAW;AACtC","file":"chunk-EKRXMSDX.js","sourcesContent":["/**\n * Generate a UUIDv4 identifier.\n * Uses the native crypto.randomUUID() which is available in Bun and modern Node.js.\n */\nexport function generateUUID(): string {\n  return globalThis.crypto.randomUUID();\n}\n"]}