@namzu/sdk 0.1.1

package/dist/tools/builtins/search-tools.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { defineTool } from "../defineTool.js";
+const inputSchema = z.object({
+    query: z.string().describe("Tool name or capability keyword to search for"),
+});
+export const SearchToolsTool = defineTool({
+    name: "search_tools",
+    description: "Search and load available tools by name or capability. " +
+        "Deferred tools listed in the system prompt must be loaded via this tool before use.",
+    inputSchema,
+    category: "analysis",
+    permissions: [],
+    readOnly: true,
+    destructive: false,
+    concurrencySafe: true,
+    async execute(input, context) {
+        if (!context.toolRegistry) {
+            return {
+                success: false,
+                output: "",
+                error: "Tool registry not available in this context.",
+            };
+        }
+        const matches = context.toolRegistry.searchDeferred(input.query);
+        if (matches.length === 0) {
+            return {
+                success: true,
+                output: `No deferred tools matching "${input.query}". All matching tools are already active.`,
+            };
+        }
+        context.toolRegistry.activate(matches.map((t) => t.name));
+        const descriptions = matches
+            .map((t) => `- ${t.name}: ${t.description}`)
+            .join("\n");
+        return {
+            success: true,
+            output: `Activated ${matches.length} tool(s):\n${descriptions}`,
+            data: {
+                activated: matches.map((t) => t.name),
+                count: matches.length,
+            },
+        };
+    },
+});
+//# sourceMappingURL=search-tools.js.map

package/dist/tools/builtins/search-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-tools.js","sourceRoot":"","sources":["../../../src/tools/builtins/search-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CAC3E,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;IACzC,IAAI,EAAE,cAAc;IACpB,WAAW,EACV,yDAAyD;QACzD,qFAAqF;IACtF,WAAW;IACX,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,EAAE;IACf,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,KAAK;IAClB,eAAe,EAAE,IAAI;IAErB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;QAC3B,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC3B,OAAO;gBACN,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,8CAA8C;aACrD,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,+BAA+B,KAAK,CAAC,KAAK,2CAA2C;aAC7F,CAAC;QACH,CAAC;QAED,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAE1D,MAAM,YAAY,GAAG,OAAO;aAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;aAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,OAAO;YACN,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,aAAa,OAAO,CAAC,MAAM,cAAc,YAAY,EAAE;YAC/D,IAAI,EAAE;gBACL,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;gBACrC,KAAK,EAAE,OAAO,CAAC,MAAM;aACrB;SACD,CAAC;IACH,CAAC;CACD,CAAC,CAAC"}

package/dist/tools/builtins/write-file.d.ts

@@ -0,0 +1,5 @@
+export declare const WriteFileTool: import("../../index.js").ToolDefinition<{
+    path: string;
+    content: string;
+}>;
+//# sourceMappingURL=write-file.d.ts.map

package/dist/tools/builtins/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../../src/tools/builtins/write-file.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,aAAa;;;EAuBxB,CAAA"}

package/dist/tools/builtins/write-file.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { defineTool } from '../defineTool.js';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+const inputSchema = z.object({
+    path: z.string().describe('Path to the file to write'),
+    content: z.string().describe('Content to write to the file'),
+});
+export const WriteFileTool = defineTool({
+    name: 'write_file',
+    description: 'Writes content to a file. Creates the file if it does not exist, overwrites if it does. Creates intermediate directories as needed.',
+    inputSchema,
+    category: 'filesystem',
+    permissions: ['file_write'],
+    readOnly: false,
+    destructive: true,
+    concurrencySafe: false,
+    async execute(input, context) {
+        const filePath = resolve(context.workingDirectory, input.path);
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, input.content, 'utf-8');
+        return {
+            success: true,
+            output: `File written successfully: ${filePath} (${input.content.length} chars)`,
+            data: { path: filePath, size: input.content.length },
+        };
+    },
+});
+//# sourceMappingURL=write-file.js.map

package/dist/tools/builtins/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/builtins/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC7D,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,UAAU,CAAC;IACtC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,qIAAqI;IACvI,WAAW;IACX,QAAQ,EAAE,YAAY;IACtB,WAAW,EAAE,CAAC,YAAY,CAAC;IAC3B,QAAQ,EAAE,KAAK;IACf,WAAW,EAAE,IAAI;IACjB,eAAe,EAAE,KAAK;IAEtB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO;QAC1B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAE9D,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAEjD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,8BAA8B,QAAQ,KAAK,KAAK,CAAC,OAAO,CAAC,MAAM,SAAS;YAChF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE;SACrD,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/tools/coordinator/index.d.ts

@@ -0,0 +1,21 @@
+import type { TaskGateway } from '../../types/agent/gateway.js';
+import type { RunId, TaskId } from '../../types/ids/index.js';
+import type { PlanManager } from '../../manager/plan/lifecycle.js';
+import type { TaskStore } from '../../types/task/index.js';
+import type { ToolDefinition } from '../../types/tool/index.js';
+export type TaskLaunchedCallback = (agentTaskId: TaskId, meta: {
+    agentId: string;
+    description: string;
+    planTaskId?: string;
+}) => void;
+export interface CoordinatorToolsOptions {
+    gateway: TaskGateway;
+    workingDirectory: string;
+    allowedAgentIds: string[];
+    taskStore?: TaskStore;
+    runId?: RunId;
+    getPlanManager?: () => PlanManager | undefined;
+    onTaskLaunched?: TaskLaunchedCallback;
+}
+export declare function buildCoordinatorTools(opts: CoordinatorToolsOptions): ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/coordinator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/coordinator/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,MAAM,MAAM,oBAAoB,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IAC7D,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,KAAK,IAAI,CAAA;AAEV,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,WAAW,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,EAAE,CAAA;IAEzB,SAAS,CAAC,EAAE,SAAS,CAAA;IAErB,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,cAAc,CAAC,EAAE,MAAM,WAAW,GAAG,SAAS,CAAA;IAE9C,cAAc,CAAC,EAAE,oBAAoB,CAAA;CACtC;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,uBAAuB,GAC5B,cAAc,EAAE,CA8KlB"}

package/dist/tools/coordinator/index.js

@@ -0,0 +1,163 @@
+import { z } from 'zod';
+import { defineTool } from '../defineTool.js';
+export function buildCoordinatorTools(opts) {
+    const { gateway, allowedAgentIds: agentIds, taskStore, runId, getPlanManager, onTaskLaunched } = opts;
+    const cwd = opts.workingDirectory;
+    const agentIdEnum = agentIds.length > 0
+        ? z.enum(agentIds)
+        : z.string();
+    const createTask = defineTool({
+        name: 'create_task',
+        description: `Launch a task on a specialized agent. NON-BLOCKING: returns immediately. You will receive a <task-notification> message when the agent finishes. Available agents: ${agentIds.join(', ')}. The agent cannot see your conversation — include ALL necessary context in the prompt. To launch multiple tasks in parallel, call this tool multiple times in a single response. After launching, briefly tell the user what you launched and end your turn — do NOT predict or fabricate results.`,
+        inputSchema: z.object({
+            agent_id: agentIdEnum.describe('Which agent to run'),
+            prompt: z.string().describe('Self-contained task description with all context the agent needs'),
+            description: z.string().describe('Short summary for tracking (shown to user)'),
+            plan_task_id: z.string().optional().describe('Existing planning task ID to link. If omitted, a planning task is auto-created.'),
+        }),
+        category: 'custom',
+        permissions: [],
+        readOnly: false,
+        destructive: false,
+        concurrencySafe: true,
+        async execute({ agent_id, prompt, description, plan_task_id }) {
+            let resolvedPlanTaskId = plan_task_id;
+            if (taskStore) {
+                if (resolvedPlanTaskId) {
+                    await taskStore.update(resolvedPlanTaskId, {
+                        status: 'in_progress',
+                        owner: agent_id,
+                    });
+                }
+                else if (runId) {
+                    const planTask = await taskStore.create({
+                        runId,
+                        subject: description,
+                        activeForm: description,
+                        owner: agent_id,
+                    });
+                    await taskStore.update(planTask.id, { status: 'in_progress' });
+                    resolvedPlanTaskId = planTask.id;
+                }
+            }
+            const handle = await gateway.createTask({
+                agentId: agent_id,
+                prompt,
+                workingDirectory: cwd,
+            });
+            if (onTaskLaunched) {
+                onTaskLaunched(handle.taskId, {
+                    agentId: agent_id,
+                    description,
+                    planTaskId: resolvedPlanTaskId,
+                });
+            }
+            return {
+                success: true,
+                output: `Task launched: ${handle.taskId} → ${agent_id} ("${description}"). You will receive a task-notification when it completes.`,
+                data: { task_id: handle.taskId, agent_id, description, state: 'running', plan_task_id: resolvedPlanTaskId },
+            };
+        },
+    });
+    const continueTask = defineTool({
+        name: 'continue_task',
+        description: 'Send a follow-up message to a previously completed task. NON-BLOCKING: the agent resumes in the background with full prior context. You will receive a task-notification when it finishes. Only use this with a task_id from a previous create_task or task-notification.',
+        inputSchema: z.object({
+            task_id: z.string().describe('Agent task ID from a previous create_task or task-notification'),
+            message: z.string().describe('Follow-up instruction for the agent'),
+        }),
+        category: 'custom',
+        permissions: [],
+        readOnly: false,
+        destructive: false,
+        concurrencySafe: true,
+        async execute({ task_id, message }) {
+            await gateway.continueTask(task_id, message);
+            return {
+                success: true,
+                output: `Follow-up sent to ${task_id}. You will receive a task-notification when it finishes.`,
+                data: { task_id, state: 'running' },
+            };
+        },
+    });
+    const cancelTask = defineTool({
+        name: 'cancel_task',
+        description: 'Cancel a running agent task. Only use this with a task_id from a previous create_task.',
+        inputSchema: z.object({
+            task_id: z.string().describe('Agent task ID from a previous create_task'),
+        }),
+        category: 'custom',
+        permissions: [],
+        readOnly: false,
+        destructive: false,
+        concurrencySafe: true,
+        async execute({ task_id }) {
+            gateway.cancelTask(task_id);
+            return {
+                success: true,
+                output: `Task ${task_id} cancelled`,
+                data: { task_id },
+            };
+        },
+    });
+    const tools = [createTask, continueTask, cancelTask];
+    if (getPlanManager) {
+        const approvePlan = defineTool({
+            name: 'approve_plan',
+            description: 'Present your execution plan to the user for approval before launching workers. Call this after you have analyzed the request and determined what tasks to run. The user can approve, reject with feedback, or modify the plan. Only proceed with create_task after approval.',
+            inputSchema: z.object({
+                title: z.string().describe('Short title for the plan (e.g. "TypeScript Security & Performance Review")'),
+                summary: z.string().describe('1-3 sentence summary of what you plan to do'),
+                steps: z.array(z.object({
+                    description: z.string().describe('What this step does'),
+                    agent_id: z.string().optional().describe('Which agent handles this (omit for orchestrator-owned steps)'),
+                    depends_on: z.array(z.string()).optional().describe('Step descriptions this depends on'),
+                })).describe('Ordered list of planned steps'),
+            }),
+            category: 'custom',
+            permissions: [],
+            readOnly: true,
+            destructive: false,
+            concurrencySafe: true,
+            async execute({ title, summary, steps }) {
+                const pm = getPlanManager();
+                if (!pm) {
+                    return {
+                        success: false,
+                        output: 'Plan approval is not available — proceed directly with create_task.',
+                        data: { approved: true },
+                    };
+                }
+                pm.startGenerating(title);
+                for (let i = 0; i < steps.length; i++) {
+                    const step = steps[i];
+                    pm.addStep({
+                        id: `step_${i + 1}`,
+                        description: step.description,
+                        toolName: step.agent_id ? 'create_task' : undefined,
+                        dependsOn: [],
+                        order: i + 1,
+                    });
+                }
+                pm.markReady(summary);
+                const response = await pm.requestApproval();
+                if (response.approved) {
+                    pm.startExecution();
+                    return {
+                        success: true,
+                        output: 'Plan approved by user. Proceed with execution — launch workers via create_task.',
+                        data: { approved: true, feedback: response.feedback },
+                    };
+                }
+                return {
+                    success: false,
+                    output: `Plan rejected. User feedback: ${response.feedback ?? 'No feedback provided'}. Revise your plan based on this feedback and call approve_plan again, or ask the user for clarification.`,
+                    data: { approved: false, feedback: response.feedback },
+                };
+            },
+        });
+        tools.push(approvePlan);
+    }
+    return tools;
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/coordinator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/coordinator/index.ts"],"names":[],"mappings":"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"}

package/dist/tools/defineTool.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+import type { ToolDefinition, ToolContext, ToolResult, ToolPermission } from '../types/tool/index.js';
+export interface DefineToolOptions<S extends z.ZodType> {
+    name: string;
+    description: string;
+    inputSchema: S;
+    category: ToolDefinition['category'];
+    permissions: ToolPermission[];
+    readOnly: boolean;
+    destructive: boolean | ((input: z.infer<S>) => boolean);
+    concurrencySafe: boolean;
+    execute(input: z.infer<S>, context: ToolContext): Promise<ToolResult>;
+}
+export declare function defineTool<S extends z.ZodType>(options: DefineToolOptions<S>): ToolDefinition<z.infer<S>>;
+//# sourceMappingURL=defineTool.d.ts.map

package/dist/tools/defineTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTool.d.ts","sourceRoot":"","sources":["../../src/tools/defineTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGrG,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,CAAC,CAAA;IACd,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IACpC,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAA;IACvD,eAAe,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACtE;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5C,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CA4B5B"}

package/dist/tools/defineTool.js

@@ -0,0 +1,29 @@
+import { toErrorMessage } from '../utils/error.js';
+export function defineTool(options) {
+    return {
+        name: options.name,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        category: options.category,
+        permissions: options.permissions,
+        isReadOnly: () => options.readOnly,
+        isDestructive: typeof options.destructive === 'function'
+            ? options.destructive
+            : () => options.destructive,
+        isConcurrencySafe: () => options.concurrencySafe,
+        async execute(input, context) {
+            try {
+                return await options.execute(input, context);
+            }
+            catch (err) {
+                const message = toErrorMessage(err);
+                return {
+                    success: false,
+                    output: '',
+                    error: `${options.name} failed: ${message}`,
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=defineTool.js.map

package/dist/tools/defineTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineTool.js","sourceRoot":"","sources":["../../src/tools/defineTool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAclD,MAAM,UAAU,UAAU,CACxB,OAA6B;IAI7B,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ;QAClC,aAAa,EAAE,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU;YACtD,CAAC,CAAC,OAAO,CAAC,WAAW;YACrB,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,WAAsB;QACxC,iBAAiB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,eAAe;QAEhD,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAoB;YAC/C,IAAI,CAAC;gBACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;gBACnC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,YAAY,OAAO,EAAE;iBAC5C,CAAA;YACH,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/tools/task/create.d.ts

@@ -0,0 +1,5 @@
+import type { TaskStore } from '../../types/task/index.js';
+import type { RunId } from '../../types/ids/index.js';
+import type { ToolDefinition } from '../../types/tool/index.js';
+export declare function buildTaskCreateTool(taskStore: TaskStore, runId: RunId): ToolDefinition;
+//# sourceMappingURL=create.d.ts.map

package/dist/tools/task/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/tools/task/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACX,cAAc,CAmChB"}

package/dist/tools/task/create.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import { defineTool } from '../defineTool.js';
+export function buildTaskCreateTool(taskStore, runId) {
+    return defineTool({
+        name: 'task_create',
+        description: 'Create a task to track a unit of planned work. Use this to break down complex work into trackable steps before starting. Each task has a subject (imperative: "Fix auth bug") and optionally an activeForm (present continuous: "Fixing auth bug") for progress display.',
+        inputSchema: z.object({
+            subject: z.string().describe('Brief title in imperative form ("Fix auth middleware")'),
+            description: z.string().optional().describe('Detailed description of the work'),
+            activeForm: z.string().optional().describe('Present continuous form for progress display ("Fixing auth middleware")'),
+            owner: z.string().optional().describe('Agent or role this task is assigned to (e.g. "code-review", "code-writer")'),
+            blockedBy: z.array(z.string()).optional().describe('Task IDs that must complete before this task can start'),
+            metadata: z.record(z.string(), z.unknown()).optional().describe('Free-form metadata'),
+        }),
+        category: 'custom',
+        permissions: [],
+        readOnly: false,
+        destructive: false,
+        concurrencySafe: true,
+        async execute({ subject, description, activeForm, owner, blockedBy, metadata }) {
+            const task = await taskStore.create({
+                runId,
+                subject,
+                description,
+                activeForm,
+                owner,
+                blockedBy: blockedBy,
+                metadata,
+            });
+            return {
+                success: true,
+                output: `Task created: ${task.id} — "${subject}"${owner ? ` [owner: ${owner}]` : ''}`,
+                data: { id: task.id, status: task.status, owner: task.owner },
+            };
+        },
+    });
+}
+//# sourceMappingURL=create.js.map

package/dist/tools/task/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/tools/task/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,mBAAmB,CACjC,SAAoB,EACpB,KAAY;IAEZ,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,0QAA0Q;QACvR,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YACtF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;YACrH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;YACnH,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;YAC5G,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SACtF,CAAC;QACF,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE;YAC5E,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;gBAClC,KAAK;gBACL,OAAO;gBACP,WAAW;gBACX,UAAU;gBACV,KAAK;gBACL,SAAS,EAAE,SAA2C;gBACtD,QAAQ;aACT,CAAC,CAAA;YAEF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iBAAiB,IAAI,CAAC,EAAE,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrF,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;aAC9D,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/task/index.d.ts

@@ -0,0 +1,8 @@
+import type { TaskStore } from '../../types/task/index.js';
+import type { RunId } from '../../types/ids/index.js';
+import type { ToolDefinition } from '../../types/tool/index.js';
+export declare function buildTaskTools(taskStore: TaskStore, runId: RunId): ToolDefinition[];
+export { buildTaskCreateTool } from './create.js';
+export { buildTaskUpdateTool } from './update.js';
+export { buildTaskListTool } from './list.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAK/D,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACX,cAAc,EAAE,CAMlB;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}

package/dist/tools/task/index.js

@@ -0,0 +1,14 @@
+import { buildTaskCreateTool } from './create.js';
+import { buildTaskUpdateTool } from './update.js';
+import { buildTaskListTool } from './list.js';
+export function buildTaskTools(taskStore, runId) {
+    return [
+        buildTaskCreateTool(taskStore, runId),
+        buildTaskUpdateTool(taskStore),
+        buildTaskListTool(taskStore, runId),
+    ];
+}
+export { buildTaskCreateTool } from './create.js';
+export { buildTaskUpdateTool } from './update.js';
+export { buildTaskListTool } from './list.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/task/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAE7C,MAAM,UAAU,cAAc,CAC5B,SAAoB,EACpB,KAAY;IAEZ,OAAO;QACL,mBAAmB,CAAC,SAAS,EAAE,KAAK,CAAC;QACrC,mBAAmB,CAAC,SAAS,CAAC;QAC9B,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC;KACpC,CAAA;AACH,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA"}

package/dist/tools/task/list.d.ts

@@ -0,0 +1,5 @@
+import type { TaskStore } from '../../types/task/index.js';
+import type { RunId } from '../../types/ids/index.js';
+import type { ToolDefinition } from '../../types/tool/index.js';
+export declare function buildTaskListTool(taskStore: TaskStore, runId: RunId): ToolDefinition;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/task/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/tools/task/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAI/D,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,GACX,cAAc,CAgDhB"}

package/dist/tools/task/list.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { isTerminalTaskStatus } from '../../types/task/index.js';
+import { defineTool } from '../defineTool.js';
+export function buildTaskListTool(taskStore, runId) {
+    return defineTool({
+        name: 'task_list',
+        description: 'List all tasks for the current run. Shows subject, status, owner, and unresolved blockers. Use this to review your plan and decide what to work on next.',
+        inputSchema: z.object({}),
+        category: 'custom',
+        permissions: [],
+        readOnly: true,
+        destructive: false,
+        concurrencySafe: true,
+        async execute() {
+            const tasks = await taskStore.list({ runId });
+            const completedIds = new Set(tasks
+                .filter((t) => isTerminalTaskStatus(t.status))
+                .map((t) => t.id));
+            const summary = tasks.map((task) => {
+                const unresolvedBlockers = task.blockedBy.filter((bid) => !completedIds.has(bid));
+                return {
+                    id: task.id,
+                    subject: task.subject,
+                    status: task.status,
+                    owner: task.owner ?? null,
+                    blockedBy: unresolvedBlockers.length > 0 ? unresolvedBlockers : undefined,
+                    activeForm: task.status === 'in_progress' ? task.activeForm : undefined,
+                };
+            });
+            const stats = {
+                total: tasks.length,
+                pending: tasks.filter((t) => t.status === 'pending').length,
+                in_progress: tasks.filter((t) => t.status === 'in_progress').length,
+                completed: tasks.filter((t) => t.status === 'completed').length,
+            };
+            return {
+                success: true,
+                output: tasks.length === 0
+                    ? 'No tasks yet.'
+                    : `${stats.total} tasks: ${stats.completed} completed, ${stats.in_progress} in progress, ${stats.pending} pending.`,
+                data: { tasks: summary, stats },
+            };
+        },
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/task/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/task/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,MAAM,UAAU,iBAAiB,CAC/B,SAAoB,EACpB,KAAY;IAEZ,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,0JAA0J;QACvK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACzB,QAAQ,EAAE,QAAQ;QAClB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QACrB,KAAK,CAAC,OAAO;YACX,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;YAE7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,KAAK;iBACF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;iBAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACpB,CAAA;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACjC,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;gBAEjF,OAAO;oBACL,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;oBACzB,SAAS,EAAE,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;oBACzE,UAAU,EAAE,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;iBACxE,CAAA;YACH,CAAC,CAAC,CAAA;YAEF,MAAM,KAAK,GAAG;gBACZ,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;gBAC3D,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,MAAM;gBACnE,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;aAChE,CAAA;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC;oBACxB,CAAC,CAAC,eAAe;oBACjB,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,WAAW,iBAAiB,KAAK,CAAC,OAAO,WAAW;gBACrH,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;aAChC,CAAA;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/tools/task/update.d.ts

@@ -0,0 +1,4 @@
+import type { TaskStore } from '../../types/task/index.js';
+import type { ToolDefinition } from '../../types/tool/index.js';
+export declare function buildTaskUpdateTool(taskStore: TaskStore): ToolDefinition;
+//# sourceMappingURL=update.d.ts.map

package/dist/tools/task/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/tools/task/update.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG/D,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,GACnB,cAAc,CA8DhB"}

package/dist/tools/task/update.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { defineTool } from '../defineTool.js';
+export function buildTaskUpdateTool(taskStore) {
+    return defineTool({
+        name: 'task_update',
+        description: 'Update an existing task. Change its status (pending → in_progress → completed), edit its description, transfer ownership, or manage dependencies. Use status "deleted" to remove a task entirely.',
+        inputSchema: z.object({
+            id: z.string().describe('Task ID (e.g. "task_abc123")'),
+            subject: z.string().optional().describe('Updated title'),
+            description: z.string().optional().describe('Updated description'),
+            activeForm: z.string().optional().describe('Updated present continuous form'),
+            status: z.enum(['pending', 'in_progress', 'completed', 'deleted']).optional().describe('New status'),
+            owner: z.string().optional().describe('Agent name to assign ownership'),
+            addBlocks: z.array(z.string()).optional().describe('Task IDs that this task should now block'),
+            addBlockedBy: z.array(z.string()).optional().describe('Task IDs that should now block this task'),
+            metadata: z.record(z.string(), z.unknown()).optional().describe('Metadata to merge'),
+        }),
+        category: 'custom',
+        permissions: [],
+        readOnly: false,
+        destructive: false,
+        concurrencySafe: true,
+        async execute({ id, subject, description, activeForm, status, owner, addBlocks, addBlockedBy, metadata }) {
+            const taskId = id;
+            if (status === 'deleted') {
+                const deleted = await taskStore.delete(taskId);
+                return {
+                    success: deleted,
+                    output: deleted ? `Task ${id} deleted` : `Task ${id} not found`,
+                };
+            }
+            if (addBlocks) {
+                for (const blockedId of addBlocks) {
+                    await taskStore.block(taskId, blockedId);
+                }
+            }
+            if (addBlockedBy) {
+                for (const blockerId of addBlockedBy) {
+                    await taskStore.block(blockerId, taskId);
+                }
+            }
+            const updated = await taskStore.update(taskId, {
+                subject,
+                description,
+                activeForm,
+                status: status,
+                owner,
+                metadata,
+            });
+            if (!updated) {
+                return { success: false, output: `Task ${id} not found` };
+            }
+            return {
+                success: true,
+                output: `Task ${id} updated — status: ${updated.status}`,
+                data: { id: updated.id, status: updated.status, owner: updated.owner },
+            };
+        },
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/tools/task/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/tools/task/update.ts"],"names":[],"mappings":"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"}