@minion-stack/db 0.4.0 → 0.6.0

package/src/pg/schema/personal-agents.ts

@@ -0,0 +1,44 @@
+import { pgTable, uuid, text, boolean, integer, timestamp, index } from 'drizzle-orm/pg-core';
+import { profiles } from './profiles.js';
+import { gateway } from './gateway.js';
+
+/**
+ * Per-user personal agent. Mirrors Turso `personal_agents`.
+ * FK remap on migration: user_id → profile_id (profiles.id),
+ * server_id → gateway_id (gateway.id, matched via gateway.legacy_server_id).
+ */
+export const personalAgents = pgTable(
+  'personal_agents',
+  {
+    id: text('id').primaryKey(),
+    profileId: uuid('profile_id')
+      .notNull()
+      .unique()
+      .references(() => profiles.id, { onDelete: 'cascade' }),
+    agentId: text('agent_id').notNull(),
+    gatewayId: uuid('gateway_id').references(() => gateway.id, { onDelete: 'set null' }),
+    displayName: text('display_name').notNull(),
+    conversationName: text('conversation_name'),
+    avatarUrl: text('avatar_url'),
+    personalityPreset: text('personality_preset', {
+      enum: ['professional', 'casual', 'creative', 'technical'],
+    }),
+    personalityText: text('personality_text'),
+    personalityConfigured: boolean('personality_configured').notNull().default(false),
+    provisioningStatus: text('provisioning_status', {
+      enum: ['pending', 'provisioning', 'active', 'error'],
+    })
+      .notNull()
+      .default('pending'),
+    provisioningError: text('provisioning_error'),
+    lastRetryAt: timestamp('last_retry_at', { withTimezone: true }),
+    retryCount: integer('retry_count').notNull().default(0),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    index('idx_personal_agents_profile').on(t.profileId),
+    index('idx_personal_agents_agent').on(t.agentId),
+    index('idx_personal_agents_status').on(t.provisioningStatus),
+  ],
+);

package/src/pg/schema/profiles.ts

@@ -11,6 +11,8 @@ export const profiles = pgTable('profiles', {
   id: uuid('id').primaryKey(), // == auth.users.id
   email: text('email').notNull(),
   displayName: text('display_name'),
+  // Public avatar URL (B2-served signed URL or external provider image).
+  avatarUrl: text('avatar_url'),
   role: text('role', { enum: ['user', 'admin'] })
     .notNull()
     .default('user'),

package/src/pg/schema/server-ops.ts

@@ -0,0 +1,126 @@
+import {
+  pgTable,
+  uuid,
+  text,
+  integer,
+  bigint,
+  boolean,
+  timestamp,
+  index,
+  uniqueIndex,
+} from 'drizzle-orm/pg-core';
+import { gateway } from './gateway.js';
+
+/**
+ * Server/gateway provisioning + backup operations.
+ * Mirrors Turso `server_backups` / `server_provision_configs` / `backup_configs` / `config_snapshots`.
+ * FK remap: server_id → gateway_id (gateway.id via legacy_server_id),
+ * tenant_id → organizations.id (plain uuid soft-ref, RLS-enforced).
+ * Type remap: integer epoch → timestamptz, integer boolean-flags → boolean,
+ * size_bytes integer → bigint.
+ */
+
+export const serverBackups = pgTable(
+  'server_backups',
+  {
+    id: text('id').primaryKey(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    tenantId: uuid('tenant_id').notNull(),
+    snapshotPath: text('snapshot_path').notNull(),
+    timestamp: timestamp('timestamp', { withTimezone: true }).notNull(),
+    sizeBytes: bigint('size_bytes', { mode: 'number' }),
+    status: text('status', { enum: ['running', 'complete', 'failed'] })
+      .notNull()
+      .default('running'),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    index('idx_server_backups_gateway').on(t.gatewayId),
+    index('idx_server_backups_tenant').on(t.tenantId),
+  ],
+);
+
+export const serverProvisionConfigs = pgTable(
+  'server_provision_configs',
+  {
+    id: text('id').primaryKey(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    tenantId: uuid('tenant_id').notNull(),
+
+    // SSH connection
+    sshHost: text('ssh_host'),
+    sshUser: text('ssh_user').default('root'),
+    sshPort: integer('ssh_port').default(22),
+
+    // Credentials (encrypted)
+    apiKey: text('api_key'),
+    apiKeyIv: text('api_key_iv'),
+
+    // Agent config
+    agentName: text('agent_name'),
+    sandboxMode: text('sandbox_mode', { enum: ['non-main', 'always', 'never'] }).default('non-main'),
+    dmPolicy: text('dm_policy', { enum: ['pairing', 'solo', 'disabled'] }).default('pairing'),
+
+    // Install config
+    installMethod: text('install_method', { enum: ['package', 'source'] }).default('package'),
+    pkgManager: text('pkg_manager', { enum: ['npm', 'bun'] }).default('npm'),
+
+    // Gateway config
+    gatewayPort: integer('gateway_port').default(18789),
+    gatewayBind: text('gateway_bind', { enum: ['loopback', 'all'] }).default('loopback'),
+
+    // Channel toggles
+    enableWhatsapp: boolean('enable_whatsapp').default(false),
+    enableTelegram: boolean('enable_telegram').default(false),
+    enableDiscord: boolean('enable_discord').default(false),
+
+    // Provision state
+    phaseStatuses: text('phase_statuses').default('{}'),
+    lastProvisionAt: timestamp('last_provision_at', { withTimezone: true }),
+
+    // Timestamps
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    uniqueIndex('provision_configs_uniq_gateway').on(t.gatewayId),
+    index('idx_provision_configs_tenant').on(t.tenantId),
+  ],
+);
+
+export const backupConfigs = pgTable(
+  'backup_configs',
+  {
+    id: text('id').primaryKey(),
+    tenantId: uuid('tenant_id').notNull(),
+    backupHost: text('backup_host'),
+    backupUser: text('backup_user').default('root'),
+    backupPort: integer('backup_port').default(22),
+    backupBasePath: text('backup_base_path').default('/mnt/agent-data/backups'),
+    schedule: text('schedule'),
+    retentionCount: integer('retention_count').default(7),
+    enabled: boolean('enabled').default(false),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [index('idx_backup_configs_tenant').on(t.tenantId)],
+);
+
+export const configSnapshots = pgTable(
+  'config_snapshots',
+  {
+    id: text('id').primaryKey(),
+    tenantId: uuid('tenant_id').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    configJson: text('config_json').notNull(),
+    configHash: text('config_hash').notNull(),
+    fetchedAt: timestamp('fetched_at', { withTimezone: true }).notNull(),
+  },
+  (t) => [uniqueIndex('idx_config_snapshots_gateway').on(t.gatewayId)],
+);

package/src/pg/schema/sessions.ts

@@ -0,0 +1,60 @@
+import { pgTable, uuid, text, integer, timestamp, index, uniqueIndex } from 'drizzle-orm/pg-core';
+import { gateway } from './gateway.js';
+
+/**
+ * Agent sessions + per-session task boards.
+ * Mirrors Turso `sessions` / `session_tasks`.
+ * FK remap: server_id → gateway_id, tenant_id → organizations.id (soft-ref),
+ * integer epoch timestamps → timestamptz.
+ */
+
+export const sessions = pgTable(
+  'sessions',
+  {
+    id: text('id').primaryKey(),
+    tenantId: uuid('tenant_id').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    agentId: text('agent_id').notNull(),
+    sessionKey: text('session_key').notNull(),
+    status: text('status', { enum: ['running', 'thinking', 'idle', 'aborted', 'completed'] })
+      .notNull()
+      .default('idle'),
+    metadata: text('metadata'),
+    startedAt: timestamp('started_at', { withTimezone: true }),
+    endedAt: timestamp('ended_at', { withTimezone: true }),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    index('idx_sessions_tenant').on(t.tenantId),
+    index('idx_sessions_gateway').on(t.gatewayId),
+    uniqueIndex('sessions_uniq_key').on(t.tenantId, t.gatewayId, t.sessionKey),
+  ],
+);
+
+export const sessionTasks = pgTable(
+  'session_tasks',
+  {
+    id: text('id').primaryKey(),
+    tenantId: uuid('tenant_id').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    sessionKey: text('session_key').notNull(),
+    title: text('title').notNull(),
+    description: text('description'),
+    status: text('status', { enum: ['backlog', 'todo', 'in_progress', 'done'] })
+      .notNull()
+      .default('backlog'),
+    sortOrder: integer('sort_order').notNull().default(0),
+    metadata: text('metadata'),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    index('idx_session_tasks_tenant').on(t.tenantId),
+    index('idx_session_tasks_gateway_session').on(t.gatewayId, t.sessionKey),
+  ],
+);

package/src/pg/schema/settings.ts

@@ -0,0 +1,21 @@
+import { pgTable, uuid, text, timestamp, index, uniqueIndex } from 'drizzle-orm/pg-core';
+import { gateway } from './gateway.js';
+
+/** Per-gateway config settings. Mirrors Turso `settings`. tenant_id → organizations.id. */
+export const settings = pgTable(
+  'settings',
+  {
+    id: uuid('id').primaryKey().defaultRandom(),
+    tenantId: uuid('tenant_id').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    section: text('section').notNull(),
+    value: text('value').notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    uniqueIndex('uq_settings_gateway_section').on(t.gatewayId, t.section),
+    index('idx_settings_tenant').on(t.tenantId),
+  ],
+);

package/src/pg/schema/skills.ts

@@ -0,0 +1,65 @@
+import {
+  pgTable,
+  uuid,
+  text,
+  integer,
+  boolean,
+  bigserial,
+  timestamp,
+  index,
+  primaryKey,
+} from 'drizzle-orm/pg-core';
+import { gateway } from './gateway.js';
+
+/**
+ * Gateway skill registry + execution telemetry.
+ * Mirrors Turso `skills` / `skill_execution_stats`.
+ * FK remap: server_id → gateway_id, tenant_id → organizations.id (soft-ref).
+ * boolean cols stay boolean; integer epoch → timestamptz; autoincrement id → bigserial.
+ */
+
+export const skills = pgTable(
+  'skills',
+  {
+    skillKey: text('skill_key').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    tenantId: uuid('tenant_id').notNull(),
+    name: text('name').notNull(),
+    description: text('description'),
+    emoji: text('emoji'),
+    bundled: boolean('bundled').notNull().default(false),
+    disabled: boolean('disabled').notNull().default(false),
+    eligible: boolean('eligible').notNull().default(false),
+    rawJson: text('raw_json').notNull(),
+    lastSeenAt: timestamp('last_seen_at', { withTimezone: true }).notNull(),
+  },
+  (t) => [
+    primaryKey({ columns: [t.skillKey, t.gatewayId] }),
+    index('idx_skills_tenant').on(t.tenantId),
+  ],
+);
+
+export const skillExecutionStats = pgTable(
+  'skill_execution_stats',
+  {
+    id: bigserial('id', { mode: 'number' }).primaryKey(),
+    tenantId: uuid('tenant_id').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    agentId: text('agent_id'),
+    skillName: text('skill_name').notNull(),
+    sessionKey: text('session_key'),
+    status: text('status', { enum: ['ok', 'auth_error', 'timeout', 'error'] }).notNull(),
+    durationMs: integer('duration_ms'),
+    errorMessage: text('error_message'),
+    occurredAt: timestamp('occurred_at', { withTimezone: true }).notNull(),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    index('idx_skill_stats_gateway_skill_time').on(t.gatewayId, t.skillName, t.occurredAt),
+    index('idx_skill_stats_tenant').on(t.tenantId),
+  ],
+);

package/src/pg/schema/user-agents.ts

@@ -0,0 +1,25 @@
+import { pgTable, uuid, text, timestamp, index, primaryKey } from 'drizzle-orm/pg-core';
+import { gateway } from './gateway.js';
+import { profiles } from './profiles.js';
+
+/**
+ * User ↔ agent access grants. Mirrors Turso `user_agents`.
+ * FK remap: user_id → profiles.id (via legacy_user_id), server_id → gateway_id.
+ */
+export const userAgents = pgTable(
+  'user_agents',
+  {
+    userId: uuid('user_id')
+      .notNull()
+      .references(() => profiles.id, { onDelete: 'cascade' }),
+    agentId: text('agent_id').notNull(),
+    gatewayId: uuid('gateway_id')
+      .notNull()
+      .references(() => gateway.id, { onDelete: 'cascade' }),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    primaryKey({ columns: [t.userId, t.agentId, t.gatewayId] }),
+    index('idx_user_agents_gateway').on(t.gatewayId),
+  ],
+);

package/src/pg/schema/user-preferences.ts

@@ -0,0 +1,23 @@
+import { pgTable, uuid, text, timestamp, uniqueIndex, index } from 'drizzle-orm/pg-core';
+import { profiles } from './profiles.js';
+
+/**
+ * Per-user UI/feature preferences. Mirrors Turso `user_preferences`.
+ * userId (Turso text) is remapped to profile_id (uuid → profiles.id) on migration.
+ */
+export const userPreferences = pgTable(
+  'user_preferences',
+  {
+    id: uuid('id').primaryKey().defaultRandom(),
+    profileId: uuid('profile_id')
+      .notNull()
+      .references(() => profiles.id, { onDelete: 'cascade' }),
+    section: text('section').notNull(),
+    value: text('value').notNull(),
+    updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    uniqueIndex('uq_user_prefs_profile_section').on(t.profileId, t.section),
+    index('idx_user_prefs_profile').on(t.profileId),
+  ],
+);

package/src/pg/schema/workshop-saves.ts

@@ -0,0 +1,13 @@
+import { pgTable, uuid, text, timestamp } from 'drizzle-orm/pg-core';
+
+/** Workshop canvas saves. Mirrors Turso `workshop_saves`. profile_id/tenant_id nullable (pre-migration shared). */
+export const workshopSaves = pgTable('workshop_saves', {
+  id: text('id').primaryKey(),
+  name: text('name').notNull(),
+  state: text('state').notNull(),
+  thumbnail: text('thumbnail'),
+  profileId: uuid('profile_id'),
+  tenantId: uuid('tenant_id'),
+  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+});

package/src/pg/schema/workspace-membership.ts

@@ -0,0 +1,26 @@
+import { pgTable, uuid, text, timestamp, index, primaryKey } from 'drizzle-orm/pg-core';
+import { profiles } from './profiles.js';
+
+/**
+ * workspace_membership — bridge between hub identity and Paperclip company tenancy.
+ * Mirrors Turso `workspace_membership`. FK remap: user_id → profiles.id (via legacy_user_id).
+ * Each row means "user X holds role Y in Paperclip company Z".
+ */
+export const workspaceMembership = pgTable(
+  'workspace_membership',
+  {
+    userId: uuid('user_id')
+      .notNull()
+      .references(() => profiles.id, { onDelete: 'cascade' }),
+    paperclipCompanyId: text('paperclip_company_id').notNull(),
+    role: text('role').notNull().default('admin'),
+    createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
+  },
+  (t) => [
+    primaryKey({ columns: [t.userId, t.paperclipCompanyId] }),
+    index('idx_workspace_membership_user').on(t.userId),
+  ],
+);
+
+export type WorkspaceMembership = typeof workspaceMembership.$inferSelect;
+export type NewWorkspaceMembership = typeof workspaceMembership.$inferInsert;

package/src/schema/index.ts

@@ -60,3 +60,5 @@ export {
 export { userPreferences } from './user-preferences.js';
 export { workspaceMembership } from './workspace-membership.js';
 export type { WorkspaceMembership, NewWorkspaceMembership } from './workspace-membership.js';
+export { joinRequests } from './join-requests.js';
+export type { JoinRequest, NewJoinRequest } from './join-requests.js';

package/src/schema/join-requests.ts

@@ -0,0 +1,42 @@
+import { sqliteTable, text, integer, index } from 'drizzle-orm/sqlite-core';
+import { user } from './auth/index.js';
+import { organization } from './auth/index.js';
+
+/**
+ * join_requests — users requesting to join an organization.
+ *
+ * When a user not-yet-in-an-org wants access, they submit a join request.
+ * Org admins review (approve/deny). On approval the user is added as a member.
+ *
+ * Used by:
+ *   - /join page (submission)
+ *   - /api/join-requests/* (listing, counting, review)
+ *   - notifications panel
+ */
+export const joinRequests = sqliteTable(
+  'join_requests',
+  {
+    id: text('id').primaryKey(),
+    userId: text('user_id')
+      .notNull()
+      .references(() => user.id, { onDelete: 'cascade' }),
+    orgId: text('org_id')
+      .notNull()
+      .references(() => organization.id, { onDelete: 'cascade' }),
+    email: text('email').notNull(),
+    message: text('message'),
+    status: text('status', { enum: ['pending', 'approved', 'denied'] })
+      .notNull()
+      .default('pending'),
+    reviewedBy: text('reviewed_by'),
+    reviewedAt: integer('reviewed_at'),
+    createdAt: integer('created_at').notNull(),
+  },
+  (t) => [
+    index('idx_join_requests_user').on(t.userId),
+    index('idx_join_requests_org_status').on(t.orgId, t.status),
+  ],
+);
+
+export type JoinRequest = typeof joinRequests.$inferSelect;
+export type NewJoinRequest = typeof joinRequests.$inferInsert;