@m6d/cortex-server 1.8.0 → 2.0.1

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

@@ -0,0 +1,194 @@
+import type { StorageAdapter } from "../../../adapters/storage/index";
+/**
+ * The MSSQL implementation of the database contract. One repository per table;
+ * 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): {
+    threads: {
+        list(userId: string, agentId: string): Promise<{
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+        }[]>;
+        getById(userId: string, threadId: string): Promise<{
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(userId: string, agentId: string): Promise<{
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        delete(userId: string, threadId: string): Promise<void>;
+        touch(threadId: string): Promise<{
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateTitle(threadId: string, title: string): Promise<void>;
+        updateSession(threadId: string, session: Record<string, unknown>): Promise<void>;
+        updateContextMeta(threadId: string, meta: import("../../..").ThreadContextMeta): Promise<void>;
+    };
+    messages: {
+        list(userId: string, threadId: string, opts: {
+            limit?: number;
+        } | undefined): Promise<{
+            id: string;
+            text: string | null;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            content: import("../../../types").ChatMessage;
+            ordinal: number;
+            role: "system" | "user" | "assistant" | "tool";
+        }[] | {
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            text: string | null;
+            content: import("../../../types").ChatMessage;
+            ordinal: number;
+            role: "system" | "user" | "assistant" | "tool";
+        }[]>;
+        upsert(threadId: string, messagesToUpsert: import("../../../types").ChatMessage[], options?: {
+            replaceAttachments?: boolean;
+        }): Promise<void>;
+    };
+    llmRequests: {
+        insert(requests: {
+            messageId: string;
+            stepNumber: number;
+            prompt: string;
+            output: string | null;
+            tokenUsage: import("../../..").TokenUsage | null;
+        }[]): Promise<void>;
+        listByMessageId(messageId: string): Promise<{
+            id: string;
+            prompt: string;
+            output: string | null;
+            tokenUsage: import("../../..").TokenUsage | null;
+        }[]>;
+    };
+    attachments: {
+        createPending(row: {
+            userId: string;
+            threadId: string;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            id?: string | undefined;
+            createdAt?: Date | undefined;
+            updatedAt?: Date | undefined;
+            messageId?: string | null | undefined;
+            description?: string | null | undefined;
+        }, limit: number): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | undefined>;
+        getById(id: string, userId: string): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | {
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            userId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | undefined>;
+        listByThread(threadId: string, userId: string): Promise<{
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            userId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        }[]>;
+        claimForMessage(threadId: string, userId: string, messageId: string): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        }[]>;
+        setDescription(id: string, userId: string, status: "pending" | "described" | "failed" | "skipped", description: string | undefined): Promise<void>;
+        remove(id: string, userId: string): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | undefined>;
+    };
+};

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

@@ -0,0 +1,17 @@
+import type { MssqlDb } from "./client";
+export declare function createLlmRequestsRepository(db: MssqlDb): {
+    insert(requests: {
+        messageId: string;
+        stepNumber: number;
+        prompt: string;
+        output: string | null;
+        tokenUsage: import("../../..").TokenUsage | null;
+    }[]): Promise<void>;
+    /** Ordered by step so the inspector replays a turn in the order it ran. */
+    listByMessageId(messageId: string): Promise<{
+        id: string;
+        prompt: string;
+        output: string | null;
+        tokenUsage: import("../../..").TokenUsage | null;
+    }[]>;
+};

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

@@ -0,0 +1,37 @@
+import type { ChatMessage } from "../../../types";
+import type { MssqlDb } from "./client";
+export declare function createMessagesRepository(db: MssqlDb): {
+    /**
+     * Fetches the newest N and reverses, so a limit keeps the most recent
+     * messages while callers still receive them oldest-first.
+     */
+    list(userId: string, threadId: string, opts: {
+        limit?: number;
+    } | undefined): Promise<{
+        id: string;
+        text: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        threadId: string;
+        content: ChatMessage;
+        ordinal: number;
+        role: "system" | "user" | "assistant" | "tool";
+    }[] | {
+        createdAt: Date;
+        updatedAt: Date;
+        id: string;
+        threadId: string;
+        text: string | null;
+        content: ChatMessage;
+        ordinal: number;
+        role: "system" | "user" | "assistant" | "tool";
+    }[]>;
+    /**
+     * Ids are client-generated, so a turn mixes new messages with edits to
+     * ones already stored. Splitting on existence lets the new ones go in as
+     * a single insert; the rest are updated individually.
+     */
+    upsert(threadId: string, messagesToUpsert: ChatMessage[], options?: {
+        replaceAttachments?: boolean;
+    }): Promise<void>;
+};

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

@@ -0,0 +1,50 @@
+import type { ThreadContextMeta } from "../../../ai/context/types";
+import type { MssqlDb } from "./client";
+import type { StorageAdapter } from "../../../adapters/storage/index";
+export declare function createThreadsRepository(db: MssqlDb, storage?: StorageAdapter): {
+    list(userId: string, agentId: string): Promise<{
+        createdAt: Date;
+        updatedAt: Date;
+        id: string;
+        userId: string;
+        agentId: string;
+        title: string | null;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
+    }[]>;
+    getById(userId: string, threadId: string): Promise<{
+        id: string;
+        userId: string;
+        agentId: string;
+        title: string | null;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
+        createdAt: Date;
+        updatedAt: Date;
+    } | null>;
+    create(userId: string, agentId: string): Promise<{
+        id: string;
+        userId: string;
+        agentId: string;
+        title: string | null;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    /** 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;
+        title: string | null;
+        session: Record<string, unknown> | null;
+        contextMeta: ThreadContextMeta | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    updateTitle(threadId: string, title: string): Promise<void>;
+    updateSession(threadId: string, session: Record<string, unknown>): Promise<void>;
+    updateContextMeta(threadId: string, meta: ThreadContextMeta): Promise<void>;
+};

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Global snake_case mapping means schema columns are never spelled out twice —
+ * the TypeScript name is the source of truth and Drizzle derives the column.
+ */
+export declare function createPostgresDb(connectionString: string): import("drizzle-orm/node-postgres").NodePgDatabase<Record<string, never>, import("drizzle-orm").EmptyRelations> & {
+    $client: import("pg").Pool;
+};
+export type PostgresDb = ReturnType<typeof createPostgresDb>;

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

@@ -0,0 +1,207 @@
+import type { StorageAdapter } from "../../../adapters/storage/index";
+/**
+ * The Postgres implementation of the database contract. One repository per
+ * table; only threads takes storage, because deleting a thread is the one
+ * operation that also has to reach into object storage.
+ */
+export declare function createPostgresAdapter(connectionString: string, storage?: StorageAdapter): {
+    threads: {
+        list(userId: string, agentId: string): Promise<{
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+        }[]>;
+        getById(userId: string, threadId: string): Promise<{
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+            createdAt: Date;
+            updatedAt: Date;
+        } | null>;
+        create(userId: string, agentId: string): Promise<{
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        delete(userId: string, threadId: string): Promise<void>;
+        touch(threadId: string): Promise<{
+            id: string;
+            userId: string;
+            agentId: string;
+            title: string | null;
+            session: Record<string, unknown> | null;
+            contextMeta: import("../../..").ThreadContextMeta | null;
+            createdAt: Date;
+            updatedAt: Date;
+        }>;
+        updateTitle(threadId: string, title: string): Promise<void>;
+        updateSession(threadId: string, session: Record<string, unknown>): Promise<void>;
+        updateContextMeta(threadId: string, meta: import("../../..").ThreadContextMeta): Promise<void>;
+    };
+    messages: {
+        list(userId: string, threadId: string, opts: {
+            limit?: number;
+        } | undefined): Promise<{
+            id: string;
+            text: string | null;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            content: import("../../../types").ChatMessage;
+            ordinal: number;
+            role: "system" | "user" | "assistant" | "tool";
+        }[] | {
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            text: string | null;
+            content: import("../../../types").ChatMessage;
+            ordinal: number;
+            role: "system" | "user" | "assistant" | "tool";
+        }[]>;
+        upsert(threadId: string, messagesToUpsert: import("../../../types").ChatMessage[], options?: {
+            replaceAttachments?: boolean;
+        }): Promise<void>;
+    };
+    llmRequests: {
+        insert(requests: {
+            messageId: string;
+            stepNumber: number;
+            prompt: string;
+            output: string | null;
+            tokenUsage: import("../../..").TokenUsage | null;
+        }[]): Promise<void>;
+        listByMessageId(messageId: string): Promise<{
+            id: string;
+            prompt: string;
+            output: string | null;
+            tokenUsage: import("../../..").TokenUsage | null;
+        }[]>;
+    };
+    attachments: {
+        createPending(row: {
+            userId: string;
+            threadId: string;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            id?: string | undefined;
+            createdAt?: Date | undefined;
+            updatedAt?: Date | undefined;
+            messageId?: string | null | undefined;
+            description?: string | null | undefined;
+        }, limit: number): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | undefined>;
+        getById(id: string, userId: string): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | {
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            userId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | undefined>;
+        listByThread(threadId: string, userId: string): Promise<{
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            userId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        }[]>;
+        claimForMessage(threadId: string, userId: string, messageId: string): Promise<{
+            createdAt: Date;
+            updatedAt: Date;
+            id: string;
+            threadId: string;
+            userId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        }[]>;
+        setDescription(id: string, userId: string, status: "pending" | "described" | "failed" | "skipped", description: string | undefined): Promise<void>;
+        remove(id: string, userId: string): Promise<{
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | {
+            id: string;
+            userId: string;
+            createdAt: Date;
+            updatedAt: Date;
+            threadId: string;
+            messageId: string | null;
+            filename: string;
+            contentType: string;
+            sizeBytes: number;
+            storageKey: string;
+            status: "pending" | "described" | "failed" | "skipped";
+            description: string | null;
+        } | undefined>;
+    };
+};

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

@@ -0,0 +1,17 @@
+import type { PostgresDb } from "./client";
+export declare function createLlmRequestsRepository(db: PostgresDb): {
+    insert(requests: {
+        messageId: string;
+        stepNumber: number;
+        prompt: string;
+        output: string | null;
+        tokenUsage: import("../../..").TokenUsage | null;
+    }[]): Promise<void>;
+    /** Ordered by step so the inspector replays a turn in the order it ran. */
+    listByMessageId(messageId: string): Promise<{
+        id: string;
+        prompt: string;
+        output: string | null;
+        tokenUsage: import("../../..").TokenUsage | null;
+    }[]>;
+};

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

@@ -0,0 +1,37 @@
+import type { ChatMessage } from "../../../types";
+import type { PostgresDb } from "./client";
+export declare function createMessagesRepository(db: PostgresDb): {
+    /**
+     * Fetches the newest N and reverses, so a limit keeps the most recent
+     * messages while callers still receive them oldest-first.
+     */
+    list(userId: string, threadId: string, opts: {
+        limit?: number;
+    } | undefined): Promise<{
+        id: string;
+        text: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        threadId: string;
+        content: ChatMessage;
+        ordinal: number;
+        role: "system" | "user" | "assistant" | "tool";
+    }[] | {
+        createdAt: Date;
+        updatedAt: Date;
+        id: string;
+        threadId: string;
+        text: string | null;
+        content: ChatMessage;
+        ordinal: number;
+        role: "system" | "user" | "assistant" | "tool";
+    }[]>;
+    /**
+     * Ids are client-generated, so a turn mixes new messages with edits to
+     * ones already stored. Splitting on existence lets the new ones go in as
+     * a single insert; the rest are updated individually.
+     */
+    upsert(threadId: string, messagesToUpsert: ChatMessage[], options?: {
+        replaceAttachments?: boolean;
+    }): Promise<void>;
+};