@witqq/agent-sdk 0.7.0 → 0.8.0

package/dist/refresh-manager-Dlv_iNZi.d.ts

@@ -0,0 +1,153 @@
+import { A as AuthToken } from './types-BxggH0Yh.js';
+
+/**
+ * Automatic background token refresh manager.
+ *
+ * Schedules token refresh at a configurable threshold before expiry
+ * (default 80% of token lifetime). Emits events on refresh, failure,
+ * and token expiry. Handles retry on failure and clean disposal.
+ *
+ * When all retries are exhausted but the token hasn't expired yet,
+ * the manager waits until the token's expiry time and then starts
+ * a fresh retry cycle. This continues until refresh succeeds or
+ * the token expires.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { TokenRefreshManager } from "@witqq/agent-sdk/auth";
+ *
+ * const manager = new TokenRefreshManager({
+ *   token: claudeToken,
+ *   refresh: (rt) => claudeAuth.refreshToken(rt),
+ * });
+ * manager.on("refreshed", (newToken) => { tokenStore.save("claude", newToken); });
+ * manager.on("error", (err) => { console.error("Refresh failed:", err); });
+ * manager.start();
+ * // ...later
+ * manager.dispose();
+ * ```
+ *
+ * @example Integration with createAuthHandler
+ * ```ts
+ * import { TokenRefreshManager } from "@witqq/agent-sdk/auth";
+ * import { createAuthHandler } from "@witqq/agent-sdk/chat/server";
+ * import type { ClaudeAuthToken } from "@witqq/agent-sdk/auth";
+ *
+ * let refreshManager: TokenRefreshManager | undefined;
+ *
+ * const authHandler = createAuthHandler({
+ *   tokenStore,
+ *   onAuth: (provider, token) => {
+ *     // Clean up previous manager
+ *     refreshManager?.dispose();
+ *     refreshManager = undefined;
+ *
+ *     if (provider === "claude" && token.expiresIn) {
+ *       refreshManager = new TokenRefreshManager({
+ *         token,
+ *         refresh: (t) =>
+ *           claudeAuth.refreshToken((t as ClaudeAuthToken).refreshToken),
+ *       });
+ *       refreshManager.on("refreshed", (newToken) => {
+ *         tokenStore.save("claude", newToken);
+ *       });
+ *       refreshManager.on("expired", () => {
+ *         console.warn("Claude token expired — re-authentication required");
+ *       });
+ *       refreshManager.start();
+ *     }
+ *   },
+ * });
+ * ```
+ */
+
+/** Events emitted by TokenRefreshManager */
+interface TokenRefreshEvents {
+    /** Emitted when token was successfully refreshed */
+    refreshed: (token: AuthToken) => void;
+    /** Emitted when refresh attempt failed (may retry) */
+    error: (error: Error, attempt: number) => void;
+    /** Emitted when token expired and could not be refreshed */
+    expired: () => void;
+    /** Emitted when manager is disposed */
+    disposed: () => void;
+}
+/** Configuration for TokenRefreshManager */
+interface TokenRefreshOptions {
+    /** Current token with expiresIn and obtainedAt */
+    token: AuthToken;
+    /**
+     * Function that performs the actual token refresh.
+     * Receives the current token and returns a new one.
+     */
+    refresh: (token: AuthToken) => Promise<AuthToken>;
+    /**
+     * Fraction of token lifetime at which to trigger refresh (0-1).
+     * Default: 0.8 (refresh at 80% of lifetime, i.e. with 20% remaining)
+     */
+    refreshThreshold?: number;
+    /**
+     * Maximum retry attempts on refresh failure. Default: 3
+     */
+    maxRetries?: number;
+    /**
+     * Base delay between retries in ms. Exponential backoff applied. Default: 1000
+     */
+    retryDelayMs?: number;
+    /**
+     * Minimum schedule delay in ms (prevents scheduling in the past). Default: 1000
+     */
+    minDelayMs?: number;
+}
+type EventName = keyof TokenRefreshEvents;
+/**
+ * Background token refresh manager with event emission and retry logic.
+ *
+ * Lifecycle: `new` → `start()` → (auto-refreshes) → `stop()` or `dispose()`
+ */
+declare class TokenRefreshManager {
+    private currentToken;
+    private readonly refreshFn;
+    private readonly threshold;
+    private readonly maxRetries;
+    private readonly retryDelayMs;
+    private readonly minDelayMs;
+    private timerId;
+    private running;
+    private disposed;
+    private readonly listeners;
+    constructor(options: TokenRefreshOptions);
+    /** Register an event listener */
+    on<K extends EventName>(event: K, listener: TokenRefreshEvents[K]): this;
+    /** Remove an event listener */
+    off<K extends EventName>(event: K, listener: TokenRefreshEvents[K]): this;
+    /** Current token managed by this instance */
+    get token(): AuthToken;
+    /** Whether the manager is currently running */
+    get isRunning(): boolean;
+    /** Whether the manager has been disposed */
+    get isDisposed(): boolean;
+    /**
+     * Start automatic refresh scheduling.
+     * If the token is already expired, emits "expired" immediately.
+     * If the token has no expiresIn, does nothing (long-lived token).
+     */
+    start(): void;
+    /** Stop automatic refresh (can be restarted with start()) */
+    stop(): void;
+    /**
+     * Update the managed token (e.g. after manual refresh).
+     * Reschedules automatic refresh if running.
+     */
+    updateToken(token: AuthToken): void;
+    /** Stop and clean up all resources */
+    dispose(): void;
+    private schedule;
+    private performRefresh;
+    private computeRefreshDelay;
+    private isTokenExpired;
+    private clearTimer;
+    private emit;
+}
+
+export { type TokenRefreshEvents as T, TokenRefreshManager as a, type TokenRefreshOptions as b };

package/dist/testing.cjs

@@ -0,0 +1,383 @@
+'use strict';
+
+// src/testing/mock-agent-service.ts
+var MockAgent = class {
+  sessionId = void 0;
+  _state = "idle";
+  _config;
+  _onRun;
+  _onStream;
+  constructor(config, options) {
+    this._config = config;
+    this._onRun = options?.onRun;
+    this._onStream = options?.onStream;
+  }
+  async run(prompt, options) {
+    if (this._onRun) return this._onRun(prompt, options);
+    return { output: "Mock response", structuredOutput: void 0, toolCalls: [], messages: [], usage: { promptTokens: 10, completionTokens: 5 } };
+  }
+  async runWithContext(messages, options) {
+    const lastMsg = messages[messages.length - 1];
+    const text = typeof lastMsg?.content === "string" ? lastMsg.content : "context";
+    return this.run(text, options);
+  }
+  async runStructured(prompt, _schema, options) {
+    const base = await this.run(prompt, options);
+    return { ...base, structuredOutput: void 0 };
+  }
+  async *stream(prompt, options) {
+    if (this._onStream) {
+      yield* this._onStream(prompt, options);
+      return;
+    }
+    yield { type: "text_delta", text: "Mock " };
+    yield { type: "text_delta", text: "response" };
+    yield { type: "done", finalOutput: "Mock response" };
+  }
+  async *streamWithContext(messages, options) {
+    const lastMsg = messages[messages.length - 1];
+    const text = typeof lastMsg?.content === "string" ? lastMsg.content : "context";
+    yield* this.stream(text, options);
+  }
+  abort() {
+    this._state = "idle";
+  }
+  async interrupt() {
+    this._state = "idle";
+  }
+  getState() {
+    return this._state;
+  }
+  getConfig() {
+    return this._config;
+  }
+  dispose() {
+    this._state = "disposed";
+  }
+};
+function createMockAgentService(options = {}) {
+  const name = options.name ?? "mock";
+  return {
+    name,
+    createAgent(config) {
+      return new MockAgent(config, options);
+    },
+    async listModels() {
+      return options.models ?? [
+        { id: "mock-model-1", name: "Mock Model 1" },
+        { id: "mock-model-2", name: "Mock Model 2" }
+      ];
+    },
+    async validate() {
+      return options.validationResult ?? { valid: true, errors: [] };
+    },
+    async dispose() {
+    }
+  };
+}
+
+// src/chat/types.ts
+function createChatId() {
+  return crypto.randomUUID();
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+function toChatId(value) {
+  if (!UUID_RE.test(value)) {
+    throw new TypeError(`Invalid ChatId: "${value}" is not a valid UUID`);
+  }
+  return value;
+}
+
+// src/testing/mock-data.ts
+function createMockSession(options = {}) {
+  const id = options.id ?? createChatId();
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    id,
+    title: options.title ?? "Test Session",
+    messages: options.messages ?? [],
+    config: {
+      model: options.config?.model ?? "test-model",
+      backend: options.config?.backend ?? "test-backend",
+      systemPrompt: options.config?.systemPrompt ?? ""
+    },
+    metadata: {
+      messageCount: options.messages?.length ?? 0,
+      totalTokens: 0,
+      custom: options.metadata ?? {}
+    },
+    status: options.status ?? "active",
+    createdAt: now,
+    updatedAt: now
+  };
+}
+function createMockMessage(options = {}) {
+  const id = createChatId();
+  const parts = options.parts ?? (options.text ? [{ type: "text", text: options.text, status: "complete" }] : [{ type: "text", text: "Test message", status: "complete" }]);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    id,
+    role: options.role ?? "user",
+    parts,
+    status: options.status ?? "complete",
+    createdAt: now,
+    metadata: options.metadata ?? {}
+  };
+}
+
+// src/testing/mock-runtime.ts
+function createMockRuntime(options = {}) {
+  const sessions = /* @__PURE__ */ new Map();
+  const tools = /* @__PURE__ */ new Map();
+  const sessionListeners = /* @__PURE__ */ new Set();
+  let currentBackend = options.defaultBackend ?? "mock";
+  let status = "idle";
+  for (const s of options.sessions ?? []) {
+    sessions.set(s.id, s);
+  }
+  function notifySessionChange() {
+    for (const cb of sessionListeners) {
+      try {
+        cb();
+      } catch {
+      }
+    }
+  }
+  const runtime = {
+    get status() {
+      return status;
+    },
+    get registeredTools() {
+      return tools;
+    },
+    async createSession(opts) {
+      const session = createMockSession({
+        title: opts.title,
+        config: {
+          model: opts.config?.model ?? "mock-model",
+          backend: opts.config?.backend ?? currentBackend,
+          systemPrompt: opts.config?.systemPrompt
+        },
+        metadata: opts.custom
+      });
+      sessions.set(session.id, session);
+      notifySessionChange();
+      return session;
+    },
+    async getSession(id) {
+      return sessions.get(toChatId(String(id))) ?? null;
+    },
+    async listSessions(_opts) {
+      return [...sessions.values()];
+    },
+    async deleteSession(id) {
+      sessions.delete(toChatId(String(id)));
+      notifySessionChange();
+    },
+    send(sessionId, message, sendOpts) {
+      if (options.onSend) return options.onSend(sessionId, message, sendOpts);
+      async function* defaultStream() {
+        const msgId = createChatId();
+        yield { type: "message:start", messageId: msgId };
+        yield { type: "message:delta", text: "Mock reply" };
+        yield { type: "message:complete", messageId: msgId };
+        yield { type: "done", finalOutput: "Mock reply" };
+        const session = sessions.get(toChatId(String(sessionId)));
+        if (session) {
+          session.messages.push(createMockMessage({ role: "assistant", text: "Mock reply" }));
+          session.metadata.messageCount = session.messages.length;
+        }
+        notifySessionChange();
+      }
+      return defaultStream();
+    },
+    abort() {
+    },
+    async listModels() {
+      return options.models ?? [{ id: "mock-model", name: "Mock Model" }];
+    },
+    async listBackends() {
+      return [{ name: currentBackend }];
+    },
+    onSessionChange(callback) {
+      sessionListeners.add(callback);
+      return () => {
+        sessionListeners.delete(callback);
+      };
+    },
+    registerTool(tool) {
+      tools.set(tool.name, tool);
+    },
+    removeTool(name) {
+      tools.delete(name);
+    },
+    use(mw) {
+    },
+    removeMiddleware(mw) {
+    },
+    async getContextStats(_sessionId) {
+      return null;
+    },
+    async dispose() {
+      status = "disposed";
+      sessions.clear();
+      tools.clear();
+      sessionListeners.clear();
+    }
+  };
+  return runtime;
+}
+
+// src/testing/mock-chat-client.ts
+function createMockChatClient(options = {}) {
+  const sessions = /* @__PURE__ */ new Map();
+  const providers = /* @__PURE__ */ new Map();
+  const sessionListeners = /* @__PURE__ */ new Set();
+  const selectionListeners = /* @__PURE__ */ new Set();
+  let activeSessionId = null;
+  let selectedProviderId = null;
+  let status = "idle";
+  for (const s of options.sessions ?? []) {
+    sessions.set(s.id, s);
+  }
+  for (const p of options.providers ?? []) {
+    providers.set(p.id, p);
+  }
+  function notifySessionChange() {
+    for (const cb of sessionListeners) {
+      try {
+        cb();
+      } catch {
+      }
+    }
+  }
+  const client = {
+    get status() {
+      return status;
+    },
+    get activeSessionId() {
+      return activeSessionId;
+    },
+    async createSession(opts) {
+      const session = createMockSession({
+        title: opts.title,
+        config: {
+          model: opts.config?.model ?? "mock-model",
+          backend: opts.config?.backend ?? "mock",
+          systemPrompt: opts.config?.systemPrompt
+        }
+      });
+      sessions.set(session.id, session);
+      activeSessionId = session.id;
+      notifySessionChange();
+      return session;
+    },
+    async getSession(id) {
+      return sessions.get(toChatId(String(id))) ?? null;
+    },
+    async listSessions(_opts) {
+      return [...sessions.values()];
+    },
+    async deleteSession(id) {
+      sessions.delete(toChatId(String(id)));
+      if (activeSessionId === String(id)) activeSessionId = null;
+      notifySessionChange();
+    },
+    async switchSession(id) {
+      const session = sessions.get(toChatId(String(id)));
+      if (!session) throw new Error(`Session ${id} not found`);
+      activeSessionId = session.id;
+      return session;
+    },
+    send(sessionId, message, sendOpts) {
+      if (options.onSend) return options.onSend(sessionId, message, sendOpts);
+      async function* defaultStream() {
+        const msgId = createChatId();
+        yield { type: "message:start", messageId: msgId };
+        yield { type: "message:delta", text: "Mock reply" };
+        yield { type: "message:complete", messageId: msgId };
+        yield { type: "done", finalOutput: "Mock reply" };
+        const session = sessions.get(toChatId(String(sessionId)));
+        if (session) {
+          session.messages.push(createMockMessage({ role: "assistant", text: "Mock reply" }));
+          session.metadata.messageCount = session.messages.length;
+        }
+        notifySessionChange();
+      }
+      return defaultStream();
+    },
+    abort() {
+    },
+    // ── Provider Selection ──
+    get selectedProviderId() {
+      return selectedProviderId;
+    },
+    selectProvider(providerId) {
+      selectedProviderId = providerId;
+      for (const cb of selectionListeners) {
+        try {
+          cb(providerId);
+        } catch {
+        }
+      }
+    },
+    onSelectionChange(callback) {
+      selectionListeners.add(callback);
+      return () => {
+        selectionListeners.delete(callback);
+      };
+    },
+    async listModels() {
+      return options.models ?? [{ id: "mock-model", name: "Mock Model" }];
+    },
+    async listBackends() {
+      return [{ name: "mock" }];
+    },
+    onSessionChange(callback) {
+      sessionListeners.add(callback);
+      return () => {
+        sessionListeners.delete(callback);
+      };
+    },
+    async getContextStats(_sessionId) {
+      return null;
+    },
+    // ── Provider CRUD ──
+    async listProviders() {
+      return [...providers.values()];
+    },
+    async createProvider(config) {
+      const provider = {
+        ...config,
+        id: createChatId(),
+        createdAt: Date.now()
+      };
+      providers.set(provider.id, provider);
+      return provider;
+    },
+    async updateProvider(id, changes) {
+      const existing = providers.get(id);
+      if (!existing) throw new Error(`Provider ${id} not found`);
+      providers.set(id, { ...existing, ...changes });
+    },
+    async deleteProvider(id) {
+      providers.delete(id);
+    },
+    async dispose() {
+      status = "disposed";
+      sessions.clear();
+      providers.clear();
+      sessionListeners.clear();
+      selectionListeners.clear();
+    }
+  };
+  return client;
+}
+
+exports.createMockAgentService = createMockAgentService;
+exports.createMockChatClient = createMockChatClient;
+exports.createMockMessage = createMockMessage;
+exports.createMockRuntime = createMockRuntime;
+exports.createMockSession = createMockSession;
+//# sourceMappingURL=testing.cjs.map
+//# sourceMappingURL=testing.cjs.map

package/dist/testing.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/mock-agent-service.ts","../src/chat/types.ts","../src/testing/mock-data.ts","../src/testing/mock-runtime.ts","../src/testing/mock-chat-client.ts"],"names":[],"mappings":"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","file":"testing.cjs","sourcesContent":["/**\n * Mock IAgentService factory for testing.\n */\nimport type {\n  IAgentService,\n  IAgent,\n  FullAgentConfig,\n  ModelInfo,\n  ValidationResult,\n  AgentResult,\n  AgentEvent,\n  Message,\n  MessageContent,\n  RunOptions,\n  StructuredOutputConfig,\n  AgentState,\n} from \"../types.js\";\n\n/** Options for createMockAgentService. */\nexport interface MockAgentServiceOptions {\n  /** Service name. Default: \"mock\". */\n  name?: string;\n  /** Models to return from listModels(). */\n  models?: ModelInfo[];\n  /** Custom validation result. Default: { valid: true, errors: [] }. */\n  validationResult?: ValidationResult;\n  /** Custom run handler. Default: returns \"Mock response\". */\n  onRun?: (prompt: MessageContent, options?: RunOptions) => Promise<AgentResult>;\n  /** Custom stream handler. Default: yields text_delta + result events. */\n  onStream?: (prompt: MessageContent, options?: RunOptions) => AsyncIterable<AgentEvent>;\n}\n\nclass MockAgent implements IAgent {\n  readonly sessionId: string | undefined = undefined;\n  private _state: AgentState = \"idle\";\n  private readonly _config: FullAgentConfig;\n  private readonly _onRun?: MockAgentServiceOptions[\"onRun\"];\n  private readonly _onStream?: MockAgentServiceOptions[\"onStream\"];\n\n  constructor(config: FullAgentConfig, options?: MockAgentServiceOptions) {\n    this._config = config;\n    this._onRun = options?.onRun;\n    this._onStream = options?.onStream;\n  }\n\n  async run(prompt: MessageContent, options: RunOptions): Promise<AgentResult> {\n    if (this._onRun) return this._onRun(prompt, options);\n    return { output: \"Mock response\", structuredOutput: undefined, toolCalls: [], messages: [], usage: { promptTokens: 10, completionTokens: 5 } };\n  }\n\n  async runWithContext(messages: Message[], options: RunOptions): Promise<AgentResult> {\n    const lastMsg = messages[messages.length - 1];\n    const text = typeof lastMsg?.content === \"string\" ? lastMsg.content : \"context\";\n    return this.run(text, options);\n  }\n\n  async runStructured<T>(\n    prompt: MessageContent,\n    _schema: StructuredOutputConfig<T>,\n    options: RunOptions,\n  ): Promise<AgentResult<T>> {\n    const base = await this.run(prompt, options);\n    return { ...base, structuredOutput: undefined as unknown as T extends void ? undefined : T };\n  }\n\n  async *stream(prompt: MessageContent, options: RunOptions): AsyncIterable<AgentEvent> {\n    if (this._onStream) {\n      yield* this._onStream(prompt, options);\n      return;\n    }\n    yield { type: \"text_delta\", text: \"Mock \" };\n    yield { type: \"text_delta\", text: \"response\" };\n    yield { type: \"done\", finalOutput: \"Mock response\" };\n  }\n\n  async *streamWithContext(messages: Message[], options: RunOptions): AsyncIterable<AgentEvent> {\n    const lastMsg = messages[messages.length - 1];\n    const text = typeof lastMsg?.content === \"string\" ? lastMsg.content : \"context\";\n    yield* this.stream(text, options);\n  }\n\n  abort(): void {\n    this._state = \"idle\";\n  }\n\n  async interrupt(): Promise<void> {\n    this._state = \"idle\";\n  }\n\n  getState(): AgentState {\n    return this._state;\n  }\n\n  getConfig(): Readonly<FullAgentConfig> {\n    return this._config;\n  }\n\n  dispose(): void {\n    this._state = \"disposed\";\n  }\n}\n\n/**\n * Create a mock IAgentService for testing agent-level code.\n *\n * ```ts\n * const service = createMockAgentService({ name: \"test\" });\n * const agent = service.createAgent({ model: \"gpt-5-mini\" });\n * const result = await agent.run(\"Hello\");\n * ```\n */\nexport function createMockAgentService(options: MockAgentServiceOptions = {}): IAgentService {\n  const name = options.name ?? \"mock\";\n  return {\n    name,\n    createAgent(config: FullAgentConfig): IAgent {\n      return new MockAgent(config, options);\n    },\n    async listModels(): Promise<ModelInfo[]> {\n      return options.models ?? [\n        { id: \"mock-model-1\", name: \"Mock Model 1\" },\n        { id: \"mock-model-2\", name: \"Mock Model 2\" },\n      ];\n    },\n    async validate(): Promise<ValidationResult> {\n      return options.validationResult ?? { valid: true, errors: [] };\n    },\n    async dispose(): Promise<void> {\n      // no-op\n    },\n  };\n}\n","/**\n * @witqq/agent-sdk — Chat domain types\n *\n * All type definitions and interfaces for the chat layer.\n * Pure types + ChatId generation (tightly coupled to branded type).\n */\n\nimport type { UsageData, ToolDefinition, ErrorCode } from \"../types.js\";\nimport type { AuthToken } from \"../auth/types.js\";\n\n// ─── Unique ID ─────────────────────────────────────────────────\n\n/** Branded type for unique identifiers */\nexport type ChatId = string & { readonly __brand: \"ChatId\" };\n\n/**\n * Generate a new unique ChatId (crypto.randomUUID-based)\n * @returns Branded ChatId string\n */\nexport function createChatId(): ChatId {\n  return crypto.randomUUID() as ChatId;\n}\n\n/** UUID v4 pattern for ChatId validation */\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;\n\n/**\n * Cast a string to ChatId with UUID format validation.\n * Use this instead of manual `as ChatId` type assertions.\n *\n * @param value - String to validate and cast\n * @returns Branded ChatId\n * @throws {TypeError} If value is not a valid UUID v4 format\n */\nexport function toChatId(value: string): ChatId {\n  if (!UUID_RE.test(value)) {\n    throw new TypeError(`Invalid ChatId: \"${value}\" is not a valid UUID`);\n  }\n  return value as ChatId;\n}\n\n/**\n * Accepts either a plain string or branded ChatId for API convenience.\n * Use this in public API signatures so consumers don't need `as ChatId` casts.\n */\nexport type ChatIdLike = string | ChatId;\n\n// ─── Status Types ──────────────────────────────────────────────\n\n/** Lifecycle status of a message part (text, reasoning, etc.) */\nexport type PartStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\";\n/** Lifecycle status of a tool call within a message */\nexport type ToolCallStatus = \"pending\" | \"running\" | \"requires_approval\" | \"complete\" | \"error\" | \"denied\";\n/** Lifecycle status of an entire message */\nexport type MessageStatus = \"pending\" | \"streaming\" | \"complete\" | \"error\" | \"cancelled\";\n/** Lifecycle status of a chat session */\nexport type SessionStatus = \"active\";\n/** Lifecycle status of the chat runtime */\nexport type RuntimeStatus = \"idle\" | \"streaming\" | \"error\" | \"disposed\";\n\n// ─── Message Parts (union) ─────────────────────────────────────\n\n/** Plain text content part */\nexport interface TextPart { type: \"text\"; text: string; status: PartStatus; }\n/** Model reasoning/thinking content part */\nexport interface ReasoningPart { type: \"reasoning\"; text: string; status: PartStatus; }\n/** Tool invocation part with call ID, arguments, optional result */\nexport interface ToolCallPart { type: \"tool_call\"; toolCallId: string; name: string; args: unknown; result?: unknown; status: ToolCallStatus; error?: string; }\n/** Source reference part (URL citation) */\nexport interface SourcePart { type: \"source\"; url: string; title?: string; status: PartStatus; }\n/** File attachment part (base64-encoded data) */\nexport interface FilePart { type: \"file\"; name: string; mimeType: string; data: string; status: PartStatus; }\n/** Union of all message part types */\nexport type MessagePart = TextPart | ReasoningPart | ToolCallPart | SourcePart | FilePart;\n\n// ─── Chat Message ──────────────────────────────────────────────\n\n/** Role of message author */\nexport type ChatRole = \"user\" | \"assistant\" | \"system\";\n\n/** Metadata attached to messages — useful preset for the TMetadata generic */\nexport interface ChatMessageMetadata {\n  model?: string;\n  backend?: string;\n  usage?: UsageData;\n  isSummary?: boolean;\n  estimatedTokens?: number;\n  custom?: Record<string, unknown>;\n}\n\n/** Message status */\nexport type ChatMessageStatus = MessageStatus;\n\n/** A single chat message — the fundamental unit of conversation */\nexport interface ChatMessage<TMetadata = unknown> {\n  id: ChatId;\n  role: ChatRole;\n  parts: MessagePart[];\n  metadata?: TMetadata;\n  createdAt: string;\n  updatedAt?: string;\n  status: MessageStatus;\n}\n\n// ─── Supporting Types ──────────────────────────────────────────\n\n// ─── Chat Session ──────────────────────────────────────────────\n\n/** Session configuration snapshot */\nexport interface ChatSessionConfig {\n  model: string;\n  backend: string;\n  systemPrompt?: string;\n  temperature?: number;\n  maxTokens?: number;\n}\n\n/**\n * Session metadata tracking usage statistics and custom extensions.\n *\n * Updated automatically by session stores on each `addMessage()` call.\n * The generic `TCustom` parameter allows type-safe application-specific\n * metadata via the `custom` field.\n *\n * @typeParam TCustom - Shape of the `custom` field (defaults to `Record<string, unknown>`)\n */\nexport interface ChatSessionMetadata<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n  /** Number of messages in the session (updated by session store) */\n  messageCount: number;\n  /** Total token count across all messages in the session */\n  totalTokens: number;\n  /** Optional tags for session categorization and filtering */\n  tags?: string[];\n  /** Application-specific metadata — typed via the TCustom generic parameter */\n  custom?: TCustom;\n}\n\n/** Chat session — a conversation with ordered messages (pure serializable data) */\nexport interface ChatSession<TCustom extends Record<string, unknown> = Record<string, unknown>> {\n  id: ChatId;\n  title?: string;\n  messages: ChatMessage[];\n  config: ChatSessionConfig;\n  metadata: ChatSessionMetadata<TCustom>;\n  status: SessionStatus;\n  createdAt: string;\n  updatedAt: string;\n  backendSessionId?: string;\n}\n\n/**\n * Reactive wrapper around ChatSession — provides subscribe/getSnapshot for\n * React useSyncExternalStore integration and lastMessage convenience getter.\n * Session stores may optionally return ObservableSession instances.\n */\nexport interface ObservableSession<TCustom extends Record<string, unknown> = Record<string, unknown>>\n  extends ChatSession<TCustom> {\n  /** Subscribe to session changes (for React useSyncExternalStore) */\n  subscribe(callback: () => void): () => void;\n  /** Get immutable snapshot of session state (for React useSyncExternalStore) */\n  getSnapshot(): ChatSession<TCustom>;\n  /** Last message in the session */\n  readonly lastMessage: ChatMessage | undefined;\n}\n\n/** Lightweight session info for listing (without full message array) */\nexport interface SessionInfo {\n  id: ChatId;\n  title?: string;\n  status: SessionStatus;\n  messageCount: number;\n  lastMessage?: ChatMessage;\n  createdAt: string;\n  updatedAt: string;\n}\n\n// ─── Chat Events ───────────────────────────────────────────────\n\n/** Events emitted during chat operation */\nexport type ChatEvent =\n  | { type: \"message:start\"; messageId: ChatId; role: ChatRole }\n  | { type: \"message:delta\"; messageId: ChatId; text: string }\n  | { type: \"message:complete\"; messageId: ChatId; message: ChatMessage }\n  | {\n      type: \"tool:start\";\n      messageId: ChatId;\n      toolCallId: string;\n      toolName: string;\n      args: Record<string, unknown>;\n    }\n  | {\n      type: \"tool:complete\";\n      messageId: ChatId;\n      toolCallId: string;\n      toolName: string;\n      result: unknown;\n      isError?: boolean;\n    }\n  | { type: \"thinking:start\"; messageId: ChatId }\n  | { type: \"thinking:delta\"; messageId: ChatId; text: string }\n  | { type: \"thinking:end\"; messageId: ChatId }\n  | {\n      type: \"permission:request\";\n      messageId: ChatId;\n      toolName: string;\n      toolArgs: Record<string, unknown>;\n    }\n  | {\n      type: \"permission:response\";\n      messageId: ChatId;\n      toolName: string;\n      allowed: boolean;\n    }\n  | {\n      type: \"usage\";\n      promptTokens: number;\n      completionTokens: number;\n      model?: string;\n    }\n  | { type: \"session:created\"; sessionId: ChatId }\n  | { type: \"session:updated\"; sessionId: ChatId }\n  | {\n      type: \"error\";\n      error: string;\n      recoverable: boolean;\n      code?: ErrorCode;\n      messageId?: ChatId;\n    }\n  | { type: \"typing:start\" }\n  | { type: \"typing:end\" }\n  | { type: \"heartbeat\" }\n  | { type: \"done\"; finalOutput?: string };\n\n/** All possible ChatEvent type strings */\nexport type ChatEventType = ChatEvent[\"type\"];\n\n// ─── Chat Middleware ───────────────────────────────────────────\n\n/** Context passed to ChatMiddleware hooks */\nexport interface ChatMiddlewareContext {\n  sessionId: ChatId;\n  signal: AbortSignal;\n}\n\n/** Runtime-level middleware for the send/receive lifecycle.\n *  Different from EventMiddleware which operates at the event bus level. */\nexport interface ChatMiddleware {\n  /** Transform message before sending to backend. Return null to reject the send. */\n  onBeforeSend?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | null | Promise<ChatMessage | null>;\n  /** Transform/intercept stream events */\n  onEvent?(event: ChatEvent, context: ChatMiddlewareContext): ChatEvent | null | Promise<ChatEvent | null>;\n  /** Transform completed message after receiving from backend */\n  onAfterReceive?(message: ChatMessage, context: ChatMiddlewareContext): ChatMessage | Promise<ChatMessage>;\n  /** Intercept errors — return null to suppress, return error to propagate */\n  onError?(error: Error, context: ChatMiddlewareContext): Error | null | Promise<Error | null>;\n}\n\n// ─── Chat Provider Abstraction ─────────────────────────────────\n\n/** Options for sending a message to a provider */\nexport interface SendMessageOptions {\n  signal?: AbortSignal;\n  /** Model to use for this request. Required for server-side runtime.send(). */\n  model?: string;\n  /** Per-call system prompt override (forwarded to the backend agent) */\n  systemPrompt?: string;\n  context?: Record<string, unknown>;\n  /** Additional tools to include in this request */\n  tools?: ToolDefinition[];\n}\n\n/** Options for runtime.send() — requires backend routing info */\nexport interface RuntimeSendOptions {\n  /** Backend to route this request to (key in backends map) */\n  backend: string;\n  /** Authentication credentials for the backend factory */\n  credentials: AuthToken;\n  /** Model to use for this request */\n  model: string;\n  /** Per-call system prompt override (forwarded to the backend agent) */\n  systemPrompt?: string;\n  /** Abort signal */\n  signal?: AbortSignal;\n  /** Request-scoped context */\n  context?: Record<string, unknown>;\n  /** Additional tools */\n  tools?: ToolDefinition[];\n}\n\n/**\n * @deprecated IChatProvider has been inlined into IChatBackend.\n * Import IChatBackend from \"@witqq/agent-sdk/chat/backends\" instead.\n * Kept as type alias for backward compatibility.\n */\nexport type IChatProvider = import(\"./backends/types.js\").IChatBackend;\n\n// ─── Factory Functions ─────────────────────────────────────────\n\n/**\n * Create a simple text ChatMessage.\n *\n * @param text - Message text content\n * @param role - Message role (default: \"user\")\n * @returns A complete ChatMessage with a single TextPart\n */\nexport function createTextMessage(text: string, role: ChatRole = \"user\"): ChatMessage {\n  return {\n    id: createChatId(),\n    role,\n    parts: [{ type: \"text\", text, status: \"complete\" }],\n    createdAt: new Date().toISOString(),\n    status: \"complete\",\n  };\n}\n\n/** Type guard: checks if a session has reactive API (subscribe/getSnapshot) */\nexport function isObservableSession<TCustom extends Record<string, unknown> = Record<string, unknown>>(\n  session: ChatSession<TCustom>,\n): session is ObservableSession<TCustom> {\n  return \"subscribe\" in session && typeof (session as ObservableSession<TCustom>).subscribe === \"function\"\n    && \"getSnapshot\" in session && typeof (session as ObservableSession<TCustom>).getSnapshot === \"function\";\n}\n","/**\n * Mock data factories for creating test ChatSession and ChatMessage instances.\n */\nimport type { ChatSession, ChatMessage, MessagePart, ChatSessionConfig, ChatId } from \"../chat/core.js\";\nimport { createChatId } from \"../chat/core.js\";\n\n/** Options for createMockSession. */\nexport interface MockSessionOptions {\n  id?: string;\n  title?: string;\n  messages?: ChatMessage[];\n  config?: Partial<ChatSessionConfig>;\n  metadata?: Record<string, unknown>;\n  status?: \"active\";\n}\n\n/** Options for createMockMessage. */\nexport interface MockMessageOptions {\n  id?: string;\n  role?: \"user\" | \"assistant\" | \"system\";\n  text?: string;\n  parts?: MessagePart[];\n  status?: \"pending\" | \"streaming\" | \"complete\" | \"error\";\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Create a mock ChatSession for testing.\n *\n * ```ts\n * const session = createMockSession({ title: \"Test chat\" });\n * ```\n */\nexport function createMockSession(options: MockSessionOptions = {}): ChatSession {\n  const id = (options.id ?? createChatId()) as ChatId;\n  const now = new Date().toISOString();\n  return {\n    id,\n    title: options.title ?? \"Test Session\",\n    messages: options.messages ?? [],\n    config: {\n      model: options.config?.model ?? \"test-model\",\n      backend: options.config?.backend ?? \"test-backend\",\n      systemPrompt: options.config?.systemPrompt ?? \"\",\n    },\n    metadata: {\n      messageCount: options.messages?.length ?? 0,\n      totalTokens: 0,\n      custom: options.metadata ?? {},\n    },\n    status: options.status ?? \"active\",\n    createdAt: now,\n    updatedAt: now,\n  };\n}\n\n/**\n * Create a mock ChatMessage for testing.\n *\n * ```ts\n * const msg = createMockMessage({ role: \"user\", text: \"Hello\" });\n * ```\n */\nexport function createMockMessage(options: MockMessageOptions = {}): ChatMessage {\n  const id = createChatId();\n  const parts: MessagePart[] = options.parts ?? (options.text\n    ? [{ type: \"text\" as const, text: options.text, status: \"complete\" as const }]\n    : [{ type: \"text\" as const, text: \"Test message\", status: \"complete\" as const }]);\n  const now = new Date().toISOString();\n  return {\n    id,\n    role: options.role ?? \"user\",\n    parts,\n    status: options.status ?? \"complete\",\n    createdAt: now,\n    metadata: options.metadata ?? {},\n  };\n}\n","/**\n * Mock IChatRuntime factory for testing chat runtime consumers.\n */\nimport type { IChatRuntime, BackendInfo } from \"../chat/runtime.js\";\nimport type { CreateSessionOptions, SessionListOptions } from \"../chat/sessions.js\";\nimport type { ChatSession, ChatEvent, ChatIdLike, ChatMiddleware, RuntimeStatus } from \"../chat/core.js\";\nimport type { RuntimeSendOptions } from \"../chat/types.js\";\nimport type { ContextStats } from \"../chat/context.js\";\nimport type { ToolDefinition, ModelInfo } from \"../types.js\";\nimport { createChatId, toChatId } from \"../chat/core.js\";\nimport { createMockSession, createMockMessage } from \"./mock-data.js\";\n\n/** Options for createMockRuntime. */\nexport interface MockRuntimeOptions {\n  /** Default backend name. Default: \"mock\". */\n  defaultBackend?: string;\n  /** Default model. */\n  defaultModel?: string;\n  /** Pre-seeded sessions. */\n  sessions?: ChatSession[];\n  /** Models to return from listModels(). */\n  models?: ModelInfo[];\n  /** Custom send handler. When not provided, yields a single text_delta + done event. */\n  onSend?: (sessionId: ChatIdLike, message: string, options?: RuntimeSendOptions) => AsyncIterable<ChatEvent>;\n}\n\n/**\n * Create a mock IChatRuntime for testing chat UI hooks and components.\n *\n * ```ts\n * const runtime = createMockRuntime({ defaultModel: \"gpt-5-mini\" });\n * const session = await runtime.createSession({});\n * ```\n */\nexport function createMockRuntime(options: MockRuntimeOptions = {}): IChatRuntime {\n  const sessions = new Map<string, ChatSession>();\n  const tools = new Map<string, ToolDefinition>();\n  const middleware: ChatMiddleware[] = [];\n  const sessionListeners = new Set<() => void>();\n  let currentBackend = options.defaultBackend ?? \"mock\";\n  let status: RuntimeStatus = \"idle\";\n\n  // Seed initial sessions\n  for (const s of options.sessions ?? []) {\n    sessions.set(s.id, s);\n  }\n\n  function notifySessionChange() {\n    for (const cb of sessionListeners) {\n      try { cb(); } catch { /* isolated */ }\n    }\n  }\n\n  const runtime: IChatRuntime = {\n    get status() { return status; },\n    get registeredTools() { return tools as ReadonlyMap<string, ToolDefinition>; },\n\n    async createSession(opts: CreateSessionOptions): Promise<ChatSession> {\n      const session = createMockSession({\n        title: opts.title,\n        config: {\n          model: opts.config?.model ?? \"mock-model\",\n          backend: opts.config?.backend ?? currentBackend,\n          systemPrompt: opts.config?.systemPrompt,\n        },\n        metadata: opts.custom as Record<string, unknown>,\n      });\n      sessions.set(session.id, session);\n      notifySessionChange();\n      return session;\n    },\n\n    async getSession(id: ChatIdLike): Promise<ChatSession | null> {\n      return sessions.get(toChatId(String(id))) ?? null;\n    },\n\n    async listSessions(_opts?: SessionListOptions): Promise<ChatSession[]> {\n      return [...sessions.values()];\n    },\n\n    async deleteSession(id: ChatIdLike): Promise<void> {\n      sessions.delete(toChatId(String(id)));\n      notifySessionChange();\n    },\n\n    send(sessionId: ChatIdLike, message: string, sendOpts?: RuntimeSendOptions): AsyncIterable<ChatEvent> {\n      if (options.onSend) return options.onSend(sessionId, message, sendOpts);\n      // Default: yield a simple response\n      async function* defaultStream(): AsyncIterable<ChatEvent> {\n        const msgId = createChatId();\n        yield { type: \"message:start\", messageId: msgId } as ChatEvent;\n        yield { type: \"message:delta\", text: \"Mock reply\" } as ChatEvent;\n        yield { type: \"message:complete\", messageId: msgId } as ChatEvent;\n        yield { type: \"done\", finalOutput: \"Mock reply\" } as ChatEvent;\n        // Add assistant message to session\n        const session = sessions.get(toChatId(String(sessionId)));\n        if (session) {\n          session.messages.push(createMockMessage({ role: \"assistant\", text: \"Mock reply\" }));\n          session.metadata.messageCount = session.messages.length;\n        }\n        notifySessionChange();\n      }\n      return defaultStream();\n    },\n\n    abort(): void { /* no-op */ },\n\n    async listModels(): Promise<ModelInfo[]> {\n      return options.models ?? [{ id: \"mock-model\", name: \"Mock Model\" }];\n    },\n\n    async listBackends(): Promise<BackendInfo[]> {\n      return [{ name: currentBackend }];\n    },\n\n    onSessionChange(callback: () => void): () => void {\n      sessionListeners.add(callback);\n      return () => { sessionListeners.delete(callback); };\n    },\n\n    registerTool(tool: ToolDefinition): void {\n      tools.set(tool.name, tool);\n    },\n\n    removeTool(name: string): void {\n      tools.delete(name);\n    },\n\n    use(mw: ChatMiddleware): void {\n      middleware.push(mw);\n    },\n\n    removeMiddleware(mw: ChatMiddleware): void {\n      const idx = middleware.indexOf(mw);\n      if (idx >= 0) middleware.splice(idx, 1);\n    },\n\n    async getContextStats(_sessionId: ChatIdLike): Promise<ContextStats | null> {\n      return null;\n    },\n\n    async dispose(): Promise<void> {\n      status = \"disposed\";\n      sessions.clear();\n      tools.clear();\n      middleware.length = 0;\n      sessionListeners.clear();\n    },\n  };\n\n  return runtime;\n}\n","/**\n * Mock IChatClient factory for testing remote chat client consumers.\n */\nimport type { IChatClient, BackendInfo } from \"../chat/runtime.js\";\nimport type { CreateSessionOptions, SessionListOptions } from \"../chat/sessions.js\";\nimport type { ChatSession, ChatEvent, ChatId, ChatIdLike, SendMessageOptions, RuntimeStatus } from \"../chat/core.js\";\nimport type { ProviderConfig } from \"../chat/provider-types.js\";\nimport type { ModelInfo } from \"../types.js\";\nimport type { ContextStats } from \"../chat/context.js\";\nimport { createChatId, toChatId } from \"../chat/core.js\";\nimport { createMockSession, createMockMessage } from \"./mock-data.js\";\n\n/** Options for createMockChatClient. */\nexport interface MockChatClientOptions {\n  /** Pre-seeded sessions. */\n  sessions?: ChatSession[];\n  /** Models to return from listModels(). */\n  models?: ModelInfo[];\n  /** Providers to return from listProviders(). */\n  providers?: ProviderConfig[];\n  /** Custom send handler. */\n  onSend?: (sessionId: ChatIdLike, message: string, options?: SendMessageOptions) => AsyncIterable<ChatEvent>;\n}\n\n/**\n * Create a mock IChatClient for testing React hooks that talk to RemoteChatClient.\n *\n * ```ts\n * const client = createMockChatClient({ providers: [{ id: \"p1\", backend: \"copilot\", model: \"gpt-5-mini\", label: \"GPT Mini\", createdAt: \"\" }] });\n * const providers = await client.listProviders();\n * ```\n */\nexport function createMockChatClient(options: MockChatClientOptions = {}): IChatClient {\n  const sessions = new Map<string, ChatSession>();\n  const providers = new Map<string, ProviderConfig>();\n  const sessionListeners = new Set<() => void>();\n  const selectionListeners = new Set<(providerId: string | null) => void>();\n  let activeSessionId: ChatId | null = null;\n  let selectedProviderId: string | null = null;\n  let status: RuntimeStatus = \"idle\";\n\n  // Seed sessions\n  for (const s of options.sessions ?? []) {\n    sessions.set(s.id, s);\n  }\n  // Seed providers\n  for (const p of options.providers ?? []) {\n    providers.set(p.id, p);\n  }\n\n  function notifySessionChange() {\n    for (const cb of sessionListeners) {\n      try { cb(); } catch { /* isolated */ }\n    }\n  }\n\n  const client: IChatClient = {\n    get status() { return status; },\n    get activeSessionId() { return activeSessionId; },\n\n    async createSession(opts: CreateSessionOptions): Promise<ChatSession> {\n      const session = createMockSession({\n        title: opts.title,\n        config: {\n          model: opts.config?.model ?? \"mock-model\",\n          backend: opts.config?.backend ?? \"mock\",\n          systemPrompt: opts.config?.systemPrompt,\n        },\n      });\n      sessions.set(session.id, session);\n      activeSessionId = session.id;\n      notifySessionChange();\n      return session;\n    },\n\n    async getSession(id: ChatIdLike): Promise<ChatSession | null> {\n      return sessions.get(toChatId(String(id))) ?? null;\n    },\n\n    async listSessions(_opts?: SessionListOptions): Promise<ChatSession[]> {\n      return [...sessions.values()];\n    },\n\n    async deleteSession(id: ChatIdLike): Promise<void> {\n      sessions.delete(toChatId(String(id)));\n      if (activeSessionId === String(id)) activeSessionId = null;\n      notifySessionChange();\n    },\n\n    async switchSession(id: ChatIdLike): Promise<ChatSession> {\n      const session = sessions.get(toChatId(String(id)));\n      if (!session) throw new Error(`Session ${id} not found`);\n      activeSessionId = session.id;\n      return session;\n    },\n\n    send(sessionId: ChatIdLike, message: string, sendOpts?: SendMessageOptions): AsyncIterable<ChatEvent> {\n      if (options.onSend) return options.onSend(sessionId, message, sendOpts);\n      async function* defaultStream(): AsyncIterable<ChatEvent> {\n        const msgId = createChatId();\n        yield { type: \"message:start\", messageId: msgId } as ChatEvent;\n        yield { type: \"message:delta\", text: \"Mock reply\" } as ChatEvent;\n        yield { type: \"message:complete\", messageId: msgId } as ChatEvent;\n        yield { type: \"done\", finalOutput: \"Mock reply\" } as ChatEvent;\n        const session = sessions.get(toChatId(String(sessionId)));\n        if (session) {\n          session.messages.push(createMockMessage({ role: \"assistant\", text: \"Mock reply\" }));\n          session.metadata.messageCount = session.messages.length;\n        }\n        notifySessionChange();\n      }\n      return defaultStream();\n    },\n\n    abort(): void { /* no-op */ },\n\n    // ── Provider Selection ──\n    get selectedProviderId() { return selectedProviderId; },\n    selectProvider(providerId: string): void {\n      selectedProviderId = providerId;\n      for (const cb of selectionListeners) {\n        try { cb(providerId); } catch { /* isolated */ }\n      }\n    },\n    onSelectionChange(callback: (providerId: string | null) => void): () => void {\n      selectionListeners.add(callback);\n      return () => { selectionListeners.delete(callback); };\n    },\n\n    async listModels(): Promise<ModelInfo[]> {\n      return options.models ?? [{ id: \"mock-model\", name: \"Mock Model\" }];\n    },\n\n    async listBackends(): Promise<BackendInfo[]> {\n      return [{ name: \"mock\" }];\n    },\n\n    onSessionChange(callback: () => void): () => void {\n      sessionListeners.add(callback);\n      return () => { sessionListeners.delete(callback); };\n    },\n\n    async getContextStats(_sessionId: ChatIdLike): Promise<ContextStats | null> {\n      return null;\n    },\n\n    // ── Provider CRUD ──\n    async listProviders(): Promise<ProviderConfig[]> {\n      return [...providers.values()];\n    },\n\n    async createProvider(config: Omit<ProviderConfig, \"id\" | \"createdAt\">): Promise<ProviderConfig> {\n      const provider: ProviderConfig = {\n        ...config,\n        id: createChatId(),\n        createdAt: Date.now(),\n      };\n      providers.set(provider.id, provider);\n      return provider;\n    },\n\n    async updateProvider(id: string, changes: Partial<Omit<ProviderConfig, \"id\" | \"createdAt\">>): Promise<void> {\n      const existing = providers.get(id);\n      if (!existing) throw new Error(`Provider ${id} not found`);\n      providers.set(id, { ...existing, ...changes });\n    },\n\n    async deleteProvider(id: string): Promise<void> {\n      providers.delete(id);\n    },\n\n    async dispose(): Promise<void> {\n      status = \"disposed\";\n      sessions.clear();\n      providers.clear();\n      sessionListeners.clear();\n      selectionListeners.clear();\n    },\n  };\n\n  return client;\n}\n"]}