@browserbasehq/orca 3.1.0-patch.0 → 3.1.0-patch.1

package/dist/cjs/lib/v3/tests/agent-callbacks.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/agent-callbacks.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport type { StepResult, ToolSet } from \"ai\";\nimport { StreamingCallbacksInNonStreamingModeError } from \"../types/public/sdkErrors.js\";\n\ntest.describe(\"Stagehand agent callbacks behavior\", () => {\n  let v3: V3;\n\n  test.beforeEach(async () => {\n    v3 = new V3({\n      ...v3TestConfig,\n      experimental: true, // Required for callbacks and streaming\n    });\n    await v3.init();\n  });\n\n  test.afterEach(async () => {\n    await v3?.close?.().catch(() => {});\n  });\n\n  test.describe(\"Non-streaming callbacks (stream: false)\", () => {\n    test(\"onStepFinish callback is called for each step\", async () => {\n      test.setTimeout(60000);\n\n      const stepFinishEvents: StepResult<ToolSet>[] = [];\n\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      await agent.execute({\n        instruction:\n          \"What is the title of this page? Mark the task as complete after answering.\",\n        maxSteps: 5,\n        callbacks: {\n          onStepFinish: async (event) => {\n            stepFinishEvents.push(event);\n          },\n        },\n      });\n\n      // Should have at least one step finish event\n      expect(stepFinishEvents.length).toBeGreaterThan(0);\n\n      // Each event should have expected properties\n      for (const event of stepFinishEvents) {\n        expect(event).toHaveProperty(\"finishReason\");\n        expect(event).toHaveProperty(\"text\");\n      }\n    });\n\n    test(\"prepareStep callback is called before each step\", async () => {\n      test.setTimeout(60000);\n\n      let prepareStepCallCount = 0;\n\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      await agent.execute({\n        instruction: \"Simply describe the page briefly.\",\n        maxSteps: 3,\n        callbacks: {\n          prepareStep: async (stepContext) => {\n            prepareStepCallCount++;\n            return stepContext;\n          },\n        },\n      });\n\n      // prepareStep should have been called at least once\n      expect(prepareStepCallCount).toBeGreaterThan(0);\n    });\n\n    test(\"callbacks receive tool call information\", async () => {\n      test.setTimeout(60000);\n\n      const toolCalls: Array<{ toolName: string; input: unknown }> = [];\n\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      await agent.execute({\n        instruction:\n          \"Take a screenshot and describe what you see briefly. Then mark the task as complete.\",\n        maxSteps: 3,\n        callbacks: {\n          onStepFinish: async (event) => {\n            if (event.toolCalls) {\n              for (const tc of event.toolCalls) {\n                toolCalls.push({\n                  toolName: tc.toolName,\n                  input: tc.input,\n                });\n              }\n            }\n          },\n        },\n      });\n\n      // Should have captured at least one tool call (e.g. screenshot)\n      expect(toolCalls.length).toBeGreaterThan(0);\n      expect(\n        toolCalls.some(\n          (tc) => tc.toolName === \"screenshot\" || tc.toolName === \"ariaTree\",\n        ),\n      ).toBe(true);\n    });\n  });\n\n  test.describe(\"Streaming callbacks (stream: true)\", () => {\n    test(\"onStepFinish callback is called for each step in stream mode\", async () => {\n      test.setTimeout(60000);\n\n      const stepFinishEvents: StepResult<ToolSet>[] = [];\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"What is this page? Describe it briefly.\",\n        maxSteps: 5,\n        callbacks: {\n          onStepFinish: async (event) => {\n            stepFinishEvents.push(event);\n          },\n        },\n      });\n\n      // Consume the stream\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      for await (const _ of streamResult.textStream) {\n        // Just consume\n      }\n\n      // Wait for result to complete\n      await streamResult.result;\n\n      // Should have at least one step finish event\n      expect(stepFinishEvents.length).toBeGreaterThan(0);\n    });\n\n    test(\"onChunk callback is called for each chunk\", async () => {\n      test.setTimeout(60000);\n\n      let chunkCount = 0;\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"Say hello briefly and describe the page.\",\n        maxSteps: 3,\n        callbacks: {\n          onChunk: async () => {\n            chunkCount++;\n          },\n        },\n      });\n\n      // Consume the stream\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      for await (const _ of streamResult.textStream) {\n        // Just consume\n      }\n\n      await streamResult.result;\n\n      // Should have received chunks\n      expect(chunkCount).toBeGreaterThan(0);\n    });\n\n    test(\"onFinish callback is called when stream completes\", async () => {\n      test.setTimeout(60000);\n\n      let finishCalled = false;\n      let finishEvent: unknown = null;\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"Simply describe the page briefly.\",\n        maxSteps: 3,\n        callbacks: {\n          onFinish: (event) => {\n            finishCalled = true;\n            finishEvent = event;\n          },\n        },\n      });\n\n      // Consume the stream\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      for await (const _ of streamResult.textStream) {\n        // Just consume\n      }\n\n      await streamResult.result;\n\n      // onFinish should have been called\n      expect(finishCalled).toBe(true);\n      expect(finishEvent).not.toBeNull();\n    });\n\n    test(\"prepareStep callback works in stream mode\", async () => {\n      test.setTimeout(60000);\n\n      let prepareStepCallCount = 0;\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"Simply describe the page briefly.\",\n        maxSteps: 3,\n        callbacks: {\n          prepareStep: async (stepContext) => {\n            prepareStepCallCount++;\n            return stepContext;\n          },\n        },\n      });\n\n      // Consume the stream\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      for await (const _ of streamResult.textStream) {\n        // Just consume\n      }\n\n      await streamResult.result;\n\n      // prepareStep should have been called at least once\n      expect(prepareStepCallCount).toBeGreaterThan(0);\n    });\n  });\n\n  test.describe(\"Streaming-only callbacks runtime validation\", () => {\n    test(\"throws StreamingCallbacksInNonStreamingModeError when onChunk is used\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onChunk: (() => {}) as never,\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StreamingCallbacksInNonStreamingModeError);\n        expect(\n          (error as StreamingCallbacksInNonStreamingModeError).invalidCallbacks,\n        ).toEqual([\"onChunk\"]);\n      }\n    });\n\n    test(\"throws StreamingCallbacksInNonStreamingModeError when onFinish is used\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onFinish: (() => {}) as never,\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StreamingCallbacksInNonStreamingModeError);\n        expect(\n          (error as StreamingCallbacksInNonStreamingModeError).invalidCallbacks,\n        ).toEqual([\"onFinish\"]);\n      }\n    });\n\n    test(\"throws StreamingCallbacksInNonStreamingModeError when onError is used\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onError: (() => {}) as never,\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StreamingCallbacksInNonStreamingModeError);\n        expect(\n          (error as StreamingCallbacksInNonStreamingModeError).invalidCallbacks,\n        ).toEqual([\"onError\"]);\n      }\n    });\n\n    test(\"throws StreamingCallbacksInNonStreamingModeError when onAbort is used\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onAbort: (() => {}) as never,\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StreamingCallbacksInNonStreamingModeError);\n        expect(\n          (error as StreamingCallbacksInNonStreamingModeError).invalidCallbacks,\n        ).toEqual([\"onAbort\"]);\n      }\n    });\n\n    test(\"error includes all invalid callbacks when multiple are used\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onChunk: (() => {}) as never,\n            onFinish: (() => {}) as never,\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StreamingCallbacksInNonStreamingModeError);\n        expect(\n          (error as StreamingCallbacksInNonStreamingModeError).invalidCallbacks,\n        ).toEqual([\"onChunk\", \"onFinish\"]);\n      }\n    });\n  });\n\n  test.describe(\"Combined callbacks\", () => {\n    test(\"multiple callbacks can be used together\", async () => {\n      test.setTimeout(60000);\n\n      let prepareStepCount = 0;\n      let stepFinishCount = 0;\n\n      const agent = v3.agent({\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      await agent.execute({\n        instruction: \"Simply describe the page briefly.\",\n        maxSteps: 3,\n        callbacks: {\n          prepareStep: async (stepContext) => {\n            prepareStepCount++;\n            return stepContext;\n          },\n          onStepFinish: async () => {\n            stepFinishCount++;\n          },\n        },\n      });\n\n      // Both callbacks should have been called\n      expect(prepareStepCount).toBeGreaterThan(0);\n      expect(stepFinishCount).toBeGreaterThan(0);\n    });\n\n    test(\"streaming with multiple callbacks\", async () => {\n      test.setTimeout(60000);\n\n      let prepareStepCount = 0;\n      let stepFinishCount = 0;\n      let chunkCount = 0;\n      let finishCalled = false;\n\n      const agent = v3.agent({\n        stream: true,\n        model: \"anthropic/claude-haiku-4-5-20251001\",\n      });\n\n      const page = v3.context.pages()[0];\n      await page.goto(\"https://example.com\");\n\n      const streamResult = await agent.execute({\n        instruction: \"Say hello briefly and describe the page.\",\n        maxSteps: 3,\n        callbacks: {\n          prepareStep: async (stepContext) => {\n            prepareStepCount++;\n            return stepContext;\n          },\n          onStepFinish: async () => {\n            stepFinishCount++;\n          },\n          onChunk: async () => {\n            chunkCount++;\n          },\n          onFinish: () => {\n            finishCalled = true;\n          },\n        },\n      });\n\n      // Consume the stream\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      for await (const _ of streamResult.textStream) {\n        // Just consume\n      }\n\n      await streamResult.result;\n\n      // All callbacks should have been called\n      expect(prepareStepCount).toBeGreaterThan(0);\n      expect(stepFinishCount).toBeGreaterThan(0);\n      expect(chunkCount).toBeGreaterThan(0);\n      expect(finishCalled).toBe(true);\n    });\n  });\n});\n"],
+  "mappings": "AAAA,kBAA6B;AAC7B,gBAAmB;AACnB,uBAA6B;AAE7B,uBAA0D;AAE1D,iBAAK,SAAS,sCAAsC,MAAM;AACxD,MAAI;AAEJ,mBAAK,WAAW,YAAY;AAC1B,SAAK,IAAI,aAAG;AAAA,MACV,GAAG;AAAA,MACH,cAAc;AAAA;AAAA,IAChB,CAAC;AACD,UAAM,GAAG,KAAK;AAAA,EAChB,CAAC;AAED,mBAAK,UAAU,YAAY;AACzB,UAAM,IAAI,QAAQ,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACpC,CAAC;AAED,mBAAK,SAAS,2CAA2C,MAAM;AAC7D,0BAAK,iDAAiD,YAAY;AAChE,uBAAK,WAAW,GAAK;AAErB,YAAM,mBAA0C,CAAC;AAEjD,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,MAAM,QAAQ;AAAA,QAClB,aACE;AAAA,QACF,UAAU;AAAA,QACV,WAAW;AAAA,UACT,cAAc,OAAO,UAAU;AAC7B,6BAAiB,KAAK,KAAK;AAAA,UAC7B;AAAA,QACF;AAAA,MACF,CAAC;AAGD,8BAAO,iBAAiB,MAAM,EAAE,gBAAgB,CAAC;AAGjD,iBAAW,SAAS,kBAAkB;AACpC,gCAAO,KAAK,EAAE,eAAe,cAAc;AAC3C,gCAAO,KAAK,EAAE,eAAe,MAAM;AAAA,MACrC;AAAA,IACF,CAAC;AAED,0BAAK,mDAAmD,YAAY;AAClE,uBAAK,WAAW,GAAK;AAErB,UAAI,uBAAuB;AAE3B,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,MAAM,QAAQ;AAAA,QAClB,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,aAAa,OAAO,gBAAgB;AAClC;AACA,mBAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF,CAAC;AAGD,8BAAO,oBAAoB,EAAE,gBAAgB,CAAC;AAAA,IAChD,CAAC;AAED,0BAAK,2CAA2C,YAAY;AAC1D,uBAAK,WAAW,GAAK;AAErB,YAAM,YAAyD,CAAC;AAEhE,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,MAAM,QAAQ;AAAA,QAClB,aACE;AAAA,QACF,UAAU;AAAA,QACV,WAAW;AAAA,UACT,cAAc,OAAO,UAAU;AAC7B,gBAAI,MAAM,WAAW;AACnB,yBAAW,MAAM,MAAM,WAAW;AAChC,0BAAU,KAAK;AAAA,kBACb,UAAU,GAAG;AAAA,kBACb,OAAO,GAAG;AAAA,gBACZ,CAAC;AAAA,cACH;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAGD,8BAAO,UAAU,MAAM,EAAE,gBAAgB,CAAC;AAC1C;AAAA,QACE,UAAU;AAAA,UACR,CAAC,OAAO,GAAG,aAAa,gBAAgB,GAAG,aAAa;AAAA,QAC1D;AAAA,MACF,EAAE,KAAK,IAAI;AAAA,IACb,CAAC;AAAA,EACH,CAAC;AAED,mBAAK,SAAS,sCAAsC,MAAM;AACxD,0BAAK,gEAAgE,YAAY;AAC/E,uBAAK,WAAW,GAAK;AAErB,YAAM,mBAA0C,CAAC;AAEjD,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,eAAe,MAAM,MAAM,QAAQ;AAAA,QACvC,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,cAAc,OAAO,UAAU;AAC7B,6BAAiB,KAAK,KAAK;AAAA,UAC7B;AAAA,QACF;AAAA,MACF,CAAC;AAID,uBAAiB,KAAK,aAAa,YAAY;AAAA,MAE/C;AAGA,YAAM,aAAa;AAGnB,8BAAO,iBAAiB,MAAM,EAAE,gBAAgB,CAAC;AAAA,IACnD,CAAC;AAED,0BAAK,6CAA6C,YAAY;AAC5D,uBAAK,WAAW,GAAK;AAErB,UAAI,aAAa;AAEjB,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,eAAe,MAAM,MAAM,QAAQ;AAAA,QACvC,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,SAAS,YAAY;AACnB;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAID,uBAAiB,KAAK,aAAa,YAAY;AAAA,MAE/C;AAEA,YAAM,aAAa;AAGnB,8BAAO,UAAU,EAAE,gBAAgB,CAAC;AAAA,IACtC,CAAC;AAED,0BAAK,qDAAqD,YAAY;AACpE,uBAAK,WAAW,GAAK;AAErB,UAAI,eAAe;AACnB,UAAI,cAAuB;AAE3B,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,eAAe,MAAM,MAAM,QAAQ;AAAA,QACvC,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,UAAU,CAAC,UAAU;AACnB,2BAAe;AACf,0BAAc;AAAA,UAChB;AAAA,QACF;AAAA,MACF,CAAC;AAID,uBAAiB,KAAK,aAAa,YAAY;AAAA,MAE/C;AAEA,YAAM,aAAa;AAGnB,8BAAO,YAAY,EAAE,KAAK,IAAI;AAC9B,8BAAO,WAAW,EAAE,IAAI,SAAS;AAAA,IACnC,CAAC;AAED,0BAAK,6CAA6C,YAAY;AAC5D,uBAAK,WAAW,GAAK;AAErB,UAAI,uBAAuB;AAE3B,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,eAAe,MAAM,MAAM,QAAQ;AAAA,QACvC,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,aAAa,OAAO,gBAAgB;AAClC;AACA,mBAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF,CAAC;AAID,uBAAiB,KAAK,aAAa,YAAY;AAAA,MAE/C;AAEA,YAAM,aAAa;AAGnB,8BAAO,oBAAoB,EAAE,gBAAgB,CAAC;AAAA,IAChD,CAAC;AAAA,EACH,CAAC;AAED,mBAAK,SAAS,+CAA+C,MAAM;AACjE,0BAAK,yEAAyE,YAAY;AACxF,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,UAAI;AACF,cAAM,MAAM,QAAQ;AAAA,UAClB,aAAa;AAAA,UACb,WAAW;AAAA,YACT,SAAU,MAAM;AAAA,YAAC;AAAA,UACnB;AAAA,QACF,CAAC;AACD,cAAM,IAAI,MAAM,6BAA6B;AAAA,MAC/C,SAAS,OAAO;AACd,gCAAO,KAAK,EAAE,eAAe,0DAAyC;AACtE;AAAA,UACG,MAAoD;AAAA,QACvD,EAAE,QAAQ,CAAC,SAAS,CAAC;AAAA,MACvB;AAAA,IACF,CAAC;AAED,0BAAK,0EAA0E,YAAY;AACzF,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,UAAI;AACF,cAAM,MAAM,QAAQ;AAAA,UAClB,aAAa;AAAA,UACb,WAAW;AAAA,YACT,UAAW,MAAM;AAAA,YAAC;AAAA,UACpB;AAAA,QACF,CAAC;AACD,cAAM,IAAI,MAAM,6BAA6B;AAAA,MAC/C,SAAS,OAAO;AACd,gCAAO,KAAK,EAAE,eAAe,0DAAyC;AACtE;AAAA,UACG,MAAoD;AAAA,QACvD,EAAE,QAAQ,CAAC,UAAU,CAAC;AAAA,MACxB;AAAA,IACF,CAAC;AAED,0BAAK,yEAAyE,YAAY;AACxF,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,UAAI;AACF,cAAM,MAAM,QAAQ;AAAA,UAClB,aAAa;AAAA,UACb,WAAW;AAAA,YACT,SAAU,MAAM;AAAA,YAAC;AAAA,UACnB;AAAA,QACF,CAAC;AACD,cAAM,IAAI,MAAM,6BAA6B;AAAA,MAC/C,SAAS,OAAO;AACd,gCAAO,KAAK,EAAE,eAAe,0DAAyC;AACtE;AAAA,UACG,MAAoD;AAAA,QACvD,EAAE,QAAQ,CAAC,SAAS,CAAC;AAAA,MACvB;AAAA,IACF,CAAC;AAED,0BAAK,yEAAyE,YAAY;AACxF,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,UAAI;AACF,cAAM,MAAM,QAAQ;AAAA,UAClB,aAAa;AAAA,UACb,WAAW;AAAA,YACT,SAAU,MAAM;AAAA,YAAC;AAAA,UACnB;AAAA,QACF,CAAC;AACD,cAAM,IAAI,MAAM,6BAA6B;AAAA,MAC/C,SAAS,OAAO;AACd,gCAAO,KAAK,EAAE,eAAe,0DAAyC;AACtE;AAAA,UACG,MAAoD;AAAA,QACvD,EAAE,QAAQ,CAAC,SAAS,CAAC;AAAA,MACvB;AAAA,IACF,CAAC;AAED,0BAAK,+DAA+D,YAAY;AAC9E,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,UAAI;AACF,cAAM,MAAM,QAAQ;AAAA,UAClB,aAAa;AAAA,UACb,WAAW;AAAA,YACT,SAAU,MAAM;AAAA,YAAC;AAAA,YACjB,UAAW,MAAM;AAAA,YAAC;AAAA,UACpB;AAAA,QACF,CAAC;AACD,cAAM,IAAI,MAAM,6BAA6B;AAAA,MAC/C,SAAS,OAAO;AACd,gCAAO,KAAK,EAAE,eAAe,0DAAyC;AACtE;AAAA,UACG,MAAoD;AAAA,QACvD,EAAE,QAAQ,CAAC,WAAW,UAAU,CAAC;AAAA,MACnC;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AAED,mBAAK,SAAS,sBAAsB,MAAM;AACxC,0BAAK,2CAA2C,YAAY;AAC1D,uBAAK,WAAW,GAAK;AAErB,UAAI,mBAAmB;AACvB,UAAI,kBAAkB;AAEtB,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,MAAM,QAAQ;AAAA,QAClB,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,aAAa,OAAO,gBAAgB;AAClC;AACA,mBAAO;AAAA,UACT;AAAA,UACA,cAAc,YAAY;AACxB;AAAA,UACF;AAAA,QACF;AAAA,MACF,CAAC;AAGD,8BAAO,gBAAgB,EAAE,gBAAgB,CAAC;AAC1C,8BAAO,eAAe,EAAE,gBAAgB,CAAC;AAAA,IAC3C,CAAC;AAED,0BAAK,qCAAqC,YAAY;AACpD,uBAAK,WAAW,GAAK;AAErB,UAAI,mBAAmB;AACvB,UAAI,kBAAkB;AACtB,UAAI,aAAa;AACjB,UAAI,eAAe;AAEnB,YAAM,QAAQ,GAAG,MAAM;AAAA,QACrB,QAAQ;AAAA,QACR,OAAO;AAAA,MACT,CAAC;AAED,YAAM,OAAO,GAAG,QAAQ,MAAM,EAAE,CAAC;AACjC,YAAM,KAAK,KAAK,qBAAqB;AAErC,YAAM,eAAe,MAAM,MAAM,QAAQ;AAAA,QACvC,aAAa;AAAA,QACb,UAAU;AAAA,QACV,WAAW;AAAA,UACT,aAAa,OAAO,gBAAgB;AAClC;AACA,mBAAO;AAAA,UACT;AAAA,UACA,cAAc,YAAY;AACxB;AAAA,UACF;AAAA,UACA,SAAS,YAAY;AACnB;AAAA,UACF;AAAA,UACA,UAAU,MAAM;AACd,2BAAe;AAAA,UACjB;AAAA,QACF;AAAA,MACF,CAAC;AAID,uBAAiB,KAAK,aAAa,YAAY;AAAA,MAE/C;AAEA,YAAM,aAAa;AAGnB,8BAAO,gBAAgB,EAAE,gBAAgB,CAAC;AAC1C,8BAAO,eAAe,EAAE,gBAAgB,CAAC;AACzC,8BAAO,UAAU,EAAE,gBAAgB,CAAC;AACpC,8BAAO,YAAY,EAAE,KAAK,IAAI;AAAA,IAChC,CAAC;AAAA,EACH,CAAC;AACH,CAAC;",
+  "names": []
+}

package/dist/cjs/lib/v3/tests/agent-experimental-validation.spec.js

@@ -0,0 +1,354 @@
+var import_test = require("@playwright/test");
+var import_zod = require("zod");
+var import_ai = require("ai");
+var import_v3 = require("../v3.js");
+var import_v3_config = require("./v3.config.js");
+var import_sdkErrors = require("../types/public/sdkErrors.js");
+const mockCustomTool = (0, import_ai.tool)({
+  description: "A mock tool for testing",
+  inputSchema: import_zod.z.object({
+    input: import_zod.z.string().describe("The input string")
+  }),
+  execute: async ({ input }) => {
+    return `Processed: ${input}`;
+  }
+});
+import_test.test.describe("Stagehand agent experimental feature validation", () => {
+  import_test.test.describe("Invalid argument errors", () => {
+    let v3;
+    import_test.test.beforeEach(async () => {
+      v3 = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: false
+      });
+      await v3.init();
+    });
+    import_test.test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    (0, import_test.test)("throws StagehandInvalidArgumentError when CUA and streaming are both enabled", async () => {
+      try {
+        v3.agent({
+          cua: true,
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.StagehandInvalidArgumentError);
+        (0, import_test.expect)(error.message).toContain("streaming");
+        (0, import_test.expect)(error.message).toContain("not supported with CUA");
+      }
+    });
+    (0, import_test.test)("throws StagehandInvalidArgumentError for CUA + streaming even with experimental: true", async () => {
+      await v3.close();
+      const v3Experimental = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: true
+      });
+      await v3Experimental.init();
+      try {
+        v3Experimental.agent({
+          cua: true,
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.StagehandInvalidArgumentError);
+        (0, import_test.expect)(error.message).toContain("streaming");
+        (0, import_test.expect)(error.message).toContain("not supported with CUA");
+      } finally {
+        await v3Experimental.close();
+      }
+    });
+  });
+  import_test.test.describe("Experimental feature errors without experimental: true", () => {
+    let v3;
+    import_test.test.beforeEach(async () => {
+      v3 = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: false
+      });
+      await v3.init();
+    });
+    import_test.test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for MCP integrations", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514",
+        integrations: ["https://mcp.example.com"]
+      });
+      try {
+        await agent.execute("test");
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain(
+          "MCP integrations and custom tools"
+        );
+      }
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for custom tools", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514",
+        tools: {
+          mockCustomTool
+        }
+      });
+      try {
+        await agent.execute("test");
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain(
+          "MCP integrations and custom tools"
+        );
+      }
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for streaming mode", async () => {
+      try {
+        const agent = v3.agent({
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        });
+        await agent.execute("test instruction");
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain("streaming");
+      }
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for callbacks", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      try {
+        await agent.execute({
+          instruction: "test",
+          callbacks: {
+            onStepFinish: async () => {
+            }
+          }
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain("callbacks");
+      }
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for abort signal", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain("abort signal");
+      }
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for message continuation", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      try {
+        await agent.execute({
+          instruction: "test",
+          messages: [{ role: "user", content: "previous message" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain("message continuation");
+      }
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError listing multiple features", async () => {
+      const agent = v3.agent({
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          callbacks: { onStepFinish: async () => {
+          } },
+          signal: controller.signal,
+          messages: [{ role: "user", content: "previous" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        const message = error.message;
+        (0, import_test.expect)(message).toContain("callbacks");
+        (0, import_test.expect)(message).toContain("abort signal");
+        (0, import_test.expect)(message).toContain("message continuation");
+      }
+    });
+  });
+  import_test.test.describe("CUA agent unsupported features", () => {
+    let v3;
+    import_test.test.beforeEach(async () => {
+      v3 = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: false
+      });
+      await v3.init();
+    });
+    import_test.test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    (0, import_test.test)("throws ExperimentalNotConfiguredError for CUA with integrations", async () => {
+      try {
+        v3.agent({
+          cua: true,
+          model: "anthropic/claude-sonnet-4-20250514",
+          integrations: ["https://mcp.example.com"]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.ExperimentalNotConfiguredError);
+        (0, import_test.expect)(error.message).toContain(
+          "MCP integrations and custom tools"
+        );
+      }
+    });
+    (0, import_test.test)("throws StagehandInvalidArgumentError for CUA with abort signal (not supported)", async () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.StagehandInvalidArgumentError);
+        (0, import_test.expect)(error.message).toContain("abort signal");
+        (0, import_test.expect)(error.message).toContain("not supported with CUA");
+      }
+    });
+    (0, import_test.test)("throws StagehandInvalidArgumentError for CUA with message continuation (not supported)", async () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      try {
+        await agent.execute({
+          instruction: "test",
+          messages: [{ role: "user", content: "previous message" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.StagehandInvalidArgumentError);
+        (0, import_test.expect)(error.message).toContain("message continuation");
+        (0, import_test.expect)(error.message).toContain("not supported with CUA");
+      }
+    });
+    (0, import_test.test)("throws StagehandInvalidArgumentError for CUA with multiple unsupported features", async () => {
+      const agent = v3.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal,
+          messages: [{ role: "user", content: "previous message" }]
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.StagehandInvalidArgumentError);
+        const message = error.message;
+        (0, import_test.expect)(message).toContain("abort signal");
+        (0, import_test.expect)(message).toContain("message continuation");
+        (0, import_test.expect)(message).toContain("are not supported with CUA");
+      }
+    });
+    (0, import_test.test)("throws StagehandInvalidArgumentError for CUA unsupported features even with experimental: true", async () => {
+      await v3.close();
+      const v3Experimental = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: true
+      });
+      await v3Experimental.init();
+      const agent = v3Experimental.agent({
+        cua: true,
+        model: "anthropic/claude-sonnet-4-20250514"
+      });
+      const controller = new AbortController();
+      try {
+        await agent.execute({
+          instruction: "test",
+          signal: controller.signal
+        });
+        throw new Error("Expected error to be thrown");
+      } catch (error) {
+        (0, import_test.expect)(error).toBeInstanceOf(import_sdkErrors.StagehandInvalidArgumentError);
+        (0, import_test.expect)(error.message).toContain("not supported with CUA");
+      } finally {
+        await v3Experimental.close();
+      }
+    });
+  });
+  import_test.test.describe("Valid configurations with experimental: true", () => {
+    let v3;
+    import_test.test.beforeEach(async () => {
+      v3 = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: true
+      });
+      await v3.init();
+    });
+    import_test.test.afterEach(async () => {
+      await v3?.close?.().catch(() => {
+      });
+    });
+    (0, import_test.test)("allows CUA without streaming", () => {
+      (0, import_test.expect)(
+        () => v3.agent({
+          cua: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        })
+      ).not.toThrow();
+    });
+    (0, import_test.test)("allows streaming mode", () => {
+      (0, import_test.expect)(
+        () => v3.agent({
+          stream: true,
+          model: "anthropic/claude-sonnet-4-20250514"
+        })
+      ).not.toThrow();
+    });
+    (0, import_test.test)("allows basic agent without experimental features", async () => {
+      const v3NonExperimental = new import_v3.V3({
+        ...import_v3_config.v3TestConfig,
+        experimental: false
+      });
+      await v3NonExperimental.init();
+      try {
+        (0, import_test.expect)(
+          () => v3NonExperimental.agent({
+            model: "anthropic/claude-sonnet-4-20250514"
+          })
+        ).not.toThrow();
+      } finally {
+        await v3NonExperimental.close();
+      }
+    });
+  });
+});
+//# sourceMappingURL=agent-experimental-validation.spec.js.map

package/dist/cjs/lib/v3/tests/agent-experimental-validation.spec.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../lib/v3/tests/agent-experimental-validation.spec.ts"],
+  "sourcesContent": ["import { test, expect } from \"@playwright/test\";\nimport { z } from \"zod\";\nimport { tool } from \"ai\";\nimport { V3 } from \"../v3.js\";\nimport { v3TestConfig } from \"./v3.config.js\";\nimport {\n  ExperimentalNotConfiguredError,\n  StagehandInvalidArgumentError,\n} from \"../types/public/sdkErrors.js\";\n\n// Define a mock custom tool for testing\nconst mockCustomTool = tool({\n  description: \"A mock tool for testing\",\n  inputSchema: z.object({\n    input: z.string().describe(\"The input string\"),\n  }),\n  execute: async ({ input }) => {\n    return `Processed: ${input}`;\n  },\n});\n\ntest.describe(\"Stagehand agent experimental feature validation\", () => {\n  test.describe(\"Invalid argument errors\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"throws StagehandInvalidArgumentError when CUA and streaming are both enabled\", async () => {\n      try {\n        v3.agent({\n          cua: true,\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"streaming\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA + streaming even with experimental: true\", async () => {\n      // Close the non-experimental instance\n      await v3.close();\n\n      // Create an experimental instance\n      const v3Experimental = new V3({\n        ...v3TestConfig,\n        experimental: true,\n      });\n      await v3Experimental.init();\n\n      try {\n        v3Experimental.agent({\n          cua: true,\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"streaming\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      } finally {\n        await v3Experimental.close();\n      }\n    });\n  });\n\n  test.describe(\"Experimental feature errors without experimental: true\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for MCP integrations\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n        integrations: [\"https://mcp.example.com\"],\n      });\n\n      try {\n        await agent.execute(\"test\");\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\n          \"MCP integrations and custom tools\",\n        );\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for custom tools\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n        tools: {\n          mockCustomTool,\n        },\n      });\n\n      try {\n        await agent.execute(\"test\");\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\n          \"MCP integrations and custom tools\",\n        );\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for streaming mode\", async () => {\n      try {\n        const agent = v3.agent({\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        });\n        await agent.execute(\"test instruction\");\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"streaming\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for callbacks\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: {\n            onStepFinish: async () => {},\n          },\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"callbacks\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for abort signal\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"abort signal\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for message continuation\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          messages: [{ role: \"user\", content: \"previous message\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\"message continuation\");\n      }\n    });\n\n    test(\"throws ExperimentalNotConfiguredError listing multiple features\", async () => {\n      const agent = v3.agent({\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          callbacks: { onStepFinish: async () => {} },\n          signal: controller.signal,\n          messages: [{ role: \"user\", content: \"previous\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        const message = (error as Error).message;\n        expect(message).toContain(\"callbacks\");\n        expect(message).toContain(\"abort signal\");\n        expect(message).toContain(\"message continuation\");\n      }\n    });\n  });\n\n  test.describe(\"CUA agent unsupported features\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"throws ExperimentalNotConfiguredError for CUA with integrations\", async () => {\n      // MCP integrations are still an experimental feature check (not unsupported)\n      try {\n        v3.agent({\n          cua: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n          integrations: [\"https://mcp.example.com\"],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(ExperimentalNotConfiguredError);\n        expect((error as Error).message).toContain(\n          \"MCP integrations and custom tools\",\n        );\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA with abort signal (not supported)\", async () => {\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"abort signal\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA with message continuation (not supported)\", async () => {\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          messages: [{ role: \"user\", content: \"previous message\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"message continuation\");\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA with multiple unsupported features\", async () => {\n      const agent = v3.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n          messages: [{ role: \"user\", content: \"previous message\" }],\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        const message = (error as Error).message;\n        expect(message).toContain(\"abort signal\");\n        expect(message).toContain(\"message continuation\");\n        expect(message).toContain(\"are not supported with CUA\");\n      }\n    });\n\n    test(\"throws StagehandInvalidArgumentError for CUA unsupported features even with experimental: true\", async () => {\n      // Close the non-experimental instance\n      await v3.close();\n\n      // Create an experimental instance\n      const v3Experimental = new V3({\n        ...v3TestConfig,\n        experimental: true,\n      });\n      await v3Experimental.init();\n\n      const agent = v3Experimental.agent({\n        cua: true,\n        model: \"anthropic/claude-sonnet-4-20250514\",\n      });\n\n      const controller = new AbortController();\n      try {\n        await agent.execute({\n          instruction: \"test\",\n          signal: controller.signal,\n        });\n        throw new Error(\"Expected error to be thrown\");\n      } catch (error) {\n        expect(error).toBeInstanceOf(StagehandInvalidArgumentError);\n        expect((error as Error).message).toContain(\"not supported with CUA\");\n      } finally {\n        await v3Experimental.close();\n      }\n    });\n  });\n\n  test.describe(\"Valid configurations with experimental: true\", () => {\n    let v3: V3;\n\n    test.beforeEach(async () => {\n      v3 = new V3({\n        ...v3TestConfig,\n        experimental: true,\n      });\n      await v3.init();\n    });\n\n    test.afterEach(async () => {\n      await v3?.close?.().catch(() => {});\n    });\n\n    test(\"allows CUA without streaming\", () => {\n      expect(() =>\n        v3.agent({\n          cua: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        }),\n      ).not.toThrow();\n    });\n\n    test(\"allows streaming mode\", () => {\n      expect(() =>\n        v3.agent({\n          stream: true,\n          model: \"anthropic/claude-sonnet-4-20250514\",\n        }),\n      ).not.toThrow();\n    });\n\n    test(\"allows basic agent without experimental features\", async () => {\n      const v3NonExperimental = new V3({\n        ...v3TestConfig,\n        experimental: false,\n      });\n      await v3NonExperimental.init();\n\n      try {\n        // This should work - just creating a basic agent with no experimental features\n        expect(() =>\n          v3NonExperimental.agent({\n            model: \"anthropic/claude-sonnet-4-20250514\",\n          }),\n        ).not.toThrow();\n      } finally {\n        await v3NonExperimental.close();\n      }\n    });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}