@apart-tech/intelligence-core 1.17.3 → 1.19.0

package/prisma/schema.prisma

@@ -20,30 +20,36 @@ model Organization {
   stripeSubscriptionId String?   @map("stripe_subscription_id") @db.VarChar(255)
   currentPeriodEnd     DateTime? @map("current_period_end") @db.Timestamptz
 
-  nodes           Node[]
-  edges           Edge[]
-  domains         Domain[]
-  apiKeys         ApiKey[]
-  workspaces      Workspace[]
-  embeddingConfig OrgEmbeddingConfig?
-  piiConfig       OrgPiiConfig?
-  agentConfig     OrgAgentConfig?
-  agentRuns       AgentRun[]
-  agentSchedules  AgentSchedule[]
-  memberships     Membership[]
-  invites         Invite[]
-  orgAgentTypes   OrgAgentType[]
-  orgMcpServers   OrgMcpServer[]
-  usageRecords    UsageRecord[]
-  quotaOverrides      QuotaOverride[]
-  onboardingPackages  OnboardingPackage[]
-  billingEvents       BillingEvent[]
-  searchMetrics       SearchMetric[]
-  tagDefinitions      TagDefinition[]
-  nodeTags            NodeTag[]
-  nodeChunks          NodeChunk[]
-  piiQueryLogs        PiiQueryLog[]
-  documents           Document[]
+  nodes              Node[]
+  edges              Edge[]
+  domains            Domain[]
+  apiKeys            ApiKey[]
+  workspaces         Workspace[]
+  embeddingConfig    OrgEmbeddingConfig?
+  piiConfig          OrgPiiConfig?
+  agentConfig        OrgAgentConfig?
+  agentRuns          AgentRun[]
+  agentSchedules     AgentSchedule[]
+  memberships        Membership[]
+  invites            Invite[]
+  orgAgentTypes      OrgAgentType[]
+  orgMcpServers      OrgMcpServer[]
+  usageRecords       UsageRecord[]
+  quotaOverrides     QuotaOverride[]
+  onboardingPackages OnboardingPackage[]
+  billingEvents      BillingEvent[]
+  searchMetrics      SearchMetric[]
+  agentInstructions  AgentInstruction[]
+  tagDefinitions     TagDefinition[]
+  nodeTags           NodeTag[]
+  nodeChunks         NodeChunk[]
+  piiQueryLogs       PiiQueryLog[]
+  documents          Document[]
+  llmProviders       OrgLlmProvider[]
+  chatSessions       ChatSession[]
+  chatMessages       ChatMessage[]
+  chatGuidelines     OrgChatGuideline[]
+  priorityDocuments  OrgPriorityDocument[]
 
   @@map("organizations")
 }
@@ -173,22 +179,22 @@ model Domain {
 }
 
 model Node {
-  id             String                   @id @default(uuid()) @db.Uuid
-  type           String                   @db.VarChar(100)
-  title          String                   @db.VarChar(500)
-  content        String                   @default("") @db.Text
-  embedding      Unsupported("vector")?
-  searchVector   Unsupported("tsvector")? @map("search_vector")
-  metadata       Json                     @default("{}")
-  status         String                   @default("draft") @db.VarChar(20)
-  createdBy      String                   @map("created_by") @db.VarChar(255)
-  createdAt      DateTime                 @default(now()) @map("created_at") @db.Timestamptz
-  updatedAt      DateTime                 @default(now()) @map("updated_at") @db.Timestamptz
-  version        Int                      @default(1)
-  hasPii            Boolean                  @default(false) @map("has_pii")
-  embeddingPiiMode  String?                  @map("embedding_pii_mode") @db.VarChar(20)
-  domainId          String?                  @map("domain_id") @db.Uuid
-  organizationId    String                   @map("organization_id") @db.Uuid
+  id               String                   @id @default(uuid()) @db.Uuid
+  type             String                   @db.VarChar(100)
+  title            String                   @db.VarChar(500)
+  content          String                   @default("") @db.Text
+  embedding        Unsupported("vector")?
+  searchVector     Unsupported("tsvector")? @map("search_vector")
+  metadata         Json                     @default("{}")
+  status           String                   @default("draft") @db.VarChar(20)
+  createdBy        String                   @map("created_by") @db.VarChar(255)
+  createdAt        DateTime                 @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt        DateTime                 @default(now()) @map("updated_at") @db.Timestamptz
+  version          Int                      @default(1)
+  hasPii           Boolean                  @default(false) @map("has_pii")
+  embeddingPiiMode String?                  @map("embedding_pii_mode") @db.VarChar(20)
+  domainId         String?                  @map("domain_id") @db.Uuid
+  organizationId   String                   @map("organization_id") @db.Uuid
 
   sourceEdges  Edge[]       @relation("SourceNode")
   targetEdges  Edge[]       @relation("TargetNode")
@@ -207,19 +213,19 @@ model Node {
 }
 
 model NodeChunk {
-  id               String                   @id @default(uuid()) @db.Uuid
-  nodeId           String                   @map("node_id") @db.Uuid
-  chunkIndex       Int                      @map("chunk_index")
-  content          String                   @db.Text
-  tokenCount       Int                      @map("token_count")
-  headingContext   String?                  @map("heading_context") @db.VarChar(500)
-  startOffset      Int                      @map("start_offset")
-  endOffset        Int                      @map("end_offset")
-  overlapPrev      Int                      @default(0) @map("overlap_prev")
+  id               String                 @id @default(uuid()) @db.Uuid
+  nodeId           String                 @map("node_id") @db.Uuid
+  chunkIndex       Int                    @map("chunk_index")
+  content          String                 @db.Text
+  tokenCount       Int                    @map("token_count")
+  headingContext   String?                @map("heading_context") @db.VarChar(500)
+  startOffset      Int                    @map("start_offset")
+  endOffset        Int                    @map("end_offset")
+  overlapPrev      Int                    @default(0) @map("overlap_prev")
   embedding        Unsupported("vector")?
-  embeddingPiiMode String?                  @map("embedding_pii_mode") @db.VarChar(20)
-  organizationId   String                   @map("organization_id") @db.Uuid
-  createdAt        DateTime                 @default(now()) @map("created_at") @db.Timestamptz
+  embeddingPiiMode String?                @map("embedding_pii_mode") @db.VarChar(20)
+  organizationId   String                 @map("organization_id") @db.Uuid
+  createdAt        DateTime               @default(now()) @map("created_at") @db.Timestamptz
 
   node         Node         @relation(fields: [nodeId], references: [id], onDelete: Cascade)
   organization Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
@@ -326,11 +332,12 @@ model OrgAgentType {
   secretEnvMapping      Json     @default("{}") @map("secret_env_mapping")
   dynamicSecrets        String[] @default([]) @map("dynamic_secrets")
 
-  organization  Organization    @relation(fields: [organizationId], references: [id], onDelete: Cascade)
-  createdByUser User?           @relation("OrgAgentTypeCreatedBy", fields: [createdByUserId], references: [id], onDelete: SetNull)
-  agentRuns     AgentRun[]      @relation("AgentRunAgent")
-  schedules     AgentSchedule[] @relation("AgentScheduleAgent")
-  apiKeys       ApiKey[]        @relation("ApiKeyAgent")
+  organization  Organization       @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  createdByUser User?              @relation("OrgAgentTypeCreatedBy", fields: [createdByUserId], references: [id], onDelete: SetNull)
+  agentRuns     AgentRun[]         @relation("AgentRunAgent")
+  schedules     AgentSchedule[]    @relation("AgentScheduleAgent")
+  apiKeys       ApiKey[]           @relation("ApiKeyAgent")
+  instructions  AgentInstruction[] @relation("AgentTypeInstructions")
 
   @@unique([organizationId, slug], map: "uq_org_agent_type_org_slug")
   @@index([organizationId], map: "idx_org_agent_types_organization")
@@ -376,13 +383,21 @@ model AgentRun {
   parentAgentRunId String?   @map("parent_agent_run_id") @db.Uuid
   actClaim         Json?     @map("act_claim")
   capturedAbility  Json?     @map("captured_ability")
-
-  organization  Organization   @relation(fields: [organizationId], references: [id], onDelete: Cascade)
-  schedule      AgentSchedule? @relation(fields: [scheduleId], references: [id], onDelete: SetNull)
-  agent         OrgAgentType?  @relation("AgentRunAgent", fields: [agentId], references: [id], onDelete: SetNull)
-  invokedByUser User?          @relation("AgentRunInvokedBy", fields: [invokedByUserId], references: [id], onDelete: SetNull)
-  parent        AgentRun?      @relation("AgentRunParent", fields: [parentAgentRunId], references: [id], onDelete: SetNull)
-  children      AgentRun[]     @relation("AgentRunParent")
+  instructionId    String?   @map("instruction_id") @db.Uuid
+  reasoningTrace   Json?     @map("reasoning_trace")
+  toolsCalled      Json?     @map("tools_called")
+  outcome          Json?
+  confidence       Decimal?  @db.Decimal
+  taskType         String?   @map("task_type") @db.VarChar(100)
+  outcomeStatus    String?   @map("outcome_status") @db.VarChar(30)
+
+  organization  Organization      @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  schedule      AgentSchedule?    @relation(fields: [scheduleId], references: [id], onDelete: SetNull)
+  agent         OrgAgentType?     @relation("AgentRunAgent", fields: [agentId], references: [id], onDelete: SetNull)
+  invokedByUser User?             @relation("AgentRunInvokedBy", fields: [invokedByUserId], references: [id], onDelete: SetNull)
+  parent        AgentRun?         @relation("AgentRunParent", fields: [parentAgentRunId], references: [id], onDelete: SetNull)
+  children      AgentRun[]        @relation("AgentRunParent")
+  instruction   AgentInstruction? @relation(fields: [instructionId], references: [id], onDelete: SetNull)
 
   @@index([organizationId], map: "idx_agent_runs_organization")
   @@index([status], map: "idx_agent_runs_status")
@@ -391,9 +406,46 @@ model AgentRun {
   @@index([agentId], map: "idx_agent_runs_agent_id")
   @@index([invokedByUserId], map: "idx_agent_runs_invoked_by_user_id")
   @@index([parentAgentRunId], map: "idx_agent_runs_parent_agent_run_id")
+  @@index([instructionId], map: "idx_agent_runs_instruction")
+  @@index([taskType, status], map: "idx_agent_runs_task_type")
   @@map("agent_runs")
 }
 
+model AgentInstruction {
+  id              String    @id @default(uuid()) @db.Uuid
+  organizationId  String    @map("organization_id") @db.Uuid
+  agentTypeId     String?   @map("agent_type_id") @db.Uuid
+  taskType        String?   @map("task_type") @db.VarChar(100)
+  version         String    @db.VarChar(20)
+  status          String    @default("draft") @db.VarChar(20)
+  systemPrompt    String    @default("") @map("system_prompt") @db.Text
+  tools           Json      @default("[]")
+  guardrails      Json      @default("{}")
+  modelConfig     Json      @default("{}") @map("model_config")
+  contentHash     String?   @map("content_hash") @db.VarChar(64)
+  parentVersionId String?   @map("parent_version_id") @db.Uuid
+  changeNote      String?   @map("change_note") @db.Text
+  publishedAt     DateTime? @map("published_at") @db.Timestamptz
+  deprecatedAt    DateTime? @map("deprecated_at") @db.Timestamptz
+  effectiveFrom   DateTime? @map("effective_from") @db.Timestamptz
+  effectiveTo     DateTime? @map("effective_to") @db.Timestamptz
+  createdBy       String    @map("created_by") @db.VarChar(255)
+  createdAt       DateTime  @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt       DateTime  @default(now()) @map("updated_at") @db.Timestamptz
+
+  organization  Organization       @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  agentType     OrgAgentType?      @relation("AgentTypeInstructions", fields: [agentTypeId], references: [id], onDelete: SetNull)
+  parentVersion AgentInstruction?  @relation("InstructionVersionChain", fields: [parentVersionId], references: [id], onDelete: SetNull)
+  childVersions AgentInstruction[] @relation("InstructionVersionChain")
+  agentRuns     AgentRun[]
+
+  @@index([organizationId], map: "idx_agent_instructions_org")
+  @@index([agentTypeId], map: "idx_agent_instructions_agent_type")
+  @@index([organizationId, agentTypeId, taskType, status, publishedAt(sort: Desc)], map: "idx_agent_instructions_org_agent_status")
+  @@index([contentHash], map: "idx_agent_instructions_hash")
+  @@map("agent_instructions")
+}
+
 model AgentSchedule {
   id                String    @id @default(uuid()) @db.Uuid
   organizationId    String    @map("organization_id") @db.Uuid
@@ -494,32 +546,32 @@ model UsageRecord {
 // ── Tag System ──────────────────────────────────────────────────────────────
 
 model TagDefinition {
-  id                  String    @id @default(uuid()) @db.Uuid
-  organizationId      String?   @map("organization_id") @db.Uuid
-  tagName             String    @map("tag_name") @db.VarChar(100)
-  tagType             String    @map("tag_type") @db.VarChar(20)
-  cardinality         String    @default("singleton") @db.VarChar(10)
-  source              String    @default("extracted") @db.VarChar(20)
-  status              String    @default("active") @map("status") @db.VarChar(20)
-  description         String    @default("") @db.Text
-  category            String?   @map("category") @db.VarChar(50)
-  labels              Json?     @map("labels") @db.JsonB
-  applicableNodeTypes Json      @default("[]") @map("applicable_node_types")
-  requiredForNodeTypes Json     @default("[]") @map("required_for_node_types")
-  enumValues          Json?     @map("enum_values")
-  enumVersion         Int       @default(1) @map("enum_version")
-  dependsOn           Json      @default("[]") @map("depends_on")
-  autoAcceptThreshold Float?    @map("auto_accept_threshold") @db.Real
-  parentDefinitionId  String?   @map("parent_definition_id") @db.Uuid
-  replacedBy          String?   @map("replaced_by") @db.Uuid
-  deprecatedAt        DateTime? @map("deprecated_at") @db.Timestamptz
-  createdAt           DateTime  @default(now()) @map("created_at") @db.Timestamptz
-  createdBy           String    @map("created_by") @db.VarChar(255)
-
-  organization   Organization?  @relation(fields: [organizationId], references: [id], onDelete: Cascade)
-  parentDef      TagDefinition? @relation("TagDefHierarchy", fields: [parentDefinitionId], references: [id])
+  id                   String    @id @default(uuid()) @db.Uuid
+  organizationId       String?   @map("organization_id") @db.Uuid
+  tagName              String    @map("tag_name") @db.VarChar(100)
+  tagType              String    @map("tag_type") @db.VarChar(20)
+  cardinality          String    @default("singleton") @db.VarChar(10)
+  source               String    @default("extracted") @db.VarChar(20)
+  status               String    @default("active") @map("status") @db.VarChar(20)
+  description          String    @default("") @db.Text
+  category             String?   @map("category") @db.VarChar(50)
+  labels               Json?     @map("labels") @db.JsonB
+  applicableNodeTypes  Json      @default("[]") @map("applicable_node_types")
+  requiredForNodeTypes Json      @default("[]") @map("required_for_node_types")
+  enumValues           Json?     @map("enum_values")
+  enumVersion          Int       @default(1) @map("enum_version")
+  dependsOn            Json      @default("[]") @map("depends_on")
+  autoAcceptThreshold  Float?    @map("auto_accept_threshold") @db.Real
+  parentDefinitionId   String?   @map("parent_definition_id") @db.Uuid
+  replacedBy           String?   @map("replaced_by") @db.Uuid
+  deprecatedAt         DateTime? @map("deprecated_at") @db.Timestamptz
+  createdAt            DateTime  @default(now()) @map("created_at") @db.Timestamptz
+  createdBy            String    @map("created_by") @db.VarChar(255)
+
+  organization   Organization?   @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  parentDef      TagDefinition?  @relation("TagDefHierarchy", fields: [parentDefinitionId], references: [id])
   childDefs      TagDefinition[] @relation("TagDefHierarchy")
-  replacementDef TagDefinition? @relation("TagDefReplacement", fields: [replacedBy], references: [id])
+  replacementDef TagDefinition?  @relation("TagDefReplacement", fields: [replacedBy], references: [id])
   replacedDefs   TagDefinition[] @relation("TagDefReplacement")
   tags           NodeTag[]
 
@@ -530,25 +582,25 @@ model TagDefinition {
 }
 
 model NodeTag {
-  id                 String    @id @default(uuid()) @db.Uuid
-  nodeId             String    @map("node_id") @db.Uuid
-  organizationId     String    @map("organization_id") @db.Uuid
-  tagDefinitionId    String    @map("tag_definition_id") @db.Uuid
-  tagName            String    @map("tag_name") @db.VarChar(100)
-  isSingleton        Boolean   @default(false) @map("is_singleton")
-
-  valueText          String?   @map("value_text") @db.Text
-  valueNum           Float?    @map("value_num") @db.DoublePrecision
-  valueCurrency      String?   @map("value_currency") @db.Char(3)
-  valueUnit          String?   @map("value_unit") @db.VarChar(20)
-  valueDate          DateTime? @map("value_date") @db.Timestamptz
-  valueRef           String?   @map("value_ref") @db.Uuid
-
-  textSpan           String?   @map("text_span") @db.Text
-  offsetStart        Int?      @map("offset_start")
-  offsetEnd          Int?      @map("offset_end")
-  contentVersion     Int?      @map("content_version")
-  attrs              Json      @default("{}") @db.JsonB
+  id              String  @id @default(uuid()) @db.Uuid
+  nodeId          String  @map("node_id") @db.Uuid
+  organizationId  String  @map("organization_id") @db.Uuid
+  tagDefinitionId String  @map("tag_definition_id") @db.Uuid
+  tagName         String  @map("tag_name") @db.VarChar(100)
+  isSingleton     Boolean @default(false) @map("is_singleton")
+
+  valueText     String?   @map("value_text") @db.Text
+  valueNum      Float?    @map("value_num") @db.DoublePrecision
+  valueCurrency String?   @map("value_currency") @db.Char(3)
+  valueUnit     String?   @map("value_unit") @db.VarChar(20)
+  valueDate     DateTime? @map("value_date") @db.Timestamptz
+  valueRef      String?   @map("value_ref") @db.Uuid
+
+  textSpan       String? @map("text_span") @db.Text
+  offsetStart    Int?    @map("offset_start")
+  offsetEnd      Int?    @map("offset_end")
+  contentVersion Int?    @map("content_version")
+  attrs          Json    @default("{}") @db.JsonB
 
   taggedBy           String    @map("tagged_by") @db.VarChar(255)
   modelId            String?   @map("model_id") @db.VarChar(100)
@@ -560,14 +612,14 @@ model NodeTag {
   supersededBy       String?   @map("superseded_by") @db.Uuid
   batchId            String?   @map("batch_id") @db.Uuid
 
-  createdAt          DateTime  @default(now()) @map("created_at") @db.Timestamptz
-  updatedAt          DateTime  @default(now()) @map("updated_at") @db.Timestamptz
+  createdAt DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt DateTime @default(now()) @map("updated_at") @db.Timestamptz
 
-  node          Node          @relation(fields: [nodeId], references: [id], onDelete: Cascade)
-  organization  Organization  @relation(fields: [organizationId], references: [id], onDelete: Cascade)
-  tagDefinition TagDefinition @relation(fields: [tagDefinitionId], references: [id])
-  supersedes    NodeTag?      @relation("TagSupersession", fields: [supersededBy], references: [id])
-  supersededTags NodeTag[]    @relation("TagSupersession")
+  node           Node          @relation(fields: [nodeId], references: [id], onDelete: Cascade)
+  organization   Organization  @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  tagDefinition  TagDefinition @relation(fields: [tagDefinitionId], references: [id])
+  supersedes     NodeTag?      @relation("TagSupersession", fields: [supersededBy], references: [id])
+  supersededTags NodeTag[]     @relation("TagSupersession")
 
   @@index([nodeId], map: "idx_node_tags_node")
   @@index([organizationId, tagName], map: "idx_node_tags_org_name")
@@ -577,25 +629,25 @@ model NodeTag {
 }
 
 model NodeTagHistory {
-  id                 String    @id @default(uuid()) @db.Uuid
-  tagId              String    @map("tag_id") @db.Uuid
-  nodeId             String    @map("node_id") @db.Uuid
-  organizationId     String    @map("organization_id") @db.Uuid
-  tagName            String    @map("tag_name") @db.VarChar(100)
-
-  valueText          String?   @map("value_text") @db.Text
-  valueNum           Float?    @map("value_num") @db.DoublePrecision
-  valueCurrency      String?   @map("value_currency") @db.Char(3)
-  valueUnit          String?   @map("value_unit") @db.VarChar(20)
-  valueDate          DateTime? @map("value_date") @db.Timestamptz
-  valueRef           String?   @map("value_ref") @db.Uuid
-
-  validFrom          DateTime  @map("valid_from") @db.Timestamptz
-  validUntil         DateTime  @map("valid_until") @db.Timestamptz
-  systemFrom         DateTime  @map("system_from") @db.Timestamptz
-  systemTo           DateTime? @map("system_to") @db.Timestamptz
-
-  replacedBy         String    @map("replaced_by") @db.VarChar(255)
+  id             String @id @default(uuid()) @db.Uuid
+  tagId          String @map("tag_id") @db.Uuid
+  nodeId         String @map("node_id") @db.Uuid
+  organizationId String @map("organization_id") @db.Uuid
+  tagName        String @map("tag_name") @db.VarChar(100)
+
+  valueText     String?   @map("value_text") @db.Text
+  valueNum      Float?    @map("value_num") @db.DoublePrecision
+  valueCurrency String?   @map("value_currency") @db.Char(3)
+  valueUnit     String?   @map("value_unit") @db.VarChar(20)
+  valueDate     DateTime? @map("value_date") @db.Timestamptz
+  valueRef      String?   @map("value_ref") @db.Uuid
+
+  validFrom  DateTime  @map("valid_from") @db.Timestamptz
+  validUntil DateTime  @map("valid_until") @db.Timestamptz
+  systemFrom DateTime  @map("system_from") @db.Timestamptz
+  systemTo   DateTime? @map("system_to") @db.Timestamptz
+
+  replacedBy String @map("replaced_by") @db.VarChar(255)
 
   @@index([nodeId, tagName, validFrom], map: "idx_tag_history_node_name_time")
   @@index([organizationId, tagName, validFrom], map: "idx_tag_history_org_name_time")
@@ -604,16 +656,16 @@ model NodeTagHistory {
 }
 
 model NodeTagAudit {
-  id          String   @id @default(uuid()) @db.Uuid
-  tagId       String   @map("tag_id") @db.Uuid
-  nodeId      String   @map("node_id") @db.Uuid
-  orgId       String   @map("organization_id") @db.Uuid
-  action      String   @map("action") @db.VarChar(20)
-  oldValue    Json?    @map("old_value") @db.JsonB
-  newValue    Json?    @map("new_value") @db.JsonB
-  actorId     String   @map("actor_id") @db.Uuid
-  reason      String?  @db.Text
-  createdAt   DateTime @default(now()) @map("created_at") @db.Timestamptz
+  id        String   @id @default(uuid()) @db.Uuid
+  tagId     String   @map("tag_id") @db.Uuid
+  nodeId    String   @map("node_id") @db.Uuid
+  orgId     String   @map("organization_id") @db.Uuid
+  action    String   @map("action") @db.VarChar(20)
+  oldValue  Json?    @map("old_value") @db.JsonB
+  newValue  Json?    @map("new_value") @db.JsonB
+  actorId   String   @map("actor_id") @db.Uuid
+  reason    String?  @db.Text
+  createdAt DateTime @default(now()) @map("created_at") @db.Timestamptz
 
   @@index([tagId], map: "idx_tag_audit_tag")
   @@index([nodeId], map: "idx_tag_audit_node")
@@ -642,25 +694,25 @@ model QuotaOverride {
 // ── Document Archive ────────────────────────────────────────────────────────
 
 model Document {
-  id              String    @id @default(dbgenerated("gen_random_uuid()")) @db.Uuid
-  organizationId  String    @map("organization_id") @db.Uuid
-  fileName        String    @map("file_name") @db.VarChar(500)
-  mimeType        String    @map("mime_type") @db.VarChar(100)
-  fileSizeBytes   Int       @map("file_size_bytes")
-  storagePath     String    @map("storage_path") @db.VarChar(1000)
-  contentHash     String?   @map("content_hash") @db.VarChar(64)
-  status          String    @default("uploading") @db.VarChar(20)
-  ocrModel        String?   @map("ocr_model") @db.VarChar(100)
-  ocrTokensIn     Int?      @map("ocr_tokens_in")
-  ocrTokensOut    Int?      @map("ocr_tokens_out")
-  pageCount       Int?      @map("page_count")
-  nodeId          String?   @map("node_id") @db.Uuid
-  errorMessage    String?   @map("error_message")
-  createdBy       String    @map("created_by") @db.VarChar(255)
-  createdAt       DateTime  @default(now()) @map("created_at") @db.Timestamptz
-  updatedAt       DateTime  @updatedAt @map("updated_at") @db.Timestamptz
+  id             String   @id @default(dbgenerated("gen_random_uuid()")) @db.Uuid
+  organizationId String   @map("organization_id") @db.Uuid
+  fileName       String   @map("file_name") @db.VarChar(500)
+  mimeType       String   @map("mime_type") @db.VarChar(100)
+  fileSizeBytes  Int      @map("file_size_bytes")
+  storagePath    String   @map("storage_path") @db.VarChar(1000)
+  contentHash    String?  @map("content_hash") @db.VarChar(64)
+  status         String   @default("uploading") @db.VarChar(20)
+  ocrModel       String?  @map("ocr_model") @db.VarChar(100)
+  ocrTokensIn    Int?     @map("ocr_tokens_in")
+  ocrTokensOut   Int?     @map("ocr_tokens_out")
+  pageCount      Int?     @map("page_count")
+  nodeId         String?  @map("node_id") @db.Uuid
+  errorMessage   String?  @map("error_message")
+  createdBy      String   @map("created_by") @db.VarChar(255)
+  createdAt      DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt      DateTime @updatedAt @map("updated_at") @db.Timestamptz
 
-  organization    Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+  organization Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
 
   @@index([organizationId, contentHash], map: "idx_documents_org_hash")
   @@index([organizationId, status], map: "idx_documents_org_status")
@@ -728,3 +780,106 @@ model SearchMetric {
   @@index([organizationId, createdAt], map: "idx_search_metrics_org_time")
   @@map("search_metrics")
 }
+
+// ── Chat Gateway ────────────────────────────────────────────────────────────
+
+model OrgLlmProvider {
+  id                String   @id @default(uuid()) @db.Uuid
+  organizationId    String   @map("organization_id") @db.Uuid
+  provider          String   @db.VarChar(30)
+  displayName       String   @map("display_name") @db.VarChar(200)
+  encryptedApiKey   String   @map("encrypted_api_key") @db.Text
+  baseUrl           String?  @map("base_url") @db.VarChar(500)
+  models            String[]
+  defaultModel      String?  @map("default_model") @db.VarChar(100)
+  dataResidency     String   @default("any") @map("data_residency") @db.VarChar(10)
+  enabled           Boolean  @default(true)
+  priority          Int      @default(0)
+  maxTokensPerMin   Int?     @map("max_tokens_per_min")
+  createdAt         DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt         DateTime @default(now()) @map("updated_at") @db.Timestamptz
+
+  organization Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+
+  @@unique([organizationId, provider], map: "uq_org_llm_provider_org_provider")
+  @@index([organizationId], map: "idx_org_llm_providers_org")
+  @@map("org_llm_providers")
+}
+
+model ChatSession {
+  id             String   @id @default(uuid()) @db.Uuid
+  organizationId String   @map("organization_id") @db.Uuid
+  userId         String   @map("user_id") @db.Uuid
+  title          String?  @db.VarChar(500)
+  privacy        String   @default("private") @db.VarChar(20)
+  status         String   @default("active") @db.VarChar(20)
+  workspaceId    String?  @map("workspace_id") @db.Uuid
+  graphCaptured  Boolean  @default(false) @map("graph_captured")
+  createdAt      DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt      DateTime @default(now()) @map("updated_at") @db.Timestamptz
+
+  messages     ChatMessage[]
+  organization Organization  @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+
+  @@index([organizationId, userId, createdAt], map: "idx_chat_sessions_org_user_time")
+  @@index([organizationId, privacy, createdAt], map: "idx_chat_sessions_org_privacy_time")
+  @@map("chat_sessions")
+}
+
+model ChatMessage {
+  id             String   @id @default(uuid()) @db.Uuid
+  sessionId      String   @map("session_id") @db.Uuid
+  organizationId String   @map("organization_id") @db.Uuid
+  role           String   @db.VarChar(20)
+  content        String   @db.Text
+  contentClean   String?  @map("content_clean") @db.Text
+  model          String?  @db.VarChar(100)
+  providerId     String?  @map("provider_id") @db.Uuid
+  tokensIn       Int?     @map("tokens_in")
+  tokensOut      Int?     @map("tokens_out")
+  costCents      Int?     @map("cost_cents")
+  durationMs     Int?     @map("duration_ms")
+  piiDetected    Boolean  @default(false) @map("pii_detected")
+  piiReport      Json?    @map("pii_report")
+  contextNodeIds String[] @default([]) @map("context_node_ids")
+  documentIds    String[] @default([]) @map("document_ids")
+  createdAt      DateTime @default(now()) @map("created_at") @db.Timestamptz
+
+  session      ChatSession  @relation(fields: [sessionId], references: [id], onDelete: Cascade)
+  organization Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+
+  @@index([sessionId, createdAt], map: "idx_chat_messages_session_time")
+  @@index([organizationId, createdAt], map: "idx_chat_messages_org_time")
+  @@map("chat_messages")
+}
+
+model OrgChatGuideline {
+  id             String   @id @default(uuid()) @db.Uuid
+  organizationId String   @map("organization_id") @db.Uuid
+  title          String   @db.VarChar(200)
+  content        String   @db.Text
+  priority       Int      @default(0)
+  enabled        Boolean  @default(true)
+  createdAt      DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt      DateTime @default(now()) @map("updated_at") @db.Timestamptz
+
+  organization Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+
+  @@index([organizationId], map: "idx_org_chat_guidelines_org")
+  @@map("org_chat_guidelines")
+}
+
+model OrgPriorityDocument {
+  id             String   @id @default(uuid()) @db.Uuid
+  organizationId String   @map("organization_id") @db.Uuid
+  nodeId         String   @map("node_id") @db.Uuid
+  boostWeight    Int      @default(1) @map("boost_weight")
+  createdAt      DateTime @default(now()) @map("created_at") @db.Timestamptz
+  updatedAt      DateTime @default(now()) @map("updated_at") @db.Timestamptz
+
+  organization Organization @relation(fields: [organizationId], references: [id], onDelete: Cascade)
+
+  @@unique([organizationId, nodeId], map: "uq_org_priority_doc_org_node")
+  @@index([organizationId], map: "idx_org_priority_documents_org")
+  @@map("org_priority_documents")
+}