sema-core 1.0.2

package/dist/tools/Write/Write.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileWriteTool = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const zod_1 = require("zod");
+const file_1 = require("../../util/file");
+const cwd_1 = require("../../util/cwd");
+const prompt_1 = require("./prompt");
+const StateManager_1 = require("../../manager/StateManager");
+const diff_1 = require("../../util/diff");
+const MAX_LINES_TO_RENDER = 5;
+const MAX_LINES_TO_RENDER_FOR_ASSISTANT = 16000;
+const TRUNCATED_MESSAGE = '<response clipped><NOTE>To save on context only part of this file has been shown to you. You should retry this tool after you have searched inside the file with Grep in order to find the line numbers of what you are looking for.</NOTE>';
+// 辅助函数：生成显示标题
+function getTitle(input) {
+    if (input?.file_path) {
+        const relativePath = (0, path_1.relative)((0, cwd_1.getCwd)(), input.file_path);
+        return `${relativePath}`;
+    }
+    return prompt_1.TOOL_NAME_FOR_PROMPT;
+}
+const inputSchema = zod_1.z.strictObject({
+    file_path: zod_1.z
+        .string()
+        .describe('The absolute path to the file to write (must be absolute, not relative)'),
+    content: zod_1.z.string().describe('The content to write to the file'),
+});
+exports.FileWriteTool = {
+    name: prompt_1.TOOL_NAME_FOR_PROMPT,
+    description() {
+        return prompt_1.DESCRIPTION;
+    },
+    inputSchema,
+    isReadOnly() {
+        return false;
+    },
+    genToolPermission(input) {
+        let title = getTitle(input);
+        const fullFilePath = (0, file_1.normalizeFilePath)(input.file_path);
+        const fileExists = (0, fs_1.existsSync)(fullFilePath);
+        let contentPreview = '';
+        const oldContent = fileExists ? (0, fs_1.readFileSync)(fullFilePath, (0, file_1.detectFileEncoding)(fullFilePath)) : '';
+        const patch = (0, diff_1.getPatch)({
+            filePath: fullFilePath,
+            fileContents: oldContent,
+            oldStr: oldContent,
+            newStr: input.content,
+        });
+        contentPreview = {
+            type: fileExists ? 'diff' : 'new',
+            patch: patch,
+            diffText: ''
+        };
+        return { title, content: contentPreview };
+    },
+    genToolResultMessage({ filePath, content, structuredPatch, type }) {
+        const title = getTitle({ file_path: filePath });
+        const displayPath = (0, path_1.relative)((0, cwd_1.getCwd)(), filePath);
+        let summary;
+        let contentPreview = '';
+        switch (type) {
+            case 'create': {
+                const allLines = content.split(/\r?\n/);
+                const numLines = allLines.length;
+                summary = `Created ${displayPath} with ${numLines} lines`;
+                const previewLines = allLines.slice(0, MAX_LINES_TO_RENDER).map(l => `+${l}`);
+                const diffText = numLines > MAX_LINES_TO_RENDER ? `... (+${numLines - MAX_LINES_TO_RENDER} lines)` : '';
+                contentPreview = {
+                    type: 'new',
+                    patch: [
+                        {
+                            oldStart: 1,
+                            oldLines: 0,
+                            newStart: 1,
+                            newLines: numLines,
+                            lines: previewLines,
+                        }
+                    ],
+                    diffText,
+                };
+                break;
+            }
+            case 'update': {
+                summary = (0, diff_1.getUpdateSummary)(filePath, structuredPatch);
+                contentPreview = {
+                    type: 'diff',
+                    patch: structuredPatch,
+                    diffText: ''
+                };
+                break;
+            }
+        }
+        return { title, summary, content: contentPreview };
+    },
+    getDisplayTitle(input) {
+        return getTitle(input);
+    },
+    async validateInput({ file_path }, agentContext) {
+        const stateManager = (0, StateManager_1.getStateManager)();
+        const agentState = stateManager.forAgent(agentContext.agentId);
+        const fullFilePath = (0, file_1.normalizeFilePath)(file_path);
+        if (!(0, fs_1.existsSync)(fullFilePath)) {
+            return { result: true };
+        }
+        const readTimestamp = agentState.getReadFileTimestamp(fullFilePath);
+        if (!readTimestamp) {
+            return {
+                result: false,
+                message: 'File has not been read yet. Read it first before writing to it.',
+            };
+        }
+        // Check if file exists and get its last modified time
+        const stats = (0, fs_1.statSync)(fullFilePath);
+        const lastWriteTime = stats.mtimeMs;
+        if (lastWriteTime > readTimestamp) {
+            return {
+                result: false,
+                message: 'File has been modified since read, either by the user or by a linter. Read it again before attempting to write it.',
+            };
+        }
+        return { result: true };
+    },
+    async *call({ file_path, content }, agentContext) {
+        const stateManager = (0, StateManager_1.getStateManager)();
+        const agentState = stateManager.forAgent(agentContext.agentId);
+        const fullFilePath = (0, file_1.normalizeFilePath)(file_path);
+        const dir = (0, path_1.dirname)(fullFilePath);
+        const oldFileExists = (0, fs_1.existsSync)(fullFilePath);
+        const enc = oldFileExists ? (0, file_1.detectFileEncoding)(fullFilePath) : 'utf-8';
+        const oldContent = oldFileExists ? (0, fs_1.readFileSync)(fullFilePath, enc) : null;
+        const endings = oldFileExists
+            ? (0, file_1.detectLineEndings)(fullFilePath)
+            : await (0, file_1.detectRepoLineEndings)((0, cwd_1.getCwd)());
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+        (0, file_1.writeTextContent)(fullFilePath, content, enc, endings);
+        // Update read timestamp, to invalidate stale writes
+        agentState.setReadFileTimestamp(fullFilePath, (0, fs_1.statSync)(fullFilePath).mtimeMs);
+        if (oldContent) {
+            const patch = (0, diff_1.getPatch)({
+                filePath: fullFilePath,
+                fileContents: oldContent,
+                oldStr: oldContent,
+                newStr: content,
+            });
+            const data = {
+                type: 'update',
+                filePath: file_path,
+                content,
+                structuredPatch: patch,
+            };
+            yield {
+                type: 'result',
+                data,
+                resultForAssistant: this.genResultForAssistant(data),
+            };
+            return;
+        }
+        const data = {
+            type: 'create',
+            filePath: file_path,
+            content,
+            structuredPatch: [],
+        };
+        yield {
+            type: 'result',
+            data,
+            resultForAssistant: this.genResultForAssistant(data),
+        };
+    },
+    genResultForAssistant({ filePath, content, type }) {
+        switch (type) {
+            case 'create':
+                return `File created successfully at: ${filePath}`;
+            case 'update':
+                return `The file ${filePath} has been updated. Here's the result of running \`cat -n\` on a snippet of the edited file:
+${(0, file_1.addLineNumbers)({
+                    content: content.split(/\r?\n/).length > MAX_LINES_TO_RENDER_FOR_ASSISTANT
+                        ? content
+                            .split(/\r?\n/)
+                            .slice(0, MAX_LINES_TO_RENDER_FOR_ASSISTANT)
+                            .join('\n') + TRUNCATED_MESSAGE
+                        : content,
+                    startLine: 1,
+                })}`;
+        }
+    },
+};
+//# sourceMappingURL=Write.js.map

package/dist/tools/Write/Write.js.map

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

package/dist/tools/Write/prompt.d.ts

@@ -0,0 +1,3 @@
+export declare const TOOL_NAME_FOR_PROMPT = "Write";
+export declare const DESCRIPTION = "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.\n- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.";
+//# sourceMappingURL=prompt.d.ts.map

package/dist/tools/Write/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/tools/Write/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAE3C,eAAO,MAAM,WAAW,0nBAO0E,CAAA"}

package/dist/tools/Write/prompt.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DESCRIPTION = exports.TOOL_NAME_FOR_PROMPT = void 0;
+exports.TOOL_NAME_FOR_PROMPT = 'Write';
+exports.DESCRIPTION = `Writes a file to the local filesystem.
+
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
+- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
+- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.
+- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.`;
+//# sourceMappingURL=prompt.js.map

package/dist/tools/Write/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/tools/Write/prompt.ts"],"names":[],"mappings":";;;AAAa,QAAA,oBAAoB,GAAG,OAAO,CAAA;AAE9B,QAAA,WAAW,GAAG;;;;;;;kGAOuE,CAAA"}

package/dist/tools/base/Tool.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+/**
+ * Sema 可扩展工具系统的核心工具接口
+ * 为所有工具实现提供标准化契约
+ */
+export interface ValidationResult {
+    result: boolean;
+    message?: string;
+    errorCode?: number;
+    meta?: any;
+}
+export interface Tool<TInput extends z.ZodObject<any> = z.ZodObject<any>, TOutput = any> {
+    name: string;
+    description?: string | (() => string);
+    inputSchema: TInput;
+    isReadOnly: () => boolean;
+    validateInput?: (input: z.infer<TInput>, agentContext: any) => Promise<ValidationResult>;
+    genResultForAssistant: (output: TOutput) => string;
+    genToolPermission?: (input: z.infer<TInput>) => {
+        title: string;
+        summary?: string;
+        content: string | Record<string, any>;
+    };
+    genToolResultMessage?: (output: TOutput, input?: z.infer<TInput>) => {
+        title: string;
+        summary: string;
+        content: string | Record<string, any>;
+    };
+    getDisplayTitle?: (input?: z.infer<TInput>) => string;
+    call: (input: z.infer<TInput>, agentContext: any) => AsyncGenerator<{
+        type: 'result';
+        data: TOutput;
+        resultForAssistant?: string;
+    }, void, unknown>;
+}
+//# sourceMappingURL=Tool.d.ts.map

package/dist/tools/base/Tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../../src/tools/base/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,GAAG,CAAA;CACX;AAGD,MAAM,WAAW,IAAI,CACnB,MAAM,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAClD,OAAO,GAAG,GAAG;IAEb,IAAI,EAAE,MAAM,CAAA;IAEZ,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAA;IAErC,WAAW,EAAE,MAAM,CAAA;IAGnB,UAAU,EAAE,MAAM,OAAO,CAAA;IAEzB,aAAa,CAAC,EAAE,CACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EACtB,YAAY,EAAE,GAAG,KACd,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAE9B,qBAAqB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;IAElD,iBAAiB,CAAC,EAAE,CAClB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KACnB;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAA;IAE/E,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAA;IAE9I,eAAe,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAA;IAGrD,IAAI,EAAE,CACJ,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EACtB,YAAY,EAAE,GAAG,KACd,cAAc,CACjB;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,EAC9D,IAAI,EACJ,OAAO,CACR,CAAA;CACF"}

package/dist/tools/base/Tool.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Tool.js.map

package/dist/tools/base/Tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../../src/tools/base/Tool.ts"],"names":[],"mappings":""}

package/dist/tools/base/tools.d.ts

@@ -0,0 +1,9 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { Tool } from './Tool';
+import { ToolInfo } from '../../types/index';
+export declare const getToolInfos: () => ToolInfo[];
+export declare const getBuiltinTools: () => Tool[];
+export declare const getTools: ((useTools?: string[] | null) => Tool[]) & import("lodash").MemoizedFunction;
+export declare const buildTools: ((tools: Tool[]) => Anthropic.Tool[]) & import("lodash").MemoizedFunction;
+export declare function getToolDescription(tool: Tool): string;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/tools/base/tools.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAgB7B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAI5C,eAAO,MAAM,YAAY,QAAO,QAAQ,EAOvC,CAAA;AAGD,eAAO,MAAM,eAAe,QAAO,IAAI,EAetC,CAAA;AAGD,eAAO,MAAM,QAAQ,eACP,MAAM,EAAE,GAAG,IAAI,KAAG,IAAI,EAAE,qCAerC,CAAA;AAwBD,eAAO,MAAM,UAAU,WACb,IAAI,EAAE,KAAG,SAAS,CAAC,IAAI,EAAE,qCAsBlC,CAAA;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKrD"}

package/dist/tools/base/tools.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTools = exports.getTools = exports.getBuiltinTools = exports.getToolInfos = void 0;
+exports.getToolDescription = getToolDescription;
+const Bash_1 = require("../Bash/Bash");
+const Edit_1 = require("../Edit/Edit");
+const Read_1 = require("../Read/Read");
+const Write_1 = require("../Write/Write");
+const Glob_1 = require("../Glob/Glob");
+const Grep_1 = require("../Grep/Grep");
+const NotebookEdit_1 = require("../NotebookEdit/NotebookEdit");
+const TodoWrite_1 = require("../TodoWrite/TodoWrite");
+const Skill_1 = require("../Skill/Skill");
+const Task_1 = require("../Task/Task");
+const AskUserQuestion_1 = require("../AskUserQuestion/AskUserQuestion");
+const ExitPlanMode_1 = require("../ExitPlanMode/ExitPlanMode");
+const ConfManager_1 = require("../../manager/ConfManager");
+const zod_to_json_schema_1 = require("zod-to-json-schema");
+const lodash_es_1 = require("lodash-es");
+// 获取所有工具信息（内置工具）
+const getToolInfos = () => {
+    const useTools = (0, ConfManager_1.getConfManager)().getCoreConfig()?.useTools;
+    return (0, exports.getBuiltinTools)().map(tool => ({
+        name: tool.name,
+        description: getToolDescription(tool),
+        status: (!useTools || useTools.includes(tool.name)) ? 'enable' : 'disable'
+    }));
+};
+exports.getToolInfos = getToolInfos;
+// 获取内置工具
+const getBuiltinTools = () => {
+    return [
+        Bash_1.BashTool,
+        Glob_1.GlobTool,
+        Grep_1.GrepTool,
+        Read_1.FileReadTool,
+        Write_1.FileWriteTool,
+        Edit_1.FileEditTool,
+        TodoWrite_1.TodoWriteTool,
+        Skill_1.SkillTool,
+        Task_1.TaskTool,
+        NotebookEdit_1.NotebookEditTool,
+        AskUserQuestion_1.AskUserQuestionTool,
+        ExitPlanMode_1.ExitPlanModeTool,
+    ];
+};
+exports.getBuiltinTools = getBuiltinTools;
+// 所有可用工具
+exports.getTools = (0, lodash_es_1.memoize)((useTools) => {
+    const allTools = (0, exports.getBuiltinTools)();
+    if (!useTools) {
+        return allTools;
+    }
+    return allTools.filter(tool => useTools.includes(tool.name));
+}, (useTools) => {
+    if (!useTools) {
+        return 'all-tools';
+    }
+    return useTools.sort().join(',');
+});
+// 从 zod schema 中提取 required 字段
+function extractRequiredFields(schema) {
+    if (!schema || typeof schema !== 'object')
+        return [];
+    if (schema._def && schema._def.shape) {
+        const shape = schema._def.shape();
+        return Object.entries(shape)
+            .filter(([_, fieldSchema]) => {
+            return !fieldSchema.isOptional();
+        })
+            .map(([fieldName]) => fieldName);
+    }
+    if (schema.properties) {
+        return schema.required || [];
+    }
+    return [];
+}
+// 使用 memoize 优化的 buildTools 函数
+exports.buildTools = (0, lodash_es_1.memoize)((tools) => {
+    return tools.map(tool => {
+        const jsonSchema = (0, zod_to_json_schema_1.zodToJsonSchema)(tool.inputSchema);
+        const requiredFields = extractRequiredFields(tool.inputSchema);
+        // 安全地获取 properties
+        const properties = (jsonSchema && typeof jsonSchema === 'object' && 'properties' in jsonSchema)
+            ? jsonSchema.properties
+            : jsonSchema;
+        return {
+            name: tool.name,
+            description: getToolDescription(tool),
+            input_schema: {
+                type: 'object',
+                properties: properties,
+                required: requiredFields
+            }
+        };
+    });
+}, (tools) => tools.map(tool => tool.name).sort().join(','));
+// 辅助函数：获取工具描述
+function getToolDescription(tool) {
+    if (typeof tool.description === 'function') {
+        return tool.description();
+    }
+    return tool.description || '';
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools/base/tools.js.map

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

package/dist/types/agent.d.ts

@@ -0,0 +1,30 @@
+import type { Tool } from '../tools/base/Tool';
+export type AgentLocate = 'user' | 'project' | 'builtin';
+export interface AgentConfig {
+    name: string;
+    description: string;
+    tools?: string[] | '*';
+    prompt: string;
+    model?: string;
+    locate?: AgentLocate;
+}
+export interface AgentInfo {
+    name: string;
+    description: string;
+    tools?: string[] | '*';
+    model?: string;
+    locate: AgentLocate;
+}
+/**
+ * 代理上下文
+ * 包含代理执行所需的所有上下文信息
+ */
+export interface AgentContext {
+    /** 代理 ID（主代理为 MAIN_AGENT_ID，子代理为 taskId） */
+    agentId: string;
+    abortController: AbortController;
+    tools: Tool[];
+    /** 模型类型 */
+    model?: 'main' | 'quick';
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE9C,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;AAExD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,eAAe,CAAA;IAChC,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB"}

package/dist/types/agent.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=agent.js.map

package/dist/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/types/agent.ts"],"names":[],"mappings":""}

package/dist/types/command.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 自定义命令类型定义
+ */
+/**
+ * 自定义命令的 Frontmatter 配置
+ */
+export interface CustomCommandFrontmatter {
+    /** 命令描述 */
+    description?: string;
+    /** 参数提示文本（如 "<file-path>" 或 "<environment> <version>"） */
+    'argument-hint'?: string;
+}
+/**
+ * 自定义命令对象
+ */
+export interface CustomCommand {
+    /** 命令名（如 "optimize" 或 "frontend:test"） */
+    name: string;
+    /** 显示名（如 "/optimize" 或 "/frontend:test"） */
+    displayName: string;
+    /** 命令描述 */
+    description: string;
+    /** 参数提示 */
+    argumentHint?: string;
+    /** 源 .md 文件路径 */
+    filePath: string;
+    /** 作用域：用户级别或项目级别 */
+    scope: 'user' | 'project';
+    /** Markdown 内容（不含 frontmatter） */
+    content: string;
+}
+/**
+ * 加载自定义命令的结果
+ */
+export interface LoadCustomCommandsResult {
+    /** 成功加载的命令列表 */
+    commands: CustomCommand[];
+    /** 加载过程中的错误列表 */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=command.d.ts.map

package/dist/types/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/types/command.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;CAM1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW;IACX,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB;IAChB,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iBAAiB;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD"}

package/dist/types/command.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * 自定义命令类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command.js.map

package/dist/types/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/types/command.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/types/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 项目配置接口
+ */
+export interface ProjectConfig {
+    allowedTools: string[];
+    history: string[];
+    lastEditTime: string;
+    rules: string[];
+}
+/**
+ * 全局配置文件接口
+ */
+export type GlobalProjectConfig = Record<string, ProjectConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":""}

package/dist/types/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 用户中断操作异常
+ * 当用户主动中断操作时抛出此异常，区别于系统错误
+ */
+export declare class InterruptedException extends Error {
+    constructor(message?: string);
+}
+/**
+ * 检查中断信号并抛出中断异常
+ * @param abortController 中断控制器
+ */
+export declare function checkAbortSignal(abortController: AbortController): void;
+/**
+ * 判断是否为中断异常
+ * @param error 错误对象
+ */
+export declare function isInterruptedException(error: unknown): error is InterruptedException;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,SAAsC;CAI1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAIvE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF"}

package/dist/types/errors.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InterruptedException = void 0;
+exports.checkAbortSignal = checkAbortSignal;
+exports.isInterruptedException = isInterruptedException;
+/**
+ * 用户中断操作异常
+ * 当用户主动中断操作时抛出此异常，区别于系统错误
+ */
+class InterruptedException extends Error {
+    constructor(message = 'Operation was interrupted by user') {
+        super(message);
+        this.name = 'InterruptedException';
+    }
+}
+exports.InterruptedException = InterruptedException;
+/**
+ * 检查中断信号并抛出中断异常
+ * @param abortController 中断控制器
+ */
+function checkAbortSignal(abortController) {
+    if (abortController.signal.aborted) {
+        throw new InterruptedException();
+    }
+}
+/**
+ * 判断是否为中断异常
+ * @param error 错误对象
+ */
+function isInterruptedException(error) {
+    return error instanceof InterruptedException;
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":";;;AAeA,4CAIC;AAMD,wDAEC;AA3BD;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,GAAG,mCAAmC;QACvD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAA;IACpC,CAAC;CACF;AALD,oDAKC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,eAAgC;IAC/D,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,oBAAoB,EAAE,CAAA;IAClC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,KAAc;IACnD,OAAO,KAAK,YAAY,oBAAoB,CAAA;AAC9C,CAAC"}