@witqq/agent-sdk 0.7.0 → 0.8.0

package/dist/chat/sqlite.cjs

@@ -0,0 +1,441 @@
+'use strict';
+
+var module$1 = require('module');
+require('fs');
+require('path');
+
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+// src/chat/sqlite/factory.ts
+
+// src/chat/types.ts
+function createChatId() {
+  return crypto.randomUUID();
+}
+
+// src/errors.ts
+var AgentSDKError = class extends Error {
+  /** @internal Marker for cross-bundle identity checks */
+  _agentSDKError = true;
+  /** Machine-readable error code. Prefer values from the ErrorCode enum. */
+  code;
+  /** Whether this error is safe to retry */
+  retryable;
+  /** HTTP status code hint for error classification */
+  httpStatus;
+  constructor(message, options) {
+    super(message, options);
+    this.name = "AgentSDKError";
+    this.code = options?.code;
+    this.retryable = options?.retryable ?? false;
+    this.httpStatus = options?.httpStatus;
+  }
+  /** Check if an error is an AgentSDKError (works across bundled copies) */
+  static is(error) {
+    return error instanceof Error && "_agentSDKError" in error && error._agentSDKError === true;
+  }
+};
+
+// src/chat/storage.ts
+var StorageError = class extends AgentSDKError {
+  /** Machine-readable error code from the unified ErrorCode enum */
+  code;
+  constructor(message, code) {
+    super(message);
+    this.name = "StorageError";
+    this.code = code;
+  }
+};
+
+// src/chat/sqlite/session-store.ts
+var CREATE_SESSIONS_TABLE = `
+  CREATE TABLE IF NOT EXISTS sessions (
+    id TEXT PRIMARY KEY,
+    title TEXT,
+    config TEXT NOT NULL,
+    metadata TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'active',
+    backend_session_id TEXT,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL
+  )
+`;
+var CREATE_MESSAGES_TABLE = `
+  CREATE TABLE IF NOT EXISTS messages (
+    id TEXT PRIMARY KEY,
+    session_id TEXT NOT NULL,
+    role TEXT NOT NULL,
+    parts TEXT NOT NULL,
+    metadata TEXT,
+    status TEXT NOT NULL DEFAULT 'complete',
+    created_at TEXT NOT NULL,
+    updated_at TEXT,
+    position INTEGER NOT NULL,
+    FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+  )
+`;
+var CREATE_MESSAGES_SESSION_IDX = `
+  CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id, position)
+`;
+var SQLiteSessionStore = class {
+  db;
+  constructor(db) {
+    this.db = db;
+    this.db.exec(CREATE_SESSIONS_TABLE);
+    this.db.exec(CREATE_MESSAGES_TABLE);
+    this.db.exec(CREATE_MESSAGES_SESSION_IDX);
+  }
+  async createSession(options = {}) {
+    const id = createChatId();
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const config = {
+      model: "default",
+      backend: "default",
+      ...options.config
+    };
+    const metadata = {
+      messageCount: 0,
+      totalTokens: 0,
+      tags: options.tags,
+      custom: options.custom
+    };
+    this.db.prepare(`
+      INSERT INTO sessions (id, title, config, metadata, status, created_at, updated_at)
+      VALUES (?, ?, ?, ?, 'active', ?, ?)
+    `).run(id, options.title ?? null, JSON.stringify(config), JSON.stringify(metadata), now, now);
+    return this.buildSession(id, options.title, config, metadata, "active", now, now, []);
+  }
+  async getSession(id) {
+    const row = this.db.prepare("SELECT * FROM sessions WHERE id = ?").get(id);
+    if (!row) return null;
+    const messages = this.loadAllMessages(row.id);
+    return this.rowToSession(row, messages);
+  }
+  async listSessions(options) {
+    const rows = this.db.prepare("SELECT * FROM sessions ORDER BY updated_at DESC").all();
+    let sessions = rows.map((r) => this.rowToSession(r, []));
+    if (options?.filter) sessions = sessions.filter(options.filter);
+    if (options?.sort) sessions.sort(options.sort);
+    if (options?.offset) sessions = sessions.slice(options.offset);
+    if (options?.limit) sessions = sessions.slice(0, options.limit);
+    return sessions;
+  }
+  async updateTitle(id, title) {
+    const result = this.db.prepare(
+      "UPDATE sessions SET title = ?, updated_at = ? WHERE id = ?"
+    ).run(title, (/* @__PURE__ */ new Date()).toISOString(), id);
+    if (result.changes === 0) throw new StorageError(`Session not found: ${id}`, "STORAGE_NOT_FOUND" /* STORAGE_NOT_FOUND */);
+  }
+  async updateConfig(id, config) {
+    const row = this.db.prepare("SELECT config FROM sessions WHERE id = ?").get(id);
+    if (!row) throw new StorageError(`Session not found: ${id}`, "STORAGE_NOT_FOUND" /* STORAGE_NOT_FOUND */);
+    const merged = { ...JSON.parse(row.config), ...config };
+    this.db.prepare(
+      "UPDATE sessions SET config = ?, updated_at = ? WHERE id = ?"
+    ).run(JSON.stringify(merged), (/* @__PURE__ */ new Date()).toISOString(), id);
+  }
+  async deleteSession(id) {
+    const result = this.db.prepare("DELETE FROM sessions WHERE id = ?").run(id);
+    if (result.changes === 0) throw new StorageError(`Session not found: ${id}`, "STORAGE_NOT_FOUND" /* STORAGE_NOT_FOUND */);
+  }
+  async appendMessage(sessionId, message) {
+    const session = this.db.prepare("SELECT id FROM sessions WHERE id = ?").get(sessionId);
+    if (!session) throw new StorageError(`Session not found: ${sessionId}`, "STORAGE_NOT_FOUND" /* STORAGE_NOT_FOUND */);
+    const position = this.getNextPosition(sessionId);
+    this.db.prepare(`
+      INSERT INTO messages (id, session_id, role, parts, metadata, status, created_at, updated_at, position)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(
+      message.id,
+      sessionId,
+      message.role,
+      JSON.stringify(message.parts),
+      message.metadata ? JSON.stringify(message.metadata) : null,
+      message.status,
+      message.createdAt,
+      message.updatedAt ?? null,
+      position
+    );
+    this.incrementMessageCount(sessionId);
+  }
+  async saveMessages(sessionId, messages) {
+    if (messages.length === 0) return;
+    const session = this.db.prepare("SELECT id FROM sessions WHERE id = ?").get(sessionId);
+    if (!session) throw new StorageError(`Session not found: ${sessionId}`, "STORAGE_NOT_FOUND" /* STORAGE_NOT_FOUND */);
+    const insertMsg = this.db.prepare(`
+      INSERT INTO messages (id, session_id, role, parts, metadata, status, created_at, updated_at, position)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+    const tx = this.db.transaction(() => {
+      let pos = this.getNextPosition(sessionId);
+      for (const msg of messages) {
+        insertMsg.run(
+          msg.id,
+          sessionId,
+          msg.role,
+          JSON.stringify(msg.parts),
+          msg.metadata ? JSON.stringify(msg.metadata) : null,
+          msg.status,
+          msg.createdAt,
+          msg.updatedAt ?? null,
+          pos++
+        );
+      }
+      this.updateSessionMeta(sessionId, messages.length);
+    });
+    tx();
+  }
+  async loadMessages(sessionId, options) {
+    const session = this.db.prepare("SELECT id FROM sessions WHERE id = ?").get(sessionId);
+    if (!session) throw new StorageError(`Session not found: ${sessionId}`, "STORAGE_NOT_FOUND" /* STORAGE_NOT_FOUND */);
+    const total = this.db.prepare(
+      "SELECT COUNT(*) as cnt FROM messages WHERE session_id = ?"
+    ).get(sessionId).cnt;
+    const limit = options?.limit ?? 50;
+    const offset = options?.offset ?? 0;
+    const rows = this.db.prepare(
+      "SELECT * FROM messages WHERE session_id = ? ORDER BY position ASC LIMIT ? OFFSET ?"
+    ).all(sessionId, limit, offset);
+    return {
+      messages: rows.map(rowToMessage),
+      total,
+      hasMore: offset + limit < total
+    };
+  }
+  async searchSessions(options) {
+    const pattern = `%${options.query}%`;
+    const limit = options.limit ?? 20;
+    const titleMatches = this.db.prepare(
+      "SELECT * FROM sessions WHERE title LIKE ? COLLATE NOCASE LIMIT ?"
+    ).all(pattern, limit);
+    const contentMatches = this.db.prepare(`
+      SELECT DISTINCT s.* FROM sessions s
+      JOIN messages m ON m.session_id = s.id
+      WHERE m.parts LIKE ? COLLATE NOCASE
+      LIMIT ?
+    `).all(pattern, limit);
+    const seen = /* @__PURE__ */ new Set();
+    const results = [];
+    for (const row of [...titleMatches, ...contentMatches]) {
+      if (!seen.has(row.id)) {
+        seen.add(row.id);
+        results.push(this.rowToSession(row, []));
+      }
+    }
+    return results.slice(0, limit);
+  }
+  async count() {
+    return this.db.prepare("SELECT COUNT(*) as cnt FROM sessions").get().cnt;
+  }
+  async clear() {
+    this.db.exec("DELETE FROM messages");
+    this.db.exec("DELETE FROM sessions");
+  }
+  // ─── Private Helpers ─────────────────────────────────────────
+  getNextPosition(sessionId) {
+    const result = this.db.prepare(
+      "SELECT MAX(position) as maxPos FROM messages WHERE session_id = ?"
+    ).get(sessionId);
+    return (result.maxPos ?? -1) + 1;
+  }
+  incrementMessageCount(sessionId) {
+    this.db.prepare(`
+      UPDATE sessions
+      SET metadata = json_set(metadata, '$.messageCount', json_extract(metadata, '$.messageCount') + 1),
+          updated_at = ?
+      WHERE id = ?
+    `).run((/* @__PURE__ */ new Date()).toISOString(), sessionId);
+  }
+  updateSessionMeta(sessionId, addedCount) {
+    this.db.prepare(`
+      UPDATE sessions
+      SET metadata = json_set(metadata, '$.messageCount', json_extract(metadata, '$.messageCount') + ?),
+          updated_at = ?
+      WHERE id = ?
+    `).run(addedCount, (/* @__PURE__ */ new Date()).toISOString(), sessionId);
+  }
+  loadAllMessages(sessionId) {
+    const rows = this.db.prepare(
+      "SELECT * FROM messages WHERE session_id = ? ORDER BY position ASC"
+    ).all(sessionId);
+    return rows.map(rowToMessage);
+  }
+  rowToSession(row, messages) {
+    return this.buildSession(
+      row.id,
+      row.title,
+      JSON.parse(row.config),
+      JSON.parse(row.metadata),
+      row.status,
+      row.created_at,
+      row.updated_at,
+      messages
+    );
+  }
+  buildSession(id, title, config, metadata, status, createdAt, updatedAt, messages) {
+    return {
+      id,
+      title: title ?? void 0,
+      messages,
+      config,
+      metadata,
+      status,
+      createdAt,
+      updatedAt
+    };
+  }
+};
+function rowToMessage(row) {
+  return {
+    id: row.id,
+    role: row.role,
+    parts: JSON.parse(row.parts),
+    metadata: row.metadata ? JSON.parse(row.metadata) : void 0,
+    status: row.status,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at ?? void 0
+  };
+}
+
+// src/chat/sqlite/provider-store.ts
+var CREATE_PROVIDERS_TABLE = `
+  CREATE TABLE IF NOT EXISTS providers (
+    id TEXT PRIMARY KEY,
+    backend TEXT NOT NULL,
+    model TEXT NOT NULL,
+    label TEXT NOT NULL,
+    created_at INTEGER NOT NULL
+  )
+`;
+var SQLiteProviderStore = class {
+  db;
+  constructor(db) {
+    this.db = db;
+    this.db.exec(CREATE_PROVIDERS_TABLE);
+  }
+  async create(config) {
+    this.db.prepare(`
+      INSERT INTO providers (id, backend, model, label, created_at)
+      VALUES (?, ?, ?, ?, ?)
+    `).run(config.id, config.backend, config.model, config.label, config.createdAt);
+  }
+  async get(id) {
+    const row = this.db.prepare("SELECT * FROM providers WHERE id = ?").get(id);
+    return row ? rowToProvider(row) : null;
+  }
+  async update(id, changes) {
+    const existing = this.db.prepare("SELECT id FROM providers WHERE id = ?").get(id);
+    if (!existing) throw new Error(`Provider "${id}" not found`);
+    const sets = [];
+    const values = [];
+    if (changes.backend !== void 0) {
+      sets.push("backend = ?");
+      values.push(changes.backend);
+    }
+    if (changes.model !== void 0) {
+      sets.push("model = ?");
+      values.push(changes.model);
+    }
+    if (changes.label !== void 0) {
+      sets.push("label = ?");
+      values.push(changes.label);
+    }
+    if (sets.length > 0) {
+      values.push(id);
+      this.db.prepare(`UPDATE providers SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+    }
+  }
+  async delete(id) {
+    this.db.prepare("DELETE FROM providers WHERE id = ?").run(id);
+  }
+  async list() {
+    const rows = this.db.prepare("SELECT * FROM providers ORDER BY created_at ASC").all();
+    return rows.map(rowToProvider);
+  }
+};
+function rowToProvider(row) {
+  return {
+    id: row.id,
+    backend: row.backend,
+    model: row.model,
+    label: row.label,
+    createdAt: row.created_at
+  };
+}
+
+// src/chat/sqlite/token-store.ts
+var CREATE_TOKENS_TABLE = `
+  CREATE TABLE IF NOT EXISTS tokens (
+    provider TEXT PRIMARY KEY,
+    token_json TEXT NOT NULL,
+    saved_at INTEGER NOT NULL
+  )
+`;
+var SQLiteTokenStore = class {
+  db;
+  constructor(db) {
+    this.db = db;
+    this.db.exec(CREATE_TOKENS_TABLE);
+  }
+  async save(provider, token) {
+    this.db.prepare(`
+      INSERT OR REPLACE INTO tokens (provider, token_json, saved_at)
+      VALUES (?, ?, ?)
+    `).run(provider, JSON.stringify(token), Date.now());
+  }
+  async load(provider) {
+    const row = this.db.prepare("SELECT token_json FROM tokens WHERE provider = ?").get(provider);
+    return row ? JSON.parse(row.token_json) : null;
+  }
+  async clear(provider) {
+    this.db.prepare("DELETE FROM tokens WHERE provider = ?").run(provider);
+  }
+  async clearAll() {
+    this.db.exec("DELETE FROM tokens");
+  }
+  async list() {
+    const rows = this.db.prepare("SELECT provider FROM tokens ORDER BY saved_at ASC").all();
+    return rows.map((r) => r.provider);
+  }
+};
+
+// src/chat/sqlite/factory.ts
+function createSQLiteStorage(pathOrOptions) {
+  let db;
+  if (typeof pathOrOptions === "string") {
+    db = createDatabase(pathOrOptions);
+  } else if (pathOrOptions.db) {
+    db = pathOrOptions.db;
+  } else {
+    db = createDatabase(pathOrOptions.dbPath);
+  }
+  db.pragma("journal_mode = WAL");
+  db.pragma("foreign_keys = ON");
+  return {
+    db,
+    sessionStore: new SQLiteSessionStore(db),
+    providerStore: new SQLiteProviderStore(db),
+    tokenStore: new SQLiteTokenStore(db)
+  };
+}
+function createDatabase(dbPath) {
+  try {
+    const esmRequire = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('sqlite.cjs', document.baseURI).href)));
+    const BetterSqlite3 = esmRequire("better-sqlite3");
+    return new BetterSqlite3(dbPath);
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (message.includes("Cannot find module") || message.includes("MODULE_NOT_FOUND")) {
+      throw new Error(
+        "better-sqlite3 is required for SQLite storage. Install it: npm install better-sqlite3"
+      );
+    }
+    throw err;
+  }
+}
+
+exports.SQLiteProviderStore = SQLiteProviderStore;
+exports.SQLiteSessionStore = SQLiteSessionStore;
+exports.SQLiteTokenStore = SQLiteTokenStore;
+exports.createSQLiteStorage = createSQLiteStorage;
+//# sourceMappingURL=sqlite.cjs.map
+//# sourceMappingURL=sqlite.cjs.map

package/dist/chat/sqlite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/chat/types.ts","../../src/errors.ts","../../src/chat/storage.ts","../../src/chat/sqlite/session-store.ts","../../src/chat/sqlite/provider-store.ts","../../src/chat/sqlite/token-store.ts","../../src/chat/sqlite/factory.ts"],"names":["createRequire"],"mappings":"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","file":"sqlite.cjs","sourcesContent":["/**\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","import { ErrorCode } from \"./types/errors.js\";\n\n/** Options for constructing an AgentSDKError */\nexport interface AgentSDKErrorOptions extends ErrorOptions {\n  /** Machine-readable error code */\n  code?: string;\n  /** Whether this error is retryable (default: false) */\n  retryable?: boolean;\n  /** HTTP status code hint (e.g. 401, 429, 500) */\n  httpStatus?: number;\n}\n\n/** Base error class for agent-sdk.\n *\n * Use `AgentSDKError.is(err)` for reliable cross-module `instanceof` checks\n * (works across separately bundled entry points where `instanceof` may fail). */\nexport class AgentSDKError extends Error {\n  /** @internal Marker for cross-bundle identity checks */\n  readonly _agentSDKError = true as const;\n  /** Machine-readable error code. Prefer values from the ErrorCode enum. */\n  readonly code?: string;\n  /** Whether this error is safe to retry */\n  readonly retryable: boolean;\n  /** HTTP status code hint for error classification */\n  readonly httpStatus?: number;\n\n  constructor(message: string, options?: AgentSDKErrorOptions) {\n    super(message, options);\n    this.name = \"AgentSDKError\";\n    this.code = options?.code;\n    this.retryable = options?.retryable ?? false;\n    this.httpStatus = options?.httpStatus;\n  }\n\n  /** Check if an error is an AgentSDKError (works across bundled copies) */\n  static is(error: unknown): error is AgentSDKError {\n    return (\n      error instanceof Error &&\n      \"_agentSDKError\" in error &&\n      (error as AgentSDKError)._agentSDKError === true\n    );\n  }\n}\n\n/** Thrown when agent.run() is called while already running (M8 re-entrancy guard) */\nexport class ReentrancyError extends AgentSDKError {\n  constructor() {\n    super(\"Agent is already running. Await the current run before starting another.\", {\n      code: ErrorCode.REENTRANCY,\n    });\n    this.name = \"ReentrancyError\";\n  }\n}\n\n/** Thrown when an operation is attempted on a disposed agent/service */\nexport class DisposedError extends AgentSDKError {\n  constructor(entity: string) {\n    super(`${entity} has been disposed and cannot be used.`, {\n      code: ErrorCode.DISPOSED,\n    });\n    this.name = \"DisposedError\";\n  }\n}\n\n/** Thrown when a backend is not found in the registry */\nexport class BackendNotFoundError extends AgentSDKError {\n  constructor(backend: string) {\n    super(\n      `Unknown backend: \"${backend}\". ` +\n      `Built-in: copilot, claude, vercel-ai. ` +\n      `Custom: use registerBackend() first.`,\n      { code: ErrorCode.BACKEND_NOT_INSTALLED },\n    );\n    this.name = \"BackendNotFoundError\";\n  }\n}\n\n/** Thrown when a backend is already registered */\nexport class BackendAlreadyRegisteredError extends AgentSDKError {\n  constructor(backend: string) {\n    super(`Backend \"${backend}\" is already registered. Use a different name or unregister first.`);\n    this.name = \"BackendAlreadyRegisteredError\";\n  }\n}\n\n/** Thrown when subprocess management fails */\nexport class SubprocessError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, { ...options, code: ErrorCode.DEPENDENCY_MISSING });\n    this.name = \"SubprocessError\";\n  }\n}\n\n/** Thrown when a required peer dependency is not installed */\nexport class DependencyError extends AgentSDKError {\n  public readonly packageName: string;\n\n  constructor(packageName: string) {\n    super(`${packageName} is not installed. Install it: npm install ${packageName}`, {\n      code: ErrorCode.DEPENDENCY_MISSING,\n    });\n    this.name = \"DependencyError\";\n    this.packageName = packageName;\n  }\n}\n\n/** Thrown when an agent run is aborted */\nexport class AbortError extends AgentSDKError {\n  constructor() {\n    super(\"Agent run was aborted.\", { code: ErrorCode.ABORTED });\n    this.name = \"AbortError\";\n  }\n}\n\n/** Thrown when a tool execution fails */\nexport class ToolExecutionError extends AgentSDKError {\n  public readonly toolName: string;\n\n  constructor(toolName: string, message: string, options?: ErrorOptions) {\n    super(`Tool \"${toolName}\" failed: ${message}`, { ...options, code: ErrorCode.TOOL_EXECUTION });\n    this.name = \"ToolExecutionError\";\n    this.toolName = toolName;\n  }\n}\n\n/** Thrown when a stream has no activity within the configured timeout */\nexport class ActivityTimeoutError extends AgentSDKError {\n  constructor(timeoutMs: number) {\n    super(`Stream activity timeout: no event received within ${timeoutMs}ms.`, {\n      code: ErrorCode.TIMEOUT,\n      retryable: true,\n    });\n    this.name = \"ActivityTimeoutError\";\n  }\n}\n\n/** Thrown when structured output parsing fails */\nexport class StructuredOutputError extends AgentSDKError {\n  constructor(message: string, options?: ErrorOptions) {\n    super(`Structured output error: ${message}`, { ...options, code: ErrorCode.INVALID_RESPONSE });\n    this.name = \"StructuredOutputError\";\n  }\n}\n","/**\n * @witqq/agent-sdk/chat/storage\n *\n * Generic storage adapter layer with pluggable backends.\n * Provides CRUD operations for any data type via `IStorageAdapter<T>`.\n * Implementations: `InMemoryStorage` (Map-based) and `FileStorage` (JSON files).\n */\n\nimport { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { AgentSDKError } from \"../errors.js\";\nimport { ErrorCode } from \"../types/errors.js\";\n\n// ─── Storage Errors ────────────────────────────────────────────\n\n/**\n * Error thrown by storage operations.\n *\n * @example\n * ```typescript\n * try {\n *   await store.get(\"missing-id\");\n * } catch (e) {\n *   if (e instanceof StorageError && e.code === ErrorCode.STORAGE_NOT_FOUND) {\n *     // handle missing item\n *   }\n * }\n * ```\n */\nexport class StorageError extends AgentSDKError {\n  /** Machine-readable error code from the unified ErrorCode enum */\n  readonly code: StorageErrorCode;\n\n  constructor(message: string, code: StorageErrorCode) {\n    super(message);\n    this.name = \"StorageError\";\n    this.code = code;\n  }\n}\n\n/** Storage-specific subset of ErrorCode */\nexport type StorageErrorCode =\n  | ErrorCode.STORAGE_NOT_FOUND\n  | ErrorCode.STORAGE_DUPLICATE_KEY\n  | ErrorCode.STORAGE_IO_ERROR\n  | ErrorCode.STORAGE_SERIALIZATION_ERROR;\n\n// ─── Storage Adapter Interface ─────────────────────────────────\n\n/**\n * Options for listing stored items.\n *\n * @typeParam T - The type of stored items\n */\nexport interface ListOptions<T> {\n  /** Filter predicate — return `true` to include the item */\n  filter?: (item: T) => boolean;\n  /** Sort comparator — standard Array.sort semantics */\n  sort?: (a: T, b: T) => number;\n  /** Maximum number of items to return */\n  limit?: number;\n  /** Number of items to skip (for pagination) */\n  offset?: number;\n}\n\n/**\n * Generic storage adapter for CRUD operations on any data type.\n * Items are identified by a string key.\n *\n * @typeParam T - The type of stored items\n *\n * @example\n * ```typescript\n * const store: IStorageAdapter<{ name: string }> = new InMemoryStorage();\n * await store.create(\"key1\", { name: \"Alice\" });\n * const item = await store.get(\"key1\"); // { name: \"Alice\" }\n * ```\n */\nexport interface IStorageAdapter<T> {\n  /**\n   * Retrieve an item by key.\n   * @param key - Unique identifier\n   * @returns The item, or `null` if not found\n   */\n  get(key: string): Promise<T | null>;\n\n  /**\n   * List items with optional filtering, sorting, and pagination.\n   * @param options - Filter, sort, limit, offset options\n   * @returns Array of matching items\n   */\n  list(options?: ListOptions<T>): Promise<T[]>;\n\n  /**\n   * Create a new item. Throws `StorageError` with code `DUPLICATE_KEY` if key exists.\n   * @param key - Unique identifier\n   * @param item - Data to store\n   */\n  create(key: string, item: T): Promise<void>;\n\n  /**\n   * Update an existing item. Throws `StorageError` with code `NOT_FOUND` if key missing.\n   * @param key - Unique identifier\n   * @param item - Updated data\n   */\n  update(key: string, item: T): Promise<void>;\n\n  /**\n   * Delete an item by key. Throws `StorageError` with code `NOT_FOUND` if key missing.\n   * @param key - Unique identifier\n   */\n  delete(key: string): Promise<void>;\n\n  /**\n   * Check whether a key exists.\n   * @param key - Unique identifier\n   * @returns `true` if key exists\n   */\n  has(key: string): Promise<boolean>;\n\n  /**\n   * Return the number of stored items.\n   * @returns Count of items\n   */\n  count(): Promise<number>;\n\n  /**\n   * Remove all items from storage.\n   */\n  clear(): Promise<void>;\n\n  /**\n   * Release any resources held by this adapter (DB connections, file handles).\n   * Optional — adapters that don't hold resources need not implement this.\n   */\n  dispose?(): Promise<void>;\n}\n\n// ─── InMemoryStorage ───────────────────────────────────────────\n\n/**\n * In-memory storage adapter backed by a `Map`.\n * Suitable for development, testing, and short-lived processes.\n * Data is lost when the process exits.\n *\n * @typeParam T - The type of stored items\n *\n * @example\n * ```typescript\n * const store = new InMemoryStorage<{ name: string }>();\n * await store.create(\"k1\", { name: \"Alice\" });\n * await store.create(\"k2\", { name: \"Bob\" });\n * const items = await store.list({ filter: i => i.name.startsWith(\"A\") });\n * // [{ name: \"Alice\" }]\n * ```\n */\nexport class InMemoryStorage<T> implements IStorageAdapter<T> {\n  private readonly data = new Map<string, T>();\n\n  /** @inheritdoc */\n  async get(key: string): Promise<T | null> {\n    const item = this.data.get(key);\n    return item !== undefined ? structuredClone(item) : null;\n  }\n\n  /** @inheritdoc */\n  async list(options?: ListOptions<T>): Promise<T[]> {\n    let items = Array.from(this.data.values()).map((item) => structuredClone(item));\n\n    if (options?.filter) {\n      items = items.filter(options.filter);\n    }\n    if (options?.sort) {\n      items.sort(options.sort);\n    }\n    if (options?.offset !== undefined) {\n      items = items.slice(options.offset);\n    }\n    if (options?.limit !== undefined) {\n      items = items.slice(0, options.limit);\n    }\n\n    return items;\n  }\n\n  /** @inheritdoc */\n  async create(key: string, item: T): Promise<void> {\n    if (this.data.has(key)) {\n      throw new StorageError(\n        `Item with key \"${key}\" already exists`,\n        ErrorCode.STORAGE_DUPLICATE_KEY,\n      );\n    }\n    this.data.set(key, structuredClone(item));\n  }\n\n  /** @inheritdoc */\n  async update(key: string, item: T): Promise<void> {\n    if (!this.data.has(key)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        ErrorCode.STORAGE_NOT_FOUND,\n      );\n    }\n    this.data.set(key, structuredClone(item));\n  }\n\n  /** @inheritdoc */\n  async delete(key: string): Promise<void> {\n    if (!this.data.has(key)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        ErrorCode.STORAGE_NOT_FOUND,\n      );\n    }\n    this.data.delete(key);\n  }\n\n  /** @inheritdoc */\n  async has(key: string): Promise<boolean> {\n    return this.data.has(key);\n  }\n\n  /** @inheritdoc */\n  async count(): Promise<number> {\n    return this.data.size;\n  }\n\n  /** @inheritdoc */\n  async clear(): Promise<void> {\n    this.data.clear();\n  }\n}\n\n// ─── FileStorage ───────────────────────────────────────────────\n\n/**\n * Options for configuring `FileStorage`.\n */\nexport interface FileStorageOptions {\n  /** Directory path where JSON files are stored */\n  directory: string;\n  /** File extension (default: `.json`) */\n  extension?: string;\n}\n\n/**\n * File-based storage adapter that persists each item as a JSON file.\n * Suitable for local applications, CLI tools, and development.\n * Creates the storage directory if it doesn't exist.\n *\n * @typeParam T - The type of stored items (must be JSON-serializable)\n *\n * @example\n * ```typescript\n * const store = new FileStorage<ChatSession>({\n *   directory: \"./data/sessions\",\n * });\n * await store.create(\"session-1\", mySession);\n * ```\n */\nexport class FileStorage<T> implements IStorageAdapter<T> {\n  private readonly directory: string;\n  private readonly extension: string;\n\n  constructor(options: FileStorageOptions) {\n    this.directory = options.directory;\n    this.extension = options.extension ?? \".json\";\n    this.ensureDirectory();\n  }\n\n  /** @inheritdoc */\n  async get(key: string): Promise<T | null> {\n    const filePath = this.keyToPath(key);\n    if (!existsSync(filePath)) {\n      return null;\n    }\n    return this.readFile(filePath);\n  }\n\n  /** @inheritdoc */\n  async list(options?: ListOptions<T>): Promise<T[]> {\n    this.ensureDirectory();\n    const files = readdirSync(this.directory).filter((f) =>\n      f.endsWith(this.extension),\n    );\n\n    let items: T[] = [];\n    for (const file of files) {\n      const item = this.readFile(join(this.directory, file));\n      items.push(item);\n    }\n\n    if (options?.filter) {\n      items = items.filter(options.filter);\n    }\n    if (options?.sort) {\n      items.sort(options.sort);\n    }\n    if (options?.offset !== undefined) {\n      items = items.slice(options.offset);\n    }\n    if (options?.limit !== undefined) {\n      items = items.slice(0, options.limit);\n    }\n\n    return items;\n  }\n\n  /** @inheritdoc */\n  async create(key: string, item: T): Promise<void> {\n    const filePath = this.keyToPath(key);\n    if (existsSync(filePath)) {\n      throw new StorageError(\n        `Item with key \"${key}\" already exists`,\n        ErrorCode.STORAGE_DUPLICATE_KEY,\n      );\n    }\n    this.writeFile(filePath, item);\n  }\n\n  /** @inheritdoc */\n  async update(key: string, item: T): Promise<void> {\n    const filePath = this.keyToPath(key);\n    if (!existsSync(filePath)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        ErrorCode.STORAGE_NOT_FOUND,\n      );\n    }\n    this.writeFile(filePath, item);\n  }\n\n  /** @inheritdoc */\n  async delete(key: string): Promise<void> {\n    const filePath = this.keyToPath(key);\n    if (!existsSync(filePath)) {\n      throw new StorageError(\n        `Item with key \"${key}\" not found`,\n        ErrorCode.STORAGE_NOT_FOUND,\n      );\n    }\n    unlinkSync(filePath);\n  }\n\n  /** @inheritdoc */\n  async has(key: string): Promise<boolean> {\n    return existsSync(this.keyToPath(key));\n  }\n\n  /** @inheritdoc */\n  async count(): Promise<number> {\n    this.ensureDirectory();\n    return readdirSync(this.directory).filter((f) =>\n      f.endsWith(this.extension),\n    ).length;\n  }\n\n  /** @inheritdoc */\n  async clear(): Promise<void> {\n    this.ensureDirectory();\n    const files = readdirSync(this.directory).filter((f) =>\n      f.endsWith(this.extension),\n    );\n    for (const file of files) {\n      unlinkSync(join(this.directory, file));\n    }\n  }\n\n  private keyToPath(key: string): string {\n    const safeKey = key.replace(/[^a-zA-Z0-9_-]/g, (c) =>\n      \"%\" + c.charCodeAt(0).toString(16).padStart(2, \"0\"),\n    );\n    return join(this.directory, `${safeKey}${this.extension}`);\n  }\n\n  private ensureDirectory(): void {\n    if (!existsSync(this.directory)) {\n      mkdirSync(this.directory, { recursive: true });\n    }\n  }\n\n  private readFile(filePath: string): T {\n    try {\n      const content = readFileSync(filePath, \"utf-8\");\n      return JSON.parse(content) as T;\n    } catch (error) {\n      if (error instanceof SyntaxError) {\n        throw new StorageError(\n          `Failed to parse file: ${filePath}`,\n          ErrorCode.STORAGE_SERIALIZATION_ERROR,\n        );\n      }\n      throw new StorageError(\n        `Failed to read file: ${filePath}`,\n        ErrorCode.STORAGE_IO_ERROR,\n      );\n    }\n  }\n\n  private writeFile(filePath: string, item: T): void {\n    try {\n      const content = JSON.stringify(item, null, 2);\n      writeFileSync(filePath, content, \"utf-8\");\n    } catch {\n      throw new StorageError(\n        `Failed to write file: ${filePath}`,\n        ErrorCode.STORAGE_IO_ERROR,\n      );\n    }\n  }\n}\n","/**\n * SQLite-backed session store implementing IChatSessionStore.\n *\n * Uses better-sqlite3 for synchronous database access wrapped in\n * async interface. Messages are stored with position ordering for\n * deterministic retrieval. Parts and metadata are JSON-serialized.\n *\n * Accepts a shared Database instance — multiple stores can share\n * a single SQLite file via the factory function.\n */\n\nimport type Database from \"better-sqlite3\";\nimport type { ChatSession, ChatMessage, ChatId, ChatSessionConfig, SessionStatus } from \"../core.js\";\nimport { createChatId } from \"../core.js\";\nimport type {\n  IChatSessionStore,\n  CreateSessionOptions,\n  PaginatedMessages,\n  SessionListOptions,\n  SessionSearchOptions,\n} from \"../sessions.js\";\nimport { StorageError } from \"../storage.js\";\nimport { ErrorCode } from \"../../types/errors.js\";\n\n// ─── Schema ────────────────────────────────────────────────────\n\nconst CREATE_SESSIONS_TABLE = `\n  CREATE TABLE IF NOT EXISTS sessions (\n    id TEXT PRIMARY KEY,\n    title TEXT,\n    config TEXT NOT NULL,\n    metadata TEXT NOT NULL,\n    status TEXT NOT NULL DEFAULT 'active',\n    backend_session_id TEXT,\n    created_at TEXT NOT NULL,\n    updated_at TEXT NOT NULL\n  )\n`;\n\nconst CREATE_MESSAGES_TABLE = `\n  CREATE TABLE IF NOT EXISTS messages (\n    id TEXT PRIMARY KEY,\n    session_id TEXT NOT NULL,\n    role TEXT NOT NULL,\n    parts TEXT NOT NULL,\n    metadata TEXT,\n    status TEXT NOT NULL DEFAULT 'complete',\n    created_at TEXT NOT NULL,\n    updated_at TEXT,\n    position INTEGER NOT NULL,\n    FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE\n  )\n`;\n\nconst CREATE_MESSAGES_SESSION_IDX = `\n  CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id, position)\n`;\n\n// ─── SQLiteSessionStore ────────────────────────────────────────\n\nexport class SQLiteSessionStore implements IChatSessionStore {\n  private readonly db: Database.Database;\n\n  constructor(db: Database.Database) {\n    this.db = db;\n    this.db.exec(CREATE_SESSIONS_TABLE);\n    this.db.exec(CREATE_MESSAGES_TABLE);\n    this.db.exec(CREATE_MESSAGES_SESSION_IDX);\n  }\n\n  async createSession(options: CreateSessionOptions = {}): Promise<ChatSession> {\n    const id = createChatId();\n    const now = new Date().toISOString();\n    const config: ChatSessionConfig = {\n      model: \"default\",\n      backend: \"default\",\n      ...options.config,\n    };\n    const metadata = {\n      messageCount: 0,\n      totalTokens: 0,\n      tags: options.tags,\n      custom: options.custom,\n    };\n\n    this.db.prepare(`\n      INSERT INTO sessions (id, title, config, metadata, status, created_at, updated_at)\n      VALUES (?, ?, ?, ?, 'active', ?, ?)\n    `).run(id, options.title ?? null, JSON.stringify(config), JSON.stringify(metadata), now, now);\n\n    return this.buildSession(id, options.title, config, metadata, \"active\", now, now, []);\n  }\n\n  async getSession(id: ChatId): Promise<ChatSession | null> {\n    const row = this.db.prepare(\"SELECT * FROM sessions WHERE id = ?\").get(id) as SessionRow | undefined;\n    if (!row) return null;\n\n    const messages = this.loadAllMessages(row.id);\n    return this.rowToSession(row, messages);\n  }\n\n  async listSessions(options?: SessionListOptions): Promise<ChatSession[]> {\n    const rows = this.db.prepare(\"SELECT * FROM sessions ORDER BY updated_at DESC\").all() as SessionRow[];\n\n    let sessions = rows.map((r) => this.rowToSession(r, []));\n\n    if (options?.filter) sessions = sessions.filter(options.filter);\n    if (options?.sort) sessions.sort(options.sort);\n    if (options?.offset) sessions = sessions.slice(options.offset);\n    if (options?.limit) sessions = sessions.slice(0, options.limit);\n\n    return sessions;\n  }\n\n  async updateTitle(id: ChatId, title: string): Promise<void> {\n    const result = this.db.prepare(\n      \"UPDATE sessions SET title = ?, updated_at = ? WHERE id = ?\",\n    ).run(title, new Date().toISOString(), id);\n    if (result.changes === 0) throw new StorageError(`Session not found: ${id}`, ErrorCode.STORAGE_NOT_FOUND);\n  }\n\n  async updateConfig(id: ChatId, config: Partial<ChatSessionConfig>): Promise<void> {\n    const row = this.db.prepare(\"SELECT config FROM sessions WHERE id = ?\").get(id) as { config: string } | undefined;\n    if (!row) throw new StorageError(`Session not found: ${id}`, ErrorCode.STORAGE_NOT_FOUND);\n\n    const merged = { ...JSON.parse(row.config), ...config };\n    this.db.prepare(\n      \"UPDATE sessions SET config = ?, updated_at = ? WHERE id = ?\",\n    ).run(JSON.stringify(merged), new Date().toISOString(), id);\n  }\n\n  async deleteSession(id: ChatId): Promise<void> {\n    const result = this.db.prepare(\"DELETE FROM sessions WHERE id = ?\").run(id);\n    if (result.changes === 0) throw new StorageError(`Session not found: ${id}`, ErrorCode.STORAGE_NOT_FOUND);\n  }\n\n  async appendMessage(sessionId: ChatId, message: ChatMessage): Promise<void> {\n    const session = this.db.prepare(\"SELECT id FROM sessions WHERE id = ?\").get(sessionId) as { id: string } | undefined;\n    if (!session) throw new StorageError(`Session not found: ${sessionId}`, ErrorCode.STORAGE_NOT_FOUND);\n\n    const position = this.getNextPosition(sessionId);\n\n    this.db.prepare(`\n      INSERT INTO messages (id, session_id, role, parts, metadata, status, created_at, updated_at, position)\n      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n    `).run(\n      message.id,\n      sessionId,\n      message.role,\n      JSON.stringify(message.parts),\n      message.metadata ? JSON.stringify(message.metadata) : null,\n      message.status,\n      message.createdAt,\n      message.updatedAt ?? null,\n      position,\n    );\n\n    this.incrementMessageCount(sessionId);\n  }\n\n  async saveMessages(sessionId: ChatId, messages: ChatMessage[]): Promise<void> {\n    if (messages.length === 0) return;\n\n    const session = this.db.prepare(\"SELECT id FROM sessions WHERE id = ?\").get(sessionId) as { id: string } | undefined;\n    if (!session) throw new StorageError(`Session not found: ${sessionId}`, ErrorCode.STORAGE_NOT_FOUND);\n\n    const insertMsg = this.db.prepare(`\n      INSERT INTO messages (id, session_id, role, parts, metadata, status, created_at, updated_at, position)\n      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)\n    `);\n\n    const tx = this.db.transaction(() => {\n      let pos = this.getNextPosition(sessionId);\n      for (const msg of messages) {\n        insertMsg.run(\n          msg.id, sessionId, msg.role,\n          JSON.stringify(msg.parts),\n          msg.metadata ? JSON.stringify(msg.metadata) : null,\n          msg.status, msg.createdAt, msg.updatedAt ?? null, pos++,\n        );\n      }\n      this.updateSessionMeta(sessionId, messages.length);\n    });\n    tx();\n  }\n\n  async loadMessages(\n    sessionId: ChatId,\n    options?: { limit?: number; offset?: number },\n  ): Promise<PaginatedMessages> {\n    const session = this.db.prepare(\"SELECT id FROM sessions WHERE id = ?\").get(sessionId) as { id: string } | undefined;\n    if (!session) throw new StorageError(`Session not found: ${sessionId}`, ErrorCode.STORAGE_NOT_FOUND);\n\n    const total = (this.db.prepare(\n      \"SELECT COUNT(*) as cnt FROM messages WHERE session_id = ?\",\n    ).get(sessionId) as { cnt: number }).cnt;\n\n    const limit = options?.limit ?? 50;\n    const offset = options?.offset ?? 0;\n\n    const rows = this.db.prepare(\n      \"SELECT * FROM messages WHERE session_id = ? ORDER BY position ASC LIMIT ? OFFSET ?\",\n    ).all(sessionId, limit, offset) as MessageRow[];\n\n    return {\n      messages: rows.map(rowToMessage),\n      total,\n      hasMore: offset + limit < total,\n    };\n  }\n\n  async searchSessions(options: SessionSearchOptions): Promise<ChatSession[]> {\n    const pattern = `%${options.query}%`;\n    const limit = options.limit ?? 20;\n\n    const titleMatches = this.db.prepare(\n      \"SELECT * FROM sessions WHERE title LIKE ? COLLATE NOCASE LIMIT ?\",\n    ).all(pattern, limit) as SessionRow[];\n\n    const contentMatches = this.db.prepare(`\n      SELECT DISTINCT s.* FROM sessions s\n      JOIN messages m ON m.session_id = s.id\n      WHERE m.parts LIKE ? COLLATE NOCASE\n      LIMIT ?\n    `).all(pattern, limit) as SessionRow[];\n\n    const seen = new Set<string>();\n    const results: ChatSession[] = [];\n    for (const row of [...titleMatches, ...contentMatches]) {\n      if (!seen.has(row.id)) {\n        seen.add(row.id);\n        results.push(this.rowToSession(row, []));\n      }\n    }\n\n    return results.slice(0, limit);\n  }\n\n  async count(): Promise<number> {\n    return (this.db.prepare(\"SELECT COUNT(*) as cnt FROM sessions\").get() as { cnt: number }).cnt;\n  }\n\n  async clear(): Promise<void> {\n    this.db.exec(\"DELETE FROM messages\");\n    this.db.exec(\"DELETE FROM sessions\");\n  }\n\n  // ─── Private Helpers ─────────────────────────────────────────\n\n  private getNextPosition(sessionId: string): number {\n    const result = this.db.prepare(\n      \"SELECT MAX(position) as maxPos FROM messages WHERE session_id = ?\",\n    ).get(sessionId) as { maxPos: number | null };\n    return (result.maxPos ?? -1) + 1;\n  }\n\n  private incrementMessageCount(sessionId: string): void {\n    this.db.prepare(`\n      UPDATE sessions\n      SET metadata = json_set(metadata, '$.messageCount', json_extract(metadata, '$.messageCount') + 1),\n          updated_at = ?\n      WHERE id = ?\n    `).run(new Date().toISOString(), sessionId);\n  }\n\n  private updateSessionMeta(sessionId: string, addedCount: number): void {\n    this.db.prepare(`\n      UPDATE sessions\n      SET metadata = json_set(metadata, '$.messageCount', json_extract(metadata, '$.messageCount') + ?),\n          updated_at = ?\n      WHERE id = ?\n    `).run(addedCount, new Date().toISOString(), sessionId);\n  }\n\n  private loadAllMessages(sessionId: string): ChatMessage[] {\n    const rows = this.db.prepare(\n      \"SELECT * FROM messages WHERE session_id = ? ORDER BY position ASC\",\n    ).all(sessionId) as MessageRow[];\n    return rows.map(rowToMessage);\n  }\n\n  private rowToSession(row: SessionRow, messages: ChatMessage[]): ChatSession {\n    return this.buildSession(\n      row.id as ChatId,\n      row.title,\n      JSON.parse(row.config),\n      JSON.parse(row.metadata),\n      row.status as SessionStatus,\n      row.created_at,\n      row.updated_at,\n      messages,\n    );\n  }\n\n  private buildSession(\n    id: ChatId,\n    title: string | undefined | null,\n    config: ChatSessionConfig,\n    metadata: ChatSession[\"metadata\"],\n    status: SessionStatus,\n    createdAt: string,\n    updatedAt: string,\n    messages: ChatMessage[],\n  ): ChatSession {\n    return {\n      id,\n      title: title ?? undefined,\n      messages,\n      config,\n      metadata,\n      status,\n      createdAt,\n      updatedAt,\n    };\n  }\n}\n\n// ─── Row Types ─────────────────────────────────────────────────\n\ninterface SessionRow {\n  id: string;\n  title: string | null;\n  config: string;\n  metadata: string;\n  status: string;\n  backend_session_id: string | null;\n  created_at: string;\n  updated_at: string;\n}\n\ninterface MessageRow {\n  id: string;\n  session_id: string;\n  role: string;\n  parts: string;\n  metadata: string | null;\n  status: string;\n  created_at: string;\n  updated_at: string | null;\n  position: number;\n}\n\nfunction rowToMessage(row: MessageRow): ChatMessage {\n  return {\n    id: row.id as ChatId,\n    role: row.role as ChatMessage[\"role\"],\n    parts: JSON.parse(row.parts),\n    metadata: row.metadata ? JSON.parse(row.metadata) : undefined,\n    status: row.status as ChatMessage[\"status\"],\n    createdAt: row.created_at,\n    updatedAt: row.updated_at ?? undefined,\n  };\n}\n","/**\n * SQLite-backed provider store implementing IProviderStore.\n *\n * Stores provider configurations in a `providers` table within\n * a shared SQLite database. Schema auto-created on construction.\n */\n\nimport type Database from \"better-sqlite3\";\nimport type { IProviderStore, ProviderConfig } from \"../provider-types.js\";\n\n// ─── Schema ────────────────────────────────────────────────────\n\nconst CREATE_PROVIDERS_TABLE = `\n  CREATE TABLE IF NOT EXISTS providers (\n    id TEXT PRIMARY KEY,\n    backend TEXT NOT NULL,\n    model TEXT NOT NULL,\n    label TEXT NOT NULL,\n    created_at INTEGER NOT NULL\n  )\n`;\n\n// ─── SQLiteProviderStore ───────────────────────────────────────\n\nexport class SQLiteProviderStore implements IProviderStore {\n  private readonly db: Database.Database;\n\n  constructor(db: Database.Database) {\n    this.db = db;\n    this.db.exec(CREATE_PROVIDERS_TABLE);\n  }\n\n  async create(config: ProviderConfig): Promise<void> {\n    this.db.prepare(`\n      INSERT INTO providers (id, backend, model, label, created_at)\n      VALUES (?, ?, ?, ?, ?)\n    `).run(config.id, config.backend, config.model, config.label, config.createdAt);\n  }\n\n  async get(id: string): Promise<ProviderConfig | null> {\n    const row = this.db.prepare(\"SELECT * FROM providers WHERE id = ?\").get(id) as ProviderRow | undefined;\n    return row ? rowToProvider(row) : null;\n  }\n\n  async update(id: string, changes: Partial<Omit<ProviderConfig, \"id\" | \"createdAt\">>): Promise<void> {\n    const existing = this.db.prepare(\"SELECT id FROM providers WHERE id = ?\").get(id) as { id: string } | undefined;\n    if (!existing) throw new Error(`Provider \"${id}\" not found`);\n\n    const sets: string[] = [];\n    const values: unknown[] = [];\n    if (changes.backend !== undefined) { sets.push(\"backend = ?\"); values.push(changes.backend); }\n    if (changes.model !== undefined) { sets.push(\"model = ?\"); values.push(changes.model); }\n    if (changes.label !== undefined) { sets.push(\"label = ?\"); values.push(changes.label); }\n\n    if (sets.length > 0) {\n      values.push(id);\n      this.db.prepare(`UPDATE providers SET ${sets.join(\", \")} WHERE id = ?`).run(...values);\n    }\n  }\n\n  async delete(id: string): Promise<void> {\n    this.db.prepare(\"DELETE FROM providers WHERE id = ?\").run(id);\n  }\n\n  async list(): Promise<ProviderConfig[]> {\n    const rows = this.db.prepare(\"SELECT * FROM providers ORDER BY created_at ASC\").all() as ProviderRow[];\n    return rows.map(rowToProvider);\n  }\n}\n\n// ─── Row Types ─────────────────────────────────────────────────\n\ninterface ProviderRow {\n  id: string;\n  backend: string;\n  model: string;\n  label: string;\n  created_at: number;\n}\n\nfunction rowToProvider(row: ProviderRow): ProviderConfig {\n  return {\n    id: row.id,\n    backend: row.backend,\n    model: row.model,\n    label: row.label,\n    createdAt: row.created_at,\n  };\n}\n","/**\n * SQLite-backed token store implementing ITokenStore.\n *\n * Stores auth tokens as JSON in a `tokens` table within\n * a shared SQLite database. Schema auto-created on construction.\n */\n\nimport type Database from \"better-sqlite3\";\nimport type { ITokenStore } from \"../server/token-store.js\";\nimport type { AuthToken } from \"../../auth/types.js\";\n\n// ─── Schema ────────────────────────────────────────────────────\n\nconst CREATE_TOKENS_TABLE = `\n  CREATE TABLE IF NOT EXISTS tokens (\n    provider TEXT PRIMARY KEY,\n    token_json TEXT NOT NULL,\n    saved_at INTEGER NOT NULL\n  )\n`;\n\n// ─── SQLiteTokenStore ──────────────────────────────────────────\n\nexport class SQLiteTokenStore implements ITokenStore {\n  private readonly db: Database.Database;\n\n  constructor(db: Database.Database) {\n    this.db = db;\n    this.db.exec(CREATE_TOKENS_TABLE);\n  }\n\n  async save(provider: string, token: AuthToken): Promise<void> {\n    this.db.prepare(`\n      INSERT OR REPLACE INTO tokens (provider, token_json, saved_at)\n      VALUES (?, ?, ?)\n    `).run(provider, JSON.stringify(token), Date.now());\n  }\n\n  async load(provider: string): Promise<AuthToken | null> {\n    const row = this.db.prepare(\"SELECT token_json FROM tokens WHERE provider = ?\").get(provider) as { token_json: string } | undefined;\n    return row ? JSON.parse(row.token_json) as AuthToken : null;\n  }\n\n  async clear(provider: string): Promise<void> {\n    this.db.prepare(\"DELETE FROM tokens WHERE provider = ?\").run(provider);\n  }\n\n  async clearAll(): Promise<void> {\n    this.db.exec(\"DELETE FROM tokens\");\n  }\n\n  async list(): Promise<string[]> {\n    const rows = this.db.prepare(\"SELECT provider FROM tokens ORDER BY saved_at ASC\").all() as { provider: string }[];\n    return rows.map(r => r.provider);\n  }\n}\n","/**\n * Factory function for creating all three SQLite stores from a single database path.\n *\n * @example\n * ```ts\n * import { createSQLiteStorage } from \"@witqq/agent-sdk/chat/sqlite\";\n *\n * const storage = createSQLiteStorage(\"/data/chat.db\");\n * // storage.sessionStore  — IChatSessionStore\n * // storage.providerStore — IProviderStore\n * // storage.tokenStore    — ITokenStore\n * // storage.db            — raw Database instance\n * ```\n */\n\nimport { createRequire } from \"node:module\";\nimport type Database from \"better-sqlite3\";\nimport { SQLiteSessionStore } from \"./session-store.js\";\nimport { SQLiteProviderStore } from \"./provider-store.js\";\nimport { SQLiteTokenStore } from \"./token-store.js\";\nimport type { IChatSessionStore } from \"../sessions.js\";\nimport type { IProviderStore } from \"../provider-types.js\";\nimport type { ITokenStore } from \"../server/token-store.js\";\n\n// ─── Types ─────────────────────────────────────────────────────\n\nexport interface SQLiteStorageOptions {\n  /** Path to SQLite database file. Use \":memory:\" for in-memory database. */\n  dbPath: string;\n  /** Optional pre-created Database instance. If provided, dbPath is ignored. */\n  db?: Database.Database;\n}\n\nexport interface SQLiteStorage {\n  /** The underlying better-sqlite3 Database instance */\n  db: Database.Database;\n  /** Session store for chat sessions and messages */\n  sessionStore: IChatSessionStore;\n  /** Provider store for provider configurations */\n  providerStore: IProviderStore;\n  /** Token store for auth tokens */\n  tokenStore: ITokenStore;\n}\n\n// ─── Factory ───────────────────────────────────────────────────\n\n/**\n * Create all three SQLite stores sharing a single database.\n *\n * Requires `better-sqlite3` as a peer dependency.\n * Schema tables are auto-created on first use.\n *\n * @param pathOrOptions - Database file path string, or options object\n * @returns Object with db, sessionStore, providerStore, tokenStore\n *\n * @throws If better-sqlite3 is not installed\n */\nexport function createSQLiteStorage(pathOrOptions: string | SQLiteStorageOptions): SQLiteStorage {\n  let db: Database.Database;\n\n  if (typeof pathOrOptions === \"string\") {\n    db = createDatabase(pathOrOptions);\n  } else if (pathOrOptions.db) {\n    db = pathOrOptions.db;\n  } else {\n    db = createDatabase(pathOrOptions.dbPath);\n  }\n\n  // Enable WAL + foreign keys once for the shared connection\n  db.pragma(\"journal_mode = WAL\");\n  db.pragma(\"foreign_keys = ON\");\n\n  return {\n    db,\n    sessionStore: new SQLiteSessionStore(db),\n    providerStore: new SQLiteProviderStore(db),\n    tokenStore: new SQLiteTokenStore(db),\n  };\n}\n\nfunction createDatabase(dbPath: string): Database.Database {\n  try {\n    // createRequire for ESM compatibility — better-sqlite3 is a CJS native addon\n    const esmRequire = createRequire(import.meta.url);\n    const BetterSqlite3 = esmRequire(\"better-sqlite3\") as typeof Database;\n    return new BetterSqlite3(dbPath);\n  } catch (err: unknown) {\n    const message = err instanceof Error ? err.message : String(err);\n    if (message.includes(\"Cannot find module\") || message.includes(\"MODULE_NOT_FOUND\")) {\n      throw new Error(\n        \"better-sqlite3 is required for SQLite storage. Install it: npm install better-sqlite3\",\n      );\n    }\n    throw err;\n  }\n}\n"]}