cray-code 1.0.0

package/dist/tools/TodoWriteTool.js

@@ -0,0 +1,58 @@
+/**
+ * TodoWriteTool — Task list management for Cray Code.
+ * Allows the agent to track multi-step task progress.
+ */
+import { z } from 'zod';
+import { buildTool } from '../Tool.js';
+export const TODO_WRITE_TOOL_NAME = 'todo_write';
+const todoItemSchema = z.object({
+    content: z.string().min(1).describe('The task description (imperative form)'),
+    status: z.enum(['pending', 'in_progress', 'completed']).describe('Task status'),
+    activeForm: z.string().min(1).describe('Present continuous form (e.g., "Running tests")'),
+});
+const inputSchema = z.object({
+    todos: z.array(todoItemSchema).describe('The updated todo list'),
+});
+export const TodoWriteTool = buildTool({
+    name: TODO_WRITE_TOOL_NAME,
+    aliases: ['todos', 'tasklist'],
+    searchHint: 'todo task list progress tracking',
+    inputSchema,
+    async description() {
+        return 'Updates the task list';
+    },
+    userFacingName() {
+        return 'TodoWrite';
+    },
+    isReadOnly() {
+        return false;
+    },
+    isConcurrencySafe() {
+        return false; // Tasks should be serial
+    },
+    async checkPermissions(_input, _context) {
+        return { behavior: 'allow' };
+    },
+    async call(input, context) {
+        const summary = input.todos.map((t) => {
+            const icon = t.status === 'completed' ? '[x]' : t.status === 'in_progress' ? '[>]' : '[ ]';
+            return `${icon} ${t.content}`;
+        }).join('\n');
+        const stats = {
+            total: input.todos.length,
+            completed: input.todos.filter((t) => t.status === 'completed').length,
+            inProgress: input.todos.filter((t) => t.status === 'in_progress').length,
+            pending: input.todos.filter((t) => t.status === 'pending').length,
+        };
+        context.logDebug(`Todo updated: ${stats.completed}/${stats.total} completed`);
+        return {
+            data: summary,
+            content: `Tasks updated: ${stats.completed}/${stats.total} completed`,
+            title: `Todo (${stats.completed}/${stats.total})`,
+        };
+    },
+    renderToolUseMessage(input) {
+        return `Updating ${input.todos.length} tasks...`;
+    },
+});
+//# sourceMappingURL=TodoWriteTool.js.map

package/dist/tools/TodoWriteTool.js.map

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

package/dist/tools/WebFetchTool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WebFetchTool — Fetch and process web content for Cray Code.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const WEB_FETCH_TOOL_NAME = "web_fetch";
+export declare const WebFetchTool: ToolDef<z.ZodObject<{
+    url: z.ZodString;
+    prompt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    url: string;
+}, {
+    prompt: string;
+    url: string;
+}>, string>;
+//# sourceMappingURL=WebFetchTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebFetchTool.d.ts","sourceRoot":"","sources":["../../src/tools/WebFetchTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAG3F,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAS/C,eAAO,MAAM,YAAY;;;;;;;;;WAiFvB,CAAC"}

package/dist/tools/WebFetchTool.js

@@ -0,0 +1,97 @@
+/**
+ * WebFetchTool — Fetch and process web content for Cray Code.
+ */
+import { z } from 'zod';
+import { buildTool } from '../Tool.js';
+export const WEB_FETCH_TOOL_NAME = 'web_fetch';
+const inputSchema = z.object({
+    url: z.string().url().describe('The URL to fetch'),
+    prompt: z.string().describe('What information to extract from the page'),
+});
+export const WebFetchTool = buildTool({
+    name: WEB_FETCH_TOOL_NAME,
+    aliases: ['fetch', 'curl'],
+    searchHint: 'web fetch http url download',
+    inputSchema,
+    description(input) {
+        return `Fetch: ${input.url}`;
+    },
+    userFacingName() {
+        return 'WebFetch';
+    },
+    isReadOnly() {
+        return true;
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async checkPermissions(_input, _context) {
+        return { behavior: 'passthrough' };
+    },
+    async call(input) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 30_000);
+            const response = await fetch(input.url, {
+                signal: controller.signal,
+                headers: {
+                    'User-Agent': 'CrayCode/1.0 (AI Agent)',
+                    'Accept': 'text/html, text/plain, application/json',
+                },
+            });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return {
+                    data: '',
+                    content: `HTTP ${response.status}: ${response.statusText} for ${input.url}`,
+                    isError: true,
+                    title: `WebFetch: ${response.status}`,
+                };
+            }
+            const contentType = response.headers.get('content-type') || '';
+            let content;
+            if (contentType.includes('text/html')) {
+                const html = await response.text();
+                content = stripHtml(html);
+            }
+            else {
+                content = await response.text();
+            }
+            // Truncate large responses
+            const truncated = content.length > 50_000;
+            if (truncated) {
+                content = content.slice(0, 50_000) + '\n... [truncated at 50KB]';
+            }
+            return {
+                data: content,
+                content,
+                truncated,
+                title: `WebFetch: ${new URL(input.url).hostname}`,
+            };
+        }
+        catch (err) {
+            return {
+                data: '',
+                content: `Fetch failed: ${err.name === 'AbortError' ? 'Request timed out' : err.message}`,
+                isError: true,
+                title: 'WebFetch Error',
+            };
+        }
+    },
+});
+function stripHtml(html) {
+    // Basic HTML to text conversion
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=WebFetchTool.js.map

package/dist/tools/WebFetchTool.js.map

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

package/dist/tools/WebSearchTool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * WebSearchTool — Web search capability for Cray Code.
+ * Uses a configurable search backend (default: free API).
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const WEB_SEARCH_TOOL_NAME = "web_search";
+export declare const WebSearchTool: ToolDef<z.ZodObject<{
+    query: z.ZodString;
+    max_results: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    max_results: number;
+    query: string;
+}, {
+    query: string;
+    max_results?: number | undefined;
+}>, string>;
+//# sourceMappingURL=WebSearchTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebSearchTool.d.ts","sourceRoot":"","sources":["../../src/tools/WebSearchTool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAG3F,eAAO,MAAM,oBAAoB,eAAe,CAAC;AASjD,eAAO,MAAM,aAAa;;;;;;;;;WA2ExB,CAAC"}

package/dist/tools/WebSearchTool.js

@@ -0,0 +1,76 @@
+/**
+ * WebSearchTool — Web search capability for Cray Code.
+ * Uses a configurable search backend (default: free API).
+ */
+import { z } from 'zod';
+import { buildTool } from '../Tool.js';
+export const WEB_SEARCH_TOOL_NAME = 'web_search';
+const inputSchema = z.object({
+    query: z.string().min(2).describe('The search query'),
+    max_results: z.number().optional().default(5).describe('Max results to return'),
+});
+export const WebSearchTool = buildTool({
+    name: WEB_SEARCH_TOOL_NAME,
+    aliases: ['search_web', 'ddg'],
+    searchHint: 'web search internet query',
+    inputSchema,
+    async description(input) {
+        return `Search: "${input.query}"`;
+    },
+    userFacingName() {
+        return 'WebSearch';
+    },
+    isReadOnly() {
+        return true;
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async checkPermissions(_input, _context) {
+        return { behavior: 'passthrough' };
+    },
+    async call(input) {
+        try {
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), 15_000);
+            // Use DuckDuckGo Instant Answer API (free, no key required)
+            const url = `https://api.duckduckgo.com/?q=${encodeURIComponent(input.query)}&format=json&no_html=1&skip_disambig=1`;
+            const response = await fetch(url, { signal: controller.signal });
+            clearTimeout(timeout);
+            const data = await response.json();
+            const results = [];
+            if (data.AbstractText) {
+                results.push(`Summary: ${data.AbstractText}`);
+            }
+            if (data.AbstractURL) {
+                results.push(`Source: ${data.AbstractURL}`);
+            }
+            if (data.RelatedTopics?.length) {
+                results.push('\nRelated:');
+                for (const topic of data.RelatedTopics.slice(0, input.max_results)) {
+                    if (topic.Text) {
+                        results.push(`- ${topic.Text} (${topic.FirstURL || ''})`);
+                    }
+                }
+            }
+            if (results.length === 0) {
+                results.push(`No results found for "${input.query}". Try a different query.`);
+            }
+            const output = results.join('\n');
+            return {
+                data: output,
+                content: output,
+                title: `Search: ${input.query}`,
+            };
+        }
+        catch (err) {
+            return {
+                data: '',
+                content: `Search failed: ${err.name === 'AbortError' ? 'Timed out' : err.message}`,
+                isError: true,
+                title: 'Search Error',
+            };
+        }
+    },
+});
+//# sourceMappingURL=WebSearchTool.js.map

package/dist/tools/WebSearchTool.js.map

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

package/dist/tools/WriteTool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * WriteTool — File writing tool for Cray Code.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const WRITE_TOOL_NAME = "write";
+export declare const WriteTool: ToolDef<z.ZodObject<{
+    file_path: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    file_path: string;
+}, {
+    content: string;
+    file_path: string;
+}>, string>;
+//# sourceMappingURL=WriteTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WriteTool.d.ts","sourceRoot":"","sources":["../../src/tools/WriteTool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAG3F,eAAO,MAAM,eAAe,UAAU,CAAC;AASvC,eAAO,MAAM,SAAS;;;;;;;;;WAiFpB,CAAC"}

package/dist/tools/WriteTool.js

@@ -0,0 +1,84 @@
+/**
+ * WriteTool — File writing tool for Cray Code.
+ */
+import { z } from 'zod';
+import { writeFile } from 'fs/promises';
+import { existsSync, mkdirSync } from 'fs';
+import * as path from 'path';
+import { buildTool } from '../Tool.js';
+export const WRITE_TOOL_NAME = 'write';
+const inputSchema = z.object({
+    file_path: z.string().describe('The absolute path to write to'),
+    content: z.string().describe('The content to write'),
+});
+export const WriteTool = buildTool({
+    name: WRITE_TOOL_NAME,
+    aliases: ['create'],
+    searchHint: 'file write create new',
+    inputSchema,
+    async description(input) {
+        return `Writes file: ${path.basename(input.file_path)}`;
+    },
+    userFacingName() {
+        return 'Write';
+    },
+    isReadOnly() {
+        return false;
+    },
+    isDestructive() {
+        return true; // Overwrites files
+    },
+    isConcurrencySafe() {
+        return false;
+    },
+    async checkPermissions(input, context) {
+        const mode = (context?.permissionContext?.mode ?? context?.mode) ?? 'default';
+        if (mode === 'bypass')
+            return { behavior: 'allow' };
+        if (mode === 'acceptEdits')
+            return { behavior: 'allow' };
+        const basename = path.basename(input.file_path);
+        const isNew = !existsSync(input.file_path);
+        return {
+            behavior: 'ask',
+            message: isNew
+                ? `Create new file: ${basename}?`
+                : `Overwrite ${basename} (${input.content.length} chars)?`,
+        };
+    },
+    async call(input, context) {
+        const filePath = path.resolve(input.file_path);
+        try {
+            // Ensure parent directory exists
+            const dir = path.dirname(filePath);
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            const existed = existsSync(filePath);
+            await writeFile(filePath, input.content, 'utf-8');
+            const lines = input.content.split('\n').length;
+            const size = Buffer.byteLength(input.content, 'utf-8');
+            const msg = existed
+                ? `Overwrote ${path.basename(filePath)} (${lines} lines, ${(size / 1024).toFixed(1)}KB)`
+                : `Created ${path.basename(filePath)} (${lines} lines, ${(size / 1024).toFixed(1)}KB)`;
+            return {
+                data: msg,
+                content: msg,
+                title: `Write: ${path.basename(filePath)}`,
+            };
+        }
+        catch (err) {
+            return {
+                data: '',
+                content: `Failed to write ${filePath}: ${err.message}`,
+                isError: true,
+                title: `Write Error: ${path.basename(filePath)}`,
+            };
+        }
+    },
+    renderToolUseMessage(input) {
+        const lines = input.content.split('\n').length;
+        return `Writing ${path.basename(input.file_path)} (${lines} lines)...`;
+    },
+});
+//# sourceMappingURL=WriteTool.js.map

package/dist/tools/WriteTool.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tools index — exports all Cray Code tools.
+ */
+export { BashTool, BASH_TOOL_NAME } from './BashTool.js';
+export { ReadTool, READ_TOOL_NAME } from './ReadTool.js';
+export { WriteTool, WRITE_TOOL_NAME } from './WriteTool.js';
+export { EditTool, EDIT_TOOL_NAME } from './EditTool.js';
+export { GlobTool, GLOB_TOOL_NAME } from './GlobTool.js';
+export { GrepTool, GREP_TOOL_NAME } from './GrepTool.js';
+export { WebFetchTool, WEB_FETCH_TOOL_NAME } from './WebFetchTool.js';
+export { WebSearchTool, WEB_SEARCH_TOOL_NAME } from './WebSearchTool.js';
+export { createMCPTool, MCP_TOOL_NAME } from './MCPTool.js';
+export { SkillTool, SKILL_TOOL_NAME } from './SkillTool.js';
+export { AgentTool, AGENT_TOOL_NAME, BUILT_IN_AGENTS } from './AgentTool.js';
+export type { BuiltInAgentType } from './AgentTool.js';
+export { TodoWriteTool, TODO_WRITE_TOOL_NAME } from './TodoWriteTool.js';
+export { AskUserQuestionTool, ASK_USER_QUESTION_TOOL_NAME } from './AskUserQuestionTool.js';
+export { EnterPlanModeTool, ExitPlanModeTool, ENTER_PLAN_TOOL_NAME, EXIT_PLAN_TOOL_NAME } from './PlanTools.js';
+export { NotebookReadTool, NOTEBOOK_READ_TOOL_NAME } from './NotebookReadTool.js';
+export { NotebookEditTool, NOTEBOOK_EDIT_TOOL_NAME } from './NotebookEditTool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,20 @@
+/**
+ * Tools index — exports all Cray Code tools.
+ */
+export { BashTool, BASH_TOOL_NAME } from './BashTool.js';
+export { ReadTool, READ_TOOL_NAME } from './ReadTool.js';
+export { WriteTool, WRITE_TOOL_NAME } from './WriteTool.js';
+export { EditTool, EDIT_TOOL_NAME } from './EditTool.js';
+export { GlobTool, GLOB_TOOL_NAME } from './GlobTool.js';
+export { GrepTool, GREP_TOOL_NAME } from './GrepTool.js';
+export { WebFetchTool, WEB_FETCH_TOOL_NAME } from './WebFetchTool.js';
+export { WebSearchTool, WEB_SEARCH_TOOL_NAME } from './WebSearchTool.js';
+export { createMCPTool, MCP_TOOL_NAME } from './MCPTool.js';
+export { SkillTool, SKILL_TOOL_NAME } from './SkillTool.js';
+export { AgentTool, AGENT_TOOL_NAME, BUILT_IN_AGENTS } from './AgentTool.js';
+export { TodoWriteTool, TODO_WRITE_TOOL_NAME } from './TodoWriteTool.js';
+export { AskUserQuestionTool, ASK_USER_QUESTION_TOOL_NAME } from './AskUserQuestionTool.js';
+export { EnterPlanModeTool, ExitPlanModeTool, ENTER_PLAN_TOOL_NAME, EXIT_PLAN_TOOL_NAME } from './PlanTools.js';
+export { NotebookReadTool, NOTEBOOK_READ_TOOL_NAME } from './NotebookReadTool.js';
+export { NotebookEditTool, NOTEBOOK_EDIT_TOOL_NAME } from './NotebookEditTool.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAChH,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * tools.ts — Tool Registry for Cray Code
+ *
+ * Central registry that assembles the full tool pool including:
+ * - Built-in tools (read, write, edit, bash, glob, grep, etc.)
+ * - MCP-provided tools (dynamic, from connected MCP servers)
+ * - Skill-linked tools (restricted tool sets for specific skills)
+ *
+ * Tool filtering by permission context and agent type is applied here.
+ */
+import type { ToolDef } from './Tool.js';
+import { type AgentDefinitionInfo } from './Tool.js';
+import type { ToolPermissionContext } from './types/permission.js';
+/** All built-in tools (always available base set) */
+export declare function getAllBuiltinTools(): ToolDef<any, any>[];
+/**
+ * Tools that sub-agents CANNOT use.
+ * Prevents infinite recursion and mode confusion.
+ */
+export declare const ALL_AGENT_DISALLOWED_TOOLS: Set<string>;
+/** Tools allowed for async (background) agents */
+export declare const ASYNC_AGENT_ALLOWED_TOOLS: Set<string>;
+/**
+ * Build the complete tool pool for a given context.
+ * Result is memoized — only rebuilds when MCP tools change context changes.
+ */
+export declare function buildToolPool(permissionContext: ToolPermissionContext, agentDef?: AgentDefinitionInfo): ToolDef<any, any>[];
+/** Invalidate tool pool cache (call after MCP server changes) */
+export declare function invalidateToolPoolCache(): void;
+/**
+ * Build a minimal tool pool for async background agents.
+ */
+export declare function buildAsyncAgentToolPool(permissionContext: ToolPermissionContext): ToolDef<any, any>[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAoB,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAqBnE,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAmBxD;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,aAMrC,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,yBAAyB,aAGpC,CAAC;AAOH;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,iBAAiB,EAAE,qBAAqB,EACxC,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAoCrB;AAED,iEAAiE;AACjE,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,qBAAqB,GACvC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAWrB"}

package/dist/tools.js

@@ -0,0 +1,102 @@
+/**
+ * tools.ts — Tool Registry for Cray Code
+ *
+ * Central registry that assembles the full tool pool including:
+ * - Built-in tools (read, write, edit, bash, glob, grep, etc.)
+ * - MCP-provided tools (dynamic, from connected MCP servers)
+ * - Skill-linked tools (restricted tool sets for specific skills)
+ *
+ * Tool filtering by permission context and agent type is applied here.
+ */
+import { assembleToolPool } from './Tool.js';
+import { BashTool, ReadTool, WriteTool, EditTool, GlobTool, GrepTool, WebFetchTool, WebSearchTool, SkillTool, AgentTool, TodoWriteTool, AskUserQuestionTool, EnterPlanModeTool, ExitPlanModeTool, NotebookReadTool, NotebookEditTool, } from './tools/index.js';
+import { getAllMCPWrappedTools } from './services/mcp/manager.js';
+/** All built-in tools (always available base set) */
+export function getAllBuiltinTools() {
+    return [
+        ReadTool,
+        WriteTool,
+        EditTool,
+        BashTool,
+        GlobTool,
+        GrepTool,
+        WebFetchTool,
+        WebSearchTool,
+        SkillTool,
+        AgentTool,
+        TodoWriteTool,
+        AskUserQuestionTool,
+        EnterPlanModeTool,
+        ExitPlanModeTool,
+        NotebookReadTool,
+        NotebookEditTool,
+    ];
+}
+/**
+ * Tools that sub-agents CANNOT use.
+ * Prevents infinite recursion and mode confusion.
+ */
+export const ALL_AGENT_DISALLOWED_TOOLS = new Set([
+    'agent', // Prevent sub-agent nesting loops
+    'task', // Legacy alias
+    'enter_plan_mode',
+    'exit_plan_mode',
+    'ask_user',
+]);
+/** Tools allowed for async (background) agents */
+export const ASYNC_AGENT_ALLOWED_TOOLS = new Set([
+    'read', 'glob', 'grep', 'web_fetch', 'web_search', 'bash',
+    'write', 'edit',
+]);
+// ─── Tool pool memoization ────────────────────────────────────
+let poolCacheKey = '';
+let poolCacheResult = [];
+/**
+ * Build the complete tool pool for a given context.
+ * Result is memoized — only rebuilds when MCP tools change context changes.
+ */
+export function buildToolPool(permissionContext, agentDef) {
+    const builtinTools = getAllBuiltinTools();
+    const mcpTools = getAllMCPWrappedTools();
+    // Cache key from tool names + permission mode + agent type
+    const key = JSON.stringify({
+        builtins: builtinTools.map((t) => t.name).sort(),
+        mcp: mcpTools.map((t) => t.name).sort(),
+        mode: permissionContext.mode,
+        agent: agentDef?.name ?? '',
+        allowed: agentDef?.allowedTools?.join(','),
+    });
+    if (key === poolCacheKey && poolCacheResult.length > 0)
+        return poolCacheResult;
+    let filteredBuiltins = builtinTools;
+    if (agentDef?.allowedTools?.length) {
+        filteredBuiltins = builtinTools.filter((t) => agentDef.allowedTools.includes(t.name));
+    }
+    filteredBuiltins = filteredBuiltins.filter((t) => !ALL_AGENT_DISALLOWED_TOOLS.has(t.name));
+    const result = assembleToolPool({
+        builtinTools: filteredBuiltins,
+        mcpTools,
+        permissionContext,
+    });
+    poolCacheKey = key;
+    poolCacheResult = result;
+    return result;
+}
+/** Invalidate tool pool cache (call after MCP server changes) */
+export function invalidateToolPoolCache() {
+    poolCacheKey = '';
+    poolCacheResult = [];
+}
+/**
+ * Build a minimal tool pool for async background agents.
+ */
+export function buildAsyncAgentToolPool(permissionContext) {
+    const builtins = getAllBuiltinTools().filter((t) => ASYNC_AGENT_ALLOWED_TOOLS.has(t.name));
+    const mcpTools = getAllMCPWrappedTools();
+    return assembleToolPool({
+        builtinTools: builtins,
+        mcpTools,
+        permissionContext,
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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