@theokit/sdk 2.15.1 → 2.18.0

package/dist/{cron-BxLSz1UH.d.cts → cron-Bbg0mBOv.d.ts}

@@ -1,4 +1,4 @@
-import { C as CustomTool, M as ModelSelection, G as SDKUserMessage, J as SendOptions, b as Run, r as RunToCompletionOptions, s as RunToCompletionResult, S as SDKMessage, U as StreamToCompletionResult, a as McpServerConfig } from './run-DXy_MVwz.cjs';
+import { C as CustomTool, M as ModelSelection, G as SDKUserMessage, J as SendOptions, b as Run, r as RunToCompletionOptions, s as RunToCompletionResult, S as SDKMessage, U as StreamToCompletionResult, a as McpServerConfig } from './run-pE-34AAo.js';
 
 /**
  * Fork primitive public type contracts (T1.2, ADRs D110-D114).
@@ -616,20 +616,50 @@ interface StoredMessage {
  */
 interface ConversationStorageAdapter {
     /**
-     * Return the full message history for a conversation, in insertion order.
+     * Return the message history for a conversation, in insertion order.
      * MUST return `[]` (not throw) when the conversation does not exist.
+     *
+     * M2 #63 — an optional `{ offset, limit }` window paginates the result so a
+     * caller hydrating a long history is not forced to materialize the whole log.
+     * Omitting `opts` returns the full history (backward-compatible). `offset`
+     * counts from the oldest message; `limit` bounds the returned count.
      */
-    getMessages(conversationId: string): Promise<readonly StoredMessage[]>;
+    getMessages(conversationId: string, opts?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<readonly StoredMessage[]>;
     /**
      * Append a single message to the conversation.
      * MUST be atomic — concurrent appends MUST NOT corrupt the log.
      * MUST create the conversation lazily if it does not exist.
      */
     appendMessage(conversationId: string, message: StoredMessage): Promise<void>;
+    /**
+     * M2 #63 — optional batch append: write a whole conversation turn
+     * (user + assistant + N tool results) in ONE atomic operation. The default FS
+     * adapter uses a single locked `appendFile` (one open per turn instead of N).
+     * Adapters that do not implement it fall back to looping `appendMessage`.
+     * MUST be atomic as a unit — a partial batch MUST NOT be observable.
+     */
+    appendMessages?(conversationId: string, messages: readonly StoredMessage[]): Promise<void>;
+    /**
+     * M3 #67 — revert a conversation back to its first `keepCount` messages
+     * ("undo the last turn(s)"). Atomic rewrite; `keepCount <= 0` empties it,
+     * `keepCount >= length` is a no-op. Returns the number of messages kept.
+     * Transcript-only; adapters that cannot truncate MAY omit it.
+     */
+    truncateConversation?(conversationId: string, keepCount: number): Promise<number>;
     /**
      * Delete the entire conversation. MUST be idempotent (delete-of-missing = ok).
      */
     deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * M3 #62 — delete every conversation whose id starts with `prefix`
+     * (e.g. `"temp__"` from {@link sessionScopePrefix}) so a whole session scope
+     * can be pruned in one call. Returns the number deleted. Optional — adapters
+     * that cannot enumerate MAY omit it.
+     */
+    deleteScope?(prefix: string): Promise<number>;
     /**
      * Optional: list conversation ids. Used by housekeeping flows.
      * Implementations that cannot enumerate (e.g., wildcards too expensive on

package/dist/{cron-DcaoP7aW.d.ts → cron-ZLSKbDbB.d.cts}

@@ -1,4 +1,4 @@
-import { C as CustomTool, M as ModelSelection, G as SDKUserMessage, J as SendOptions, b as Run, r as RunToCompletionOptions, s as RunToCompletionResult, S as SDKMessage, U as StreamToCompletionResult, a as McpServerConfig } from './run-DXy_MVwz.js';
+import { C as CustomTool, M as ModelSelection, G as SDKUserMessage, J as SendOptions, b as Run, r as RunToCompletionOptions, s as RunToCompletionResult, S as SDKMessage, U as StreamToCompletionResult, a as McpServerConfig } from './run-pE-34AAo.cjs';
 
 /**
  * Fork primitive public type contracts (T1.2, ADRs D110-D114).
@@ -616,20 +616,50 @@ interface StoredMessage {
  */
 interface ConversationStorageAdapter {
     /**
-     * Return the full message history for a conversation, in insertion order.
+     * Return the message history for a conversation, in insertion order.
      * MUST return `[]` (not throw) when the conversation does not exist.
+     *
+     * M2 #63 — an optional `{ offset, limit }` window paginates the result so a
+     * caller hydrating a long history is not forced to materialize the whole log.
+     * Omitting `opts` returns the full history (backward-compatible). `offset`
+     * counts from the oldest message; `limit` bounds the returned count.
      */
-    getMessages(conversationId: string): Promise<readonly StoredMessage[]>;
+    getMessages(conversationId: string, opts?: {
+        offset?: number;
+        limit?: number;
+    }): Promise<readonly StoredMessage[]>;
     /**
      * Append a single message to the conversation.
      * MUST be atomic — concurrent appends MUST NOT corrupt the log.
      * MUST create the conversation lazily if it does not exist.
      */
     appendMessage(conversationId: string, message: StoredMessage): Promise<void>;
+    /**
+     * M2 #63 — optional batch append: write a whole conversation turn
+     * (user + assistant + N tool results) in ONE atomic operation. The default FS
+     * adapter uses a single locked `appendFile` (one open per turn instead of N).
+     * Adapters that do not implement it fall back to looping `appendMessage`.
+     * MUST be atomic as a unit — a partial batch MUST NOT be observable.
+     */
+    appendMessages?(conversationId: string, messages: readonly StoredMessage[]): Promise<void>;
+    /**
+     * M3 #67 — revert a conversation back to its first `keepCount` messages
+     * ("undo the last turn(s)"). Atomic rewrite; `keepCount <= 0` empties it,
+     * `keepCount >= length` is a no-op. Returns the number of messages kept.
+     * Transcript-only; adapters that cannot truncate MAY omit it.
+     */
+    truncateConversation?(conversationId: string, keepCount: number): Promise<number>;
     /**
      * Delete the entire conversation. MUST be idempotent (delete-of-missing = ok).
      */
     deleteConversation(conversationId: string): Promise<void>;
+    /**
+     * M3 #62 — delete every conversation whose id starts with `prefix`
+     * (e.g. `"temp__"` from {@link sessionScopePrefix}) so a whole session scope
+     * can be pruned in one call. Returns the number deleted. Optional — adapters
+     * that cannot enumerate MAY omit it.
+     */
+    deleteScope?(prefix: string): Promise<number>;
     /**
      * Optional: list conversation ids. Used by housekeeping flows.
      * Implementations that cannot enumerate (e.g., wildcards too expensive on