@skj1724/oh-my-opencode 4.0.1 → 4.0.4

package/dist/shared/agent-permissions.d.ts

@@ -8,14 +8,22 @@
  * - canDelegateTasks: 是否可以委派任务
  * - allowedCategories: 允许委派的分类列表
  */
+export type ToolMode = "blacklist" | "whitelist";
 export interface AgentPermission {
     canReadFiles: boolean;
     canWriteFiles: boolean;
     canExecuteCommands: boolean;
     canDelegateTasks: boolean;
     allowedCategories: string[];
+    /** 工具限制模式：blacklist（从 5 维推导黑名单，其余默认允许）或 whitelist（全禁，只开放列出的工具） */
+    toolMode?: ToolMode;
+    /** 工具级覆盖，不受 5 维推导影响。在 blacklist 模式下追加到黑名单，在 whitelist 模式下追加到白名单 */
+    toolOverrides?: Record<string, boolean>;
+    /** SDK permission 覆盖，值格式为 "allow" | "deny" */
+    sdkPermissionOverrides?: Record<string, "allow" | "deny">;
 }
 export declare const DEFAULT_AGENT_PERMISSIONS: Record<string, AgentPermission>;
+export declare const ALL_DEFINED_AGENTS: readonly string[];
 /**
  * 获取指定 agent 的权限配置。
  * 优先级：用户覆盖 > 默认配置 > 新 agent 默认值。
@@ -26,6 +34,11 @@ export declare function canWriteFiles(agentName: string): boolean;
 export declare function canExecuteCommands(agentName: string): boolean;
 export declare function canDelegateTasks(agentName: string): boolean;
 export declare function getAllowedCategories(agentName: string): string[];
+/**
+ * 根据 agent 的 5 维权限推导工具限制。
+ * 结果会被 memoize 以避免重复计算。
+ */
+export declare function deriveToolRestrictions(agentName: string): Record<string, boolean>;
 /**
  * 检查父 agent 是否可以委派给目标 agent。
  *
@@ -35,3 +48,8 @@ export declare function getAllowedCategories(agentName: string): string[];
  * 3. 如果父 agent 是只读（canWriteFiles: false），目标 agent 也必须是只读（canWriteFiles: false）
  */
 export declare function canDelegateTo(parentAgent: string, targetAgent: string, category?: string): boolean;
+/**
+ * 根据 agent 的 5 维权限推导 SDK permission 配置。
+ * 结果会被 memoize 以避免重复计算。
+ */
+export declare function deriveSdkPermission(agentName: string): Record<string, "allow" | "deny">;

package/dist/shared/agent-tool-restrictions.d.ts

@@ -1,7 +1,5 @@
 /**
  * Agent tool restrictions for session.prompt calls.
- * OpenCode SDK's session.prompt `tools` parameter expects boolean values.
- * true = tool allowed, false = tool denied.
+ * Delegates to deriveToolRestrictions() from the unified permissions system.
  */
 export declare function getAgentToolRestrictions(agentName: string): Record<string, boolean>;
-export declare function hasAgentToolRestrictions(agentName: string): boolean;

package/dist/shared/index.d.ts

@@ -24,6 +24,7 @@ export * from "./agent-variant";
 export * from "./session-cursor";
 export * from "./shell-env";
 export * from "./system-directive";
+export * from "./agent-permissions";
 export * from "./agent-tool-restrictions";
 export * from "./model-requirements";
 export * from "./model-resolver";

package/dist/shared/migration.d.ts

@@ -1,4 +1,13 @@
 export declare const AGENT_NAME_MAP: Record<string, string>;
+/**
+ * 内置 agent 名称集合（用于配置迁移判定）。
+ * 与 ALL_DEFINED_AGENTS（src/shared/agent-permissions.ts）的关系：
+ * - 重叠：主执行官、技术参谋、知识典藏、深度探索、媒体解析、预审顾问、计划审查、战略参谋、任务编排
+ * - ALL_DEFINED_AGENTS 多出："BTW 顾问"、"执行助理"（不在 BUILTIN_AGENT_NAMES 中）
+ * - BUILTIN_AGENT_NAMES 多出："build"（不是 agent，是 OpenCode-Builder 的配置键）
+ *
+ * 添加新 agent 时，需要同时更新 DEFAULT_AGENT_PERMISSIONS 和此集合。
+ */
 export declare const BUILTIN_AGENT_NAMES: Set<string>;
 export declare const HOOK_NAME_MAP: Record<string, string | null>;
 /**

package/dist/tools/session-manager/constants.d.ts

@@ -4,9 +4,9 @@ export declare const PART_STORAGE: string;
 export declare const SESSION_STORAGE: string;
 export declare const TODO_DIR: string;
 export declare const TRANSCRIPT_DIR: string;
-export declare const SESSION_LIST_DESCRIPTION = "\u5217\u51FA\u6240\u6709 OpenCode session\uFF0C\u652F\u6301\u53EF\u9009\u8FC7\u6EE4\u3002\n\n\u8FD4\u56DE\u53EF\u7528\u7684 session ID \u5217\u8868\uFF0C\u5305\u542B\u6D88\u606F\u6570\u91CF\u3001\u65E5\u671F\u8303\u56F4\u548C\u4F7F\u7528\u8FC7\u7684 agents \u7B49\u5143\u6570\u636E\u3002\n\n\u53C2\u6570\uFF1A\n- limit\uFF08\u53EF\u9009\uFF09\uFF1A\u6700\u5927\u8FD4\u56DE session \u6570\u91CF\n- from_date\uFF08\u53EF\u9009\uFF09\uFF1A\u8FC7\u6EE4\u6B64\u65E5\u671F\u4E4B\u540E\u7684 session\uFF08ISO 8601 \u683C\u5F0F\uFF09\n- to_date\uFF08\u53EF\u9009\uFF09\uFF1A\u8FC7\u6EE4\u6B64\u65E5\u671F\u4E4B\u524D\u7684 session\uFF08ISO 8601 \u683C\u5F0F\uFF09\n\n\u8F93\u51FA\u793A\u4F8B\uFF1A\n| Session ID | Messages | First | Last | Agents |\n|------------|----------|-------|------|--------|\n| ses_abc123 | 45 | 2025-12-20 | 2025-12-24 | build, \u6280\u672F\u53C2\u8C0B |\n| ses_def456 | 12 | 2025-12-19 | 2025-12-19 | build |";
+export declare const SESSION_LIST_DESCRIPTION = "\u5217\u51FA\u6240\u6709 OpenCode session\uFF0C\u652F\u6301\u53EF\u9009\u8FC7\u6EE4\u3002\n\n\u8FD4\u56DE\u53EF\u7528\u7684 session ID \u5217\u8868\uFF0C\u5305\u542B\u6D88\u606F\u6570\u91CF\u3001\u65E5\u671F\u8303\u56F4\u548C\u4F7F\u7528\u8FC7\u7684 agents \u7B49\u5143\u6570\u636E\u3002\n\n\u53C2\u6570\uFF1A\n- limit\uFF08\u53EF\u9009\uFF09\uFF1A\u6700\u5927\u8FD4\u56DE session \u6570\u91CF\n- from_date\uFF08\u53EF\u9009\uFF09\uFF1A\u8FC7\u6EE4\u6B64\u65E5\u671F\u4E4B\u540E\u7684 session\uFF08ISO 8601 \u683C\u5F0F\uFF09\n- to_date\uFF08\u53EF\u9009\uFF09\uFF1A\u8FC7\u6EE4\u6B64\u65E5\u671F\u4E4B\u524D\u7684 session\uFF08ISO 8601 \u683C\u5F0F\uFF09\n\n\u8F93\u51FA\u793A\u4F8B\uFF1A\n| Session ID | \u6807\u9898 | Messages | First | Last | Agents |\n|------------|------|----------|-------|------|--------|\n| ses_abc123 | \u9879\u76EE\u91CD\u6784 | 45 | 2025-12-20 | 2025-12-24 | build, \u6280\u672F\u53C2\u8C0B |\n| ses_def456 | | 12 | 2025-12-19 | 2025-12-19 | build |";
 export declare const SESSION_READ_DESCRIPTION = "\u8BFB\u53D6 OpenCode session \u4E2D\u7684\u6D88\u606F\u548C\u5386\u53F2\u8BB0\u5F55\u3002\n\n\u8FD4\u56DE\u683C\u5F0F\u5316\u7684 session \u6D88\u606F\u89C6\u56FE\uFF0C\u5305\u542B\u89D2\u8272\u3001\u65F6\u95F4\u6233\u548C\u5185\u5BB9\u3002\u53EF\u9009\u62E9\u5305\u542B todo \u548C transcript \u6570\u636E\u3002\n\n\u53C2\u6570\uFF1A\n- session_id\uFF08\u5FC5\u586B\uFF09\uFF1A\u8981\u8BFB\u53D6\u7684 Session ID\n- include_todos\uFF08\u53EF\u9009\uFF09\uFF1A\u5305\u542B todo \u5217\u8868\uFF08\u5982\u679C\u6709\u7684\u8BDD\uFF09\uFF08\u9ED8\u8BA4\u503C: false\uFF09\n- include_transcript\uFF08\u53EF\u9009\uFF09\uFF1A\u5305\u542B transcript \u65E5\u5FD7\uFF08\u5982\u679C\u6709\u7684\u8BDD\uFF09\uFF08\u9ED8\u8BA4\u503C: false\uFF09\n- limit\uFF08\u53EF\u9009\uFF09\uFF1A\u6700\u5927\u8FD4\u56DE\u6D88\u606F\u6570\u91CF\uFF08\u9ED8\u8BA4\u503C: \u5168\u90E8\uFF09\n\n\u8F93\u51FA\u793A\u4F8B\uFF1A\nSession: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 to 2025-12-24\n\n[Message 1] user (2025-12-20 10:30:00)\nHello, can you help me with...\n\n[Message 2] assistant (2025-12-20 10:30:15)\nOf course! Let me help you with...";
 export declare const SESSION_SEARCH_DESCRIPTION = "\u5728 OpenCode session \u6D88\u606F\u4E2D\u641C\u7D22\u5185\u5BB9\u3002\n\n\u5BF9 session \u6D88\u606F\u6267\u884C\u5168\u6587\u641C\u7D22\uFF0C\u8FD4\u56DE\u5339\u914D\u7684\u6458\u8981\u53CA\u4E0A\u4E0B\u6587\u3002\n\n\u53C2\u6570\uFF1A\n- query\uFF08\u5FC5\u586B\uFF09\uFF1A\u641C\u7D22\u67E5\u8BE2\u5B57\u7B26\u4E32\n- session_id\uFF08\u53EF\u9009\uFF09\uFF1A\u4EC5\u5728\u6307\u5B9A session \u4E2D\u641C\u7D22\uFF08\u9ED8\u8BA4\u503C: \u5168\u90E8 session\uFF09\n- case_sensitive\uFF08\u53EF\u9009\uFF09\uFF1A\u533A\u5206\u5927\u5C0F\u5199\u641C\u7D22\uFF08\u9ED8\u8BA4\u503C: false\uFF09\n- limit\uFF08\u53EF\u9009\uFF09\uFF1A\u6700\u5927\u8FD4\u56DE\u7ED3\u679C\u6570\u91CF\uFF08\u9ED8\u8BA4\u503C: 20\uFF09\n\n\u8F93\u51FA\u793A\u4F8B\uFF1A\n\u5728 2 \u4E2A session \u4E2D\u627E\u5230 3 \u6761\u5339\u914D\uFF1A\n\n[ses_abc123] Message msg_001 (user)\n...implement the **session manager** tool...\n\n[ses_abc123] Message msg_005 (assistant)\n...I'll create a **session manager** with full search...\n\n[ses_def456] Message msg_012 (user)\n...use the **session manager** to find...";
-export declare const SESSION_INFO_DESCRIPTION = "\u83B7\u53D6 OpenCode session \u7684\u5143\u6570\u636E\u548C\u7EDF\u8BA1\u4FE1\u606F\u3002\n\n\u8FD4\u56DE session \u7684\u8BE6\u7EC6\u4FE1\u606F\uFF0C\u5305\u62EC\u6D88\u606F\u6570\u91CF\u3001\u65E5\u671F\u8303\u56F4\u3001\u4F7F\u7528\u8FC7\u7684 agents \u548C\u53EF\u7528\u7684\u6570\u636E\u6E90\u3002\n\n\u53C2\u6570\uFF1A\n- session_id\uFF08\u5FC5\u586B\uFF09\uFF1A\u8981\u67E5\u770B\u7684 Session ID\n\n\u8F93\u51FA\u793A\u4F8B\uFF1A\nSession ID: ses_abc123\nMessages: 45\nDate Range: 2025-12-20 10:30:00 to 2025-12-24 15:45:30\nDuration: 4 days, 5 hours\nAgents Used: build, \u6280\u672F\u53C2\u8C0B, librarian\nHas Todos: Yes (12 items, 8 completed)\nHas Transcript: Yes (234 entries)";
+export declare const SESSION_INFO_DESCRIPTION = "\u83B7\u53D6 OpenCode session \u7684\u5143\u6570\u636E\u548C\u7EDF\u8BA1\u4FE1\u606F\u3002\n\n\u8FD4\u56DE session \u7684\u8BE6\u7EC6\u4FE1\u606F\uFF0C\u5305\u62EC\u6D88\u606F\u6570\u91CF\u3001\u65E5\u671F\u8303\u56F4\u3001\u4F7F\u7528\u8FC7\u7684 agents \u548C\u53EF\u7528\u7684\u6570\u636E\u6E90\u3002\n\n\u53C2\u6570\uFF1A\n- session_id\uFF08\u5FC5\u586B\uFF09\uFF1A\u8981\u67E5\u770B\u7684 Session ID\n\n\u8F93\u51FA\u793A\u4F8B\uFF1A\nSession ID: ses_abc123\nTitle: \u9879\u76EE\u91CD\u6784\nMessages: 45\nDate Range: 2025-12-20 10:30:00 to 2025-12-24 15:45:30\nDuration: 4 days, 5 hours\nAgents Used: build, \u6280\u672F\u53C2\u8C0B, librarian\nHas Todos: Yes (12 items, 8 completed)\nHas Transcript: Yes (234 entries)";
 export declare const SESSION_DELETE_DESCRIPTION = "\u5220\u9664 OpenCode session \u53CA\u5176\u6240\u6709\u5173\u8054\u6570\u636E\u3002\n\n\u5220\u9664 session \u7684\u6D88\u606F\u3001parts\u3001todos \u548C transcript\u3002\u6B64\u64CD\u4F5C\u65E0\u6CD5\u64A4\u9500\u3002\n\n\u53C2\u6570\uFF1A\n- session_id\uFF08\u5FC5\u586B\uFF09\uFF1A\u8981\u5220\u9664\u7684 Session ID\n- confirm\uFF08\u5FC5\u586B\uFF09\uFF1A\u5FC5\u987B\u4E3A true \u624D\u80FD\u786E\u8BA4\u5220\u9664\n\n\u793A\u4F8B\uFF1A\nsession_delete(session_id=\"ses_abc123\", confirm=true)\nSuccessfully deleted session ses_abc123";
 export declare const TOOL_NAME_PREFIX = "session_";

package/dist/tools/session-manager/types.d.ts

@@ -29,6 +29,7 @@ export interface SessionInfo {
     has_transcript: boolean;
     todos?: TodoItem[];
     transcript_entries?: number;
+    title?: string;
 }
 export interface TodoItem {
     id: string;

package/dist/tools/session-manager/utils.d.ts

@@ -1,5 +1,5 @@
-import type { SessionInfo, SessionMessage, SearchResult } from "./types";
-export declare function formatSessionList(sessionIDs: string[]): Promise<string>;
+import type { SessionInfo, SessionMessage, SessionMetadata, SearchResult } from "./types";
+export declare function formatSessionList(sessions: SessionMetadata[]): Promise<string>;
 export declare function formatSessionMessages(messages: SessionMessage[], includeTodos?: boolean, todos?: Array<{
     id: string;
     content: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skj1724/oh-my-opencode",
-  "version": "4.0.01",
+  "version": "4.0.04",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",