@witqq/agent-sdk 0.7.0 → 0.8.0

package/dist/errors-CmVvczxZ.d.ts

@@ -0,0 +1,28 @@
+/** Options for constructing an AgentSDKError */
+interface AgentSDKErrorOptions extends ErrorOptions {
+    /** Machine-readable error code */
+    code?: string;
+    /** Whether this error is retryable (default: false) */
+    retryable?: boolean;
+    /** HTTP status code hint (e.g. 401, 429, 500) */
+    httpStatus?: number;
+}
+/** Base error class for agent-sdk.
+ *
+ * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks
+ * (works across separately bundled entry points where `instanceof` may fail). */
+declare class AgentSDKError extends Error {
+    /** @internal Marker for cross-bundle identity checks */
+    readonly _agentSDKError: true;
+    /** Machine-readable error code. Prefer values from the ErrorCode enum. */
+    readonly code?: string;
+    /** Whether this error is safe to retry */
+    readonly retryable: boolean;
+    /** HTTP status code hint for error classification */
+    readonly httpStatus?: number;
+    constructor(message: string, options?: AgentSDKErrorOptions);
+    /** Check if an error is an AgentSDKError (works across bundled copies) */
+    static is(error: unknown): error is AgentSDKError;
+}
+
+export { AgentSDKError as A };

package/dist/{in-process-transport-C2oPTYs6.d.ts → in-process-transport-C1JnJGVR.d.ts}

@@ -1,7 +1,7 @@
-import { ChatSession, SendMessageOptions, ChatEvent, ChatMessage } from './chat/core.js';
-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.js';
-import { I as IBackendAdapter, B as BackendAdapterOptions } from './types-DLZzlJxt.js';
-import { I as IChatTransport } from './transport-D1OaUgRk.js';
+import { I as IChatBackend, B as BackendAdapterOptions, g as ChatSession, S as SendMessageOptions, c as ChatMessage, a as ChatEvent, d as IResumableBackend } from './types-ajANVzf7.js';
+import { F as FullAgentConfig, I as IAgentService, c as IAgent, d as Message, M as ModelInfo } from './agent-CW9XbmG_.js';
+import { C as CopilotBackendOptions, a as ClaudeBackendOptions, V as VercelAIBackendOptions } from './backends-BSrsBYFn.js';
+import { I as IChatTransport } from './transport-Ciap4PWK.js';
 
 /**
  * @witqq/agent-sdk/chat/backends/base
@@ -11,23 +11,28 @@ import { I as IChatTransport } from './transport-D1OaUgRk.js';
  */
 
 /**
- * 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,7 +46,9 @@ 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;
@@ -64,7 +71,7 @@ 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 {
+declare class CopilotChatAdapter extends BaseBackendAdapter implements IResumableBackend {
     private _backendSessionId;
     private readonly _copilotOptions?;
     constructor(options: CopilotChatAdapterOptions);
@@ -91,7 +98,7 @@ 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 {
+declare class ClaudeChatAdapter extends BaseBackendAdapter implements IResumableBackend {
     private _backendSessionId;
     private readonly _claudeOptions?;
     constructor(options: ClaudeChatAdapterOptions);
@@ -106,7 +113,7 @@ declare class ClaudeChatAdapter extends BaseBackendAdapter {
  * @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 +125,12 @@ 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;
 }
 
@@ -220,4 +225,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, VercelAIChatAdapter as V, WS_READY_STATE as W, type ClaudeChatAdapterOptions as a, CopilotChatAdapter as b, type CopilotChatAdapterOptions as c, type VercelAIChatAdapterOptions as d, type WebSocketLike as e, WsChatTransport as f, type WsTransportOptions as g };

package/dist/{in-process-transport-DG-w5G6k.d.cts → in-process-transport-C7DSqPyX.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 { I as IChatBackend, B as BackendAdapterOptions, g as ChatSession, S as SendMessageOptions, c as ChatMessage, a as ChatEvent, d as IResumableBackend } from './types-DRgd_9R7.cjs';
+import { F as FullAgentConfig, I as IAgentService, c as IAgent, d as Message, M as ModelInfo } from './agent-DxY68NZL.cjs';
+import { C as CopilotBackendOptions, a as ClaudeBackendOptions, V as VercelAIBackendOptions } from './backends-BSrsBYFn.cjs';
+import { I as IChatTransport } from './transport-Cdh3M0tS.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,7 +46,9 @@ 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;
@@ -64,7 +71,7 @@ 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 {
+declare class CopilotChatAdapter extends BaseBackendAdapter implements IResumableBackend {
     private _backendSessionId;
     private readonly _copilotOptions?;
     constructor(options: CopilotChatAdapterOptions);
@@ -91,7 +98,7 @@ 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 {
+declare class ClaudeChatAdapter extends BaseBackendAdapter implements IResumableBackend {
     private _backendSessionId;
     private readonly _claudeOptions?;
     constructor(options: ClaudeChatAdapterOptions);
@@ -106,7 +113,7 @@ declare class ClaudeChatAdapter extends BaseBackendAdapter {
  * @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 +125,12 @@ 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;
 }
 
@@ -220,4 +225,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, VercelAIChatAdapter as V, WS_READY_STATE as W, type ClaudeChatAdapterOptions as a, CopilotChatAdapter as b, type CopilotChatAdapterOptions as c, type VercelAIChatAdapterOptions as d, type WebSocketLike as e, WsChatTransport as f, type WsTransportOptions as g };