Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(plugin): 将卡片停用限定到当前插件
liugaoweia57fd37fed12
diff --git a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.mdindex d833ad3485..7e9a207a48 100644--- a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md+++ b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-agent-tasks.md@@ -214,7 +214,7 @@ const r = await cindy.agent.requestSchedule({- `list({targetKind:'project'|'task'|'bot'})`:返回 `{targets:[{kind,id,label,detail}]}`,只含本机可用目标的名称和目录/说明,不含消息历史。插件可自行搜索和展示列表,最近活动只用于排序。- `resolve({target:{kind,id}})`:复核已保存或本次选择的目标,返回最新 `{kind,id,label,detail}`。只查询,不创建任务、不打开 UI、不保存绑定;固定目标失效返回 TARGET_UNAVAILABLE,不自动替换。插件可将 `{kind,id}` 存入自己的配置。project 的 id 是 Cindy 已有项目目录,task/bot 的 id 是任务/伙伴标识。-- `send({target:{kind,id},requestKey,text,context?,title?,autoTitle?,route?,permissionMode?,delivery?,attachments?})`:直接指定目标,Host 当次复核。project 在目录中新建普通任务,可传统一模型目录的 route 和本次 permissionMode;task/bot 沿用接收方模型、权限、目录,不接受 route 或 permissionMode。`delivery` 为 `queue | steer`,缺省 queue;project 不接受 steer。steer 尝试同轮注入,不停止当前轮,空闲或插话暂不可用时入队。返回 `{taskId,accepted:true,delivery:"queue"|"steer"}` 表示实际接受路径,不表示执行完成。筛查拒绝返回 DELIVERY_REJECTED,不入队重试;ACK 未知返回 DELIVERY_UNCERTAIN,不得换键重发。不开放读取任意任务历史或改模。+- `send({target:{kind,id},requestKey,text,context?,title?,autoTitle?,route?,permissionMode?,delivery?,attachments?})`:直接指定目标,Host 当次复核。project 在目录中新建普通任务,可传统一模型目录的 route 和已授权范围内的 permissionMode;task/bot 沿用接收方模型、权限、目录,不接受 route 或 permissionMode。`delivery` 为 `queue | steer`,缺省 queue;project 不接受 steer。steer 尝试同轮注入,不停止当前轮,空闲或插话暂不可用时入队。返回 `{taskId,accepted:true,delivery:"queue"|"steer"}` 表示实际接受路径,不表示执行完成。筛查拒绝返回 DELIVERY_REJECTED,不入队重试;ACK 未知返回 DELIVERY_UNCERTAIN,不得换键重发。不开放读取任意任务历史或改模。- 同一次 send 重试沿用相同 requestKey、target、内容和 delivery(缺省与 queue 等价);同键参数变化返回 REQUEST_KEY_CONFLICT。Host 在执行前持久保留投递回执,重启后已接受的请求返回原结果,未确定结果的请求返回 DELIVERY_UNCERTAIN,不再次创建或投递。回执不保存正文或附件字节。不要通过更换 requestKey 绕过未知结果,应先让用户在 Cindy 检查。- `cancel({requestKey})`:使本次请求及迟到的发送失效,仅撤回本插件该请求尚未执行的输入;不会停止接收方其他输入,也不保证撤销已经开始的工作。新操作使用新的 requestKey。- `tasks.send` 和 `targets.send` 均支持可选 `attachments:[{base64,name?}]`:只接收插件提供的图片字节,不接受本机路径、URL、媒体 URI 或自报 MIME。Host 检测 PNG/JPEG/WebP,最多 4 张、合计 20 MiB。先检查 `tasks.capabilities().messageAttachments.kinds` 包含 image;旧客户端不支持时停止,不静默丢图或改投临时路径。截图进既有 cindy-media,作为消息附件展示并进入模型输入;不需要额外声明 media.deposit。附件内容及名称参与幂等签名,更换附件不能复用同键。@@ -257,16 +257,17 @@ text 与 context 合计不超过 64000;tasks.send 的 text 上限仍为 32768### 新建任务的权限选择(可选)-先检查 `tasks.capabilities().createPermissionMode === true`。Host 已批准任务能力后,`tasks.create` 和-project 的 `targets.send` 可传 `permissionMode: 'ask' | 'auto' | 'bypassPermissions'`,对应默认权限、自动审批、完全访问。-仅决定这一个新任务,不修改插件默认设置。省略时使用启用卡片的默认值,否则为 ask。+先检查 `tasks.capabilities().createPermissionMode === true`。`tasks.create` 和 project 的+`targets.send` 可传 `permissionMode: 'ask' | 'auto' | 'bypassPermissions'`,对应默认权限、自动审批、完全访问。+参数仅决定新任务,不写插件默认配置;已有 task/bot 不接受该参数。-默认卡不是授权上限。每个插件自行声明 `showTaskPreferences:false` 后,其旧模型、目录和权限配置不再读取,-不影响其它插件。Host 仍在创建、异步准备、投递和排队接受前复核能力批准、账号、任务归属与 Session/Plan。-既有 `requestWriteAccess` 仍只支持 acceptEdits/auto,确认只修改目标 Session,不改默认卡或其它任务。-历史 plan/acceptEdits 配置保留,但不是新参数选项。不接受自报 confirmed;Plan Mode 不是此参数的权限档位。-已有 task/bot 不接受 permissionMode,也不改变接收方权限。同键改变权限仍返回冲突错误,省略字段的旧请求可重放。-旧 Host 未宣告支持时不发送新参数;依赖隐藏后解耦的插件须使用实现此契约的 Host。+启用默认卡时保留权限上限:ask 允许 ask,auto 允许 ask/auto,bypassPermissions 允许三档;+超出返回 PERMISSION_DENIED,省略沿用设置。历史 plan/acceptEdits 保留,但不是新参数选项。+本插件声明 `showTaskPreferences:false` 时,其卡片配置完全无效,不作为上限;插件自行传参,未传为 ask。+包括完全访问在内均按插件参数执行,不增加独立权限上限或逐次宿主确认。+此选择不影响其它插件或全局设置。两类都须 Host 批准任务能力,并在创建、投递及排队接受时复核归属和 Session/Plan。+既有 requestWriteAccess 仅支持 acceptEdits/auto;启用卡片保留原写回规则,隐藏时只改目标 Session。+不接受自报 confirmed。权限参与幂等摘要,同键修改返回冲突;缺省旧请求可重放,旧 Host 未声明支持时不发新参数。原有 `cindy.tasks` 的归属限制不变。先调用 `capabilities()` 获取实际支持操作。当前仅支持本插件创建的本机普通任务:`models`、`create`、`get`、`setModel`、`list`、`send`、`getRun`、`listRuns`、`readMessages`、`cancel`、`setHidden`。@@ -280,13 +281,13 @@ project 的 `targets.send` 可传 `permissionMode: 'ask' | 'auto' | 'bypassPermi卸载会撤销插件后续 API 控制,但不保证停止已派发的原生工作;需要停止时请使用任务停止入口。计划须在首次派发或创建 Worker 前登记,之后不可改写(包括补填 task);需要不同范围时创建新任务。缺少该字段的存量计划继续可读,但 Host 不允许插件任务自动授权或普通 MCP 快捷放行,不会从 Agent 消息推导额外授权;进入 Host 的 Ask/acceptEdits 动作仍可沿原流程逐次确认。-计划不授予目录权限。Worker 仅可使用宿主任务目录及解析后仍在其中的子目录或用户亲选的确切目录;Library 绑定不自动变成 Agent 工作根。宿主在登记和创建时均复核。+计划不授予目录权限。Worker 仅可使用宿主任务目录及解析后仍在其中的子目录、启用卡片时的插件配置目录或用户亲选的确切目录;Library 绑定不自动变成 Agent 工作根。宿主在登记和创建时均复核。插件自有主任务不支持用 `execution_device_id` 新建跨设备 Worker;本机目录授权不代表已授权另一台电脑的同名目录,登记团队计划也不改变此限制。这描述准入检查,不是持续的 OS 目录隔离保证。首版用于可信本地工作区;同权限进程在检查后恶意置换目录对象仍可能改变实际 cwd,不提供此类对抗性沙箱。`models()` 返回统一目录可选项的完整 route、efforts 和 supportsFastMode。用户明确选择后将 route 原样传给 create,或用 `setModel({taskId, expectedRevision, route})` 修改已有自有任务。运行中按普通任务的安全边界切换,不修改应用默认。两方法使用前检查 capabilities.operations。当 `capabilities().pluginDefaultModel === true` 时,持续复用任务的插件可在每次新输入前调用-`setModel({taskId, expectedRevision, route:'plugin-default'})`。Host 当次读取本插件有效的任务模型默认值(隐藏卡片时忽略旧值),+`setModel({taskId, expectedRevision, route:'plugin-default'})`。Host 当次读取本插件有效的任务模型设置(隐藏卡片时忽略旧值),复用 create 的模型解析规则(未指定时采用当前新任务选择),只同步模型、来源、引擎、强度和 Fast,不改权限、目录或其它任务。返回 `{status,task}`;配置相同返回 unchanged,不反复切换。后续 send 使用返回 task.revision。须先处理已接受/结果不确定的旧请求,再同步下一次输入,@@ -341,9 +342,10 @@ create/send 的 requestKey 持久去重;同键不同内容拒绝。删除后新字段需该能力为 true 才发送,旧客户端不能假定支持;同 requestKey 的重放保留原创建结果。来源/模型/强度必须当前可用,派发前再次核对;失败引导改选或修复连接,不自动换模型或账号。已有普通任务保留自身配置,用户在任务内修复后继续使用原任务。-工作目录由宿主分配,或沿用启用默认卡时用户已选择的目录;不接受任意路径。-权限使用显式参数或有效默认值,缺省 ask;不继承发起任务权限。Host 能力批准与 Session 执行权限独立校验。-工作区行为及询问规则与所选 Agent 的普通任务一致。已有任务和历史 plan/acceptEdits 值不自动改权。+工作目录由宿主分配,或沿用已启用卡片中的配置目录;不接受任意路径。+启用卡片时权限上限来自该插件设置,可在范围内选择本次权限;隐藏时不读卡片,由插件创建参数决定。+省略参数沿用有效设置,缺省 ask。工作区行为及询问规则与所选 Agent 的普通任务一致,+不继承发起任务的权限。既有任务与显式历史 plan/acceptEdits 配置保留原行为,不自动提权;需要改变时由用户选择。create 可传 `isolatedWorkspace:true`,使用宿主为该任务生成的独立空目录,忽略插件的项目目录偏好。返回 workingDir 仅属于本插件创建的任务,可交给插件 Node 进程放入候选项目;不接受插件自报任意目录。任务视图同时返回 permissionMode;按实际权限展示,不将历史 plan 值视作跨 Agent 的只读保证,不能暗中升级权限。diff --git a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.mdindex a481c3f4c6..459eaa76ca 100644--- a/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md+++ b/apps/desktop/resources/system-skills/cindy-plugin-creator/references/plugin-settings.md@@ -12,7 +12,8 @@**宿主默认配置卡(可选)**:每个插件在自己的身份卡声明 `showTaskPreferences`,只接受布尔值。省略或声明 `"showTaskPreferences": true` 时,符合能力条件的插件继续显示并使用自己的「模型与任务」默认卡。声明 `"showTaskPreferences": false` 隐藏该插件在 Desktop 和手机上的卡片,且不读取其旧模型、目录、权限配置;其它插件不受影响。-旧值保留,重新启用后恢复。插件自行维护配置并通过任务参数传入;默认卡不是宿主授权上限。+旧值保留,重新启用后恢复原有配置与执行规则。隐藏时由插件自行维护配置并通过任务参数传入;不影响全局设置。+隐藏插件的新任务权限按参数执行,包括完全访问;不增加独立权限上限或逐次宿主确认。Host 仍独立检查能力批准、任务归属、目录和任务当前权限,隐藏字段本身不授予能力。旧 Host 可能只隐藏 UI 而继续使用配置;依赖解耦行为须使用实现此契约的客户端版本。diff --git a/apps/desktop/src/main/cindy-brain/__tests__/ghostUserDataRelocation.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/ghostUserDataRelocation.test.tsindex 4d8d50406e..793178fb95 100644--- a/apps/desktop/src/main/cindy-brain/__tests__/ghostUserDataRelocation.test.ts+++ b/apps/desktop/src/main/cindy-brain/__tests__/ghostUserDataRelocation.test.ts@@ -191,7 +191,7 @@ it('completes source replacement and another plugin uninstall without reversingawait seedSourceResources();const archive = '_ns__cindy-archive-00000000-0000-4000-8000-000000000002__helper';const service = createPluginTaskService({- store: tasks, assertCurrent: () => {}, assertAuthorized: vi.fn(),+ store: tasks, assertCurrent: () => {}, assertAuthorized: vi.fn(), readPermissionMode: vi.fn(),readModelPreference: vi.fn(), resolveRoute: vi.fn(), createSession: vi.fn(), readSession: vi.fn(), readLiveSession: vi.fn(),dispatch: vi.fn(), inspect: vi.fn(), cancel: vi.fn(),});diff --git a/apps/desktop/src/main/cindy-brain/__tests__/pluginModelPrefsIpc.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/pluginModelPrefsIpc.test.tsindex d366964c92..da39daad73 100644--- a/apps/desktop/src/main/cindy-brain/__tests__/pluginModelPrefsIpc.test.ts+++ b/apps/desktop/src/main/cindy-brain/__tests__/pluginModelPrefsIpc.test.ts@@ -59,7 +59,7 @@ describe('ghosts:errand-prefs (plugin model & tasks)', () => {// unit: invoke the real Host defaults reader; hidden values must never be read,// and opting back in must expose the original saved values without migration.-const createDefaults = createGhostProductionCallbacks<{ getPluginTaskDefaults(id: string): Record<string, unknown> }>({+const createDefaults = createGhostProductionCallbacks<{ getPluginTaskDefaults(id: string): Record<string, unknown> | undefined }>({functions: ['getPluginTaskDefaults'],});it('opts out of every saved default without modifying storage or affecting another plugin', () => {@@ -68,11 +68,11 @@ it('opts out of every saved default without modifying storage or affecting anothlet hidden = true;const api = createDefaults({ readPluginTaskConfig: readConfig, findGhostForInstanceId: (id: string) =>id === 'missing' ? null : ({ manifest: { showTaskPreferences: id === 'hidden' ? !hidden : undefined } }) });- expect(api.getPluginTaskDefaults('hidden')).toEqual({});- expect(api.getPluginTaskDefaults('missing')).toEqual({});+ expect(api.getPluginTaskDefaults('hidden')).toBeUndefined();+ expect(api.getPluginTaskDefaults('missing')).toBeUndefined();expect(readConfig).not.toHaveBeenCalled();configs.hidden.permissionMode = 'ask';- expect(api.getPluginTaskDefaults('hidden')).toEqual({});+ expect(api.getPluginTaskDefaults('hidden')).toBeUndefined();expect(api.getPluginTaskDefaults('visible')).toEqual(configs.visible);hidden = false;expect(api.getPluginTaskDefaults('hidden')).toEqual(configs.hidden);diff --git a/apps/desktop/src/main/cindy-brain/index.ts b/apps/desktop/src/main/cindy-brain/index.tsindex 96f89c6316..976372f1be 100644--- a/apps/desktop/src/main/cindy-brain/index.ts+++ b/apps/desktop/src/main/cindy-brain/index.ts@@ -2207,11 +2207,11 @@ export function pluginTargetAuthorizationRevision(id: string): string | null {return hasPluginTargetApproval(ghost) ? pluginTaskAuthorizationRevision(id) : null;}-// Runtime defaults are separate from Host capability approval. Hidden settings-// stay on disk for the settings UI, but must not participate in any operation.+// Undefined means this plugin opted out of its Host task card. Saved settings+// remain on disk, but are neither read nor used for that plugin at runtime.export function getPluginTaskDefaults(id: string) {const ghost = findGhostForInstanceId(id);- return ghost && ghost.manifest.showTaskPreferences !== false ? readPluginTaskConfig(id) : {};+ return ghost && ghost.manifest.showTaskPreferences !== false ? readPluginTaskConfig(id) : undefined;}export function isPluginTaskAuthorized(id: string): boolean {@@ -5157,7 +5157,7 @@ configureProviderMediaRuntime({function getPluginOneshotModelSelection(ghostId: string,): { providerId?: string; agentKind: AgentKind; model: string } | null {- const config = getPluginTaskDefaults(ghostId);+ const config = getPluginTaskDefaults(ghostId) ?? {};if (!config.model) return null;if (!config.agentKind || config.agentKind === 'pi') {// 两种情况按目录解析一条快问快答可路由的 供应商×agent×模型:diff --git a/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts b/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.tsindex cff4406a50..e1399dc2a4 100644--- a/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts+++ b/apps/desktop/src/main/cindy-brain/pluginTaskPrefsStore.ts@@ -1,12 +1,12 @@/*** User preferences for plugin-created ordinary tasks. The legacy errand adapter- * consumes the effective defaults; this store does not grant task authority.+ * consumes these same preferences; it does not own the model/permission policy.* Keep ghost-errand-prefs.json and its `errand`/`sessions` keys for installed-plugin* compatibility. `sessions` belongs only to the old errand sessionKey adapter.* Empty model preferences use the originating task or the current new-task route.* New ordinary tasks use ask; the legacy adapter retains its historical default.- * Hidden cards retain their saved values but provide no runtime defaults.- * Host capability approval and Session permissions are independent of this store.+ * Permissions stay independently user-owned, never caller-inherited.+ * A plugin that hides its Host task card does not read or use this store at runtime.* Model admission belongs to the shared ordinary-session resolver, never this store.* The same model fields are the plugin's single "model" preference: Cindy quick* answers (cindy.text.oneshot) use them too; empty = the system auxiliary model.@@ -29,7 +29,7 @@ import {readLegacyOneshotPins,} from './cindyPrefsStore.js';-/** Normalize a creation default, not an authorization ceiling. */+/** User-owned plugin task permission policy. A model source never grants authority. */export function clampPluginTaskPermissionMode(value: unknown, fallback: GhostErrandPermissionMode = 'ask'): GhostErrandPermissionMode {return typeof value === 'string' && (GHOST_ERRAND_PERMISSION_MODES as readonly string[]).includes(value)? value as GhostErrandPermissionMode : fallback;diff --git a/apps/desktop/src/main/maker-ipc/__tests__/orcaWorkerCreationService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/orcaWorkerCreationService.test.tsindex 5b5110daeb..f3e13b93ec 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/orcaWorkerCreationService.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/orcaWorkerCreationService.test.ts@@ -50,15 +50,15 @@ describe('Host provenance across Orca creation waits', () => {};function setup(action: Action, phase: string, change: string, entry = 'task') {let epoch = { client: {} }, enabled = true;- const directoryCase = ['lead-directory', 'pick'].includes(change);+ const directoryCase = ['config', 'pick'].includes(change);const candidate = path.resolve('synthetic-worker');- let picked = change === 'pick';+ let configured = change === 'config' ? candidate : undefined, picked = change === 'pick';let directoryResolved = false, directoryReads = 0;let queuedAcceptance: (() => void | Promise<void>) | undefined;let receipt: { operation: string; pluginId: string; payload: string } | null = change === 'ordinary' ? null : {operation: 'create', pluginId: 'plugin', payload: JSON.stringify({ ownershipRevoked: change === 'already-revoked' }),};- const task = { revision: 1, status: 'active', permissionMode: 'auto', planModeEnabled: false, workingDir: change === 'lead-directory' ? candidate : path.resolve('synthetic-project') };+ const task = { revision: 1, status: 'active', permissionMode: 'auto', planModeEnabled: false, workingDir: path.resolve('synthetic-project') };const mutate = (point: string) => {if (point !== phase) return;if (change === 'uninstalled' || change === 'reinstalled') {@@ -70,7 +70,7 @@ describe('Host provenance across Orca creation waits', () => {else if (change === 'plan') task.planModeEnabled = true;else if (change === 'archived') task.status = 'archived';else if (change === 'disabled') enabled = false;- else if (change === 'lead-directory') task.workingDir = path.resolve('other-project');+ else if (change === 'config') configured = undefined;else if (change === 'pick') picked = false;};const bindings = {@@ -86,10 +86,10 @@ describe('Host provenance across Orca creation waits', () => {if (!receipt || receipt.pluginId !== pluginId || JSON.parse(receipt.payload).ownershipRevoked) throw new PluginTaskError('TASK_NOT_FOUND', 'Revoked');return { ...task };} }),- isPluginTaskAuthorized: () => enabled, getPluginTaskDefaults: () => ({ permissionMode: 'auto', workingDir: candidate }),+ isPluginTaskAuthorized: () => enabled, getPluginTaskDefaults: () => change === 'hidden-card' ? undefined : ({ permissionMode: 'auto', workingDir: directoryCase ? configured : task.workingDir }),resolvePluginWorkerDirectory: vi.fn(async () => {directoryResolved = true; directoryReads = 0;- if (directoryCase && task.workingDir !== candidate && !picked) throw new PluginTaskError('PERMISSION_DENIED', 'Directory revoked');+ if (directoryCase && !configured && !picked) throw new PluginTaskError('PERMISSION_DENIED', 'Directory revoked');return directoryCase ? candidate : task.workingDir;}), isGhostPickedDir: () => picked,};@@ -154,6 +154,18 @@ describe('Host provenance across Orca creation waits', () => {} };}+ // unit: opting out removes only this plugin's card from native Worker admission.+ // Enabled-card config/pick revocation cases keep their original behavior.+ it.each(['createWorker', 'enableTeam', 'startNew', 'startExisting'] as const)(+ 'runs %s with a hidden plugin card', async action => {+ const { run, deps, lifecycleDeps } = setup(action, '', 'hidden-card');+ await expect(run()).resolves.toMatchObject({ ok: true });+ expect(lifecycleDeps.setWorkerPermissionMode).not.toHaveBeenCalled();+ if (action === 'createWorker' || action === 'enableTeam')+ expect(deps.bootstrapSession).toHaveBeenCalledWith(expect.objectContaining({ permissionMode: 'auto' }));+ },+ );+function wireRemoteCreation(deps: OrcaWorkerCreationDeps) {deps.openRemoteWorker = vi.fn(async (input: Parameters<NonNullable<OrcaWorkerCreationDeps['openRemoteWorker']>>[0]) => ({ok: true as const, proxySessionId: 'remote-proxy', remoteSessionId: 'remote-session',@@ -234,8 +246,8 @@ describe('Host provenance across Orca creation waits', () => {['owner', 'missing', 'ask', 'plan', 'archived', 'disabled'].map(change => ({ action, phase: 'bootstrap', change }))));cases.push(...(['createWorker', 'enableTeam'] as Action[]).flatMap(action =>['worker-write', 'role-write', 'release', 'final-task', 'final-source', ...(action === 'enableTeam' ? ['lead-activation'] : [])].flatMap(phase =>- ['lead-directory', 'pick'].map(change => ({ action, phase, change })))));- it.each((['createWorker', 'enableTeam'] as const).flatMap(action => ['lead-directory', 'pick'].flatMap(change => ['', 'accepted'].map(phase => ({ action, change, phase }))))) (+ ['config', 'pick'].map(change => ({ action, phase, change })))));+ it.each((['createWorker', 'enableTeam'] as const).flatMap(action => ['config', 'pick'].flatMap(change => ['', 'accepted'].map(phase => ({ action, change, phase }))))) ('retains $action $change directory authority after the queued reply: $phase', async ({ action, change, phase }) => {const { run, acceptQueued, deps, lifecycleDeps } = setup(action, phase, change, 'queued');expect(await run()).toMatchObject({ ok: true, dispatched: false });@@ -266,7 +278,7 @@ describe('Host provenance across Orca creation waits', () => {});it.each((['createWorker', 'enableTeam'] as const).flatMap(action =>(action === 'createWorker' ? ['task', 'placeholder'] : ['task', 'placeholder', 'deferred']).flatMap(entry =>- ['lead-directory', 'pick'].flatMap(change => ['', 'accepted'].map(phase => ({ action, entry, change, phase }))))))(+ ['config', 'pick'].flatMap(change => ['', 'accepted'].map(phase => ({ action, entry, change, phase }))))))('retains resolved scope until $action $entry acceptance: $change $phase', async ({ action, entry, change, phase }) => {const { run, deps, lifecycleDeps } = setup(action, phase, change, entry);const result = await run();@@ -3656,7 +3668,7 @@ describe('production plugin Auto admission after reservation', () => {let receiptReads = 0;let reservedTaskReads = 0;const epoch = { client: {} };- const revoke = () => { enabled = false; };+ const revoke = () => { mode = 'acceptEdits'; };const task = () => ({ revision: 1, status: taskStatus, permissionMode: taskMode, planModeEnabled, workingDir: path.resolve('repo') });const planItem = { label: 'sample', workingDir: path.resolve(point === 'canonical-directory' ? 'alias' : point === 'different-directory' ? 'other' : 'repo'), route: { agentKind: 'codex', model: 'gpt-5.5', providerId: 'xd', effort: 'medium', fastMode: point === 'normalized-fast' } };const payload = () => JSON.stringify(planned ? { teamPlan: { concurrency: 2, items: [planItem] }, settledLabels: point === 'settled-label' ? ['sample'] : [] } : {});diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginReviewSnapshotFreshness.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginReviewSnapshotFreshness.test.tsindex 38045bbe83..2810e97c3e 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginReviewSnapshotFreshness.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginReviewSnapshotFreshness.test.ts@@ -66,7 +66,7 @@ function fixture() {module.exports.run(db);resolvePath.mockReset().mockResolvedValue('/answer');const control = { phase: '', mutate: () => {}, storageUnavailable: false,- accountChanged: false, ownershipValid: true, authorized: true, approvalRevision: 'install' as string | null, permissionMode: 'auto' };+ accountChanged: false, ownershipValid: true, authorized: true, approvalRevision: 'install' as string | null, usesDefaults: true, permissionMode: 'auto' };const mutate=(at:string)=>{if(control.phase===at)control.mutate();};const epoch={userId:'owner',clientEpoch:1,client:{drizzle:drizzle(db),tx:async(_name:string,args:unknown)=>{const projection=readAutoReviewProjectionTransaction(db,args);mutate('projection');return projection;},@@ -80,7 +80,7 @@ function fixture() {getCurrentDbClientSnapshot:()=>control.accountChanged ? null : epoch,sessions,orcaWorkers,orcaTeams,eq,fastModeToStorage,createPluginTaskStore:()=>({get:async()=>db.prepare('SELECT id,target_id AS targetId,plugin_id AS pluginId,operation,payload,revision FROM plugin_task_requests').get()}),drainPersistQueue:async()=>mutate('drain'),pluginTaskServiceForCurrentOwner:()=>({get:async()=>{mutate('ownership');if(!control.ownershipValid)throw Error('ownership revoked');}}),- getPluginTaskDefaults:()=>({permissionMode:control.permissionMode}),readPluginTaskPlanReceipt,+ getPluginTaskDefaults:()=>control.usesDefaults ? ({permissionMode:control.permissionMode}) : undefined,readPluginTaskPlanReceipt,pluginTaskAuthorizationRevision:()=>control.approvalRevision,isPluginTaskAuthorized:()=>control.authorized,};new Function(...Object.keys(deps),js)(...Object.values(deps));@@ -158,6 +158,7 @@ const duringPathChanges = {ownership: ({control}: ReturnType<typeof fixture>) => {control.ownershipValid=false;},approval: ({control}: ReturnType<typeof fixture>) => {control.authorized=false;},approvalRemoved: ({control}: ReturnType<typeof fixture>) => {control.approvalRevision=null;},+ configAsk: ({control}: ReturnType<typeof fixture>) => {control.permissionMode='default';},account: ({control}: ReturnType<typeof fixture>) => {control.accountChanged=true;},userInstruction: ({db}: ReturnType<typeof fixture>) => db.prepare('INSERT INTO messages VALUES (?,?,?,?,?,?,?,NULL)').run('revoke','worker','revoke','user',JSON.stringify({text:'Do not run'}),1,JSON.stringify({delivery:'turn',autoReviewUserText:'Do not run'})),@@ -193,10 +194,9 @@ it.each(['initial', 'after cached allow'].flatMap(phase => Object.keys(duringPat} finally {f.db.close();}},);-// unit: preferences are not authorization; changing them must not invalidate a-// still-approved task's review. Actual permission/approval revocation stays above.-it('ignores card defaults in Auto authorization and its cache identity', async () => {- const f = fixture();+// unit: hidden defaults must not enter the Auto review authority or cache key.+it('ignores only a hidden card in Auto authorization and its cache identity', async () => {+ const f = fixture(); f.control.usesDefaults = false;try {setPlan(f.db);const before = await f.resolve(request);diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginStartTeamAdmission.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginStartTeamAdmission.test.tsindex 9b824e5196..ed2982f33b 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginStartTeamAdmission.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginStartTeamAdmission.test.ts@@ -14,7 +14,7 @@ const branch = source.slice(source.indexOf(" case 'startTeam': {"), source.const authorization = source.slice(source.indexOf(' const assertPluginWorkerAutoAuthorized ='), source.indexOf(' // Uninstall keeps the historical receipt'));const js = ts.transpileModule(`${authorization}\nreturn async function(pluginId, request) { switch(request.kind) { ${branch} } }`, { compilerOptions: { target: ts.ScriptTarget.ES2022 } }).outputText;-function fixture(initial = 'active', afterConfirmation = initial) {+function fixture(initial = 'active', afterConfirmation = initial, useDefaults = true) {const epoch = {};const task = { taskId: 'task', status: initial, revision: 1, permissionMode: 'auto' };const service = { get: vi.fn(async () => ({ ...task })) };@@ -25,7 +25,7 @@ function fixture(initial = 'active', afterConfirmation = initial) {return create();});const deps = { service, getCurrentDbClientSnapshot: () => epoch, PluginTaskError, assertPluginTaskResult, startOrcaTeamForCaller: start,- isPluginTaskAuthorized: () => true, getPluginTaskDefaults: () => ({ permissionMode: 'auto' }) };+ isPluginTaskAuthorized: () => true, getPluginTaskDefaults: () => useDefaults ? ({ permissionMode: 'auto' }) : undefined };const run = new Function(...Object.keys(deps), js)(...Object.values(deps));return { run: () => run('plugin', { kind: 'startTeam', taskId: 'task' }), start, create };}@@ -41,6 +41,11 @@ describe('plugin team active-task admission', () => {await expect(f.run()).rejects.toMatchObject({ code: 'TASK_BUSY' });expect(f.create).not.toHaveBeenCalled();});+ it('starts an approved task when its plugin has hidden the card', async () => {+ const f = fixture('active', 'active', false);+ await expect(f.run()).resolves.toEqual({ ok: true, teamId: 'team' });+ expect(f.create).toHaveBeenCalledOnce();+ });it('starts a still-active task', async () => {const f = fixture();await expect(f.run()).resolves.toEqual({ ok: true, teamId: 'team' });@@ -171,7 +176,7 @@ describe('plugin team activation uses the native lifecycle compensation', () =>orcaLifecycleService: createOrcaLifecycleService(deps) };const run = new Function(...Object.keys(callbacks), wired)(...Object.values(callbacks));const operation = run('plugin', { kind: 'startTeam', taskId: 'task' });- if (change === 'healthy' || change === 'configuredPermission' || change === 'configuredDirectory') {+ if (change === 'healthy') {await expect(operation).resolves.toMatchObject({ ok: true, teamId: 'team' });expect(teamActive).toBe(true); expect(role).toBe('lead'); expect(vendorActive).toBe(true);expect(epoch).toBe(originalEpoch);diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.tsindex 466ba02705..0400bcd1ab 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts@@ -158,6 +158,7 @@ function fixture() {const live = { instanceId: execution.instanceId, stablePlanModeState: { enabled: false, generation: 0 } };const deps: PluginTaskServiceDeps = {store,+ readPermissionMode: () => 'auto',readModelPreference: () => route,assertAuthorized: () => {if (!current) throw new Error('Owner changed');@@ -212,7 +213,7 @@ const permissionCreatorCode = ts.transpileModule('return (' + permissionCreatorSpermissionCreatorStart + ' createSession: '.length,permissionCreatorSource.indexOf('\n },', permissionCreatorStart) + 8,) + ');', { compilerOptions: { target: ts.ScriptTarget.ES2022 } }).outputText;-function useProductionPermissionCreator(f: ReturnType<typeof fixture>, configured: { permissionMode: string }) {+function useProductionPermissionCreator(f: ReturnType<typeof fixture>, configured: { permissionMode: string }, useDefaults = true) {const snapshot = {};const persist = vi.fn(async (options: { sessionId: string; title: string; permissionMode: string;onPersistenceStarted(): void; shouldContinue(): boolean }) => {@@ -221,18 +222,19 @@ function useProductionPermissionCreator(f: ReturnType<typeof fixture>, configuref.tasks.set(options.sessionId, { taskId: options.sessionId, title: options.title, status: 'active',resolvedConfig: f.route, revision: 1, permissionMode: options.permissionMode });});- const deps = { assertPlugin: () => f.deps.assertAuthorized('p'), getPluginTaskDefaults: () => ({ ...configured }),+ const deps = { assertPlugin: () => {}, getPluginTaskDefaults: () => useDefaults ? ({ ...configured }) : undefined,resolveRoute: (...args: Parameters<typeof f.deps.resolveRoute>) => f.deps.resolveRoute(...args),PluginTaskError, isPluginTaskPermissionAllowed, createPluginTaskSession: persist,clampPluginTaskPermissionMode: (mode: unknown) => mode ?? 'ask', snapshot,getCurrentDbClientSnapshot: () => snapshot, isPluginTaskAuthorized: () => true,};+ f.deps.readPermissionMode = () => useDefaults ? configured.permissionMode : undefined;f.deps.createSession = new Function(...Object.keys(deps), permissionCreatorCode)(...Object.values(deps));return persist;}// unit: new per-create permissions must reach ordinary Session persistence while-// keeping Host approval separate. Previous cases only exercised the default.+// remaining within the user policy. Previous cases only exercised the default.it('persists the chosen creation permission without changing defaults or duplicate requests', async () => {const f = fixture(), configured = { permissionMode: 'bypassPermissions' };const persist = useProductionPermissionCreator(f, configured);@@ -250,31 +252,31 @@ it('persists the chosen creation permission without changing defaults or duplicaexpect(configured).toEqual({ permissionMode: 'bypassPermissions' });});-// unit: task parameters are independent of host defaults; installing/enabling-// tasks is still required. Previously an empty/hidden card capped creation at ask.-it('creates and sends with explicit permission independently of card defaults', async () => {+// unit: a hidden card cannot cap explicit creation, sending or queued acceptance.+// Enabled-card cases below retain their original ceiling and revocation behavior.+it.each(['auto', 'bypassPermissions'] as const)('uses the hidden plugin configuration through %s creation and queued acceptance', async permissionMode => {const f = fixture(), configured = { permissionMode: 'ask' };- useProductionPermissionCreator(f, configured);- const task = await f.service.create('p', { requestKey: 'independent', title: 'Work', permissionMode: 'auto' });+ useProductionPermissionCreator(f, configured, false);+ const task = await f.service.create('p', { requestKey: 'independent', title: 'Work', permissionMode });configured.permissionMode = 'plan';const run = await f.service.send('p', { taskId: task.taskId, expectedRevision: task.revision, requestKey: 'input', text: 'Continue' });await f.service.accept(task.taskId, { clientId: run.inputMessageId }, f.execution);f.deps.inspect = async () => ({ execution: f.execution, pending: [] });expect((await f.service.getRun('p', run.runId)).status).toBe('running');- expect((await f.service.get('p', task.taskId)).permissionMode).toBe('auto');+ expect((await f.service.get('p', task.taskId)).permissionMode).toBe(permissionMode);expect(configured.permissionMode).toBe('plan');});// unit: full access must work through ordinary send/accept, but a revoked user-// capability approval must block the queued input before execution. No full-access path existed before.-it('delivers an authorized full-access task and rechecks capability approval before acceptance', async () => {+// ceiling must block the queued input before execution. No full-access path existed before.+it('delivers an authorized full-access task and rechecks the ceiling before acceptance', async () => {const f = fixture(), configured = { permissionMode: 'bypassPermissions' };useProductionPermissionCreator(f, configured);const task = await f.service.create('p', { requestKey: 'full', title: 'Work', permissionMode: 'bypassPermissions' });const run = await f.service.send('p', { taskId: task.taskId, expectedRevision: task.revision,requestKey: 'send', text: 'Continue' });expect(f.deps.dispatch).toHaveBeenCalledOnce();- f.deps.assertAuthorized = () => { throw new PluginTaskError('PERMISSION_DENIED', 'Plugin approval revoked'); };+ configured.permissionMode = 'auto';await expect(f.service.accept(task.taskId, { clientId: run.inputMessageId }, f.execution)).rejects.toMatchObject({ code: 'PERMISSION_DENIED' });await expect(f.service.create('p', { requestKey: 'denied', title: 'Work', permissionMode: 'bypassPermissions' }))@@ -285,22 +287,19 @@ it('rejects an unauthorized creation permission before reserving a task', asyncconst f = fixture(), configured = { permissionMode: 'ask' };const persist = useProductionPermissionCreator(f, configured);const request = { requestKey: 'new', title: 'Work', permissionMode: 'auto' as const };- const allowed = f.deps.assertAuthorized;- f.deps.assertAuthorized = () => { throw new PluginTaskError('PERMISSION_DENIED', 'Plugin approval revoked'); };await expect(f.service.create('p', request)).rejects.toMatchObject({ code: 'PERMISSION_DENIED' });expect(persist).not.toHaveBeenCalled();expect(f.rows.size).toBe(0);- f.deps.assertAuthorized = allowed;+ configured.permissionMode = 'auto';expect((await f.service.create('p', request)).permissionMode).toBe('auto');});it.each(['route', 'persistence'] as const)('rechecks creation permission after %s preparation', async phase => {const f = fixture(), configured = { permissionMode: 'auto' };const persist = useProductionPermissionCreator(f, configured);- const revoke = () => { f.deps.assertAuthorized = () => { throw new PluginTaskError('PERMISSION_DENIED', 'Plugin approval revoked'); }; };- if (phase === 'route') f.deps.resolveRoute = async () => { revoke(); return f.route; };+ if (phase === 'route') f.deps.resolveRoute = async () => { configured.permissionMode = 'ask'; return f.route; };else persist.mockImplementationOnce(async options => {- revoke();+ configured.permissionMode = 'ask';options.onPersistenceStarted();});await expect(f.service.create('p', { requestKey: 'new', title: 'Work', permissionMode: 'auto' }))@@ -965,9 +964,9 @@ describe('plugin ordinary task receipts', () => {});});-it('unknown task permission blocks new sends but preserves inspection of existing work',async()=>{+it('permission elevation blocks new sends but preserves inspection of existing work',async()=>{const f=fixture();const task=await f.create();const run=await f.send();- f.tasks.set(task.taskId,{...f.tasks.get(task.taskId)!,permissionMode:'unknown'});+ f.tasks.set(task.taskId,{...f.tasks.get(task.taskId)!,permissionMode:'bypassPermissions'});expect((await f.service.get('p',task.taskId)).taskId).toBe(task.taskId);expect((await f.service.getRun('p',run.runId)).runId).toBe(run.runId);await expect(f.service.send('p',{taskId:task.taskId,expectedRevision:task.revision,requestKey:'new-send',text:'new'})).rejects.toMatchObject({code:'PERMISSION_DENIED'});@@ -1002,7 +1001,7 @@ it('freezes owned plan and retains settled labels',async()=>{const f=fixture(),tit('rechecks permissions when queued input reaches native dispatch', async () => {const f=fixture(), run=await f.send();- f.tasks.get(run.taskId)!.permissionMode='unknown';+ f.tasks.get(run.taskId)!.permissionMode='bypassPermissions';await expect(f.service.accept(run.taskId,{clientId:run.inputMessageId},f.execution)).rejects.toMatchObject({code:'PERMISSION_DENIED'});expect(JSON.parse(f.rows.get(run.runId)!.payload).status).toBe('queued');});@@ -1173,12 +1172,12 @@ describe('current plugin dispatch authority', () => {it.each(['before', 'route', 'insert'])('blocks a new dispatch after revocation at %s', async point => {const f = fixture(), task = await f.create();f.tasks.get(task.taskId)!.permissionMode = 'auto';- const revoke = () => { f.tasks.get(task.taskId)!.planModeEnabled = true; };- if (point === 'before') revoke();- if (point === 'route') f.deps.resolveRoute = async () => { revoke(); return f.route; };+ let mode = 'auto'; f.deps.readPermissionMode = () => mode;+ if (point === 'before') mode = 'plan';+ if (point === 'route') f.deps.resolveRoute = async () => { mode = 'plan'; return f.route; };if (point === 'insert') {const insert = f.deps.store.insert;- f.deps.store.insert = async row => { await insert(row); revoke(); };+ f.deps.store.insert = async row => { await insert(row); mode = 'plan'; };}const attempt = f.service.send('p', {taskId:task.taskId,expectedRevision:task.revision,requestKey:'new',text:'input'});if (point === 'insert') await expect(attempt).resolves.toMatchObject({status:'failed'});@@ -1188,12 +1187,12 @@ describe('current plugin dispatch authority', () => {it.each(['before', 'route', 'save'])('blocks queued acceptance after revocation at %s and keeps cancel available', async point => {const f = fixture(), run = await f.send();f.tasks.get(run.taskId)!.permissionMode = 'auto';- const revoke = () => { f.tasks.get(run.taskId)!.planModeEnabled = true; };- if (point === 'before') revoke();- if (point === 'route') f.deps.resolveRoute = async () => { revoke(); return f.route; };+ let mode = 'auto'; f.deps.readPermissionMode = () => mode;+ if (point === 'before') mode = 'plan';+ if (point === 'route') f.deps.resolveRoute = async () => { mode = 'plan'; return f.route; };if (point === 'save') {const save = f.deps.store.save;- f.deps.store.save = async row => { await save(row); revoke(); };+ f.deps.store.save = async row => { await save(row); mode = 'plan'; };}await expect(f.service.accept(run.taskId,{clientId:run.inputMessageId},f.execution)).rejects.toMatchObject({code:'PERMISSION_DENIED'});// Same-key retries observe the existing receipt; they never reopen dispatch.@@ -1211,7 +1210,7 @@ describe('current plugin dispatch authority', () => {f.deps.store.insert = async row => {await insert(row);if (change === 'plan') f.tasks.get(task.taskId)!.planModeEnabled = true;- if (change === 'permission') f.tasks.get(task.taskId)!.permissionMode = 'unknown';+ if (change === 'permission') f.deps.readPermissionMode = () => 'plan';if (change === 'archive') f.tasks.get(task.taskId)!.status = 'archived';if (change === 'read failure') f.deps.readSession = vi.fn().mockRejectedValueOnce(new Error('Read unavailable')).mockImplementation(readSession);@@ -1228,7 +1227,7 @@ describe('current plugin dispatch authority', () => {// Restored authority permits an explicit new request, never replay of the old input.f.deps.store.insert = insert;Object.assign(f.tasks.get(task.taskId)!, { planModeEnabled: false, status: 'active' });- f.tasks.get(task.taskId)!.permissionMode = 'auto';+ f.deps.readPermissionMode = () => 'auto';expect(await restarted.send('p', request)).toEqual(run);expect(await restarted.send('p', { ...request, requestKey: 'new' })).toMatchObject({ status: 'queued' });expect(f.deps.dispatch).toHaveBeenCalledTimes(1);@@ -1433,7 +1432,7 @@ it.each([});const source = readFileSync(new URL('../register.ts', import.meta.url), 'utf8');const preferenceStart = source.indexOf(' readModelPreference:');- const preference = source.slice(preferenceStart, source.indexOf(' readLiveSession:', preferenceStart));+ const preference = source.slice(preferenceStart, source.indexOf(' readPermissionMode:', preferenceStart));const resolveStart = source.indexOf(' const resolveRoute = async');const resolve = source.slice(resolveStart, source.indexOf(' const readExecution', resolveStart));const deps = { getPluginTaskDefaults: () => config, getSelectedNewMakerRoute: () => selected,diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskStorePagination.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskStorePagination.test.tsindex 38260b8296..7c6c93a162 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskStorePagination.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskStorePagination.test.ts@@ -46,7 +46,7 @@ it('durably revokes only create ownership while retaining plans, run results andconst unused=async():Promise<never>=>{throw Error('unexpected dispatch/control');};const service=createPluginTaskService({store,assertCurrent(){},assertAuthorized(){},readSession:async taskId=>({taskId,title:'kept',revision:1,status:'active',resolvedConfig:route,permissionMode:'plan'}),- readModelPreference:()=>route,readLiveSession:()=>undefined,resolveRoute:unused,createSession:unused,dispatch:unused,inspect:unused,cancel:unused,+ readModelPreference:()=>route,readPermissionMode:()=> 'plan',readLiveSession:()=>undefined,resolveRoute:unused,createSession:unused,dispatch:unused,inspect:unused,cancel:unused,});expect((await service.list('p')).items.map(row=>row.taskId)).toEqual(['task']);await store.revokePlugin('p');diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginWriteAccess.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginWriteAccess.test.tsindex 65ec04e5d1..83fa44d616 100644--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginWriteAccess.test.ts+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginWriteAccess.test.ts@@ -22,6 +22,7 @@ const planJs = ts.transpileModule(planSource, { compilerOptions: { target: ts.Scconst settingJs = ts.transpileModule(settingSource, { compilerOptions: { target: ts.ScriptTarget.ES2022 } }).outputText;function fixture() {let identity = 'owner-epoch-install';+ let usesDefaults = true;const gate = new PluginWriteAccessGate();let cfg: Record<string, unknown> = { permissionMode: 'plan', model: 'old' };const history = { input: false, startedAt: null as number | null, endedAt: null as number | null, permissionMode: 'plan', planModeEnabled: false };@@ -38,7 +39,7 @@ function fixture() {const slots = new Set<string>();const dialog = { showMessageBox: vi.fn(async () => ({ response: 0 })) };const write = vi.fn((_id: string, value: Record<string, unknown>) => { cfg = value; });- const deps = { isPluginTaskPermissionAllowed, withBotPermissionChange: async (_id: string, change: () => Promise<unknown>) => change(), withSessionPermissionChange, withSessionRestartLock, drainPersistQueue:drain,messages,sessions,eq:()=>true,and:()=>true,service, getCurrentDbClientSnapshot: () => ownership.current, getPluginTaskDefaults: () => cfg, pluginPermissionRequests: slots, PluginTaskError, maker: { getSession: () => cold ? null : live }, inputCoordinator: queue, dialog, t: (x: string) => x, getInstalledGhostName: () => 'fixture', clampPluginTaskPermissionMode: (x: string) => x, writePluginTaskConfig: write, broadcastSessionPatched: vi.fn() };+ const deps = { isPluginTaskPermissionAllowed, withBotPermissionChange: async (_id: string, change: () => Promise<unknown>) => change(), withSessionPermissionChange, withSessionRestartLock, drainPersistQueue:drain,messages,sessions,eq:()=>true,and:()=>true,service, getCurrentDbClientSnapshot: () => ownership.current, getPluginTaskDefaults: () => usesDefaults ? cfg : undefined, pluginPermissionRequests: slots, PluginTaskError, maker: { getSession: () => cold ? null : live }, inputCoordinator: queue, dialog, t: (x: string) => x, getInstalledGhostName: () => 'fixture', clampPluginTaskPermissionMode: (x: string) => x, writePluginTaskConfig: write, broadcastSessionPatched: vi.fn() };const allDeps = {...deps, pluginWriteAccessGate:gate, pluginWriteAccessIdentity:()=>identity};const run = new Function(...Object.keys(allDeps), js)(...Object.values(allDeps));let setMode!: (event: unknown, sessionId: string, mode: string) => Promise<unknown>;@@ -59,7 +60,7 @@ function fixture() {getLiveSession:()=>cold?null:live,persist:async next=>{await epoch.client.tx('bots.persistSessionPermission',{mode:next});},});- return {setPlan:(enabled:boolean)=>setPlan({},'task',enabled),planPersist,forgetGrants,runtimePlan:()=>runtimePlan,nativePlan:(enabled:boolean|null)=>{runtimePlan=enabled;},setImMode, setMode:(mode:string)=>setMode({},'task',mode), persistedResults, remote:()=>{remote=true;}, cold:()=>{cold=true;}, runtimeMode:()=>runtimeMode, changeOwner:()=>{ownership.current={};}, run: (mode = 'acceptEdits', explicit = false) => run('plugin', { kind: 'requestWriteAccess', taskId: 'task', mode }, explicit), queue, gate, identity: (next: string) => {identity=next;}, service, live, epoch, dialog, slots, write, history, drain, config: () => cfg, change: (next: Record<string, unknown>) => { cfg = next; } };+ return {hideCard: () => { usesDefaults = false; }, setPlan:(enabled:boolean)=>setPlan({},'task',enabled),planPersist,forgetGrants,runtimePlan:()=>runtimePlan,nativePlan:(enabled:boolean|null)=>{runtimePlan=enabled;},setImMode, setMode:(mode:string)=>setMode({},'task',mode), persistedResults, remote:()=>{remote=true;}, cold:()=>{cold=true;}, runtimeMode:()=>runtimeMode, changeOwner:()=>{ownership.current={};}, run: (mode = 'acceptEdits', explicit = false) => run('plugin', { kind: 'requestWriteAccess', taskId: 'task', mode }, explicit), queue, gate, identity: (next: string) => {identity=next;}, service, live, epoch, dialog, slots, write, history, drain, config: () => cfg, change: (next: Record<string, unknown>) => { cfg = next; } };}describe('shared-provider credential grants on permission changes', () => {it('clears the task grant only when permission or Plan mode really changes, even without a running agent', async () => {@@ -76,11 +77,9 @@ describe('shared-provider credential grants on permission changes', () => {});});describe('plugin write confirmation interleavings', () => {- // unit: native consent authorizes only the chosen Session. It must not rewrite- // plugin defaults and thereby affect unrelated future tasks.- it('keeps host confirmation independent of card defaults', async () => {- const f = fixture();- f.change({ permissionMode: 'ask', model: 'chosen' });+ // unit: hidden-card consent affects only the task and never touches saved defaults.+ it('keeps a hidden plugin card ineffective during permission confirmation', async () => {+ const f = fixture(); f.hideCard();f.dialog.showMessageBox.mockImplementationOnce(async () => {f.change({ permissionMode: 'bypassPermissions', model: 'changed' });return { response: 0 };@@ -90,9 +89,8 @@ describe('plugin write confirmation interleavings', () => {expect(f.write).not.toHaveBeenCalled();expect(f.config()).toEqual({ permissionMode: 'bypassPermissions', model: 'changed' });});-// unit: adding full access must not make an older write-access request lower- // an already granted task, nor overwrite unrelated defaults.+ // an already granted task or the user's independent plugin permission ceiling.it('keeps full-access grants when an older client requests Auto', async () => {const f=fixture();f.change({permissionMode:'bypassPermissions'});f.service.get.mockResolvedValue({taskId:'task',revision:1,status:'active',permissionMode:'bypassPermissions'});@@ -101,7 +99,7 @@ describe('plugin write confirmation interleavings', () => {expect(f.live.setPermissionMode).not.toHaveBeenCalled();expect(f.write).not.toHaveBeenCalled();});- it('grants Auto to a task without changing plugin defaults', async () => {+ it('grants Auto to a task without reducing the plugin full-access ceiling', async () => {const f=fixture();f.change({permissionMode:'bypassPermissions'});await expect(f.run('auto')).resolves.toMatchObject({granted:true});expect(f.live.setPermissionMode).toHaveBeenCalledWith('auto');@@ -196,19 +194,18 @@ describe('plugin write confirmation interleavings', () => {if (point === 'runtime') f.live.setPermissionMode.mockImplementationOnce(async () => { change(); });if (point === 'database') f.epoch.client.tx.mockImplementationOnce(async () => { change(); return { updated: true }; });if (point === 'lastRead') f.service.get.mockImplementationOnce(async () => ({ taskId: 'task', revision: 1, status: 'active', permissionMode: 'plan' })).mockImplementationOnce(async () => ({ taskId: 'task', revision: 1, status: 'active', permissionMode: 'plan' })).mockImplementationOnce(async () => { change(); return { taskId: 'task', revision: 1, status: 'active', permissionMode: 'plan' }; });- await f.run('auto'); expect(f.config()).toEqual({ permissionMode: 'plan', model: 'new', workingDir: '/chosen', fastMode: true });- expect(f.write).not.toHaveBeenCalled();+ await f.run('auto'); expect(f.config()).toEqual({ permissionMode: 'auto', model: 'new', workingDir: '/chosen', fastMode: true });});- it('does not treat a later default change as a Session permission revocation', async () => {+ it('does not overwrite a later permission change', async () => {const f = fixture(); f.live.setPermissionMode.mockImplementationOnce(async () => { f.change({ permissionMode: 'acceptEdits', model: 'new' }); });- await expect(f.run('auto')).resolves.toMatchObject({ granted: true });+ await expect(f.run('auto')).rejects.toMatchObject({ code: 'PERMISSION_DENIED' });expect(f.write).not.toHaveBeenCalled(); expect(f.slots.size).toBe(0);- expect(f.live.setPermissionMode).toHaveBeenLastCalledWith('auto');- expect(f.config()).toEqual({permissionMode:'acceptEdits',model:'new'});+ expect(f.live.setPermissionMode).toHaveBeenLastCalledWith('plan');+ expect(f.epoch.client.tx).toHaveBeenLastCalledWith('bots.persistSessionPermission', {sessionId:'task', mode:'plan'});});it.each(['database', 'lastRead'] as const)('rolls back runtime and stored permission after late %s revocation', async point => {const f=fixture();- const revoke=()=>{f.change({permissionMode:'acceptEdits',model:'new'});f.identity('revoked-install');};+ const revoke=()=>f.change({permissionMode:'acceptEdits',model:'new'});if(point==='database') f.epoch.client.tx.mockImplementationOnce(async()=>{revoke();return {updated:true};});else f.service.get.mockImplementationOnce(async()=>({taskId:'task',revision:1,status:'active',permissionMode:'plan'})).mockImplementationOnce(async()=>({taskId:'task',revision:1,status:'active',permissionMode:'plan'}))@@ -280,13 +277,13 @@ describe('first plugin write approval checks actual task history', () => {});-it.each(['bypassPermissions', 'auto', 'acceptEdits'])('reuses the task %s permission regardless of lower card defaults', async permissionMode => {+it.each(['bypassPermissions', 'auto', 'acceptEdits'])('does not report %s as granted after plugin authority is lowered', async permissionMode => {const f = fixture();f.service.get.mockImplementation(async () => ({taskId:'task',revision:1,status:'active',permissionMode}));- await expect(f.run()).resolves.toMatchObject({granted:true});- expect(f.dialog.showMessageBox).not.toHaveBeenCalled();+ f.dialog.showMessageBox.mockResolvedValue({response:1});+ await expect(f.run()).resolves.toMatchObject({granted:false});+ expect(f.dialog.showMessageBox).toHaveBeenCalledOnce();expect(f.live.setPermissionMode).not.toHaveBeenCalled();- expect(f.write).not.toHaveBeenCalled();});it.each(['acceptEdits', 'auto'])('reuses an effective %s grant without another confirmation',async permissionMode=>{const f=fixture();f.change({permissionMode});diff --git a/apps/desktop/src/main/maker-ipc/pluginTaskService.ts b/apps/desktop/src/main/maker-ipc/pluginTaskService.tsindex f5ba07a605..d0451b07be 100644--- a/apps/desktop/src/main/maker-ipc/pluginTaskService.ts+++ b/apps/desktop/src/main/maker-ipc/pluginTaskService.ts@@ -1,8 +1,8 @@import { createHash, randomUUID } from 'node:crypto';import type { Session } from '@cindy/maker-core';+import { GHOST_ERRAND_PERMISSION_MODES } from '../../shared/ghost.js';import type { PluginTaskPermissionMode, PluginTaskRoute, PluginTaskRun, PluginTaskView, PluginTeamPlan } from '../../shared/pluginTasks.js';import { isPluginTaskPermissionMode, isPluginTeamPlanWithinBudget, PLUGIN_TASK_RECEIPT_MAX_JSON_CHARS } from '../../shared/pluginTasks.js';-import { GHOST_ERRAND_PERMISSION_MODES } from '../../shared/ghost.js';import type { PluginMessageAttachment } from '../../shared/pluginAttachments.js';import { withParsedPluginMessageAttachments, type PluginMessageImage } from '../cindy-media/pluginMessageAttachments.js';import { DEFAULT_DRAFT_SESSION_TITLE } from '@cindy/maker-shared/session-title';@@ -112,11 +112,11 @@ export function isTeamPlanLabelLockedByReceipt(export function assertPluginTaskResult(result: { ok: boolean; errorCode?: string }, message: string): void {if (!result.ok) throw new PluginTaskError(result.errorCode || 'HOST_NOT_READY', message);}-/** Compare a requested permission with a Session's current mode, never card defaults. */-export function isPluginTaskPermissionAllowed(taskMode: unknown, currentMode: unknown, planModeEnabled = false): boolean {+/** A live task cannot exercise more authority than the plugin's current setting. */+export function isPluginTaskPermissionAllowed(taskMode: unknown, configuredMode: unknown, planModeEnabled = false): boolean {const rank = (mode: unknown) => mode === 'plan' ? 0 : mode === 'ask' ? 1 : mode === 'acceptEdits' ? 2 : mode === 'auto' ? 3 : mode === 'bypassPermissions' ? 4 : -1;const task = rank(taskMode);- return !planModeEnabled && task >= 0 && task <= Math.max(0, rank(currentMode));+ return !planModeEnabled && task >= 0 && task <= Math.max(0, rank(configuredMode));}const fail = (code: string, message: string): never => {throw new PluginTaskError(code, message);@@ -142,6 +142,8 @@ export interface PluginTaskServiceDeps {/** Bound to the captured account/database epoch and plugin availability. */assertCurrent(): void;assertAuthorized(pluginId: string): void;+ /** Undefined only when this plugin has opted out of its Host task card. */+ readPermissionMode(pluginId: string): unknown;/** Include the inherited new-task selection when the resolver can use it. */readModelPreference(pluginId: string): Partial<PluginTaskRoute> & { inheritedDefault?: string };resolveRoute(pluginId: string, route?: PluginTaskRoute, callId?: string): Promise<PluginTaskRoute>;@@ -243,17 +245,19 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {assertCurrent();return assertCurrent;};- // Actual Session state is authoritative after creation. Defaults are not grants- // and cannot revoke or elevate an existing task. The runtime enforces its mode.- const isTaskRunnable = (view: PluginTaskView) => !view.planModeEnabled- && (GHOST_ERRAND_PERMISSION_MODES as readonly unknown[]).includes(view.permissionMode);+ const isTaskPermissionAllowed = (pluginId: string, view: PluginTaskView) => {+ const configuredMode = deps.readPermissionMode(pluginId);+ return configuredMode === undefined+ ? !view.planModeEnabled && (GHOST_ERRAND_PERMISSION_MODES as readonly unknown[]).includes(view.permissionMode)+ : isPluginTaskPermissionAllowed(view.permissionMode, configuredMode, view.planModeEnabled);+ };const assertDispatch = async (pluginId: string, taskId: string, assertPlanCurrent = capturePlanGuard(taskId)) => {const view = await ownTask(pluginId, taskId);deps.assertAuthorized(pluginId);assertPlanCurrent();if (view.status !== 'active') return fail('TASK_BUSY', 'Archived tasks cannot accept input');- if (!isTaskRunnable(view))- return fail('PERMISSION_DENIED', 'Task permission is unavailable or Plan Mode is active');+ if (!isTaskPermissionAllowed(pluginId, view))+ return fail('PERMISSION_DENIED', 'Task permission exceeds plugin dispatch policy');return view;};const save = async (row: PluginTaskReceipt, payload: unknown) => {@@ -363,6 +367,13 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {return fail('INVALID_REQUEST', 'Supply a title or opt into automatic naming');if (request.permissionMode !== undefined && !isPluginTaskPermissionMode(request.permissionMode))return fail('INVALID_REQUEST', 'Unsupported task creation permission');+ const assertRequestedPermission = () => {+ if (request.permissionMode === undefined) return;+ deps.assertAuthorized(pluginId);+ const configuredMode = deps.readPermissionMode(pluginId);+ if (configuredMode !== undefined && !isPluginTaskPermissionAllowed(request.permissionMode, configuredMode))+ fail('PERMISSION_DENIED', 'Requested permission exceeds plugin dispatch policy');+ };const title = request.autoTitle ? DEFAULT_DRAFT_SESSION_TITLE : request.title!;const hidden = request.hidden === true;if (hidden) assertHiddenTasksAllowed(pluginId);@@ -380,11 +391,11 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {// Do not recreate a deleted/ambiguous task on replay.return ownTask(pluginId, row.id);}- deps.assertAuthorized(pluginId);+ assertRequestedPermission();const route = await deps.resolveRoute(pluginId, request.route, request.callId);deps.assertCurrent();targetContext?.assertCurrent();- deps.assertAuthorized(pluginId);+ assertRequestedPermission();const taskId = targetContext?.taskId ?? id();row = newReceipt(pluginId,@@ -399,7 +410,7 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {let persistenceStarted = false;try {deps.assertCurrent();- const onPersistenceStarted = () => { deps.assertAuthorized(pluginId); persistenceStarted = true; };+ const onPersistenceStarted = () => { assertRequestedPermission(); persistenceStarted = true; };// Omitted new fields keep the original creator call shape.if (request.permissionMode !== undefined) {targetContext?.assertCurrent();@@ -527,7 +538,7 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {if (previous)return { run: JSON.parse(previous.payload) as PluginTaskRun, dispatch: false as const };const assertPlanCurrent = capturePlanGuard(view.taskId);- if (!isTaskRunnable(view)) return fail('PERMISSION_DENIED', 'Task permission is unavailable or Plan Mode is active');+ if (!isTaskPermissionAllowed(pluginId, view)) return fail('PERMISSION_DENIED', 'Task permission exceeds plugin dispatch policy');if (view.status !== 'active')return fail('TASK_BUSY', 'Archived tasks cannot accept input');if (view.revision !== request.expectedRevision)@@ -666,7 +677,7 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {const view = await ownTask(row.pluginId, taskId);assertPlanCurrent();if (view.status !== 'active') return fail('TASK_BUSY', 'Archived tasks cannot accept input');- if (!isTaskRunnable(view)) return fail('PERMISSION_DENIED', 'Task permission is unavailable or Plan Mode is active');+ if (!isTaskPermissionAllowed(row.pluginId, view)) return fail('PERMISSION_DENIED', 'Task permission exceeds plugin dispatch policy');if (hash(view.resolvedConfig) !== hash(run.acceptedConfig))return fail('ROUTE_UNAVAILABLE', 'Accepted route changed before dispatch');await deps.resolveRoute(row.pluginId, run.acceptedConfig);diff --git a/apps/desktop/src/main/maker-ipc/register.ts b/apps/desktop/src/main/maker-ipc/register.tsindex 1d04d4c7a0..4bfaa7d8e9 100644--- a/apps/desktop/src/main/maker-ipc/register.ts+++ b/apps/desktop/src/main/maker-ipc/register.ts@@ -1513,6 +1513,7 @@ import {import {clampPluginTaskPermissionMode,setPluginTaskConfigValidator,+ writePluginTaskConfig,readGhostErrandSessionId,writeGhostErrandSessionId,} from '../cindy-brain/pluginTaskPrefsStore.js';@@ -13967,7 +13968,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)const routeUnavailable = (): never => { throw new PluginTaskError('ROUTE_UNAVAILABLE', 'The selected provider, model or effort is unavailable'); };const resolveRoute = async (pluginId: string, requested?: PluginTaskRoute, callId?: string): Promise<PluginTaskRoute> => {assertPlugin(pluginId);- const selection = requested ?? getPluginTaskDefaults(pluginId);+ const selection = { ...getPluginTaskDefaults(pluginId), ...requested };const sourceSessionId = getPluginTaskSourceSessionId(pluginId, callId);if (callId && !sourceSessionId && !(selection.agentKind && selection.model && selection.providerId)) throw new PluginTaskError('ROUTE_UNAVAILABLE', '发起任务已不可用,请重新调用,或在面板选择模型后创建任务');try {@@ -13993,7 +13994,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)},acceptInvocation: acceptPluginInvocation,readModelPreference: pluginId => {- const config = getPluginTaskDefaults(pluginId);+ const config = getPluginTaskDefaults(pluginId) ?? {};// Match the shared resolver: a complete explicit identity does not// inherit the new-task selection; partial/reset settings can do so.const fallback = config.agentKind && config.model && config.providerId@@ -14002,6 +14003,10 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)fallback.harness, fallback.model, fallback.providerId, fallback.effort, fallback.fastMode,]) : undefined };},+ readPermissionMode: pluginId => {+ const config = getPluginTaskDefaults(pluginId);+ return config ? clampPluginTaskPermissionMode(config.permissionMode) : undefined;+ },readLiveSession: taskId => maker.getSession(taskId),setModel: async (taskId, route, assertUnchanged) => {const current = await sessionControlService.getSessionRuntime({ targetSessionId: taskId });@@ -14036,15 +14041,17 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)createSession: async (pluginId, taskId, title, route, isolatedWorkspace, requestedRoute, onPersistenceStarted, callId, hidden, targetContext, permissionMode) => {assertPlugin(pluginId);const cfg = getPluginTaskDefaults(pluginId);- const configuredPermission = clampPluginTaskPermissionMode(cfg.permissionMode);+ const configuredPermission = clampPluginTaskPermissionMode(cfg?.permissionMode);+ if (cfg && permissionMode !== undefined && !isPluginTaskPermissionAllowed(permissionMode, configuredPermission))+ throw new PluginTaskError('PERMISSION_DENIED', 'Requested permission exceeds plugin dispatch policy');const configurationIsCurrent = () => {targetContext?.assertCurrent();const current = getPluginTaskDefaults(pluginId);- return (targetContext || isolatedWorkspace || current.workingDir === cfg.workingDir)- && (permissionMode !== undefined || current.permissionMode === cfg.permissionMode)- && (requestedRoute !== undefined || (current.agentKind === cfg.agentKind && current.model === cfg.model- && current.providerId === cfg.providerId && current.effort === cfg.effort- && current.fastMode === cfg.fastMode));+ if (!cfg || !current) return cfg === current;+ return current.workingDir === cfg.workingDir && current.permissionMode === cfg.permissionMode+ && current.agentKind === cfg.agentKind && current.model === cfg.model+ && current.providerId === cfg.providerId && current.effort === cfg.effort+ && current.fastMode === cfg.fastMode;};// Receipt persistence/provider lookup can yield after the first resolution.// Reuse the resolver with the original request, then guard this configuration@@ -14052,7 +14059,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)const currentRoute = await resolveRoute(pluginId, requestedRoute, callId);if ((Object.keys(currentRoute) as Array<keyof PluginTaskRoute>).some(key => currentRoute[key] !== route[key]))throw new PluginTaskError('ROUTE_UNAVAILABLE', 'Plugin task route changed');- const requestedWorkingDir = targetContext?.workingDir ?? (!isolatedWorkspace ? cfg.workingDir : undefined);+ const requestedWorkingDir = targetContext?.workingDir ?? (!isolatedWorkspace ? cfg?.workingDir : undefined);const workingDir = requestedWorkingDir? await resolvePluginWorkerDirectory({requested: requestedWorkingDir, configuredDirectory: requestedWorkingDir,@@ -14253,14 +14260,16 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)assertPlanInactive();if (task.planModeEnabled) throw new PluginTaskError('PERMISSION_DENIED', 'Exit Plan Mode before requesting write access');const mode = request.mode ?? 'acceptEdits';+ const cfg = getPluginTaskDefaults(pluginId);assertCallerCurrent();- if (isPluginTaskPermissionAllowed(mode, task.permissionMode)) return { granted: true, task };+ if ((!cfg || isPluginTaskPermissionAllowed(task.permissionMode, cfg.permissionMode)) && isPluginTaskPermissionAllowed(mode, task.permissionMode)) return { granted: true, task };if (pluginPermissionRequests.size) throw new PluginTaskError('TASK_BUSY', 'A permission request is already open');const identity = pluginWriteAccessIdentity(pluginId);const assertRequestCurrent = () => {assertCallerCurrent();if (snapshot !== getCurrentDbClientSnapshot() || identity !== pluginWriteAccessIdentity(pluginId)) throw new PluginTaskError('PERMISSION_DENIED', 'Permission request identity changed');};+ const before = JSON.stringify(cfg);const assertIdle = async () => {await inputCoordinator.ensureQueueRestored(task.taskId);assertRequestCurrent();@@ -14290,12 +14299,12 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)const result = request.mobilePageId ? { response: await showMobilePluginTaskPermission(pluginId, request.mobilePageId, {title: t(mode === 'auto' ? 'pluginTaskWriteAccess.autoTitle' : 'pluginTaskWriteAccess.title'),message: t(mode === 'auto' ? 'pluginTaskWriteAccess.autoMessage' : 'pluginTaskWriteAccess.message').replace('{{name}}', getInstalledGhostName(pluginId) ?? pluginId),- detail: `${task.title}\n\n${t(mode === 'auto' ? 'pluginTaskWriteAccess.autoDetail' : 'pluginTaskWriteAccess.detail')}`,+ detail: `${task.title}\n\n${t(mode === 'auto' ? (cfg ? 'pluginTaskWriteAccess.autoDetail' : 'pluginTaskWriteAccess.autoTaskDetail') : (cfg ? 'pluginTaskWriteAccess.detail' : 'pluginTaskWriteAccess.taskDetail'))}`,allow: t('pluginTaskWriteAccess.allow'), cancel: t('pluginTaskWriteAccess.cancel'),}) ? 0 : 1 } : await dialog.showMessageBox({type: 'question', title: t(mode === 'auto' ? 'pluginTaskWriteAccess.autoTitle' : 'pluginTaskWriteAccess.title'),message: t(mode === 'auto' ? 'pluginTaskWriteAccess.autoMessage' : 'pluginTaskWriteAccess.message').replace('{{name}}', getInstalledGhostName(pluginId) ?? pluginId),- detail: t(mode === 'auto' ? 'pluginTaskWriteAccess.autoDetail' : 'pluginTaskWriteAccess.detail'),+ detail: t(mode === 'auto' ? (cfg ? 'pluginTaskWriteAccess.autoDetail' : 'pluginTaskWriteAccess.autoTaskDetail') : (cfg ? 'pluginTaskWriteAccess.detail' : 'pluginTaskWriteAccess.taskDetail')),buttons: [t('pluginTaskWriteAccess.allow'), t('pluginTaskWriteAccess.cancel')], defaultId: 1, cancelId: 1,});if (result.response !== 0) return { granted: false };@@ -14303,6 +14312,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)// permission writers never hold that fence while awaiting this queue.return await withBotPermissionChange(task.taskId, () => withSessionPermissionChange(task.taskId, () => service.completeOperation(() => withSessionRestartLock(task.taskId, async () => {assertRequestCurrent();+ if (snapshot !== getCurrentDbClientSnapshot() || before !== JSON.stringify(getPluginTaskDefaults(pluginId))) throw new PluginTaskError('PERMISSION_DENIED', 'Account or permission settings changed');const fresh = await service.get(pluginId, task.taskId);if (fresh.status !== 'active') throw new PluginTaskError('TASK_BUSY', 'Archived tasks cannot request write access');if (fresh.planModeEnabled) throw new PluginTaskError('PERMISSION_DENIED', 'Exit Plan Mode before requesting write access');@@ -14325,6 +14335,9 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)assertRequestCurrent();if (snapshot !== getCurrentDbClientSnapshot()) throw new PluginTaskError('PERMISSION_DENIED', 'Account changed');assertPlanInactive();+ const currentConfig = getPluginTaskDefaults(pluginId);+ if (currentConfig?.permissionMode !== cfg?.permissionMode) throw new PluginTaskError('PERMISSION_DENIED', 'Permission settings changed');+ if (currentConfig && !isPluginTaskPermissionAllowed(mode, clampPluginTaskPermissionMode(currentConfig.permissionMode))) writePluginTaskConfig(pluginId, {...currentConfig, permissionMode: mode});broadcastSessionPatched(task.taskId, {permissionMode: mode});return { granted: true, task: updatedTask };} catch (error) {@@ -14339,6 +14352,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)case 'startTeam': {const epoch = getCurrentDbClientSnapshot();const task = await service.get(pluginId, request.taskId);+ const configuredDirectory = getPluginTaskDefaults(pluginId)?.workingDir;// Becoming Lead changes revision through orcaRole, but may not change admission facts.const admission = (view: typeof task) => JSON.stringify([view.resolvedConfig, view.permissionMode, view.planModeEnabled, view.workingDir]);const expectedAdmission = admission(task);@@ -14348,6 +14362,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)const fresh = await service.get(pluginId, task.taskId);if (epoch !== getCurrentDbClientSnapshot()) throw new PluginTaskError('PERMISSION_DENIED', 'Account changed');assertPluginWorkerAutoAuthorized(pluginId, fresh);+ if (configuredDirectory !== getPluginTaskDefaults(pluginId)?.workingDir) throw new PluginTaskError('PERMISSION_DENIED', 'Plugin directory authorization changed');if ((!activationStarted && fresh.revision !== task.revision) || admission(fresh) !== expectedAdmission) throw new PluginTaskError('STALE_REVISION', 'Task changed during team activation');}, service.completeOperation);assertPluginTaskResult(result, 'Collaboration could not be started');@@ -14356,12 +14371,13 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)case 'setTeamPlan': return withSendToSessionLock(request.taskId, async () => {const epoch = getCurrentDbClientSnapshot();const task = await service.get(pluginId, request.taskId);+ const cfg = getPluginTaskDefaults(pluginId);const assertCurrent = () => {- if (epoch !== getCurrentDbClientSnapshot() || !isPluginTaskAuthorized(pluginId)) throw new PluginTaskError('PERMISSION_DENIED', 'Plugin directory authorization changed');+ if (epoch !== getCurrentDbClientSnapshot() || !isPluginTaskAuthorized(pluginId) || cfg?.workingDir !== getPluginTaskDefaults(pluginId)?.workingDir) throw new PluginTaskError('PERMISSION_DENIED', 'Plugin directory authorization changed');};const items = [];for (const item of request.plan.items) {- const workingDir = await resolvePluginWorkerDirectory({requested:item.workingDir,leadDirectory:task.workingDir,isPickedDirectory:dir=>isGhostPickedDir(pluginId,dir),assertCurrent});+ const workingDir = await resolvePluginWorkerDirectory({requested:item.workingDir,leadDirectory:task.workingDir,configuredDirectory:cfg?.workingDir,isPickedDirectory:dir=>isGhostPickedDir(pluginId,dir),assertCurrent});items.push({...item, workingDir});}const current = await service.get(pluginId, request.taskId);@@ -14492,6 +14508,9 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)assertCreatePermission: (pluginId, permissionMode) => {if (!isPluginTaskAuthorized(pluginId)) throw new PluginTaskError('PERMISSION_DENIED', 'Plugin task capability is unavailable');if (!isPluginTaskPermissionMode(permissionMode)) throw new PluginTaskError('INVALID_REQUEST', 'Unsupported task creation permission');+ const config = getPluginTaskDefaults(pluginId);+ if (config && !isPluginTaskPermissionAllowed(permissionMode, clampPluginTaskPermissionMode(config.permissionMode)))+ throw new PluginTaskError('PERMISSION_DENIED', 'Requested permission exceeds plugin dispatch policy');},assertProjectDispatch: async (pluginId, taskId) => {await pluginTaskServiceForCurrentOwner!().assertDispatch(pluginId, taskId);@@ -14632,7 +14651,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)// Legacy result-returning adapter; ordinary task configuration lives above.setGhostErrandRunner(createGhostErrandRunner({- readConfig: getPluginTaskDefaults,+ readConfig: id => getPluginTaskDefaults(id) ?? {},readSessionId: readGhostErrandSessionId,writeSessionId: writeGhostErrandSessionId,getSessionRow: async (sessionId) => {@@ -14745,13 +14764,13 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)createDraftSession: async (params) => {const assertOwner = captureSessionOwner();const config = getPluginTaskDefaults(params.ghostId);- const execution = await resolveSessionExecution(config, params.sourceSessionId);+ const execution = await resolveSessionExecution(config ?? {}, params.sourceSessionId);assertOwner();const sessionId = await createPluginDraftSession({...params,shouldContinue: () => { assertOwner(); return (params.shouldContinue?.() ?? true)&& JSON.stringify(getPluginTaskDefaults(params.ghostId)) === JSON.stringify(config); },- defaults: { ...execution, effort: execution.effort ?? '', permissionMode: clampPluginTaskPermissionMode(config.permissionMode), agentKind: execution.agentKind === 'claude-code' ? 'cc' : execution.agentKind },+ defaults: { ...execution, effort: execution.effort ?? '', permissionMode: clampPluginTaskPermissionMode(config?.permissionMode), agentKind: execution.agentKind === 'claude-code' ? 'cc' : execution.agentKind },notifySessionCreated: (info) => notifyGhostSessionEvent('created', info),});if (!sessionId) return null;@@ -15871,7 +15890,8 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)if (task.status !== 'active') {throw new PluginTaskError('TASK_BUSY', 'Archived tasks cannot create Workers');}- if (!isPluginTaskAuthorized(pluginId) || task.planModeEnabled || task.permissionMode !== 'auto') {+ const config = getPluginTaskDefaults(pluginId);+ if (!isPluginTaskAuthorized(pluginId) || task.planModeEnabled || task.permissionMode !== 'auto' || (config && config.permissionMode !== 'auto')) {throw new PluginTaskError('PERMISSION_DENIED', 'Authorize Auto for the plugin coordinator before creating Workers');}};@@ -16036,11 +16056,12 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)) {throw new PluginTaskError('PERMISSION_DENIED', 'Plugin-owned tasks cannot run a Worker Agent on another computer');}+ const cfg = getPluginTaskDefaults(receipt.pluginId);const resolveAuthorizedDirectory = (requested: string) => resolvePluginWorkerDirectory({requested, leadDirectory: task.workingDir,- isPickedDirectory: dir => isGhostPickedDir(receipt.pluginId,dir),+ configuredDirectory: cfg?.workingDir, isPickedDirectory: dir => isGhostPickedDir(receipt.pluginId,dir),assertCurrent: () => {- if (epoch !== getCurrentDbClientSnapshot() || !isPluginTaskAuthorized(receipt.pluginId)) throw new PluginTaskError('PERMISSION_DENIED','Plugin directory authorization changed');+ if (epoch !== getCurrentDbClientSnapshot() || !isPluginTaskAuthorized(receipt.pluginId) || cfg?.workingDir !== getPluginTaskDefaults(receipt.pluginId)?.workingDir) throw new PluginTaskError('PERMISSION_DENIED','Plugin directory authorization changed');},});const directory = await resolveAuthorizedDirectory(params.workingDir ?? task.workingDir ?? '');@@ -16062,8 +16083,9 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)// Last admission check also covers no-plan plugin tasks and revocation// while directory/receipt reads or the existing reservation were pending.assertPluginWorkerAutoAuthorized(receipt.pluginId, currentTask);+ if (cfg?.workingDir !== getPluginTaskDefaults(receipt.pluginId)?.workingDir) throw new PluginTaskError('PERMISSION_DENIED','Plugin directory authorization changed');assertPluginWorkerDirectoryScope({ requested: directory, leadDirectory: currentTask.workingDir,- isPickedDirectory: dir => isGhostPickedDir(receipt.pluginId, dir) });+ configuredDirectory: cfg?.workingDir, isPickedDirectory: dir => isGhostPickedDir(receipt.pluginId, dir) });if (!data.teamPlan) return undefined; // Existing plugins retain their original behavior.if (!item || data.settledLabels?.includes(params.label)) throw new PluginTaskError('INVALID_REQUEST','Worker is not pending in the registered plan');const route = item.route;@@ -18042,11 +18064,12 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)projection.revision,]);if (epoch !== getCurrentDbClientSnapshot()) throw new Error('Account changed');+ const config = getPluginTaskDefaults(receipt.pluginId);const approvalRevision = pluginTaskAuthorizationRevision(receipt.pluginId);return {pluginId: receipt.pluginId,- authorized: !!unchanged && approvalRevision !== null && isPluginTaskAuthorized(receipt.pluginId),- revision: [epoch.userId, epoch.clientEpoch, approvalRevision, link],+ authorized: !!unchanged && approvalRevision !== null && isPluginTaskAuthorized(receipt.pluginId) && (!config || config.permissionMode === 'auto'),+ revision: [epoch.userId, epoch.clientEpoch, approvalRevision, config?.permissionMode, link],plan: data.teamPlan, settledLabels: data.settledLabels,registeredRoute: data.route,session: { workingDir: session.workingDir, permissionMode: session.permissionMode, planModeEnabled: !!session.planModeEnabled, status: session.status,diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex ab27a30aff..0b54ef7f02 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -17809,10 +17809,12 @@"pluginTaskWriteAccess": {"autoTitle": "Enable Auto approval","autoMessage": "Allow “{{name}}” to use Auto approval?",- "autoDetail": "Cindy will review coordinator and Worker actions automatically. Actions requiring confirmation or denied actions still pause. This is not Full access. Only this session’s permission changes; plugin defaults stay unchanged.",+ "autoDetail": "Cindy will review coordinator and Worker actions automatically. Actions requiring confirmation or denied actions still pause. This is not Full access. The choice is saved in plugin AI settings without changing global permissions for other tasks.",+ "autoTaskDetail": "Cindy will review coordinator and Worker actions automatically. Actions requiring confirmation or denied actions still pause. This is not Full access. Only this session’s permission changes; plugin defaults stay unchanged.","title": "Allow this plugin’s AI to edit files?","message": "Allow the AI in “{{name}}” to edit files and continue?",- "detail": "This allows edits only for the current session. A separate working directory is not a system sandbox; commands still follow Cindy permission checks. You can change this in the session’s permission menu.",+ "detail": "This sets the plugin’s AI permission to Allow edits for future tasks too. A separate working directory is not a system sandbox; commands still follow Cindy permission checks. You can switch back to read-only in the plugin’s AI settings.",+ "taskDetail": "This allows edits only for the current session. A separate working directory is not a system sandbox; commands still follow Cindy permission checks. You can change this in the session’s permission menu.","allow": "Allow and continue","cancel": "Not now"},diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex acbc7e267c..e876ed45fc 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -17749,12 +17749,14 @@"pluginTaskWriteAccess": {"title": "このプラグインの AI にファイルの編集を許可しますか?","message": "「{{name}}」の AI にファイルの編集を許可して続行しますか?",- "detail": "現在のセッションのみ編集を許可します。独立した作業ディレクトリはシステムのサンドボックスではなく、コマンドには引き続き Cindy の権限チェックが適用されます。このセッションの権限メニューで変更できます。",+ "detail": "このプラグインの AI 権限を編集可能に変更します。今後のタスクにも適用されます。独立した作業ディレクトリはシステムのサンドボックスではなく、コマンドには引き続き Cindy の権限チェックが適用されます。プラグインの AI 設定でいつでも読み取り専用に戻せます。",+ "taskDetail": "現在のセッションのみ編集を許可します。独立した作業ディレクトリはシステムのサンドボックスではなく、コマンドには引き続き Cindy の権限チェックが適用されます。このセッションの権限メニューで変更できます。","allow": "許可して続行","cancel": "今は許可しない","autoTitle": "Auto 自動承認を有効化","autoMessage": "「{{name}}」で Auto 自動承認を使用しますか?",- "autoDetail": "主タスクと Worker の操作を Cindy が自動審査します。確認が必要な操作や拒否された操作は停止します。完全アクセスではありません。現在のセッションの権限のみを変更し、プラグインの既定設定は変更しません。"+ "autoDetail": "主タスクと Worker の操作を Cindy が自動審査します。確認が必要な操作や拒否された操作は停止します。完全アクセスではありません。他のタスクの全体設定は変更しません。",+ "autoTaskDetail": "主タスクと Worker の操作を Cindy が自動審査します。確認が必要な操作や拒否された操作は停止します。完全アクセスではありません。現在のセッションの権限のみを変更し、プラグインの既定設定は変更しません。"},"groupTools": {"authorizationRequired": "グループの許可が失効したか、この操作は許可されていません。パートナーの所有者からこのグループで再度依頼してください。",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 1216c6f855..6e9e04af0c 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -17749,12 +17749,14 @@"pluginTaskWriteAccess": {"title": "이 플러그인의 AI가 파일을 수정하도록 허용할까요?","message": "“{{name}}”의 AI가 파일을 수정하도록 허용하고 계속할까요?",- "detail": "현재 세션에만 수정을 허용합니다. 별도의 작업 디렉터리는 시스템 샌드박스가 아니며, 명령에는 계속 Cindy의 권한 검사가 적용됩니다. 이 세션의 권한 메뉴에서 변경할 수 있습니다.",+ "detail": "이 플러그인의 AI 권한을 수정 가능으로 변경하며, 이후 작업에도 적용됩니다. 별도의 작업 디렉터리는 시스템 샌드박스가 아니며, 명령에는 계속 Cindy의 권한 검사가 적용됩니다. 플러그인 AI 설정에서 언제든지 읽기 전용으로 되돌릴 수 있습니다.",+ "taskDetail": "현재 세션에만 수정을 허용합니다. 별도의 작업 디렉터리는 시스템 샌드박스가 아니며, 명령에는 계속 Cindy의 권한 검사가 적용됩니다. 이 세션의 권한 메뉴에서 변경할 수 있습니다.","allow": "허용하고 계속","cancel": "지금은 허용 안 함","autoTitle": "Auto 자동 승인 사용","autoMessage": "“{{name}}”에 Auto 자동 승인을 허용할까요?",- "autoDetail": "Cindy가 주 작업과 Worker 동작을 자동 심사합니다. 확인이 필요하거나 거부된 동작은 일시 중지됩니다. 전체 접근 권한이 아닙니다. 현재 세션의 권한만 변경하며 플러그인 기본 설정은 변경하지 않습니다."+ "autoDetail": "Cindy가 주 작업과 Worker 동작을 자동 심사합니다. 확인이 필요하거나 거부된 동작은 일시 중지됩니다. 전체 접근 권한이 아니며 다른 작업의 전역 권한은 변경하지 않습니다.",+ "autoTaskDetail": "Cindy가 주 작업과 Worker 동작을 자동 심사합니다. 확인이 필요하거나 거부된 동작은 일시 중지됩니다. 전체 접근 권한이 아닙니다. 현재 세션의 권한만 변경하며 플러그인 기본 설정은 변경하지 않습니다."},"groupTools": {"authorizationRequired": "그룹 권한이 만료되었거나 이 작업이 허용되지 않습니다. 파트너 소유자가 이 그룹에서 다시 요청해 주세요.",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 2bb1c508c1..f72f1b9676 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -17749,10 +17749,12 @@"pluginTaskWriteAccess": {"autoTitle": "启用 Auto 自动审批","autoMessage": "允许“{{name}}”使用 Auto 自动审批?",- "autoDetail": "主任务和 Worker 的操作将交由 Cindy 自动审批。审批要求人工确认或拒绝时仍会暂停;这不是完全访问。仅更改当前任务的权限,不改动插件默认设置。",+ "autoDetail": "主任务和 Worker 的操作将交由 Cindy 自动审批。审批要求人工确认或拒绝时仍会暂停;这不是完全访问。此选择保存到插件 AI 设置,不改变其他任务的全局权限。",+ "autoTaskDetail": "主任务和 Worker 的操作将交由 Cindy 自动审批。审批要求人工确认或拒绝时仍会暂停;这不是完全访问。仅更改当前任务的权限,不改动插件默认设置。","title": "允许插件的 AI 修改文件?","message": "允许“{{name}}”的 AI 修改文件并继续?",- "detail": "仅将当前任务的权限设为“允许修改”。独立作答目录不是系统沙箱;命令仍遵循 Cindy 的权限检查。你可以在当前任务的权限菜单中调整。",+ "detail": "将此插件的 AI 权限设为“允许修改”,后续任务沿用此选择。独立作答目录不是系统沙箱;命令仍遵循 Cindy 的权限检查。你可以随时在插件 AI 设置中改回只读。",+ "taskDetail": "仅将当前任务的权限设为“允许修改”。独立作答目录不是系统沙箱;命令仍遵循 Cindy 的权限检查。你可以在当前任务的权限菜单中调整。","allow": "允许并继续","cancel": "暂不允许"},diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 4ed0b3c579..b97c31c9c1 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -17749,12 +17749,14 @@"pluginTaskWriteAccess": {"title": "允許此插件的 AI 修改檔案?","message": "允許「{{name}}」的 AI 修改檔案並繼續?",- "detail": "僅將目前任務的權限設為「允許修改」。獨立工作目錄不是系統沙箱;命令仍遵循 Cindy 的權限檢查。你可以在目前任務的權限選單中調整。",+ "detail": "將此插件的 AI 權限設為「允許修改」,後續任務也會沿用此選擇。獨立工作目錄不是系統沙箱;命令仍遵循 Cindy 的權限檢查。你可以隨時在插件 AI 設定中改回唯讀。",+ "taskDetail": "僅將目前任務的權限設為「允許修改」。獨立工作目錄不是系統沙箱;命令仍遵循 Cindy 的權限檢查。你可以在目前任務的權限選單中調整。","allow": "允許並繼續","cancel": "暫不允許","autoTitle": "啟用 Auto 自動審批","autoMessage": "允許「{{name}}」使用 Auto 自動審批?",- "autoDetail": "主任務與 Worker 的操作將交由 Cindy 自動審批。需要人工確認或遭拒時仍會暫停;這不是完全存取。僅變更目前任務的權限,不變更插件預設設定。"+ "autoDetail": "主任務與 Worker 的操作將交由 Cindy 自動審批。需要人工確認或遭拒時仍會暫停;這不是完全存取。此選擇儲存到插件 AI 設定,不變更其他任務的全域權限。",+ "autoTaskDetail": "主任務與 Worker 的操作將交由 Cindy 自動審批。需要人工確認或遭拒時仍會暫停;這不是完全存取。僅變更目前任務的權限,不變更插件預設設定。"},"groupTools": {"authorizationRequired": "群組授權已失效或不允許此操作,請由夥伴主人在目前群組重新發起。",diff --git a/apps/desktop/src/shared/ghost.ts b/apps/desktop/src/shared/ghost.tsindex 339cc013e0..89e7c3cae5 100644--- a/apps/desktop/src/shared/ghost.ts+++ b/apps/desktop/src/shared/ghost.ts@@ -6564,7 +6564,7 @@ export const GHOST_ERRAND_MIN_INTERVAL_MS = 10_000;export const GHOST_ERRAND_SESSION_KEY_RE = /^[A-Za-z0-9._-]{1,64}$/;/**- * 插件新建任务与普通任务使用同一三档;显式参数优先,其次有效默认配置,缺省 ask。+ * 插件新建任务与普通任务使用同一三档;启用卡片时受本插件设置上限约束,隐藏时不读取卡片。* plan / acceptEdits 仅保留旧配置及旧接口兼容,不自动升权或丢弃历史选择。*/export const GHOST_ERRAND_PERMISSION_MODES = [...PLUGIN_TASK_PERMISSION_MODES, 'plan', 'acceptEdits'] as const;diff --git a/apps/desktop/src/shared/pluginTasks.ts b/apps/desktop/src/shared/pluginTasks.tsindex a63aa39f56..408a338844 100644--- a/apps/desktop/src/shared/pluginTasks.ts+++ b/apps/desktop/src/shared/pluginTasks.ts@@ -94,7 +94,7 @@ export type PluginTaskRequest = (/** Opt in to Host naming after the first accepted message; omit title. */autoTitle?: boolean;route?: PluginTaskRoute;- /** New task only; requires Host task approval and does not change plugin defaults. */+ /** New task only; the plugin's Host card ceiling applies only when enabled. */permissionMode?: PluginTaskPermissionMode;isolatedWorkspace?: boolean;/** Requires `agent.hiddenTasks`; creates the task as a background task. */diff --git a/docs/dev-rules/plugin-security-and-authoring.md b/docs/dev-rules/plugin-security-and-authoring.mdindex dd7653e234..bbb8bdf449 100644--- a/docs/dev-rules/plugin-security-and-authoring.md+++ b/docs/dev-rules/plugin-security-and-authoring.md@@ -136,11 +136,13 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开但当前 Host 不展示、不授权、也不因此阻止安装或发布。未来 Host 识别该字段后,才按正常的能力展示和运行时守门链路启用。不能把未知字段猜成现有权限,也不能让它意外获得能力。-- 顶层 `showTaskPreferences?: boolean` 是每个插件自己的默认配置声明,不是 Cindy 全局开关。- 省略或 `true` 沿用原有能力条件并提供该插件的创建默认值;`false` 隐藏 Desktop 和手机上的卡片,- 且运行期不读取该插件的旧模型、目录和权限配置。旧数据保留,重新启用时恢复;其它插件不受影响。- 默认卡不承担授权上限,隐藏字段也不授予能力。Host 仍独立检查能力批准、任务归属、目录和 Session/Plan。- 旧客户端可能只隐藏卡片而继续读取配置;依赖解耦行为须使用实现此契约的 Host。+- 顶层 `showTaskPreferences?: boolean` 由每个插件在自己的 manifest 声明。+ 省略或 `true` 保持该插件的卡片配置、权限限制和执行规则;`false` 隐藏该插件的 Desktop/手机卡片,+ 且运行期不读取、不使用、不回写其模型、目录和权限配置。旧数据保留,重新启用后恢复。+ 此选择仅影响声明它的插件,不影响其它插件或全局设置。隐藏字段本身不授予宿主能力,+ 能力批准、账号、任务归属、目录与 Session/Plan 校验继续执行。+ 隐藏插件的新任务权限由插件参数决定,包括完全访问;不增加独立权限上限或逐次宿主确认。+ 旧 Host 可能只隐藏 UI;依赖停用语义须使用实现此契约的 Host。实现见 `getPluginTaskDefaults`、`ghostPluginViewModel.ts`、`mobilePageService.ts`;作者用法见 `FORGE_GUIDE` §4.8。- `agent.tasks` 另需 Host receipt 的显式任务能力批准事实;旧 receipt 没有该事实时,只在首次任务能力调用通过既有宿主权限界面确认,原插件的启用态、其它能力、凭证和@@ -214,7 +216,7 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开### 3.1 安装与自动更新-插件普通任务创建的 Worker 目录由宿主校验:允许当前任务目录及解析符号链接后仍在其中的子目录、用户通过目录选择器授权的确切目录。Library 绑定本身不授予 Agent 工作目录权限,协同计划也不构成目录授权。登记计划和实际创建 Worker 均复核授权;账号、实际任务配置或任务归属发生变化时拒绝继续创建;默认卡目录不作为额外授权根。+插件普通任务创建的 Worker 目录由宿主校验:允许当前任务目录及解析符号链接后仍在其中的子目录、已启用默认卡的插件 AI 配置目录、用户通过目录选择器授权的确切目录。Library 绑定本身不授予 Agent 工作目录权限,协同计划也不构成目录授权。登记计划和实际创建 Worker 均复核授权;账号、配置或任务归属发生变化时拒绝继续创建。这些目录授权只标识任务所在电脑的资源,不授权另一台电脑的同名目录。插件自有 Lead 不支持通过 `executionDeviceId` 新建跨设备 Worker:有无团队计划均在目录探测、槽位预留和远端创建之前拒绝。普通用户任务的跨设备 Worker 及插件既有 Worker 路径不变;不新增插件批准、配置或迁移。同一次 Worker 创建沿用最初的账号与任务归属,在启动 Session、续租完成后、写入 Worker 前再次复核。复核失败沿用既有尽力清理路径(关闭、移除运行缓存、归档 Session 与释放预留),不派发初始任务;新团队沿用创建失败收尾。@@ -488,15 +490,18 @@ Library 请求同时绑定迁移代次和安装批准,根解析、排队及开缺省从宿主验证的发起任务继承,面板无发起任务则使用当前新任务的完整选择,不优先翻找 Claude Code 的历史草稿。模型选择不授予权限或目录。保存、新建和插件派发前复用普通独立任务的模型/供应商/Agent 准入,不另建目录或选择器。连接状态不等于额度、网络及远端参数一定可用;执行失败如实返回,不静默换型号或账号。-- 插件须先取得 Host 的任务能力批准;已批准的插件可在 `tasks.create` 或 project 的- `targets.send` 显式选择默认权限(`ask`)/自动审批(`auto`)/完全访问(`bypassPermissions`)。- 省略时使用启用卡片的默认值,否则为 `ask`;不继承发起任务权限,也不写插件默认配置。- 默认卡不是授权上限。Main 在创建、异步准备、投递及排队接受时继续复核账号、批准、归属和实际任务状态。- 已有任务按自己的权限执行,默认卡改值不撤销或提升它的权限;已有任务/伙伴投递不接受权限覆盖。- 旧 `requestWriteAccess` 仍只支持 acceptEdits/auto,通过原宿主确认只改变目标 Session,不写回默认卡。- 旧 errand 适配器保留历史缺省 `plan`;历史 plan/acceptEdits 配置保留,但不列入新建接口和设置页的新选项。- 不把历史 `plan` 值宣称为跨 Agent 的只读保证。旧存储、IPC 和能力批准不迁移,无需重装或重新批准。- 来源优先级、复用和恢复见 [插件普通任务接口](plugin-task-api-implementation.md#模型配置与创建来源)。+- 已启用默认卡的插件新建普通任务,其权限沿用用户插件设置或既有宿主确认流程,默认普通任务的 `ask`,允许+ 用户显式选择默认权限(`ask`)/自动审批(`auto`)/完全访问(`bypassPermissions`);不继承发起任务的权限。+ 这类插件的 `tasks.create` 与 project 的 `targets.send` 可选 `permissionMode`,仅在当前用户插件权限上限内+ 选择本次新任务的 ask/auto/bypassPermissions;参数本身不授予权限、不写插件默认设置。+ 完全访问须来自用户在插件设置中的选择;旧 `requestWriteAccess` 仍只支持 acceptEdits/auto,+ 不增加完全访问确认弹窗,也不因复用该流程降低用户已授权的上限。+ Main 在创建前及异步准备后复核;省略参数保持旧行为,已有任务/伙伴投递不接受权限覆盖。+ 旧 errand 适配器保留历史缺省 `plan` 与原 Agent 行为;历史 plan/acceptEdits 配置保留,但不列入新建接口和设置页的新选项。已有任务不自动改权。+ 不把历史 `plan` 值宣称为跨 Agent 的只读保证,也不为它改造各 Agent 的权限引擎。+ 旧存储文件名、键及 IPC 保持兼容,升级不丢配置、不重批权限。来源优先级、复用和恢复+ 详见 [插件普通任务接口](plugin-task-api-implementation.md#模型配置与创建来源)。+ 隐藏卡片的插件不读取该上限,可通过已批准任务能力的创建参数自行选择;权限确认只改变目标 Session,不写回停用卡片。- 附件、媒体、目录和保存路径通过归属校验后的 grant/deposit/ledger 交接,**禁止把宿主绝对路径或不必要的字节暴露给沙箱**。媒体字节须走[`media-storage-and-protocols.md`](media-storage-and-protocols.md) 的统一入库。diff --git a/docs/dev-rules/plugin-task-api-implementation.md b/docs/dev-rules/plugin-task-api-implementation.mdindex a905674725..1b5bfe6fb6 100644--- a/docs/dev-rules/plugin-task-api-implementation.md+++ b/docs/dev-rules/plugin-task-api-implementation.md@@ -114,16 +114,16 @@ Host 每次调用都重新读取本插件的模型设置,复用创建任务的新任务选择;用户可为插件单独覆盖。模型、Agent、供应商、推理强度和 Fast 作为完整组合解析,绝不从另一 Agent 的历史草稿拼出一组值。权限独立设置,不随模型来源继承。-每个插件可在自己的 `ghost.json` 顶层声明 `showTaskPreferences: false`,隐藏 Desktop 和手机上的-宿主「模型与任务」默认卡,并停止读取该插件旧卡片的模型、目录和权限值。旧数据保留;重新启用-后恢复。省略或 `true` 仍按原有能力条件提供该插件的默认配置,其它插件不受影响。-运行期统一通过 `getPluginTaskDefaults` 读取有效默认值,原始存储只供设置页维护。-默认卡与宿主授权独立:卡片只提供缺省参数,不作为权限上限;Host 仍核验插件能力批准、账号/安装代次、-任务归属、目录/目标授权以及 Session 当前权限和 Plan 状态。旧 Host 可能只隐藏 UI,升级后才有解耦语义。+每个插件可在自己的 `ghost.json` 声明 `showTaskPreferences: false`,隐藏该插件在 Desktop/手机上的+宿主「模型与任务」卡片,并使该卡的全部配置在运行期无效。统一通过 `getPluginTaskDefaults` 判定,+隐藏时不读取、不采用、不回写其旧模型、目录或权限值;数据保留,重新启用后恢复。+省略或 `true` 保持该插件原有卡片配置、权限限制和执行规则;其它插件和全局设置不受影响。+以下卡片规则均只适用于启用卡片的插件;Host 的能力批准、账号/安装代次、任务归属、目录/目标授权和+Session/Plan 仍独立检查。旧 Host 可能只隐藏 UI,依赖停用语义须使用实现此契约的客户端。| 入口 | 模型来源与复用 | 权限与结果 || --- | --- | --- |-| `tasks.create` | 显式 route → 插件任务设置 → 经验证的 callId 发起任务 → 当前新任务选择;保存准入后的完整 route | 已批准任务能力的插件可选本次 permissionMode;省略沿用有效默认值,缺省 ask;返回普通任务及持久创建回执 |+| `tasks.create` | 显式 route → 插件任务设置 → 经验证的 callId 发起任务 → 当前新任务选择;保存准入后的完整 route | 可选 permissionMode;启用卡片时受其权限上限约束,隐藏时不读该上限;省略沿用设置,缺省 ask;返回普通任务及持久创建回执 || `tasks.send` | 使用该任务当前 route,检查 revision 和当前可用性;不因新默认变化重建任务 | 复核插件归属与权限;结果使用逐输入 run 回执 || `agent.errand` | 共用模型解析;无显式覆盖时优先保留已有专属任务的当前模型。配置冲突时只在新任务创建成功后替换映射,旧历史保留 | 旧权限边界、sessionKey、jobId 与结果取回协议保持兼容 || `workspace.ensureSession` | 已有工作区入口照常复用;新建才使用插件设置/发起任务/当前新任务完整组合 | 目录仍经亲选或原有确认流程;只建入口、不运行 Agent |@@ -146,11 +146,12 @@ Host 每次调用都重新读取本插件的模型设置,复用创建任务的自动审批(auto)和完全访问(bypassPermissions),用户明确选择后才覆盖旧值。`tasks.capabilities().createPermissionMode` 表示创建接口支持按次选择 ask/auto/bypassPermissions。-`tasks.create` 和 project 的 `targets.send` 接收可选 `permissionMode`,前提仍是 Host 已批准任务能力。-新参数只写入新 Session,不写插件默认配置;默认卡的权限值不限制本次显式选择。-新字段参与请求摘要,缺省不增加摘要项,因此旧回执仍能重放;创建期间复核账号、插件批准与实际使用的默认值。-已有任务和伙伴不接受该参数。既有 requestWriteAccess 仍只接受 acceptEdits/auto,通过原宿主确认-只改变目标 Session,不写回默认卡、不影响其它任务;不新增确认 UI 或授权存储。+`tasks.create` 和 project 的 `targets.send` 接收可选 `permissionMode`,仅写入新 Session,不修改插件偏好。+启用卡片时保留当前设置上限,不足返回 PERMISSION_DENIED;隐藏时不读取或比较卡片,插件自行传参,未传为 ask。+隐藏插件传入的三档权限直接用于新任务,包括完全访问;不新增独立权限上限或逐次宿主确认。+两类插件都须获得 Host 任务能力批准,并复核账号、归属与真实任务状态;已有任务与伙伴不接受该参数。+新字段参与请求摘要,缺省不增加摘要项,旧回执可重放。既有 requestWriteAccess 仅支持 acceptEdits/auto,+启用卡片时保持原写回规则,隐藏时只改变目标 Session;不新增确认 UI 或授权存储。`pluginTaskPrefsStore` 保留历史 `ghost-errand-prefs.json`、`errand` 与 `sessions` 键以及既有 IPC 名;无需重装、重新授权或人工迁移。`sessions` 键只供旧 errand 映射使用。@@ -184,11 +185,11 @@ Claude Code 适配层 `toSdkModelString` 会按目录窗口自动追加 `[1m]`- `capabilities/models/create/list/get/setModel/send/getRun/listRuns/readMessages/cancel/setHidden`。- create 可传 `hidden:true`、`setHidden({taskId, hidden})` 切换,`get`/`list` 快照恒返回 `hidden` 布尔值;仅身份卡声明 `agent.hiddenTasks: true`(必须同时 `agent.tasks: true`)时可用,见下文「后台任务」。-- create 可传 isolatedWorkspace:true,由宿主分配独立空作答目录;返回本任务 workingDir 与实际 permissionMode,Host 任务能力批准独立校验。-- 默认创建用户可见的普通本地 Session(声明 hiddenTasks 后可在同一次 INSERT 中创建后台任务);权限取显式参数或有效默认值,目录取已授权目标/有效默认目录或宿主分配;不接受任意目录或另一插件身份。普通任务创建前复用 Worker 的目录身份判据:配置路径必须仍为原规范路径,改链、缺失或非目录拒绝;异步解析后复核账号、tasks 批准及配置。缺省/isolatedWorkspace 仍由宿主分配目录,旧 errand 路径不变。旧别名配置没有原目标证据,不自动授权当前目标;这不解决校验后的目录置换窗口。+- create 可传 isolatedWorkspace:true,由宿主分配独立空作答目录;返回本任务 workingDir 与实际 permissionMode,按次选择不得超过用户授予插件的权限。+- 默认创建用户可见的普通本地 Session(声明 hiddenTasks 后可在同一次 INSERT 中创建后台任务);工作目录及权限来自用户配置,不接受插件传入绕过权限、任意目录或另一插件身份。普通任务创建前复用 Worker 的目录身份判据:配置路径必须仍为原规范路径,改链、缺失或非目录拒绝;异步解析后复核账号、tasks 批准及配置。缺省/isolatedWorkspace 仍由宿主分配目录,旧 errand 路径不变。旧别名配置没有原目标证据,不自动授权当前目标;这不解决校验后的目录置换窗口。- 发送走普通输入协调器,使用持久 requestKey 去重和稳定输入 ID;重复请求不会再次启动模型。- 指定 provider、model、effort、Fast 必须通过当前目录核验;派发前再次核验,不静默 fallback。-- 创建回执写入后、创建 Session 前,按原始请求重新解析路由并与已受理路由比较;实际使用的默认模型配置变化则拒绝,不静默使用旧值。目录解析及创建器的最终 continuation 复核实际使用的默认字段;隐藏或已被显式参数覆盖的卡片字段不参与判断。+- 创建回执写入后、创建 Session 前,按原始请求重新解析路由并与已受理路由比较;默认模型配置变化则拒绝,不静默使用旧值。目录解析及创建器的最终 continuation 同时复核 agentKind/model/provider/effort/Fast、目录和权限。- 本次创建在 Session INSERT 开始前明确失败(如配置、目录或工作区准备失败)时,沿现有回执队列撤回仍为原版本、且原始 Session 行不存在的新回执;修正原因后可用原 requestKey 显式重试,不自动重派。回执存储固定原账号数据库,撤销或版本变化的回执不删除。- 新请求的幂等摘要忽略对象键顺序,保留数组顺序;计划及已受理配置共用相同比较。早期开发版创建回执保留原序列化输入的精确重试兼容;这类旧摘要未保存原始键序,不能承诺首次以不同键序重放成功。- 回执独立落库,区分任务、输入执行及原生执行代次;原生终态按 instanceId + generation 结算,不以 idle 或最后一条 assistant 消息猜测完成。@@ -262,13 +263,13 @@ Claude Code 适配层 `toSdkModelString` 会按目录窗口自动追加 `[1m]`插件新增的 tasks 能力首次使用时复用宿主权限确认。拒绝、超时或确认失败后,同一账号代际和安装修订在当前宿主进程内不再自动弹窗;插件重载或重复调用不能清除该状态。用户可在本机插件详情权限区点击“确认任务权限”重新进入原确认流程,点击不等于批准;在途确认不并发,账号、安装修订或发起窗口改变时旧结果无效。旧插件的既有功能、启用态、凭证与设置不变。此显式入口不向插件页面或 device-link 暴露;重启宿主后可重新首次询问。-逻辑页可调用 cindy.tasks.requestWriteAccess({taskId, mode?})。省略 mode 保留旧行为(acceptEdits,仅限未开始执行的任务);mode: auto 请求宿主原生确认,仅为空闲自有任务启用 Auto,不写插件默认卡。插件不能替用户确认,该写权限请求接口不接受 Full access;新任务可经已批准的创建接口选择完全访问。拒绝不改状态;账号、插件批准或任务版本在确认期间改变则拒绝写入。Auto 插件主任务的 Worker 固定使用 Auto,不继承或改写全局 Worker 偏好;授权撤销后拒绝新建。Host 读取该次权限时一并保留账号与插件来源,在团队查询、Worker 准备/启动、落盘后以及首条输入的 accepted 回调中复核;在途卸载、重装、归属消失或降权不能将本次创建降为普通 Orca。调用开始前已明确撤销的旧用户任务仍可新发起普通 Orca。首条输入(任务或就绪消息)真正接收时沿现有回调再次复核;任务接收生命周期的异步更新前后均检查,失败回滚本次临时运行态并取消派发。直发拒绝后,在派发调用退出后才沿原生命周期清理新 Worker;排队后迟到的拒绝仅取消该输入并回滚本次临时状态,保留 Worker 和用户数据。既有内存回调不构成跨重启的授权事务,也不保证中断已接收执行。失败沿原生命周期尽力清理,不保证跨账号数据库补偿或跨进程事务。独立目录不是沙箱。返回 granted 与更新后的 task/revision,插件应继续原批次。+逻辑页可调用 cindy.tasks.requestWriteAccess({taskId, mode?})。省略 mode 保留旧行为(acceptEdits,仅限未开始执行的任务);mode: auto 请求宿主原生确认,为空闲自有任务启用 Auto;卡片启用时保留后续任务的原写回规则,隐藏时不读写卡片。插件不能替用户确认,该写权限请求接口不接受 Full access;启用卡片时,完全访问须由用户在插件设置中选择;隐藏时由已批准能力的创建参数指定。拒绝不改状态;账号、配置、任务版本在确认期间改变则拒绝写入。Auto 插件主任务的 Worker 固定使用 Auto,不继承或改写全局 Worker 偏好;授权撤销后拒绝新建。Host 读取该次权限时一并保留账号与插件来源,在团队查询、Worker 准备/启动、落盘后以及首条输入的 accepted 回调中复核;在途卸载、重装、归属消失或降权不能将本次创建降为普通 Orca。调用开始前已明确撤销的旧用户任务仍可新发起普通 Orca。首条输入(任务或就绪消息)真正接收时沿现有回调再次复核;任务接收生命周期的异步更新前后均检查,失败回滚本次临时运行态并取消派发。直发拒绝后,在派发调用退出后才沿原生命周期清理新 Worker;排队后迟到的拒绝仅取消该输入并回滚本次临时状态,保留 Worker 和用户数据。既有内存回调不构成跨重启的授权事务,也不保证中断已接收执行。失败沿原生命周期尽力清理,不保证跨账号数据库补偿或跨进程事务。独立目录不是沙箱。返回 granted 与更新后的 task/revision,插件应继续原批次。### 主任务协调评测插件拥有的主任务通过公共 `start_team` 显式请求 Worker Full access 时,Host 在原确认入口前复用当前插件归属与 Auto 判据,直接返回 PERMISSION_DENIED,不弹确认、不更新全局偏好或创建团队。Auto/省略参数和普通用户任务的 Full access 确认保持原流程;已撤权任务仍按当前接受输入的来源判定,旧插件执行不会变成普通用户调用。-Worker 创建后至首条输入真正接受,继续核对实际解析的目录与模型路由;落盘、创建预留释放、Lead 激活和排队接收不会结束这次校验。异步来源/计划读取后同步复核当前目录授权,Lead 工作目录变化或 picker 记录淘汰不能借旧检查放行。复用原创建失败补偿;排队后迟到拒绝只取消该输入,不删除已创建的 Worker。回调仅在 Host 内传递,不进入任务回执或 IPC 返回值。+Worker 创建后至首条输入真正接受,继续核对实际解析的目录与模型路由;落盘、创建预留释放、Lead 激活和排队接收不会结束这次校验。异步来源/计划读取后同步复核当前目录授权,配置目录被取消或 picker 记录淘汰不能借旧检查放行。复用原创建失败补偿;排队后迟到拒绝只取消该输入,不删除已创建的 Worker。回调仅在 Host 内传递,不进入任务回执或 IPC 返回值。模型调用的暂停 Worker、归档、结束团队与切换焦点,也复用当前输入来源和插件权限检查;关闭、归档及既有目录锁等待后的写入前复核。原有延后完成确认保存同次调用的核验回调,消费一次后不重登记;独立用户确认不继承模型限制。用户 UI/远程控制的停止清理及内部失败补偿保持原入口。多步清理途中拒绝可能已有局部效果,不构成跨工具授权事务,也不保证停止已接受的原生执行。@@ -280,11 +281,11 @@ Worker 创建后至首条输入真正接受,继续核对实际解析的目录首次协同计划检查落盘 user 消息与任务开始/结束时间;清空或回退对话不会抹除执行事实。目录核验到保存复用普通发送锁,同计划重放仍保持幂等。-`tasks.startTeam({taskId})` 为本插件拥有的普通任务启用 Orca Lead,复用现有协同入口及 Worker 权限确认。插件不能指定 Worker 权限绕过确认。确认返回后检查原修订;团队查询、创建和 Lead 激活后复用同一准入回调,核对原账号、插件归属/批准、当前 Auto/Plan、任务路由与目录。默认卡不参与协作准入。正常成为 Lead 会改变包含角色的修订,原生阶段改比这些准入事实,不把本次角色变化误判为用户变更。`tasks.getTeam({taskId})` 只投影所属团队的 Worker 身份、实际模型配置、目录、队列和终态;不会将 Lead 一轮完成解释为整个团队完成。+`tasks.startTeam({taskId})` 为本插件拥有的普通任务启用 Orca Lead,复用现有协同入口及 Worker 权限确认。插件不能指定 Worker 权限绕过确认。确认返回后检查原修订;团队查询、创建和 Lead 激活后复用同一准入回调,核对原账号、插件归属/批准、当前 Auto/Plan、任务路由与目录以及插件配置目录。正常成为 Lead 会改变包含角色的修订,原生阶段改比这些准入事实,不把本次角色变化误判为用户变更。`tasks.getTeam({taskId})` 只投影所属团队的 Worker 身份、实际模型配置、目录、队列和终态;不会将 Lead 一轮完成解释为整个团队完成。-协同启动要求任务仍为 active;创建或激活中的归档、能力撤回、任务降权及任务配置变化会拒绝本次调用;默认卡变动不影响已有任务。新建团队沿原 lifecycle 补偿标为 failed,清理 Lead 角色及运行态选项,不删除任务或成果;复用已有团队时只拒绝本次调用,不结束原团队。检查与尽力补偿均处于原生操作的 drain 跟踪内;存储补偿失败仍返回失败,不保证跨账号数据库补偿,也不宣称最终复核与后续跨进程归档形成事务。+协同启动要求任务仍为 active;创建或激活中的归档、撤权、降权及配置变化会拒绝本次调用。新建团队沿原 lifecycle 补偿标为 failed,清理 Lead 角色及运行态选项,不删除任务或成果;复用已有团队时只拒绝本次调用,不结束原团队。检查与尽力补偿均处于原生操作的 drain 跟踪内;存储补偿失败仍返回失败,不保证跨账号数据库补偿,也不宣称最终复核与后续跨进程归档形成事务。-插件可读取自己任务在权限变化后的状态与执行停止;新发送按该 Session 当前权限运行,不与默认卡比较。任务快照同时返回独立的 planModeEnabled 与原 permissionMode;独立 Plan Mode 开启时拒绝新发送、排队接受、写权限请求及 Worker/团队启动,不以原 Auto/AcceptEdits 作为执行授权。普通 permissionMode 为 plan 的既有流程保持不变。既有普通任务的所有权收据在成为 Lead 后继续有效;Worker 不是插件直接控制的普通任务。+插件可读取自己任务在权限变化后的状态与执行停止,但新发送拒绝超出插件策略的 full access 任务。任务快照同时返回独立的 planModeEnabled 与原 permissionMode;独立 Plan Mode 开启时拒绝新发送、排队接受、写权限请求及 Worker/团队启动,不以原 Auto/AcceptEdits 作为执行授权。普通 permissionMode 为 plan 的既有流程保持不变。既有普通任务的所有权收据在成为 Lead 后继续有效;Worker 不是插件直接控制的普通任务。评测客户端每批仅创建一个 Lead,答案目录逐份隔离,由 Lead 使用原生 Orca 调度。插件根据 Worker 成员、配置、目录、done 且无活动/队列的状态独立验收。该投影不是逐轮执行账本,不作为精确费用证据。重试先核对既有 Worker;未知归属不得重派或算零分。停止须确认 Lead 停止处理完成和团队不再活动。@@ -294,7 +295,7 @@ getTeam 的 completedAt 可由宿主落盘的 turnCompleted 终态恢复:仅`setTeamPlan({taskId,plan:{concurrency,items}})` 在本插件自己的创建收据中冻结计划。首次登记必须早于输入派发和 Worker 创建(包括创建预留);同一计划的幂等重放不受此限制。每项含唯一 label、workingDir 和精确 route;重复设置必须一致。未登记计划的存量任务保留读取、停止和已有成果,但不能据此取得委派 Auto 自动授权。Worker 创建复用原子 reservation,预留后再次核对计划,计划上限只可收窄宿主硬上限。已结算 label 持久保留,不因归档再次变成可派发项。-目录准入仅使用当前 Lead 工作目录及其子目录或用户亲选的确切目录,不把默认卡目录当作额外授权根。计划保存目录准入返回的 canonical 路径,后续别名改链不会把冻结计划改成新目标;这不构成 OS 目录对象隔离。首版仅用于可信本地工作区,不防御同权限进程在最后校验后、harness 使用 cwd 前恶意替换目录对象;路径复核或 JS 锁不能消除该窗口,不把另建 OS 隔离后端列为本接口的发布前提。插件归属、显式撤权、用户降权与任务范围的检查仍须成立。`getTeam` 先恢复 Lead 的持久输入队列,恢复失败或未确认时拒绝返回空闲;最终读取实时 Lead 状态,不以启动后的空内存队列报告批次完成。+计划保存目录准入返回的 canonical 路径,后续别名改链不会把冻结计划改成新目标;这不构成 OS 目录对象隔离。首版仅用于可信本地工作区,不防御同权限进程在最后校验后、harness 使用 cwd 前恶意替换目录对象;路径复核或 JS 锁不能消除该窗口,不把另建 OS 隔离后端列为本接口的发布前提。插件归属、显式撤权、用户降权与任务范围的检查仍须成立。`getTeam` 先恢复 Lead 的持久输入队列,恢复失败或未确认时拒绝返回空闲;最终读取实时 Lead 状态,不以启动后的空内存队列报告批次完成。`releaseWorker({taskId,workerId,completedAt})` 仅释放本插件 Lead 内、结束时间仍匹配、无活动/排队输入的 Worker。它与 getTeam 共用宿主成功终态判据,不能以 Worker 更新时间或失败轮结束时间替代交卷凭据。调用方应先保存交卷快照和评分。复用 Orca 的归档路径、transition 锁和发送锁;持锁后再次核对 completedAt 与归属。有计划时必须在归档前确认标签归属;无计划的兼容调用不写标签结算。已有发送锁时直接拒绝释放,不等待而形成锁反转;只有归档成功才结算 label。拒绝正在发送或运行的 Worker,保留任务历史与作答文件。@@ -319,7 +320,7 @@ Host 只接受经绑定插件身份写入的自有创建收据;已登记计划已识别插件任务的协调任务或 Worker 缺少有效范围时返回既有 authorizationError,在缓存、本地安全动作或 Host MCP 快捷路径之前拒绝自动授权;不退回普通任务、不从消息补造范围。旧计划继续可读,不事后补填;新范围须在新任务中登记完整计划。Ask/acceptEdits 保留既有逐次人工确认,普通无插件归属任务不受此限制。没有新增权限档位、没有提升到 Full access。-审批在查询缓存前重新核对插件批准版本、启用状态、任务/Lead 的 Auto 权限、账号 epoch、任务状态、+审批在查询缓存前重新核对插件批准版本、启用状态、启用卡片时的 Auto 设置、账号 epoch、任务状态、团队归属和计划匹配;异步结果返回前再次核对。历史投影和归属读取完成后,以同一条只读 SQL 比较本次使用的任务/Lead 权限、独立 Plan、状态、路由目录、团队链接及计划收据,并复核授权投影修订号仍与读取值一致、投影已同步且版本为 3;变化拒绝本次授权,查询失败保留 unavailable。该检查同时覆盖 Lead 和 Worker 的真人证据变化,不只检查当前 Worker 的意图。Lead 或 Worker 已开启独立 Plan 时不恢复委派 Auto。Worker 别名目录的异步解析在该次归属和最终授权核验之前完成;核验后只同步消费本次目录匹配结果,不再等待文件系统读取。该结果不写入回执,也不替代可信本地工作区边界。@@ -358,7 +359,7 @@ Pi 子代理未成功投递的自动 allow 再次投递前重走现有核验,- `resolve({target:{kind,id}})` 返回最新目标元数据,供插件校验保存的固定目标;无写入、弹窗或隐式选中。`send` 同样重新校验目标,不要求先 list/resolve,也不接受任意不可用路径或目标;失效返回 TARGET_UNAVAILABLE,不降级改投。- `send({target,requestKey,text,context?,title?,autoTitle?,route?,permissionMode?,delivery?,attachments?})` 在指定项目中新建普通任务,或向指定普通任务/伙伴投递。- 新任务经现有 `PluginTaskService.create` 登记归属后使用 `createPluginTaskSession`,使用显式参数或有效默认配置,保留能力批准及卸载撤销流程;可传统一模型目录的 route 与 permissionMode。+ 新任务经现有 `PluginTaskService.create` 登记归属后使用 `createPluginTaskSession`,沿用插件模型选择、受限动手权限及卸载撤销流程,可传统一模型目录的 route,以及当前授权范围内的 permissionMode。存量任务和伙伴保留其模型、权限、目录,不接受 route 或 permissionMode;伙伴通过唯一 canonical 注册解析,不使用兼容镜像或伪造伙伴身份。- 同键并发发送共享同一 Promise。回执复用当前账号 SQLite 的 `plugin_task_requests`,以 `operation=target` 按插件和请求键读写单行;只保存请求摘要、Host 生成的 taskId/clientId、批准修订和状态,不保存正文、图片或插件固定配置。执行前原子预留回执;已接受请求可在重启后返回原结果,尚未确定的回执返回 DELIVERY_UNCERTAIN,