axon-code 2.4.0

package/dist/tools/notebook-write.d.ts

@@ -0,0 +1,23 @@
+/**
+ * NotebookWrite 工具
+ *
+ * 让 agent 管理自己的两个笔记本：
+ * - experience: 跨项目经验
+ * - project: 项目知识
+ */
+import { BaseTool } from './base.js';
+import type { ToolResult, ToolDefinition } from '../types/index.js';
+import { type NotebookType } from '../memory/notebook.js';
+export interface NotebookWriteInput {
+    /** 笔记本类型 */
+    notebook: NotebookType;
+    /** 写入内容（完整替换）。传空字符串表示读取当前内容。 */
+    content: string;
+}
+export declare class NotebookWriteTool extends BaseTool<NotebookWriteInput, ToolResult> {
+    name: string;
+    description: string;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: NotebookWriteInput): Promise<ToolResult>;
+}
+//# sourceMappingURL=notebook-write.d.ts.map

package/dist/tools/notebook-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-write.d.ts","sourceRoot":"","sources":["../../src/tools/notebook-write.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG9E,MAAM,WAAW,kBAAkB;IACjC,YAAY;IACZ,QAAQ,EAAE,YAAY,CAAC;IACvB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,QAAQ,CAAC,kBAAkB,EAAE,UAAU,CAAC;IAC7E,IAAI,SAAmB;IACvB,WAAW,SA8B+C;IAE1D,cAAc,IAAI,cAAc,CAAC,aAAa,CAAC;IAkBzC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;CAgC9D"}

package/dist/tools/notebook-write.js

@@ -0,0 +1,86 @@
+/**
+ * NotebookWrite 工具
+ *
+ * 让 agent 管理自己的两个笔记本：
+ * - experience: 跨项目经验
+ * - project: 项目知识
+ */
+import { BaseTool } from './base.js';
+import { getNotebookManager } from '../memory/notebook.js';
+export class NotebookWriteTool extends BaseTool {
+    name = 'NotebookWrite';
+    description = `Manage your personal notebooks to persist memories and work experience across conversations.
+
+## MANDATORY AUTO-TRIGGER RULES
+You MUST call this tool IMMEDIATELY (in the same response, before any text reply) when:
+1. User shares personal info (name, role, preferences, contact) → write to profile
+2. User explicitly asks you to remember something → write to experience or project
+3. You discover a project gotcha not covered in AXON.md → write to project
+
+Saying "I'll remember" without calling this tool is a LIE — conversation memory is ephemeral. Only notebook writes persist.
+
+## Three Notebooks
+- **profile**: Stable personal info — name, role, contact, preferences, background. (~2K tokens max)
+- **experience**: Cross-project knowledge — work patterns, lessons learned, anti-patterns. (~4K tokens max)
+- **project**: Things YOU discovered about this project that are NOT in AXON.md — gotchas, hidden dependencies, operational tips. (~8K tokens max)
+
+## IMPORTANT: project notebook vs AXON.md
+AXON.md contains the user's project instructions and documentation. Do NOT duplicate its content into project notebook.
+Only write things you discovered during work that AXON.md does not cover:
+- "After changing types.ts, also update attachments.ts"
+- "session.sessionId is a getter not a method, don't use getId()"
+- "compress() has a logic bug, CORE branch is unreachable"
+
+## Guidelines
+- Write in markdown, keep it concise
+- Add dates for time-sensitive info: "Prefers React (2026-02)"
+- Record patterns, not volatile facts (facts go stale, patterns don't)
+- When new info contradicts your notes, update the notes
+- Stay within token budgets — prune stale content when needed
+
+## Reading
+Pass empty string as content to read the current notebook.`;
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                notebook: {
+                    type: 'string',
+                    enum: ['profile', 'experience', 'project'],
+                    description: 'Which notebook to read/write',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Full content to write (replaces existing). Empty string to read.',
+                },
+            },
+            required: ['notebook', 'content'],
+        };
+    }
+    async execute(input) {
+        const manager = getNotebookManager();
+        if (!manager) {
+            return this.error('NotebookManager not initialized.');
+        }
+        const { notebook, content } = input;
+        // 验证笔记本类型
+        if (!['profile', 'experience', 'project'].includes(notebook)) {
+            return this.error(`Invalid notebook type: ${notebook}. Options: profile, experience, project`);
+        }
+        // 读取模式
+        if (!content || content.trim() === '') {
+            const existing = manager.read(notebook);
+            if (!existing.trim()) {
+                return this.success(`[${notebook}] Notebook is empty.`);
+            }
+            return this.success(existing);
+        }
+        // 写入模式
+        const result = manager.write(notebook, content);
+        if (!result.success) {
+            return this.error(result.error);
+        }
+        return this.success(`\u2713 Updated ${notebook} notebook (${result.tokens} tokens)\nPath: ${result.path}`);
+    }
+}
+//# sourceMappingURL=notebook-write.js.map

package/dist/tools/notebook-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-write.js","sourceRoot":"","sources":["../../src/tools/notebook-write.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,kBAAkB,EAAqB,MAAM,uBAAuB,CAAC;AAU9E,MAAM,OAAO,iBAAkB,SAAQ,QAAwC;IAC7E,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DA8B2C,CAAC;IAE1D,cAAc;QACZ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC;oBAC1C,WAAW,EAAE,8BAA8B;iBAC5C;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kEAAkE;iBAChF;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAyB;QACrC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;QAEpC,UAAU;QACV,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,0BAA0B,QAAQ,yCAAyC,CAAC,CAAC;QACjG,CAAC;QAED,OAAO;QACP,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,sBAAsB,CAAC,CAAC;YAC1D,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QAED,OAAO;QACP,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAM,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CACjB,kBAAkB,QAAQ,cAAc,MAAM,CAAC,MAAM,mBAAmB,MAAM,CAAC,IAAI,EAAE,CACtF,CAAC;IACJ,CAAC;CACF"}

package/dist/tools/notebook.d.ts

@@ -0,0 +1,46 @@
+/**
+ * NotebookEdit 工具
+ * 编辑 Jupyter Notebook 单元格
+ *
+ * 功能特性：
+ * - 支持 replace, insert, delete 三种编辑模式
+ * - 自动清理单元格输出（code 类型）
+ * - Jupyter notebook 格式验证
+ * - 增强的错误处理和路径验证
+ * - 保留单元格元数据
+ */
+import { BaseTool } from './base.js';
+import type { NotebookEditInput, ToolResult, ToolDefinition } from '../types/index.js';
+export declare class NotebookEditTool extends BaseTool<NotebookEditInput, ToolResult> {
+    name: string;
+    shouldDefer: boolean;
+    searchHint: string;
+    description: string;
+    /**
+     * 获取详细的工具提示词
+     * 官方 Axon 的 prompt 方法实现
+     */
+    prompt(): Promise<string>;
+    getInputSchema(): ToolDefinition['inputSchema'];
+    execute(input: NotebookEditInput): Promise<ToolResult>;
+    /**
+     * 验证 Jupyter notebook 格式
+     */
+    private validateNotebookFormat;
+    /**
+     * 查找单元格索引
+     * 支持按 ID 或数字索引查找
+     */
+    private findCellIndex;
+    /**
+     * 清除单元格输出
+     * 仅对 code 类型的单元格生效
+     */
+    private clearCellOutputs;
+    /**
+     * 生成唯一的单元格 ID
+     * 格式：8位随机字母数字字符串
+     */
+    private generateCellId;
+}
+//# sourceMappingURL=notebook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notebook.d.ts","sourceRoot":"","sources":["../../src/tools/notebook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAoBvF,qBAAa,gBAAiB,SAAQ,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CAAC;IAC3E,IAAI,SAAkB;IACtB,WAAW,UAAQ;IACnB,UAAU,SAAyE;IACnF,WAAW,SAAoE;IAE/E;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAI/B,cAAc,IAAI,cAAc,CAAC,aAAa,CAAC;IA+BzC,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAgN5D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4D9B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAwBrB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAQvB"}

package/dist/tools/notebook.js

@@ -0,0 +1,335 @@
+/**
+ * NotebookEdit 工具
+ * 编辑 Jupyter Notebook 单元格
+ *
+ * 功能特性：
+ * - 支持 replace, insert, delete 三种编辑模式
+ * - 自动清理单元格输出（code 类型）
+ * - Jupyter notebook 格式验证
+ * - 增强的错误处理和路径验证
+ * - 保留单元格元数据
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { BaseTool } from './base.js';
+import { t } from '../i18n/index.js';
+import { fromMsysPath } from '../utils/platform.js';
+export class NotebookEditTool extends BaseTool {
+    name = 'NotebookEdit';
+    shouldDefer = true;
+    searchHint = 'Jupyter notebook, edit ipynb cell, modify notebook code or markdown';
+    description = 'Replace the contents of a specific cell in a Jupyter notebook.';
+    /**
+     * 获取详细的工具提示词
+     * 官方 Axon 的 prompt 方法实现
+     */
+    async prompt() {
+        return 'Completely replaces the contents of a specific cell in a Jupyter notebook (.ipynb file) with new source. Jupyter notebooks are interactive documents that combine code, text, and visualizations, commonly used for data analysis and scientific computing. The notebook_path parameter must be an absolute path, not a relative path. The cell_number is 0-indexed. Use edit_mode=insert to add a new cell at the index specified by cell_number. Use edit_mode=delete to delete the cell at the index specified by cell_number.';
+    }
+    getInputSchema() {
+        return {
+            type: 'object',
+            properties: {
+                notebook_path: {
+                    type: 'string',
+                    description: 'The absolute path to the Jupyter notebook file to edit (must be absolute, not relative)',
+                },
+                cell_id: {
+                    type: 'string',
+                    description: 'The ID of the cell to edit. When inserting a new cell, the new cell will be inserted after the cell with this ID, or at the beginning if not specified.',
+                },
+                new_source: {
+                    type: 'string',
+                    description: 'The new source for the cell',
+                },
+                cell_type: {
+                    type: 'string',
+                    enum: ['code', 'markdown'],
+                    description: 'The type of the cell (code or markdown). If not specified, it defaults to the current cell type. If using edit_mode=insert, this is required.',
+                },
+                edit_mode: {
+                    type: 'string',
+                    enum: ['replace', 'insert', 'delete'],
+                    description: 'The type of edit to make (replace, insert, delete). Defaults to replace.',
+                },
+            },
+            required: ['notebook_path', 'new_source'],
+        };
+    }
+    async execute(input) {
+        const { notebook_path: rawNotebookPath, cell_id, new_source, cell_type, edit_mode = 'replace' } = input;
+        const notebook_path = fromMsysPath(rawNotebookPath);
+        try {
+            // 验证路径是否为绝对路径
+            if (!path.isAbsolute(notebook_path)) {
+                return {
+                    success: false,
+                    error: `notebook_path must be an absolute path, got: ${notebook_path}`,
+                };
+            }
+            // 检查文件是否存在
+            if (!fs.existsSync(notebook_path)) {
+                return {
+                    success: false,
+                    error: t('notebook.notFound', { path: notebook_path }),
+                };
+            }
+            // 检查是否是文件（不是目录）
+            const stats = fs.statSync(notebook_path);
+            if (!stats.isFile()) {
+                return {
+                    success: false,
+                    error: t('notebook.notFile', { path: notebook_path }),
+                };
+            }
+            // 检查文件扩展名
+            if (!notebook_path.endsWith('.ipynb')) {
+                return {
+                    success: false,
+                    error: t('notebook.invalidExt', { ext: path.extname(notebook_path) }),
+                };
+            }
+            // 读取并解析 notebook
+            const content = fs.readFileSync(notebook_path, 'utf-8');
+            let notebook;
+            try {
+                notebook = JSON.parse(content);
+            }
+            catch (parseError) {
+                return {
+                    success: false,
+                    error: t('notebook.parseError', { error: parseError instanceof Error ? parseError.message : String(parseError) }),
+                };
+            }
+            // 验证 notebook 格式
+            const validationError = this.validateNotebookFormat(notebook);
+            if (validationError) {
+                return { success: false, error: validationError };
+            }
+            // 找到目标单元格索引
+            // 官方行为：未指定 cell_id 时，cellIndex 默认为 0
+            let cellIndex;
+            if (!cell_id) {
+                cellIndex = 0;
+            }
+            else {
+                cellIndex = this.findCellIndex(notebook.cells, cell_id);
+                // 如果按 ID 找不到，对于非 insert 模式报错
+                if (cellIndex === -1) {
+                    if (edit_mode !== 'insert') {
+                        return {
+                            success: false,
+                            error: t('notebook.cellNotFoundById', { id: cell_id, count: String(notebook.cells.length) }),
+                        };
+                    }
+                    // insert 模式下找不到 cell_id，也应该报错（与官方行为一致）
+                    return {
+                        success: false,
+                        error: t('notebook.cellNotFound', { id: cell_id }),
+                    };
+                }
+                // insert 模式：在找到的单元格之后插入
+                if (edit_mode === 'insert') {
+                    cellIndex = cellIndex + 1;
+                }
+            }
+            // delete 模式必须指定 cell_id
+            if (edit_mode === 'delete' && !cell_id) {
+                return {
+                    success: false,
+                    error: t('notebook.cellIdRequired'),
+                };
+            }
+            // 执行编辑操作
+            let resultMessage = '';
+            let actualEditMode = edit_mode;
+            let generatedCellId;
+            // 特殊处理：如果 replace 的索引超出范围，自动转为 insert
+            if (actualEditMode === 'replace' && cellIndex >= notebook.cells.length) {
+                actualEditMode = 'insert';
+                if (!cell_type) {
+                    // 如果没有指定 cell_type，默认为 code
+                    input.cell_type = 'code';
+                }
+            }
+            switch (actualEditMode) {
+                case 'replace': {
+                    if (cellIndex < 0 || cellIndex >= notebook.cells.length) {
+                        return {
+                            success: false,
+                            error: t('notebook.cellOutOfRange', { index: String(cellIndex), count: String(notebook.cells.length) }),
+                        };
+                    }
+                    const cell = notebook.cells[cellIndex];
+                    const oldType = cell.cell_type;
+                    // 更新源代码（官方使用字符串，而非数组）
+                    cell.source = new_source;
+                    // 如果指定了 cell_type，更新类型
+                    if (cell_type) {
+                        cell.cell_type = cell_type;
+                    }
+                    // 清除输出（对于 code 单元格）
+                    this.clearCellOutputs(cell);
+                    // 保留原有的 cell ID（如果存在）
+                    generatedCellId = cell.id;
+                    resultMessage = `Replaced cell ${cellIndex}${oldType !== cell.cell_type ? ` (changed type from ${oldType} to ${cell.cell_type})` : ''}`;
+                    break;
+                }
+                case 'insert': {
+                    const finalCellType = cell_type || 'code';
+                    const newCell = {
+                        cell_type: finalCellType,
+                        source: new_source,
+                        metadata: {},
+                    };
+                    // 初始化 code 单元格的输出
+                    if (finalCellType === 'code') {
+                        newCell.outputs = [];
+                        newCell.execution_count = null;
+                    }
+                    // 只在 nbformat 4.5+ 生成 ID
+                    if (notebook.nbformat > 4 ||
+                        (notebook.nbformat === 4 && notebook.nbformat_minor >= 5)) {
+                        newCell.id = this.generateCellId();
+                        generatedCellId = newCell.id;
+                    }
+                    // 确定插入位置
+                    // cellIndex 现在总是有效值（>= 0），因为在前面已经验证过了
+                    notebook.cells.splice(cellIndex, 0, newCell);
+                    resultMessage = `Inserted new ${finalCellType} cell at position ${cellIndex}`;
+                    break;
+                }
+                case 'delete': {
+                    if (cellIndex < 0 || cellIndex >= notebook.cells.length) {
+                        return {
+                            success: false,
+                            error: t('notebook.cellOutOfRange', { index: String(cellIndex), count: String(notebook.cells.length) }),
+                        };
+                    }
+                    const deletedCell = notebook.cells[cellIndex];
+                    notebook.cells.splice(cellIndex, 1);
+                    resultMessage = `Deleted ${deletedCell.cell_type} cell at position ${cellIndex} (${notebook.cells.length} cells remaining)`;
+                    break;
+                }
+                default:
+                    return {
+                        success: false,
+                        error: t('notebook.invalidEditMode', { mode: edit_mode }),
+                    };
+            }
+            // 写回文件（使用美化的 JSON 格式，与官方一致：缩进 1 空格）
+            fs.writeFileSync(notebook_path, JSON.stringify(notebook, null, 1) + '\n', 'utf-8');
+            return {
+                success: true,
+                output: `${resultMessage} in ${path.basename(notebook_path)}`,
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                error: t('notebook.editError', { error: errorMessage }),
+            };
+        }
+    }
+    /**
+     * 验证 Jupyter notebook 格式
+     */
+    validateNotebookFormat(notebook) {
+        // 检查必需字段
+        if (!notebook.cells || !Array.isArray(notebook.cells)) {
+            return t('notebook.invalidStructure', { detail: 'missing or invalid cells array' });
+        }
+        if (typeof notebook.nbformat !== 'number') {
+            return t('notebook.invalidStructure', { detail: 'missing or invalid nbformat' });
+        }
+        if (typeof notebook.nbformat_minor !== 'number') {
+            return t('notebook.invalidStructure', { detail: 'missing or invalid nbformat_minor' });
+        }
+        // 验证 nbformat 版本（支持 v4.x）
+        if (notebook.nbformat < 4) {
+            return `Unsupported notebook format version: ${notebook.nbformat}.${notebook.nbformat_minor} (only v4.x is supported)`;
+        }
+        if (notebook.nbformat > 4) {
+            // 警告但不阻止（未来版本可能兼容）
+            console.warn(`Warning: Notebook format v${notebook.nbformat}.${notebook.nbformat_minor} is newer than expected (v4.x)`);
+        }
+        // 验证 metadata
+        if (!notebook.metadata || typeof notebook.metadata !== 'object') {
+            return t('notebook.invalidStructure', { detail: 'missing or invalid metadata' });
+        }
+        // 验证每个单元格的基本结构
+        for (let i = 0; i < notebook.cells.length; i++) {
+            const cell = notebook.cells[i];
+            if (!cell.cell_type || typeof cell.cell_type !== 'string') {
+                return `Invalid cell at index ${i}: missing or invalid cell_type`;
+            }
+            if (!['code', 'markdown', 'raw'].includes(cell.cell_type)) {
+                return `Invalid cell at index ${i}: unknown cell_type '${cell.cell_type}'`;
+            }
+            if (cell.source === undefined) {
+                return `Invalid cell at index ${i}: missing source`;
+            }
+            // code 单元格必须有 outputs 和 execution_count
+            if (cell.cell_type === 'code') {
+                if (!Array.isArray(cell.outputs)) {
+                    // 自动修复：添加空输出数组
+                    cell.outputs = [];
+                }
+                if (cell.execution_count === undefined) {
+                    cell.execution_count = null;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * 查找单元格索引
+     * 支持按 ID 或数字索引查找
+     */
+    findCellIndex(cells, cellId) {
+        // 首先尝试按 ID 精确匹配
+        const indexById = cells.findIndex((c) => c.id === cellId);
+        if (indexById !== -1) {
+            return indexById;
+        }
+        // 尝试解析为数字索引
+        const numIndex = parseInt(cellId, 10);
+        if (!isNaN(numIndex)) {
+            // 支持负数索引（从末尾开始）
+            if (numIndex < 0) {
+                const positiveIndex = cells.length + numIndex;
+                if (positiveIndex >= 0 && positiveIndex < cells.length) {
+                    return positiveIndex;
+                }
+            }
+            else if (numIndex >= 0 && numIndex < cells.length) {
+                return numIndex;
+            }
+        }
+        return -1;
+    }
+    /**
+     * 清除单元格输出
+     * 仅对 code 类型的单元格生效
+     */
+    clearCellOutputs(cell) {
+        if (cell.cell_type === 'code') {
+            cell.outputs = [];
+            cell.execution_count = null;
+        }
+    }
+    /**
+     * 生成唯一的单元格 ID
+     * 格式：8位随机字母数字字符串
+     */
+    generateCellId() {
+        const chars = 'abcdefghijklmnopqrstuvwxyz0123456789';
+        let id = '';
+        for (let i = 0; i < 8; i++) {
+            id += chars[Math.floor(Math.random() * chars.length)];
+        }
+        return id;
+    }
+}
+//# sourceMappingURL=notebook.js.map

package/dist/tools/notebook.js.map

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

package/dist/tools/output-persistence.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 统一输出持久化模块
+ * 用于处理工具输出过大时的磁盘持久化
+ *
+ * 对应官方 2.1.2 版本的输出管理机制
+ */
+/**
+ * 输出持久化选项
+ */
+export interface OutputPersistenceOptions {
+    /** 最大输出长度（字节），超过则持久化。默认 30000 */
+    maxLength?: number;
+    /** 工具名称，用于文件命名 */
+    toolName: string;
+    /** 可选的时间戳 */
+    timestamp?: string;
+    /** 可选的会话 ID */
+    sessionId?: string;
+    /** 是否保留头尾内容（默认 true） */
+    keepHeadTail?: boolean;
+    /** 保留头部字符数（默认 1000） */
+    headChars?: number;
+    /** 保留尾部字符数（默认 1000） */
+    tailChars?: number;
+}
+/**
+ * 持久化结果
+ */
+export interface PersistenceResult {
+    /** 返回给 Claude 的内容（可能是截断的） */
+    content: string;
+    /** 如果持久化了，这是文件路径 */
+    filePath?: string;
+    /** 原始内容的长度 */
+    originalLength: number;
+    /** 是否被持久化 */
+    persisted: boolean;
+}
+/**
+ * 获取输出目录路径
+ */
+export declare function getOutputDir(): string;
+/**
+ * 清理过期的输出文件
+ * 删除超过 MAX_FILE_AGE_DAYS 天的文件
+ */
+export declare function cleanupOldOutputFiles(): number;
+/**
+ * 持久化大输出
+ *
+ * @param output 原始输出内容
+ * @param options 持久化选项
+ * @returns 持久化结果，包含返回内容和文件路径
+ */
+export declare function persistLargeOutput(output: string, options: OutputPersistenceOptions): Promise<PersistenceResult>;
+/**
+ * 同步版本的持久化（用于无法使用 async 的场景）
+ */
+export declare function persistLargeOutputSync(output: string, options: OutputPersistenceOptions): PersistenceResult;
+/**
+ * 读取已持久化的输出文件
+ */
+export declare function readPersistedOutput(filePath: string): Promise<string>;
+/**
+ * 获取输出目录的统计信息
+ */
+export declare function getOutputDirStats(): {
+    totalFiles: number;
+    totalSize: number;
+    oldestFile: string | null;
+    newestFile: string | null;
+};
+//# sourceMappingURL=output-persistence.d.ts.map

package/dist/tools/output-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-persistence.d.ts","sourceRoot":"","sources":["../../src/tools/output-persistence.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AASD;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAUrC;AAaD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAsC9C;AAoCD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC,CAmD5B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,iBAAiB,CAoDnB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAiDA"}