@wfm-cn/dsh-storage 0.0.0-stage → 0.2.0

package/lib/types/generated/sqlserver/models.d.ts

@@ -0,0 +1,3 @@
+export type * from './models/AiMessage.js';
+export type * from './models/AiChatHistory.js';
+export type * from './commonInputTypes.js';

package/lib/types/health.d.ts

@@ -0,0 +1,52 @@
+import { type SyncConfig } from './config.js';
+export type HealthStatus = {
+    state: 'ok' | 'down' | 'disabled' | 'config-error';
+    lastOkAt?: number;
+    lastError?: string;
+    retryCount: number;
+    mirroredTotal?: number;
+};
+/** Thrown by the probe when the sync config itself is unusable — no retries until it is fixed. */
+export declare class ConfigError extends Error {
+}
+type TransitionCallback = (to: HealthStatus['state'], from: HealthStatus['state'], status: HealthStatus) => void;
+export interface HealthMonitorOptions {
+    /** Re-probe interval while healthy (default 30s). */
+    intervalMs?: number;
+}
+/**
+ * States: 'disabled' (not started) → 'ok'/'down' on probe results, or
+ * 'config-error' when the probe reports a ConfigError (retries suspended
+ * until an explicit `recheck()`). Same-state results never re-fire
+ * transition callbacks.
+ */
+export declare class HealthMonitor {
+    private readonly probe;
+    private readonly options;
+    private state;
+    private lastOkAt;
+    private lastError;
+    private retryCount;
+    private running;
+    private timer;
+    private readonly listeners;
+    constructor(probe: () => Promise<void>, options?: HealthMonitorOptions);
+    start(): void;
+    stop(): void;
+    snapshot(): HealthStatus;
+    onTransition(cb: TransitionCallback): () => void;
+    /** Run one probe cycle immediately (re-arms after a config error). */
+    recheck(): Promise<void>;
+    private clearTimer;
+    private runProbe;
+    private onSuccess;
+    private onFailure;
+    private scheduleRetry;
+    private transition;
+}
+/** Probe for HealthMonitor: resolves when the database is live and migrated. */
+export declare function probeDatabase(cfg: SyncConfig): Promise<void>;
+export type ConnectionTestResult = 'ok' | 'no-tables' | `fail:${string}`;
+/** One-shot panel test: never throws — every failure maps to 'fail:<reason>'. */
+export declare function testConnection(cfg: SyncConfig): Promise<ConnectionTestResult>;
+export {};

package/lib/types/index.d.ts

@@ -0,0 +1,91 @@
+/**
+ * dsh-storage — mirrors the dsh session event stream into the ai_messages /
+ * ai_chat_histories tables (MySQL/PostgreSQL/SQLite/SQL Server).
+ *
+ * Design: dsh's own session persistence (JSONL/SQLite) stays authoritative.
+ * This plugin taps `session/event` (the same seam the built-in persistence
+ * coordinator uses) and projects events into MessageRow / SessionRow shaped
+ * after the source project's ai_messages / ai_chat_histories tables.
+ *
+ * A2A task state (task metadata in Redis, workspace archives in GCS) is NOT
+ * here — that belongs to the A2A layer, see dsh-a2a's TaskStore backends.
+ *
+ * Resume caveat (docs/subsystems/persistence.md): constructor seeds do not
+ * emit events. On agent resume, only events >= `session.firstLiveSeq` fire
+ * on this stream — historical rows must come from the database itself, not
+ * from replaying the tap.
+ *
+ * @module dsh-storage
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import Schema from '@deepseek-ai/schemastery';
+import { type DatabaseProvider } from './backends/database.js';
+import { type BackfillSummary } from './backfill.js';
+import { type SyncConfig } from './config.js';
+import { type CreateTableResult } from './ddl.js';
+import { type ConnectionTestResult, type HealthStatus } from './health.js';
+import { type StorageToast } from './notify.js';
+export declare const name = "dsh-storage";
+export declare const inject: string[];
+export declare const Config: Schema<Schemastery.ObjectS<NoInfer<{
+    enabled: Schema<boolean, boolean, "defined">;
+    database: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        provider: Schema<"mysql" | "postgresql" | "sqlite" | "sqlserver", "mysql" | "postgresql" | "sqlite" | "sqlserver", "defined">;
+        url: Schema<string, string, "defined">;
+        timezone: Schema<string, string, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        provider: Schema<"mysql" | "postgresql" | "sqlite" | "sqlserver", "mysql" | "postgresql" | "sqlite" | "sqlserver", "defined">;
+        url: Schema<string, string, "defined">;
+        timezone: Schema<string, string, "defined">;
+    }>>, "plain">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    enabled: Schema<boolean, boolean, "defined">;
+    database: Schema<Schemastery.ObjectS<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        provider: Schema<"mysql" | "postgresql" | "sqlite" | "sqlserver", "mysql" | "postgresql" | "sqlite" | "sqlserver", "defined">;
+        url: Schema<string, string, "defined">;
+        timezone: Schema<string, string, "defined">;
+    }>>, Schemastery.ObjectT<NoInfer<{
+        enabled: Schema<boolean, boolean, "defined">;
+        provider: Schema<"mysql" | "postgresql" | "sqlite" | "sqlserver", "mysql" | "postgresql" | "sqlite" | "sqlserver", "defined">;
+        url: Schema<string, string, "defined">;
+        timezone: Schema<string, string, "defined">;
+    }>>, "plain">;
+}>>, "plain">;
+export interface StoragePluginConfig {
+    enabled: boolean;
+    database: {
+        enabled: boolean;
+        provider: DatabaseProvider;
+        url: string;
+        timezone?: string;
+    };
+}
+/** Explicit write API for a consumer's session-clear flow. */
+export interface DshStorageService {
+    archiveSession(sessionId: string): Promise<string | null>;
+}
+/** Status/health RPC for the settings panel (Task 5) and notifications (Task 6). */
+export interface DshStorageStatusService {
+    snapshot(): HealthStatus;
+    testConnection(cfg: SyncConfig): Promise<ConnectionTestResult>;
+    /** Panel 「建表」: provider-appropriate DDL via packaged prisma schemas. */
+    createTables(cfg: SyncConfig): Promise<CreateTableResult>;
+    /** Panel form load/persist — the file the backend watches (T3). */
+    getConfig(): {
+        config: SyncConfig;
+        error?: 'parse' | 'missing-field';
+    };
+    saveConfig(cfg: SyncConfig): {
+        config: SyncConfig;
+    };
+    /** Panel 「补传」 (T6): replay gap events from local session logs. */
+    backfill(): Promise<BackfillSummary>;
+    /** Toast notifications newer than the cursor (client polling, T6). */
+    toasts(payload: {
+        sinceId?: number;
+    }): StorageToast[];
+}
+export declare function apply(ctx: Context, config: StoragePluginConfig): void;

package/lib/types/notify.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 同步中断/恢复通知 (Task 6): the host side records toast notifications on
+ * HealthMonitor transitions; the browser client (src/client/toast.tsx) polls
+ * them through the status bridge and renders a React portal independent of
+ * the settings panel. The monitor already guarantees transitions only
+ * (same-state results never re-fire), so each record is a real state change.
+ */
+export interface StorageToast {
+    id: number;
+    kind: 'interrupted' | 'recovered';
+    text: string;
+    /** Secondary line (recovery backfill hint). */
+    hint?: string;
+    createdAt: number;
+}
+/** Minimal monitor surface wireNotifications needs (satisfied by HealthMonitor). */
+export interface ToastCapableMonitor {
+    onTransition(cb: (to: string, from: string, status: {
+        lastError?: string;
+    }) => void): () => void;
+}
+/** 中断 toast: good → bad. */
+export declare function notifyGoodToBad(lastError?: string): StorageToast;
+/** 恢复 toast: bad → good, with a backfill hint for the gap. */
+export declare function notifyBadToGood(): StorageToast;
+/** Records newer than `sinceId` (polling cursor for the client). */
+export declare function drainToasts(sinceId?: number): StorageToast[];
+/** Test/reset hook: drop all history. */
+export declare function clearToasts(): void;
+/**
+ * Wire the toast records onto a monitor's transitions. Good→bad strictly
+ * means ok → down (a config error was never "good"); bad→good covers
+ * down → ok and config-error → ok.
+ */
+export declare function wireNotifications(monitor: ToastCapableMonitor): () => void;

package/lib/types/projector.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Projects dsh session events onto MessageRow / SessionRow.
+ *
+ * Event shapes verified against the dsh persistence catalog
+ * (https://deepseek-harness.github.io/deepseek-harness/reference/persistence-catalog)
+ * and the @deepseek-ai/dsh-llm message types:
+ * - envelope: `{ type, seq, time, data }` — payload lives under `data`.
+ * - `user/message` and `assistant/message` produce rows; `tool/result` updates
+ *   the matching assistant row's toolCalls instead of producing a tool row.
+ * - token usage (V3 log): `assistant/message.data.usage` is the settled
+ *   step's accounting; a failed/cancelled attempt commits `assistant/attempt`
+ *   instead, with the adapter's usage chunk preserved as a raw record in its
+ *   embedded compact stream (recovered in usageSampleOf). `turn/end` carries
+ *   none — it only serves as a rollup checkpoint.
+ * - compaction summaries enter the surface as a `user/message` with
+ *   `surfaceOp: replace`, so they flow through the user path unchanged.
+ */
+import type { MessageRow } from './types.js';
+/**
+ * Map one session event to zero or one message row. Returns null for events
+ * that should not be persisted as standalone rows (log-only events: chunks,
+ * turn/step lifecycle, approvals, ...).
+ */
+export declare function projectEvent(_session: any, event: any, sessionId: string): MessageRow | null;
+/** Identify the assistant tool call answered by either supported result shape. */
+export declare function toolResultCallId(event: any): string | undefined;
+/** Update the persisted assistant call identified by a tool result. */
+export declare function mergeToolResult(event: any, rows: MessageRow[]): MessageRow | null;
+export interface UsageSample {
+    input: number;
+    output: number;
+}
+/**
+ * Extract one model call's usage, keyed by its durable event sequence.
+ *
+ * V3 session log (dsh-session@0.1.6-alpha.2):
+ * - `assistant/message.data.usage` — the settled call's accounting;
+ * - `assistant/attempt` — a failed/retried/cancelled call commits no surface
+ *   message; the adapter's usage chunk survives as a raw `chunk` record in the
+ *   embedded compact `stream` (deltas are packed, but usage is a raw type).
+ *
+ * Calls on one `(turn, step)` are additive: a retry is another billed model
+ * call, not a progressive snapshot. Only redelivery of the same event sequence
+ * is a duplicate. Totals include the cache buckets: cacheRead/cacheWrite are
+ * billed in their own buckets (observed cacheReadTokens ≫ inputTokens in dsh
+ * session logs — they are not subsets of inputTokens).
+ */
+export declare function usageSampleOf(event: any): {
+    key: string;
+    sample: UsageSample;
+} | null;

package/lib/types/status-route.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Host→browser bridge for the settings panel: exposes the dshStorageStatus
+ * service over the DSH connection generic-RPC channel `/dsh-storage`.
+ *
+ * Pattern verified against the installed reference plugins (ds-harness-remote
+ * `registerControlRoute`, dsh-video-skin settings.section client): the browser
+ * client calls `ctx.connection.rpc.call('/dsh-storage', endpoint, payload)`,
+ * which POSTs `{type:'client-request', rpcId, method, payload}` to
+ * `/<channel>/<endpoint>` and expects `{type:'server-response', rpcId,
+ * result:{ok:true,value}|{ok:false,error:{code,message,details}}}`. When the
+ * webServer service is available we serve that path with a prefix route
+ * (guarded by `connection.requestRejection` for authentication); otherwise we
+ * fall back to `connection.rpc.handle` for in-process carriers. Both halves
+ * stay optional (`ctx.get`), so profiles without a web carrier simply skip
+ * the bridge.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SyncConfig } from './config.js';
+import type { CreateTableResult } from './ddl.js';
+import type { ConnectionTestResult, HealthStatus } from './health.js';
+import type { BackfillSummary } from './backfill.js';
+import type { StorageToast } from './notify.js';
+/** The surface bridged to the browser panel. */
+export interface StatusService {
+    snapshot(): HealthStatus;
+    testConnection(cfg: SyncConfig): Promise<ConnectionTestResult>;
+    createTables(cfg: SyncConfig): Promise<CreateTableResult>;
+    getConfig(): {
+        config: SyncConfig;
+        error?: 'parse' | 'missing-field';
+    };
+    saveConfig(cfg: SyncConfig): {
+        config: SyncConfig;
+    };
+    /** Panel 「补传」: replay missing events from local session logs. */
+    backfill(): Promise<BackfillSummary>;
+    /** Toast notifications newer than the cursor (client polling). */
+    toasts(payload: {
+        sinceId?: number;
+    }): StorageToast[];
+}
+export declare const STATUS_CHANNEL = "/dsh-storage";
+/**
+ * Register the /dsh-storage channel. Wire order mirrors ds-harness-remote's
+ * control route: an authenticated webServer prefix route when both services
+ * allow it, otherwise connection.rpc.handle for logical carriers.
+ */
+export declare function registerStatusRoute(ctx: Context, service: StatusService): (() => void) | undefined;

package/lib/types/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared row types and the backend contract.
+ *
+ * Row shapes mirror the `ai_messages` / `ai_chat_histories` Prisma models
+ * (see prisma/schema.{mysql,postgresql,sqlite,sqlserver}.prisma), matching
+ * the source project's tables.
+ */
+/** One row in `ai_messages`. */
+export interface MessageRow {
+    id: string;
+    sessionId: string;
+    historyId: string | null;
+    /** 'user' | 'model' | 'tool' | 'utility_compressor' | plugin-defined */
+    type: string;
+    content: string;
+    thoughts?: unknown;
+    model?: string | null;
+    tokens?: unknown;
+    toolCalls?: unknown;
+    agentId?: string | null;
+    metadata?: Record<string, unknown>;
+    createdAt: Date;
+}
+/** One row in `ai_chat_histories` — a per-session rollup. */
+export interface SessionRow {
+    sessionId: string;
+    title?: string | null;
+    messageCount: number;
+    totalTokens: number;
+    firstMessageAt?: Date | null;
+    lastMessageAt?: Date | null;
+    /** Plugin bookkeeping persisted in the row's JSON metadata column. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A storage backend receives already-projected rows. Backend errors reject
+ * into the plugin's per-session queue, whose catch/log boundary keeps
+ * mirroring failures out of the agent loop.
+ */
+export interface StorageBackend {
+    readonly name: string;
+    init?(): Promise<void>;
+    /** Read the stored session row, for seeding the live rollup on resume. */
+    readSession?(sessionId: string): Promise<SessionRow | null>;
+    /** Max message created_at per session across active rows (backfill gap detection). */
+    latestPerSession?(): Promise<Map<string, Date>>;
+    /** Read one persisted logical message, including archived rows for redelivery. */
+    readMessages(sessionId: string, messageId: string): Promise<MessageRow[]>;
+    /** Find the newest active model message containing this exact tool call. */
+    readToolCallMessages(sessionId: string, callId: string): Promise<MessageRow[]>;
+    upsertMessage(row: MessageRow): Promise<void>;
+    upsertSession(row: SessionRow): Promise<void>;
+    /** Atomically persist one event's optional message and its session rollup. */
+    upsertEvent(message: MessageRow | null, session: SessionRow): Promise<void>;
+    /** Move active messages into a queryable history row; null when already empty. */
+    archiveSession(sessionId: string): Promise<string | null>;
+    close?(): Promise<void>;
+}

package/lib/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared row types and the backend contract.
+ *
+ * Row shapes mirror the `ai_messages` / `ai_chat_histories` Prisma models
+ * (see prisma/schema.{mysql,postgresql,sqlite,sqlserver}.prisma), matching
+ * the source project's tables.
+ */
+export {};

package/package.json

@@ -1,6 +1,129 @@
 {
   "name": "@wfm-cn/dsh-storage",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Session storage mirror for DeepSeek Harness: projects the session event stream into MySQL/PostgreSQL/SQLite/SQL Server (ai_messages / ai_chat_histories) without replacing dsh's local persistence.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json",
+    "./client": {
+      "default": "./lib/client.js"
+    }
+  },
+  "files": [
+    "lib",
+    "prisma",
+    "cordis.patch.yml",
+    "preview.png",
+    "CHANGELOG.md"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/2938236819/dsh-storage.git"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "node scripts/prisma-generate.mjs && tsc -p tsconfig.build.json && npm run build:client",
+    "build:client": "esbuild src/client/index.ts --bundle --format=iife --outfile=lib/client.js --target=es2020 --minify --legal-comments=none",
+    "generate": "node scripts/prisma-generate.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.5",
+    "@prisma/client": "7.9.1",
+    "@prisma/adapter-mariadb": "7.9.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-session": ">=0.1.5-rc.1 || >=0.1.6-alpha.1 || >=0.1.7-alpha.1 || >=0.2.0-rc.1 || >=0.2.1-rc.1 || >=0.2.2-rc.1",
+    "@prisma/adapter-libsql": "^7.9.1",
+    "@prisma/adapter-mariadb": "^7.9.1",
+    "@prisma/adapter-mssql": "^7.9.1",
+    "@prisma/adapter-pg": "^7.9.1",
+    "@prisma/client": "^7.9.1",
+    "react": ">=18.2.0 <19",
+    "@deepseek-ai/dsh-client-connection": ">=0.2.0-rc.1 <0.3.0-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.2.0-rc.1 <0.3.0-0"
+  },
+  "peerDependenciesMeta": {
+    "@prisma/adapter-libsql": {
+      "optional": true
+    },
+    "@prisma/adapter-mariadb": {
+      "optional": true
+    },
+    "@prisma/adapter-mssql": {
+      "optional": true
+    },
+    "@prisma/adapter-pg": {
+      "optional": true
+    },
+    "@prisma/client": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.1.0",
+    "@deepseek-ai/dsh-session": "0.2.2-rc.1",
+    "@prisma/adapter-libsql": "^7.9.1",
+    "@prisma/adapter-mariadb": "^7.9.1",
+    "@prisma/adapter-mssql": "^7.9.1",
+    "@prisma/adapter-pg": "^7.9.1",
+    "@prisma/client": "^7.9.1",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
+    "esbuild": "^0.28.2",
+    "jsdom": "^31.0.0",
+    "prisma": "^7.9.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "typescript": "^5.6.3",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": "^20.19 || ^22.12 || >=24.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "@prisma/engines",
+      "esbuild",
+      "prisma"
+    ],
+    "patchedDependencies": {
+      "@prisma/adapter-mariadb@7.9.1": "patches/@prisma__adapter-mariadb@7.9.1.patch"
+    }
+  }
 }

package/prisma/schema.mysql.prisma

@@ -0,0 +1,78 @@
+// Prisma schema for the dsh-storage database backend — MySQL variant (Prisma 7).
+//
+// Table layout matches the source project's ai_messages / ai_chat_histories
+// (packages/core/prisma/schema.prisma) so existing data stays compatible:
+//   - `type` values come from the dsh session event map
+//     ('user' | 'model' | 'tool' | ...) instead of gemini-cli message roles.
+//   - `agent_id` distinguishes the main agent from subagent writers.
+//   - no user_id: tenancy is carried by session_id, not a column.
+//
+// The client is pre-generated at package build time (`pnpm generate`, output
+// src/generated/mysql, compiled into lib/generated) — consumers do NOT run
+// `prisma generate`. To create/upgrade tables, run `prisma db push` /
+// migrations against this file; the connection URL lives in prisma.config.ts
+// (Prisma 7 dropped datasource.url from the schema).
+
+generator client {
+  provider            = "prisma-client"
+  output              = "../src/generated/mysql"
+  importFileExtension = "js"
+}
+
+datasource db {
+  provider = "mysql"
+}
+
+/// User and assistant messages; tool results update the assistant row's tool_calls.
+model AiMessage {
+  id            String    @id @default(cuid()) @db.Char(36)
+  sessionId     String    @map("session_id") @db.VarChar(100)
+  historyId     String?   @map("history_id") @db.Char(36)
+  type          String    @db.VarChar(50)
+  content       String    @db.LongText
+  thoughts      Json?
+  model         String?   @db.VarChar(100)
+  tokens        Json?
+  toolCalls     Json?     @map("tool_calls")
+  agentId       String?   @map("agent_id") @db.VarChar(100)
+  metadata      Json?
+  device        String?   @map("device") @db.VarChar(100)
+  createdAt     DateTime  @default(now()) @map("created_at") @db.Timestamp(0)
+  updatedAt     DateTime  @default(now()) @updatedAt @map("updated_at") @db.Timestamp(0)
+  deletedAt     DateTime? @map("deleted_at") @db.Timestamp(0)
+
+  // Relations
+  history       AiChatHistory? @relation(fields: [historyId], references: [id], onDelete: NoAction)
+
+  @@index([sessionId], map: "idx_session")
+  @@index([historyId], map: "idx_history")
+  @@index([createdAt], map: "idx_created")
+  @@index([deletedAt], map: "idx_deleted")
+  @@index([agentId], map: "idx_agent")
+  @@index([sessionId, agentId, type, createdAt], map: "idx_session_agent_type_created")
+  @@index([sessionId, historyId, deletedAt, type, createdAt, id], map: "idx_tool_call_lookup")
+  @@index([sessionId, deletedAt, updatedAt, id], map: "idx_archive_recovery")
+  @@map("ai_messages")
+}
+
+/// Per-session rollup, maintained incrementally by the projector.
+model AiChatHistory {
+  id             String    @id @default(cuid()) @db.Char(36)
+  sessionId      String    @map("session_id") @db.VarChar(100)
+  title          String?   @db.VarChar(255)
+  summary        String?   @db.Text
+  messageCount   Int       @default(0) @map("message_count")
+  totalTokens    BigInt    @default(0) @map("total_tokens")
+  firstMessageAt DateTime? @map("first_message_at") @db.DateTime(6)
+  lastMessageAt  DateTime? @map("last_message_at") @db.DateTime(6)
+  metadata       Json?
+  device         String?   @map("device") @db.VarChar(100)
+  deletedAt      DateTime? @map("deleted_at") @db.DateTime(6)
+
+  // Relations
+  messages       AiMessage[]
+
+  @@index([sessionId], map: "idx_chat_history_session")
+  @@index([deletedAt], map: "idx_chat_history_deleted")
+  @@map("ai_chat_histories")
+}

package/prisma/schema.postgresql.prisma

@@ -0,0 +1,70 @@
+// Prisma schema for the dsh-storage database backend — PostgreSQL variant (Prisma 7).
+//
+// Same models as schema.mysql.prisma, with PostgreSQL native types
+// (`@db.Text` instead of `@db.LongText`, `@db.Timestamp` instead of
+// `@db.DateTime`). Client pre-generation and table creation work as described
+// in schema.mysql.prisma's header.
+
+generator client {
+  provider            = "prisma-client"
+  output              = "../src/generated/postgresql"
+  importFileExtension = "js"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+/// User and assistant messages; tool results update the assistant row's tool_calls.
+model AiMessage {
+  id            String    @id @default(cuid()) @db.Char(36)
+  sessionId     String    @map("session_id") @db.VarChar(100)
+  historyId     String?   @map("history_id") @db.Char(36)
+  type          String    @db.VarChar(50)
+  content       String    @db.Text
+  thoughts      Json?
+  model         String?   @db.VarChar(100)
+  tokens        Json?
+  toolCalls     Json?     @map("tool_calls")
+  agentId       String?   @map("agent_id") @db.VarChar(100)
+  metadata      Json?
+  device        String?   @map("device") @db.VarChar(100)
+  createdAt     DateTime  @default(now()) @map("created_at") @db.Timestamp(0)
+  updatedAt     DateTime  @default(now()) @updatedAt @map("updated_at") @db.Timestamp(0)
+  deletedAt     DateTime? @map("deleted_at") @db.Timestamp(0)
+
+  // Relations
+  history       AiChatHistory? @relation(fields: [historyId], references: [id], onDelete: NoAction)
+
+  @@index([sessionId], map: "idx_session")
+  @@index([historyId], map: "idx_history")
+  @@index([createdAt], map: "idx_created")
+  @@index([deletedAt], map: "idx_deleted")
+  @@index([agentId], map: "idx_agent")
+  @@index([sessionId, agentId, type, createdAt], map: "idx_session_agent_type_created")
+  @@index([sessionId, historyId, deletedAt, type, createdAt, id], map: "idx_tool_call_lookup")
+  @@index([sessionId, deletedAt, updatedAt, id], map: "idx_archive_recovery")
+  @@map("ai_messages")
+}
+
+/// Per-session rollup, maintained incrementally by the projector.
+model AiChatHistory {
+  id             String    @id @default(cuid()) @db.Char(36)
+  sessionId      String    @map("session_id") @db.VarChar(100)
+  title          String?   @db.VarChar(255)
+  summary        String?   @db.Text
+  messageCount   Int       @default(0) @map("message_count")
+  totalTokens    BigInt    @default(0) @map("total_tokens")
+  firstMessageAt DateTime? @map("first_message_at") @db.Timestamp(6)
+  lastMessageAt  DateTime? @map("last_message_at") @db.Timestamp(6)
+  metadata       Json?
+  device         String?   @map("device") @db.VarChar(100)
+  deletedAt      DateTime? @map("deleted_at") @db.Timestamp(6)
+
+  // Relations
+  messages       AiMessage[]
+
+  @@index([sessionId], map: "idx_chat_history_session")
+  @@index([deletedAt], map: "idx_chat_history_deleted")
+  @@map("ai_chat_histories")
+}