@contractspec/lib.ai-agent 1.56.1 → 1.58.0

package/dist/agent/unified-agent.d.ts

@@ -1,131 +1,164 @@
-import { AgentSpec } from "../spec/spec.js";
-import { AgentCallOptions, AgentGenerateResult, ToolHandler } from "../types.js";
-import { ClaudeAgentSDKConfig, OpenCodeSDKConfig } from "../providers/types.js";
-
-//#region src/agent/unified-agent.d.ts
-
+/**
+ * Unified Agent Wrapper
+ *
+ * Provides a single API surface for running agents regardless of backend:
+ * - AI SDK v6 (existing ContractSpec implementation)
+ * - Claude Agent SDK (@anthropic-ai/claude-agent-sdk)
+ * - OpenCode SDK (@opencode-ai/sdk)
+ *
+ * @example
+ * ```typescript
+ * import { UnifiedAgent, createUnifiedAgent } from '@contractspec/lib.ai-agent';
+ *
+ * // Create agent with AI SDK backend (default)
+ * const agent = createUnifiedAgent(mySpec, {
+ *   backend: 'ai-sdk',
+ * });
+ *
+ * // Create agent with Claude Agent SDK backend
+ * const claudeAgent = createUnifiedAgent(mySpec, {
+ *   backend: 'claude-agent-sdk',
+ *   config: { extendedThinking: true },
+ * });
+ *
+ * // All agents use the same API
+ * const response = await agent.run('Hello');
+ * ```
+ */
+import type { LanguageModel } from 'ai';
+import type { ProviderConfig } from '@contractspec/lib.ai-providers/types';
+import type { AgentSpec } from '../spec/spec';
+import type { AgentCallOptions, AgentGenerateResult, ToolHandler } from '../types';
+import type { ClaudeAgentSDKConfig, OpenCodeSDKConfig } from '../providers/types';
 /** Supported backend types */
-type UnifiedAgentBackend = 'ai-sdk' | 'claude-agent-sdk' | 'opencode-sdk';
+export type UnifiedAgentBackend = 'ai-sdk' | 'claude-agent-sdk' | 'opencode-sdk';
 /** Backend-specific configuration */
-interface UnifiedAgentBackendConfig {
-  'ai-sdk'?: {
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
-  };
-  'claude-agent-sdk'?: ClaudeAgentSDKConfig;
-  'opencode-sdk'?: OpenCodeSDKConfig;
+export interface UnifiedAgentBackendConfig {
+    'ai-sdk'?: {
+        model?: string;
+        modelInstance?: LanguageModel;
+        provider?: ProviderConfig;
+        temperature?: number;
+        maxTokens?: number;
+    };
+    'claude-agent-sdk'?: ClaudeAgentSDKConfig;
+    'opencode-sdk'?: OpenCodeSDKConfig;
 }
 /** Unified agent configuration */
-interface UnifiedAgentConfig {
-  /** Backend to use */
-  backend: UnifiedAgentBackend;
-  /** Backend-specific configuration */
-  config?: UnifiedAgentBackendConfig[UnifiedAgentBackend];
-  /** Tool handlers for the agent */
-  tools?: Map<string, ToolHandler>;
-  /** Fallback backend if primary fails */
-  fallbackBackend?: UnifiedAgentBackend;
-  /** Enable verbose logging */
-  verbose?: boolean;
+export interface UnifiedAgentConfig {
+    /** Backend to use */
+    backend: UnifiedAgentBackend;
+    /** Backend-specific configuration */
+    config?: UnifiedAgentBackendConfig[UnifiedAgentBackend];
+    /** Tool handlers for the agent */
+    tools?: Map<string, ToolHandler>;
+    /** Fallback backend if primary fails */
+    fallbackBackend?: UnifiedAgentBackend;
+    /** Enable verbose logging */
+    verbose?: boolean;
 }
 /** Unified agent run options */
-interface UnifiedAgentRunOptions extends AgentCallOptions {
-  /** Override backend for this call */
-  backend?: UnifiedAgentBackend;
+export interface UnifiedAgentRunOptions extends AgentCallOptions {
+    /** Override backend for this call */
+    backend?: UnifiedAgentBackend;
 }
 /** Unified agent state */
-interface UnifiedAgentState {
-  backend: UnifiedAgentBackend;
-  isReady: boolean;
-  sessionId?: string;
-  messageCount: number;
-  lastError?: Error;
+export interface UnifiedAgentState {
+    backend: UnifiedAgentBackend;
+    isReady: boolean;
+    sessionId?: string;
+    messageCount: number;
+    lastError?: Error;
 }
 /**
  * Unified agent that works across multiple backends.
  */
-declare class UnifiedAgent {
-  private readonly spec;
-  private readonly config;
-  private readonly tools;
-  private provider?;
-  private context?;
-  private state;
-  constructor(spec: AgentSpec, config: UnifiedAgentConfig);
-  /**
-   * Initialize the agent with its backend.
-   */
-  initialize(): Promise<void>;
-  private initializeClaudeAgentSDK;
-  private initializeOpenCodeSDK;
-  /**
-   * Run the agent with a message.
-   */
-  run(message: string, options?: UnifiedAgentRunOptions): Promise<AgentGenerateResult>;
-  private runWithAISDK;
-  private runWithExternalProvider;
-  private convertExternalResult;
-  /**
-   * Get agent state.
-   */
-  getState(): UnifiedAgentState;
-  /**
-   * Get the agent spec.
-   */
-  getSpec(): AgentSpec;
-  /**
-   * Get the current backend.
-   */
-  getBackend(): UnifiedAgentBackend;
-  /**
-   * Check if a specific backend is available.
-   */
-  isBackendAvailable(backend: UnifiedAgentBackend): Promise<boolean>;
-  /**
-   * Switch to a different backend.
-   */
-  switchBackend(backend: UnifiedAgentBackend): Promise<void>;
-  /**
-   * Reset the agent state.
-   */
-  reset(): void;
-  /**
-   * Add a tool handler.
-   */
-  addTool(name: string, handler: ToolHandler): void;
-  /**
-   * Remove a tool handler.
-   */
-  removeTool(name: string): boolean;
+export declare class UnifiedAgent {
+    private readonly spec;
+    private readonly config;
+    private readonly tools;
+    private provider?;
+    private context?;
+    private state;
+    constructor(spec: AgentSpec, config: UnifiedAgentConfig);
+    /**
+     * Initialize the agent with its backend.
+     */
+    initialize(): Promise<void>;
+    private initializeClaudeAgentSDK;
+    private initializeOpenCodeSDK;
+    /**
+     * Run the agent with a message.
+     */
+    run(message: string, options?: UnifiedAgentRunOptions): Promise<AgentGenerateResult>;
+    private runWithAISDK;
+    private runWithExternalProvider;
+    private convertExternalResult;
+    private getAISDKConfig;
+    private resolveAISDKModel;
+    private applyModelSettings;
+    /**
+     * Get agent state.
+     */
+    getState(): UnifiedAgentState;
+    /**
+     * Get the agent spec.
+     */
+    getSpec(): AgentSpec;
+    /**
+     * Get the current backend.
+     */
+    getBackend(): UnifiedAgentBackend;
+    /**
+     * Check if a specific backend is available.
+     */
+    isBackendAvailable(backend: UnifiedAgentBackend): Promise<boolean>;
+    /**
+     * Switch to a different backend.
+     */
+    switchBackend(backend: UnifiedAgentBackend): Promise<void>;
+    /**
+     * Reset the agent state.
+     */
+    reset(): void;
+    /**
+     * Add a tool handler.
+     */
+    addTool(name: string, handler: ToolHandler): void;
+    /**
+     * Remove a tool handler.
+     */
+    removeTool(name: string): boolean;
 }
 /**
  * Create a unified agent.
  */
-declare function createUnifiedAgent(spec: AgentSpec, config: UnifiedAgentConfig): UnifiedAgent;
+export declare function createUnifiedAgent(spec: AgentSpec, config: UnifiedAgentConfig): UnifiedAgent;
 /**
  * Create a unified agent with AI SDK backend (default).
  */
-declare function createAISDKAgent(spec: AgentSpec, options?: {
-  tools?: Map<string, ToolHandler>;
-  model?: string;
+export declare function createAISDKAgent(spec: AgentSpec, options?: {
+    tools?: Map<string, ToolHandler>;
+    model?: string;
+    modelInstance?: LanguageModel;
+    provider?: ProviderConfig;
+    temperature?: number;
+    maxTokens?: number;
 }): UnifiedAgent;
 /**
  * Create a unified agent with Claude Agent SDK backend.
  */
-declare function createClaudeAgentSDKAgent(spec: AgentSpec, config?: ClaudeAgentSDKConfig & {
-  tools?: Map<string, ToolHandler>;
+export declare function createClaudeAgentSDKAgent(spec: AgentSpec, config?: ClaudeAgentSDKConfig & {
+    tools?: Map<string, ToolHandler>;
 }): UnifiedAgent;
 /**
  * Create a unified agent with OpenCode SDK backend.
  */
-declare function createOpenCodeSDKAgent(spec: AgentSpec, config?: OpenCodeSDKConfig & {
-  tools?: Map<string, ToolHandler>;
+export declare function createOpenCodeSDKAgent(spec: AgentSpec, config?: OpenCodeSDKConfig & {
+    tools?: Map<string, ToolHandler>;
 }): UnifiedAgent;
 /**
  * Get available backends.
  */
-declare function getAvailableBackends(): Promise<UnifiedAgentBackend[]>;
-//#endregion
-export { UnifiedAgent, UnifiedAgentBackend, UnifiedAgentBackendConfig, UnifiedAgentConfig, UnifiedAgentRunOptions, UnifiedAgentState, createAISDKAgent, createClaudeAgentSDKAgent, createOpenCodeSDKAgent, createUnifiedAgent, getAvailableBackends };
+export declare function getAvailableBackends(): Promise<UnifiedAgentBackend[]>;
 //# sourceMappingURL=unified-agent.d.ts.map

package/dist/agent/unified-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unified-agent.d.ts","names":[],"sources":["../../src/agent/unified-agent.ts"],"sourcesContent":[],"mappings":";;;;;;;AAoZiC,KAtWrB,mBAAA,GAsWqB,QAAA,GAAA,kBAAA,GAAA,cAAA;;AAmBjB,UAnXC,yBAAA,CAmXiB;EAC1B,QAAA,CAAA,EAAA;IACE,KAAA,CAAA,EAAA,MAAA;IACP,WAAA,CAAA,EAAA,MAAA;IAAY,SAAA,CAAA,EAAA,MAAA;EAOC,CAAA;EACR,kBAAA,CAAA,EAxXe,oBAwXf;EAEgB,cAAA,CAAA,EAzXL,iBAyXK;;;AAGT,UAxXE,kBAAA,CAwXF;EAWC;EACR,OAAA,EAlYG,mBAkYH;EACG;EACa,MAAA,CAAA,EAlYb,yBAkYa,CAlYa,mBAkYb,CAAA;EAAZ;EAET,KAAA,CAAA,EAlYO,GAkYP,CAAA,MAAA,EAlYmB,WAkYnB,CAAA;EAAY;EAYC,eAAA,CAAA,EA5YI,mBA4YkB;EAC9B;EACG,OAAA,CAAA,EAAA,OAAA;;;AAGR,UA3Yc,sBAAA,SAA+B,gBA2Y7C,CAAA;EAAY;EAYO,OAAA,CAAA,EArZV,mBAqZ8B;;;UAjZzB,iBAAA;WACN;;;;cAIG;;;;;cAUD,YAAA;;;;;;;oBAQO,mBAAmB;;;;gBAcjB;;;;;;iCA+FR,yBACT,QAAQ;;;;;;;cA4GC;;;;aAOD;;;;gBAOG;;;;8BAOoB,sBAAsB;;;;yBAiC3B,sBAAsB;;;;;;;;iCA0BpB;;;;;;;;;iBAmBjB,kBAAA,OACR,mBACE,qBACP;;;;iBAOa,gBAAA,OACR;UAEI,YAAY;;IAGrB;;;;iBAWa,yBAAA,OACR,oBACG;UACC,YAAY;IAErB;;;;iBAYa,sBAAA,OACR,oBACG;UACC,YAAY;IAErB;;;;iBAYmB,oBAAA,CAAA,GAAwB,QAAQ"}
+{"version":3,"file":"unified-agent.d.ts","sourceRoot":"","sources":["../../src/agent/unified-agent.ts"],"names":[],"mappings":"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"}