cray-code 1.0.0

package/dist/tools/MCPTool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * MCPTool — Model Context Protocol integration for Cray Code.
+ * Dynamically wraps external MCP server tools for use by the LLM agent.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const MCP_TOOL_NAME = "mcp";
+declare const inputSchema: z.ZodObject<{
+    server: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    server: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    server: z.ZodString;
+    tool: z.ZodString;
+    arguments: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.ZodTypeAny, "passthrough">>;
+/** Create a wrapped MCP tool instance for a specific MCP server tool */
+export declare function createMCPTool(serverName: string, toolName: string, toolDescription: string, toolInputSchema: Record<string, unknown>): ToolDef<typeof inputSchema, string>;
+export {};
+//# sourceMappingURL=MCPTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MCPTool.d.ts","sourceRoot":"","sources":["../../src/tools/MCPTool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAA4D,MAAM,YAAY,CAAC;AAI/G,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,QAAA,MAAM,WAAW;;;;;;;;;;;;gCAID,CAAC;AAIjB,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,OAAO,WAAW,EAAE,MAAM,CAAC,CA2DrC"}

package/dist/tools/MCPTool.js

@@ -0,0 +1,67 @@
+/**
+ * MCPTool — Model Context Protocol integration for Cray Code.
+ * Dynamically wraps external MCP server tools for use by the LLM agent.
+ */
+import { z } from 'zod';
+import { buildTool } from '../Tool.js';
+import { getAllMCPServers } from '../services/mcp/manager.js';
+export const MCP_TOOL_NAME = 'mcp';
+const inputSchema = z.object({
+    server: z.string().describe('MCP server name'),
+    tool: z.string().describe('Tool name on the MCP server'),
+    arguments: z.record(z.unknown()).describe('Tool arguments'),
+}).passthrough();
+/** Create a wrapped MCP tool instance for a specific MCP server tool */
+export function createMCPTool(serverName, toolName, toolDescription, toolInputSchema) {
+    return buildTool({
+        name: `mcp__${serverName}__${toolName}`,
+        mcpInfo: { serverName, toolName },
+        searchHint: `MCP ${serverName} ${toolName}`,
+        inputSchema,
+        description() {
+            return toolDescription;
+        },
+        userFacingName() {
+            return `${serverName}:${toolName}`;
+        },
+        isConcurrencySafe() {
+            return true;
+        },
+        async checkPermissions(_input, _context) {
+            return { behavior: 'passthrough' };
+        },
+        async call(input, _context) {
+            try {
+                const servers = getAllMCPServers();
+                const server = servers.get(serverName);
+                if (!server || !server.connected) {
+                    return {
+                        data: '',
+                        content: `MCP server "${serverName}" is not connected`,
+                        isError: true,
+                        title: `MCP Error: ${serverName}`,
+                    };
+                }
+                // Dispatch to the MCP server
+                const result = await server.callTool(toolName, input.arguments);
+                const output = typeof result === 'string' ? result : JSON.stringify(result, null, 2);
+                const truncated = output.length > 100_000;
+                return {
+                    data: truncated ? output.slice(0, 100_000) + '\n... [truncated]' : output,
+                    content: output,
+                    truncated,
+                    title: `MCP ${serverName}/${toolName}`,
+                };
+            }
+            catch (err) {
+                return {
+                    data: '',
+                    content: `MCP tool error: ${err.message}`,
+                    isError: true,
+                    title: `MCP Error: ${serverName}/${toolName}`,
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=MCPTool.js.map

package/dist/tools/MCPTool.js.map

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

package/dist/tools/NotebookEditTool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * NotebookEditTool — Jupyter notebook (.ipynb) cell editor for Cray Code.
+ * Supports replace, insert, and delete operations on individual cells.
+ * Matches Claude Code's NotebookEdit capabilities.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const NOTEBOOK_EDIT_TOOL_NAME = "notebook_edit";
+export declare const NotebookEditTool: ToolDef<z.ZodObject<{
+    notebook_path: z.ZodString;
+    cell_id: z.ZodOptional<z.ZodString>;
+    new_source: z.ZodString;
+    cell_type: z.ZodOptional<z.ZodEnum<["code", "markdown"]>>;
+    edit_mode: z.ZodDefault<z.ZodOptional<z.ZodEnum<["replace", "insert", "delete"]>>>;
+}, "strip", z.ZodTypeAny, {
+    notebook_path: string;
+    new_source: string;
+    edit_mode: "replace" | "insert" | "delete";
+    cell_id?: string | undefined;
+    cell_type?: "code" | "markdown" | undefined;
+}, {
+    notebook_path: string;
+    new_source: string;
+    cell_id?: string | undefined;
+    cell_type?: "code" | "markdown" | undefined;
+    edit_mode?: "replace" | "insert" | "delete" | undefined;
+}>, string>;
+//# sourceMappingURL=NotebookEditTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotebookEditTool.d.ts","sourceRoot":"","sources":["../../src/tools/NotebookEditTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAG3F,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AA+BvD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;WA4N3B,CAAC"}

package/dist/tools/NotebookEditTool.js

@@ -0,0 +1,213 @@
+/**
+ * NotebookEditTool — Jupyter notebook (.ipynb) cell editor for Cray Code.
+ * Supports replace, insert, and delete operations on individual cells.
+ * Matches Claude Code's NotebookEdit capabilities.
+ */
+import { z } from 'zod';
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync, mkdirSync } from 'fs';
+import * as path from 'path';
+import { buildTool } from '../Tool.js';
+export const NOTEBOOK_EDIT_TOOL_NAME = 'notebook_edit';
+const inputSchema = z.object({
+    notebook_path: z.string().describe('The absolute path to the Jupyter notebook file'),
+    cell_id: z.string().optional().describe('The ID of the cell to edit. When inserting, the new cell is inserted after this cell, or at the beginning if not specified.'),
+    new_source: z.string().describe('The new source for the cell'),
+    cell_type: z.enum(['code', 'markdown']).optional().describe('The type of the cell. Defaults to current cell type. Required for insert.'),
+    edit_mode: z.enum(['replace', 'insert', 'delete']).optional().default('replace'),
+});
+function generateCellId() {
+    return `cell-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+export const NotebookEditTool = buildTool({
+    name: NOTEBOOK_EDIT_TOOL_NAME,
+    aliases: ['nb_edit', 'edit_notebook'],
+    searchHint: 'jupyter notebook ipynb edit cell modify',
+    inputSchema,
+    async description(input) {
+        const op = input.edit_mode === 'delete' ? 'Delete' : input.edit_mode === 'insert' ? 'Insert' : 'Edit';
+        return `${op} cell in ${path.basename(input.notebook_path)}`;
+    },
+    userFacingName() {
+        return 'NotebookEdit';
+    },
+    isReadOnly() {
+        return false;
+    },
+    isConcurrencySafe() {
+        return false;
+    },
+    async checkPermissions(input, context) {
+        const mode = (context?.permissionContext?.mode ?? context?.mode) ?? 'default';
+        if (mode === 'bypass' || mode === 'acceptEdits')
+            return { behavior: 'allow' };
+        const op = input.edit_mode === 'delete' ? 'Delete cell from' : input.edit_mode === 'insert' ? 'Insert cell into' : 'Edit cell in';
+        return {
+            behavior: 'ask',
+            message: `${op} ${path.basename(input.notebook_path)}?`,
+        };
+    },
+    async call(input, context) {
+        const notebookPath = path.resolve(input.notebook_path);
+        try {
+            if (!existsSync(notebookPath)) {
+                if (input.edit_mode === 'insert') {
+                    // Create a new empty notebook
+                    const newNb = {
+                        cells: [],
+                        metadata: {},
+                        nbformat: 4,
+                        nbformat_minor: 5,
+                    };
+                    const dir = path.dirname(notebookPath);
+                    if (!existsSync(dir))
+                        mkdirSync(dir, { recursive: true });
+                    await writeFile(notebookPath, JSON.stringify(newNb, null, 2), 'utf-8');
+                    return {
+                        data: `Created new notebook: ${path.basename(notebookPath)}`,
+                        content: `Created new notebook: ${path.basename(notebookPath)}. Use notebook_edit with edit_mode="insert" to add cells.`,
+                        title: `NotebookEdit: ${path.basename(notebookPath)}`,
+                    };
+                }
+                return {
+                    data: '',
+                    content: `Notebook not found: ${notebookPath}`,
+                    isError: true,
+                    title: `NotebookEdit: ${path.basename(notebookPath)}`,
+                };
+            }
+            const raw = await readFile(notebookPath, 'utf-8');
+            const nb = JSON.parse(raw);
+            if (!nb.cells || !Array.isArray(nb.cells)) {
+                return {
+                    data: '',
+                    content: `Invalid notebook format in ${path.basename(notebookPath)}`,
+                    isError: true,
+                    title: `NotebookEdit: ${path.basename(notebookPath)}`,
+                };
+            }
+            if (input.edit_mode === 'delete') {
+                if (!input.cell_id) {
+                    return {
+                        data: '',
+                        content: 'cell_id is required for delete mode.',
+                        isError: true,
+                        title: 'NotebookEdit Error',
+                    };
+                }
+                const idx = nb.cells.findIndex((c) => c.id === input.cell_id);
+                if (idx === -1) {
+                    return {
+                        data: '',
+                        content: `Cell not found: ${input.cell_id}`,
+                        isError: true,
+                        title: 'NotebookEdit: cell not found',
+                    };
+                }
+                const removed = nb.cells[idx];
+                nb.cells.splice(idx, 1);
+                await writeFile(notebookPath, JSON.stringify(nb, null, 2), 'utf-8');
+                const cellLabel = removed.cell_type === 'code'
+                    ? `[${removed.execution_count ?? ' '}] ${(removed.source.join('') || '').slice(0, 60)}`
+                    : `[markdown] ${(removed.source.join('') || '').slice(0, 60)}`;
+                return {
+                    data: `Deleted cell ${idx + 1}: ${cellLabel}`,
+                    content: `Deleted cell ${idx + 1} (id: ${input.cell_id}) from ${path.basename(notebookPath)}`,
+                    title: `NotebookEdit: deleted cell`,
+                };
+            }
+            if (input.edit_mode === 'insert') {
+                const cellType = input.cell_type || 'code';
+                const newSource = input.new_source.split('\n').map((l, i, arr) => i < arr.length - 1 ? l + '\n' : l);
+                const newCell = {
+                    cell_type: cellType,
+                    source: newSource.length === 0 ? [''] : newSource,
+                    id: generateCellId(),
+                    execution_count: null,
+                };
+                if (cellType === 'code') {
+                    newCell.outputs = [];
+                }
+                if (input.cell_id) {
+                    const idx = nb.cells.findIndex((c) => c.id === input.cell_id);
+                    if (idx === -1) {
+                        return {
+                            data: '',
+                            content: `Cell not found: ${input.cell_id}. Insert at beginning with no cell_id.`,
+                            isError: true,
+                            title: 'NotebookEdit: cell not found',
+                        };
+                    }
+                    nb.cells.splice(idx + 1, 0, newCell);
+                }
+                else {
+                    nb.cells.unshift(newCell);
+                }
+                await writeFile(notebookPath, JSON.stringify(nb, null, 2), 'utf-8');
+                const pos = input.cell_id
+                    ? `after cell ${nb.cells.findIndex((c) => c.id === input.cell_id)}`
+                    : 'at beginning';
+                return {
+                    data: `Inserted ${cellType} cell ${pos}`,
+                    content: `Inserted new ${cellType} cell (id: ${newCell.id}) ${pos} in ${path.basename(notebookPath)}`,
+                    title: `NotebookEdit: inserted ${cellType} cell`,
+                };
+            }
+            // edit_mode === 'replace'
+            if (!input.cell_id) {
+                return {
+                    data: '',
+                    content: 'cell_id is required for replace mode.',
+                    isError: true,
+                    title: 'NotebookEdit Error',
+                };
+            }
+            const cellIdx = nb.cells.findIndex((c) => c.id === input.cell_id);
+            if (cellIdx === -1) {
+                return {
+                    data: '',
+                    content: `Cell not found: ${input.cell_id}`,
+                    isError: true,
+                    title: 'NotebookEdit: cell not found',
+                };
+            }
+            const oldCell = nb.cells[cellIdx];
+            const newSource = input.new_source.split('\n').map((l, i, arr) => i < arr.length - 1 ? l + '\n' : l);
+            nb.cells[cellIdx] = {
+                ...oldCell,
+                source: newSource.length === 0 ? [''] : newSource,
+                cell_type: input.cell_type || oldCell.cell_type,
+            };
+            // If type changed to/from code, adjust outputs
+            if (input.cell_type && input.cell_type !== oldCell.cell_type) {
+                if (input.cell_type === 'code' && !nb.cells[cellIdx].outputs) {
+                    nb.cells[cellIdx].outputs = [];
+                }
+                else if (input.cell_type === 'markdown') {
+                    delete nb.cells[cellIdx].outputs;
+                    delete nb.cells[cellIdx].execution_count;
+                }
+            }
+            await writeFile(notebookPath, JSON.stringify(nb, null, 2), 'utf-8');
+            const preview = input.new_source.slice(0, 60);
+            return {
+                data: `Replaced cell ${cellIdx + 1} (id: ${input.cell_id})`,
+                content: `Replaced cell ${cellIdx + 1} (id: ${input.cell_id}) in ${path.basename(notebookPath)}: "${preview}"`,
+                title: `NotebookEdit: replaced cell`,
+            };
+        }
+        catch (err) {
+            return {
+                data: '',
+                content: `Failed to edit notebook ${notebookPath}: ${err.message}`,
+                isError: true,
+                title: `NotebookEdit Error: ${path.basename(notebookPath)}`,
+            };
+        }
+    },
+    renderToolUseMessage(input) {
+        const op = input.edit_mode === 'delete' ? 'Deleting cell from' : input.edit_mode === 'insert' ? 'Inserting cell into' : 'Editing cell in';
+        return `${op} ${path.basename(input.notebook_path)}...`;
+    },
+});
+//# sourceMappingURL=NotebookEditTool.js.map

package/dist/tools/NotebookEditTool.js.map

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

package/dist/tools/NotebookReadTool.d.ts

@@ -0,0 +1,19 @@
+/**
+ * NotebookReadTool — Jupyter notebook (.ipynb) reader for Cray Code.
+ * Displays cells with their outputs (code, text, visualizations).
+ * Matches Claude Code's NotebookRead capabilities.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const NOTEBOOK_READ_TOOL_NAME = "notebook_read";
+export declare const NotebookReadTool: ToolDef<z.ZodObject<{
+    file_path: z.ZodString;
+    pages: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    pages?: string | undefined;
+}, {
+    file_path: string;
+    pages?: string | undefined;
+}>, string>;
+//# sourceMappingURL=NotebookReadTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NotebookReadTool.d.ts","sourceRoot":"","sources":["../../src/tools/NotebookReadTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAG3F,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAmFvD,eAAO,MAAM,gBAAgB;;;;;;;;;WAyJ3B,CAAC"}

package/dist/tools/NotebookReadTool.js

@@ -0,0 +1,191 @@
+/**
+ * NotebookReadTool — Jupyter notebook (.ipynb) reader for Cray Code.
+ * Displays cells with their outputs (code, text, visualizations).
+ * Matches Claude Code's NotebookRead capabilities.
+ */
+import { z } from 'zod';
+import { readFile } from 'fs/promises';
+import { existsSync, statSync } from 'fs';
+import * as path from 'path';
+import { buildTool } from '../Tool.js';
+export const NOTEBOOK_READ_TOOL_NAME = 'notebook_read';
+const inputSchema = z.object({
+    file_path: z.string().describe('The absolute path to the .ipynb notebook file to read'),
+    pages: z.string().optional().describe('Cell range to read (e.g., "1-5", "3", "10-20"). 1-indexed.'),
+});
+function parsePageRange(pages, maxCells) {
+    if (pages.includes('-')) {
+        const [a, b] = pages.split('-').map(Number);
+        return { start: Math.max(1, a) - 1, end: Math.min(maxCells, b) };
+    }
+    const n = Number(pages);
+    return { start: n - 1, end: n };
+}
+function formatCellSource(source) {
+    return Array.isArray(source) ? source.join('') : source;
+}
+function formatOutput(output) {
+    const lines = [];
+    lines.push(`  [${output.output_type}]`);
+    if (output.name)
+        lines.push(`  name: ${output.name}`);
+    if (output.text) {
+        const text = Array.isArray(output.text) ? output.text.join('') : output.text;
+        for (const l of String(text).split('\n')) {
+            lines.push(`  ${l}`);
+        }
+    }
+    if (output.data) {
+        for (const [mime, rawVal] of Object.entries(output.data)) {
+            const val = Array.isArray(rawVal) ? rawVal.join('') : String(rawVal);
+            if (mime.startsWith('image/')) {
+                lines.push(`  [${mime}: ${Math.ceil(val.length * 0.75)} bytes]`);
+            }
+            else if (val.length < 5000) {
+                lines.push(`  [${mime}]:`);
+                for (const l of val.split('\n').slice(0, 40)) {
+                    lines.push(`    ${l}`);
+                }
+            }
+            else {
+                lines.push(`  [${mime}: ${val.length} chars]`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+export const NotebookReadTool = buildTool({
+    name: NOTEBOOK_READ_TOOL_NAME,
+    aliases: ['nb_read', 'read_notebook'],
+    searchHint: 'jupyter notebook ipynb read cells',
+    inputSchema,
+    async description(input) {
+        return `Reads notebook: ${path.basename(input.file_path)}`;
+    },
+    userFacingName() {
+        return 'NotebookRead';
+    },
+    isReadOnly() {
+        return true;
+    },
+    isConcurrencySafe() {
+        return true;
+    },
+    async checkPermissions(_input, _context) {
+        return { behavior: 'passthrough' };
+    },
+    async call(input, context) {
+        const filePath = path.resolve(input.file_path);
+        try {
+            if (!existsSync(filePath)) {
+                return {
+                    data: '',
+                    content: `Notebook not found: ${filePath}`,
+                    isError: true,
+                    title: `NotebookRead: ${path.basename(filePath)}`,
+                };
+            }
+            const stats = statSync(filePath);
+            if (stats.size > 50 * 1024 * 1024) {
+                return {
+                    data: '',
+                    content: `Notebook too large (${(stats.size / 1024 / 1024).toFixed(1)}MB). Max 50MB.`,
+                    isError: true,
+                    title: `NotebookRead: ${path.basename(filePath)} (too large)`,
+                };
+            }
+            const raw = await readFile(filePath, 'utf-8');
+            const nb = JSON.parse(raw);
+            if (!nb.cells || !Array.isArray(nb.cells)) {
+                return {
+                    data: '',
+                    content: `Invalid notebook format in ${path.basename(filePath)}`,
+                    isError: true,
+                    title: `NotebookRead: ${path.basename(filePath)} (invalid)`,
+                };
+            }
+            const totalCells = nb.cells.length;
+            let startIdx = 0;
+            let endIdx = totalCells;
+            if (input.pages) {
+                const range = parsePageRange(input.pages, totalCells);
+                startIdx = range.start;
+                endIdx = range.end;
+            }
+            // Limit: max 100 cells per read
+            endIdx = Math.min(endIdx, startIdx + 100);
+            const parts = [];
+            parts.push(`Notebook: ${path.basename(filePath)}`);
+            parts.push(`Format: nbformat v${nb.nbformat}.${nb.nbformat_minor}`);
+            parts.push(`Total cells: ${totalCells}`);
+            if (input.pages)
+                parts.push(`Showing cells: ${startIdx + 1}-${endIdx}`);
+            parts.push('');
+            let charCount = 0;
+            const MAX_OUTPUT = 80_000;
+            for (let i = startIdx; i < endIdx; i++) {
+                const cell = nb.cells[i];
+                const cellNum = i + 1;
+                const source = formatCellSource(cell.source);
+                const execCount = cell.execution_count;
+                const execLabel = execCount != null ? ` [${execCount}]` : '';
+                if (cell.cell_type === 'markdown') {
+                    parts.push(`[${cellNum}] Markdown:${execLabel}`);
+                    for (const l of source.split('\n').slice(0, 30)) {
+                        parts.push(`  ${l}`);
+                    }
+                }
+                else if (cell.cell_type === 'code') {
+                    parts.push(`[${cellNum}] Code:${execLabel}`);
+                    for (const l of source.split('\n').slice(0, 50)) {
+                        parts.push(`  ${l}`);
+                    }
+                    if (cell.outputs && cell.outputs.length > 0) {
+                        parts.push(`  --- outputs (${cell.outputs.length}) ---`);
+                        for (const out of cell.outputs.slice(0, 5)) {
+                            parts.push(formatOutput(out));
+                        }
+                        if (cell.outputs.length > 5) {
+                            parts.push(`  ... ${cell.outputs.length - 5} more outputs`);
+                        }
+                    }
+                }
+                else {
+                    parts.push(`[${cellNum}] Raw:`);
+                    for (const l of source.split('\n').slice(0, 20)) {
+                        parts.push(`  ${l}`);
+                    }
+                }
+                parts.push('');
+                // Truncation check
+                const current = parts.join('\n').length;
+                if (current > MAX_OUTPUT) {
+                    parts.push(`... [truncated at ${MAX_OUTPUT / 1000}KB, ${endIdx - i - 1} cells remaining]`);
+                    break;
+                }
+            }
+            if (endIdx < totalCells) {
+                parts.push(`... [${totalCells - endIdx} more cells available, use pages="${endIdx + 1}-${Math.min(endIdx + 100, totalCells)}" to continue]`);
+            }
+            const result = parts.join('\n');
+            return {
+                data: result,
+                content: result,
+                truncated: endIdx < totalCells || result.length >= MAX_OUTPUT,
+                title: `NotebookRead: ${path.basename(filePath)} (cells ${startIdx + 1}-${endIdx} of ${totalCells})`,
+            };
+        }
+        catch (err) {
+            return {
+                data: '',
+                content: `Error reading notebook ${filePath}: ${err.message}`,
+                isError: true,
+                title: `NotebookRead Error: ${path.basename(filePath)}`,
+            };
+        }
+    },
+    renderToolUseMessage(input) {
+        return `Reading notebook ${path.basename(input.file_path)}...`;
+    },
+});
+//# sourceMappingURL=NotebookReadTool.js.map

package/dist/tools/NotebookReadTool.js.map

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

package/dist/tools/PlanTools.d.ts

@@ -0,0 +1,17 @@
+/**
+ * PlanTools — Enter/Exit plan mode tools for Cray Code.
+ * Plan mode allows the agent to design an approach before implementation.
+ */
+import { z } from 'zod';
+import { type ToolDef } from '../Tool.js';
+export declare const ENTER_PLAN_TOOL_NAME = "enter_plan_mode";
+export declare const EnterPlanModeTool: ToolDef<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, string>;
+export declare const EXIT_PLAN_TOOL_NAME = "exit_plan_mode";
+export declare const ExitPlanModeTool: ToolDef<z.ZodObject<{
+    plan: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    plan: string;
+}, {
+    plan: string;
+}>, string>;
+//# sourceMappingURL=PlanTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlanTools.d.ts","sourceRoot":"","sources":["../../src/tools/PlanTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,KAAK,OAAO,EAAwC,MAAM,YAAY,CAAC;AAE3F,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAItD,eAAO,MAAM,iBAAiB,iEA8B5B,CAAC;AAEH,eAAO,MAAM,mBAAmB,mBAAmB,CAAC;AAMpD,eAAO,MAAM,gBAAgB;;;;;;WA8B3B,CAAC"}