@agentxjs/devtools 1.9.3-dev → 1.9.6-dev

package/dist/chunk-YRTTCKHM.js

@@ -0,0 +1,152 @@
+// src/recorder/RecordingDriver.ts
+import { createLogger } from "commonxjs/logger";
+var logger = createLogger("devtools/RecordingDriver");
+var RecordingDriver = class {
+  name = "RecordingDriver";
+  realDriver;
+  fixtureName;
+  fixtureDescription;
+  recordedEvents = [];
+  recordingStartTime = 0;
+  constructor(options) {
+    this.realDriver = options.driver;
+    this.fixtureName = options.name;
+    this.fixtureDescription = options.description;
+    logger.info("RecordingDriver created", { name: this.fixtureName });
+  }
+  // ============================================================================
+  // Driver Interface Properties (delegate to real driver)
+  // ============================================================================
+  get sessionId() {
+    return this.realDriver.sessionId;
+  }
+  get state() {
+    return this.realDriver.state;
+  }
+  // ============================================================================
+  // Lifecycle Methods (delegate to real driver)
+  // ============================================================================
+  async initialize() {
+    await this.realDriver.initialize();
+    this.recordingStartTime = Date.now();
+    this.recordedEvents = [];
+    logger.info("RecordingDriver initialized, recording started", {
+      name: this.fixtureName
+    });
+  }
+  async dispose() {
+    await this.realDriver.dispose();
+    logger.info("RecordingDriver disposed", {
+      name: this.fixtureName,
+      eventsRecorded: this.recordedEvents.length
+    });
+  }
+  // ============================================================================
+  // Core Methods
+  // ============================================================================
+  /**
+   * Receive a user message and return stream of events
+   *
+   * Wraps the real driver's receive() and records all events.
+   */
+  async *receive(message) {
+    logger.debug("RecordingDriver receiving message", {
+      name: this.fixtureName
+    });
+    for await (const event of this.realDriver.receive(message)) {
+      this.recordEvent(event);
+      yield event;
+    }
+    logger.debug("RecordingDriver receive completed", {
+      name: this.fixtureName,
+      eventsRecorded: this.recordedEvents.length
+    });
+  }
+  /**
+   * Interrupt current operation (delegate to real driver)
+   */
+  interrupt() {
+    this.realDriver.interrupt();
+  }
+  // ============================================================================
+  // Recording Methods
+  // ============================================================================
+  /**
+   * Record an event
+   */
+  recordEvent(event) {
+    this.recordedEvents.push({
+      event,
+      timestamp: Date.now()
+    });
+    logger.debug("Event recorded", {
+      type: event.type,
+      totalEvents: this.recordedEvents.length
+    });
+  }
+  /**
+   * Get the recorded fixture
+   */
+  getFixture() {
+    const events = [];
+    let lastTimestamp = this.recordingStartTime;
+    for (const recorded of this.recordedEvents) {
+      const delay = recorded.timestamp - lastTimestamp;
+      lastTimestamp = recorded.timestamp;
+      events.push({
+        type: recorded.event.type,
+        delay: Math.max(0, delay),
+        data: recorded.event.data
+      });
+    }
+    return {
+      name: this.fixtureName,
+      description: this.fixtureDescription,
+      recordedAt: this.recordingStartTime,
+      events
+    };
+  }
+  /**
+   * Save the recorded fixture to a JSON file
+   */
+  async saveFixture(filePath) {
+    const fixture = this.getFixture();
+    const json = JSON.stringify(fixture, null, 2);
+    const { writeFile } = await import("fs/promises");
+    await writeFile(filePath, json, "utf-8");
+    logger.info("Fixture saved", {
+      path: filePath,
+      name: fixture.name,
+      eventCount: fixture.events.length
+    });
+  }
+  /**
+   * Get the number of recorded events
+   */
+  get eventCount() {
+    return this.recordedEvents.length;
+  }
+  /**
+   * Clear recorded events (start fresh recording)
+   */
+  clearRecording() {
+    this.recordedEvents = [];
+    this.recordingStartTime = Date.now();
+    logger.debug("Recording cleared");
+  }
+  /**
+   * Get raw recorded events (for debugging)
+   */
+  getRawEvents() {
+    return [...this.recordedEvents];
+  }
+};
+function createRecordingDriver(options) {
+  return new RecordingDriver(options);
+}
+
+export {
+  RecordingDriver,
+  createRecordingDriver
+};
+//# sourceMappingURL=chunk-YRTTCKHM.js.map

package/dist/chunk-YRTTCKHM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/recorder/RecordingDriver.ts"],"sourcesContent":["/**\n * RecordingDriver - Wraps a real driver to record events\n *\n * Used to capture real LLM API responses and save them as fixtures.\n * These fixtures can then be played back by MockDriver for testing.\n *\n * Usage:\n * ```typescript\n * import { createClaudeDriver } from \"@agentxjs/claude-driver\";\n * import { RecordingDriver } from \"@agentxjs/devtools/recorder\";\n *\n * // Create real driver\n * const realDriver = createClaudeDriver(config);\n *\n * // Wrap with recorder\n * const recorder = new RecordingDriver({\n *   driver: realDriver,\n *   name: \"my-scenario\",\n *   description: \"User asks about weather\",\n * });\n *\n * await recorder.initialize();\n *\n * // Use like a normal driver - events are recorded\n * for await (const event of recorder.receive({ content: \"Hello\" })) {\n *   console.log(event);\n * }\n *\n * // Save the fixture\n * await recorder.saveFixture(\"./fixtures/my-scenario.json\");\n * ```\n */\n\nimport type {\n  Driver,\n  DriverState,\n  DriverStreamEvent,\n} from \"@agentxjs/core/driver\";\nimport type { UserMessage } from \"@agentxjs/core/agent\";\nimport type { Fixture, FixtureEvent } from \"../types\";\nimport { createLogger } from \"commonxjs/logger\";\n\nconst logger = createLogger(\"devtools/RecordingDriver\");\n\n/**\n * Options for RecordingDriver\n */\nexport interface RecordingDriverOptions {\n  /**\n   * The real driver to wrap\n   */\n  driver: Driver;\n\n  /**\n   * Fixture name for the recording\n   */\n  name: string;\n\n  /**\n   * Description for the recording\n   */\n  description?: string;\n}\n\n/**\n * Recorded event with timing\n */\ninterface RecordedEvent {\n  event: DriverStreamEvent;\n  timestamp: number;\n}\n\n/**\n * RecordingDriver - Records events from a real driver\n *\n * Implements the new Driver interface by wrapping a real driver\n * and intercepting events from receive().\n */\nexport class RecordingDriver implements Driver {\n  readonly name = \"RecordingDriver\";\n\n  private readonly realDriver: Driver;\n  private readonly fixtureName: string;\n  private readonly fixtureDescription?: string;\n\n  private recordedEvents: RecordedEvent[] = [];\n  private recordingStartTime: number = 0;\n\n  constructor(options: RecordingDriverOptions) {\n    this.realDriver = options.driver;\n    this.fixtureName = options.name;\n    this.fixtureDescription = options.description;\n\n    logger.info(\"RecordingDriver created\", { name: this.fixtureName });\n  }\n\n  // ============================================================================\n  // Driver Interface Properties (delegate to real driver)\n  // ============================================================================\n\n  get sessionId(): string | null {\n    return this.realDriver.sessionId;\n  }\n\n  get state(): DriverState {\n    return this.realDriver.state;\n  }\n\n  // ============================================================================\n  // Lifecycle Methods (delegate to real driver)\n  // ============================================================================\n\n  async initialize(): Promise<void> {\n    await this.realDriver.initialize();\n    this.recordingStartTime = Date.now();\n    this.recordedEvents = [];\n    logger.info(\"RecordingDriver initialized, recording started\", {\n      name: this.fixtureName,\n    });\n  }\n\n  async dispose(): Promise<void> {\n    await this.realDriver.dispose();\n    logger.info(\"RecordingDriver disposed\", {\n      name: this.fixtureName,\n      eventsRecorded: this.recordedEvents.length,\n    });\n  }\n\n  // ============================================================================\n  // Core Methods\n  // ============================================================================\n\n  /**\n   * Receive a user message and return stream of events\n   *\n   * Wraps the real driver's receive() and records all events.\n   */\n  async *receive(message: UserMessage): AsyncIterable<DriverStreamEvent> {\n    logger.debug(\"RecordingDriver receiving message\", {\n      name: this.fixtureName,\n    });\n\n    // Call the real driver and intercept events\n    for await (const event of this.realDriver.receive(message)) {\n      // Record the event\n      this.recordEvent(event);\n\n      // Pass through to caller\n      yield event;\n    }\n\n    logger.debug(\"RecordingDriver receive completed\", {\n      name: this.fixtureName,\n      eventsRecorded: this.recordedEvents.length,\n    });\n  }\n\n  /**\n   * Interrupt current operation (delegate to real driver)\n   */\n  interrupt(): void {\n    this.realDriver.interrupt();\n  }\n\n  // ============================================================================\n  // Recording Methods\n  // ============================================================================\n\n  /**\n   * Record an event\n   */\n  private recordEvent(event: DriverStreamEvent): void {\n    this.recordedEvents.push({\n      event,\n      timestamp: Date.now(),\n    });\n\n    logger.debug(\"Event recorded\", {\n      type: event.type,\n      totalEvents: this.recordedEvents.length,\n    });\n  }\n\n  /**\n   * Get the recorded fixture\n   */\n  getFixture(): Fixture {\n    const events: FixtureEvent[] = [];\n    let lastTimestamp = this.recordingStartTime;\n\n    for (const recorded of this.recordedEvents) {\n      const delay = recorded.timestamp - lastTimestamp;\n      lastTimestamp = recorded.timestamp;\n\n      events.push({\n        type: recorded.event.type,\n        delay: Math.max(0, delay),\n        data: recorded.event.data,\n      });\n    }\n\n    return {\n      name: this.fixtureName,\n      description: this.fixtureDescription,\n      recordedAt: this.recordingStartTime,\n      events,\n    };\n  }\n\n  /**\n   * Save the recorded fixture to a JSON file\n   */\n  async saveFixture(filePath: string): Promise<void> {\n    const fixture = this.getFixture();\n    const json = JSON.stringify(fixture, null, 2);\n\n    // Use dynamic import for Node.js fs\n    const { writeFile } = await import(\"node:fs/promises\");\n    await writeFile(filePath, json, \"utf-8\");\n\n    logger.info(\"Fixture saved\", {\n      path: filePath,\n      name: fixture.name,\n      eventCount: fixture.events.length,\n    });\n  }\n\n  /**\n   * Get the number of recorded events\n   */\n  get eventCount(): number {\n    return this.recordedEvents.length;\n  }\n\n  /**\n   * Clear recorded events (start fresh recording)\n   */\n  clearRecording(): void {\n    this.recordedEvents = [];\n    this.recordingStartTime = Date.now();\n    logger.debug(\"Recording cleared\");\n  }\n\n  /**\n   * Get raw recorded events (for debugging)\n   */\n  getRawEvents(): RecordedEvent[] {\n    return [...this.recordedEvents];\n  }\n}\n\n/**\n * Create a RecordingDriver that wraps a real driver\n */\nexport function createRecordingDriver(options: RecordingDriverOptions): RecordingDriver {\n  return new RecordingDriver(options);\n}\n"],"mappings":"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","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,21 @@
+import {
+  BUILTIN_FIXTURES,
+  EMPTY_RESPONSE,
+  ERROR_RESPONSE,
+  LONG_REPLY,
+  SIMPLE_REPLY,
+  TOOL_CALL,
+  getFixture,
+  listFixtures
+} from "../chunk-6OHXS7LW.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":[]}

package/dist/index.d.ts

@@ -0,0 +1,207 @@
+import { CreateDriver, Driver } from '@agentxjs/core/driver';
+import { F as Fixture } from './types-C6Lf3vz2.js';
+export { a as FixtureEvent, M as MockDriverOptions } from './types-C6Lf3vz2.js';
+export { MockDriver, createMockDriver } from './mock/index.js';
+export { RecordingDriver, RecordingDriverOptions, createRecordingDriver } from './recorder/index.js';
+export { BUILTIN_FIXTURES, EMPTY_RESPONSE, ERROR_RESPONSE, LONG_REPLY, SIMPLE_REPLY, TOOL_CALL, getFixture, listFixtures } from './fixtures/index.js';
+import '@agentxjs/core/agent';
+
+/**
+ * Devtools SDK - VCR-style fixture management
+ *
+ * Automatically uses existing fixtures or records new ones on-the-fly.
+ *
+ * Usage:
+ * ```typescript
+ * import { createDevtools } from "@agentxjs/devtools";
+ *
+ * const devtools = createDevtools({
+ *   fixturesDir: "./fixtures",
+ *   apiKey: process.env.DEEPRACTICE_API_KEY,
+ * });
+ *
+ * // Has fixture → playback (MockDriver)
+ * // No fixture → call API, record, save, return MockDriver
+ * const driver = await devtools.driver("hello-test", {
+ *   message: "Hello!",
+ * });
+ *
+ * await driver.initialize();
+ * for await (const event of driver.receive({ content: "Hello" })) {
+ *   console.log(event);
+ * }
+ * ```
+ */
+
+/**
+ * Devtools configuration
+ */
+interface DevtoolsConfig {
+    /**
+     * Directory to store/load fixtures
+     */
+    fixturesDir: string;
+    /**
+     * API key for recording (required if recording)
+     */
+    apiKey?: string;
+    /**
+     * API base URL
+     */
+    baseUrl?: string;
+    /**
+     * Default model
+     */
+    model?: string;
+    /**
+     * Default system prompt
+     */
+    systemPrompt?: string;
+    /**
+     * Working directory for tool execution
+     */
+    cwd?: string;
+    /**
+     * Real driver factory for recording
+     * If not provided, will try to use @agentxjs/claude-driver
+     */
+    createDriver?: CreateDriver;
+}
+/**
+ * Options for getting a driver
+ */
+interface DriverOptions {
+    /**
+     * Message to send if recording is needed
+     */
+    message: string;
+    /**
+     * Override system prompt
+     */
+    systemPrompt?: string;
+    /**
+     * Override working directory
+     */
+    cwd?: string;
+    /**
+     * Force re-record even if fixture exists
+     */
+    forceRecord?: boolean;
+}
+/**
+ * Devtools SDK
+ */
+declare class Devtools {
+    private config;
+    private realCreateDriver;
+    constructor(config: DevtoolsConfig);
+    /**
+     * Get a driver for the given fixture name
+     *
+     * - If fixture exists → returns MockDriver with playback
+     * - If fixture doesn't exist → records, saves, returns MockDriver
+     */
+    driver(name: string, options: DriverOptions): Promise<Driver>;
+    /**
+     * Get a CreateDriver function that uses a pre-loaded fixture
+     *
+     * NOTE: This loads the fixture synchronously, so the fixture must exist.
+     * For async loading/recording, use driver() instead.
+     */
+    createDriverForFixture(fixturePath: string): CreateDriver;
+    /**
+     * Record a fixture
+     */
+    record(name: string, options: DriverOptions): Promise<Fixture>;
+    /**
+     * Load a fixture by name
+     */
+    load(name: string): Promise<Fixture>;
+    /**
+     * Check if a fixture exists
+     */
+    exists(name: string): boolean;
+    /**
+     * Delete a fixture
+     */
+    delete(name: string): Promise<void>;
+    private getFixturePath;
+    private loadFixture;
+    private saveFixture;
+    private getRealCreateDriver;
+}
+/**
+ * Create a Devtools instance
+ */
+declare function createDevtools(config: DevtoolsConfig): Devtools;
+/**
+ * Configuration for VCR-aware CreateDriver
+ */
+interface VcrCreateDriverConfig {
+    /**
+     * Directory to store/load fixtures
+     */
+    fixturesDir: string;
+    /**
+     * Get current fixture name. Return null to skip VCR (use real driver).
+     * Called when driver is created.
+     */
+    getFixtureName: () => string | null;
+    /**
+     * API key for recording
+     */
+    apiKey?: string;
+    /**
+     * API base URL
+     */
+    baseUrl?: string;
+    /**
+     * Default model
+     */
+    model?: string;
+    /**
+     * Real driver factory (optional, defaults to @agentxjs/claude-driver)
+     */
+    createRealDriver?: CreateDriver;
+    /**
+     * Called when playback mode is used
+     */
+    onPlayback?: (fixtureName: string) => void;
+    /**
+     * Called when recording mode is used
+     */
+    onRecording?: (fixtureName: string) => void;
+    /**
+     * Called when fixture is saved
+     */
+    onSaved?: (fixtureName: string, eventCount: number) => void;
+}
+/**
+ * Create a VCR-aware CreateDriver function
+ *
+ * VCR logic (hardcoded):
+ * - Fixture exists → Playback (MockDriver)
+ * - Fixture missing → Recording (RecordingDriver) → Auto-save on dispose
+ *
+ * @example
+ * ```typescript
+ * let currentFixture: string | null = null;
+ *
+ * const vcrCreateDriver = createVcrCreateDriver({
+ *   fixturesDir: "./fixtures",
+ *   getFixtureName: () => currentFixture,
+ *   apiKey: process.env.API_KEY,
+ * });
+ *
+ * // Before each test:
+ * currentFixture = "test-scenario-name";
+ *
+ * // Use with server/provider:
+ * const provider = await createNodeProvider({
+ *   createDriver: vcrCreateDriver,
+ * });
+ * ```
+ */
+declare function createVcrCreateDriver(config: VcrCreateDriverConfig): CreateDriver;
+
+export { Devtools, type DevtoolsConfig, type DriverOptions, Fixture, type VcrCreateDriverConfig, createDevtools, createVcrCreateDriver };