Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(plugins): 插件任务新增 archive,归档自有的空闲任务

Dashebffbcc853d3
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.md
index 7e9a207a48..af2c1ac1c4 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
@@ -270,7 +270,8 @@ text 与 context 合计不超过 64000;tasks.send 的 text 上限仍为 32768
不接受自报 confirmed。权限参与幂等摘要,同键修改返回冲突;缺省旧请求可重放,旧 Host 未声明支持时不发新参数。
原有 `cindy.tasks` 的归属限制不变。先调用 `capabilities()` 获取实际支持操作。当前仅支持本插件创建的本机普通任务:
-`models`、`create`、`get`、`setModel`、`list`、`send`、`getRun`、`listRuns`、`readMessages`、`cancel`、`setHidden`。
+`models`、`create`、`get`、`setModel`、`list`、`send`、`getRun`、`listRuns`、`readMessages`、`cancel`、`setHidden`、`archive`。
+`archive({taskId})` 归档自有的空闲任务(执行中或有排队输入时 `TASK_BUSY`),用户可随时恢复;没有删除接口。按视频、按文档等开新任务的插件,切换时归档上一条,避免后台任务堆积。
可对自有任务调用 `startTeam({taskId})` 启用 Orca 主任务,并用 `getTeam({taskId})` 读取实际协同状态。协调主任务需经用户授权 Auto,Worker 自动沿用 Auto。
这些任务及其 Worker 不提供 `cindy_helper` 的账号级历史或跨任务控制能力,`cindy_memory.session_search` 也拒绝历史检索;协调使用独立 Orca 工具,结果由插件通过 `readMessages/getTeam` 读取。旧 errand/workspace 不因来源标记受到限制;明确卸载撤销归属后,调用方已无正在执行的输入或已接受新真人输入时,保留的用户任务恢复普通 helper 与历史检索能力;仍执行旧插件输入时继续受限,自动回报和插件输入重试不构成真人接管。这不恢复插件控制权,也不保证停止已接受执行,不构成通用执行沙箱。
在首次派发前调用 `setTeamPlan({taskId,plan:{concurrency,task,items}})`,每项包含
diff --git a/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts b/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts
index f5fa829897..89dcdb4a82 100644
--- a/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts
+++ b/apps/desktop/src/main/cindy-brain/__tests__/taskSlot.test.ts
@@ -190,6 +190,19 @@ describe('background tasks (agent.hiddenTasks)', () => {
expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'get', taskId: 'own', hidden: true })).toBe(false);
});
+ it('validates the archive operation shape and advertises it to every tasks plugin', async () => {
+ // Rule: archive is reversible housekeeping for a plugin's own tasks; no hiddenTasks declaration needed. tier: unit.
+ expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'archive', taskId: 'own' })).toBe(true);
+ expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'archive' })).toBe(false);
+ expect(validPluginTaskRequest({ type: 'tasks-request', kind: 'archive', taskId: 'own', hidden: true })).toBe(false);
+ const handler = vi.fn(async () => ({ taskId: 'own', status: 'archived' }));
+ const deps = { getGhost: () => undeclared, handler, isCurrent: () => true };
+ expect(await handlePluginTaskRequest('p', { type: 'tasks-request', kind: 'archive', taskId: 'own' }, deps))
+ .toEqual({ ok: true, data: { taskId: 'own', status: 'archived' } });
+ const caps = await handlePluginTaskRequest('p', { type: 'tasks-request', kind: 'capabilities' }, deps);
+ expect((caps as { data: { operations: string[] } }).data.operations).toContain('archive');
+ });
+
it('denies hidden creation and setHidden without the declaration, before reaching the handler', async () => {
const handler = vi.fn(async () => ({ taskId: 't' }));
const deps = { getGhost: () => undeclared, handler, isCurrent: () => true };
diff --git a/apps/desktop/src/main/cindy-brain/taskSlot.ts b/apps/desktop/src/main/cindy-brain/taskSlot.ts
index 64634304bb..375b3c7977 100644
--- a/apps/desktop/src/main/cindy-brain/taskSlot.ts
+++ b/apps/desktop/src/main/cindy-brain/taskSlot.ts
@@ -23,6 +23,7 @@ export const PLUGIN_TASK_OPERATIONS = [
'cancel',
'readMessages',
'setHidden',
+ 'archive',
] as const;
export type PluginTaskHandler = (pluginId: string, request: PluginTaskRequest) => Promise<unknown>;
const object = (v: unknown): v is Record<string, unknown> =>
@@ -49,6 +50,7 @@ export function validPluginTaskRequest(value: unknown): value is PluginTaskReque
readMessages: ['taskId', 'after', 'limit'],
cancel: ['runId', 'requestKey'],
setHidden: ['taskId', 'hidden'],
+ archive: ['taskId'],
};
if (typeof value.kind !== 'string' || !Object.hasOwn(allowed, value.kind)) return false;
const kind = value.kind;
@@ -58,7 +60,7 @@ export function validPluginTaskRequest(value: unknown): value is PluginTaskReque
if (kind === 'requestWriteAccess' && value.mode !== undefined && !['acceptEdits', 'auto'].includes(String(value.mode))) return false;
const requires = (key: string) => text(value[key], 128);
if (['create', 'send', 'cancel'].includes(value.kind) && !requires('requestKey')) return false;
- if (['get', 'setModel', 'send', 'listRuns', 'readMessages', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'setHidden'].includes(value.kind) && !requires('taskId'))
+ if (['get', 'setModel', 'send', 'listRuns', 'readMessages', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'setHidden', 'archive'].includes(value.kind) && !requires('taskId'))
return false;
if (kind === 'setHidden' && typeof value.hidden !== 'boolean') return false;
if (value.hidden !== undefined && typeof value.hidden !== 'boolean') return false;
diff --git a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts
index 2c86e6b484..abf818ee54 100644
--- a/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts
+++ b/apps/desktop/src/main/maker-ipc/__tests__/pluginTaskService.test.ts
@@ -1438,6 +1438,25 @@ it('an open plugin selection without a source session follows the auxiliary chai
await expect(run([{ agentKind: 'codex', providerId: f.route.providerId, model: 'cheap' }], { model: 'next' })).resolves.toMatchObject({ model: 'next' });
});
+it('archives only its own idle task through the host writer and treats archived tasks as done', async () => {
+ // Rule: plugins rotate per-video tasks and archive the previous one; a working task is never cut off. tier: unit.
+ const f = fixture(), task = await f.create();
+ f.deps.archive = vi.fn(async (taskId: string, assertAllowed: () => void) => {
+ assertAllowed();
+ f.tasks.set(taskId, { ...f.tasks.get(taskId)!, status: 'archived' });
+ });
+ (f.deps.inspect as ReturnType<typeof vi.fn>).mockResolvedValueOnce({ execution: f.execution, pending: [] });
+ await expect(f.service.archive('p', { taskId: task.taskId })).rejects.toMatchObject({ code: 'TASK_BUSY' });
+ expect(f.deps.archive).not.toHaveBeenCalled();
+ expect((await f.service.archive('p', { taskId: task.taskId })).status).toBe('archived');
+ expect((await f.service.archive('p', { taskId: task.taskId })).status).toBe('archived');
+ expect(f.deps.archive).toHaveBeenCalledTimes(1);
+ await expect(f.service.archive('other', { taskId: task.taskId })).rejects.toMatchObject({ code: 'TASK_NOT_FOUND' });
+ await expect(f.service.send('p', { taskId: task.taskId, requestKey: 'late', expectedRevision: task.revision, text: 'x' })).rejects.toMatchObject({ code: 'TASK_BUSY' });
+ const bare = fixture(), plain = await bare.create();
+ await expect(bare.service.archive('p', { taskId: plain.taskId })).rejects.toMatchObject({ code: 'HOST_NOT_READY' });
+});
+
it.each([
['provider', 'reset'], ['provider', 'partial'],
['mutation', 'reset'], ['mutation', 'partial'],
diff --git a/apps/desktop/src/main/maker-ipc/pluginTaskService.ts b/apps/desktop/src/main/maker-ipc/pluginTaskService.ts
index d0451b07be..421ef2c339 100644
--- a/apps/desktop/src/main/maker-ipc/pluginTaskService.ts
+++ b/apps/desktop/src/main/maker-ipc/pluginTaskService.ts
@@ -173,6 +173,8 @@ export interface PluginTaskServiceDeps {
setHidden?(taskId: string, hidden: boolean, assertAllowed: () => void): Promise<void>;
/** Uninstall fallback: reveal this plugin's background tasks before ownership is revoked. */
revealPluginTasks?(pluginId: string): Promise<void>;
+ /** Host archive writer (same path as the sidebar); `assertAllowed` runs right before the write. */
+ archive?(taskId: string, assertAllowed: () => void): Promise<void>;
setModel?(taskId: string, route: PluginTaskRoute, assertCurrent: () => Promise<void>): Promise<{ status: string }>;
readSession(taskId: string): Promise<PluginTaskView | null>;
readLiveSession(taskId: string): Pick<Session, 'instanceId' | 'stablePlanModeState'> | undefined;
@@ -507,6 +509,22 @@ export function createPluginTaskService(deps: PluginTaskServiceDeps) {
}
return ownTask(pluginId, request.taskId);
}),
+ /**
+ * Archive this plugin's own idle local task. Reversible by the user (unarchive) and never a
+ * delete; a task with live execution or queued input stays active so nothing is cut off.
+ */
+ archive: (pluginId: string, request: { taskId: string }) => exclusive(async () => {
+ const task = await ownTask(pluginId, request.taskId);
+ if (task.status === 'archived') return task;
+ if (!deps.archive) return fail('HOST_NOT_READY', 'Task archive service is not ready');
+ const observed = await deps.inspect(request.taskId);
+ if (observed.execution || observed.pending.length) return fail('TASK_BUSY', 'The task is still working');
+ await deps.archive(request.taskId, () => {
+ deps.assertCurrent();
+ deps.assertAuthorized(pluginId);
+ });
+ return ownTask(pluginId, request.taskId);
+ }),
list: (pluginId: string, after = '', limit = 50) =>
exclusive(async () => {
deps.assertAuthorized(pluginId);
diff --git a/apps/desktop/src/main/maker-ipc/register.ts b/apps/desktop/src/main/maker-ipc/register.ts
index 38d5a1fee5..95bead7903 100644
--- a/apps/desktop/src/main/maker-ipc/register.ts
+++ b/apps/desktop/src/main/maker-ipc/register.ts
@@ -1336,7 +1336,7 @@ import {
closeRejectedRuntimeAndRestoreControlStores,
isRemoteModelSwitchRouteChangeError,
} from './runtimeSetModel.js';
-import { updateSessionInDb } from '../localDb/ipc/sessions.js';
+import { patchSessionMetaInDb, updateSessionInDb } from '../localDb/ipc/sessions.js';
import { codexThreadTransferSourcePredicate, commitCodexThreadTransfer, relinkCodexProviderThread } from './codexProviderThreadRelink.js';
import {
codexCustomProviderConfigSignature,
@@ -14316,6 +14316,10 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)
setHidden: async (taskId, hidden, assertAllowed) => {
await setSessionHidden({ sessionId: taskId, hidden, db: snapshot.client, assertCurrent: assertAllowed });
},
+ // Same archive path as the sidebar and remote archive: status persisted plus sessions:patched broadcast.
+ archive: async (taskId, assertAllowed) => {
+ await patchSessionMetaInDb(taskId, { status: 'archived' }, { beforeWrite: assertAllowed });
+ },
revealPluginTasks: async pluginId => {
// 不受详情页列表的展示上限约束:分批恢复全部,避免卸载撤销归属后仍有任务隐藏。
await revealAllPluginHiddenTasks(snapshot.client, pluginId, taskId =>
@@ -14680,6 +14684,7 @@ export function registerMakerIpc(maker: Maker, options: RegisterMakerIpcOptions)
case 'create': return service.create(pluginId, request);
case 'get': return service.get(pluginId, request.taskId);
case 'setHidden': return service.setHidden(pluginId, request);
+ case 'archive': return service.archive(pluginId, request);
case 'list': return service.list(pluginId, request.after, request.limit);
case 'send': return service.send(pluginId, request);
case 'readMessages': {
diff --git a/apps/desktop/src/preload/ghostPreload.ts b/apps/desktop/src/preload/ghostPreload.ts
index 847830b453..82e7f290b1 100644
--- a/apps/desktop/src/preload/ghostPreload.ts
+++ b/apps/desktop/src/preload/ghostPreload.ts
@@ -81,7 +81,7 @@ contextBridge.exposeInMainWorld('cindy', {
},
])),
tasks: Object.fromEntries(
- ['capabilities', 'models', 'setModel', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'create', 'list', 'get', 'send', 'getRun', 'listRuns', 'cancel', 'readMessages', 'setHidden'].map(kind => [
+ ['capabilities', 'models', 'setModel', 'requestWriteAccess', 'startTeam', 'getTeam', 'setTeamPlan', 'releaseWorker', 'create', 'list', 'get', 'send', 'getRun', 'listRuns', 'cancel', 'readMessages', 'setHidden', 'archive'].map(kind => [
kind, async (req: Record<string, unknown> = {}): Promise<unknown> => {
const result = await ipcRenderer.invoke('ghost-pipe:send', { ...req, type: 'tasks-request', kind });
if (result?.ok === true) return result.data;
diff --git a/apps/desktop/src/shared/pluginTasks.ts b/apps/desktop/src/shared/pluginTasks.ts
index 408a338844..28edc992a5 100644
--- a/apps/desktop/src/shared/pluginTasks.ts
+++ b/apps/desktop/src/shared/pluginTasks.ts
@@ -101,6 +101,8 @@ export type PluginTaskRequest = (
hidden?: boolean;
}
| { type: 'tasks-request'; kind: 'setHidden'; taskId: string; hidden: boolean }
+ /** Archive this plugin's own idle task; the user can unarchive it from the task list or plugin page. */
+ | { type: 'tasks-request'; kind: 'archive'; taskId: string }
| { type: 'tasks-request'; kind: 'list'; after?: string; limit?: number }
| { type: 'tasks-request'; kind: 'get'; taskId: string }
| { type: 'tasks-request'; kind: 'startTeam' | 'getTeam'; taskId: string }
diff --git a/docs/dev-rules/plugin-task-api-implementation.md b/docs/dev-rules/plugin-task-api-implementation.md
index 1b5bfe6fb6..2f5ea2da6d 100644
--- a/docs/dev-rules/plugin-task-api-implementation.md
+++ b/docs/dev-rules/plugin-task-api-implementation.md
@@ -183,7 +183,8 @@ Claude Code 适配层 `toSdkModelString` 会按目录窗口自动追加 `[1m]`
## 已接入
-- `capabilities/models/create/list/get/setModel/send/getRun/listRuns/readMessages/cancel/setHidden`。
+- `capabilities/models/create/list/get/setModel/send/getRun/listRuns/readMessages/cancel/setHidden/archive`。
+- `archive({taskId})` 归档本插件自建的空闲本地任务(有执行中或排队输入时返回 `TASK_BUSY`),走与侧栏归档相同的 `patchSessionMetaInDb` 路径;可逆(用户可恢复),不提供删除。归档后的任务由「存储空间 → 数据库清理」按既有规则处理。
- create 可传 `hidden:true`、`setHidden({taskId, hidden})` 切换,`get`/`list` 快照恒返回 `hidden` 布尔值;仅身份卡声明 `agent.hiddenTasks: true`(必须同时 `agent.tasks: true`)时可用,见下文「后台任务」。
- create 可传 isolatedWorkspace:true,由宿主分配独立空作答目录;返回本任务 workingDir 与实际 permissionMode,按次选择不得超过用户授予插件的权限。
- 默认创建用户可见的普通本地 Session(声明 hiddenTasks 后可在同一次 INSERT 中创建后台任务);工作目录及权限来自用户配置,不接受插件传入绕过权限、任意目录或另一插件身份。普通任务创建前复用 Worker 的目录身份判据:配置路径必须仍为原规范路径,改链、缺失或非目录拒绝;异步解析后复核账号、tasks 批准及配置。缺省/isolatedWorkspace 仍由宿主分配目录,旧 errand 路径不变。旧别名配置没有原目标证据,不自动授权当前目标;这不解决校验后的目录置换窗口。