@contractspec/lib.ai-agent 1.57.0 → 1.59.0

package/dist/agent/json-runner.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json-runner.test.d.ts.map

package/dist/agent/json-runner.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-runner.test.d.ts","sourceRoot":"","sources":["../../src/agent/json-runner.test.ts"],"names":[],"mappings":""}

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

@@ -1,141 +1,164 @@
-import { AgentSpec } from "../spec/spec.js";
-import { AgentCallOptions, AgentGenerateResult, ToolHandler } from "../types.js";
-import { ClaudeAgentSDKConfig, OpenCodeSDKConfig } from "../providers/types.js";
-import { LanguageModel } from "ai";
-import { ProviderConfig } from "@contractspec/lib.ai-providers/types";
-
-//#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;
-    modelInstance?: LanguageModel;
-    provider?: ProviderConfig;
-    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;
-  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;
+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;
-  modelInstance?: LanguageModel;
-  provider?: ProviderConfig;
-  temperature?: number;
-  maxTokens?: number;
+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"],"mappings":";;;;;;;;KAiDY,mBAAA;;UAMK,yBAAA;EACf,QAAA;IACE,KAAA;IACA,aAAA,GAAgB,aAAA;IAChB,QAAA,GAAW,cAAA;IACX,WAAA;IACA,SAAA;EAAA;EAEF,kBAAA,GAAqB,oBAAA;EACrB,cAAA,GAAiB,iBAAA;AAAA;;UAIF,kBAAA;EAIf;EAFA,OAAA,EAAS,mBAAA;EAE0B;EAAnC,MAAA,GAAS,yBAAA,CAA0B,mBAAA;EAE3B;EAAR,KAAA,GAAQ,GAAA,SAAY,WAAA;EAEpB;EAAA,eAAA,GAAkB,mBAAA;EAElB;EAAA,OAAA;AAAA;AAIF;AAAA,UAAiB,sBAAA,SAA+B,gBAAA;;EAE9C,OAAA,GAAU,mBAAA;AAAA;;UAIK,iBAAA;EACf,OAAA,EAAS,mBAAA;EACT,OAAA;EACA,SAAA;EACA,YAAA;EACA,SAAA,GAAY,KAAA;AAAA;;;;cAUD,YAAA;EAAA,iBACM,IAAA;EAAA,iBACA,MAAA;EAAA,iBACA,KAAA;EAAA,QACT,QAAA;EAAA,QACA,OAAA;EAAA,QACA,KAAA;cAEI,IAAA,EAAM,SAAA,EAAW,MAAA,EAAQ,kBAAA;;;;EAc/B,UAAA,CAAA,GAAc,OAAA;EAAA,QAyCN,wBAAA;EAAA,QA0BA,qBAAA;EA6BX;;;EAHG,GAAA,CACJ,OAAA,UACA,OAAA,GAAU,sBAAA,GACT,OAAA,CAAQ,mBAAA;EAAA,QA2BG,YAAA;EAAA,QAmBA,uBAAA;EAAA,QAmBN,qBAAA;EAAA,QA+BA,cAAA;EAAA,QAKM,iBAAA;EAAA,QAmBN,kBAAA;EA4GkC;;;EAhF1C,QAAA,CAAA,GAAY,iBAAA;EAtQJ;;;EA6QR,OAAA,CAAA,GAAW,SAAA;EAzQO;;;EAgRlB,UAAA,CAAA,GAAc,mBAAA;EAlQR;;;EAyQA,kBAAA,CAAmB,OAAA,EAAS,mBAAA,GAAsB,OAAA;EA5KlD;;;EA6MA,aAAA,CAAc,OAAA,EAAS,mBAAA,GAAsB,OAAA;EA1MhD;;;EA0NH,KAAA,CAAA;EAzJQ;;;EAmKR,OAAA,CAAQ,IAAA,UAAc,OAAA,EAAS,WAAA;EAhF/B;;;EAuFA,UAAA,CAAW,IAAA;AAAA;;;;iBAYG,kBAAA,CACd,IAAA,EAAM,SAAA,EACN,MAAA,EAAQ,kBAAA,GACP,YAAA;;;;iBAOa,gBAAA,CACd,IAAA,EAAM,SAAA,EACN,OAAA;EACE,KAAA,GAAQ,GAAA,SAAY,WAAA;EACpB,KAAA;EACA,aAAA,GAAgB,aAAA;EAChB,QAAA,GAAW,cAAA;EACX,WAAA;EACA,SAAA;AAAA,IAED,YAAA;;;;iBAiBa,yBAAA,CACd,IAAA,EAAM,SAAA,EACN,MAAA,GAAS,oBAAA;EACP,KAAA,GAAQ,GAAA,SAAY,WAAA;AAAA,IAErB,YAAA;;;;iBAYa,sBAAA,CACd,IAAA,EAAM,SAAA,EACN,MAAA,GAAS,iBAAA;EACP,KAAA,GAAQ,GAAA,SAAY,WAAA;AAAA,IAErB,YAAA;;;;iBAYmB,oBAAA,CAAA,GAAwB,OAAA,CAAQ,mBAAA"}
+{"version":3,"file":"unified-agent.d.ts","sourceRoot":"","sources":["../../src/agent/unified-agent.ts"],"names":[],"mappings":"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"}