@witqq/agent-sdk 0.7.0 → 0.9.0

package/dist/{in-process-transport-DG-w5G6k.d.cts → in-process-transport-Ct9YcX8I.d.cts}

@@ -1,7 +1,7 @@
-import { ChatSession, SendMessageOptions, ChatEvent, ChatMessage } from './chat/core.cjs';
-import { I as IAgentService, b as IAgent, c as AgentConfig, M as Message, d as ModelInfo, C as CopilotBackendOptions, a as ClaudeBackendOptions, V as VercelAIBackendOptions } from './types-CqvUAYxt.cjs';
-import { I as IBackendAdapter, B as BackendAdapterOptions } from './types-tE0CXwBl.cjs';
-import { I as IChatTransport } from './transport-DX1Nhm4N.cjs';
+import { F as FullAgentConfig, I as IAgentService, c as IAgent, d as Message, M as ModelInfo } from './agent-C6H2CgJA.cjs';
+import { C as CopilotBackendOptions, a as ClaudeBackendOptions, V as VercelAIBackendOptions, M as MockLLMBackendOptions } from './backends-Cno0gZjy.cjs';
+import { I as IChatBackend, B as BackendAdapterOptions, g as ChatSession, S as SendMessageOptions, c as ChatMessage, a as ChatEvent, d as IResumableBackend } from './types-DkSXALKg.cjs';
+import { I as IChatTransport } from './transport-DLWCN18G.cjs';
 
 /**
  * @witqq/agent-sdk/chat/backends/base
@@ -11,23 +11,28 @@ import { I as IChatTransport } from './transport-DX1Nhm4N.cjs';
  */
 
 /**
- * Abstract base for backend adapters.
- * Subclasses implement createService() and override resume behavior.
+ * Abstract base for backend adapters implementing IChatBackend (core only).
+ * Subclasses implement createService() for backend-specific service creation.
+ * Resume support is NOT required — subclasses can implement IResumableBackend separately.
  */
-declare abstract class BaseBackendAdapter implements IBackendAdapter {
+declare abstract class BaseBackendAdapter implements IChatBackend {
     readonly name: string;
-    protected _agentService: IAgentService;
-    protected _agent: IAgent | null;
-    protected _disposed: boolean;
-    protected readonly _agentConfig: AgentConfig;
-    private readonly _ownsService;
+    private _agentService;
+    private _agentServiceFactory;
+    private _disposed;
+    protected readonly _agentConfig: FullAgentConfig;
+    private _ownsService;
+    private _currentAgent;
     constructor(name: string, options: BackendAdapterOptions);
     /** Subclasses create their specific IAgentService */
     protected abstract createService(): IAgentService;
     get agentService(): IAgentService;
-    abstract get backendSessionId(): string | null;
-    abstract canResume(): boolean;
-    abstract resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    get currentModel(): string | undefined;
+    /**
+     * @deprecated No-op. Tools are passed per-call via SendMessageOptions.tools.
+     * Kept for backward compatibility with code that calls setTools() directly.
+     */
+    setTools(): void;
     sendMessage(session: ChatSession, message: string, options?: SendMessageOptions): Promise<ChatMessage>;
     streamMessage(session: ChatSession, message: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
     /**
@@ -41,13 +46,37 @@ declare abstract class BaseBackendAdapter implements IBackendAdapter {
         errors: string[];
     }>;
     dispose(): Promise<void>;
-    /** Get or create an agent, applying model override from options */
+    /** Get or create an agent. Model is passed per-call via RunOptions.
+     *  Tools are passed per-call via SendMessageOptions — not baked into config.
+     *  For persistent sessions, reuses agent when model matches. */
     protected getOrCreateAgent(options?: SendMessageOptions): IAgent;
     /** Subclasses capture backend session ID from agent after streaming */
     protected abstract captureSessionId(agent: IAgent): void;
     protected assertNotDisposed(): void;
 }
 
+/**
+ * @witqq/agent-sdk/chat/backends/resumable
+ *
+ * Abstract base for CLI-backed adapters with session resume support.
+ * Shared by CopilotChatAdapter and ClaudeChatAdapter — the only
+ * difference between them is createService() and constructor options.
+ */
+
+/**
+ * Abstract base for backend adapters that support session resume.
+ * Handles backendSessionId tracking, canResume(), resume(), captureSessionId().
+ * Subclasses only define constructor (with backend-specific options) and createService().
+ */
+declare abstract class ResumableChatAdapter extends BaseBackendAdapter implements IResumableBackend {
+    private _backendSessionId;
+    constructor(name: string, options: BackendAdapterOptions);
+    get backendSessionId(): string | null;
+    canResume(): boolean;
+    resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    protected captureSessionId(agent: IAgent): void;
+}
+
 /**
  * @witqq/agent-sdk/chat/backends/copilot
  *
@@ -64,15 +93,10 @@ interface CopilotChatAdapterOptions extends BackendAdapterOptions {
  * Backend adapter for GitHub Copilot CLI.
  * Uses persistent session mode for session resume via CLI session ID.
  */
-declare class CopilotChatAdapter extends BaseBackendAdapter {
-    private _backendSessionId;
+declare class CopilotChatAdapter extends ResumableChatAdapter {
     private readonly _copilotOptions?;
     constructor(options: CopilotChatAdapterOptions);
     protected createService(): IAgentService;
-    get backendSessionId(): string | null;
-    canResume(): boolean;
-    resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
-    protected captureSessionId(agent: IAgent): void;
 }
 
 /**
@@ -91,22 +115,17 @@ interface ClaudeChatAdapterOptions extends BackendAdapterOptions {
  * Backend adapter for Claude CLI.
  * Uses persistent session mode for session resume via Claude's session_id.
  */
-declare class ClaudeChatAdapter extends BaseBackendAdapter {
-    private _backendSessionId;
+declare class ClaudeChatAdapter extends ResumableChatAdapter {
     private readonly _claudeOptions?;
     constructor(options: ClaudeChatAdapterOptions);
     protected createService(): IAgentService;
-    get backendSessionId(): string | null;
-    canResume(): boolean;
-    resume(session: ChatSession, backendSessionId: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
-    protected captureSessionId(agent: IAgent): void;
 }
 
 /**
  * @witqq/agent-sdk/chat/backends/vercel-ai
  *
  * VercelAIChatAdapter wraps VercelAIAgentService for chat use.
- * Stateless adapter — canResume() always returns false.
+ * Stateless adapter — implements IChatBackend only (no resume support).
  * Each streamMessage/sendMessage creates a fresh agent (per-call session mode).
  */
 
@@ -118,14 +137,34 @@ interface VercelAIChatAdapterOptions extends BackendAdapterOptions {
 /**
  * Backend adapter for Vercel AI SDK (API-based).
  * Stateless — each call creates a fresh agent. Does not support resume.
+ * Implements IChatBackend only (no IResumableBackend).
  */
 declare class VercelAIChatAdapter extends BaseBackendAdapter {
     private readonly _vercelOptions?;
     constructor(options: VercelAIChatAdapterOptions);
     protected createService(): IAgentService;
-    get backendSessionId(): string | null;
-    canResume(): boolean;
-    resume(_session: ChatSession, _backendSessionId: string, _options?: SendMessageOptions): AsyncIterable<ChatEvent>;
+    protected captureSessionId(_agent: IAgent): void;
+}
+
+/**
+ * @witqq/agent-sdk/chat/backends/mock-llm
+ *
+ * MockLLMChatAdapter wraps MockLLMService for chat use.
+ * No auth, no credentials — fully deterministic testing backend.
+ */
+
+/** Options for creating a MockLLMChatAdapter */
+interface MockLLMChatAdapterOptions extends BackendAdapterOptions {
+    /** MockLLM backend options (mode, latency, streaming, etc.) */
+    mockOptions?: MockLLMBackendOptions;
+}
+/**
+ * Backend adapter for Mock LLM.
+ * Zero-auth, deterministic, fully configurable for E2E testing.
+ */
+declare class MockLLMChatAdapter extends BaseBackendAdapter {
+    constructor(options: MockLLMChatAdapterOptions);
+    protected createService(): IAgentService;
     protected captureSessionId(_agent: IAgent): void;
 }
 
@@ -220,4 +259,4 @@ declare class InProcessChatTransport implements IChatTransport {
     [Symbol.asyncIterator](): AsyncIterator<ChatEvent>;
 }
 
-export { BaseBackendAdapter as B, ClaudeChatAdapter as C, InProcessChatTransport as I, VercelAIChatAdapter as V, WsChatTransport as W, CopilotChatAdapter as a, type ClaudeChatAdapterOptions as b, type CopilotChatAdapterOptions as c, type VercelAIChatAdapterOptions as d, WS_READY_STATE as e, type WebSocketLike as f, type WsTransportOptions as g };
+export { BaseBackendAdapter as B, ClaudeChatAdapter as C, InProcessChatTransport as I, MockLLMChatAdapter as M, ResumableChatAdapter as R, VercelAIChatAdapter as V, WS_READY_STATE as W, type ClaudeChatAdapterOptions as a, CopilotChatAdapter as b, type CopilotChatAdapterOptions as c, type MockLLMChatAdapterOptions as d, type VercelAIChatAdapterOptions as e, type WebSocketLike as f, WsChatTransport as g, type WsTransportOptions as h };