@agimon-ai/doompi-task 0.0.1-alpha.39 → 0.0.1-alpha.40

package/README.md

@@ -1,13 +1,10 @@
 # @agimon-ai/doompi-task
 
-A persistent, dependency-aware task graph for Pi, with an optional delegation bridge to DoomPi
-Team.
+Track persistent, dependency-aware tasks in Pi and optionally delegate them through DoomPi Team.
 
 Part of the [DoomPi distribution](https://www.npmjs.com/package/@agimon-ai/doompi).
 
-Task owns task records and `tasks.json`. Team owns agents and runs. Loading both lets Task delegate
-pending work through Team's session-bound `doom/delegation` Cordis service; it does not merge their
-persistence.
+Task owns task records and `tasks.json`. Team owns agents and runs. When both are loaded, Task delegates pending work through Team without merging their stored state.
 
 > **Alpha:** task and delegation contracts may change between releases.
 

package/dist/adapters/webTasksChannel.cjs

@@ -0,0 +1,2 @@
+const e=require("./store/paths.cjs"),t=require("./store/taskStore.cjs"),n=require("../types/webTasks.cjs");function r(e){return{tasks:e.tasks.flatMap(e=>{if(e.status===`deleted`)return[];let t={id:e.id,subject:e.subject,status:e.status,blockedBy:e.blockedBy??[]};return e.description&&(t.description=e.description),e.activeForm&&(t.activeForm=e.activeForm),e.owner&&(t.owner=e.owner),e.updatedAt&&(t.updatedAt=e.updatedAt),e.delegation&&(t.delegation={agent:e.delegation.agent,state:e.delegation.state}),[t]}),rev:e.rev}}function i(i={}){return{frameType:n.TASKS_CHANNEL_TYPE,start(n){let a=new Map,o=o=>{if(a.has(o.sessionId))return;let s=i.storeFor?.(o)??new t.TaskStore({cwd:o.cwd,storePath:e.resolveStorePath(o.cwd,process.env,o.sessionId)}),c=s.read(),l=s.onExternalChange(e=>n.publish(o.sessionId,r(e)));a.set(o.sessionId,{store:s,unwatch:l}),c.tasks.length>0&&n.publish(o.sessionId,r(c))},s=e=>{let t=a.get(e);t&&(t.unwatch(),t.store.dispose(),a.delete(e))};for(let e of n.sessions())o(e);return{payloadFor(e){o(e);let t=a.get(e.sessionId)?.store.snapshot;return t===void 0?void 0:r(t)},sessionAdded:o,sessionRemoved:s,close(){for(let e of a.keys())s(e)}}}}}const a=[i()];exports.createTasksChannel=i,exports.webHubChannels=a;
+//# sourceMappingURL=webTasksChannel.cjs.map

package/dist/adapters/webTasksChannel.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTasksChannel.cjs","names":["TASKS_CHANNEL_TYPE","TaskStore","resolveStorePath"],"sources":["../../src/adapters/webTasksChannel.ts"],"sourcesContent":["import type { HubChannelSource, HubSessionScope, WebHubChannel } from '@agimon-ai/doompi-web-contracts';\nimport { resolveStorePath } from './store/paths.ts';\nimport { TaskStore } from './store/taskStore.ts';\nimport type { TaskDocument } from '../services/store/types.ts';\nimport { TASKS_CHANNEL_TYPE, type WebTask, type WebTasksPayload } from '../types/webTasks.ts';\n\ninterface TaskStoreSource {\n  readonly snapshot: TaskDocument;\n  read(): TaskDocument;\n  onExternalChange(listener: (document: TaskDocument) => void): () => void;\n  dispose(): void;\n}\n\nexport interface TasksChannelOptions {\n  /** Injectable for tests. The default opens the session tree's durable task store. */\n  storeFor?: (scope: HubSessionScope) => TaskStoreSource;\n}\n\nfunction present(document: TaskDocument): WebTasksPayload {\n  const tasks: WebTask[] = document.tasks.flatMap((task) => {\n    if (task.status === 'deleted') return [];\n    const view: WebTask = {\n      id: task.id,\n      subject: task.subject,\n      status: task.status,\n      blockedBy: task.blockedBy ?? [],\n    };\n    if (task.description) view.description = task.description;\n    if (task.activeForm) view.activeForm = task.activeForm;\n    if (task.owner) view.owner = task.owner;\n    if (task.updatedAt) view.updatedAt = task.updatedAt;\n    if (task.delegation) {\n      view.delegation = { agent: task.delegation.agent, state: task.delegation.state };\n    }\n    return [view];\n  });\n  return { tasks, rev: document.rev };\n}\n\n/** Publishes each managed session's durable task graph and follows external subagent writes. */\nexport function createTasksChannel(options: TasksChannelOptions = {}): WebHubChannel {\n  return {\n    frameType: TASKS_CHANNEL_TYPE,\n    start(host) {\n      const stores = new Map<string, { store: TaskStoreSource; unwatch: () => void }>();\n      const open = (scope: HubSessionScope): void => {\n        if (stores.has(scope.sessionId)) return;\n        const store =\n          options.storeFor?.(scope) ??\n          new TaskStore({ cwd: scope.cwd, storePath: resolveStorePath(scope.cwd, process.env, scope.sessionId) });\n        const document = store.read();\n        const unwatch = store.onExternalChange((changed) => host.publish(scope.sessionId, present(changed)));\n        stores.set(scope.sessionId, { store, unwatch });\n        if (document.tasks.length > 0) host.publish(scope.sessionId, present(document));\n      };\n      const close = (sessionId: string): void => {\n        const source = stores.get(sessionId);\n        if (!source) return;\n        source.unwatch();\n        source.store.dispose();\n        stores.delete(sessionId);\n      };\n      for (const scope of host.sessions()) open(scope);\n\n      const source: HubChannelSource = {\n        payloadFor(scope) {\n          open(scope);\n          const document = stores.get(scope.sessionId)?.store.snapshot;\n          return document === undefined ? undefined : present(document);\n        },\n        sessionAdded: open,\n        sessionRemoved: close,\n        close() {\n          for (const sessionId of stores.keys()) close(sessionId);\n        },\n      };\n      return source;\n    },\n  };\n}\n\n/** The named export the generated hub registry imports. */\nexport const webHubChannels: readonly WebHubChannel[] = [createTasksChannel()];\n"],"mappings":"2GAkBA,SAAS,EAAQ,EAAyC,CAkBxD,MAAO,CAAE,MAjBgB,EAAS,MAAM,QAAS,GAAS,CACxD,GAAI,EAAK,SAAW,UAAW,MAAO,CAAC,EACvC,IAAM,EAAgB,CACpB,GAAI,EAAK,GACT,QAAS,EAAK,QACd,OAAQ,EAAK,OACb,UAAW,EAAK,WAAa,CAAC,CAChC,EAQA,OAPI,EAAK,cAAa,EAAK,YAAc,EAAK,aAC1C,EAAK,aAAY,EAAK,WAAa,EAAK,YACxC,EAAK,QAAO,EAAK,MAAQ,EAAK,OAC9B,EAAK,YAAW,EAAK,UAAY,EAAK,WACtC,EAAK,aACP,EAAK,WAAa,CAAE,MAAO,EAAK,WAAW,MAAO,MAAO,EAAK,WAAW,KAAM,GAE1E,CAAC,CAAI,CACd,CACa,EAAG,IAAK,EAAS,GAAI,CACpC,CAGA,SAAgB,EAAmB,EAA+B,CAAC,EAAkB,CACnF,MAAO,CACL,UAAWA,EAAAA,mBACX,MAAM,EAAM,CACV,IAAM,EAAS,IAAI,IACb,EAAQ,GAAiC,CAC7C,GAAI,EAAO,IAAI,EAAM,SAAS,EAAG,OACjC,IAAM,EACJ,EAAQ,WAAW,CAAK,GACxB,IAAIC,EAAAA,UAAU,CAAE,IAAK,EAAM,IAAK,UAAWC,EAAAA,iBAAiB,EAAM,IAAK,QAAQ,IAAK,EAAM,SAAS,CAAE,CAAC,EAClG,EAAW,EAAM,KAAK,EACtB,EAAU,EAAM,iBAAkB,GAAY,EAAK,QAAQ,EAAM,UAAW,EAAQ,CAAO,CAAC,CAAC,EACnG,EAAO,IAAI,EAAM,UAAW,CAAE,QAAO,SAAQ,CAAC,EAC1C,EAAS,MAAM,OAAS,GAAG,EAAK,QAAQ,EAAM,UAAW,EAAQ,CAAQ,CAAC,CAChF,EACM,EAAS,GAA4B,CACzC,IAAM,EAAS,EAAO,IAAI,CAAS,EAC9B,IACL,EAAO,QAAQ,EACf,EAAO,MAAM,QAAQ,EACrB,EAAO,OAAO,CAAS,EACzB,EACA,IAAK,IAAM,KAAS,EAAK,SAAS,EAAG,EAAK,CAAK,EAc/C,MAAO,CAXL,WAAW,EAAO,CAChB,EAAK,CAAK,EACV,IAAM,EAAW,EAAO,IAAI,EAAM,SAAS,CAAC,EAAE,MAAM,SACpD,OAAO,IAAa,IAAA,GAAY,IAAA,GAAY,EAAQ,CAAQ,CAC9D,EACA,aAAc,EACd,eAAgB,EAChB,OAAQ,CACN,IAAK,IAAM,KAAa,EAAO,KAAK,EAAG,EAAM,CAAS,CACxD,CAEU,CACd,CACF,CACF,CAGA,MAAa,EAA2C,CAAC,EAAmB,CAAC"}

package/dist/adapters/webTasksChannel.d.cts

@@ -0,0 +1,20 @@
+import { TaskDocument } from "../services/store/types.cjs";
+import { HubSessionScope, WebHubChannel } from "@agimon-ai/doompi-web-contracts";
+//#region src/adapters/webTasksChannel.d.ts
+interface TaskStoreSource {
+  readonly snapshot: TaskDocument;
+  read(): TaskDocument;
+  onExternalChange(listener: (document: TaskDocument) => void): () => void;
+  dispose(): void;
+}
+interface TasksChannelOptions {
+  /** Injectable for tests. The default opens the session tree's durable task store. */
+  storeFor?: (scope: HubSessionScope) => TaskStoreSource;
+}
+/** Publishes each managed session's durable task graph and follows external subagent writes. */
+declare function createTasksChannel(options?: TasksChannelOptions): WebHubChannel;
+/** The named export the generated hub registry imports. */
+declare const webHubChannels: readonly WebHubChannel[];
+//#endregion
+export { TasksChannelOptions, createTasksChannel, webHubChannels };
+//# sourceMappingURL=webTasksChannel.d.cts.map

package/dist/adapters/webTasksChannel.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTasksChannel.d.cts","names":[],"sources":["../../src/adapters/webTasksChannel.ts"],"mappings":";;;UAMU;WACC,UAAU;EACnB,QAAQ;EACR,iBAAiB,WAAW,UAAU;EACtC;;UAGe;;EAEf,YAAY,OAAO,oBAAoB;;;iBAyBzB,mBAAmB,UAAS,sBAA2B;;cA0C1D,yBAAyB"}

package/dist/adapters/webTasksChannel.d.mts

@@ -0,0 +1,20 @@
+import { TaskDocument } from "../services/store/types.mjs";
+import { HubSessionScope, WebHubChannel } from "@agimon-ai/doompi-web-contracts";
+//#region src/adapters/webTasksChannel.d.ts
+interface TaskStoreSource {
+  readonly snapshot: TaskDocument;
+  read(): TaskDocument;
+  onExternalChange(listener: (document: TaskDocument) => void): () => void;
+  dispose(): void;
+}
+interface TasksChannelOptions {
+  /** Injectable for tests. The default opens the session tree's durable task store. */
+  storeFor?: (scope: HubSessionScope) => TaskStoreSource;
+}
+/** Publishes each managed session's durable task graph and follows external subagent writes. */
+declare function createTasksChannel(options?: TasksChannelOptions): WebHubChannel;
+/** The named export the generated hub registry imports. */
+declare const webHubChannels: readonly WebHubChannel[];
+//#endregion
+export { TasksChannelOptions, createTasksChannel, webHubChannels };
+//# sourceMappingURL=webTasksChannel.d.mts.map

package/dist/adapters/webTasksChannel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTasksChannel.d.mts","names":[],"sources":["../../src/adapters/webTasksChannel.ts"],"mappings":";;;UAMU;WACC,UAAU;EACnB,QAAQ;EACR,iBAAiB,WAAW,UAAU;EACtC;;UAGe;;EAEf,YAAY,OAAO,oBAAoB;;;iBAyBzB,mBAAmB,UAAS,sBAA2B;;cA0C1D,yBAAyB"}

package/dist/adapters/webTasksChannel.mjs

@@ -0,0 +1,2 @@
+import{resolveStorePath as e}from"./store/paths.mjs";import{TaskStore as t}from"./store/taskStore.mjs";import{TASKS_CHANNEL_TYPE as n}from"../types/webTasks.mjs";function r(e){return{tasks:e.tasks.flatMap(e=>{if(e.status===`deleted`)return[];let t={id:e.id,subject:e.subject,status:e.status,blockedBy:e.blockedBy??[]};return e.description&&(t.description=e.description),e.activeForm&&(t.activeForm=e.activeForm),e.owner&&(t.owner=e.owner),e.updatedAt&&(t.updatedAt=e.updatedAt),e.delegation&&(t.delegation={agent:e.delegation.agent,state:e.delegation.state}),[t]}),rev:e.rev}}function i(i={}){return{frameType:n,start(n){let a=new Map,o=o=>{if(a.has(o.sessionId))return;let s=i.storeFor?.(o)??new t({cwd:o.cwd,storePath:e(o.cwd,process.env,o.sessionId)}),c=s.read(),l=s.onExternalChange(e=>n.publish(o.sessionId,r(e)));a.set(o.sessionId,{store:s,unwatch:l}),c.tasks.length>0&&n.publish(o.sessionId,r(c))},s=e=>{let t=a.get(e);t&&(t.unwatch(),t.store.dispose(),a.delete(e))};for(let e of n.sessions())o(e);return{payloadFor(e){o(e);let t=a.get(e.sessionId)?.store.snapshot;return t===void 0?void 0:r(t)},sessionAdded:o,sessionRemoved:s,close(){for(let e of a.keys())s(e)}}}}}const a=[i()];export{i as createTasksChannel,a as webHubChannels};
+//# sourceMappingURL=webTasksChannel.mjs.map

package/dist/adapters/webTasksChannel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTasksChannel.mjs","names":[],"sources":["../../src/adapters/webTasksChannel.ts"],"sourcesContent":["import type { HubChannelSource, HubSessionScope, WebHubChannel } from '@agimon-ai/doompi-web-contracts';\nimport { resolveStorePath } from './store/paths.ts';\nimport { TaskStore } from './store/taskStore.ts';\nimport type { TaskDocument } from '../services/store/types.ts';\nimport { TASKS_CHANNEL_TYPE, type WebTask, type WebTasksPayload } from '../types/webTasks.ts';\n\ninterface TaskStoreSource {\n  readonly snapshot: TaskDocument;\n  read(): TaskDocument;\n  onExternalChange(listener: (document: TaskDocument) => void): () => void;\n  dispose(): void;\n}\n\nexport interface TasksChannelOptions {\n  /** Injectable for tests. The default opens the session tree's durable task store. */\n  storeFor?: (scope: HubSessionScope) => TaskStoreSource;\n}\n\nfunction present(document: TaskDocument): WebTasksPayload {\n  const tasks: WebTask[] = document.tasks.flatMap((task) => {\n    if (task.status === 'deleted') return [];\n    const view: WebTask = {\n      id: task.id,\n      subject: task.subject,\n      status: task.status,\n      blockedBy: task.blockedBy ?? [],\n    };\n    if (task.description) view.description = task.description;\n    if (task.activeForm) view.activeForm = task.activeForm;\n    if (task.owner) view.owner = task.owner;\n    if (task.updatedAt) view.updatedAt = task.updatedAt;\n    if (task.delegation) {\n      view.delegation = { agent: task.delegation.agent, state: task.delegation.state };\n    }\n    return [view];\n  });\n  return { tasks, rev: document.rev };\n}\n\n/** Publishes each managed session's durable task graph and follows external subagent writes. */\nexport function createTasksChannel(options: TasksChannelOptions = {}): WebHubChannel {\n  return {\n    frameType: TASKS_CHANNEL_TYPE,\n    start(host) {\n      const stores = new Map<string, { store: TaskStoreSource; unwatch: () => void }>();\n      const open = (scope: HubSessionScope): void => {\n        if (stores.has(scope.sessionId)) return;\n        const store =\n          options.storeFor?.(scope) ??\n          new TaskStore({ cwd: scope.cwd, storePath: resolveStorePath(scope.cwd, process.env, scope.sessionId) });\n        const document = store.read();\n        const unwatch = store.onExternalChange((changed) => host.publish(scope.sessionId, present(changed)));\n        stores.set(scope.sessionId, { store, unwatch });\n        if (document.tasks.length > 0) host.publish(scope.sessionId, present(document));\n      };\n      const close = (sessionId: string): void => {\n        const source = stores.get(sessionId);\n        if (!source) return;\n        source.unwatch();\n        source.store.dispose();\n        stores.delete(sessionId);\n      };\n      for (const scope of host.sessions()) open(scope);\n\n      const source: HubChannelSource = {\n        payloadFor(scope) {\n          open(scope);\n          const document = stores.get(scope.sessionId)?.store.snapshot;\n          return document === undefined ? undefined : present(document);\n        },\n        sessionAdded: open,\n        sessionRemoved: close,\n        close() {\n          for (const sessionId of stores.keys()) close(sessionId);\n        },\n      };\n      return source;\n    },\n  };\n}\n\n/** The named export the generated hub registry imports. */\nexport const webHubChannels: readonly WebHubChannel[] = [createTasksChannel()];\n"],"mappings":"kKAkBA,SAAS,EAAQ,EAAyC,CAkBxD,MAAO,CAAE,MAjBgB,EAAS,MAAM,QAAS,GAAS,CACxD,GAAI,EAAK,SAAW,UAAW,MAAO,CAAC,EACvC,IAAM,EAAgB,CACpB,GAAI,EAAK,GACT,QAAS,EAAK,QACd,OAAQ,EAAK,OACb,UAAW,EAAK,WAAa,CAAC,CAChC,EAQA,OAPI,EAAK,cAAa,EAAK,YAAc,EAAK,aAC1C,EAAK,aAAY,EAAK,WAAa,EAAK,YACxC,EAAK,QAAO,EAAK,MAAQ,EAAK,OAC9B,EAAK,YAAW,EAAK,UAAY,EAAK,WACtC,EAAK,aACP,EAAK,WAAa,CAAE,MAAO,EAAK,WAAW,MAAO,MAAO,EAAK,WAAW,KAAM,GAE1E,CAAC,CAAI,CACd,CACa,EAAG,IAAK,EAAS,GAAI,CACpC,CAGA,SAAgB,EAAmB,EAA+B,CAAC,EAAkB,CACnF,MAAO,CACL,UAAW,EACX,MAAM,EAAM,CACV,IAAM,EAAS,IAAI,IACb,EAAQ,GAAiC,CAC7C,GAAI,EAAO,IAAI,EAAM,SAAS,EAAG,OACjC,IAAM,EACJ,EAAQ,WAAW,CAAK,GACxB,IAAI,EAAU,CAAE,IAAK,EAAM,IAAK,UAAW,EAAiB,EAAM,IAAK,QAAQ,IAAK,EAAM,SAAS,CAAE,CAAC,EAClG,EAAW,EAAM,KAAK,EACtB,EAAU,EAAM,iBAAkB,GAAY,EAAK,QAAQ,EAAM,UAAW,EAAQ,CAAO,CAAC,CAAC,EACnG,EAAO,IAAI,EAAM,UAAW,CAAE,QAAO,SAAQ,CAAC,EAC1C,EAAS,MAAM,OAAS,GAAG,EAAK,QAAQ,EAAM,UAAW,EAAQ,CAAQ,CAAC,CAChF,EACM,EAAS,GAA4B,CACzC,IAAM,EAAS,EAAO,IAAI,CAAS,EAC9B,IACL,EAAO,QAAQ,EACf,EAAO,MAAM,QAAQ,EACrB,EAAO,OAAO,CAAS,EACzB,EACA,IAAK,IAAM,KAAS,EAAK,SAAS,EAAG,EAAK,CAAK,EAc/C,MAAO,CAXL,WAAW,EAAO,CAChB,EAAK,CAAK,EACV,IAAM,EAAW,EAAO,IAAI,EAAM,SAAS,CAAC,EAAE,MAAM,SACpD,OAAO,IAAa,IAAA,GAAY,IAAA,GAAY,EAAQ,CAAQ,CAC9D,EACA,aAAc,EACd,eAAgB,EAChB,OAAQ,CACN,IAAK,IAAM,KAAa,EAAO,KAAK,EAAG,EAAM,CAAS,CACxD,CAEU,CACd,CACF,CACF,CAGA,MAAa,EAA2C,CAAC,EAAmB,CAAC"}

package/dist/types/webTasks.cjs

@@ -0,0 +1,2 @@
+exports.TASKS_CHANNEL_TYPE=`task_graph`;
+//# sourceMappingURL=webTasks.cjs.map

package/dist/types/webTasks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTasks.cjs","names":[],"sources":["../../src/types/webTasks.ts"],"sourcesContent":["/** Browser-safe task view published by the cockpit hub channel. */\nexport const TASKS_CHANNEL_TYPE = 'task_graph';\n\nexport type WebTaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'deleted';\n\nexport interface WebTask {\n  id: number;\n  subject: string;\n  description?: string;\n  activeForm?: string;\n  status: WebTaskStatus;\n  blockedBy: number[];\n  owner?: string;\n  updatedAt?: string;\n  delegation?: {\n    agent?: string;\n    state?: string;\n  };\n}\n\nexport interface WebTasksPayload {\n  tasks: WebTask[];\n  rev: number;\n}\n"],"mappings":""}

package/dist/types/webTasks.mjs

@@ -0,0 +1,2 @@
+const e=`task_graph`;export{e as TASKS_CHANNEL_TYPE};
+//# sourceMappingURL=webTasks.mjs.map

package/dist/types/webTasks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webTasks.mjs","names":[],"sources":["../../src/types/webTasks.ts"],"sourcesContent":["/** Browser-safe task view published by the cockpit hub channel. */\nexport const TASKS_CHANNEL_TYPE = 'task_graph';\n\nexport type WebTaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'deleted';\n\nexport interface WebTask {\n  id: number;\n  subject: string;\n  description?: string;\n  activeForm?: string;\n  status: WebTaskStatus;\n  blockedBy: number[];\n  owner?: string;\n  updatedAt?: string;\n  delegation?: {\n    agent?: string;\n    state?: string;\n  };\n}\n\nexport interface WebTasksPayload {\n  tasks: WebTask[];\n  rev: number;\n}\n"],"mappings":"AACA,MAAa,EAAqB"}

package/dist/webHub.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./adapters/webTasksChannel.cjs");exports.createTasksChannel=e.createTasksChannel,exports.webHubChannels=e.webHubChannels;

package/dist/webHub.d.cts

@@ -0,0 +1,2 @@
+import { TasksChannelOptions, createTasksChannel, webHubChannels } from "./adapters/webTasksChannel.cjs";
+export { type TasksChannelOptions, createTasksChannel, webHubChannels };

package/dist/webHub.d.mts

@@ -0,0 +1,2 @@
+import { TasksChannelOptions, createTasksChannel, webHubChannels } from "./adapters/webTasksChannel.mjs";
+export { type TasksChannelOptions, createTasksChannel, webHubChannels };

package/dist/webHub.mjs

@@ -0,0 +1 @@
+import{createTasksChannel as e,webHubChannels as t}from"./adapters/webTasksChannel.mjs";export{e as createTasksChannel,t as webHubChannels};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agimon-ai/doompi-task",
-  "version": "0.0.1-alpha.39",
+  "version": "0.0.1-alpha.40",
   "description": "Persistent, dependency-aware task graphs and subagent delegation for Pi coding sessions.",
   "keywords": [
     "ai",
@@ -28,6 +28,7 @@
   "files": [
     "dist",
     "web",
+    "src/types/webTasks.ts",
     "package.json"
   ],
   "type": "module",
@@ -130,6 +131,11 @@
       "import": "./dist/tool/taskTool.mjs",
       "require": "./dist/tool/taskTool.cjs"
     },
+    "./web-hub": {
+      "types": "./dist/webHub.d.mts",
+      "import": "./dist/webHub.mjs",
+      "require": "./dist/webHub.cjs"
+    },
     "./tui/format": {
       "types": "./dist/tui/format.d.mts",
       "import": "./dist/tui/format.mjs",
@@ -159,11 +165,11 @@
   "dependencies": {
     "@deepseek-ai/cordis": "4.0.1",
     "typebox": "1.3.16",
-    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.39",
-    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.39",
-    "@agimon-ai/doompi-ui": "0.0.1-alpha.39",
-    "@agimon-ai/doompi-web-components": "0.0.1-alpha.0",
-    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.2"
+    "@agimon-ai/doompi-extension-contracts": "0.0.1-alpha.40",
+    "@agimon-ai/doompi-ui": "0.0.1-alpha.40",
+    "@agimon-ai/doompi-telemetry": "0.0.1-alpha.40",
+    "@agimon-ai/doompi-web-components": "0.0.1-alpha.1",
+    "@agimon-ai/doompi-web-contracts": "0.0.1-alpha.3"
   },
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "0.84.3",
@@ -195,8 +201,14 @@
   },
   "doompiWeb": {
     "pluginId": "task",
-    "channels": [],
-    "client": "./web/index.ts"
+    "channels": [
+      "task_graph"
+    ],
+    "client": "./web/index.ts",
+    "hub": {
+      "entry": "./src/exports/webHub.ts",
+      "dist": "./dist/webHub.mjs"
+    }
   },
   "pi": {
     "extensions": [

package/src/types/webTasks.ts

@@ -0,0 +1,24 @@
+/** Browser-safe task view published by the cockpit hub channel. */
+export const TASKS_CHANNEL_TYPE = 'task_graph';
+
+export type WebTaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'deleted';
+
+export interface WebTask {
+  id: number;
+  subject: string;
+  description?: string;
+  activeForm?: string;
+  status: WebTaskStatus;
+  blockedBy: number[];
+  owner?: string;
+  updatedAt?: string;
+  delegation?: {
+    agent?: string;
+    state?: string;
+  };
+}
+
+export interface WebTasksPayload {
+  tasks: WebTask[];
+  rev: number;
+}

package/web/TasksActivitySection.tsx

@@ -0,0 +1,207 @@
+import {
+  Button,
+  ChevronDownIcon,
+  ChevronRightIcon,
+  Dot,
+  Textarea,
+  type DotTone,
+} from '@agimon-ai/doompi-web-components';
+import type { WebPluginSlotProps } from '@agimon-ai/doompi-web-contracts';
+import { useStore } from '@tanstack/react-store';
+import { useState } from 'react';
+import type { WebTask } from '../src/types/webTasks.ts';
+import { requestTaskInstruction, requestTaskRemoval, tasks, type TaskInstructionKind } from './tasksStore.ts';
+
+const STATUS_TONE: Readonly<Record<WebTask['status'], DotTone>> = {
+  pending: 'muted',
+  in_progress: 'yellow',
+  completed: 'green',
+  failed: 'red',
+  deleted: 'muted',
+};
+
+interface EditorState {
+  taskId: number;
+  kind: TaskInstructionKind;
+  value: string;
+}
+
+function TaskRow({
+  task,
+  sessionId,
+  sendSessionFrame,
+  editor,
+  setEditor,
+}: {
+  task: WebTask;
+  sessionId: string;
+  sendSessionFrame: WebPluginSlotProps['sendSessionFrame'];
+  editor: EditorState | undefined;
+  setEditor: (editor: EditorState | undefined) => void;
+}) {
+  const editing = editor?.taskId === task.id;
+  const detail = task.status === 'in_progress' ? task.activeForm : task.description;
+  return (
+    <div
+      data-testid={`activity-task-${task.id}`}
+      data-task-status={task.status}
+      className="flex flex-col gap-1 rounded-[5px] px-1 py-1"
+    >
+      <div className="flex min-w-0 items-center gap-1.5">
+        <Dot tone={STATUS_TONE[task.status]} pulse={task.status === 'in_progress'} />
+        <span
+          className={`min-w-0 flex-1 truncate text-[10px] font-bold ${task.status === 'failed' ? 'text-doom-red' : task.status === 'completed' ? 'text-doom-dim' : 'text-doom-hi'}`}
+        >
+          <span className="text-doom-faint">#{task.id}</span> {task.subject}
+        </span>
+        <span className="shrink-0 text-[8px] text-doom-faint">{task.status.replace('_', ' ')}</span>
+      </div>
+      {detail || task.delegation?.agent || task.blockedBy.length > 0 ? (
+        <span className="truncate pl-3 text-[9px] text-doom-faint">
+          {task.delegation?.agent ? `[${task.delegation.agent}] ` : ''}
+          {detail ?? ''}
+          {task.blockedBy.length > 0 ? ` · blocked by ${task.blockedBy.map((id) => `#${id}`).join(', ')}` : ''}
+        </span>
+      ) : null}
+      {task.status !== 'completed' && task.status !== 'deleted' ? (
+        <div className="flex items-center gap-2 pl-3">
+          <Button
+            variant="link"
+            size="xs"
+            className="h-auto px-0 text-[8px]"
+            onClick={() => setEditor({ taskId: task.id, kind: 'edit', value: '' })}
+          >
+            edit
+          </Button>
+          <Button
+            variant="link"
+            size="xs"
+            className="h-auto px-0 text-[8px]"
+            onClick={() => setEditor({ taskId: task.id, kind: 'note', value: '' })}
+          >
+            note
+          </Button>
+          <Button
+            variant="link"
+            size="xs"
+            className="h-auto px-0 text-[8px] text-doom-red"
+            onClick={() => requestTaskRemoval(sendSessionFrame, sessionId, task.id)}
+          >
+            remove
+          </Button>
+        </div>
+      ) : null}
+      {editing ? (
+        <form
+          className="flex flex-col gap-1 pl-3"
+          onSubmit={(event) => {
+            event.preventDefault();
+            if (!editor.value.trim()) return;
+            requestTaskInstruction(sendSessionFrame, sessionId, task.id, editor.kind, editor.value);
+            setEditor(undefined);
+          }}
+        >
+          <Textarea
+            autoFocus
+            rows={2}
+            size="sm"
+            value={editor.value}
+            placeholder={editor.kind === 'note' ? 'note for the agent' : 'what should change'}
+            onChange={(event) => setEditor({ ...editor, value: event.target.value })}
+            className="text-[9px]"
+          />
+          <div className="flex gap-2">
+            <Button type="submit" variant="link" size="xs" className="h-auto px-0 text-[8px]">
+              send
+            </Button>
+            <Button
+              type="button"
+              variant="link"
+              size="xs"
+              className="h-auto px-0 text-[8px] text-doom-faint"
+              onClick={() => setEditor(undefined)}
+            >
+              cancel
+            </Button>
+          </div>
+        </form>
+      ) : null}
+    </div>
+  );
+}
+
+/** Session task graph in the activity dock. Empty graphs have no cockpit presence. */
+export function TasksActivitySection({ sessionId, sendSessionFrame }: WebPluginSlotProps) {
+  const sessionTasks = useStore(tasks.store, (state) => tasks.select(state, sessionId).tasks);
+  const [historyOpen, setHistoryOpen] = useState(false);
+  const [editor, setEditor] = useState<EditorState>();
+  if (sessionId === null || sessionTasks.length === 0) return null;
+
+  const active = sessionTasks.filter((task) => task.status === 'pending' || task.status === 'in_progress');
+  const history = sessionTasks.filter((task) => task.status === 'completed' || task.status === 'failed');
+  return (
+    <section data-testid="activity-tasks" className="flex flex-col gap-2 border-b border-doom-border-soft px-3 py-3">
+      <div className="flex items-center gap-2 px-1">
+        <span
+          aria-hidden
+          className={
+            active.length > 0
+              ? 'animate-pulse text-[11px] font-bold text-doom-yellow'
+              : 'text-[11px] font-bold text-doom-faint'
+          }
+        >
+          #
+        </span>
+        <span className="flex-1 text-[11px] font-bold text-doom-text">tasks</span>
+        <span className="text-[9px] text-doom-faint">{active.length} active</span>
+      </div>
+      {active.length > 0 ? (
+        <div className="flex flex-col gap-0.5">
+          {active.map((task) => (
+            <TaskRow
+              key={task.id}
+              task={task}
+              sessionId={sessionId}
+              sendSessionFrame={sendSessionFrame}
+              editor={editor}
+              setEditor={setEditor}
+            />
+          ))}
+        </div>
+      ) : null}
+      {history.length > 0 ? (
+        <div className="flex flex-col gap-0.5">
+          <Button
+            variant="ghost"
+            size="xs"
+            aria-expanded={historyOpen}
+            onClick={() => setHistoryOpen((open) => !open)}
+            className="justify-start gap-1.5 rounded-[5px] px-1 py-0.5 hover:bg-doom-panel"
+          >
+            {historyOpen ? (
+              <ChevronDownIcon className="h-2.5 w-2.5 text-doom-faint" />
+            ) : (
+              <ChevronRightIcon className="h-2.5 w-2.5 text-doom-faint" />
+            )}
+            <span className="text-[10px] font-bold text-doom-dim">session</span>
+            <span className="text-[9px] text-doom-faint">{history.length}</span>
+          </Button>
+          {historyOpen ? (
+            <div className="flex flex-col gap-0.5 pl-2">
+              {history.map((task) => (
+                <TaskRow
+                  key={task.id}
+                  task={task}
+                  sessionId={sessionId}
+                  sendSessionFrame={sendSessionFrame}
+                  editor={editor}
+                  setEditor={setEditor}
+                />
+              ))}
+            </div>
+          ) : null}
+        </div>
+      ) : null}
+    </section>
+  );
+}

package/web/index.ts

@@ -1,11 +1,15 @@
 import { defineWebPlugin } from '@agimon-ai/doompi-web-contracts';
+import { TasksActivitySection } from './TasksActivitySection.tsx';
 import { TaskToolMessage } from './TaskToolMessage.tsx';
+import { tasksChannel } from './tasksStore.ts';
 
 /**
- * This package's cockpit presence: the task tool's timeline card, the web
- * half of src/tui/format.ts (renderTaskCall and renderTaskResult).
+ * This package's cockpit presence: the live session task graph in the activity
+ * dock and the task tool's timeline card.
  */
 export const webPlugin = defineWebPlugin({
   id: 'task',
+  channels: [tasksChannel],
+  activitySections: [{ id: 'tasks', component: TasksActivitySection }],
   toolRenderers: [{ tools: ['task'], message: TaskToolMessage }],
 });

package/web/tasksStore.ts

@@ -0,0 +1,72 @@
+import { defineSessionStore, type SessionFrameSender } from '@agimon-ai/doompi-web-contracts';
+import { TASKS_CHANNEL_TYPE, type WebTask, type WebTasksPayload } from '../src/types/webTasks.ts';
+
+export interface TasksSession {
+  tasks: WebTask[];
+  rev: number;
+}
+
+export const tasks = defineSessionStore<TasksSession>({ tasks: [], rev: 0 });
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function parseTask(value: unknown): WebTask | null {
+  if (!isRecord(value) || typeof value.id !== 'number' || typeof value.subject !== 'string') return null;
+  if (!['pending', 'in_progress', 'completed', 'failed'].includes(String(value.status))) return null;
+  const task: WebTask = {
+    id: value.id,
+    subject: value.subject,
+    status: value.status as WebTask['status'],
+    blockedBy: Array.isArray(value.blockedBy)
+      ? value.blockedBy.filter((id): id is number => typeof id === 'number')
+      : [],
+  };
+  if (typeof value.description === 'string') task.description = value.description;
+  if (typeof value.activeForm === 'string') task.activeForm = value.activeForm;
+  if (typeof value.owner === 'string') task.owner = value.owner;
+  if (typeof value.updatedAt === 'string') task.updatedAt = value.updatedAt;
+  if (isRecord(value.delegation)) {
+    task.delegation = {};
+    if (typeof value.delegation.agent === 'string') task.delegation.agent = value.delegation.agent;
+    if (typeof value.delegation.state === 'string') task.delegation.state = value.delegation.state;
+  }
+  return task;
+}
+
+export const tasksChannel = tasks.channel<WebTasksPayload>({
+  channel: TASKS_CHANNEL_TYPE,
+  parse(input) {
+    if (!isRecord(input) || !Array.isArray(input.tasks) || typeof input.rev !== 'number') return null;
+    return { tasks: input.tasks.map(parseTask).filter((task): task is WebTask => task !== null), rev: input.rev };
+  },
+  reduce: (_current, payload) => payload,
+});
+
+export type TaskInstructionKind = 'edit' | 'note';
+
+export function taskInstruction(taskId: number, kind: TaskInstructionKind, instruction: string): string {
+  const detail = instruction.trim();
+  if (kind === 'note') {
+    return `Send this note to the agent working on task #${taskId}, then update the task if needed: ${detail}`;
+  }
+  return `Update task #${taskId} according to this instruction. Preserve a valid dependency graph: ${detail}`;
+}
+
+export function requestTaskInstruction(
+  send: SessionFrameSender,
+  sessionId: string,
+  taskId: number,
+  kind: TaskInstructionKind,
+  instruction: string,
+): void {
+  send(sessionId, { type: 'prompt', message: taskInstruction(taskId, kind, instruction) });
+}
+
+export function requestTaskRemoval(send: SessionFrameSender, sessionId: string, taskId: number): void {
+  send(sessionId, {
+    type: 'prompt',
+    message: `Remove task #${taskId}. Also remove or repair every dependency that references it so the remaining task graph is valid.`,
+  });
+}