@agentxjs/core 1.9.7-dev → 1.9.9-dev

package/dist/agent/index.js

@@ -27,12 +27,12 @@ import {
   mapOutput,
   withLogging
 } from "../chunk-EKHT54KN.js";
+import "../chunk-7ZDX3O6I.js";
 import {
   isMessageEvent,
   isStateEvent,
   isTurnEvent
 } from "../chunk-K6WXQ2RW.js";
-import "../chunk-7ZDX3O6I.js";
 import "../chunk-E5FPOAPO.js";
 import "../chunk-7D4SUZUM.js";
 export {

package/dist/driver/index.d.ts

@@ -122,8 +122,29 @@ type DriverStreamEventType = DriverStreamEvent["type"];
  *
  * This is our capability boundary - we define what we support.
  * Specific implementations (Claude, OpenAI) must work within this.
+ *
+ * @typeParam TOptions - Driver-specific options type. Each driver implementation
+ * can define its own options interface and pass it as a type parameter.
+ *
+ * @example
+ * ```typescript
+ * // Define driver-specific options
+ * interface ClaudeDriverOptions {
+ *   claudeCodePath?: string;
+ *   maxTurns?: number;
+ * }
+ *
+ * // Use with type parameter
+ * const config: DriverConfig<ClaudeDriverOptions> = {
+ *   apiKey: "...",
+ *   agentId: "my-agent",
+ *   options: {
+ *     claudeCodePath: "/usr/local/bin/claude"
+ *   }
+ * };
+ * ```
  */
-interface DriverConfig {
+interface DriverConfig<TOptions = Record<string, unknown>> {
     /**
      * API key for authentication
      */
@@ -170,6 +191,27 @@ interface DriverConfig {
      * Save this ID to enable session resume later.
      */
     onSessionIdCaptured?: (sessionId: string) => void;
+    /**
+     * Driver-specific options
+     *
+     * Each driver implementation can define its own options type.
+     * This allows drivers to have custom configuration without
+     * polluting the base DriverConfig interface.
+     *
+     * @example
+     * ```typescript
+     * // ClaudeDriver options
+     * interface ClaudeDriverOptions {
+     *   claudeCodePath?: string;
+     * }
+     *
+     * const config: DriverConfig<ClaudeDriverOptions> = {
+     *   apiKey: "...",
+     *   options: { claudeCodePath: "/usr/bin/claude" }
+     * };
+     * ```
+     */
+    options?: TOptions;
 }
 /**
  * DriverState - Current state of the Driver
@@ -253,14 +295,16 @@ interface Driver {
  *
  * Each implementation package exports a function of this type.
  *
+ * @typeParam TOptions - Driver-specific options type
+ *
  * @example
  * ```typescript
  * // @agentxjs/claude-driver
- * export const createDriver: CreateDriver = (config) => {
- *   return new ClaudeDriverImpl(config);
+ * export const createClaudeDriver: CreateDriver<ClaudeDriverOptions> = (config) => {
+ *   return new ClaudeDriver(config);
  * };
  * ```
  */
-type CreateDriver = (config: DriverConfig) => Driver;
+type CreateDriver<TOptions = Record<string, unknown>> = (config: DriverConfig<TOptions>) => Driver;
 
 export type { CreateDriver, Driver, DriverConfig, DriverState, DriverStreamEvent, DriverStreamEventType, ErrorEvent, InputJsonDeltaEvent, InterruptedEvent, McpServerConfig, MessageStartEvent, MessageStopEvent, StopReason, StreamEvent, TextDeltaEvent, ToolResultEvent, ToolUseStartEvent, ToolUseStopEvent };

package/dist/index.js

@@ -27,15 +27,15 @@ import {
   mapOutput,
   withLogging
 } from "./chunk-EKHT54KN.js";
+import "./chunk-7ZDX3O6I.js";
 import {
   isMessageEvent,
   isStateEvent,
   isTurnEvent
 } from "./chunk-K6WXQ2RW.js";
-import "./chunk-7ZDX3O6I.js";
 import "./chunk-E5FPOAPO.js";
-import "./chunk-7D4SUZUM.js";
 import "./chunk-RL3JRNXM.js";
+import "./chunk-7D4SUZUM.js";
 export {
   AgentStateMachine,
   MealyMachine,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxjs/core",
-  "version": "1.9.7-dev",
+  "version": "1.9.9-dev",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/driver/types.ts

@@ -185,8 +185,29 @@ export type DriverStreamEventType = DriverStreamEvent["type"];
  *
  * This is our capability boundary - we define what we support.
  * Specific implementations (Claude, OpenAI) must work within this.
+ *
+ * @typeParam TOptions - Driver-specific options type. Each driver implementation
+ * can define its own options interface and pass it as a type parameter.
+ *
+ * @example
+ * ```typescript
+ * // Define driver-specific options
+ * interface ClaudeDriverOptions {
+ *   claudeCodePath?: string;
+ *   maxTurns?: number;
+ * }
+ *
+ * // Use with type parameter
+ * const config: DriverConfig<ClaudeDriverOptions> = {
+ *   apiKey: "...",
+ *   agentId: "my-agent",
+ *   options: {
+ *     claudeCodePath: "/usr/local/bin/claude"
+ *   }
+ * };
+ * ```
  */
-export interface DriverConfig {
+export interface DriverConfig<TOptions = Record<string, unknown>> {
   // === Provider Configuration ===
 
   /**
@@ -248,6 +269,30 @@ export interface DriverConfig {
    * Save this ID to enable session resume later.
    */
   onSessionIdCaptured?: (sessionId: string) => void;
+
+  // === Driver-Specific Options ===
+
+  /**
+   * Driver-specific options
+   *
+   * Each driver implementation can define its own options type.
+   * This allows drivers to have custom configuration without
+   * polluting the base DriverConfig interface.
+   *
+   * @example
+   * ```typescript
+   * // ClaudeDriver options
+   * interface ClaudeDriverOptions {
+   *   claudeCodePath?: string;
+   * }
+   *
+   * const config: DriverConfig<ClaudeDriverOptions> = {
+   *   apiKey: "...",
+   *   options: { claudeCodePath: "/usr/bin/claude" }
+   * };
+   * ```
+   */
+  options?: TOptions;
 }
 
 // ============================================================================
@@ -352,12 +397,16 @@ export interface Driver {
  *
  * Each implementation package exports a function of this type.
  *
+ * @typeParam TOptions - Driver-specific options type
+ *
  * @example
  * ```typescript
  * // @agentxjs/claude-driver
- * export const createDriver: CreateDriver = (config) => {
- *   return new ClaudeDriverImpl(config);
+ * export const createClaudeDriver: CreateDriver<ClaudeDriverOptions> = (config) => {
+ *   return new ClaudeDriver(config);
  * };
  * ```
  */
-export type CreateDriver = (config: DriverConfig) => Driver;
+export type CreateDriver<TOptions = Record<string, unknown>> = (
+  config: DriverConfig<TOptions>
+) => Driver;