c0de-agent 1.6.0 → 1.7.0

package/dist/shared/types/kanban.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Kanban shared types — used by backend store, kanban tool, REST routes,
+ * and frontend components.
+ */
+/** A kanban column definition (stored as JSON in kanban_boards.columns). */
+type KanbanColumnDef = {
+    id: string;
+    name: string;
+};
+/** A kanban label definition (stored as JSON in kanban_boards.labels). */
+type KanbanLabelDef = {
+    id: string;
+    name: string;
+    /** Hex color, e.g. "#ef4444" */
+    color: string;
+};
+/** Card priority level. */
+type KanbanPriority = 'high' | 'medium' | 'low';
+/** A kanban card (task). */
+type KanbanCard = {
+    id: string;
+    boardId: string;
+    title: string;
+    description: string | null;
+    columnId: string;
+    priority: KanbanPriority;
+    position: number;
+    /** Label ids referencing board.labels[].id */
+    labels: string[];
+    createdAt: string;
+    updatedAt: string;
+};
+/** A kanban board (one per project). */
+type KanbanBoard = {
+    id: string;
+    projectId: string;
+    columns: KanbanColumnDef[];
+    labels: KanbanLabelDef[];
+    createdAt: string;
+    updatedAt: string;
+};
+/** Board with all its cards (the full payload for GET /api/kanban/:projectId). */
+type KanbanBoardWithCards = KanbanBoard & {
+    cards: KanbanCard[];
+};
+/** Default 5 columns for a new board. */
+declare const DEFAULT_KANBAN_COLUMNS: readonly KanbanColumnDef[];
+/** A curated palette for new labels (user can pick or override). */
+declare const KANBAN_LABEL_COLORS: readonly string[];
+/** Dependency-reversal interface for the `kanban` tool (host injects a db-backed
+ *  implementation, mirroring the todoState pattern). */
+interface KanbanStore {
+    getBoard(): Promise<KanbanBoardWithCards>;
+    addCard(input: {
+        title: string;
+        description?: string | null;
+        columnId?: string;
+        priority?: KanbanPriority;
+        labels?: string[];
+    }): Promise<KanbanCard>;
+    updateCard(id: string, patch: {
+        title?: string;
+        description?: string | null;
+        priority?: KanbanPriority;
+        labels?: string[];
+    }): Promise<KanbanCard>;
+    moveCard(id: string, columnId: string, position?: number): Promise<KanbanCard>;
+    deleteCard(id: string): Promise<void>;
+    updateBoard(patch: {
+        columns?: KanbanColumnDef[];
+        labels?: KanbanLabelDef[];
+    }): Promise<KanbanBoard>;
+}
+export type { KanbanBoard, KanbanBoardWithCards, KanbanCard, KanbanColumnDef, KanbanLabelDef, KanbanPriority, KanbanStore, };
+export { DEFAULT_KANBAN_COLUMNS, KANBAN_LABEL_COLORS };

package/dist/shared/types/kanban.js

@@ -0,0 +1,24 @@
+/**
+ * Kanban shared types — used by backend store, kanban tool, REST routes,
+ * and frontend components.
+ */
+/** Default 5 columns for a new board. */
+const DEFAULT_KANBAN_COLUMNS = [
+    { id: 'todo', name: '待办' },
+    { id: 'in_progress', name: '进行中' },
+    { id: 'in_review', name: '审核中' },
+    { id: 'done', name: '已完成' },
+    { id: 'cancelled', name: '已取消' },
+];
+/** A curated palette for new labels (user can pick or override). */
+const KANBAN_LABEL_COLORS = [
+    '#ef4444', // red
+    '#f97316', // orange
+    '#eab308', // yellow
+    '#22c55e', // green
+    '#06b6d4', // cyan
+    '#3b82f6', // blue
+    '#8b5cf6', // violet
+    '#ec4899', // pink
+];
+export { DEFAULT_KANBAN_COLUMNS, KANBAN_LABEL_COLORS };

package/dist/shared/types/tool.d.ts

@@ -1,4 +1,5 @@
 import type { JSONSchema, SessionRef } from './base.js';
+import type { KanbanStore } from './kanban.js';
 export type TodoPhaseLike = {
     name: string;
     tasks: {
@@ -79,6 +80,9 @@ type ToolContext = {
         get: () => TodoPhaseLike[];
         set: (phases: TodoPhaseLike[]) => void;
     };
+    /** Kanban store (dependency-reversal for the `kanban` tool).
+     *  Host injects a db-backed implementation scoped to the session's project. */
+    kanbanStore?: KanbanStore;
 };
 /** 单个并行子任务项（批量模式）。 */
 type TaskItem = {

package/dist/tools/builtin/kanban.d.ts

@@ -0,0 +1,32 @@
+import type { KanbanPriority } from '../../shared/types/kanban.js';
+import type { ToolDef } from '../../shared/types/tool.js';
+type KanbanInput = {
+    op: 'view';
+} | {
+    op: 'add';
+    title: string;
+    description?: string;
+    columnId?: string;
+    priority?: KanbanPriority;
+    labels?: string[];
+} | {
+    op: 'update';
+    id: string;
+    title?: string;
+    description?: string | null;
+    priority?: KanbanPriority;
+    labels?: string[];
+} | {
+    op: 'move';
+    id: string;
+    columnId: string;
+    position?: number;
+} | {
+    op: 'delete';
+    id: string;
+};
+/** kanban tool: project-scoped task board for human↔agent collaboration.
+ *  Permission: auto (operates on the project's kanban board, no system side effects).
+ *  State persists in DB via ctx.kanbanStore (dependency-reversal, like todoState). */
+export declare const kanbanTool: ToolDef;
+export type { KanbanInput };

package/dist/tools/builtin/kanban.js

@@ -0,0 +1,203 @@
+// kanban tool: project-scoped task board for agent collaboration.
+// Mirrors the todo tool's ToolDef pattern but persists to DB (per-project)
+// instead of in-memory session state. Agents can add, move, update, delete
+// tasks and view the full board — enabling human↔agent and agent↔agent
+// coordination via a shared kanban board.
+// =============================================================================
+// Summary formatter
+// =============================================================================
+/** Priority display symbol for compact board summary. */
+const PRIORITY_SYMBOL = {
+    high: '🔴',
+    medium: '🟡',
+    low: '⚪',
+};
+function formatBoardSummary(board, errors = []) {
+    const lines = [];
+    if (errors.length > 0)
+        lines.push(`Errors: ${errors.join('; ')}`);
+    for (const col of board.columns) {
+        const cards = board.cards.filter((c) => c.columnId === col.id);
+        lines.push(`## ${col.name} (${cards.length})`);
+        for (const card of cards) {
+            const shortId = card.id.slice(0, 8);
+            const sym = PRIORITY_SYMBOL[card.priority] ?? '';
+            lines.push(`  ${sym} [${shortId}] ${card.title}`);
+            if (card.description) {
+                const preview = card.description.length > 80 ? `${card.description.slice(0, 77)}…` : card.description;
+                lines.push(`      ${preview}`);
+            }
+        }
+        if (cards.length === 0)
+            lines.push('  (empty)');
+    }
+    const total = board.cards.length;
+    lines.push(`\nTotal: ${total} card(s).`);
+    if (total === 0)
+        lines.push('Board is empty — use kanban add to create tasks.');
+    return lines.join('\n');
+}
+// =============================================================================
+// Schema
+// =============================================================================
+const kanbanParameters = {
+    type: 'object',
+    description: 'Apply a single kanban board operation',
+    properties: {
+        op: {
+            type: 'string',
+            enum: ['view', 'add', 'update', 'move', 'delete'],
+            description: 'Operation to apply',
+        },
+        title: { type: 'string', description: 'Task title (for add, update)' },
+        description: { type: 'string', description: 'Task description (for add, update)' },
+        id: { type: 'string', description: 'Card id (for update, move, delete)' },
+        columnId: {
+            type: 'string',
+            description: 'Column id to place/move the card (for add, move)',
+        },
+        priority: {
+            type: 'string',
+            enum: ['high', 'medium', 'low'],
+            description: 'Priority level (for add, update)',
+        },
+        labels: {
+            type: 'array',
+            items: { type: 'string' },
+            description: 'Label ids (for add, update)',
+        },
+        position: {
+            type: 'number',
+            description: 'Position within column (for move). Omit to append.',
+        },
+    },
+    required: ['op'],
+    additionalProperties: false,
+};
+// =============================================================================
+// Tool definition
+// =============================================================================
+/** kanban tool: project-scoped task board for human↔agent collaboration.
+ *  Permission: auto (operates on the project's kanban board, no system side effects).
+ *  State persists in DB via ctx.kanbanStore (dependency-reversal, like todoState). */
+export const kanbanTool = {
+    name: 'kanban',
+    description: `Manage the project's shared kanban task board. 5 operations:
+- view: list all columns and cards (read-only)
+- add: create a new task card (title required; optional description, columnId defaults to todo, priority defaults to medium, labels)
+- update: edit a card's title/description/priority/labels (id required)
+- move: move a card to a different column or reorder (id + columnId required; optional position)
+- delete: remove a card (id required)
+
+The board is shared across all sessions and agents in the same project — use it to coordinate work, track tasks visible to the user, and break down complex projects. Column ids are: todo, in_progress, in_review, done, cancelled (customizable by the user via the board config UI).`,
+    parameters: kanbanParameters,
+    permission: 'auto',
+    execute: async (input, ctx) => {
+        const params = input;
+        const store = ctx.kanbanStore;
+        if (!store) {
+            return { _tag: 'error', error: 'Kanban store not available in this context' };
+        }
+        const errors = [];
+        try {
+            switch (params.op) {
+                case 'view': {
+                    const board = await store.getBoard();
+                    return {
+                        _tag: 'success',
+                        output: formatBoardSummary(board),
+                        metadata: { board },
+                    };
+                }
+                case 'add': {
+                    const addTitle = params.title?.trim();
+                    if (!addTitle) {
+                        errors.push('title is required for add');
+                    }
+                    if (errors.length > 0)
+                        break;
+                    const card = await store.addCard({
+                        title: addTitle,
+                        description: params.description ?? null,
+                        columnId: params.columnId,
+                        priority: params.priority,
+                        labels: params.labels,
+                    });
+                    const board = await store.getBoard();
+                    return {
+                        _tag: 'success',
+                        output: `Card added: [${card.id.slice(0, 8)}] "${card.title}"\n\n${formatBoardSummary(board)}`,
+                        metadata: { card, board },
+                    };
+                }
+                case 'update': {
+                    const updateId = params.id?.trim();
+                    if (!updateId) {
+                        errors.push('id is required for update');
+                    }
+                    if (errors.length > 0)
+                        break;
+                    const card = await store.updateCard(updateId, {
+                        ...(params.title !== undefined && { title: params.title }),
+                        ...(params.description !== undefined && { description: params.description }),
+                        ...(params.priority !== undefined && { priority: params.priority }),
+                        ...(params.labels !== undefined && { labels: params.labels }),
+                    });
+                    const board = await store.getBoard();
+                    return {
+                        _tag: 'success',
+                        output: `Card updated: [${card.id.slice(0, 8)}] "${card.title}"\n\n${formatBoardSummary(board)}`,
+                        metadata: { card, board },
+                    };
+                }
+                case 'move': {
+                    const moveId = params.id?.trim();
+                    const targetCol = params.columnId?.trim();
+                    if (!moveId) {
+                        errors.push('id is required for move');
+                    }
+                    if (!targetCol) {
+                        errors.push('columnId is required for move');
+                    }
+                    if (errors.length > 0)
+                        break;
+                    const card = await store.moveCard(moveId, targetCol, params.position);
+                    const board = await store.getBoard();
+                    return {
+                        _tag: 'success',
+                        output: `Card moved: [${card.id.slice(0, 8)}] "${card.title}" → ${targetCol}\n\n${formatBoardSummary(board)}`,
+                        metadata: { card, board },
+                    };
+                }
+                case 'delete': {
+                    const deleteId = params.id?.trim();
+                    if (!deleteId) {
+                        errors.push('id is required for delete');
+                    }
+                    if (errors.length > 0)
+                        break;
+                    await store.deleteCard(deleteId);
+                    const board = await store.getBoard();
+                    return {
+                        _tag: 'success',
+                        output: `Card deleted: ${deleteId.slice(0, 8)}\n\n${formatBoardSummary(board)}`,
+                        metadata: { board },
+                    };
+                }
+                default:
+                    errors.push(`Unknown op: ${params.op}`);
+            }
+        }
+        catch (e) {
+            errors.push(e instanceof Error ? e.message : String(e));
+        }
+        // Errors are surfaced in output text (like todo tool) so the LLM can read
+        // and retry. Return success to avoid skewing tool metrics.
+        const board = await store.getBoard();
+        return {
+            _tag: 'success',
+            output: formatBoardSummary(board, errors),
+            metadata: { board },
+        };
+    },
+};

package/dist/tools/index.d.ts

@@ -8,7 +8,7 @@ export { globTool, globToRegex } from './builtin/glob.js';
 export { grepTool } from './builtin/grep.js';
 export { readTool } from './builtin/read.js';
 export { createDefaultURLRegistry, createFileResolver, createSkillResolver, } from './builtin/resolvers.js';
-export { taskTool } from './builtin/task.js';
+export { kanbanTool } from './builtin/kanban.js';
 export { todoTool } from './builtin/todo.js';
 export type { TodoInput, TodoItem, TodoPhase, TodoStatus } from './builtin/todo.js';
 export { writeTool } from './builtin/write.js';

package/dist/tools/index.js

@@ -7,7 +7,7 @@ export { grepTool } from './builtin/grep.js';
 export { readTool } from './builtin/read.js';
 // ── Builtin tools ───────────────────────────────────────────
 export { createDefaultURLRegistry, createFileResolver, createSkillResolver, } from './builtin/resolvers.js';
-export { taskTool } from './builtin/task.js';
+export { kanbanTool } from './builtin/kanban.js';
 export { todoTool } from './builtin/todo.js';
 export { writeTool } from './builtin/write.js';
 export { yieldTool } from './builtin/yield.js';
@@ -27,6 +27,7 @@ import { dapTools } from './builtin/dap.js';
 import { editTool } from './builtin/edit.js';
 import { globTool } from './builtin/glob.js';
 import { grepTool } from './builtin/grep.js';
+import { kanbanTool } from './builtin/kanban.js';
 import { readTool } from './builtin/read.js';
 import { taskTool } from './builtin/task.js';
 import { todoTool } from './builtin/todo.js';
@@ -48,6 +49,7 @@ export function createDefaultRegistry(config = DEFAULT_CONFIG) {
     registerTool(reg, globTool);
     registerTool(reg, grepTool);
     registerTool(reg, bashTool);
+    registerTool(reg, kanbanTool);
     registerTool(reg, taskTool);
     registerTool(reg, todoTool);
     registerTool(reg, yieldTool);

package/drizzle/0004_smooth_red_skull.sql

@@ -0,0 +1,26 @@
+CREATE TABLE "kanban_boards" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"project_id" text NOT NULL,
+	"columns" jsonb NOT NULL,
+	"labels" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE "kanban_cards" (
+	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
+	"board_id" uuid NOT NULL,
+	"title" text NOT NULL,
+	"description" text,
+	"column_id" text NOT NULL,
+	"priority" text DEFAULT 'medium' NOT NULL,
+	"position" real DEFAULT 0 NOT NULL,
+	"labels" jsonb DEFAULT '[]'::jsonb NOT NULL,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+ALTER TABLE "kanban_boards" ADD CONSTRAINT "kanban_boards_project_id_projects_id_fk" FOREIGN KEY ("project_id") REFERENCES "public"."projects"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+ALTER TABLE "kanban_cards" ADD CONSTRAINT "kanban_cards_board_id_kanban_boards_id_fk" FOREIGN KEY ("board_id") REFERENCES "public"."kanban_boards"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
+CREATE UNIQUE INDEX "uq_kanban_boards_project" ON "kanban_boards" USING btree ("project_id");--> statement-breakpoint
+CREATE INDEX "idx_kanban_cards_board" ON "kanban_cards" USING btree ("board_id","column_id","position");