@m6d/cortex-server 2.3.0 → 2.4.0

package/dist/src/lib/adapters/database/mssql/index.d.ts

@@ -4,7 +4,9 @@ import type { StorageAdapter } from "../../../adapters/storage/index";
  * only threads takes storage, because deleting a thread is the one operation
  * that also has to reach into object storage.
  */
-export declare function createMssqlAdapter(connectionString: string, storage?: StorageAdapter): {
+export declare function createMssqlAdapter(connectionString: string, storage?: StorageAdapter, options?: {
+    syncMirror?: boolean;
+}): {
     threads: {
         list(userId: string, agentId: string): Promise<{
             createdAt: Date;
@@ -13,39 +15,45 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
             userId: string;
             agentId: string;
             title: string | null;
+            isTest: boolean;
             session: Record<string, unknown> | null;
             contextMeta: import("../../..").ThreadContextMeta | null;
         }[]>;
         getById(userId: string, threadId: string): Promise<{
-            id: string;
-            userId: string;
             agentId: string;
+            userId: string;
+            id: string;
             title: string | null;
-            session: Record<string, unknown> | null;
-            contextMeta: import("../../..").ThreadContextMeta | null;
+            isTest: boolean;
             createdAt: Date;
             updatedAt: Date;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
         } | null>;
-        create(userId: string, agentId: string): Promise<{
-            id: string;
-            userId: string;
+        create(userId: string, agentId: string, options: {
+            isTest?: boolean;
+        } | undefined): Promise<{
             agentId: string;
+            userId: string;
+            id: string;
             title: string | null;
-            session: Record<string, unknown> | null;
-            contextMeta: import("../../..").ThreadContextMeta | null;
+            isTest: boolean;
             createdAt: Date;
             updatedAt: Date;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
         }>;
         delete(userId: string, threadId: string): Promise<void>;
         touch(threadId: string): Promise<{
-            id: string;
-            userId: string;
             agentId: string;
+            userId: string;
+            id: string;
             title: string | null;
-            session: Record<string, unknown> | null;
-            contextMeta: import("../../..").ThreadContextMeta | null;
+            isTest: boolean;
             createdAt: Date;
             updatedAt: Date;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
         }>;
         updateTitle(threadId: string, title: string): Promise<void>;
         updateSession(threadId: string, session: Record<string, unknown>): Promise<void>;
@@ -55,14 +63,14 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
         list(userId: string, threadId: string, opts: {
             limit?: number;
         } | undefined): Promise<{
-            id: string;
             text: string | null;
+            threadId: string;
+            id: string;
             createdAt: Date;
             updatedAt: Date;
-            threadId: string;
-            content: import("../../../types").ChatMessage;
-            ordinal: number;
             role: "system" | "user" | "assistant" | "tool";
+            ordinal: number;
+            content: import("../../../types").ChatMessage;
         }[] | {
             createdAt: Date;
             updatedAt: Date;
@@ -78,7 +86,7 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
         }): Promise<void>;
     };
     llmRequests: {
-        insert(requests: {
+        insert(threadId: string, requests: {
             messageId: string;
             stepNumber: number;
             prompt: string;
@@ -94,8 +102,8 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
     };
     attachments: {
         createPending(row: {
-            userId: string;
             threadId: string;
+            userId: string;
             filename: string;
             contentType: string;
             sizeBytes: number;
@@ -107,11 +115,11 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
             messageId?: string | null | undefined;
             description?: string | null | undefined;
         }, limit: number): Promise<{
-            id: string;
+            threadId: string;
             userId: string;
+            id: string;
             createdAt: Date;
             updatedAt: Date;
-            threadId: string;
             messageId: string | null;
             filename: string;
             contentType: string;
@@ -121,11 +129,11 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
             description: string | null;
         } | undefined>;
         getById(id: string, userId: string): Promise<{
-            id: string;
+            threadId: string;
             userId: string;
+            id: string;
             createdAt: Date;
             updatedAt: Date;
-            threadId: string;
             messageId: string | null;
             filename: string;
             contentType: string;
@@ -162,11 +170,11 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
             description: string | null;
         }[]>;
         claimForMessage(threadId: string, userId: string, messageId: string): Promise<{
-            id: string;
+            threadId: string;
             userId: string;
+            id: string;
             createdAt: Date;
             updatedAt: Date;
-            threadId: string;
             messageId: string | null;
             filename: string;
             contentType: string;
@@ -177,11 +185,11 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
         }[]>;
         setDescription(id: string, userId: string, status: "pending" | "described" | "failed" | "skipped", description: string | undefined): Promise<void>;
         remove(id: string, userId: string): Promise<{
-            id: string;
+            threadId: string;
             userId: string;
+            id: string;
             createdAt: Date;
             updatedAt: Date;
-            threadId: string;
             messageId: string | null;
             filename: string;
             contentType: string;
@@ -191,4 +199,101 @@ export declare function createMssqlAdapter(connectionString: string, storage?: S
             description: string | null;
         } | undefined>;
     };
+    outbox: {
+        enqueue: (events: ({
+            type: "thread.upsert";
+            id: string;
+            agentSlug: string;
+            userId: string;
+            title: string | null;
+            isTest: boolean;
+            createdAt: string;
+            updatedAt: string;
+        } | {
+            type: "thread.delete";
+            id: string;
+        } | {
+            type: "message.upsert";
+            id: string;
+            threadId: string;
+            role: "system" | "user" | "assistant" | "tool";
+            text: string | null;
+            ordinal: number;
+            content: {
+                [x: string]: unknown;
+            };
+            createdAt: string;
+        } | {
+            type: "usage.record";
+            id: string;
+            messageId: string;
+            threadId: string;
+            stepNumber: number;
+            tokenUsage: {
+                input: {
+                    noCache: number;
+                    cacheRead: number;
+                    cacheWrite: number;
+                    total: number;
+                };
+                output: {
+                    reasoning: number;
+                    text: number;
+                    total: number;
+                };
+                total: number;
+            };
+            createdAt: string;
+        })[]) => Promise<void>;
+        peek(limit: number): Promise<{
+            id: number;
+            event: {
+                type: "thread.upsert";
+                id: string;
+                agentSlug: string;
+                userId: string;
+                title: string | null;
+                isTest: boolean;
+                createdAt: string;
+                updatedAt: string;
+            } | {
+                type: "thread.delete";
+                id: string;
+            } | {
+                type: "message.upsert";
+                id: string;
+                threadId: string;
+                role: "system" | "user" | "assistant" | "tool";
+                text: string | null;
+                ordinal: number;
+                content: {
+                    [x: string]: unknown;
+                };
+                createdAt: string;
+            } | {
+                type: "usage.record";
+                id: string;
+                messageId: string;
+                threadId: string;
+                stepNumber: number;
+                tokenUsage: {
+                    input: {
+                        noCache: number;
+                        cacheRead: number;
+                        cacheWrite: number;
+                        total: number;
+                    };
+                    output: {
+                        reasoning: number;
+                        text: number;
+                        total: number;
+                    };
+                    total: number;
+                };
+                createdAt: string;
+            };
+        }[]>;
+        epoch(): Promise<string>;
+        ack(ids: number[]): Promise<void>;
+    };
 };

package/dist/src/lib/adapters/database/mssql/llm-requests.d.ts

@@ -1,6 +1,7 @@
 import type { MssqlDb } from "./client";
-export declare function createLlmRequestsRepository(db: MssqlDb): {
-    insert(requests: {
+import { enqueueSyncEvents } from "./outbox";
+export declare function createLlmRequestsRepository(db: MssqlDb, enqueue?: typeof enqueueSyncEvents): {
+    insert(threadId: string, requests: {
         messageId: string;
         stepNumber: number;
         prompt: string;

package/dist/src/lib/adapters/database/mssql/messages.d.ts

@@ -1,6 +1,7 @@
 import type { ChatMessage } from "../../../types";
 import type { MssqlDb } from "./client";
-export declare function createMessagesRepository(db: MssqlDb): {
+import { enqueueSyncEvents } from "./outbox";
+export declare function createMessagesRepository(db: MssqlDb, enqueue?: typeof enqueueSyncEvents): {
     /**
      * Fetches the newest N and reverses, so a limit keeps the most recent
      * messages while callers still receive them oldest-first.
@@ -8,14 +9,14 @@ export declare function createMessagesRepository(db: MssqlDb): {
     list(userId: string, threadId: string, opts: {
         limit?: number;
     } | undefined): Promise<{
-        id: string;
         text: string | null;
+        threadId: string;
+        id: string;
         createdAt: Date;
         updatedAt: Date;
-        threadId: string;
-        content: ChatMessage;
-        ordinal: number;
         role: "system" | "user" | "assistant" | "tool";
+        ordinal: number;
+        content: ChatMessage;
     }[] | {
         createdAt: Date;
         updatedAt: Date;

package/dist/src/lib/adapters/database/mssql/outbox.d.ts

@@ -0,0 +1,103 @@
+import type { SyncEvent } from "../../../../../contracts/src/runtime";
+import type { MssqlDb } from "./client";
+/** A db or one of its transactions, so a write and its events commit together. */
+type Executor = Pick<MssqlDb, "insert">;
+export declare function enqueueSyncEvents(executor: Executor, events: SyncEvent[]): Promise<void>;
+export declare function createOutboxRepository(db: MssqlDb): {
+    enqueue: (events: ({
+        type: "thread.upsert";
+        id: string;
+        agentSlug: string;
+        userId: string;
+        title: string | null;
+        isTest: boolean;
+        createdAt: string;
+        updatedAt: string;
+    } | {
+        type: "thread.delete";
+        id: string;
+    } | {
+        type: "message.upsert";
+        id: string;
+        threadId: string;
+        role: "system" | "user" | "assistant" | "tool";
+        text: string | null;
+        ordinal: number;
+        content: {
+            [x: string]: unknown;
+        };
+        createdAt: string;
+    } | {
+        type: "usage.record";
+        id: string;
+        messageId: string;
+        threadId: string;
+        stepNumber: number;
+        tokenUsage: {
+            input: {
+                noCache: number;
+                cacheRead: number;
+                cacheWrite: number;
+                total: number;
+            };
+            output: {
+                reasoning: number;
+                text: number;
+                total: number;
+            };
+            total: number;
+        };
+        createdAt: string;
+    })[]) => Promise<void>;
+    peek(limit: number): Promise<{
+        id: number;
+        event: {
+            type: "thread.upsert";
+            id: string;
+            agentSlug: string;
+            userId: string;
+            title: string | null;
+            isTest: boolean;
+            createdAt: string;
+            updatedAt: string;
+        } | {
+            type: "thread.delete";
+            id: string;
+        } | {
+            type: "message.upsert";
+            id: string;
+            threadId: string;
+            role: "system" | "user" | "assistant" | "tool";
+            text: string | null;
+            ordinal: number;
+            content: {
+                [x: string]: unknown;
+            };
+            createdAt: string;
+        } | {
+            type: "usage.record";
+            id: string;
+            messageId: string;
+            threadId: string;
+            stepNumber: number;
+            tokenUsage: {
+                input: {
+                    noCache: number;
+                    cacheRead: number;
+                    cacheWrite: number;
+                    total: number;
+                };
+                output: {
+                    reasoning: number;
+                    text: number;
+                    total: number;
+                };
+                total: number;
+            };
+            createdAt: string;
+        };
+    }[]>;
+    epoch(): Promise<string>;
+    ack(ids: number[]): Promise<void>;
+};
+export {};

package/dist/src/lib/adapters/database/mssql/threads.d.ts

@@ -1,7 +1,8 @@
 import type { ThreadContextMeta } from "../../../ai/context/types";
 import type { MssqlDb } from "./client";
+import { enqueueSyncEvents } from "./outbox";
 import type { StorageAdapter } from "../../../adapters/storage/index";
-export declare function createThreadsRepository(db: MssqlDb, storage?: StorageAdapter): {
+export declare function createThreadsRepository(db: MssqlDb, storage?: StorageAdapter, enqueue?: typeof enqueueSyncEvents): {
     list(userId: string, agentId: string): Promise<{
         createdAt: Date;
         updatedAt: Date;
@@ -9,40 +10,46 @@ export declare function createThreadsRepository(db: MssqlDb, storage?: StorageAd
         userId: string;
         agentId: string;
         title: string | null;
+        isTest: boolean;
         session: Record<string, unknown> | null;
         contextMeta: ThreadContextMeta | null;
     }[]>;
     getById(userId: string, threadId: string): Promise<{
-        id: string;
-        userId: string;
         agentId: string;
+        userId: string;
+        id: string;
         title: string | null;
-        session: Record<string, unknown> | null;
-        contextMeta: ThreadContextMeta | null;
+        isTest: boolean;
         createdAt: Date;
         updatedAt: Date;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
     } | null>;
-    create(userId: string, agentId: string): Promise<{
-        id: string;
-        userId: string;
+    create(userId: string, agentId: string, options: {
+        isTest?: boolean;
+    } | undefined): Promise<{
         agentId: string;
+        userId: string;
+        id: string;
         title: string | null;
-        session: Record<string, unknown> | null;
-        contextMeta: ThreadContextMeta | null;
+        isTest: boolean;
         createdAt: Date;
         updatedAt: Date;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
     }>;
     /** Object storage has no foreign keys, so attachment paths must be swept before row cascade. */
     delete(userId: string, threadId: string): Promise<void>;
     touch(threadId: string): Promise<{
-        id: string;
-        userId: string;
         agentId: string;
+        userId: string;
+        id: string;
         title: string | null;
-        session: Record<string, unknown> | null;
-        contextMeta: ThreadContextMeta | null;
+        isTest: boolean;
         createdAt: Date;
         updatedAt: Date;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
     }>;
     updateTitle(threadId: string, title: string): Promise<void>;
     updateSession(threadId: string, session: Record<string, unknown>): Promise<void>;

package/dist/src/lib/adapters/database/postgres/attachments.d.ts

@@ -1,8 +1,8 @@
 import type { PostgresDb } from "./client";
 export declare function createAttachmentsRepository(db: PostgresDb): {
     createPending(row: {
-        userId: string;
         threadId: string;
+        userId: string;
         filename: string;
         contentType: string;
         sizeBytes: number;
@@ -14,11 +14,11 @@ export declare function createAttachmentsRepository(db: PostgresDb): {
         messageId?: string | null | undefined;
         description?: string | null | undefined;
     }, limit: number): Promise<{
-        id: string;
+        threadId: string;
         userId: string;
+        id: string;
         createdAt: Date;
         updatedAt: Date;
-        threadId: string;
         messageId: string | null;
         filename: string;
         contentType: string;
@@ -28,11 +28,11 @@ export declare function createAttachmentsRepository(db: PostgresDb): {
         description: string | null;
     } | undefined>;
     getById(id: string, userId: string): Promise<{
-        id: string;
+        threadId: string;
         userId: string;
+        id: string;
         createdAt: Date;
         updatedAt: Date;
-        threadId: string;
         messageId: string | null;
         filename: string;
         contentType: string;
@@ -84,11 +84,11 @@ export declare function createAttachmentsRepository(db: PostgresDb): {
     }[]>;
     setDescription(id: string, userId: string, status: "pending" | "described" | "failed" | "skipped", description: string | undefined): Promise<void>;
     remove(id: string, userId: string): Promise<{
-        id: string;
+        threadId: string;
         userId: string;
+        id: string;
         createdAt: Date;
         updatedAt: Date;
-        threadId: string;
         messageId: string | null;
         filename: string;
         contentType: string;
@@ -97,11 +97,11 @@ export declare function createAttachmentsRepository(db: PostgresDb): {
         status: "pending" | "described" | "failed" | "skipped";
         description: string | null;
     } | {
-        id: string;
+        threadId: string;
         userId: string;
+        id: string;
         createdAt: Date;
         updatedAt: Date;
-        threadId: string;
         messageId: string | null;
         filename: string;
         contentType: string;