@agentxjs/devtools 1.9.5-dev → 2.0.0

package/dist/chunk-J6L73HM5.js

@@ -0,0 +1,301 @@
+import {
+  BUILTIN_FIXTURES
+} from "./chunk-6OHXS7LW.js";
+
+// src/mock/MockDriver.ts
+import { createLogger } from "commonxjs/logger";
+var logger = createLogger("devtools/MockDriver");
+var MockDriver = class {
+  name = "MockDriver";
+  _sessionId = null;
+  _state = "idle";
+  config;
+  options;
+  fixtures;
+  currentFixture;
+  // For interrupt handling
+  isInterrupted = false;
+  // Event cursor for multi-turn conversations
+  eventCursor = 0;
+  /**
+   * Create a MockDriver
+   *
+   * @param options - MockDriverOptions or DriverConfig
+   * @param mockOptions - MockDriverOptions if first param is DriverConfig
+   */
+  constructor(optionsOrConfig, mockOptions) {
+    if (mockOptions !== void 0 || "apiKey" in optionsOrConfig) {
+      this.config = optionsOrConfig;
+      const opts = mockOptions || {};
+      this.options = {
+        defaultDelay: 10,
+        speedMultiplier: 0,
+        ...opts
+      };
+    } else {
+      this.config = null;
+      const opts = optionsOrConfig;
+      this.options = {
+        defaultDelay: 10,
+        speedMultiplier: 0,
+        ...opts
+      };
+    }
+    this.fixtures = new Map(BUILTIN_FIXTURES);
+    if (this.options.fixtures) {
+      for (const [name, fixture] of this.options.fixtures) {
+        this.fixtures.set(name, fixture);
+      }
+    }
+    this.currentFixture = this.resolveFixture(this.options.fixture || "simple-reply");
+    logger.debug("MockDriver created", {
+      fixture: this.currentFixture.name,
+      agentId: this.config?.agentId
+    });
+  }
+  // ============================================================================
+  // Driver Interface Properties
+  // ============================================================================
+  get sessionId() {
+    return this._sessionId;
+  }
+  get state() {
+    return this._state;
+  }
+  // ============================================================================
+  // Lifecycle Methods
+  // ============================================================================
+  /**
+   * Initialize the Driver
+   */
+  async initialize() {
+    if (this._state !== "idle") {
+      throw new Error(`Cannot initialize: MockDriver is in "${this._state}" state`);
+    }
+    this._sessionId = `mock-session-${Date.now()}`;
+    logger.debug("MockDriver initialized", {
+      sessionId: this._sessionId,
+      fixture: this.currentFixture.name
+    });
+  }
+  /**
+   * Dispose and cleanup resources
+   */
+  async dispose() {
+    if (this._state === "disposed") {
+      return;
+    }
+    this._state = "disposed";
+    this.isInterrupted = true;
+    logger.debug("MockDriver disposed");
+  }
+  // ============================================================================
+  // Core Methods
+  // ============================================================================
+  /**
+   * Receive a user message and return stream of events
+   *
+   * Plays back the current fixture as DriverStreamEvent.
+   *
+   * @param message - User message (ignored for playback)
+   * @returns AsyncIterable of stream events
+   */
+  async *receive(_message) {
+    if (this._state === "disposed") {
+      throw new Error("Cannot receive: MockDriver is disposed");
+    }
+    if (this._state === "active") {
+      throw new Error("Cannot receive: MockDriver is already processing a message");
+    }
+    this._state = "active";
+    this.isInterrupted = false;
+    const { speedMultiplier = 0, defaultDelay = 10 } = this.options;
+    const events = this.currentFixture.events;
+    try {
+      while (this.eventCursor < events.length) {
+        const fixtureEvent = events[this.eventCursor];
+        this.eventCursor++;
+        if (this.isInterrupted) {
+          yield {
+            type: "interrupted",
+            timestamp: Date.now(),
+            data: { reason: "user" }
+          };
+          break;
+        }
+        const delay = fixtureEvent.delay || defaultDelay;
+        if (delay > 0 && speedMultiplier > 0) {
+          await this.sleep(delay * speedMultiplier);
+        }
+        const event = this.convertFixtureEvent(fixtureEvent);
+        if (event) {
+          yield event;
+        }
+        if (fixtureEvent.type === "message_stop") {
+          break;
+        }
+      }
+    } finally {
+      this._state = "idle";
+    }
+  }
+  /**
+   * Interrupt current operation
+   */
+  interrupt() {
+    if (this._state !== "active") {
+      logger.debug("Interrupt called but no active operation");
+      return;
+    }
+    logger.debug("MockDriver interrupted");
+    this.isInterrupted = true;
+  }
+  // ============================================================================
+  // Fixture Management
+  // ============================================================================
+  /**
+   * Set the fixture to use for next playback
+   */
+  setFixture(fixture) {
+    this.currentFixture = this.resolveFixture(fixture);
+    this.eventCursor = 0;
+    logger.debug("Fixture changed", { fixture: this.currentFixture.name });
+  }
+  /**
+   * Add a custom fixture
+   */
+  addFixture(fixture) {
+    this.fixtures.set(fixture.name, fixture);
+  }
+  /**
+   * Get the current fixture
+   */
+  getFixture() {
+    return this.currentFixture;
+  }
+  /**
+   * Get available fixture names
+   */
+  getFixtureNames() {
+    return Array.from(this.fixtures.keys());
+  }
+  // ============================================================================
+  // Private Methods
+  // ============================================================================
+  /**
+   * Resolve fixture from name or Fixture object
+   */
+  resolveFixture(fixture) {
+    if (typeof fixture === "string") {
+      const found = this.fixtures.get(fixture);
+      if (!found) {
+        logger.warn(`Fixture "${fixture}" not found, using "simple-reply"`);
+        return this.fixtures.get("simple-reply");
+      }
+      return found;
+    }
+    return fixture;
+  }
+  /**
+   * Convert FixtureEvent to DriverStreamEvent
+   */
+  convertFixtureEvent(fixtureEvent) {
+    const timestamp = Date.now();
+    const data = fixtureEvent.data;
+    switch (fixtureEvent.type) {
+      case "message_start":
+        return {
+          type: "message_start",
+          timestamp,
+          data: {
+            messageId: data.messageId || `msg_${timestamp}`,
+            model: data.model || "mock-model"
+          }
+        };
+      case "text_delta":
+        return {
+          type: "text_delta",
+          timestamp,
+          data: { text: data.text || "" }
+        };
+      case "tool_use_start":
+        return {
+          type: "tool_use_start",
+          timestamp,
+          data: {
+            toolCallId: data.toolCallId || `tool_${timestamp}`,
+            toolName: data.toolName || ""
+          }
+        };
+      case "input_json_delta":
+        return {
+          type: "input_json_delta",
+          timestamp,
+          data: { partialJson: data.partialJson || "" }
+        };
+      case "tool_use_stop":
+        return {
+          type: "tool_use_stop",
+          timestamp,
+          data: {
+            toolCallId: data.toolCallId || "",
+            toolName: data.toolName || "",
+            input: data.input || {}
+          }
+        };
+      case "tool_result":
+        return {
+          type: "tool_result",
+          timestamp,
+          data: {
+            toolCallId: data.toolCallId || "",
+            result: data.result,
+            isError: data.isError
+          }
+        };
+      case "message_delta":
+        return {
+          type: "message_delta",
+          timestamp,
+          data: {
+            usage: data.usage
+          }
+        };
+      case "message_stop":
+        return {
+          type: "message_stop",
+          timestamp,
+          data: {
+            stopReason: data.stopReason || "end_turn"
+          }
+        };
+      case "error":
+        return {
+          type: "error",
+          timestamp,
+          data: {
+            message: data.message || "Unknown error",
+            errorCode: data.errorCode || "mock_error"
+          }
+        };
+      default:
+        logger.debug(`Unknown fixture event type: ${fixtureEvent.type}`);
+        return null;
+    }
+  }
+  /**
+   * Sleep for specified milliseconds
+   */
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+function createMockDriver(mockOptions = {}) {
+  return (config) => new MockDriver(config, mockOptions);
+}
+
+export {
+  MockDriver,
+  createMockDriver
+};
+//# sourceMappingURL=chunk-J6L73HM5.js.map

package/dist/chunk-J6L73HM5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mock/MockDriver.ts"],"sourcesContent":["/**\n * MockDriver - Mock Driver for Testing\n *\n * Plays back recorded fixtures when receiving messages.\n * Implements the new Driver interface with receive() returning AsyncIterable.\n *\n * Usage:\n * ```typescript\n * const driver = new MockDriver({\n *   fixture: \"simple-reply\",\n * });\n *\n * await driver.initialize();\n *\n * for await (const event of driver.receive({ content: \"Hello\" })) {\n *   if (event.type === \"text_delta\") {\n *     console.log(event.data.text);\n *   }\n * }\n *\n * await driver.dispose();\n * ```\n */\n\nimport type { Driver, DriverConfig, DriverState, DriverStreamEvent } from \"@agentxjs/core/driver\";\nimport type { UserMessage } from \"@agentxjs/core/agent\";\nimport type { Fixture, FixtureEvent, MockDriverOptions } from \"../types\";\nimport { BUILTIN_FIXTURES } from \"../../fixtures\";\nimport { createLogger } from \"commonxjs/logger\";\n\nconst logger = createLogger(\"devtools/MockDriver\");\n\n/**\n * MockDriver - Playback driver for testing\n *\n * Implements the new Driver interface:\n * - receive() returns AsyncIterable<DriverStreamEvent>\n * - Clear input/output boundaries for testing\n */\nexport class MockDriver implements Driver {\n  readonly name = \"MockDriver\";\n\n  private _sessionId: string | null = null;\n  private _state: DriverState = \"idle\";\n\n  private readonly config: DriverConfig | null;\n  private readonly options: MockDriverOptions;\n  private readonly fixtures: Map<string, Fixture>;\n  private currentFixture: Fixture;\n\n  // For interrupt handling\n  private isInterrupted = false;\n\n  // Event cursor for multi-turn conversations\n  private eventCursor = 0;\n\n  /**\n   * Create a MockDriver\n   *\n   * @param options - MockDriverOptions or DriverConfig\n   * @param mockOptions - MockDriverOptions if first param is DriverConfig\n   */\n  constructor(optionsOrConfig: MockDriverOptions | DriverConfig, mockOptions?: MockDriverOptions) {\n    // Detect which constructor form is being used\n    if (mockOptions !== undefined || \"apiKey\" in optionsOrConfig) {\n      // Factory mode: (DriverConfig, MockDriverOptions)\n      this.config = optionsOrConfig as DriverConfig;\n      const opts = mockOptions || {};\n      this.options = {\n        defaultDelay: 10,\n        speedMultiplier: 0,\n        ...opts,\n      };\n    } else {\n      // Simple mode: (MockDriverOptions)\n      this.config = null;\n      const opts = optionsOrConfig as MockDriverOptions;\n      this.options = {\n        defaultDelay: 10,\n        speedMultiplier: 0,\n        ...opts,\n      };\n    }\n\n    // Initialize fixtures\n    this.fixtures = new Map(BUILTIN_FIXTURES);\n    if (this.options.fixtures) {\n      for (const [name, fixture] of this.options.fixtures) {\n        this.fixtures.set(name, fixture);\n      }\n    }\n\n    // Set initial fixture\n    this.currentFixture = this.resolveFixture(this.options.fixture || \"simple-reply\");\n\n    logger.debug(\"MockDriver created\", {\n      fixture: this.currentFixture.name,\n      agentId: this.config?.agentId,\n    });\n  }\n\n  // ============================================================================\n  // Driver Interface Properties\n  // ============================================================================\n\n  get sessionId(): string | null {\n    return this._sessionId;\n  }\n\n  get state(): DriverState {\n    return this._state;\n  }\n\n  // ============================================================================\n  // Lifecycle Methods\n  // ============================================================================\n\n  /**\n   * Initialize the Driver\n   */\n  async initialize(): Promise<void> {\n    if (this._state !== \"idle\") {\n      throw new Error(`Cannot initialize: MockDriver is in \"${this._state}\" state`);\n    }\n\n    // Generate a mock session ID\n    this._sessionId = `mock-session-${Date.now()}`;\n\n    logger.debug(\"MockDriver initialized\", {\n      sessionId: this._sessionId,\n      fixture: this.currentFixture.name,\n    });\n  }\n\n  /**\n   * Dispose and cleanup resources\n   */\n  async dispose(): Promise<void> {\n    if (this._state === \"disposed\") {\n      return;\n    }\n\n    this._state = \"disposed\";\n    this.isInterrupted = true;\n\n    logger.debug(\"MockDriver disposed\");\n  }\n\n  // ============================================================================\n  // Core Methods\n  // ============================================================================\n\n  /**\n   * Receive a user message and return stream of events\n   *\n   * Plays back the current fixture as DriverStreamEvent.\n   *\n   * @param message - User message (ignored for playback)\n   * @returns AsyncIterable of stream events\n   */\n  async *receive(_message: UserMessage): AsyncIterable<DriverStreamEvent> {\n    if (this._state === \"disposed\") {\n      throw new Error(\"Cannot receive: MockDriver is disposed\");\n    }\n\n    if (this._state === \"active\") {\n      throw new Error(\"Cannot receive: MockDriver is already processing a message\");\n    }\n\n    this._state = \"active\";\n    this.isInterrupted = false;\n\n    const { speedMultiplier = 0, defaultDelay = 10 } = this.options;\n    const events = this.currentFixture.events;\n\n    try {\n      // Start from cursor position and play until message_stop\n      while (this.eventCursor < events.length) {\n        const fixtureEvent = events[this.eventCursor];\n        this.eventCursor++;\n\n        // Check for interrupt\n        if (this.isInterrupted) {\n          yield {\n            type: \"interrupted\",\n            timestamp: Date.now(),\n            data: { reason: \"user\" },\n          };\n          break;\n        }\n\n        // Apply delay\n        const delay = fixtureEvent.delay || defaultDelay;\n        if (delay > 0 && speedMultiplier > 0) {\n          await this.sleep(delay * speedMultiplier);\n        }\n\n        // Convert and yield event\n        const event = this.convertFixtureEvent(fixtureEvent);\n        if (event) {\n          yield event;\n        }\n\n        // Stop at message_stop (end of one turn)\n        if (fixtureEvent.type === \"message_stop\") {\n          break;\n        }\n      }\n    } finally {\n      this._state = \"idle\";\n    }\n  }\n\n  /**\n   * Interrupt current operation\n   */\n  interrupt(): void {\n    if (this._state !== \"active\") {\n      logger.debug(\"Interrupt called but no active operation\");\n      return;\n    }\n\n    logger.debug(\"MockDriver interrupted\");\n    this.isInterrupted = true;\n  }\n\n  // ============================================================================\n  // Fixture Management\n  // ============================================================================\n\n  /**\n   * Set the fixture to use for next playback\n   */\n  setFixture(fixture: string | Fixture): void {\n    this.currentFixture = this.resolveFixture(fixture);\n    this.eventCursor = 0; // Reset cursor when fixture changes\n    logger.debug(\"Fixture changed\", { fixture: this.currentFixture.name });\n  }\n\n  /**\n   * Add a custom fixture\n   */\n  addFixture(fixture: Fixture): void {\n    this.fixtures.set(fixture.name, fixture);\n  }\n\n  /**\n   * Get the current fixture\n   */\n  getFixture(): Fixture {\n    return this.currentFixture;\n  }\n\n  /**\n   * Get available fixture names\n   */\n  getFixtureNames(): string[] {\n    return Array.from(this.fixtures.keys());\n  }\n\n  // ============================================================================\n  // Private Methods\n  // ============================================================================\n\n  /**\n   * Resolve fixture from name or Fixture object\n   */\n  private resolveFixture(fixture: string | Fixture): Fixture {\n    if (typeof fixture === \"string\") {\n      const found = this.fixtures.get(fixture);\n      if (!found) {\n        logger.warn(`Fixture \"${fixture}\" not found, using \"simple-reply\"`);\n        return this.fixtures.get(\"simple-reply\")!;\n      }\n      return found;\n    }\n    return fixture;\n  }\n\n  /**\n   * Convert FixtureEvent to DriverStreamEvent\n   */\n  private convertFixtureEvent(fixtureEvent: FixtureEvent): DriverStreamEvent | null {\n    const timestamp = Date.now();\n    const data = fixtureEvent.data as Record<string, unknown>;\n\n    switch (fixtureEvent.type) {\n      case \"message_start\":\n        return {\n          type: \"message_start\",\n          timestamp,\n          data: {\n            messageId: (data.messageId as string) || `msg_${timestamp}`,\n            model: (data.model as string) || \"mock-model\",\n          },\n        };\n\n      case \"text_delta\":\n        return {\n          type: \"text_delta\",\n          timestamp,\n          data: { text: (data.text as string) || \"\" },\n        };\n\n      case \"tool_use_start\":\n        return {\n          type: \"tool_use_start\",\n          timestamp,\n          data: {\n            toolCallId: (data.toolCallId as string) || `tool_${timestamp}`,\n            toolName: (data.toolName as string) || \"\",\n          },\n        };\n\n      case \"input_json_delta\":\n        return {\n          type: \"input_json_delta\",\n          timestamp,\n          data: { partialJson: (data.partialJson as string) || \"\" },\n        };\n\n      case \"tool_use_stop\":\n        return {\n          type: \"tool_use_stop\",\n          timestamp,\n          data: {\n            toolCallId: (data.toolCallId as string) || \"\",\n            toolName: (data.toolName as string) || \"\",\n            input: (data.input as Record<string, unknown>) || {},\n          },\n        };\n\n      case \"tool_result\":\n        return {\n          type: \"tool_result\",\n          timestamp,\n          data: {\n            toolCallId: (data.toolCallId as string) || \"\",\n            result: data.result,\n            isError: data.isError as boolean | undefined,\n          },\n        };\n\n      case \"message_delta\":\n        return {\n          type: \"message_delta\",\n          timestamp,\n          data: {\n            usage: data.usage as { inputTokens: number; outputTokens: number } | undefined,\n          },\n        };\n\n      case \"message_stop\":\n        return {\n          type: \"message_stop\",\n          timestamp,\n          data: {\n            stopReason:\n              (data.stopReason as\n                | \"end_turn\"\n                | \"tool_use\"\n                | \"max_tokens\"\n                | \"stop_sequence\"\n                | \"other\") || \"end_turn\",\n          },\n        };\n\n      case \"error\":\n        return {\n          type: \"error\",\n          timestamp,\n          data: {\n            message: (data.message as string) || \"Unknown error\",\n            errorCode: (data.errorCode as string) || \"mock_error\",\n          },\n        };\n\n      default:\n        // Pass through unknown events with generic structure\n        logger.debug(`Unknown fixture event type: ${fixtureEvent.type}`);\n        return null;\n    }\n  }\n\n  /**\n   * Sleep for specified milliseconds\n   */\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/**\n * Create a MockDriver factory function\n *\n * Returns a CreateDriver-compatible function.\n *\n * @param mockOptions - Options for all created drivers\n * @returns CreateDriver function\n */\nexport function createMockDriver(\n  mockOptions: MockDriverOptions = {}\n): (config: DriverConfig) => Driver {\n  return (config: DriverConfig) => new MockDriver(config, mockOptions);\n}\n"],"mappings":";;;;;AA4BA,SAAS,oBAAoB;AAE7B,IAAM,SAAS,aAAa,qBAAqB;AAS1C,IAAM,aAAN,MAAmC;AAAA,EAC/B,OAAO;AAAA,EAER,aAA4B;AAAA,EAC5B,SAAsB;AAAA,EAEb;AAAA,EACA;AAAA,EACA;AAAA,EACT;AAAA;AAAA,EAGA,gBAAgB;AAAA;AAAA,EAGhB,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtB,YAAY,iBAAmD,aAAiC;AAE9F,QAAI,gBAAgB,UAAa,YAAY,iBAAiB;AAE5D,WAAK,SAAS;AACd,YAAM,OAAO,eAAe,CAAC;AAC7B,WAAK,UAAU;AAAA,QACb,cAAc;AAAA,QACd,iBAAiB;AAAA,QACjB,GAAG;AAAA,MACL;AAAA,IACF,OAAO;AAEL,WAAK,SAAS;AACd,YAAM,OAAO;AACb,WAAK,UAAU;AAAA,QACb,cAAc;AAAA,QACd,iBAAiB;AAAA,QACjB,GAAG;AAAA,MACL;AAAA,IACF;AAGA,SAAK,WAAW,IAAI,IAAI,gBAAgB;AACxC,QAAI,KAAK,QAAQ,UAAU;AACzB,iBAAW,CAAC,MAAM,OAAO,KAAK,KAAK,QAAQ,UAAU;AACnD,aAAK,SAAS,IAAI,MAAM,OAAO;AAAA,MACjC;AAAA,IACF;AAGA,SAAK,iBAAiB,KAAK,eAAe,KAAK,QAAQ,WAAW,cAAc;AAEhF,WAAO,MAAM,sBAAsB;AAAA,MACjC,SAAS,KAAK,eAAe;AAAA,MAC7B,SAAS,KAAK,QAAQ;AAAA,IACxB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAMA,IAAI,YAA2B;AAC7B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,IAAI,QAAqB;AACvB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,aAA4B;AAChC,QAAI,KAAK,WAAW,QAAQ;AAC1B,YAAM,IAAI,MAAM,wCAAwC,KAAK,MAAM,SAAS;AAAA,IAC9E;AAGA,SAAK,aAAa,gBAAgB,KAAK,IAAI,CAAC;AAE5C,WAAO,MAAM,0BAA0B;AAAA,MACrC,WAAW,KAAK;AAAA,MAChB,SAAS,KAAK,eAAe;AAAA,IAC/B,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAAyB;AAC7B,QAAI,KAAK,WAAW,YAAY;AAC9B;AAAA,IACF;AAEA,SAAK,SAAS;AACd,SAAK,gBAAgB;AAErB,WAAO,MAAM,qBAAqB;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,OAAO,QAAQ,UAAyD;AACtE,QAAI,KAAK,WAAW,YAAY;AAC9B,YAAM,IAAI,MAAM,wCAAwC;AAAA,IAC1D;AAEA,QAAI,KAAK,WAAW,UAAU;AAC5B,YAAM,IAAI,MAAM,4DAA4D;AAAA,IAC9E;AAEA,SAAK,SAAS;AACd,SAAK,gBAAgB;AAErB,UAAM,EAAE,kBAAkB,GAAG,eAAe,GAAG,IAAI,KAAK;AACxD,UAAM,SAAS,KAAK,eAAe;AAEnC,QAAI;AAEF,aAAO,KAAK,cAAc,OAAO,QAAQ;AACvC,cAAM,eAAe,OAAO,KAAK,WAAW;AAC5C,aAAK;AAGL,YAAI,KAAK,eAAe;AACtB,gBAAM;AAAA,YACJ,MAAM;AAAA,YACN,WAAW,KAAK,IAAI;AAAA,YACpB,MAAM,EAAE,QAAQ,OAAO;AAAA,UACzB;AACA;AAAA,QACF;AAGA,cAAM,QAAQ,aAAa,SAAS;AACpC,YAAI,QAAQ,KAAK,kBAAkB,GAAG;AACpC,gBAAM,KAAK,MAAM,QAAQ,eAAe;AAAA,QAC1C;AAGA,cAAM,QAAQ,KAAK,oBAAoB,YAAY;AACnD,YAAI,OAAO;AACT,gBAAM;AAAA,QACR;AAGA,YAAI,aAAa,SAAS,gBAAgB;AACxC;AAAA,QACF;AAAA,MACF;AAAA,IACF,UAAE;AACA,WAAK,SAAS;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,YAAkB;AAChB,QAAI,KAAK,WAAW,UAAU;AAC5B,aAAO,MAAM,0CAA0C;AACvD;AAAA,IACF;AAEA,WAAO,MAAM,wBAAwB;AACrC,SAAK,gBAAgB;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,SAAiC;AAC1C,SAAK,iBAAiB,KAAK,eAAe,OAAO;AACjD,SAAK,cAAc;AACnB,WAAO,MAAM,mBAAmB,EAAE,SAAS,KAAK,eAAe,KAAK,CAAC;AAAA,EACvE;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,SAAwB;AACjC,SAAK,SAAS,IAAI,QAAQ,MAAM,OAAO;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,aAAsB;AACpB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,kBAA4B;AAC1B,WAAO,MAAM,KAAK,KAAK,SAAS,KAAK,CAAC;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASQ,eAAe,SAAoC;AACzD,QAAI,OAAO,YAAY,UAAU;AAC/B,YAAM,QAAQ,KAAK,SAAS,IAAI,OAAO;AACvC,UAAI,CAAC,OAAO;AACV,eAAO,KAAK,YAAY,OAAO,mCAAmC;AAClE,eAAO,KAAK,SAAS,IAAI,cAAc;AAAA,MACzC;AACA,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,oBAAoB,cAAsD;AAChF,UAAM,YAAY,KAAK,IAAI;AAC3B,UAAM,OAAO,aAAa;AAE1B,YAAQ,aAAa,MAAM;AAAA,MACzB,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,WAAY,KAAK,aAAwB,OAAO,SAAS;AAAA,YACzD,OAAQ,KAAK,SAAoB;AAAA,UACnC;AAAA,QACF;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM,EAAE,MAAO,KAAK,QAAmB,GAAG;AAAA,QAC5C;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,YAAa,KAAK,cAAyB,QAAQ,SAAS;AAAA,YAC5D,UAAW,KAAK,YAAuB;AAAA,UACzC;AAAA,QACF;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM,EAAE,aAAc,KAAK,eAA0B,GAAG;AAAA,QAC1D;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,YAAa,KAAK,cAAyB;AAAA,YAC3C,UAAW,KAAK,YAAuB;AAAA,YACvC,OAAQ,KAAK,SAAqC,CAAC;AAAA,UACrD;AAAA,QACF;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,YAAa,KAAK,cAAyB;AAAA,YAC3C,QAAQ,KAAK;AAAA,YACb,SAAS,KAAK;AAAA,UAChB;AAAA,QACF;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,OAAO,KAAK;AAAA,UACd;AAAA,QACF;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,YACG,KAAK,cAKU;AAAA,UACpB;AAAA,QACF;AAAA,MAEF,KAAK;AACH,eAAO;AAAA,UACL,MAAM;AAAA,UACN;AAAA,UACA,MAAM;AAAA,YACJ,SAAU,KAAK,WAAsB;AAAA,YACrC,WAAY,KAAK,aAAwB;AAAA,UAC3C;AAAA,QACF;AAAA,MAEF;AAEE,eAAO,MAAM,+BAA+B,aAAa,IAAI,EAAE;AAC/D,eAAO;AAAA,IACX;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,MAAM,IAA2B;AACvC,WAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AAAA,EACzD;AACF;AAUO,SAAS,iBACd,cAAiC,CAAC,GACA;AAClC,SAAO,CAAC,WAAyB,IAAI,WAAW,QAAQ,WAAW;AACrE;","names":[]}

package/dist/chunk-S7J75AXG.js

@@ -0,0 +1,64 @@
+// src/env.ts
+import { existsSync, readFileSync } from "fs";
+import { resolve, dirname } from "path";
+function loadEnvFile(filePath) {
+  if (!existsSync(filePath)) return;
+  const content = readFileSync(filePath, "utf-8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIndex = trimmed.indexOf("=");
+    if (eqIndex === -1) continue;
+    const key = trimmed.slice(0, eqIndex).trim();
+    let value = trimmed.slice(eqIndex + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    if (process.env[key] === void 0) {
+      process.env[key] = value;
+    }
+  }
+}
+function findMonorepoRoot() {
+  let dir = process.cwd();
+  while (true) {
+    const pkgPath = resolve(dir, "package.json");
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        if (pkg.workspaces) return dir;
+      } catch {
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}
+var cwd = process.cwd();
+loadEnvFile(resolve(cwd, ".env"));
+loadEnvFile(resolve(cwd, ".env.local"));
+var monorepoRoot = findMonorepoRoot();
+if (monorepoRoot && monorepoRoot !== cwd) {
+  loadEnvFile(resolve(monorepoRoot, ".env"));
+  loadEnvFile(resolve(monorepoRoot, ".env.local"));
+}
+var env = {
+  /** Deepractice API key */
+  get apiKey() {
+    return process.env.DEEPRACTICE_API_KEY;
+  },
+  /** Deepractice API base URL */
+  get baseUrl() {
+    return process.env.DEEPRACTICE_BASE_URL;
+  },
+  /** Model identifier */
+  get model() {
+    return process.env.DEEPRACTICE_MODEL || "claude-haiku-4-5-20251001";
+  }
+};
+
+export {
+  env
+};
+//# sourceMappingURL=chunk-S7J75AXG.js.map

package/dist/chunk-S7J75AXG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/env.ts"],"sourcesContent":["/**\n * Unified environment configuration for devtools\n *\n * Single source of truth for API credentials and model settings.\n * Automatically loads .env / .env.local from monorepo root on import.\n *\n * All devtools modules (VCR, BDD, Devtools SDK) should use this\n * instead of reading process.env directly.\n *\n * @example\n * ```ts\n * import { env } from \"@agentxjs/devtools\";\n *\n * const driver = createMonoDriver({\n *   apiKey: env.apiKey!,\n *   baseUrl: env.baseUrl,\n *   model: env.model,\n * });\n * ```\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve, dirname } from \"node:path\";\n\n// ============================================================================\n// Auto-load .env files from monorepo root\n// ============================================================================\n\nfunction loadEnvFile(filePath: string): void {\n  if (!existsSync(filePath)) return;\n  const content = readFileSync(filePath, \"utf-8\");\n  for (const line of content.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith(\"#\")) continue;\n    const eqIndex = trimmed.indexOf(\"=\");\n    if (eqIndex === -1) continue;\n    const key = trimmed.slice(0, eqIndex).trim();\n    let value = trimmed.slice(eqIndex + 1).trim();\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n    if (process.env[key] === undefined) {\n      process.env[key] = value;\n    }\n  }\n}\n\nfunction findMonorepoRoot(): string | null {\n  let dir = process.cwd();\n  while (true) {\n    const pkgPath = resolve(dir, \"package.json\");\n    if (existsSync(pkgPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n        if (pkg.workspaces) return dir;\n      } catch {}\n    }\n    const parent = dirname(dir);\n    if (parent === dir) return null;\n    dir = parent;\n  }\n}\n\n// Load on import — cwd first, then monorepo root\nconst cwd = process.cwd();\nloadEnvFile(resolve(cwd, \".env\"));\nloadEnvFile(resolve(cwd, \".env.local\"));\n\nconst monorepoRoot = findMonorepoRoot();\nif (monorepoRoot && monorepoRoot !== cwd) {\n  loadEnvFile(resolve(monorepoRoot, \".env\"));\n  loadEnvFile(resolve(monorepoRoot, \".env.local\"));\n}\n\n// ============================================================================\n// Public API\n// ============================================================================\n\nexport const env = {\n  /** Deepractice API key */\n  get apiKey(): string | undefined {\n    return process.env.DEEPRACTICE_API_KEY;\n  },\n\n  /** Deepractice API base URL */\n  get baseUrl(): string | undefined {\n    return process.env.DEEPRACTICE_BASE_URL;\n  },\n\n  /** Model identifier */\n  get model(): string {\n    return process.env.DEEPRACTICE_MODEL || \"claude-haiku-4-5-20251001\";\n  },\n};\n"],"mappings":";AAqBA,SAAS,YAAY,oBAAoB;AACzC,SAAS,SAAS,eAAe;AAMjC,SAAS,YAAY,UAAwB;AAC3C,MAAI,CAAC,WAAW,QAAQ,EAAG;AAC3B,QAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,aAAW,QAAQ,QAAQ,MAAM,IAAI,GAAG;AACtC,UAAM,UAAU,KAAK,KAAK;AAC1B,QAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,EAAG;AACzC,UAAM,UAAU,QAAQ,QAAQ,GAAG;AACnC,QAAI,YAAY,GAAI;AACpB,UAAM,MAAM,QAAQ,MAAM,GAAG,OAAO,EAAE,KAAK;AAC3C,QAAI,QAAQ,QAAQ,MAAM,UAAU,CAAC,EAAE,KAAK;AAC5C,QACG,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,KAC3C,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,GAC5C;AACA,cAAQ,MAAM,MAAM,GAAG,EAAE;AAAA,IAC3B;AACA,QAAI,QAAQ,IAAI,GAAG,MAAM,QAAW;AAClC,cAAQ,IAAI,GAAG,IAAI;AAAA,IACrB;AAAA,EACF;AACF;AAEA,SAAS,mBAAkC;AACzC,MAAI,MAAM,QAAQ,IAAI;AACtB,SAAO,MAAM;AACX,UAAM,UAAU,QAAQ,KAAK,cAAc;AAC3C,QAAI,WAAW,OAAO,GAAG;AACvB,UAAI;AACF,cAAM,MAAM,KAAK,MAAM,aAAa,SAAS,OAAO,CAAC;AACrD,YAAI,IAAI,WAAY,QAAO;AAAA,MAC7B,QAAQ;AAAA,MAAC;AAAA,IACX;AACA,UAAM,SAAS,QAAQ,GAAG;AAC1B,QAAI,WAAW,IAAK,QAAO;AAC3B,UAAM;AAAA,EACR;AACF;AAGA,IAAM,MAAM,QAAQ,IAAI;AACxB,YAAY,QAAQ,KAAK,MAAM,CAAC;AAChC,YAAY,QAAQ,KAAK,YAAY,CAAC;AAEtC,IAAM,eAAe,iBAAiB;AACtC,IAAI,gBAAgB,iBAAiB,KAAK;AACxC,cAAY,QAAQ,cAAc,MAAM,CAAC;AACzC,cAAY,QAAQ,cAAc,YAAY,CAAC;AACjD;AAMO,IAAM,MAAM;AAAA;AAAA,EAEjB,IAAI,SAA6B;AAC/B,WAAO,QAAQ,IAAI;AAAA,EACrB;AAAA;AAAA,EAGA,IAAI,UAA8B;AAChC,WAAO,QAAQ,IAAI;AAAA,EACrB;AAAA;AAAA,EAGA,IAAI,QAAgB;AAClB,WAAO,QAAQ,IAAI,qBAAqB;AAAA,EAC1C;AACF;","names":[]}

package/dist/fixtures/index.d.ts

@@ -0,0 +1,49 @@
+import { F as Fixture } from '../types-C6Lf3vz2.js';
+
+/**
+ * Built-in Fixtures for MockDriver
+ *
+ * These fixtures simulate common conversation patterns.
+ * They can be used directly or as templates for custom fixtures.
+ */
+
+/**
+ * Simple text reply - no tool calls
+ *
+ * Simulates: "Hello!" -> "Hello! How can I help you today?"
+ */
+declare const SIMPLE_REPLY: Fixture;
+/**
+ * Multi-paragraph response
+ *
+ * Simulates a longer response with multiple sentences
+ */
+declare const LONG_REPLY: Fixture;
+/**
+ * Tool call response - demonstrates tool_use flow
+ *
+ * Simulates: "What time is it?" -> tool_call(get_current_time) -> "It's 2:30 PM"
+ */
+declare const TOOL_CALL: Fixture;
+/**
+ * Error response
+ */
+declare const ERROR_RESPONSE: Fixture;
+/**
+ * Empty response (for edge case testing)
+ */
+declare const EMPTY_RESPONSE: Fixture;
+/**
+ * All built-in fixtures
+ */
+declare const BUILTIN_FIXTURES: Map<string, Fixture>;
+/**
+ * Get a built-in fixture by name
+ */
+declare function getFixture(name: string): Fixture | undefined;
+/**
+ * List all built-in fixture names
+ */
+declare function listFixtures(): string[];
+
+export { BUILTIN_FIXTURES, EMPTY_RESPONSE, ERROR_RESPONSE, LONG_REPLY, SIMPLE_REPLY, TOOL_CALL, getFixture, listFixtures };

package/dist/fixtures/index.js

@@ -0,0 +1,22 @@
+import {
+  BUILTIN_FIXTURES,
+  EMPTY_RESPONSE,
+  ERROR_RESPONSE,
+  LONG_REPLY,
+  SIMPLE_REPLY,
+  TOOL_CALL,
+  getFixture,
+  listFixtures
+} from "../chunk-6OHXS7LW.js";
+import "../chunk-DGUM43GV.js";
+export {
+  BUILTIN_FIXTURES,
+  EMPTY_RESPONSE,
+  ERROR_RESPONSE,
+  LONG_REPLY,
+  SIMPLE_REPLY,
+  TOOL_CALL,
+  getFixture,
+  listFixtures
+};
+//# sourceMappingURL=index.js.map

package/dist/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}