agentworkshop 0.2.1

package/server/services/workshop/db/task.repo.ts

@@ -0,0 +1,175 @@
+/**
+ * Task 仓储:tasks 表 CRUD。
+ * 工厂接收 DatabaseSync(依赖注入),不持有任何单例。
+ */
+import { randomUUID } from 'node:crypto'
+import type { DatabaseSync } from 'node:sqlite'
+import type { TaskRow } from './database'
+
+const COLS
+  = 'id, channel_id AS channelId, parent_id AS parentId, assignee_id AS assigneeId, creator_id AS creatorId, title, description, state, progress, retry_count AS retryCount, artifacts_json AS artifactsJson, history_json AS historyJson, route_reason AS routeReason, created_at AS createdAt, updated_at AS updatedAt'
+
+const NON_TERMINAL_STATES = `'SUBMITTED', 'ASSIGNED', 'WORKING', 'WAITING'`
+
+export interface TaskCreateInput {
+  channelId: string
+  parentId?: string | null
+  assigneeId: string
+  creatorId?: string | null
+  title: string
+  description?: string | null
+  state?: string
+  progress?: number
+  retryCount?: number
+  artifacts?: unknown[]
+  history?: unknown[]
+  routeReason?: string | null
+}
+
+export interface TaskPatch {
+  parentId?: string | null
+  assigneeId?: string
+  creatorId?: string | null
+  title?: string
+  description?: string | null
+  state?: string
+  progress?: number
+  retryCount?: number
+  artifacts?: unknown[]
+  history?: unknown[]
+}
+
+/** 任务元数据行(META_COLS 投影;不含 artifactsJson/historyJson 两个 JSON 大列) */
+export interface TaskMetaRow {
+  id: string
+  channelId: string
+  parentId: string | null
+  assigneeId: string
+  creatorId: string | null
+  title: string
+  description: string | null
+  state: string
+  progress: number
+  retryCount: number
+  routeReason: string
+  createdAt: string
+  updatedAt: string
+}
+
+export type TaskRepo = ReturnType<typeof createTaskRepo>
+
+export function createTaskRepo(db: DatabaseSync) {
+  const insert = db.prepare(
+    `INSERT INTO tasks (id, channel_id, parent_id, assignee_id, creator_id, title, description, state, progress, retry_count, artifacts_json, history_json, route_reason, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+  )
+  const selectById = db.prepare(`SELECT ${COLS} FROM tasks WHERE id = ?`)
+  const selectByChannel = db.prepare(`SELECT ${COLS} FROM tasks WHERE channel_id = ? ORDER BY createdAt ASC, rowid ASC`)
+  const selectByAssignee = db.prepare(`SELECT ${COLS} FROM tasks WHERE assignee_id = ? ORDER BY createdAt ASC, rowid ASC`)
+  const selectByChannelAssignee = db.prepare(
+    `SELECT ${COLS} FROM tasks WHERE channel_id = ? AND assignee_id = ? ORDER BY createdAt ASC, rowid ASC`,
+  )
+  const selectNonTerminal = db.prepare(
+    `SELECT ${COLS} FROM tasks WHERE state IN (${NON_TERMINAL_STATES}) ORDER BY createdAt ASC, rowid ASC`,
+  )
+  // 元数据投影(调度快照热路径):不含 artifacts_json/history_json 两个 JSON 大列,
+  // 免每 tick 对全部任务做全量 JSON.parse(历史最多 200 条消息,频道任务多时解析成本线性放大)。
+  // 调度/队列视图只需 id/state/parent/assignee/progress/title/description/retry/createdAt。
+  const META_COLS
+    = 'id, channel_id AS channelId, parent_id AS parentId, assignee_id AS assigneeId, creator_id AS creatorId, title, description, state, progress, retry_count AS retryCount, route_reason AS routeReason, created_at AS createdAt, updated_at AS updatedAt'
+  const selectByChannelMeta = db.prepare(`SELECT ${META_COLS} FROM tasks WHERE channel_id = ? ORDER BY createdAt ASC, rowid ASC`)
+  const selectByChannelAssigneeMeta = db.prepare(`SELECT ${META_COLS} FROM tasks WHERE channel_id = ? AND assignee_id = ? ORDER BY createdAt ASC, rowid ASC`)
+  const selectChildrenMeta = db.prepare(`SELECT ${META_COLS} FROM tasks WHERE channel_id = ? AND parent_id = ? ORDER BY createdAt ASC, rowid ASC`)
+  const updateStmt = db.prepare(
+    `UPDATE tasks SET parent_id = ?, assignee_id = ?, creator_id = ?, title = ?, description = ?, state = ?, progress = ?, retry_count = ?, artifacts_json = ?, history_json = ?, updated_at = ? WHERE id = ?`,
+  )
+
+  return {
+    /** 创建任务(state 缺省 SUBMITTED,artifacts/history 序列化存储) */
+    create(input: TaskCreateInput): TaskRow {
+      const now = new Date().toISOString()
+      const row: TaskRow = {
+        id: randomUUID(),
+        channelId: input.channelId,
+        parentId: input.parentId ?? null,
+        assigneeId: input.assigneeId,
+        creatorId: input.creatorId ?? null,
+        title: input.title,
+        description: input.description ?? null,
+        state: input.state ?? 'SUBMITTED',
+        progress: input.progress ?? 0,
+        retryCount: input.retryCount ?? 0,
+        artifactsJson: JSON.stringify(input.artifacts ?? []),
+        historyJson: JSON.stringify(input.history ?? []),
+        routeReason: input.routeReason ?? '',
+        createdAt: now,
+        updatedAt: now,
+      }
+      insert.run(
+        row.id, row.channelId, row.parentId, row.assigneeId, row.creatorId, row.title, row.description, row.state, row.progress, row.retryCount, row.artifactsJson, row.historyJson, row.routeReason, row.createdAt, row.updatedAt,
+      )
+      return row
+    },
+
+    /** 局部更新;artifacts/history 提供时重新序列化;未命中返回 undefined */
+    update(id: string, patch: TaskPatch): TaskRow | undefined {
+      const current = selectById.get(id) as unknown as TaskRow | undefined
+      if (!current) return undefined
+      const next: TaskRow = {
+        ...current,
+        parentId: patch.parentId !== undefined ? patch.parentId : current.parentId,
+        assigneeId: patch.assigneeId ?? current.assigneeId,
+        creatorId: patch.creatorId !== undefined ? patch.creatorId : current.creatorId,
+        title: patch.title ?? current.title,
+        description: patch.description !== undefined ? patch.description : current.description,
+        state: patch.state ?? current.state,
+        progress: patch.progress ?? current.progress,
+        retryCount: patch.retryCount ?? current.retryCount,
+        artifactsJson: patch.artifacts !== undefined ? JSON.stringify(patch.artifacts) : current.artifactsJson,
+        historyJson: patch.history !== undefined ? JSON.stringify(patch.history) : current.historyJson,
+        updatedAt: new Date().toISOString(),
+      }
+      updateStmt.run(
+        next.parentId, next.assigneeId, next.creatorId, next.title, next.description, next.state, next.progress, next.retryCount, next.artifactsJson, next.historyJson, next.updatedAt, id,
+      )
+      return next
+    },
+
+    findById(id: string): TaskRow | undefined {
+      return selectById.get(id) as unknown as TaskRow | undefined
+    },
+
+    listByChannel(channelId: string): TaskRow[] {
+      return selectByChannel.all(channelId) as unknown as TaskRow[]
+    },
+
+    listByAssignee(agentId: string): TaskRow[] {
+      return selectByAssignee.all(agentId) as unknown as TaskRow[]
+    },
+
+    /** channel 内指定 assignee 的任务(FIFO:createdAt ASC;单 agent 任务队列视图的数据源) */
+    listByChannelAssignee(channelId: string, assigneeId: string): TaskRow[] {
+      return selectByChannelAssignee.all(channelId, assigneeId) as unknown as TaskRow[]
+    },
+
+    /** 非终态任务(SUBMITTED/ASSIGNED/WORKING/WAITING) */
+    listNonTerminal(): TaskRow[] {
+      return selectNonTerminal.all() as unknown as TaskRow[]
+    },
+
+    /** channel 全部任务的元数据投影(调度快照热路径;免 JSON 大列解析) */
+    listByChannelMeta(channelId: string): TaskMetaRow[] {
+      return selectByChannelMeta.all(channelId) as unknown as TaskMetaRow[]
+    },
+
+    /** channel 内指定 assignee 的任务元数据投影(队列视图热路径;免 JSON 大列解析) */
+    listByChannelAssigneeMeta(channelId: string, assigneeId: string): TaskMetaRow[] {
+      return selectByChannelAssigneeMeta.all(channelId, assigneeId) as unknown as TaskMetaRow[]
+    },
+
+    /** channel 内指定父任务的子任务元数据(判重/完成闸门/子任务统计直查;idx_tasks_parent 支撑) */
+    listChildrenMeta(channelId: string, parentId: string): TaskMetaRow[] {
+      return selectChildrenMeta.all(channelId, parentId) as unknown as TaskMetaRow[]
+    },
+  }
+}

package/server/services/workshop/db/team-member.repo.ts

@@ -0,0 +1,70 @@
+/**
+ * TeamMember 仓储:team_members 表(team × agent 模板 成员关系)。
+ * 一个 team 可含多个 Agent 模板;同一模板在同一 team 内唯一(复合主键)。
+ * 工厂接收 DatabaseSync(依赖注入),不持有任何单例。
+ */
+import type { DatabaseSync } from 'node:sqlite'
+import type { TeamMemberRow } from './database'
+
+export interface TeamMemberAddInput {
+  teamId: string
+  templateId: string
+  role: 'lead' | 'worker'
+}
+
+/** team_members 表仓储契约 */
+export interface TeamMemberRepo {
+  /** 加入成员;重复加入抛约束错误(SQLITE_CONSTRAINT,由上层转 409) */
+  add(input: TeamMemberAddInput): TeamMemberRow
+  /** team 内全部成员(按加入顺序) */
+  listByTeam(teamId: string): TeamMemberRow[]
+  findByTeamTemplate(teamId: string, templateId: string): TeamMemberRow | undefined
+  /** 某模板加入的全部 team(跨 team) */
+  listByTemplate(templateId: string): TeamMemberRow[]
+  /** team 内 lead 数量(约束一个 team 至多一个 lead) */
+  countLead(teamId: string): number
+  /** 移除成员(仅删关系,不删模板) */
+  remove(teamId: string, templateId: string): void
+}
+
+const COLS = 'team_id AS teamId, template_id AS templateId, role, created_at AS createdAt'
+
+export function createTeamMemberRepo(db: DatabaseSync): TeamMemberRepo {
+  const insert = db.prepare(
+    `INSERT INTO team_members (team_id, template_id, role, created_at)
+     VALUES (?, ?, ?, ?)`,
+  )
+  const selectByTeam = db.prepare(`SELECT ${COLS} FROM team_members WHERE team_id = ? ORDER BY created_at ASC`)
+  const selectByTeamTemplate = db.prepare(`SELECT ${COLS} FROM team_members WHERE team_id = ? AND template_id = ?`)
+  const selectByTemplate = db.prepare(`SELECT ${COLS} FROM team_members WHERE template_id = ? ORDER BY created_at ASC`)
+  const removeStmt = db.prepare(`DELETE FROM team_members WHERE team_id = ? AND template_id = ?`)
+  const selectLeads = db.prepare(`SELECT ${COLS} FROM team_members WHERE team_id = ? AND role = 'lead'`)
+
+  return {
+    add(input: TeamMemberAddInput): TeamMemberRow {
+      const now = new Date().toISOString()
+      insert.run(input.teamId, input.templateId, input.role, now)
+      return { teamId: input.teamId, templateId: input.templateId, role: input.role, createdAt: now }
+    },
+
+    listByTeam(teamId: string): TeamMemberRow[] {
+      return selectByTeam.all(teamId) as unknown as TeamMemberRow[]
+    },
+
+    findByTeamTemplate(teamId: string, templateId: string): TeamMemberRow | undefined {
+      return selectByTeamTemplate.get(teamId, templateId) as unknown as TeamMemberRow | undefined
+    },
+
+    listByTemplate(templateId: string): TeamMemberRow[] {
+      return selectByTemplate.all(templateId) as unknown as TeamMemberRow[]
+    },
+
+    countLead(teamId: string): number {
+      return (selectLeads.all(teamId) as unknown as TeamMemberRow[]).length
+    },
+
+    remove(teamId: string, templateId: string): void {
+      removeStmt.run(teamId, templateId)
+    },
+  }
+}

package/server/services/workshop/db/team.repo.ts

@@ -0,0 +1,109 @@
+/**
+ * AgentTeam 仓储:teams 表 CRUD(Agent 模板编组,无 channel 绑定)。
+ * 成员关系见 team-member.repo.ts。
+ * 工厂接收 DatabaseSync(依赖注入),不持有任何单例。
+ * 可见性(v10):private 仅属主可见;public 全员可读可用;owner NULL = 内置(恒 public,不可变更)。
+ */
+import { randomUUID } from 'node:crypto'
+import type { DatabaseSync } from 'node:sqlite'
+import type { TeamRow } from './database'
+
+export interface TeamCreateInput {
+  name: string
+  description?: string
+  /** 可见性(缺省 private) */
+  visibility?: string
+  /** 归属用户(null = 内置公共) */
+  ownerUserId?: string | null
+}
+
+export interface TeamPatch {
+  name?: string
+  description?: string
+  visibility?: string
+}
+
+/** teams 表仓储契约 */
+export interface TeamRepo {
+  /** 创建 team(description 缺省空串) */
+  create(input: TeamCreateInput): TeamRow
+  list(): TeamRow[]
+  /** 按 owner 过滤(含 NULL 内置公共行) */
+  listForOwner(ownerUserId: string): TeamRow[]
+  /** 用户可见集:本人(任意可见性)+ 全部 public(含内置) */
+  listVisible(userId: string): TeamRow[]
+  findById(id: string): TeamRow | undefined
+  /** 局部更新;未命中返回 undefined */
+  update(id: string, patch: TeamPatch): TeamRow | undefined
+  remove(id: string): void
+}
+
+const COLS = 'id, name, description, visibility, owner_user_id AS ownerUserId, created_at AS createdAt, updated_at AS updatedAt'
+
+export function createTeamRepo(db: DatabaseSync): TeamRepo {
+  const insert = db.prepare(
+    `INSERT INTO teams (id, name, description, visibility, owner_user_id, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+  )
+  const selectAll = db.prepare(`SELECT ${COLS} FROM teams ORDER BY createdAt ASC`)
+  const selectByOwner = db.prepare(`SELECT ${COLS} FROM teams WHERE owner_user_id = ? OR owner_user_id IS NULL ORDER BY createdAt ASC`)
+  const selectVisible = db.prepare(`SELECT ${COLS} FROM teams WHERE owner_user_id = ? OR visibility = 'public' ORDER BY createdAt ASC`)
+  const selectById = db.prepare(`SELECT ${COLS} FROM teams WHERE id = ?`)
+  const updateStmt = db.prepare(
+    `UPDATE teams SET name = ?, description = ?, visibility = ?, updated_at = ? WHERE id = ?`,
+  )
+  const removeStmt = db.prepare(`DELETE FROM teams WHERE id = ?`)
+
+  return {
+    create(input: TeamCreateInput): TeamRow {
+      const now = new Date().toISOString()
+      const row: TeamRow = {
+        id: randomUUID(),
+        name: input.name,
+        description: input.description ?? '',
+        visibility: input.visibility ?? 'private',
+        ownerUserId: input.ownerUserId ?? null,
+        createdAt: now,
+        updatedAt: now,
+      }
+      insert.run(row.id, row.name, row.description, row.visibility, row.ownerUserId, row.createdAt, row.updatedAt)
+      return row
+    },
+
+    list(): TeamRow[] {
+      return selectAll.all() as unknown as TeamRow[]
+    },
+
+    /** 按 owner 过滤(含 NULL 内置公共行) */
+    listForOwner(ownerUserId: string): TeamRow[] {
+      return selectByOwner.all(ownerUserId) as unknown as TeamRow[]
+    },
+
+    /** 用户可见集:本人(任意可见性)+ 全部 public(含内置) */
+    listVisible(userId: string): TeamRow[] {
+      return selectVisible.all(userId) as unknown as TeamRow[]
+    },
+
+    findById(id: string): TeamRow | undefined {
+      return selectById.get(id) as unknown as TeamRow | undefined
+    },
+
+    update(id: string, patch: TeamPatch): TeamRow | undefined {
+      const current = selectById.get(id) as unknown as TeamRow | undefined
+      if (!current) return undefined
+      const next: TeamRow = {
+        ...current,
+        name: patch.name ?? current.name,
+        description: patch.description ?? current.description,
+        visibility: patch.visibility ?? current.visibility,
+        updatedAt: new Date().toISOString(),
+      }
+      updateStmt.run(next.name, next.description, next.visibility, next.updatedAt, id)
+      return next
+    },
+
+    remove(id: string): void {
+      removeStmt.run(id)
+    },
+  }
+}

package/server/services/workshop/db/user.repo.ts

@@ -0,0 +1,100 @@
+/**
+ * User 仓储:用户级隔离身份(users 表)+ 服务端 Workspace(workspaces/workspace_channels)。
+ * - 用户 token = 管理 API 的 Bearer 凭证(区别于 agent 实例 token)
+ * - Workspace 持久化挂载关系(channel 引用不 FK,channel 删除后挂载行残留由清理兜底)
+ */
+import { randomUUID } from 'node:crypto'
+import type { DatabaseSync } from 'node:sqlite'
+import type { UserRow, WorkspaceRow } from './database'
+
+export type UserRepo = ReturnType<typeof createUserRepo>
+
+export function createUserRepo(db: DatabaseSync) {
+  const insertUser = db.prepare(
+    `INSERT INTO users (id, name, token, created_at) VALUES (?, ?, ?, ?)`,
+  )
+  const findById = db.prepare(
+    `SELECT id, name, token, created_at AS createdAt FROM users WHERE id = ?`,
+  )
+  const findByName = db.prepare(
+    `SELECT id, name, token, created_at AS createdAt FROM users WHERE name = ?`,
+  )
+  const findByToken = db.prepare(
+    `SELECT id, name, token, created_at AS createdAt FROM users WHERE token = ?`,
+  )
+
+  // workspaces
+  const insertWs = db.prepare(
+    `INSERT INTO workspaces (id, owner_user_id, name, created_at) VALUES (?, ?, ?, ?)`,
+  )
+  const wsCols = 'id, owner_user_id AS ownerUserId, name, created_at AS createdAt'
+  const listWsByOwner = db.prepare(
+    `SELECT ${wsCols} FROM workspaces WHERE owner_user_id = ? ORDER BY created_at ASC`,
+  )
+  const findWs = db.prepare(`SELECT ${wsCols} FROM workspaces WHERE id = ?`)
+  const deleteWs = db.prepare(`DELETE FROM workspaces WHERE id = ?`)
+
+  // workspace_channels(挂载关系)
+  const insertMount = db.prepare(
+    `INSERT OR IGNORE INTO workspace_channels (workspace_id, channel_id, created_at) VALUES (?, ?, ?)`,
+  )
+  const deleteMount = db.prepare(
+    `DELETE FROM workspace_channels WHERE workspace_id = ? AND channel_id = ?`,
+  )
+  const listMounts = db.prepare(
+    `SELECT channel_id AS channelId FROM workspace_channels WHERE workspace_id = ? ORDER BY created_at ASC`,
+  )
+
+  return {
+    /** 注册用户(name 唯一;token 仅创建时生成返回,库中仅存明文哈希对照) */
+    create(name: string): UserRow {
+      const row: UserRow = {
+        id: randomUUID(),
+        name,
+        token: `u-${randomUUID().replace(/-/g, '')}`,
+        createdAt: new Date().toISOString(),
+      }
+      insertUser.run(row.id, row.name, row.token, row.createdAt)
+      return row
+    },
+    getById(id: string): UserRow | null {
+      return (findById.get(id) as UserRow | undefined) ?? null
+    },
+    getByName(name: string): UserRow | null {
+      return (findByName.get(name) as UserRow | undefined) ?? null
+    },
+    getByToken(token: string): UserRow | null {
+      return (findByToken.get(token) as UserRow | undefined) ?? null
+    },
+
+    // ===== Workspace(服务端持久化;按 owner 隔离)=====
+    createWorkspace(ownerUserId: string, name: string): WorkspaceRow {
+      const row: WorkspaceRow = {
+        id: randomUUID(),
+        ownerUserId,
+        name,
+        createdAt: new Date().toISOString(),
+      }
+      insertWs.run(row.id, row.ownerUserId, row.name, row.createdAt)
+      return row
+    },
+    listWorkspaces(ownerUserId: string): WorkspaceRow[] {
+      return listWsByOwner.all(ownerUserId) as unknown as WorkspaceRow[]
+    },
+    getWorkspace(id: string): WorkspaceRow | null {
+      return (findWs.get(id) as WorkspaceRow | undefined) ?? null
+    },
+    deleteWorkspace(id: string): boolean {
+      return deleteWs.run(id).changes > 0
+    },
+    mountChannel(workspaceId: string, channelId: string): void {
+      insertMount.run(workspaceId, channelId, new Date().toISOString())
+    },
+    unmountChannel(workspaceId: string, channelId: string): void {
+      deleteMount.run(workspaceId, channelId)
+    },
+    listMountedChannels(workspaceId: string): string[] {
+      return (listMounts.all(workspaceId) as Array<{ channelId: string }>).map(r => r.channelId)
+    },
+  }
+}