@witqq/agent-sdk 0.7.0 → 0.8.0

package/dist/chat/runtime.d.cts

@@ -1,11 +1,13 @@
-import { ChatMiddleware, ChatIdLike, ChatMessage, RuntimeStatus, ChatSession, ChatId, SendMessageOptions, ChatEvent } from './core.cjs';
-import { I as IBackendAdapter } from '../types-tE0CXwBl.cjs';
+import { I as IChatBackend, e as ChatMiddleware, f as ChatIdLike, c as ChatMessage, R as RuntimeStatus, g as ChatSession, b as ChatId, S as SendMessageOptions, a as ChatEvent, h as RuntimeSendOptions } from '../types-DRgd_9R7.cjs';
+import { T as ToolDefinition, M as ModelInfo } from '../agent-DxY68NZL.cjs';
 import { IChatSessionStore, CreateSessionOptions, SessionListOptions } from './sessions.cjs';
 import { ContextWindowConfig, ContextStats } from './context.cjs';
-import { d as ModelInfo, T as ToolDefinition } from '../types-CqvUAYxt.cjs';
-import './storage.cjs';
-import '../errors-BDLbNu9w.cjs';
+import { A as AuthToken } from '../types-4vbcmPTp.cjs';
+import { P as ProviderConfig } from '../provider-types-PTSlRPNB.cjs';
+import '../errors-C-so0M4t.cjs';
 import 'zod';
+import './storage.cjs';
+import '../errors-CmVvczxZ.cjs';
 
 /**
  * @witqq/agent-sdk/chat/runtime
@@ -24,7 +26,7 @@ import 'zod';
  */
 
 /** Factory function that creates a backend adapter on demand */
-type BackendAdapterFactory = () => IBackendAdapter | Promise<IBackendAdapter>;
+type BackendAdapterFactory = (credentials: AuthToken) => IChatBackend | Promise<IChatBackend>;
 /** Configuration for creating a chat runtime via createChatRuntime() */
 interface ChatRuntimeOptions {
     /** Map of backend name → adapter factory (lazy creation on first use) */
@@ -37,10 +39,8 @@ interface ChatRuntimeOptions {
     context?: ContextWindowConfig;
     /** Middleware pipeline (optional, applied in order) */
     middleware?: ChatMiddleware[];
-    /** Default model override (optional) */
-    defaultModel?: string;
     /** Retry configuration for pre-stream connection errors */
-    retryConfig?: RetryConfig;
+    retryConfig?: StreamRetryConfig;
     /**
      * Stream inactivity timeout in milliseconds (optional).
      * When set, aborts the stream if no events arrive within this window.
@@ -52,46 +52,110 @@ interface ChatRuntimeOptions {
      * Use for archiving, logging, or analytics.
      */
     onContextTrimmed?: (sessionId: ChatIdLike, removedMessages: ChatMessage[]) => void;
+    /**
+     * Initial tools to register on the runtime.
+     * Equivalent to calling `registerTool()` for each tool after creation.
+     */
+    tools?: ToolDefinition[];
 }
-/** Retry configuration for pre-stream failures */
-interface RetryConfig {
+/** Retry configuration for pre-stream failures (renamed to avoid clash with agent-level RetryConfig) */
+interface StreamRetryConfig {
     /** Maximum number of attempts (default: 1 = no retry) */
     maxAttempts: number;
     /** Delay between retries in milliseconds */
     delayMs: number;
 }
-/** The unified chat runtime facade */
-interface IChatRuntime<TMetadata extends Record<string, unknown> = Record<string, unknown>> {
-    /** Current runtime status */
+/** @deprecated Use StreamRetryConfig */
+type RetryConfig = StreamRetryConfig;
+/** Information about a registered backend */
+interface BackendInfo {
+    /** Backend name (key in backends map) */
+    name: string;
+}
+/**
+ * Provider CRUD operations — separated per Interface Segregation Principle.
+ * Implemented by IChatClient (which needs provider management for UI).
+ * Not required on IChatRuntime (providers are a handler-layer concern).
+ */
+interface IProviderClient {
+    listProviders(): Promise<ProviderConfig[]>;
+    createProvider(config: Omit<ProviderConfig, "id" | "createdAt">): Promise<ProviderConfig>;
+    updateProvider(id: string, changes: Partial<Omit<ProviderConfig, "id" | "createdAt">>): Promise<void>;
+    deleteProvider(id: string): Promise<void>;
+}
+/** Callback for provider selection changes */
+type SelectionChangeCallback = (providerId: string | null) => void;
+/**
+ * Client-side interface for interacting with a remote chat server.
+ * Fully self-contained — no shared base with IChatRuntime.
+ * Extends IProviderClient for provider CRUD (ISP).
+ * Used by React components and remote clients.
+ *
+ * @typeParam TMetadata - Type-level convenience for message metadata.
+ *   NOT enforced at the storage boundary — session stores always use `unknown`.
+ *   Consumers are responsible for metadata shape consistency.
+ */
+interface IChatClient<TMetadata extends Record<string, unknown> = Record<string, unknown>> extends IProviderClient {
     readonly status: RuntimeStatus;
-    /** Dispose the runtime and all owned resources */
     dispose(): Promise<void>;
     createSession(options: CreateSessionOptions<TMetadata>): Promise<ChatSession<TMetadata>>;
     getSession(id: ChatIdLike): Promise<ChatSession<TMetadata> | null>;
     listSessions(options?: SessionListOptions): Promise<ChatSession<TMetadata>[]>;
     deleteSession(id: ChatIdLike): Promise<void>;
-    archiveSession(id: ChatIdLike): Promise<void>;
     switchSession(id: ChatIdLike): Promise<ChatSession<TMetadata>>;
-    /** Currently active session ID (null if none) */
     readonly activeSessionId: ChatId | null;
+    /**
+     * Send a message. Options are optional — the server handler resolves
+     * model and backend from provider selection state.
+     * Compare with IChatRuntime.send() where RuntimeSendOptions is required.
+     */
     send(sessionId: ChatIdLike, message: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
     abort(): void;
-    switchBackend(name: string): Promise<void>;
-    switchModel(model: string): void;
+    selectProvider(providerId: string): void;
+    readonly selectedProviderId: string | null;
+    onSelectionChange(callback: SelectionChangeCallback): () => void;
+    onSessionChange(callback: () => void): () => void;
     listModels(): Promise<ModelInfo[]>;
-    /** Current backend name */
-    readonly currentBackend: string;
-    /** Current model (from config or default) */
-    readonly currentModel: string | undefined;
+    listBackends(): Promise<BackendInfo[]>;
+    getContextStats(sessionId: ChatIdLike): Promise<ContextStats | null>;
+}
+/**
+ * Server-side chat runtime. Fully self-contained — no shared base with IChatClient.
+ * Manages backend adapters, tools, middleware, and context trimming.
+ * Does NOT include client-facing provider CRUD or selection — those are
+ * handled by the server handler layer.
+ *
+ * @typeParam TMetadata - Type-level convenience for message metadata.
+ *   NOT enforced at the storage boundary — session stores always use `unknown`.
+ *   Casts in `ChatRuntime.createSession()`/`getSession()` are intentionally unsafe
+ *   to provide typed access. Consumers are responsible for metadata shape consistency.
+ */
+interface IChatRuntime<TMetadata extends Record<string, unknown> = Record<string, unknown>> {
+    readonly status: RuntimeStatus;
+    dispose(): Promise<void>;
+    createSession(options: CreateSessionOptions<TMetadata>): Promise<ChatSession<TMetadata>>;
+    getSession(id: ChatIdLike): Promise<ChatSession<TMetadata> | null>;
+    listSessions(options?: SessionListOptions): Promise<ChatSession<TMetadata>[]>;
+    deleteSession(id: ChatIdLike): Promise<void>;
+    /**
+     * Send a message. RuntimeSendOptions is required on the server — the caller
+     * (usually a handler) must supply backend, model, and credentials.
+     * Compare with IChatClient.send() where options are optional.
+     */
+    send(sessionId: ChatIdLike, message: string, options: RuntimeSendOptions): AsyncIterable<ChatEvent>;
+    abort(): void;
+    onSessionChange(callback: () => void): () => void;
+    listModels(options?: {
+        backend?: string;
+        credentials?: AuthToken;
+    }): Promise<ModelInfo[]>;
+    listBackends(): Promise<BackendInfo[]>;
     registerTool(tool: ToolDefinition): void;
     removeTool(name: string): void;
     readonly registeredTools: ReadonlyMap<string, ToolDefinition>;
     use(middleware: ChatMiddleware): void;
     removeMiddleware(middleware: ChatMiddleware): void;
-    /** Get context usage stats from the last send() for a session. Returns null if no trimming has occurred. */
-    getContextStats(sessionId: ChatIdLike): ContextStats | null;
-    /** Subscribe to session mutations (create, delete, archive, message send complete). Returns unsubscribe function. */
-    onSessionChange(callback: () => void): () => void;
+    getContextStats(sessionId: ChatIdLike): Promise<ContextStats | null>;
 }
 /**
  * Create a fully-wired chat runtime from configuration.
@@ -115,4 +179,4 @@ interface IChatRuntime<TMetadata extends Record<string, unknown> = Record<string
  */
 declare function createChatRuntime<TMetadata extends Record<string, unknown> = Record<string, unknown>>(options: ChatRuntimeOptions): IChatRuntime<TMetadata>;
 
-export { type BackendAdapterFactory, type ChatRuntimeOptions, type IChatRuntime, type RetryConfig, createChatRuntime };
+export { type BackendAdapterFactory, type BackendInfo, type ChatRuntimeOptions, type IChatClient, type IChatRuntime, type IProviderClient, type RetryConfig, type SelectionChangeCallback, type StreamRetryConfig, createChatRuntime };

package/dist/chat/runtime.d.ts

@@ -1,11 +1,13 @@
-import { ChatMiddleware, ChatIdLike, ChatMessage, RuntimeStatus, ChatSession, ChatId, SendMessageOptions, ChatEvent } from './core.js';
-import { I as IBackendAdapter } from '../types-DLZzlJxt.js';
+import { I as IChatBackend, e as ChatMiddleware, f as ChatIdLike, c as ChatMessage, R as RuntimeStatus, g as ChatSession, b as ChatId, S as SendMessageOptions, a as ChatEvent, h as RuntimeSendOptions } from '../types-ajANVzf7.js';
+import { T as ToolDefinition, M as ModelInfo } from '../agent-CW9XbmG_.js';
 import { IChatSessionStore, CreateSessionOptions, SessionListOptions } from './sessions.js';
 import { ContextWindowConfig, ContextStats } from './context.js';
-import { d as ModelInfo, T as ToolDefinition } from '../types-CqvUAYxt.js';
-import './storage.js';
-import '../errors-BDLbNu9w.js';
+import { A as AuthToken } from '../types-BxggH0Yh.js';
+import { P as ProviderConfig } from '../provider-types-PTSlRPNB.js';
+import '../errors-C-so0M4t.js';
 import 'zod';
+import './storage.js';
+import '../errors-CmVvczxZ.js';
 
 /**
  * @witqq/agent-sdk/chat/runtime
@@ -24,7 +26,7 @@ import 'zod';
  */
 
 /** Factory function that creates a backend adapter on demand */
-type BackendAdapterFactory = () => IBackendAdapter | Promise<IBackendAdapter>;
+type BackendAdapterFactory = (credentials: AuthToken) => IChatBackend | Promise<IChatBackend>;
 /** Configuration for creating a chat runtime via createChatRuntime() */
 interface ChatRuntimeOptions {
     /** Map of backend name → adapter factory (lazy creation on first use) */
@@ -37,10 +39,8 @@ interface ChatRuntimeOptions {
     context?: ContextWindowConfig;
     /** Middleware pipeline (optional, applied in order) */
     middleware?: ChatMiddleware[];
-    /** Default model override (optional) */
-    defaultModel?: string;
     /** Retry configuration for pre-stream connection errors */
-    retryConfig?: RetryConfig;
+    retryConfig?: StreamRetryConfig;
     /**
      * Stream inactivity timeout in milliseconds (optional).
      * When set, aborts the stream if no events arrive within this window.
@@ -52,46 +52,110 @@ interface ChatRuntimeOptions {
      * Use for archiving, logging, or analytics.
      */
     onContextTrimmed?: (sessionId: ChatIdLike, removedMessages: ChatMessage[]) => void;
+    /**
+     * Initial tools to register on the runtime.
+     * Equivalent to calling `registerTool()` for each tool after creation.
+     */
+    tools?: ToolDefinition[];
 }
-/** Retry configuration for pre-stream failures */
-interface RetryConfig {
+/** Retry configuration for pre-stream failures (renamed to avoid clash with agent-level RetryConfig) */
+interface StreamRetryConfig {
     /** Maximum number of attempts (default: 1 = no retry) */
     maxAttempts: number;
     /** Delay between retries in milliseconds */
     delayMs: number;
 }
-/** The unified chat runtime facade */
-interface IChatRuntime<TMetadata extends Record<string, unknown> = Record<string, unknown>> {
-    /** Current runtime status */
+/** @deprecated Use StreamRetryConfig */
+type RetryConfig = StreamRetryConfig;
+/** Information about a registered backend */
+interface BackendInfo {
+    /** Backend name (key in backends map) */
+    name: string;
+}
+/**
+ * Provider CRUD operations — separated per Interface Segregation Principle.
+ * Implemented by IChatClient (which needs provider management for UI).
+ * Not required on IChatRuntime (providers are a handler-layer concern).
+ */
+interface IProviderClient {
+    listProviders(): Promise<ProviderConfig[]>;
+    createProvider(config: Omit<ProviderConfig, "id" | "createdAt">): Promise<ProviderConfig>;
+    updateProvider(id: string, changes: Partial<Omit<ProviderConfig, "id" | "createdAt">>): Promise<void>;
+    deleteProvider(id: string): Promise<void>;
+}
+/** Callback for provider selection changes */
+type SelectionChangeCallback = (providerId: string | null) => void;
+/**
+ * Client-side interface for interacting with a remote chat server.
+ * Fully self-contained — no shared base with IChatRuntime.
+ * Extends IProviderClient for provider CRUD (ISP).
+ * Used by React components and remote clients.
+ *
+ * @typeParam TMetadata - Type-level convenience for message metadata.
+ *   NOT enforced at the storage boundary — session stores always use `unknown`.
+ *   Consumers are responsible for metadata shape consistency.
+ */
+interface IChatClient<TMetadata extends Record<string, unknown> = Record<string, unknown>> extends IProviderClient {
     readonly status: RuntimeStatus;
-    /** Dispose the runtime and all owned resources */
     dispose(): Promise<void>;
     createSession(options: CreateSessionOptions<TMetadata>): Promise<ChatSession<TMetadata>>;
     getSession(id: ChatIdLike): Promise<ChatSession<TMetadata> | null>;
     listSessions(options?: SessionListOptions): Promise<ChatSession<TMetadata>[]>;
     deleteSession(id: ChatIdLike): Promise<void>;
-    archiveSession(id: ChatIdLike): Promise<void>;
     switchSession(id: ChatIdLike): Promise<ChatSession<TMetadata>>;
-    /** Currently active session ID (null if none) */
     readonly activeSessionId: ChatId | null;
+    /**
+     * Send a message. Options are optional — the server handler resolves
+     * model and backend from provider selection state.
+     * Compare with IChatRuntime.send() where RuntimeSendOptions is required.
+     */
     send(sessionId: ChatIdLike, message: string, options?: SendMessageOptions): AsyncIterable<ChatEvent>;
     abort(): void;
-    switchBackend(name: string): Promise<void>;
-    switchModel(model: string): void;
+    selectProvider(providerId: string): void;
+    readonly selectedProviderId: string | null;
+    onSelectionChange(callback: SelectionChangeCallback): () => void;
+    onSessionChange(callback: () => void): () => void;
     listModels(): Promise<ModelInfo[]>;
-    /** Current backend name */
-    readonly currentBackend: string;
-    /** Current model (from config or default) */
-    readonly currentModel: string | undefined;
+    listBackends(): Promise<BackendInfo[]>;
+    getContextStats(sessionId: ChatIdLike): Promise<ContextStats | null>;
+}
+/**
+ * Server-side chat runtime. Fully self-contained — no shared base with IChatClient.
+ * Manages backend adapters, tools, middleware, and context trimming.
+ * Does NOT include client-facing provider CRUD or selection — those are
+ * handled by the server handler layer.
+ *
+ * @typeParam TMetadata - Type-level convenience for message metadata.
+ *   NOT enforced at the storage boundary — session stores always use `unknown`.
+ *   Casts in `ChatRuntime.createSession()`/`getSession()` are intentionally unsafe
+ *   to provide typed access. Consumers are responsible for metadata shape consistency.
+ */
+interface IChatRuntime<TMetadata extends Record<string, unknown> = Record<string, unknown>> {
+    readonly status: RuntimeStatus;
+    dispose(): Promise<void>;
+    createSession(options: CreateSessionOptions<TMetadata>): Promise<ChatSession<TMetadata>>;
+    getSession(id: ChatIdLike): Promise<ChatSession<TMetadata> | null>;
+    listSessions(options?: SessionListOptions): Promise<ChatSession<TMetadata>[]>;
+    deleteSession(id: ChatIdLike): Promise<void>;
+    /**
+     * Send a message. RuntimeSendOptions is required on the server — the caller
+     * (usually a handler) must supply backend, model, and credentials.
+     * Compare with IChatClient.send() where options are optional.
+     */
+    send(sessionId: ChatIdLike, message: string, options: RuntimeSendOptions): AsyncIterable<ChatEvent>;
+    abort(): void;
+    onSessionChange(callback: () => void): () => void;
+    listModels(options?: {
+        backend?: string;
+        credentials?: AuthToken;
+    }): Promise<ModelInfo[]>;
+    listBackends(): Promise<BackendInfo[]>;
     registerTool(tool: ToolDefinition): void;
     removeTool(name: string): void;
     readonly registeredTools: ReadonlyMap<string, ToolDefinition>;
     use(middleware: ChatMiddleware): void;
     removeMiddleware(middleware: ChatMiddleware): void;
-    /** Get context usage stats from the last send() for a session. Returns null if no trimming has occurred. */
-    getContextStats(sessionId: ChatIdLike): ContextStats | null;
-    /** Subscribe to session mutations (create, delete, archive, message send complete). Returns unsubscribe function. */
-    onSessionChange(callback: () => void): () => void;
+    getContextStats(sessionId: ChatIdLike): Promise<ContextStats | null>;
 }
 /**
  * Create a fully-wired chat runtime from configuration.
@@ -115,4 +179,4 @@ interface IChatRuntime<TMetadata extends Record<string, unknown> = Record<string
  */
 declare function createChatRuntime<TMetadata extends Record<string, unknown> = Record<string, unknown>>(options: ChatRuntimeOptions): IChatRuntime<TMetadata>;
 
-export { type BackendAdapterFactory, type ChatRuntimeOptions, type IChatRuntime, type RetryConfig, createChatRuntime };
+export { type BackendAdapterFactory, type BackendInfo, type ChatRuntimeOptions, type IChatClient, type IChatRuntime, type IProviderClient, type RetryConfig, type SelectionChangeCallback, type StreamRetryConfig, createChatRuntime };