@lingxiao-office/sdk 1.0.0

package/dist/tools/implementations/LspTool.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LSP Tool — provides code intelligence operations via Language Server Protocol.
+ *
+ * Experimental: only registered when LINGXIAO_EXPERIMENTAL_LSP=1
+ */
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class LspTool extends Tool {
+    readonly name = "lsp";
+    readonly description = "Code intelligence via Language Server Protocol. Supports go-to-definition, find-references, hover, document symbols, and workspace symbol search.";
+    readonly parameters: z.ZodObject<{
+        operation: z.ZodEnum<{
+            goToDefinition: "goToDefinition";
+            findReferences: "findReferences";
+            hover: "hover";
+            documentSymbol: "documentSymbol";
+            workspaceSymbol: "workspaceSymbol";
+        }>;
+        filePath: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+        character: z.ZodOptional<z.ZodNumber>;
+        query: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default LspTool;
+//# sourceMappingURL=LspTool.d.ts.map

package/dist/tools/implementations/LspTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LspTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/LspTool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA0BrE,qBAAa,OAAQ,SAAQ,IAAI;IAC/B,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,uJAAuJ;IAC3K,QAAQ,CAAC,UAAU;;;;;;;;;;;;sBAAiB;IAE9B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAoFzE;AAED,eAAe,OAAO,CAAC"}

package/dist/tools/implementations/LspTool.js

@@ -0,0 +1,111 @@
+/**
+ * LSP Tool — provides code intelligence operations via Language Server Protocol.
+ *
+ * Experimental: only registered when LINGXIAO_EXPERIMENTAL_LSP=1
+ */
+import { z } from 'zod';
+import { resolve } from 'node:path';
+import { Tool } from '../Tool.js';
+import { detectLanguage, formatLocation, formatSymbol, getOrCreateConnection, } from '../LspClient.js';
+const LspOperationEnum = z.enum([
+    'goToDefinition',
+    'findReferences',
+    'hover',
+    'documentSymbol',
+    'workspaceSymbol',
+]);
+const LspToolSchema = z.object({
+    operation: LspOperationEnum.describe('The LSP operation to perform'),
+    filePath: z.string().describe('Absolute or relative file path to operate on'),
+    line: z.number().int().min(1).optional().describe('Line number (1-based). Required for goToDefinition, findReferences, hover'),
+    character: z.number().int().min(1).optional().describe('Character offset (1-based). Required for goToDefinition, findReferences, hover'),
+    query: z.string().optional().describe('Search query for workspaceSymbol operation'),
+});
+export class LspTool extends Tool {
+    name = 'lsp';
+    description = 'Code intelligence via Language Server Protocol. Supports go-to-definition, find-references, hover, document symbols, and workspace symbol search.';
+    parameters = LspToolSchema;
+    async execute(args, context) {
+        const params = args;
+        const workspace = context?.workspace || process.cwd();
+        const filePath = resolve(workspace, params.filePath);
+        // Validate positional args for operations that need them
+        const positionalOps = ['goToDefinition', 'findReferences', 'hover'];
+        if (positionalOps.includes(params.operation)) {
+            if (params.line == null || params.character == null) {
+                return {
+                    success: false,
+                    data: null,
+                    error: `Operation "${params.operation}" requires both "line" and "character" parameters (1-based).`,
+                };
+            }
+        }
+        if (params.operation === 'workspaceSymbol' && !params.query) {
+            return {
+                success: false,
+                data: null,
+                error: 'Operation "workspaceSymbol" requires a "query" parameter.',
+            };
+        }
+        const language = detectLanguage(filePath);
+        if (!language) {
+            return {
+                success: false,
+                data: null,
+                error: `Could not detect language for file: ${params.filePath}. Supported extensions: ts, tsx, js, jsx, py, rs, go`,
+            };
+        }
+        try {
+            const conn = await getOrCreateConnection(language, workspace);
+            switch (params.operation) {
+                case 'goToDefinition': {
+                    const locations = await conn.goToDefinition(filePath, params.line, params.character);
+                    if (locations.length === 0) {
+                        return { success: true, data: 'No definition found at the specified position.' };
+                    }
+                    return { success: true, data: locations.map(formatLocation).join('\n') };
+                }
+                case 'findReferences': {
+                    const refs = await conn.findReferences(filePath, params.line, params.character);
+                    if (refs.length === 0) {
+                        return { success: true, data: 'No references found at the specified position.' };
+                    }
+                    return { success: true, data: refs.map(formatLocation).join('\n') };
+                }
+                case 'hover': {
+                    const hover = await conn.hover(filePath, params.line, params.character);
+                    if (!hover) {
+                        return { success: true, data: 'No hover information available at the specified position.' };
+                    }
+                    return { success: true, data: hover.contents };
+                }
+                case 'documentSymbol': {
+                    const symbols = await conn.documentSymbol(filePath);
+                    if (symbols.length === 0) {
+                        return { success: true, data: 'No symbols found in this document.' };
+                    }
+                    return { success: true, data: symbols.map(formatSymbol).join('\n') };
+                }
+                case 'workspaceSymbol': {
+                    const symbols = await conn.workspaceSymbol(params.query);
+                    if (symbols.length === 0) {
+                        return { success: true, data: `No symbols matching "${params.query}" found in workspace.` };
+                    }
+                    return { success: true, data: symbols.map(formatSymbol).join('\n') };
+                }
+                default:
+                    return { success: false, data: null, error: `Unknown operation: ${params.operation}` };
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                data: null,
+                error: `LSP operation failed: ${msg}. Ensure the language server is installed and available on PATH.`,
+            };
+        }
+    }
+}
+export default LspTool;
+//# sourceMappingURL=LspTool.js.map

package/dist/tools/implementations/LspTool.js.map

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

package/dist/tools/implementations/McpTool.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class McpTool extends Tool {
+    readonly name = "mcp";
+    readonly description = "\u7EDF\u4E00 MCP \u5165\u53E3\uFF1A\u5217\u51FA\u5DF2\u5B89\u88C5 MCP servers\uFF0C\u53D1\u73B0 tools/resources/prompts/resource templates\uFF0C\u8C03\u7528 MCP tools\uFF0C\u8BFB\u53D6 resources/prompts\uFF0C\u5E76\u67E5\u770B server capability snapshot\u3002MCP server \u901A\u8FC7\u63D2\u4EF6\u5E02\u573A\u6216 settings.mcp.servers \u5B89\u88C5\u3002";
+    readonly parameters: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"list_servers">;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"list_tools">;
+        server: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"call_tool">;
+        server: z.ZodString;
+        tool: z.ZodString;
+        arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"list_resources">;
+        server: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"read_resource">;
+        server: z.ZodString;
+        uri: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"list_prompts">;
+        server: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"get_prompt">;
+        server: z.ZodString;
+        name: z.ZodString;
+        arguments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"list_resource_templates">;
+        server: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        action: z.ZodLiteral<"capability_snapshot">;
+        server: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "action">;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default McpTool;
+//# sourceMappingURL=McpTool.d.ts.map

package/dist/tools/implementations/McpTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/McpTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAmB,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAiEtF,qBAAa,OAAQ,SAAQ,IAAI;IAC/B,QAAQ,CAAC,IAAI,SAAS;IACtB,QAAQ,CAAC,WAAW,sWAA4L;IAChN,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCAAa;IAE1B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiCzE;AAED,eAAe,OAAO,CAAC"}

package/dist/tools/implementations/McpTool.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+import { Tool, createToolError } from '../Tool.js';
+import { getRuntimeMcpClient } from '../../core/McpClient.js';
+import { syncPluginMcpContributions } from '../../core/plugins/PluginStore.js';
+const McpSchema = z.discriminatedUnion('action', [
+    z.object({
+        action: z.literal('list_servers'),
+    }).strict(),
+    z.object({
+        action: z.literal('list_tools'),
+        server: z.string().optional().describe('可选 MCP server id 或 registry name；省略时列出全部已启用 server 的 tools'),
+    }).strict(),
+    z.object({
+        action: z.literal('call_tool'),
+        server: z.string().describe('MCP server id 或 registry name'),
+        tool: z.string().describe('MCP server 暴露的 tool name'),
+        arguments: z.record(z.string(), z.unknown()).default({}).describe('传给 MCP tool 的 JSON 参数'),
+    }).strict(),
+    z.object({
+        action: z.literal('list_resources'),
+        server: z.string().optional().describe('可选 MCP server id 或 registry name；省略时列出全部已启用 server 的 resources'),
+    }).strict(),
+    z.object({
+        action: z.literal('read_resource'),
+        server: z.string().describe('MCP server id 或 registry name'),
+        uri: z.string().describe('MCP resource URI'),
+    }).strict(),
+    z.object({
+        action: z.literal('list_prompts'),
+        server: z.string().optional().describe('可选 MCP server id 或 registry name；省略时列出全部已启用 server 的 prompts'),
+    }).strict(),
+    z.object({
+        action: z.literal('get_prompt'),
+        server: z.string().describe('MCP server id 或 registry name'),
+        name: z.string().describe('MCP prompt name'),
+        arguments: z.record(z.string(), z.unknown()).default({}).describe('传给 MCP prompt 的 JSON 参数'),
+    }).strict(),
+    z.object({
+        action: z.literal('list_resource_templates'),
+        server: z.string().optional().describe('可选 MCP server id 或 registry name；省略时列出全部已启用 server 的 resource templates'),
+    }).strict(),
+    z.object({
+        action: z.literal('capability_snapshot'),
+        server: z.string().optional().describe('可选 MCP server id 或 registry name；省略时返回全部已启用 server 的 initialize capability snapshot'),
+    }).strict(),
+]);
+function getClient(context) {
+    const injected = context?.mcpClient || context?.mcp;
+    if (injected && typeof injected === 'object') {
+        return injected;
+    }
+    return getRuntimeMcpClient();
+}
+function formatError(error) {
+    return createToolError({
+        code: 'MCP_REQUEST_FAILED',
+        message: error instanceof Error ? error.message : String(error),
+        retryable: true,
+        cause: error instanceof Error ? error.stack || error.message : String(error),
+        fix: '先用 mcp(action="list_servers") 确认 server 已安装并启用，再用 list_tools/list_resources/list_prompts/list_resource_templates 查看真实能力和 schema。',
+    });
+}
+export class McpTool extends Tool {
+    name = 'mcp';
+    description = '统一 MCP 入口：列出已安装 MCP servers，发现 tools/resources/prompts/resource templates，调用 MCP tools，读取 resources/prompts，并查看 server capability snapshot。MCP server 通过插件市场或 settings.mcp.servers 安装。';
+    parameters = McpSchema;
+    async execute(args, context) {
+        const params = args;
+        if (!context?.mcpClient && !context?.mcp) {
+            syncPluginMcpContributions(context?.workspace);
+        }
+        const client = getClient(context);
+        try {
+            switch (params.action) {
+                case 'list_servers':
+                    return { success: true, data: client.listServers() };
+                case 'list_tools':
+                    return { success: true, data: await client.listTools(params.server) };
+                case 'call_tool':
+                    return { success: true, data: await client.callTool(params.server, params.tool, params.arguments) };
+                case 'list_resources':
+                    return { success: true, data: await client.listResources(params.server) };
+                case 'read_resource':
+                    return { success: true, data: await client.readResource(params.server, params.uri) };
+                case 'list_prompts':
+                    return { success: true, data: await client.listPrompts(params.server) };
+                case 'get_prompt':
+                    return { success: true, data: await client.getPrompt(params.server, params.name, params.arguments) };
+                case 'list_resource_templates':
+                    return { success: true, data: await client.listResourceTemplates(params.server) };
+                case 'capability_snapshot':
+                    return { success: true, data: await client.getCapabilitySnapshot(params.server) };
+                default:
+                    return { success: false, data: null, error: 'Unknown MCP action' };
+            }
+        }
+        catch (error) {
+            return formatError(error);
+        }
+    }
+}
+export default McpTool;
+//# sourceMappingURL=McpTool.js.map

package/dist/tools/implementations/McpTool.js.map

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

package/dist/tools/implementations/MemoryTool.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class MemoryTool extends Tool {
+    readonly name = "memory";
+    readonly description = "\u8F7B\u91CF\u6301\u4E45\u8BB0\u5FC6\u7CFB\u7EDF \u2014 \u4FDD\u5B58\u548C\u68C0\u7D22\u9879\u76EE\u7EA7/\u7528\u6237\u7EA7\u957F\u671F\u8BB0\u5FC6\u3002";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            search: "search";
+            delete: "delete";
+            list: "list";
+            save: "save";
+            load: "load";
+            rebuild: "rebuild";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<{
+            project: "project";
+            user: "user";
+            feedback: "feedback";
+            reference: "reference";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            project: "project";
+            user: "user";
+        }>>;
+        maxResults: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+/**
+ * P0-1c: memory_read — read-only memory tool (load/search/list).
+ * Tier=read, so read-restricted roles (explore, research, review, planner) can use it.
+ */
+export declare class MemoryReadTool extends Tool {
+    readonly name = "memory_read";
+    readonly description = "\u53EA\u8BFB\u8BB0\u5FC6\u68C0\u7D22 \u2014 \u8BFB\u53D6\u3001\u641C\u7D22\u548C\u5217\u51FA\u957F\u671F\u8BB0\u5FC6\u3002\u4E0D\u80FD\u4FEE\u6539\u8BB0\u5FC6\u3002";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            search: "search";
+            list: "list";
+            load: "load";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        query: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            project: "project";
+            user: "user";
+        }>>;
+        maxResults: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    private readonly delegate;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+/**
+ * P0-1c: memory_write — write memory tool (save/delete/rebuild).
+ * Tier=write, so only full-tier roles (coding, verify, frontend, backend, fullstack, etc.) can use it.
+ */
+export declare class MemoryWriteTool extends Tool {
+    readonly name = "memory_write";
+    readonly description = "\u5199\u5165\u8BB0\u5FC6 \u2014 \u4FDD\u5B58\u3001\u5220\u9664\u548C\u91CD\u5EFA\u957F\u671F\u8BB0\u5FC6\u7D22\u5F15\u3002";
+    readonly parameters: z.ZodObject<{
+        action: z.ZodEnum<{
+            delete: "delete";
+            save: "save";
+            rebuild: "rebuild";
+        }>;
+        name: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<{
+            project: "project";
+            user: "user";
+            feedback: "feedback";
+            reference: "reference";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodEnum<{
+            all: "all";
+            project: "project";
+            user: "user";
+        }>>;
+    }, z.core.$strip>;
+    private readonly delegate;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=MemoryTool.d.ts.map

package/dist/tools/implementations/MemoryTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/MemoryTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAuDrE,qBAAa,UAAW,SAAQ,IAAI;IAClC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,+JAAkC;IACtD,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;sBAAgB;IAE7B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAiGzE;AAGD;;;GAGG;AACH,qBAAa,cAAe,SAAQ,IAAI;IACtC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,0KAAmC;IACvD,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;sBAAoB;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAEvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAGzE;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,IAAI;IACvC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,gIAA4B;IAChD,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;sBAAqB;IAExC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAEvC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAGzE"}

package/dist/tools/implementations/MemoryTool.js

@@ -0,0 +1,167 @@
+import { z } from 'zod';
+import { Tool } from '../Tool.js';
+import { MemoryManager } from '../../memory/MemoryManager.js';
+const MemorySchema = z.object({
+    action: z.enum(['save', 'load', 'search', 'list', 'delete', 'rebuild']).describe('save=保存记忆, load=读取指定记忆, search=搜索相关记忆, list=列出记忆, delete=删除记忆, rebuild=重建索引'),
+    name: z.string().optional().describe('记忆名称 (save/load/delete 必填)，如 "user-preferences"'),
+    type: z.enum(['user', 'feedback', 'project', 'reference']).optional().describe('记忆类型 (save 必填): user=用户偏好, feedback=做事准则, project=项目知识, reference=外部资源'),
+    description: z.string().optional().describe('一句话描述 (save 必填)，用于索引检索'),
+    content: z.string().optional().describe('记忆正文 (save 必填)，Markdown 格式'),
+    query: z.string().optional().describe('搜索关键词 (search 必填)'),
+    scope: z.enum(['project', 'user', 'all']).optional().describe('作用域: project=项目级(.lingxiao/memory/), user=用户级(~/.lingxiao/memory/), all=先项目后用户。默认 project'),
+    maxResults: z.number().int().positive().max(50).optional().describe('search/list 最大结果数，默认 search=20'),
+});
+function resolveWritableScope(scope) {
+    return scope === 'all' ? null : scope;
+}
+function resolveSearchOptions(scope, maxResults) {
+    return {
+        scopes: scope === 'all' ? ['project', 'user'] : [scope],
+        maxResults,
+    };
+}
+// P0-1c: memory_read schema — read-only actions only
+const MemoryReadSchema = z.object({
+    action: z.enum(['load', 'search', 'list']).describe('load=读取指定记忆, search=搜索相关记忆, list=列出记忆'),
+    name: z.string().optional().describe('记忆名称 (load 必填)'),
+    query: z.string().optional().describe('搜索关键词 (search 必填)'),
+    scope: z.enum(['project', 'user', 'all']).optional().describe('作用域'),
+    maxResults: z.number().int().positive().max(50).optional().describe('最大结果数'),
+});
+// P0-1c: memory_write schema — write actions only
+const MemoryWriteSchema = z.object({
+    action: z.enum(['save', 'delete', 'rebuild']).describe('save=保存记忆, delete=删除记忆, rebuild=重建索引'),
+    name: z.string().optional().describe('记忆名称 (save/delete 必填)'),
+    type: z.enum(['user', 'feedback', 'project', 'reference']).optional().describe('记忆类型'),
+    description: z.string().optional().describe('一句话描述'),
+    content: z.string().optional().describe('记忆正文'),
+    scope: z.enum(['project', 'user', 'all']).optional().describe('作用域'),
+});
+export class MemoryTool extends Tool {
+    name = 'memory';
+    description = '轻量持久记忆系统 — 保存和检索项目级/用户级长期记忆。';
+    parameters = MemorySchema;
+    async execute(args, context) {
+        const params = args;
+        const workspace = context?.workspace || process.cwd();
+        const manager = new MemoryManager(workspace);
+        const scope = params.scope || 'project';
+        try {
+            switch (params.action) {
+                case 'save': {
+                    const writableScope = resolveWritableScope(scope);
+                    if (!writableScope)
+                        return { success: false, data: null, error: 'save 需要 scope 为 project 或 user，不能使用 all' };
+                    if (!params.name)
+                        return { success: false, data: null, error: 'save 需要 name 参数' };
+                    if (!params.type)
+                        return { success: false, data: null, error: 'save 需要 type 参数' };
+                    if (!params.description)
+                        return { success: false, data: null, error: 'save 需要 description 参数' };
+                    if (!params.content)
+                        return { success: false, data: null, error: 'save 需要 content 参数' };
+                    const result = manager.saveMemory(params.name, params.type, params.description, params.content, writableScope);
+                    const scopeLabel = writableScope === 'user' ? '用户级' : '项目级';
+                    return {
+                        success: true,
+                        data: `已保存${scopeLabel}记忆 "${result.name}" (${result.fileName})\n${result.filePath}`,
+                    };
+                }
+                case 'load': {
+                    if (!params.name)
+                        return { success: false, data: null, error: 'load 需要 name 参数' };
+                    const result = scope === 'all'
+                        ? manager.readMemoryAcrossScopes(params.name)
+                        : manager.readMemory(params.name, scope);
+                    if (!result) {
+                        return { success: false, data: null, error: `记忆 "${params.name}" 不存在` };
+                    }
+                    return {
+                        success: true,
+                        data: [
+                            `## ${result.name} (${result.scope}/${result.type})`,
+                            result.description,
+                            '',
+                            `file: ${result.filePath}`,
+                            '',
+                            result.content,
+                        ].join('\n'),
+                    };
+                }
+                case 'search': {
+                    if (!params.query)
+                        return { success: false, data: null, error: 'search 需要 query 参数' };
+                    const formatted = scope === 'all'
+                        ? manager.searchAllAndFormat(params.query, resolveSearchOptions(scope, params.maxResults))
+                        : manager.searchAndFormat(params.query, scope, params.maxResults);
+                    return { success: true, data: formatted };
+                }
+                case 'list': {
+                    const entries = scope === 'all'
+                        ? manager.listAllMemories()
+                        : manager.listMemories(scope).map((entry) => ({ ...entry, scope }));
+                    const limited = params.maxResults ? entries.slice(0, params.maxResults) : entries;
+                    if (entries.length === 0) {
+                        const label = scope === 'all' ? '长期' : scope === 'user' ? '用户级' : '项目级';
+                        return { success: true, data: `暂无${label}记忆` };
+                    }
+                    const lines = limited.map(e => `- [${e.name}](${e.fileName}) (${e.scope}) - ${e.description}`);
+                    return { success: true, data: lines.join('\n') };
+                }
+                case 'delete': {
+                    const writableScope = resolveWritableScope(scope);
+                    if (!writableScope)
+                        return { success: false, data: null, error: 'delete 需要 scope 为 project 或 user，不能使用 all' };
+                    if (!params.name)
+                        return { success: false, data: null, error: 'delete 需要 name 参数' };
+                    const ok = manager.deleteMemory(params.name, writableScope);
+                    if (!ok) {
+                        return { success: false, data: null, error: `记忆 "${params.name}" 不存在或删除失败` };
+                    }
+                    return { success: true, data: `已删除记忆 "${params.name}"` };
+                }
+                case 'rebuild': {
+                    if (scope === 'all') {
+                        manager.rebuildIndex('project');
+                        manager.rebuildIndex('user');
+                        return { success: true, data: '已重建项目级和用户级记忆索引' };
+                    }
+                    manager.rebuildIndex(scope);
+                    return { success: true, data: `已重建${scope === 'user' ? '用户级' : '项目级'}记忆索引` };
+                }
+                default:
+                    return { success: false, data: null, error: `未知 action: ${params.action}` };
+            }
+        }
+        catch (err) {
+            return { success: false, data: null, error: `记忆操作失败: ${err instanceof Error ? err.message : String(err)}` };
+        }
+    }
+}
+/**
+ * P0-1c: memory_read — read-only memory tool (load/search/list).
+ * Tier=read, so read-restricted roles (explore, research, review, planner) can use it.
+ */
+export class MemoryReadTool extends Tool {
+    name = 'memory_read';
+    description = '只读记忆检索 — 读取、搜索和列出长期记忆。不能修改记忆。';
+    parameters = MemoryReadSchema;
+    delegate = new MemoryTool();
+    async execute(args, context) {
+        return this.delegate.execute(args, context);
+    }
+}
+/**
+ * P0-1c: memory_write — write memory tool (save/delete/rebuild).
+ * Tier=write, so only full-tier roles (coding, verify, frontend, backend, fullstack, etc.) can use it.
+ */
+export class MemoryWriteTool extends Tool {
+    name = 'memory_write';
+    description = '写入记忆 — 保存、删除和重建长期记忆索引。';
+    parameters = MemoryWriteSchema;
+    delegate = new MemoryTool();
+    async execute(args, context) {
+        return this.delegate.execute(args, context);
+    }
+}
+//# sourceMappingURL=MemoryTool.js.map

package/dist/tools/implementations/MemoryTool.js.map

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

package/dist/tools/implementations/NodeReplTool.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { Tool, type ToolContext, type ToolResult } from '../Tool.js';
+export declare class NodeReplTool extends Tool {
+    readonly name = "node_repl";
+    readonly description = "\u6301\u4E45 JavaScript REPL\uFF1A\u5728\u9694\u79BB vm context \u4E2D\u6267\u884C JS\uFF0C\u652F\u6301 await\u3001session reset/list\u3002\u7528\u4E8E\u5FEB\u901F\u8BA1\u7B97\u3001\u89E3\u6790 JSON\u3001\u9A8C\u8BC1\u5C0F\u6BB5\u903B\u8F91\uFF1B\u5C5E\u4E8E\u6267\u884C\u7C7B\u5DE5\u5177\u3002";
+    readonly parameters: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"eval">;
+        code: z.ZodString;
+        session: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"reset">;
+        session: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"list_sessions">;
+    }, z.core.$strip>], "action">;
+    execute(args: unknown, context?: ToolContext): Promise<ToolResult>;
+}
+export default NodeReplTool;
+//# sourceMappingURL=NodeReplTool.d.ts.map

package/dist/tools/implementations/NodeReplTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeReplTool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/NodeReplTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AA8DrE,qBAAa,YAAa,SAAQ,IAAI;IACpC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,4SAAyG;IAC7H,QAAQ,CAAC,UAAU;;;;;;;;;;kCAAkB;IAE/B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAgDzE;AAED,eAAe,YAAY,CAAC"}