c0de-agent 1.5.0 → 1.7.0

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/builtin/todo.d.ts

@@ -0,0 +1,67 @@
+import type { ToolDef } from '../../shared/types/tool.js';
+type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'abandoned';
+type TodoItem = {
+    content: string;
+    status: TodoStatus;
+};
+type TodoPhase = {
+    name: string;
+    tasks: TodoItem[];
+};
+/** A single todo operation entry (the tool's input params). */
+type TodoInput = {
+    op: 'init';
+    list?: {
+        phase: string;
+        items: string[];
+    }[];
+    phase?: string;
+    items?: string[];
+} | {
+    op: 'start';
+    task: string;
+} | {
+    op: 'done';
+    task?: string;
+    phase?: string;
+} | {
+    op: 'drop';
+    task?: string;
+    phase?: string;
+} | {
+    op: 'rm';
+    task?: string;
+    phase?: string;
+} | {
+    op: 'append';
+    phase: string;
+    items: string[];
+} | {
+    op: 'view';
+};
+/** Deep-clone phases (mutation-safe). */
+export declare function clonePhases(phases: TodoPhase[]): TodoPhase[];
+/** Return the active todo task, preferring in_progress over the first pending. */
+export declare function nextActionableTask(phases: readonly TodoPhase[]): TodoItem | undefined;
+/** Report whether `content` likely names the same work as any entry in
+ *  `descriptions`. Normalize-then-equal first, with a substring fallback
+ *  in either direction (≥6 char overlap on the contained side). */
+export declare function todoMatchesAnyDescription(content: string, descriptions: readonly string[]): boolean;
+/** Render todo phases as a Markdown checklist suitable for editing/copying. */
+export declare function phasesToMarkdown(phases: TodoPhase[]): string;
+/** Parse a Markdown checklist back into todo phases. */
+export declare function markdownToPhases(md: string): {
+    phases: TodoPhase[];
+    errors: string[];
+};
+/** Extract the latest todo phases from stored messages (tool results).
+ *  Scans backwards for the most recent `todo` tool result with phases metadata. */
+export declare function getLatestTodoPhasesFromMessages(messages: {
+    role: string;
+    content: unknown[];
+}[]): TodoPhase[];
+/** todo tool: phased task tracking with 7 operations.
+ *  Permission: auto (no side effects beyond session state).
+ *  State is held in-memory via ctx.todoState hook (dependency-reversal). */
+export declare const todoTool: ToolDef;
+export type { TodoInput, TodoItem, TodoPhase, TodoStatus };