@ekodb/ekodb-client 0.18.2 → 0.19.0

package/dist/client.d.ts

@@ -258,6 +258,22 @@ export interface ChatModels {
     anthropic: string[];
     perplexity: string[];
 }
+/**
+ * Request to compact a chat session's history on demand.
+ */
+export interface CompactChatRequest {
+    keep_recent?: number;
+}
+/**
+ * Result of an on-demand chat history compaction.
+ */
+export interface CompactChatResponse {
+    folded: number;
+    kept_recent: number;
+    summary_chars: number;
+    summary_message_id: string | null;
+    already_compact: boolean;
+}
 /**
  * Request to generate embeddings
  */
@@ -866,6 +882,17 @@ export declare class EkoDBClient {
      * Toggle the "forgotten" status of a message
      */
     toggleForgottenMessage(sessionId: string, messageId: string, forgotten: boolean): Promise<void>;
+    /**
+     * Compact a chat session's history on demand.
+     *
+     * Folds older messages into a summary while preserving the most recent
+     * messages verbatim, reducing context size for long-running sessions.
+     *
+     * @param chatId - Chat session ID
+     * @param keepRecent - Number of recent messages to preserve verbatim (optional)
+     * @returns Compaction result with counts and the summary message ID
+     */
+    compactChat(chatId: string, keepRecent?: number): Promise<CompactChatResponse>;
     /**
      * Merge multiple chat sessions into one
      */

package/dist/client.js

@@ -1277,6 +1277,23 @@ class EkoDBClient {
     async toggleForgottenMessage(sessionId, messageId, forgotten) {
         await this.makeRequest("PATCH", `/api/chat/${sessionId}/messages/${messageId}/forgotten`, { forgotten }, 0, true);
     }
+    /**
+     * Compact a chat session's history on demand.
+     *
+     * Folds older messages into a summary while preserving the most recent
+     * messages verbatim, reducing context size for long-running sessions.
+     *
+     * @param chatId - Chat session ID
+     * @param keepRecent - Number of recent messages to preserve verbatim (optional)
+     * @returns Compaction result with counts and the summary message ID
+     */
+    async compactChat(chatId, keepRecent) {
+        const body = {};
+        if (keepRecent !== undefined) {
+            body.keep_recent = keepRecent;
+        }
+        return this.makeRequest("POST", `/api/chat/${chatId}/compact`, body, 0, true);
+    }
     /**
      * Merge multiple chat sessions into one
      */

package/dist/client.test.js

@@ -489,6 +489,41 @@ function mockErrorResponse(status, message) {
         mockJsonResponse({ status: "deleted" });
         await (0, vitest_1.expect)(client.deleteChatSession("chat_123")).resolves.not.toThrow();
     });
+    (0, vitest_1.it)("compacts chat history", async () => {
+        const client = createTestClient();
+        mockTokenResponse();
+        mockJsonResponse({
+            folded: 12,
+            kept_recent: 8,
+            summary_chars: 1024,
+            summary_message_id: "msg_summary_001",
+            already_compact: false,
+        });
+        const result = await client.compactChat("chat_123", 8);
+        (0, vitest_1.expect)(result).toHaveProperty("folded", 12);
+        (0, vitest_1.expect)(result).toHaveProperty("kept_recent", 8);
+        (0, vitest_1.expect)(result).toHaveProperty("summary_message_id", "msg_summary_001");
+        (0, vitest_1.expect)(result).toHaveProperty("already_compact", false);
+        const [, init] = mockFetch.mock.calls[1];
+        (0, vitest_1.expect)(init.method).toBe("POST");
+        (0, vitest_1.expect)(JSON.parse(init.body)).toEqual({ keep_recent: 8 });
+    });
+    (0, vitest_1.it)("compacts chat history without keepRecent", async () => {
+        const client = createTestClient();
+        mockTokenResponse();
+        mockJsonResponse({
+            folded: 0,
+            kept_recent: 0,
+            summary_chars: 0,
+            summary_message_id: null,
+            already_compact: true,
+        });
+        const result = await client.compactChat("chat_123");
+        (0, vitest_1.expect)(result.already_compact).toBe(true);
+        (0, vitest_1.expect)(result.summary_message_id).toBeNull();
+        const [, init] = mockFetch.mock.calls[1];
+        (0, vitest_1.expect)(JSON.parse(init.body)).toEqual({});
+    });
 });
 // ============================================================================
 // Error Handling Tests

package/dist/index.d.ts

@@ -12,4 +12,4 @@ export type { Schema, FieldTypeSchema, IndexConfig, CollectionMetadata, } from "
 export type { JoinConfig } from "./join";
 export type { UserFunction, ParameterDefinition, FunctionStageConfig, GroupFunctionConfig, SortFieldConfig, FunctionResult, FunctionStats, StageStats, } from "./functions";
 export type { MutationNotification, ChatStreamEvent, ClientToolDefinition, ChatSendOptions, SubscribeOptions, } from "./client";
-export type { Record, Query, BatchOperationResult, ClientConfig, RateLimitInfo, CollectionConfig, ChatRequest, CreateChatSessionRequest, ChatMessageRequest, TokenUsage, ChatResponse, ChatSession, ChatSessionResponse, ListSessionsQuery, ListSessionsResponse, GetMessagesQuery, GetMessagesResponse, UpdateSessionRequest, MergeSessionsRequest, ChatModels, EmbedRequest, EmbedResponse, RawCompletionRequest, RawCompletionResponse, ToolChoice, ToolConfig, } from "./client";
+export type { Record, Query, BatchOperationResult, ClientConfig, RateLimitInfo, CollectionConfig, ChatRequest, CreateChatSessionRequest, ChatMessageRequest, TokenUsage, ChatResponse, ChatSession, ChatSessionResponse, ListSessionsQuery, ListSessionsResponse, GetMessagesQuery, GetMessagesResponse, UpdateSessionRequest, MergeSessionsRequest, ChatModels, CompactChatRequest, CompactChatResponse, EmbedRequest, EmbedResponse, RawCompletionRequest, RawCompletionResponse, ToolChoice, ToolConfig, } from "./client";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekodb/ekodb-client",
-  "version": "0.18.2",
+  "version": "0.19.0",
   "description": "Official TypeScript/JavaScript client for ekoDB",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,6 +27,6 @@
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3",
-    "ws": "^8.19.0"
+    "ws": "^8.20.1"
   }
 }

package/src/client.test.ts

@@ -665,6 +665,51 @@ describe("EkoDBClient chat", () => {
 
     await expect(client.deleteChatSession("chat_123")).resolves.not.toThrow();
   });
+
+  it("compacts chat history", async () => {
+    const client = createTestClient();
+
+    mockTokenResponse();
+    mockJsonResponse({
+      folded: 12,
+      kept_recent: 8,
+      summary_chars: 1024,
+      summary_message_id: "msg_summary_001",
+      already_compact: false,
+    });
+
+    const result = await client.compactChat("chat_123", 8);
+
+    expect(result).toHaveProperty("folded", 12);
+    expect(result).toHaveProperty("kept_recent", 8);
+    expect(result).toHaveProperty("summary_message_id", "msg_summary_001");
+    expect(result).toHaveProperty("already_compact", false);
+
+    const [, init] = mockFetch.mock.calls[1];
+    expect(init.method).toBe("POST");
+    expect(JSON.parse(init.body as string)).toEqual({ keep_recent: 8 });
+  });
+
+  it("compacts chat history without keepRecent", async () => {
+    const client = createTestClient();
+
+    mockTokenResponse();
+    mockJsonResponse({
+      folded: 0,
+      kept_recent: 0,
+      summary_chars: 0,
+      summary_message_id: null,
+      already_compact: true,
+    });
+
+    const result = await client.compactChat("chat_123");
+
+    expect(result.already_compact).toBe(true);
+    expect(result.summary_message_id).toBeNull();
+
+    const [, init] = mockFetch.mock.calls[1];
+    expect(JSON.parse(init.body as string)).toEqual({});
+  });
 });
 
 // ============================================================================

package/src/client.ts

@@ -304,6 +304,26 @@ export interface ChatModels {
   perplexity: string[];
 }
 
+/**
+ * Request to compact a chat session's history on demand.
+ */
+export interface CompactChatRequest {
+  keep_recent?: number;
+  // No bypass_ripple: compaction writes chat-message records, which the server
+  // does not ripple (same convention as all chat-message writes).
+}
+
+/**
+ * Result of an on-demand chat history compaction.
+ */
+export interface CompactChatResponse {
+  folded: number;
+  kept_recent: number;
+  summary_chars: number;
+  summary_message_id: string | null;
+  already_compact: boolean;
+}
+
 /**
  * Request to generate embeddings
  */
@@ -2042,6 +2062,33 @@ export class EkoDBClient {
     );
   }
 
+  /**
+   * Compact a chat session's history on demand.
+   *
+   * Folds older messages into a summary while preserving the most recent
+   * messages verbatim, reducing context size for long-running sessions.
+   *
+   * @param chatId - Chat session ID
+   * @param keepRecent - Number of recent messages to preserve verbatim (optional)
+   * @returns Compaction result with counts and the summary message ID
+   */
+  async compactChat(
+    chatId: string,
+    keepRecent?: number,
+  ): Promise<CompactChatResponse> {
+    const body: CompactChatRequest = {};
+    if (keepRecent !== undefined) {
+      body.keep_recent = keepRecent;
+    }
+    return this.makeRequest<CompactChatResponse>(
+      "POST",
+      `/api/chat/${chatId}/compact`,
+      body,
+      0,
+      true, // Force JSON for chat operations
+    );
+  }
+
   /**
    * Merge multiple chat sessions into one
    */

package/src/index.ts

@@ -82,6 +82,8 @@ export type {
   UpdateSessionRequest,
   MergeSessionsRequest,
   ChatModels,
+  CompactChatRequest,
+  CompactChatResponse,
   EmbedRequest,
   EmbedResponse,
   RawCompletionRequest,