@intelligo-dev/core 1.0.0-beta.1 → 1.0.0-beta.13

package/src/db/migrations/meta/_journal.json

@@ -5,295 +5,22 @@
     {
       "idx": 0,
       "version": "7",
-      "when": 1770467636254,
-      "tag": "0000_sharp_night_nurse",
+      "when": 1789740313941,
+      "tag": "0000_baseline",
       "breakpoints": true
     },
     {
       "idx": 1,
       "version": "7",
-      "when": 1770475851108,
-      "tag": "0001_hesitant_vapor",
+      "when": 1789740314941,
+      "tag": "0001_reconcile_chain_built_databases",
       "breakpoints": true
     },
     {
       "idx": 2,
       "version": "7",
-      "when": 1770556082464,
-      "tag": "0002_numerous_lady_vermin",
-      "breakpoints": true
-    },
-    {
-      "idx": 3,
-      "version": "7",
-      "when": 1770606381406,
-      "tag": "0003_mighty_jean_grey",
-      "breakpoints": true
-    },
-    {
-      "idx": 4,
-      "version": "7",
-      "when": 1770743970189,
-      "tag": "0004_cynical_grandmaster",
-      "breakpoints": true
-    },
-    {
-      "idx": 5,
-      "version": "7",
-      "when": 1771267120497,
-      "tag": "0005_careful_switch",
-      "breakpoints": true
-    },
-    {
-      "idx": 6,
-      "version": "7",
-      "when": 1771340722768,
-      "tag": "0006_tense_blue_marvel",
-      "breakpoints": true
-    },
-    {
-      "idx": 7,
-      "version": "7",
-      "when": 1771390659372,
-      "tag": "0007_next_squadron_sinister",
-      "breakpoints": true
-    },
-    {
-      "idx": 8,
-      "version": "7",
-      "when": 1771666802968,
-      "tag": "0008_powerful_scream",
-      "breakpoints": true
-    },
-    {
-      "idx": 9,
-      "version": "7",
-      "when": 1771669888764,
-      "tag": "0009_sad_ink",
-      "breakpoints": true
-    },
-    {
-      "idx": 10,
-      "version": "7",
-      "when": 1771684216541,
-      "tag": "0010_shocking_omega_flight",
-      "breakpoints": true
-    },
-    {
-      "idx": 11,
-      "version": "7",
-      "when": 1775401944659,
-      "tag": "0011_ambiguous_otto_octavius",
-      "breakpoints": true
-    },
-    {
-      "idx": 12,
-      "version": "7",
-      "when": 1700000012000,
-      "tag": "0011_hnsw_vector_index",
-      "breakpoints": true
-    },
-    {
-      "idx": 13,
-      "version": "7",
-      "when": 1700000013000,
-      "tag": "0012_user_profiles",
-      "breakpoints": true
-    },
-    {
-      "idx": 14,
-      "version": "7",
-      "when": 1700000014000,
-      "tag": "0013_trending_seasonal_columns",
-      "breakpoints": true
-    },
-    {
-      "idx": 15,
-      "version": "7",
-      "when": 1700000015000,
-      "tag": "0014_add_product_type_to_agents",
-      "breakpoints": true
-    },
-    {
-      "idx": 16,
-      "version": "7",
-      "when": 1700000016000,
-      "tag": "0015_new_v1_tables",
-      "breakpoints": true
-    },
-    {
-      "idx": 17,
-      "version": "7",
-      "when": 1700000017000,
-      "tag": "0016_document_types",
-      "breakpoints": true
-    },
-    {
-      "idx": 18,
-      "version": "7",
-      "when": 1700000018000,
-      "tag": "0017_document_metadata",
-      "breakpoints": true
-    },
-    {
-      "idx": 19,
-      "version": "7",
-      "when": 1700000019000,
-      "tag": "0018_identity_graph",
-      "breakpoints": true
-    },
-    {
-      "idx": 20,
-      "version": "7",
-      "when": 1700000020000,
-      "tag": "0019_db_driven_prompts",
-      "breakpoints": true
-    },
-    {
-      "idx": 21,
-      "version": "7",
-      "when": 1700000021000,
-      "tag": "0020_pending_extractions",
-      "breakpoints": true
-    },
-    {
-      "idx": 22,
-      "version": "7",
-      "when": 1700000022000,
-      "tag": "0021_rag_documents",
-      "breakpoints": true
-    },
-    {
-      "idx": 23,
-      "version": "7",
-      "when": 1700000023000,
-      "tag": "0022_user_quotas_usage_jsonb",
-      "breakpoints": true
-    },
-    {
-      "idx": 24,
-      "version": "7",
-      "when": 1700000024000,
-      "tag": "0023_user_facts_user_scoped_unique",
-      "breakpoints": true
-    },
-    {
-      "idx": 25,
-      "version": "7",
-      "when": 1700000025000,
-      "tag": "0024_user_memories_hnsw",
-      "breakpoints": true
-    },
-    {
-      "idx": 26,
-      "version": "7",
-      "when": 1700000026000,
-      "tag": "0025_audit_trigger_errcode",
-      "breakpoints": true
-    },
-    {
-      "idx": 27,
-      "version": "7",
-      "when": 1700000027000,
-      "tag": "0026_user_profile_snapshots_composite_pk",
-      "breakpoints": true
-    },
-    {
-      "idx": 28,
-      "version": "7",
-      "when": 1700000028000,
-      "tag": "0027_billing_settings_mnt_columns",
-      "breakpoints": true
-    },
-    {
-      "idx": 29,
-      "version": "7",
-      "when": 1700000029000,
-      "tag": "0028_trial_credits_normalized_email",
-      "breakpoints": true
-    },
-    {
-      "idx": 30,
-      "version": "7",
-      "when": 1700000030000,
-      "tag": "0029_usage_records_conversation_idx",
-      "breakpoints": true
-    },
-    {
-      "idx": 31,
-      "version": "7",
-      "when": 1700000031000,
-      "tag": "0030_pending_extractions_composite_idx",
-      "breakpoints": true
-    },
-    {
-      "idx": 32,
-      "version": "7",
-      "when": 1700000032000,
-      "tag": "0031_rag_documents_hnsw",
-      "breakpoints": true
-    },
-    {
-      "idx": 33,
-      "version": "7",
-      "when": 1700000033000,
-      "tag": "0032_rate_limit_unique_idx",
-      "breakpoints": true
-    },
-    {
-      "idx": 34,
-      "version": "7",
-      "when": 1700000034000,
-      "tag": "0033_pending_extractions_partial_idx",
-      "breakpoints": true
-    },
-    {
-      "idx": 35,
-      "version": "7",
-      "when": 1700000035000,
-      "tag": "0034_rate_limit_count",
-      "breakpoints": true
-    },
-    {
-      "idx": 36,
-      "version": "7",
-      "when": 1700000036000,
-      "tag": "0035_credit_reservations",
-      "breakpoints": true
-    },
-    {
-      "idx": 37,
-      "version": "7",
-      "when": 1700000037000,
-      "tag": "0036_executions_audit_jobs",
-      "breakpoints": true
-    },
-    {
-      "idx": 38,
-      "version": "7",
-      "when": 1700000038000,
-      "tag": "0037_rate_limit_minute_bucket",
-      "breakpoints": true
-    },
-    {
-      "idx": 39,
-      "version": "7",
-      "when": 1700000039000,
-      "tag": "0038_user_quotas_generic_usage",
-      "breakpoints": true
-    },
-    {
-      "idx": 40,
-      "version": "7",
-      "when": 1700000040000,
-      "tag": "0039_platform_admin_impersonation",
-      "breakpoints": true
-    },
-    {
-      "idx": 41,
-      "version": "7",
-      "when": 1700000041000,
-      "tag": "0040_ee_audit_chain",
+      "when": 1789808201382,
+      "tag": "0002_webhook_claim_lease",
       "breakpoints": true
     }
   ]

package/src/db/schema/agents.ts

@@ -0,0 +1,57 @@
+import {
+  pgTable,
+  text,
+  timestamp,
+  integer,
+  boolean,
+  jsonb,
+} from "drizzle-orm/pg-core";
+
+/**
+ * Localized text, keyed by locale tag: `{ en: "…", de: "…" }`. Open, so
+ * adding a language is not a schema change.
+ */
+export type LocalizedText = Record<string, string>;
+
+/** A quick-start prompt shown for an agent. */
+export type AgentSuggestion = {
+  id: string;
+  label: LocalizedText;
+  prompt: LocalizedText;
+};
+
+/** Per-agent model routing. Only `primary` is read. */
+export type AgentModelConfig = {
+  primary: string;
+  fallback?: string;
+  routing?: Record<string, string>;
+};
+
+/** AI agent configuration: system prompt, tools and model per agent. */
+export const agents = pgTable("agents", {
+  id: text("id").primaryKey(), // Slug, e.g. "support-assistant"
+  name: jsonb("name").notNull().$type<LocalizedText>(), // { en: "Support Assistant", … }
+  description: jsonb("description").notNull().$type<LocalizedText>(), // { en: "…", … }
+  systemPromptKey: text("system_prompt_key").notNull(), // Translation namespace key; not read at runtime (systemPrompt is).
+  systemPrompt: jsonb("system_prompt").$type<LocalizedText | null>(), // Source of truth for agent instructions.
+  modelConfig: jsonb("model_config").$type<AgentModelConfig | null>(), // Only `primary` is read.
+  icon: text("icon").notNull(), // Icon identifier (e.g., "briefcase", "map-pin")
+  defaultModel: text("default_model").notNull(), // AI model ID (e.g., "openai/gpt-4o") — fallback when modelConfig is null.
+  maxSteps: integer("max_steps").notNull(), // ToolLoopAgent max iterations
+  contextWindowSize: integer("context_window_size").notNull(), // Conversation windowing message count
+  tools: jsonb("tools").notNull().default([]).$type<string[]>(), // Array of tool names
+  basePath: text("base_path").notNull(), // URL base path (e.g., "/support")
+  isActive: boolean("is_active").notNull().default(true), // Whether agent is available to users
+  suggestions: jsonb("suggestions")
+    .notNull()
+    .default([])
+    .$type<AgentSuggestion[]>(), // Quick-start suggestion prompts
+  isSystem: boolean("is_system").notNull().default(true), // System agents can't be deleted by users
+  featureKey: text("feature_key"), // Nullable: billing feature key (e.g., "support_assistant"). Used for feature gating lookups.
+  color: text("color").notNull().default("bg-gray-500"), // Tailwind bg class for UI indicators (e.g., "bg-blue-500")
+  createdAt: timestamp("created_at").notNull().defaultNow(),
+  updatedAt: timestamp("updated_at").notNull().defaultNow(),
+});
+
+export type Agent = typeof agents.$inferSelect;
+export type InsertAgent = typeof agents.$inferInsert;

package/src/db/schema/ai.ts

@@ -0,0 +1,174 @@
+/**
+ * Chat persistence every product shares: conversations, messages,
+ * attachments, votes and documents (artifact versions).
+ */
+
+import {
+  pgTable,
+  text,
+  timestamp,
+  integer,
+  index,
+  uniqueIndex,
+  boolean,
+  primaryKey,
+  jsonb,
+} from "drizzle-orm/pg-core";
+import { organization, users } from "./auth";
+
+/**
+ * A product that attaches typed state to a conversation puts it under
+ * `productContext` and owns the shape.
+ */
+export type ConversationMetadata = {
+  conversationSummary?: string; // LLM-generated summary of pruned messages
+  productContext?: Record<string, unknown>;
+  [key: string]: unknown;
+};
+
+/** One chat session between a user and an agent, within a workspace. */
+export const conversations = pgTable(
+  "conversations",
+  {
+    id: text("id").primaryKey(),
+    workspaceId: text("workspace_id")
+      .notNull()
+      .references(() => organization.id, { onDelete: "cascade" }),
+    userId: text("user_id")
+      .notNull()
+      .references(() => users.id, { onDelete: "cascade" }),
+    agentId: text("agent_id").notNull(), // the product's agent slug
+    title: text("title"), // Nullable until the product sets one
+    modelId: text("model_id"), // e.g., "openai/gpt-4o"
+    visibility: text("visibility").notNull().default("private"), // "private" | "public"
+    metadata: jsonb("metadata"), // ConversationMetadata
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    updatedAt: timestamp("updated_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("conversations_workspace_id_idx").on(table.workspaceId),
+    index("conversations_user_id_idx").on(table.userId),
+    index("conversations_workspace_updated_idx").on(
+      table.workspaceId,
+      table.updatedAt
+    ),
+    index("conversations_workspace_user_idx").on(
+      table.workspaceId,
+      table.userId
+    ),
+  ]
+);
+
+export const messages = pgTable(
+  "messages",
+  {
+    id: text("id").primaryKey(),
+    conversationId: text("conversation_id")
+      .notNull()
+      .references(() => conversations.id, { onDelete: "cascade" }),
+    role: text("role").notNull(), // "user" | "assistant" | "system" | "tool"
+    content: text("content"), // Nullable; `parts` holds the message
+    parts: text("parts").notNull(), // JSON array of AI SDK UIMessagePart objects
+    attachments: text("attachments"), // JSON array of file attachment metadata
+    toolInvocations: text("tool_invocations"), // JSON string of tool calls/results (AI SDK format)
+    tokenCount: integer("token_count"),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("messages_conversation_id_idx").on(table.conversationId),
+    index("messages_conversation_created_idx").on(
+      table.conversationId,
+      table.createdAt
+    ),
+  ]
+);
+
+/**
+ * Files a user put into a conversation. The object lives behind the
+ * storage port under `storage_key`; the
+ * row is what makes a URL safe to hand out (tenancy, type, size).
+ * `conversation_id` is set once the turn that carried the file is
+ * persisted; a row that never gets one is an orphan to sweep.
+ */
+export const attachments = pgTable(
+  "attachments",
+  {
+    id: text("id").primaryKey(),
+    workspaceId: text("workspace_id")
+      .notNull()
+      .references(() => organization.id, { onDelete: "cascade" }),
+    userId: text("user_id")
+      .notNull()
+      .references(() => users.id, { onDelete: "cascade" }),
+    conversationId: text("conversation_id").references(() => conversations.id, {
+      onDelete: "set null",
+    }),
+    storageKey: text("storage_key").notNull(),
+    filename: text("filename").notNull(),
+    mediaType: text("media_type").notNull(),
+    sizeBytes: integer("size_bytes").notNull(),
+    extractedText: text("extracted_text"), // document text for the model, when a policy extracts it
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+  },
+  (table) => [
+    index("attachments_workspace_id_idx").on(table.workspaceId),
+    index("attachments_conversation_id_idx").on(table.conversationId),
+    uniqueIndex("attachments_storage_key_idx").on(table.storageKey),
+  ]
+);
+
+/** One vote per message (composite key on chat and message). */
+export const votes = pgTable(
+  "votes",
+  {
+    chatId: text("chat_id")
+      .notNull()
+      .references(() => conversations.id, { onDelete: "cascade" }),
+    messageId: text("message_id")
+      .notNull()
+      .references(() => messages.id, { onDelete: "cascade" }),
+    isUpvoted: boolean("is_upvoted").notNull(),
+  },
+  (table) => [
+    primaryKey({ columns: [table.chatId, table.messageId] }),
+    index("votes_message_id_idx").on(table.messageId),
+  ]
+);
+
+/**
+ * AI-generated documents with version history: each save is a new row,
+ * keyed on id + createdAt.
+ */
+export const documents = pgTable(
+  "documents",
+  {
+    id: text("id").notNull(),
+    createdAt: timestamp("created_at").notNull().defaultNow(),
+    title: text("title").notNull(),
+    content: text("content"),
+    kind: text("kind").notNull().default("text"),
+    metadata: jsonb("metadata"), // Structured data (e.g. a report's JSON)
+    userId: text("user_id")
+      .notNull()
+      .references(() => users.id, { onDelete: "cascade" }),
+    workspaceId: text("workspace_id")
+      .notNull()
+      .references(() => organization.id, { onDelete: "cascade" }),
+  },
+  (table) => [
+    primaryKey({ columns: [table.id, table.createdAt] }),
+    index("documents_workspace_id_idx").on(table.workspaceId),
+    index("documents_user_id_idx").on(table.userId),
+  ]
+);
+
+export type Conversation = typeof conversations.$inferSelect;
+export type InsertConversation = typeof conversations.$inferInsert;
+export type Message = typeof messages.$inferSelect;
+export type InsertMessage = typeof messages.$inferInsert;
+export type Attachment = typeof attachments.$inferSelect;
+export type InsertAttachment = typeof attachments.$inferInsert;
+export type Vote = typeof votes.$inferSelect;
+export type InsertVote = typeof votes.$inferInsert;
+export type Document = typeof documents.$inferSelect;
+export type InsertDocument = typeof documents.$inferInsert;