@witqq/agent-sdk 0.7.0 → 0.9.0

package/dist/chat/sessions.d.cts

@@ -1,9 +1,11 @@
-import { ChatSessionConfig, ChatSession, ChatId, ChatMessage } from './core.cjs';
+import { b as ChatId, g as ChatSession, c as ChatMessage, j as ChatSessionConfig } from '../types-DkSXALKg.cjs';
 import { IStorageAdapter } from './storage.cjs';
 export { StorageError } from './storage.cjs';
-import '../types-CqvUAYxt.cjs';
+import '../agent-C6H2CgJA.cjs';
 import 'zod';
-import '../errors-BDLbNu9w.cjs';
+import '../errors-C-so0M4t.cjs';
+import '../types-4vbcmPTp.cjs';
+import '../errors-CmVvczxZ.cjs';
 
 /**
  * @witqq/agent-sdk/chat/sessions
@@ -52,121 +54,47 @@ interface SessionSearchOptions {
     limit?: number;
 }
 /**
- * Session store interface for managing chat sessions.
- * Wraps a storage adapter with session-specific operations.
- *
- * @example
- * ```typescript
- * const store = new InMemorySessionStore();
- * const session = await store.createSession({ config: { model: "gpt-4", backend: "vercel-ai" } });
- * await store.appendMessage(session.id, message);
- * const page = await store.loadMessages(session.id, { limit: 20, offset: 0 });
- * ```
+ * Read-only session operations.
+ * Consumers needing read-only access (dashboards, analytics) implement only this.
  */
-interface IChatSessionStore {
-    /**
-     * Create a new session with defaults.
-     * @param options - Session creation options
-     * @returns The created session
-     */
-    createSession(options: CreateSessionOptions): Promise<ChatSession>;
-    /**
-     * Retrieve a session by ID.
-     * @param id - Session ID
-     * @returns The session, or `null` if not found
-     */
+interface ISessionReader {
     getSession(id: ChatId): Promise<ChatSession | null>;
-    /**
-     * List sessions with optional filtering, sorting, and pagination.
-     * @param options - List options
-     * @returns Array of sessions
-     */
     listSessions(options?: SessionListOptions): Promise<ChatSession[]>;
-    /**
-     * Update session title.
-     * @param id - Session ID
-     * @param title - New title
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    updateTitle(id: ChatId, title: string): Promise<void>;
-    /**
-     * Update session configuration.
-     * @param id - Session ID
-     * @param config - Partial config to merge
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    updateConfig(id: ChatId, config: Partial<ChatSessionConfig>): Promise<void>;
-    /**
-     * Delete a session by ID.
-     * @param id - Session ID
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    deleteSession(id: ChatId): Promise<void>;
-    /**
-     * Append a single message to a session.
-     * Updates session metadata (messageCount, updatedAt).
-     * @param sessionId - Session ID
-     * @param message - Message to append
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    appendMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
-    /**
-     * Append multiple messages to a session in bulk.
-     * No-op if messages array is empty.
-     * @param sessionId - Session ID
-     * @param messages - Messages to append
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    saveMessages(sessionId: ChatId, messages: ChatMessage[]): Promise<void>;
-    /**
-     * Get paginated messages from a session.
-     * @param sessionId - Session ID
-     * @param options - Pagination options (limit, offset)
-     * @returns Paginated messages result
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
     loadMessages(sessionId: ChatId, options?: {
         limit?: number;
         offset?: number;
     }): Promise<PaginatedMessages>;
-    /**
-     * Archive a session (set status to "archived").
-     * @param id - Session ID
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    archiveSession(id: ChatId): Promise<void>;
-    /**
-     * Unarchive a session (set status back to "active").
-     * @param id - Session ID
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    unarchiveSession(id: ChatId): Promise<void>;
-    /**
-     * Search sessions by title and message content.
-     * Case-insensitive substring match.
-     * @param options - Search query and limit
-     * @returns Matching sessions (without full message content)
-     */
     searchSessions(options: SessionSearchOptions): Promise<ChatSession[]>;
-    /**
-     * Return the number of stored sessions.
-     */
     count(): Promise<number>;
-    /**
-     * Remove all sessions.
-     */
+}
+/**
+ * Write/mutate session operations.
+ * Consumers needing full access implement both ISessionReader & ISessionWriter.
+ */
+interface ISessionWriter {
+    createSession(options: CreateSessionOptions): Promise<ChatSession>;
+    updateTitle(id: ChatId, title: string): Promise<void>;
+    updateConfig(id: ChatId, config: Partial<ChatSessionConfig>): Promise<void>;
+    deleteSession(id: ChatId): Promise<void>;
+    appendMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
+    saveMessages(sessionId: ChatId, messages: ChatMessage[]): Promise<void>;
     clear(): Promise<void>;
-    /**
-     * @deprecated Use `appendMessage()` instead. Will be removed in next major.
-     */
-    addMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
-    /**
-     * @deprecated Use `loadMessages()` instead. Will be removed in next major.
-     */
-    getMessages(sessionId: ChatId, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<PaginatedMessages>;
+    /** Release any resources held by this store (optional). */
+    dispose?(): Promise<void>;
+}
+/**
+ * Full session store interface — union of reader and writer.
+ * Backward-compatible: all existing implementations continue to work.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySessionStore();
+ * const session = await store.createSession({ config: { model: "gpt-4", backend: "vercel-ai" } });
+ * await store.appendMessage(session.id, message);
+ * const page = await store.loadMessages(session.id, { limit: 20, offset: 0 });
+ * ```
+ */
+interface IChatSessionStore extends ISessionReader, ISessionWriter {
 }
 /**
  * Base session store implementation backed by any `IStorageAdapter<ChatSession>`.
@@ -187,18 +115,9 @@ declare class BaseSessionStore implements IChatSessionStore {
         limit?: number;
         offset?: number;
     }): Promise<PaginatedMessages>;
-    archiveSession(id: ChatId): Promise<void>;
-    unarchiveSession(id: ChatId): Promise<void>;
     searchSessions(options: SessionSearchOptions): Promise<ChatSession[]>;
     count(): Promise<number>;
     clear(): Promise<void>;
-    /** @deprecated Use `appendMessage()` instead */
-    addMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
-    /** @deprecated Use `loadMessages()` instead */
-    getMessages(sessionId: ChatId, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<PaginatedMessages>;
 }
 /**
  * In-memory session store. Data is lost when the process exits.
@@ -236,4 +155,4 @@ declare class FileSessionStore extends BaseSessionStore {
     constructor(options: FileSessionStoreOptions);
 }
 
-export { type CreateSessionOptions, FileSessionStore, type FileSessionStoreOptions, type IChatSessionStore, InMemorySessionStore, type PaginatedMessages, type SessionListOptions, type SessionSearchOptions };
+export { type CreateSessionOptions, FileSessionStore, type FileSessionStoreOptions, type IChatSessionStore, type ISessionReader, type ISessionWriter, InMemorySessionStore, type PaginatedMessages, type SessionListOptions, type SessionSearchOptions };

package/dist/chat/sessions.d.ts

@@ -1,9 +1,11 @@
-import { ChatSessionConfig, ChatSession, ChatId, ChatMessage } from './core.js';
+import { b as ChatId, g as ChatSession, c as ChatMessage, j as ChatSessionConfig } from '../types-DgtI1hzh.js';
 import { IStorageAdapter } from './storage.js';
 export { StorageError } from './storage.js';
-import '../types-CqvUAYxt.js';
+import '../agent-F7oB6eKp.js';
 import 'zod';
-import '../errors-BDLbNu9w.js';
+import '../errors-C-so0M4t.js';
+import '../types-BxggH0Yh.js';
+import '../errors-CmVvczxZ.js';
 
 /**
  * @witqq/agent-sdk/chat/sessions
@@ -52,121 +54,47 @@ interface SessionSearchOptions {
     limit?: number;
 }
 /**
- * Session store interface for managing chat sessions.
- * Wraps a storage adapter with session-specific operations.
- *
- * @example
- * ```typescript
- * const store = new InMemorySessionStore();
- * const session = await store.createSession({ config: { model: "gpt-4", backend: "vercel-ai" } });
- * await store.appendMessage(session.id, message);
- * const page = await store.loadMessages(session.id, { limit: 20, offset: 0 });
- * ```
+ * Read-only session operations.
+ * Consumers needing read-only access (dashboards, analytics) implement only this.
  */
-interface IChatSessionStore {
-    /**
-     * Create a new session with defaults.
-     * @param options - Session creation options
-     * @returns The created session
-     */
-    createSession(options: CreateSessionOptions): Promise<ChatSession>;
-    /**
-     * Retrieve a session by ID.
-     * @param id - Session ID
-     * @returns The session, or `null` if not found
-     */
+interface ISessionReader {
     getSession(id: ChatId): Promise<ChatSession | null>;
-    /**
-     * List sessions with optional filtering, sorting, and pagination.
-     * @param options - List options
-     * @returns Array of sessions
-     */
     listSessions(options?: SessionListOptions): Promise<ChatSession[]>;
-    /**
-     * Update session title.
-     * @param id - Session ID
-     * @param title - New title
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    updateTitle(id: ChatId, title: string): Promise<void>;
-    /**
-     * Update session configuration.
-     * @param id - Session ID
-     * @param config - Partial config to merge
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    updateConfig(id: ChatId, config: Partial<ChatSessionConfig>): Promise<void>;
-    /**
-     * Delete a session by ID.
-     * @param id - Session ID
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    deleteSession(id: ChatId): Promise<void>;
-    /**
-     * Append a single message to a session.
-     * Updates session metadata (messageCount, updatedAt).
-     * @param sessionId - Session ID
-     * @param message - Message to append
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    appendMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
-    /**
-     * Append multiple messages to a session in bulk.
-     * No-op if messages array is empty.
-     * @param sessionId - Session ID
-     * @param messages - Messages to append
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    saveMessages(sessionId: ChatId, messages: ChatMessage[]): Promise<void>;
-    /**
-     * Get paginated messages from a session.
-     * @param sessionId - Session ID
-     * @param options - Pagination options (limit, offset)
-     * @returns Paginated messages result
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
     loadMessages(sessionId: ChatId, options?: {
         limit?: number;
         offset?: number;
     }): Promise<PaginatedMessages>;
-    /**
-     * Archive a session (set status to "archived").
-     * @param id - Session ID
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    archiveSession(id: ChatId): Promise<void>;
-    /**
-     * Unarchive a session (set status back to "active").
-     * @param id - Session ID
-     * @throws {StorageError} with code `NOT_FOUND` if session doesn't exist
-     */
-    unarchiveSession(id: ChatId): Promise<void>;
-    /**
-     * Search sessions by title and message content.
-     * Case-insensitive substring match.
-     * @param options - Search query and limit
-     * @returns Matching sessions (without full message content)
-     */
     searchSessions(options: SessionSearchOptions): Promise<ChatSession[]>;
-    /**
-     * Return the number of stored sessions.
-     */
     count(): Promise<number>;
-    /**
-     * Remove all sessions.
-     */
+}
+/**
+ * Write/mutate session operations.
+ * Consumers needing full access implement both ISessionReader & ISessionWriter.
+ */
+interface ISessionWriter {
+    createSession(options: CreateSessionOptions): Promise<ChatSession>;
+    updateTitle(id: ChatId, title: string): Promise<void>;
+    updateConfig(id: ChatId, config: Partial<ChatSessionConfig>): Promise<void>;
+    deleteSession(id: ChatId): Promise<void>;
+    appendMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
+    saveMessages(sessionId: ChatId, messages: ChatMessage[]): Promise<void>;
     clear(): Promise<void>;
-    /**
-     * @deprecated Use `appendMessage()` instead. Will be removed in next major.
-     */
-    addMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
-    /**
-     * @deprecated Use `loadMessages()` instead. Will be removed in next major.
-     */
-    getMessages(sessionId: ChatId, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<PaginatedMessages>;
+    /** Release any resources held by this store (optional). */
+    dispose?(): Promise<void>;
+}
+/**
+ * Full session store interface — union of reader and writer.
+ * Backward-compatible: all existing implementations continue to work.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySessionStore();
+ * const session = await store.createSession({ config: { model: "gpt-4", backend: "vercel-ai" } });
+ * await store.appendMessage(session.id, message);
+ * const page = await store.loadMessages(session.id, { limit: 20, offset: 0 });
+ * ```
+ */
+interface IChatSessionStore extends ISessionReader, ISessionWriter {
 }
 /**
  * Base session store implementation backed by any `IStorageAdapter<ChatSession>`.
@@ -187,18 +115,9 @@ declare class BaseSessionStore implements IChatSessionStore {
         limit?: number;
         offset?: number;
     }): Promise<PaginatedMessages>;
-    archiveSession(id: ChatId): Promise<void>;
-    unarchiveSession(id: ChatId): Promise<void>;
     searchSessions(options: SessionSearchOptions): Promise<ChatSession[]>;
     count(): Promise<number>;
     clear(): Promise<void>;
-    /** @deprecated Use `appendMessage()` instead */
-    addMessage(sessionId: ChatId, message: ChatMessage): Promise<void>;
-    /** @deprecated Use `loadMessages()` instead */
-    getMessages(sessionId: ChatId, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<PaginatedMessages>;
 }
 /**
  * In-memory session store. Data is lost when the process exits.
@@ -236,4 +155,4 @@ declare class FileSessionStore extends BaseSessionStore {
     constructor(options: FileSessionStoreOptions);
 }
 
-export { type CreateSessionOptions, FileSessionStore, type FileSessionStoreOptions, type IChatSessionStore, InMemorySessionStore, type PaginatedMessages, type SessionListOptions, type SessionSearchOptions };
+export { type CreateSessionOptions, FileSessionStore, type FileSessionStoreOptions, type IChatSessionStore, type ISessionReader, type ISessionWriter, InMemorySessionStore, type PaginatedMessages, type SessionListOptions, type SessionSearchOptions };