sema-core 1.0.14 → 2.0.0

package/dist/prompt/tools/createTodo.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTION = void 0;
+const tool_1 = require("../tool");
+exports.TOOL_DESCRIPTION = `Create a task list to track multi-step work and show progress to the user.
+
+Use when work involves 3+ steps or user explicitly asks. For single trivial actions, skip — just do them.
+
+## Workflow
+
+1. Capture requirements as tasks immediately
+2. Mark \`in_progress\` BEFORE starting, \`completed\` when done
+3. Add follow-up tasks discovered during work
+4. Use ${tool_1.TOOL_NAME_UPDATE_TODO} for dependencies (blocks/blockedBy)
+
+## Fields
+
+- **title** (required): Imperative title, e.g. "Fix auth bug in login flow"
+- **description** (required): What, why, and acceptance criteria — enough for another agent to complete
+- **progress_text** (optional): Spinner text in present-continuous, e.g. "Fixing auth bug"
+
+All tasks start \`pending\`. Check ${tool_1.TOOL_NAME_LIST_TODOS} first to avoid duplicates.`;
+//# sourceMappingURL=createTodo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createTodo.js","sourceRoot":"","sources":["../../../src/prompt/tools/createTodo.ts"],"names":[],"mappings":";;;AAAA,kCAAqE;AAExD,QAAA,gBAAgB,GAAG;;;;;;;;;SASvB,4BAAqB;;;;;;;;qCAQO,2BAAoB,6BAA6B,CAAA"}

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

@@ -0,0 +1,3 @@
+export declare const TOOL_DESCRIPTION = "Fetches a URL, converts HTML to markdown, and uses a fast model to extract information based on your prompt. Responses may be summarized for large pages. Results are cached for 15 minutes.\n\nRouting rules (check BEFORE calling):\n- Authenticated services cannot authenticate\n- If an MCP web fetch tool exists, prefer it over this tool\n\nBehavior notes:\n- HTTP auto-upgrades to HTTPS\n- Cross-host redirects return the redirect URL instead of content \u2014 re-fetch with the new URL\n";
+export declare function buildSecondaryModelPrompt(markdownContent: string, prompt: string): string;
+//# sourceMappingURL=fetchUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchUrl.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/fetchUrl.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,6eAS5B,CAAA;AAED,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,MAAM,CAWR"}

package/dist/prompt/tools/fetchUrl.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTION = void 0;
+exports.buildSecondaryModelPrompt = buildSecondaryModelPrompt;
+exports.TOOL_DESCRIPTION = `Fetches a URL, converts HTML to markdown, and uses a fast model to extract information based on your prompt. Responses may be summarized for large pages. Results are cached for 15 minutes.
+
+Routing rules (check BEFORE calling):
+- Authenticated services cannot authenticate
+- If an MCP web fetch tool exists, prefer it over this tool
+
+Behavior notes:
+- HTTP auto-upgrades to HTTPS
+- Cross-host redirects return the redirect URL instead of content — re-fetch with the new URL
+`;
+function buildSecondaryModelPrompt(markdownContent, prompt) {
+    return `Answer the question using ONLY the web page content below. If the content does not contain the answer, say so.
+
+<webpage>
+${markdownContent}
+</webpage>
+
+Question: ${prompt}
+
+Be concise. Preserve code snippets and exact values when relevant.
+`;
+}
+//# sourceMappingURL=fetchUrl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchUrl.js","sourceRoot":"","sources":["../../../src/prompt/tools/fetchUrl.ts"],"names":[],"mappings":";;;AAWA,8DAcC;AAzBY,QAAA,gBAAgB,GAAG;;;;;;;;;CAS/B,CAAA;AAED,SAAgB,yBAAyB,CACvC,eAAuB,EACvB,MAAc;IAEd,OAAO;;;EAGP,eAAe;;;YAGL,MAAM;;;CAGjB,CAAA;AACD,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare const TOOL_DESCRIPTION = "Signal that your plan is ready for user review.\n\n## Mechanism\n- Write your plan to the designated plan file FIRST, then call this tool\n- This tool takes no plan content \u2014 it reads from the file you already wrote\n\n## Scope\nThis tool is ONLY for tasks that involve planning code changes.\n\nDo NOT use it for research, exploration, or information-gathering tasks (searching, reading, understanding code).\n\n## Rules\n1. Resolve ambiguities with ask_form BEFORE finalizing your plan \u2014 not after\n2. Never use ask_form to ask \"Should I proceed?\" \u2014 submitting via this tool IS requesting approval\n\n## Examples\n- \"Find how authentication works in this repo\" \u2192 research task, do NOT use this tool\n- \"Implement OAuth login flow\" \u2192 implementation task, write plan then use this tool\n";
+//# sourceMappingURL=planToAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planToAgent.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/planToAgent.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,uzBAkB5B,CAAA"}

package/dist/prompt/tools/planToAgent.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTION = void 0;
+const tool_1 = require("../tool");
+exports.TOOL_DESCRIPTION = `Signal that your plan is ready for user review.
+
+## Mechanism
+- Write your plan to the designated plan file FIRST, then call this tool
+- This tool takes no plan content — it reads from the file you already wrote
+
+## Scope
+This tool is ONLY for tasks that involve planning code changes.
+
+Do NOT use it for research, exploration, or information-gathering tasks (searching, reading, understanding code).
+
+## Rules
+1. Resolve ambiguities with ${tool_1.TOOL_NAME_PICK_OPTION} BEFORE finalizing your plan — not after
+2. Never use ${tool_1.TOOL_NAME_PICK_OPTION} to ask "Should I proceed?" — submitting via this tool IS requesting approval
+
+## Examples
+- "Find how authentication works in this repo" → research task, do NOT use this tool
+- "Implement OAuth login flow" → implementation task, write plan then use this tool
+`;
+//# sourceMappingURL=planToAgent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planToAgent.js","sourceRoot":"","sources":["../../../src/prompt/tools/planToAgent.ts"],"names":[],"mappings":";;;AAAA,kCAA+C;AAElC,QAAA,gBAAgB,GAAG;;;;;;;;;;;;8BAYF,4BAAqB;eACpC,4BAAqB;;;;;CAKnC,CAAA"}

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

@@ -0,0 +1,2 @@
+export declare const getToolDescription: (defaultTimeoutMs: number, maxTimeoutMs: number) => string;
+//# sourceMappingURL=runShell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runShell.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/runShell.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB,GAC7B,kBAAkB,MAAM,EACxB,cAAc,MAAM,KACnB,MAwBF,CAAA"}

package/dist/prompt/tools/runShell.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolDescription = void 0;
+const tool_1 = require("../tool");
+const getToolDescription = (defaultTimeoutMs, maxTimeoutMs) => `Run shell commands and return their output.
+
+# Restrictions
+
+- Do NOT use ${tool_1.TOOL_NAME_RUN_SHELL} when a dedicated tool applies: ${tool_1.TOOL_NAME_SEARCH_FILES} (not find/ls), ${tool_1.TOOL_NAME_SEARCH_CONTENT} (not grep/rg), ${tool_1.TOOL_NAME_VIEW_FILE} (not cat/head/tail), Edit (not sed/awk), ${tool_1.TOOL_NAME_WRITE_FILE} (not echo/heredoc), Direct output (not echo/printf).
+- Never separate commands with bare newlines (newlines inside quoted strings are fine).
+
+# Command execution
+
+- Working directory persists across calls; shell state (variables, aliases) does not.
+- Run \`ls\` first before creating new directories/files to confirm the parent exists.
+- Quote paths with spaces. Use absolute paths; avoid \`cd\` unless requested.
+- Timeout: default ${defaultTimeoutMs}ms, max ${maxTimeoutMs}ms.
+- Use \`background\` for long-running commands. No trailing \`&\` needed.
+- Write a concise \`description\` for every call.
+
+# Multiple commands
+
+- Independent → parallel ${tool_1.TOOL_NAME_RUN_SHELL} tool calls in one message.
+- Dependent → chain with \`&&\`. Use \`;\` only when tolerating failures.
+
+# Sleep
+
+Avoid sleep. Use \`background\` or check status directly (e.g., \`docker ps\`). If unavoidable, keep 1–3s.
+`;
+exports.getToolDescription = getToolDescription;
+//# sourceMappingURL=runShell.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runShell.js","sourceRoot":"","sources":["../../../src/prompt/tools/runShell.ts"],"names":[],"mappings":";;;AAAA,kCAMgB;AAET,MAAM,kBAAkB,GAAG,CAChC,gBAAwB,EACxB,YAAoB,EACZ,EAAE,CAAC;;;;eAIE,0BAAmB,mCAAmC,6BAAsB,mBAAmB,+BAAwB,mBAAmB,0BAAmB,6CAA6C,2BAAoB;;;;;;;;qBAQxN,gBAAgB,WAAW,YAAY;;;;;;2BAMjC,0BAAmB;;;;;;CAM7C,CAAA;AA3BY,QAAA,kBAAkB,sBA2B9B"}

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

@@ -0,0 +1,2 @@
+export declare const TOOL_DESCRIPTION = "A ripgrep-based code search tool.\n\nRules:\n- Use search_content for ALL searches. NEVER run `grep` or `rg` via run_shell.\n- For open-ended, multi-round searches, use run_shell instead.\n\nCapabilities:\n- Full regex supported\n- File filtering: glob or type parameter\n- Output modes: \"files\" (default), \"content\", \"count\"\n- Cross-line matching: set `multiline: true`\n\nNote: ripgrep syntax \u2014 literal braces must be escaped.";
+//# sourceMappingURL=searchContent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchContent.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/searchContent.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,6bAY0B,CAAA"}

package/dist/prompt/tools/searchContent.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTION = void 0;
+const tool_1 = require("../tool");
+exports.TOOL_DESCRIPTION = `A ripgrep-based code search tool.
+
+Rules:
+- Use ${tool_1.TOOL_NAME_SEARCH_CONTENT} for ALL searches. NEVER run \`grep\` or \`rg\` via ${tool_1.TOOL_NAME_RUN_SHELL}.
+- For open-ended, multi-round searches, use ${tool_1.TOOL_NAME_RUN_SHELL} instead.
+
+Capabilities:
+- Full regex supported
+- File filtering: glob or type parameter
+- Output modes: "files" (default), "content", "count"
+- Cross-line matching: set \`multiline: true\`
+
+Note: ripgrep syntax — literal braces must be escaped.`;
+//# sourceMappingURL=searchContent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searchContent.js","sourceRoot":"","sources":["../../../src/prompt/tools/searchContent.ts"],"names":[],"mappings":";;;AAAA,kCAAuE;AAE1D,QAAA,gBAAgB,GAAG;;;QAGxB,+BAAwB,uDAAuD,0BAAmB;8CAC5D,0BAAmB;;;;;;;;uDAQV,CAAA"}

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

@@ -0,0 +1,2 @@
+export declare const TOOL_DESCRIPTION: string;
+//# sourceMappingURL=skill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAE,MASqC,CAAA"}

package/dist/prompt/tools/skill.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTION = void 0;
+exports.TOOL_DESCRIPTION = `Dispatch specialized skill modules during conversation.
+
+Format:
+- \`skill: "name"\` — basic call
+- \`skill: "name", args: "value"\` — with arguments
+- \`skill: "provider:name"\` — namespaced call
+
+Behavior contract:
+1. A matching skill MUST be dispatched before any text output — this is a hard gate, not a preference.
+2. Referencing a skill by name without dispatching it is forbidden.`;
+//# sourceMappingURL=skill.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../src/prompt/tools/skill.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAW;;;;;;;;;oEAS4B,CAAA"}

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

@@ -0,0 +1,2 @@
+export declare function resolveSubAgentDescription(): string;
+//# sourceMappingURL=subAgent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subAgent.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/subAgent.ts"],"names":[],"mappings":"AAIA,wBAAgB,0BAA0B,IAAI,MAAM,CAsCnD"}

package/dist/prompt/tools/subAgent.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSubAgentDescription = resolveSubAgentDescription;
+const agentsManager_1 = require("../../services/agents/agentsManager");
+const tool_1 = require("../tool");
+function resolveSubAgentDescription() {
+    return `Spawn autonomous sub-agents to handle complex, multi-step work.
+
+Each agent runs in its own independent context with its own tool set. Use \`agent_type\` to select; defaults to Default.
+
+Available types:
+${agentsManager_1.getAgentTypesDescription}
+
+## Agent selection
+
+- **Read-only tasks** (browse, analyze, search, explain, list files, understand structure): use \`SearchCodebase\` — it's faster and lighter.
+- **Write tasks** (create, edit, fix, refactor, multi-step modifications): use \`Default\`.
+
+When in doubt: if the task requires NO file writes, prefer \`SearchCodebase\`.
+
+## Prefer direct tools for simple tasks
+
+If a ${tool_1.TOOL_NAME_VIEW_FILE}, ${tool_1.TOOL_NAME_SEARCH_FILES}, or ${tool_1.TOOL_NAME_SEARCH_CONTENT} call can answer the question, use that instead — agents are for multi-step work, not single lookups.
+
+## Execution model
+
+**Parallel launch**: When multiple agents are independent, fire them all in one message — never sequentially.
+
+**Foreground** (default): Block until result. Use when downstream work depends on the output.
+**Background** (\`background: true\`): Fire and continue. You'll be notified on completion — do not poll or sleep.
+
+## Prompting the agent
+
+The agent has zero conversation context. Write its prompt as a self-contained brief:
+- State the goal and why it matters
+- Include file paths, line numbers, or specific findings you already have
+- Specify whether it should write code or only research
+- Keep scope tight — one clear deliverable per agent
+
+## Handling results
+
+Agent output is invisible to the user. Synthesize and relay key findings in your response.
+`;
+}
+//# sourceMappingURL=subAgent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subAgent.js","sourceRoot":"","sources":["../../../src/prompt/tools/subAgent.ts"],"names":[],"mappings":";;AAIA,gEAsCC;AA1CD,uEAA8E;AAC9E,kCAA+F;AAG/F,SAAgB,0BAA0B;IACxC,OAAO;;;;;EAKP,wCAAwB;;;;;;;;;;;OAWnB,0BAAmB,KAAK,6BAAsB,QAAQ,+BAAwB;;;;;;;;;;;;;;;;;;;;CAoBpF,CAAA;AACD,CAAC"}

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

@@ -0,0 +1,4 @@
+export declare const VIEW_FILE_MAX_LINES = 2000;
+export declare const VIEW_FILE_MAX_LINE_LENGTH = 1500;
+export declare const TOOL_DESCRIPTION = "Read any file from the local filesystem. All paths are assumed valid; non-existent files return an error.\n\nRules:\n- file_path MUST be absolute\n- Default: reads up to 2000 lines from the start. Use start_line/max_lines for long files, but prefer reading the whole file\n- Lines longer than 1500 chars keep only the first 1500 chars (rest replaced with a truncation marker)\n- Output: cat -n format (line numbers from 1)\n\nSupported formats:\n- Text, code, config files\n- Images (PNG, JPG, etc.) \u2014 ALWAYS read when user provides a screenshot path\n- PDF \u2014 large PDFs (>10 pages) MUST use the pdf_page_range parameter (e.g., \"1-3\"), max 20 pages per call\n- Jupyter notebooks (.ipynb) \u2014 returns all cells with outputs\n\nNOT supported:\n- Word (.doc/.docx) \u2014 use Bash to extract text instead\n- Directories \u2014 use `ls` via Bash instead\n\nTips:\n- Read multiple files in parallel when possible";
+//# sourceMappingURL=viewFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewFile.d.ts","sourceRoot":"","sources":["../../../src/prompt/tools/viewFile.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,eAAO,MAAM,yBAAyB,OAAO,CAAA;AAE7C,eAAO,MAAM,gBAAgB,+5BAmBmB,CAAA"}

package/dist/prompt/tools/viewFile.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DESCRIPTION = exports.VIEW_FILE_MAX_LINE_LENGTH = exports.VIEW_FILE_MAX_LINES = void 0;
+exports.VIEW_FILE_MAX_LINES = 2000; // 最多读取行数
+exports.VIEW_FILE_MAX_LINE_LENGTH = 1500; // 单行最多保留字符数，超出截断
+exports.TOOL_DESCRIPTION = `Read any file from the local filesystem. All paths are assumed valid; non-existent files return an error.
+
+Rules:
+- file_path MUST be absolute
+- Default: reads up to ${exports.VIEW_FILE_MAX_LINES} lines from the start. Use start_line/max_lines for long files, but prefer reading the whole file
+- Lines longer than ${exports.VIEW_FILE_MAX_LINE_LENGTH} chars keep only the first ${exports.VIEW_FILE_MAX_LINE_LENGTH} chars (rest replaced with a truncation marker)
+- Output: cat -n format (line numbers from 1)
+
+Supported formats:
+- Text, code, config files
+- Images (PNG, JPG, etc.) — ALWAYS read when user provides a screenshot path
+- PDF — large PDFs (>10 pages) MUST use the pdf_page_range parameter (e.g., "1-3"), max 20 pages per call
+- Jupyter notebooks (.ipynb) — returns all cells with outputs
+
+NOT supported:
+- Word (.doc/.docx) — use Bash to extract text instead
+- Directories — use \`ls\` via Bash instead
+
+Tips:
+- Read multiple files in parallel when possible`;
+//# sourceMappingURL=viewFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewFile.js","sourceRoot":"","sources":["../../../src/prompt/tools/viewFile.ts"],"names":[],"mappings":";;;AACa,QAAA,mBAAmB,GAAG,IAAI,CAAA,CAAE,SAAS;AACrC,QAAA,yBAAyB,GAAG,IAAI,CAAA,CAAE,iBAAiB;AAEnD,QAAA,gBAAgB,GAAG;;;;yBAIP,2BAAmB;sBACtB,iCAAyB,8BAA8B,iCAAyB;;;;;;;;;;;;;;gDActD,CAAA"}

package/dist/services/agents/agentsManager.d.ts

@@ -2,8 +2,7 @@
  * Agents 管理器
  *
  * 管理自定义 Agent 的全局注册和查找
- * 实现优先级：内置 < 用户级 < 项目级 (后加载的覆盖先加载的)
- * 兼容 Claude Code 和 Sema 两套路径（Claude 只读）
+ * 实现优先级：内置 < 插件 < 用户级 < 项目级 (后加载的覆盖先加载的)
  */
 import { AgentConfig } from '../../types/agent';
 /**
@@ -12,8 +11,6 @@ import { AgentConfig } from '../../types/agent';
 declare class AgentsManager {
     private semaUserAgentsDir;
     private semaProjectAgentsDir;
-    private claudeUserAgentsDir;
-    private claudeProjectAgentsDir;
     private agentConfigs;
     private agentInfoCache;
     private loadingPromise;
@@ -24,8 +21,8 @@ declare class AgentsManager {
     private invalidateCache;
     /**
      * 加载 Agents 配置（内部方法）
-     * 按优先级加载：用户级(Claude) -> 项目级(Claude) -> 内置 -> 插件 -> 用户级(Sema) -> 项目级(Sema)
-     * 后加载的覆盖先加载的，优先级从高到低：项目级(Sema) > 用户级(Sema) > 插件 > 内置 > 项目级(Claude) > 用户级(Claude)
+     * 按优先级加载：内置 -> 插件 -> 用户级 -> 项目级
+     * 后加载的覆盖先加载的
      */
     private loadAgents;
     /**
@@ -39,12 +36,11 @@ declare class AgentsManager {
     private loadAgentsFromPlugins;
     /**
      * 从指定目录加载 agent 配置
-     * Claude 来源为只读
      */
     private loadAgentsFromDir;
     /**
      * 解析 Agent Markdown 文件
-     * 使用 parseClaudeFile 统一解析 frontmatter
+     * 使用 parseFile 统一解析 frontmatter
      */
     private parseAgentFile;
     /**
@@ -52,14 +48,15 @@ declare class AgentsManager {
      */
     private getAgentsConfs;
     /**
-     * 获取所有 Agent 信息（有缓存则直接返回，否则等待后台加载或重新加载）
+     * 重新加载并缓存 Agents 信息
      */
-    getAgentsInfo(): Promise<AgentConfig[]>;
+    private loadAndCacheAgents;
     /**
-     * 刷新 Agents 信息
-     * 重新加载所有配置，更新缓存
+     * 获取所有 Agent 信息
+     * @param concise 简洁模式，返回的 prompt 字段为空字符串（UI 层一般用不上）
+     * @param refresh 是否强制刷新（清缓存后重新加载）
      */
-    refreshAgentsInfo(): Promise<AgentConfig[]>;
+    getAgentsInfo(concise?: boolean, refresh?: boolean): Promise<AgentConfig[]>;
     /**
      * 根据名称获取 Agent 配置
      */
@@ -79,12 +76,12 @@ declare class AgentsManager {
     private generateAgentFileContent;
     /**
      * 添加 Agent 配置
-     * 只能添加到 Sema 路径（Claude 为只读）
+     * 只能添加到 Sema 路径
      */
     addAgentConf(agentConf: AgentConfig): Promise<AgentConfig[]>;
     /**
      * 移除 Agent 配置
-     * Claude 来源为只读，不可移除
+     * 内置 Agent 不可移除
      */
     removeAgentConf(name: string): Promise<AgentConfig[]>;
     /**

package/dist/services/agents/agentsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentsManager.d.ts","sourceRoot":"","sources":["../../../src/services/agents/agentsManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAA;AAS3D;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,oBAAoB,CAAQ;IAEpC,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,sBAAsB,CAAQ;IAEtC,OAAO,CAAC,YAAY,CAAsC;IAE1D,OAAO,CAAC,cAAc,CAA6B;IAEnD,OAAO,CAAC,cAAc,CAAsC;;IAmB5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;YACW,UAAU;IAiCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;;OAGG;YACW,qBAAqB;IAiCnC;;;OAGG;YACW,iBAAiB;IAsC/B;;;OAGG;YACW,cAAc;IAsD5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAU7C;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBjD;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIrD;;;OAGG;IACH,wBAAwB,IAAI,MAAM;IAUlC;;OAEG;YACW,eAAe;IAoB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0BlE;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA8C3D;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"agentsManager.d.ts","sourceRoot":"","sources":["../../../src/services/agents/agentsManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAA;AAS3D;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,oBAAoB,CAAQ;IAEpC,OAAO,CAAC,YAAY,CAAsC;IAE1D,OAAO,CAAC,cAAc,CAA6B;IAEnD,OAAO,CAAC,cAAc,CAAsC;;IAiB5D;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;YACW,UAAU;IAoBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;OAGG;YACW,qBAAqB;IAgCnC;;OAEG;YACW,iBAAiB;IAsC/B;;;OAGG;YACW,cAAc;IAsE5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;YACW,kBAAkB;IAqBhC;;;;OAIG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAcjF;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIrD;;;OAGG;IACH,wBAAwB,IAAI,MAAM;IAUlC;;OAEG;YACW,eAAe;IAoB7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;;OAGG;IACG,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0BlE;;;OAGG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAyC3D;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}