@agimon-ai/doompi-task 0.0.1-alpha.2 → 0.0.1-alpha.21

package/dist/commands/task/taskTool.cjs

@@ -0,0 +1,3 @@
+const e=require("../../adapters/telemetry/logSinkTelemetry.cjs"),t=require("../../schemas/task.cjs"),n=require("../../services/store/reducer.cjs"),r=require("../../tui/format.cjs");require("../../types/config.cjs");const i=require("./promptGuidelines.cjs"),a=require("./responseEnvelope.cjs"),o=`Manage a shared task list to track multi-step progress, and delegate tasks to subagents`,s=`tool.action`,c=`task.id`,l=new Set([`upsert`,`list`,`get`,`delete`,`clear`]);var u=class extends Error{};function d(e,t){return new u([`Task ${e} failed: ${t}`,``,`Options:`,`- List the task board and inspect the current ids, states, and blockers.`,`- Correct the arguments or state conflict, then retry once.`,`- Ask the user before cancelling work or changing dependencies to recover.`].join(`
+`))}function f(e,n){let r=Object.keys(n).filter(r=>n[r]!==void 0&&!t.taskActionAcceptsField(e,r));if(r.length===0)return;let i=e===`upsert`?` ${t.MSG_UPSERT_FIELD_MISPLACED}`:``;throw d(e,`${e} does not accept ${r.join(`, `)}.${i}`)}function p(e){let t=e.assignments;if(!t||t.length===0)throw d(`assign`,`assign requires a non-empty assignments[] array`);return t}function m(e,t){return{agent:e.agent,inlineAgent:e.inlineAgent,instructions:e.instructions,relevantFiles:e.relevantFiles,priorFindings:e.priorFindings,model:e.model,context:e.context,signal:t}}async function h(t,n,r,i){let a=[];for(let[o,l]of n.entries()){let n;try{n=await t.assign(l.id,m(l,r))}catch(t){i?.error(e.TASK_EVENT.toolFailed,t,{[s]:`assign`,[c]:l.id}),n={ok:!1,message:t instanceof Error?t.message:String(t)}}a.push({index:o,id:l.id,agent:l.agent,...n})}return a}async function g(e,t,r,i){let{document:o,value:s}=await e.mutate(e=>{let a=n.applyTaskMutation(e,t,r,void 0,i);return{...n.isCommittingOp(a.op)?{document:a.document}:{},value:a}});if(s.op.kind===`error`)throw d(t,s.op.message);if(s.op.kind===`upsert`&&s.op.applied===0)throw d(t,a.formatUpsertFailureText(s.op));return a.buildToolResult(t,r,o,s.op)}function _(n,m){let{store:_,delegation:v,maxTasks:y=15}=m;n.registerTool({name:t.TOOL_NAME,label:t.TOOL_LABEL,description:`Manage a shared task list for tracking multi-step progress, and delegate tasks to subagents. Actions: upsert (write tasks — a tasks[] array where an entry with an id changes that task and an entry without an id creates one, so one call can capture a whole plan), list, get, delete (tombstone), clear (close/reset the list), assign (hand one or more tasks through assignments[] to named subagents that work in the background), cancel (stop a delegated run). upsert and assign apply entries independently: successes remain committed or delegated and failures are reported by array index. Batch a plan and independent assignments, but report progress one task at a time. Status: pending → in_progress → completed, plus failed and a deleted tombstone. The list is shared within the current session tree, including delegated subagents, while unrelated sessions start empty. Session stores persist until retention cleanup.`,promptSnippet:o,promptGuidelines:i.DEFAULT_PROMPT_GUIDELINES,parameters:t.TaskParamsSchema,renderShell:`self`,async execute(t,n,r,i,o){let b=n.action,x=n;try{if(f(b,x),l.has(b)){let e=await g(_,b,x,y);return m.onChange?.(),e}if(b===`assign`){let e=p(x),t=e[0],n=e.length===1&&t?`Delegating task #${t.id}...`:`Delegating ${e.length} tasks...`;i?.(a.buildTextResult(b,x,_.snapshot,n));let o=await h(v,e,r,m.report);m.onChange?.();let s=a.formatAssignmentResults(o),c=o.flatMap(e=>e.ok?[e.id]:[]);if(c.length===0)throw d(b,s);return a.buildAssignmentResult(x,_.snapshot,s,{assigned:c,failed:o.length-c.length})}i?.(a.buildTextResult(b,x,_.snapshot,`Requesting cancellation for task #${x.id??`unknown`}...`));let e=await v.cancel(x.id??NaN);if(m.onChange?.(),!e.ok)throw d(b,e.message);return a.buildTextResult(b,x,_.snapshot,e.message,void 0)}catch(t){throw m.report?.error(e.TASK_EVENT.toolFailed,t,{[s]:b,...x.id===void 0?{}:{[c]:x.id}}),t instanceof u?t:d(b,t instanceof Error?t.message:String(t))}},renderCall(e,t,n){return r.renderTaskCall(e,t,_.snapshot.tasks)},renderResult(e,t,n,i){return r.renderTaskResult(e,t,n)}})}exports.DEFAULT_PROMPT_GUIDELINES=i.DEFAULT_PROMPT_GUIDELINES,exports.DEFAULT_PROMPT_SNIPPET=o,exports.registerTaskTool=_;
+//# sourceMappingURL=taskTool.cjs.map

package/dist/commands/task/taskTool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskTool.cjs","names":["taskActionAcceptsField","MSG_UPSERT_FIELD_MISPLACED","TASK_EVENT","applyTaskMutation","isCommittingOp","formatUpsertFailureText","buildToolResult","TOOL_NAME","TOOL_LABEL","DEFAULT_PROMPT_GUIDELINES","TaskParamsSchema","buildTextResult","formatAssignmentResults","buildAssignmentResult","renderTaskCall","renderTaskResult"],"sources":["../../../src/commands/task/taskTool.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { TASK_EVENT, type TaskFailureReporter } from '../../adapters/telemetry/logSinkTelemetry.ts';\nimport {\n  MSG_UPSERT_FIELD_MISPLACED,\n  TaskParamsSchema,\n  TOOL_LABEL,\n  TOOL_NAME,\n  taskActionAcceptsField,\n} from '../../schemas/task.ts';\nimport type { AssignOptions, DelegationManager, DelegationOutcome } from '../../services/delegation/manager.ts';\nimport { applyTaskMutation, isCommittingOp, type ReducerAction } from '../../services/store/reducer.ts';\nimport type { TaskStore } from '../../services/store/taskStore.ts';\nimport type { TaskAction, TaskAssignment, TaskMutationParams } from '../../services/store/types.ts';\nimport { renderTaskCall, renderTaskResult } from '../../tui/format.ts';\nimport { DEFAULT_MAX_TASKS } from '../../types/config.ts';\nimport { DEFAULT_PROMPT_GUIDELINES } from './promptGuidelines.ts';\nimport {\n  type AssignmentItemResult,\n  buildAssignmentResult,\n  buildTextResult,\n  buildToolResult,\n  formatAssignmentResults,\n  formatUpsertFailureText,\n  type ToolResult,\n} from './responseEnvelope.ts';\n\nexport { DEFAULT_PROMPT_GUIDELINES } from './promptGuidelines.ts';\n\nexport const DEFAULT_PROMPT_SNIPPET =\n  'Manage a shared task list to track multi-step progress, and delegate tasks to subagents';\n\nexport interface TaskToolDependencies {\n  store: TaskStore;\n  delegation: DelegationManager;\n  maxTasks?: number;\n  onChange?: () => void;\n  report?: TaskFailureReporter;\n}\n\nconst ACTION_ATTRIBUTE = 'tool.action';\nconst TASK_ID_ATTRIBUTE = 'task.id';\nconst REDUCER_ACTIONS = new Set<TaskAction>(['upsert', 'list', 'get', 'delete', 'clear']);\n\nclass TaskToolExecutionError extends Error {}\n\nfunction actionableTaskError(action: TaskAction, message: string): TaskToolExecutionError {\n  return new TaskToolExecutionError(\n    [\n      `Task ${action} failed: ${message}`,\n      '',\n      'Options:',\n      '- List the task board and inspect the current ids, states, and blockers.',\n      '- Correct the arguments or state conflict, then retry once.',\n      '- Ask the user before cancelling work or changing dependencies to recover.',\n    ].join('\\n'),\n  );\n}\n\n/**\n * Reject a field that belongs to a different action.\n *\n * The params schema is flat and shared across every action, so this is the only\n * place `{\"action\":\"upsert\",\"id\":3}` can be caught — and it must be, because\n * the entry it carries has no id and would silently create a duplicate task.\n */\nfunction rejectStrayFields(action: TaskAction, params: TaskMutationParams): void {\n  const stray = Object.keys(params).filter((key) => params[key] !== undefined && !taskActionAcceptsField(action, key));\n  if (stray.length === 0) return;\n  const hint = action === 'upsert' ? ` ${MSG_UPSERT_FIELD_MISPLACED}` : '';\n  throw actionableTaskError(action, `${action} does not accept ${stray.join(', ')}.${hint}`);\n}\n\n/** assignments[] is the only assign contract, even when it contains one task. */\nfunction resolveAssignments(params: TaskMutationParams): TaskAssignment[] {\n  const assignments = params.assignments;\n  if (!assignments || assignments.length === 0) {\n    throw actionableTaskError('assign', 'assign requires a non-empty assignments[] array');\n  }\n  return assignments;\n}\n\nfunction assignOptions(request: TaskAssignment, signal: AbortSignal | undefined): AssignOptions {\n  return {\n    agent: request.agent,\n    inlineAgent: request.inlineAgent,\n    instructions: request.instructions,\n    relevantFiles: request.relevantFiles,\n    priorFindings: request.priorFindings,\n    model: request.model,\n    context: request.context,\n    signal,\n  };\n}\n\nasync function executeAssignmentBatch(\n  delegation: DelegationManager,\n  assignments: readonly TaskAssignment[],\n  signal: AbortSignal | undefined,\n  report: TaskFailureReporter | undefined,\n): Promise<AssignmentItemResult[]> {\n  const results: AssignmentItemResult[] = [];\n  for (const [index, assignment] of assignments.entries()) {\n    let outcome: DelegationOutcome;\n    try {\n      outcome = await delegation.assign(assignment.id, assignOptions(assignment, signal));\n    } catch (error) {\n      report?.error(TASK_EVENT.toolFailed, error, {\n        [ACTION_ATTRIBUTE]: 'assign',\n        [TASK_ID_ATTRIBUTE]: assignment.id,\n      });\n      outcome = { ok: false, message: error instanceof Error ? error.message : String(error) };\n    }\n    results.push({ index, id: assignment.id, agent: assignment.agent, ...outcome });\n  }\n  return results;\n}\n\n/** Run an action through the reducer, persisting only when it produced a change. */\nasync function executeReducerAction(\n  store: TaskStore,\n  action: ReducerAction,\n  params: TaskMutationParams,\n  maxTasks: number,\n): Promise<ToolResult> {\n  const { document, value } = await store.mutate((current) => {\n    const result = applyTaskMutation(current, action, params, undefined, maxTasks);\n    return {\n      ...(isCommittingOp(result.op) ? { document: result.document } : {}),\n      value: result,\n    };\n  });\n  if (value.op.kind === 'error') throw actionableTaskError(action, value.op.message);\n  // An upsert that applied nothing is a failed call: it wrote nothing and left\n  // `rev` alone, so it must not read to the model as a success. A batch where\n  // some entries landed returns normally — that is what partial apply means.\n  if (value.op.kind === 'upsert' && value.op.applied === 0) {\n    throw actionableTaskError(action, formatUpsertFailureText(value.op));\n  }\n  // `document` is the committed document, so `details.rev` matches what landed\n  // on disk; `value.document` is the pre-write copy and lags by one.\n  return buildToolResult(action, params, document, value.op);\n}\n\nexport function registerTaskTool(pi: ExtensionAPI, dependencies: TaskToolDependencies): void {\n  const { store, delegation, maxTasks = DEFAULT_MAX_TASKS } = dependencies;\n\n  pi.registerTool({\n    name: TOOL_NAME,\n    label: TOOL_LABEL,\n    description:\n      'Manage a shared task list for tracking multi-step progress, and delegate tasks to subagents. Actions: upsert (write tasks — a tasks[] array where an entry with an id changes that task and an entry without an id creates one, so one call can capture a whole plan), list, get, delete (tombstone), clear (close/reset the list), assign (hand one or more tasks through assignments[] to named subagents that work in the background), cancel (stop a delegated run). upsert and assign apply entries independently: successes remain committed or delegated and failures are reported by array index. Batch a plan and independent assignments, but report progress one task at a time. Status: pending → in_progress → completed, plus failed and a deleted tombstone. The list is shared within the current session tree, including delegated subagents, while unrelated sessions start empty. Session stores persist until retention cleanup.',\n    promptSnippet: DEFAULT_PROMPT_SNIPPET,\n    promptGuidelines: DEFAULT_PROMPT_GUIDELINES,\n    parameters: TaskParamsSchema,\n    // Task rows carry their own status colors. Owning the shell prevents Pi's\n    // pending/success/error background fill from obscuring those row states.\n    renderShell: 'self',\n\n    async execute(_toolCallId, params, signal, onUpdate, _ctx) {\n      const action = params.action as TaskAction;\n      const mutationParams = params as TaskMutationParams;\n\n      try {\n        rejectStrayFields(action, mutationParams);\n        if (REDUCER_ACTIONS.has(action)) {\n          const result = await executeReducerAction(store, action as ReducerAction, mutationParams, maxTasks);\n          dependencies.onChange?.();\n          return result;\n        }\n\n        if (action === 'assign') {\n          const assignments = resolveAssignments(mutationParams);\n          const first = assignments[0];\n          const progress =\n            assignments.length === 1 && first\n              ? `Delegating task #${first.id}...`\n              : `Delegating ${assignments.length} tasks...`;\n          onUpdate?.(buildTextResult(action, mutationParams, store.snapshot, progress));\n          const results = await executeAssignmentBatch(delegation, assignments, signal, dependencies.report);\n          dependencies.onChange?.();\n          const text = formatAssignmentResults(results);\n          const assigned = results.flatMap((item) => (item.ok ? [item.id] : []));\n          if (assigned.length === 0) throw actionableTaskError(action, text);\n          return buildAssignmentResult(mutationParams, store.snapshot, text, {\n            assigned,\n            failed: results.length - assigned.length,\n          });\n        }\n\n        onUpdate?.(\n          buildTextResult(\n            action,\n            mutationParams,\n            store.snapshot,\n            `Requesting cancellation for task #${mutationParams.id ?? 'unknown'}...`,\n          ),\n        );\n        const outcome = await delegation.cancel(mutationParams.id ?? Number.NaN);\n        dependencies.onChange?.();\n        if (!outcome.ok) throw actionableTaskError(action, outcome.message);\n        return buildTextResult(action, mutationParams, store.snapshot, outcome.message, undefined);\n      } catch (error) {\n        // Rethrown so pi still renders the failure to the model; recorded\n        // because this is where a store fault becomes visible to the user.\n        dependencies.report?.error(TASK_EVENT.toolFailed, error, {\n          [ACTION_ATTRIBUTE]: action,\n          ...(mutationParams.id === undefined ? {} : { [TASK_ID_ATTRIBUTE]: mutationParams.id }),\n        });\n        if (error instanceof TaskToolExecutionError) throw error;\n        throw actionableTaskError(action, error instanceof Error ? error.message : String(error));\n      }\n    },\n\n    // Render hooks receive no session identity, so they read the store snapshot\n    // that the executing session last loaded. That is the foreground session's\n    // own view, which is exactly what its transcript should show.\n    renderCall(args, theme, _context) {\n      return renderTaskCall(args as never, theme, store.snapshot.tasks);\n    },\n\n    renderResult(result, options, theme, _context) {\n      return renderTaskResult(result, options, theme);\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/commands/task/taskTool.d.cts

@@ -0,0 +1,19 @@
+import { TaskFailureReporter } from "../../adapters/telemetry/logSinkTelemetry.cjs";
+import { TaskStore } from "../../adapters/store/taskStore.cjs";
+import "../../services/store/taskStore.cjs";
+import { DelegationManager } from "../../services/delegation/manager.cjs";
+import { DEFAULT_PROMPT_GUIDELINES } from "./promptGuidelines.cjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/commands/task/taskTool.d.ts
+declare const DEFAULT_PROMPT_SNIPPET = "Manage a shared task list to track multi-step progress, and delegate tasks to subagents";
+interface TaskToolDependencies {
+  store: TaskStore;
+  delegation: DelegationManager;
+  maxTasks?: number;
+  onChange?: () => void;
+  report?: TaskFailureReporter;
+}
+declare function registerTaskTool(pi: ExtensionAPI, dependencies: TaskToolDependencies): void;
+//#endregion
+export { DEFAULT_PROMPT_GUIDELINES, DEFAULT_PROMPT_SNIPPET, TaskToolDependencies, registerTaskTool };
+//# sourceMappingURL=taskTool.d.cts.map

package/dist/commands/task/taskTool.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskTool.d.cts","names":[],"sources":["../../../src/commands/task/taskTool.ts"],"mappings":";;;;;;;cA4Ba;UAGI;EACf,OAAO;EACP,YAAY;EACZ;EACA;EACA,SAAS;;iBA2GK,iBAAiB,IAAI,cAAc,cAAc"}

package/dist/commands/task/taskTool.d.mts

@@ -0,0 +1,19 @@
+import { TaskFailureReporter } from "../../adapters/telemetry/logSinkTelemetry.mjs";
+import { TaskStore } from "../../adapters/store/taskStore.mjs";
+import "../../services/store/taskStore.mjs";
+import { DelegationManager } from "../../services/delegation/manager.mjs";
+import { DEFAULT_PROMPT_GUIDELINES } from "./promptGuidelines.mjs";
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+//#region src/commands/task/taskTool.d.ts
+declare const DEFAULT_PROMPT_SNIPPET = "Manage a shared task list to track multi-step progress, and delegate tasks to subagents";
+interface TaskToolDependencies {
+  store: TaskStore;
+  delegation: DelegationManager;
+  maxTasks?: number;
+  onChange?: () => void;
+  report?: TaskFailureReporter;
+}
+declare function registerTaskTool(pi: ExtensionAPI, dependencies: TaskToolDependencies): void;
+//#endregion
+export { DEFAULT_PROMPT_GUIDELINES, DEFAULT_PROMPT_SNIPPET, TaskToolDependencies, registerTaskTool };
+//# sourceMappingURL=taskTool.d.mts.map

package/dist/commands/task/taskTool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskTool.d.mts","names":[],"sources":["../../../src/commands/task/taskTool.ts"],"mappings":";;;;;;;cA4Ba;UAGI;EACf,OAAO;EACP,YAAY;EACZ;EACA;EACA,SAAS;;iBA2GK,iBAAiB,IAAI,cAAc,cAAc"}

package/dist/commands/task/taskTool.mjs

@@ -0,0 +1,3 @@
+import{TASK_EVENT as e}from"../../adapters/telemetry/logSinkTelemetry.mjs";import{MSG_UPSERT_FIELD_MISPLACED as t,TOOL_LABEL as n,TOOL_NAME as r,TaskParamsSchema as i,taskActionAcceptsField as a}from"../../schemas/task.mjs";import{applyTaskMutation as o,isCommittingOp as s}from"../../services/store/reducer.mjs";import{renderTaskCall as c,renderTaskResult as l}from"../../tui/format.mjs";import"../../types/config.mjs";import{DEFAULT_PROMPT_GUIDELINES as u}from"./promptGuidelines.mjs";import{buildAssignmentResult as d,buildTextResult as f,buildToolResult as p,formatAssignmentResults as m,formatUpsertFailureText as h}from"./responseEnvelope.mjs";const g=`Manage a shared task list to track multi-step progress, and delegate tasks to subagents`,_=`tool.action`,v=`task.id`,y=new Set([`upsert`,`list`,`get`,`delete`,`clear`]);var b=class extends Error{};function x(e,t){return new b([`Task ${e} failed: ${t}`,``,`Options:`,`- List the task board and inspect the current ids, states, and blockers.`,`- Correct the arguments or state conflict, then retry once.`,`- Ask the user before cancelling work or changing dependencies to recover.`].join(`
+`))}function S(e,n){let r=Object.keys(n).filter(t=>n[t]!==void 0&&!a(e,t));if(r.length===0)return;let i=e===`upsert`?` ${t}`:``;throw x(e,`${e} does not accept ${r.join(`, `)}.${i}`)}function C(e){let t=e.assignments;if(!t||t.length===0)throw x(`assign`,`assign requires a non-empty assignments[] array`);return t}function w(e,t){return{agent:e.agent,inlineAgent:e.inlineAgent,instructions:e.instructions,relevantFiles:e.relevantFiles,priorFindings:e.priorFindings,model:e.model,context:e.context,signal:t}}async function T(t,n,r,i){let a=[];for(let[o,s]of n.entries()){let n;try{n=await t.assign(s.id,w(s,r))}catch(t){i?.error(e.toolFailed,t,{[_]:`assign`,[v]:s.id}),n={ok:!1,message:t instanceof Error?t.message:String(t)}}a.push({index:o,id:s.id,agent:s.agent,...n})}return a}async function E(e,t,n,r){let{document:i,value:a}=await e.mutate(e=>{let i=o(e,t,n,void 0,r);return{...s(i.op)?{document:i.document}:{},value:i}});if(a.op.kind===`error`)throw x(t,a.op.message);if(a.op.kind===`upsert`&&a.op.applied===0)throw x(t,h(a.op));return p(t,n,i,a.op)}function D(t,a){let{store:o,delegation:s,maxTasks:p=15}=a;t.registerTool({name:r,label:n,description:`Manage a shared task list for tracking multi-step progress, and delegate tasks to subagents. Actions: upsert (write tasks — a tasks[] array where an entry with an id changes that task and an entry without an id creates one, so one call can capture a whole plan), list, get, delete (tombstone), clear (close/reset the list), assign (hand one or more tasks through assignments[] to named subagents that work in the background), cancel (stop a delegated run). upsert and assign apply entries independently: successes remain committed or delegated and failures are reported by array index. Batch a plan and independent assignments, but report progress one task at a time. Status: pending → in_progress → completed, plus failed and a deleted tombstone. The list is shared within the current session tree, including delegated subagents, while unrelated sessions start empty. Session stores persist until retention cleanup.`,promptSnippet:g,promptGuidelines:u,parameters:i,renderShell:`self`,async execute(t,n,r,i,c){let l=n.action,u=n;try{if(S(l,u),y.has(l)){let e=await E(o,l,u,p);return a.onChange?.(),e}if(l===`assign`){let e=C(u),t=e[0],n=e.length===1&&t?`Delegating task #${t.id}...`:`Delegating ${e.length} tasks...`;i?.(f(l,u,o.snapshot,n));let c=await T(s,e,r,a.report);a.onChange?.();let p=m(c),h=c.flatMap(e=>e.ok?[e.id]:[]);if(h.length===0)throw x(l,p);return d(u,o.snapshot,p,{assigned:h,failed:c.length-h.length})}i?.(f(l,u,o.snapshot,`Requesting cancellation for task #${u.id??`unknown`}...`));let e=await s.cancel(u.id??NaN);if(a.onChange?.(),!e.ok)throw x(l,e.message);return f(l,u,o.snapshot,e.message,void 0)}catch(t){throw a.report?.error(e.toolFailed,t,{[_]:l,...u.id===void 0?{}:{[v]:u.id}}),t instanceof b?t:x(l,t instanceof Error?t.message:String(t))}},renderCall(e,t,n){return c(e,t,o.snapshot.tasks)},renderResult(e,t,n,r){return l(e,t,n)}})}export{u as DEFAULT_PROMPT_GUIDELINES,g as DEFAULT_PROMPT_SNIPPET,D as registerTaskTool};
+//# sourceMappingURL=taskTool.mjs.map

package/dist/commands/task/taskTool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskTool.mjs","names":[],"sources":["../../../src/commands/task/taskTool.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport { TASK_EVENT, type TaskFailureReporter } from '../../adapters/telemetry/logSinkTelemetry.ts';\nimport {\n  MSG_UPSERT_FIELD_MISPLACED,\n  TaskParamsSchema,\n  TOOL_LABEL,\n  TOOL_NAME,\n  taskActionAcceptsField,\n} from '../../schemas/task.ts';\nimport type { AssignOptions, DelegationManager, DelegationOutcome } from '../../services/delegation/manager.ts';\nimport { applyTaskMutation, isCommittingOp, type ReducerAction } from '../../services/store/reducer.ts';\nimport type { TaskStore } from '../../services/store/taskStore.ts';\nimport type { TaskAction, TaskAssignment, TaskMutationParams } from '../../services/store/types.ts';\nimport { renderTaskCall, renderTaskResult } from '../../tui/format.ts';\nimport { DEFAULT_MAX_TASKS } from '../../types/config.ts';\nimport { DEFAULT_PROMPT_GUIDELINES } from './promptGuidelines.ts';\nimport {\n  type AssignmentItemResult,\n  buildAssignmentResult,\n  buildTextResult,\n  buildToolResult,\n  formatAssignmentResults,\n  formatUpsertFailureText,\n  type ToolResult,\n} from './responseEnvelope.ts';\n\nexport { DEFAULT_PROMPT_GUIDELINES } from './promptGuidelines.ts';\n\nexport const DEFAULT_PROMPT_SNIPPET =\n  'Manage a shared task list to track multi-step progress, and delegate tasks to subagents';\n\nexport interface TaskToolDependencies {\n  store: TaskStore;\n  delegation: DelegationManager;\n  maxTasks?: number;\n  onChange?: () => void;\n  report?: TaskFailureReporter;\n}\n\nconst ACTION_ATTRIBUTE = 'tool.action';\nconst TASK_ID_ATTRIBUTE = 'task.id';\nconst REDUCER_ACTIONS = new Set<TaskAction>(['upsert', 'list', 'get', 'delete', 'clear']);\n\nclass TaskToolExecutionError extends Error {}\n\nfunction actionableTaskError(action: TaskAction, message: string): TaskToolExecutionError {\n  return new TaskToolExecutionError(\n    [\n      `Task ${action} failed: ${message}`,\n      '',\n      'Options:',\n      '- List the task board and inspect the current ids, states, and blockers.',\n      '- Correct the arguments or state conflict, then retry once.',\n      '- Ask the user before cancelling work or changing dependencies to recover.',\n    ].join('\\n'),\n  );\n}\n\n/**\n * Reject a field that belongs to a different action.\n *\n * The params schema is flat and shared across every action, so this is the only\n * place `{\"action\":\"upsert\",\"id\":3}` can be caught — and it must be, because\n * the entry it carries has no id and would silently create a duplicate task.\n */\nfunction rejectStrayFields(action: TaskAction, params: TaskMutationParams): void {\n  const stray = Object.keys(params).filter((key) => params[key] !== undefined && !taskActionAcceptsField(action, key));\n  if (stray.length === 0) return;\n  const hint = action === 'upsert' ? ` ${MSG_UPSERT_FIELD_MISPLACED}` : '';\n  throw actionableTaskError(action, `${action} does not accept ${stray.join(', ')}.${hint}`);\n}\n\n/** assignments[] is the only assign contract, even when it contains one task. */\nfunction resolveAssignments(params: TaskMutationParams): TaskAssignment[] {\n  const assignments = params.assignments;\n  if (!assignments || assignments.length === 0) {\n    throw actionableTaskError('assign', 'assign requires a non-empty assignments[] array');\n  }\n  return assignments;\n}\n\nfunction assignOptions(request: TaskAssignment, signal: AbortSignal | undefined): AssignOptions {\n  return {\n    agent: request.agent,\n    inlineAgent: request.inlineAgent,\n    instructions: request.instructions,\n    relevantFiles: request.relevantFiles,\n    priorFindings: request.priorFindings,\n    model: request.model,\n    context: request.context,\n    signal,\n  };\n}\n\nasync function executeAssignmentBatch(\n  delegation: DelegationManager,\n  assignments: readonly TaskAssignment[],\n  signal: AbortSignal | undefined,\n  report: TaskFailureReporter | undefined,\n): Promise<AssignmentItemResult[]> {\n  const results: AssignmentItemResult[] = [];\n  for (const [index, assignment] of assignments.entries()) {\n    let outcome: DelegationOutcome;\n    try {\n      outcome = await delegation.assign(assignment.id, assignOptions(assignment, signal));\n    } catch (error) {\n      report?.error(TASK_EVENT.toolFailed, error, {\n        [ACTION_ATTRIBUTE]: 'assign',\n        [TASK_ID_ATTRIBUTE]: assignment.id,\n      });\n      outcome = { ok: false, message: error instanceof Error ? error.message : String(error) };\n    }\n    results.push({ index, id: assignment.id, agent: assignment.agent, ...outcome });\n  }\n  return results;\n}\n\n/** Run an action through the reducer, persisting only when it produced a change. */\nasync function executeReducerAction(\n  store: TaskStore,\n  action: ReducerAction,\n  params: TaskMutationParams,\n  maxTasks: number,\n): Promise<ToolResult> {\n  const { document, value } = await store.mutate((current) => {\n    const result = applyTaskMutation(current, action, params, undefined, maxTasks);\n    return {\n      ...(isCommittingOp(result.op) ? { document: result.document } : {}),\n      value: result,\n    };\n  });\n  if (value.op.kind === 'error') throw actionableTaskError(action, value.op.message);\n  // An upsert that applied nothing is a failed call: it wrote nothing and left\n  // `rev` alone, so it must not read to the model as a success. A batch where\n  // some entries landed returns normally — that is what partial apply means.\n  if (value.op.kind === 'upsert' && value.op.applied === 0) {\n    throw actionableTaskError(action, formatUpsertFailureText(value.op));\n  }\n  // `document` is the committed document, so `details.rev` matches what landed\n  // on disk; `value.document` is the pre-write copy and lags by one.\n  return buildToolResult(action, params, document, value.op);\n}\n\nexport function registerTaskTool(pi: ExtensionAPI, dependencies: TaskToolDependencies): void {\n  const { store, delegation, maxTasks = DEFAULT_MAX_TASKS } = dependencies;\n\n  pi.registerTool({\n    name: TOOL_NAME,\n    label: TOOL_LABEL,\n    description:\n      'Manage a shared task list for tracking multi-step progress, and delegate tasks to subagents. Actions: upsert (write tasks — a tasks[] array where an entry with an id changes that task and an entry without an id creates one, so one call can capture a whole plan), list, get, delete (tombstone), clear (close/reset the list), assign (hand one or more tasks through assignments[] to named subagents that work in the background), cancel (stop a delegated run). upsert and assign apply entries independently: successes remain committed or delegated and failures are reported by array index. Batch a plan and independent assignments, but report progress one task at a time. Status: pending → in_progress → completed, plus failed and a deleted tombstone. The list is shared within the current session tree, including delegated subagents, while unrelated sessions start empty. Session stores persist until retention cleanup.',\n    promptSnippet: DEFAULT_PROMPT_SNIPPET,\n    promptGuidelines: DEFAULT_PROMPT_GUIDELINES,\n    parameters: TaskParamsSchema,\n    // Task rows carry their own status colors. Owning the shell prevents Pi's\n    // pending/success/error background fill from obscuring those row states.\n    renderShell: 'self',\n\n    async execute(_toolCallId, params, signal, onUpdate, _ctx) {\n      const action = params.action as TaskAction;\n      const mutationParams = params as TaskMutationParams;\n\n      try {\n        rejectStrayFields(action, mutationParams);\n        if (REDUCER_ACTIONS.has(action)) {\n          const result = await executeReducerAction(store, action as ReducerAction, mutationParams, maxTasks);\n          dependencies.onChange?.();\n          return result;\n        }\n\n        if (action === 'assign') {\n          const assignments = resolveAssignments(mutationParams);\n          const first = assignments[0];\n          const progress =\n            assignments.length === 1 && first\n              ? `Delegating task #${first.id}...`\n              : `Delegating ${assignments.length} tasks...`;\n          onUpdate?.(buildTextResult(action, mutationParams, store.snapshot, progress));\n          const results = await executeAssignmentBatch(delegation, assignments, signal, dependencies.report);\n          dependencies.onChange?.();\n          const text = formatAssignmentResults(results);\n          const assigned = results.flatMap((item) => (item.ok ? [item.id] : []));\n          if (assigned.length === 0) throw actionableTaskError(action, text);\n          return buildAssignmentResult(mutationParams, store.snapshot, text, {\n            assigned,\n            failed: results.length - assigned.length,\n          });\n        }\n\n        onUpdate?.(\n          buildTextResult(\n            action,\n            mutationParams,\n            store.snapshot,\n            `Requesting cancellation for task #${mutationParams.id ?? 'unknown'}...`,\n          ),\n        );\n        const outcome = await delegation.cancel(mutationParams.id ?? Number.NaN);\n        dependencies.onChange?.();\n        if (!outcome.ok) throw actionableTaskError(action, outcome.message);\n        return buildTextResult(action, mutationParams, store.snapshot, outcome.message, undefined);\n      } catch (error) {\n        // Rethrown so pi still renders the failure to the model; recorded\n        // because this is where a store fault becomes visible to the user.\n        dependencies.report?.error(TASK_EVENT.toolFailed, error, {\n          [ACTION_ATTRIBUTE]: action,\n          ...(mutationParams.id === undefined ? {} : { [TASK_ID_ATTRIBUTE]: mutationParams.id }),\n        });\n        if (error instanceof TaskToolExecutionError) throw error;\n        throw actionableTaskError(action, error instanceof Error ? error.message : String(error));\n      }\n    },\n\n    // Render hooks receive no session identity, so they read the store snapshot\n    // that the executing session last loaded. That is the foreground session's\n    // own view, which is exactly what its transcript should show.\n    renderCall(args, theme, _context) {\n      return renderTaskCall(args as never, theme, store.snapshot.tasks);\n    },\n\n    renderResult(result, options, theme, _context) {\n      return renderTaskResult(result, options, theme);\n    },\n  });\n}\n"],"mappings":"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"}

package/dist/commands.cjs

@@ -1,2 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./tool/schema.cjs"),t=require("./tui/taskSpace.cjs");function n(n,r){n.registerCommand(e.COMMAND_NAME,{description:`Open Task Space for this session tree`,handler:async(n,i)=>{if(!i.hasUI){i.ui.notify(e.ERR_REQUIRES_INTERACTIVE,`error`);return}r.read(),await t.openTaskSpace(i,{store:r})}})}exports.registerTasksCommand=n;
-//# sourceMappingURL=commands.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./commands/index.cjs");exports.registerTasksCommand=e.registerTasksCommand;

package/dist/commands.d.cts

@@ -1,14 +1,2 @@
-import { TaskStore } from "./store/taskStore.cjs";
-import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-//#region src/commands.d.ts
-/**
- * `/tasks`, reachable from the leader palette as `SPC t t`.
- *
- * The command opens the Task Space overlay rather than printing a listing: the
- * overlay is the readable surface and it can edit, while a transcript dump could
- * only be read.
- */
-declare function registerTasksCommand(pi: ExtensionAPI, store: TaskStore): void;
-//#endregion
-export { registerTasksCommand };
-//# sourceMappingURL=commands.d.cts.map
+import { registerTasksCommand } from "./commands/index.cjs";
+export { registerTasksCommand };

package/dist/commands.d.mts

@@ -1,14 +1,2 @@
-import { TaskStore } from "./store/taskStore.mjs";
-import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-//#region src/commands.d.ts
-/**
- * `/tasks`, reachable from the leader palette as `SPC t t`.
- *
- * The command opens the Task Space overlay rather than printing a listing: the
- * overlay is the readable surface and it can edit, while a transcript dump could
- * only be read.
- */
-declare function registerTasksCommand(pi: ExtensionAPI, store: TaskStore): void;
-//#endregion
-export { registerTasksCommand };
-//# sourceMappingURL=commands.d.mts.map
+import { registerTasksCommand } from "./commands/index.mjs";
+export { registerTasksCommand };

package/dist/commands.mjs

@@ -1,2 +1 @@
-import{COMMAND_NAME as e,ERR_REQUIRES_INTERACTIVE as t}from"./tool/schema.mjs";import{openTaskSpace as n}from"./tui/taskSpace.mjs";function r(r,i){r.registerCommand(e,{description:`Open Task Space for this session tree`,handler:async(e,r)=>{if(!r.hasUI){r.ui.notify(t,`error`);return}i.read(),await n(r,{store:i})}})}export{r as registerTasksCommand};
-//# sourceMappingURL=commands.mjs.map
+import{registerTasksCommand as e}from"./commands/index.mjs";export{e as registerTasksCommand};

package/dist/config.cjs

@@ -1,2 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=`DOOM_TASK_COLLAPSE_KEY`,t=`DOOM_TASK_STORE_TTL_MS`,n=`DOOM_TASK_DELEGATION_TIMEOUT_MS`,r=`ctrl+shift+t`,i=2592e6,a=12e5;function o(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:{}}function s(e){let t=o(e),n=typeof t.maxWidgetLines==`number`&&Number.isFinite(t.maxWidgetLines)?Math.min(Math.max(t.maxWidgetLines,3),60):12,s=typeof t.storeTtlMs==`number`&&Number.isFinite(t.storeTtlMs)&&t.storeTtlMs>0?t.storeTtlMs:i,c=typeof t.delegationTimeoutMs==`number`&&Number.isFinite(t.delegationTimeoutMs)&&t.delegationTimeoutMs>0?t.delegationTimeoutMs:a;return{maxWidgetLines:n,storeTtlMs:s,collapseKey:typeof t.collapseKey==`string`&&t.collapseKey.trim()?t.collapseKey.trim().toLowerCase()===`off`?`off`:t.collapseKey.trim():r,delegationTimeoutMs:c}}function c(e=process.env){let t=Number.parseInt(e.DOOM_TASK_MAX_WIDGET_LINES??``,10);return Number.isFinite(t)?Math.min(Math.max(t,3),60):12}function l(e=process.env){let n=Number(e[t]);return Number.isFinite(n)&&n>0?n:i}function u(e=process.env){let t=Number(e[n]);return Number.isFinite(t)&&t>0?t:a}function d(t=process.env){let n=t[e]?.trim();return n?n.toLowerCase()===`off`?`off`:n:r}exports.COLLAPSE_KEY_ENV=e,exports.COLLAPSE_KEY_OFF=`off`,exports.DEFAULT_COLLAPSE_KEY=r,exports.DEFAULT_DELEGATION_TIMEOUT_MS=a,exports.DEFAULT_MAX_WIDGET_LINES=12,exports.DEFAULT_STORE_TTL_MS=i,exports.DELEGATION_TIMEOUT_MS_ENV=n,exports.MAX_WIDGET_LINES_ENV=`DOOM_TASK_MAX_WIDGET_LINES`,exports.STORE_TTL_MS_ENV=t,exports.getDelegationTimeoutMs=u,exports.getMaxWidgetLines=c,exports.getStoreTtlMs=l,exports.parsePiTaskConfig=s,exports.resolveCollapseKey=d;
-//# sourceMappingURL=config.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./types/config.cjs");exports.COLLAPSE_KEY_ENV=e.COLLAPSE_KEY_ENV,exports.COLLAPSE_KEY_OFF=e.COLLAPSE_KEY_OFF,exports.DEFAULT_COLLAPSE_KEY=e.DEFAULT_COLLAPSE_KEY,exports.DEFAULT_DELEGATION_TIMEOUT_MS=e.DEFAULT_DELEGATION_TIMEOUT_MS,exports.DEFAULT_MAX_TASKS=e.DEFAULT_MAX_TASKS,exports.DEFAULT_MAX_WIDGET_LINES=e.DEFAULT_MAX_WIDGET_LINES,exports.DEFAULT_STORE_TTL_MS=e.DEFAULT_STORE_TTL_MS,exports.DELEGATION_TIMEOUT_MS_ENV=e.DELEGATION_TIMEOUT_MS_ENV,exports.MAX_TASKS_ENV=e.MAX_TASKS_ENV,exports.MAX_WIDGET_LINES_ENV=e.MAX_WIDGET_LINES_ENV,exports.STORE_TTL_MS_ENV=e.STORE_TTL_MS_ENV,exports.getDelegationTimeoutMs=e.getDelegationTimeoutMs,exports.getMaxTasks=e.getMaxTasks,exports.getMaxWidgetLines=e.getMaxWidgetLines,exports.getStoreTtlMs=e.getStoreTtlMs,exports.parsePiTaskConfig=e.parsePiTaskConfig,exports.resolveCollapseKey=e.resolveCollapseKey;

package/dist/config.d.cts

@@ -1,38 +1,2 @@
-//#region src/config.d.ts
-/**
- * Extension configuration, read from the environment.
- *
- * Env rather than a config file: doom-pi already carries per-launch state to Pi
- * through env vars, so this keeps doom-task consistent with how the harness
- * configures the rest of the extension set.
- */
-declare const MAX_WIDGET_LINES_ENV = "DOOM_TASK_MAX_WIDGET_LINES";
-declare const COLLAPSE_KEY_ENV = "DOOM_TASK_COLLAPSE_KEY";
-declare const STORE_TTL_MS_ENV = "DOOM_TASK_STORE_TTL_MS";
-declare const DELEGATION_TIMEOUT_MS_ENV = "DOOM_TASK_DELEGATION_TIMEOUT_MS";
-declare const DEFAULT_MAX_WIDGET_LINES = 12;
-declare const DEFAULT_COLLAPSE_KEY = "ctrl+shift+t";
-declare const DEFAULT_STORE_TTL_MS: number;
-/** Deliberately under the subagents auto-drain ceiling (30 min) so a headless
- * session still gets the failure and a model turn before draining gives up. */
-declare const DEFAULT_DELEGATION_TIMEOUT_MS: number;
-declare const COLLAPSE_KEY_OFF = "off";
-interface PiTaskConfig {
-  maxWidgetLines: number;
-  storeTtlMs: number;
-  collapseKey: string;
-  delegationTimeoutMs: number;
-}
-/** Parse configuration only after the Pi host has applied its project-trust policy. */
-declare function parsePiTaskConfig(value: unknown): PiTaskConfig;
-/** Rows the overlay may use for content, clamped to a sane range. */
-declare function getMaxWidgetLines(env?: NodeJS.ProcessEnv): number;
-/** Retention window for inactive session-tree stores. */
-declare function getStoreTtlMs(env?: NodeJS.ProcessEnv): number;
-/** How long a delegated run may go without reporting a result. */
-declare function getDelegationTimeoutMs(env?: NodeJS.ProcessEnv): number;
-/** Collapse shortcut, or the `off` sentinel when the user disabled it. */
-declare function resolveCollapseKey(env?: NodeJS.ProcessEnv): string;
-//#endregion
-export { COLLAPSE_KEY_ENV, COLLAPSE_KEY_OFF, DEFAULT_COLLAPSE_KEY, DEFAULT_DELEGATION_TIMEOUT_MS, DEFAULT_MAX_WIDGET_LINES, DEFAULT_STORE_TTL_MS, DELEGATION_TIMEOUT_MS_ENV, MAX_WIDGET_LINES_ENV, PiTaskConfig, STORE_TTL_MS_ENV, getDelegationTimeoutMs, getMaxWidgetLines, getStoreTtlMs, parsePiTaskConfig, resolveCollapseKey };
-//# sourceMappingURL=config.d.cts.map
+import { COLLAPSE_KEY_ENV, COLLAPSE_KEY_OFF, DEFAULT_COLLAPSE_KEY, DEFAULT_DELEGATION_TIMEOUT_MS, DEFAULT_MAX_TASKS, DEFAULT_MAX_WIDGET_LINES, DEFAULT_STORE_TTL_MS, DELEGATION_TIMEOUT_MS_ENV, MAX_TASKS_ENV, MAX_WIDGET_LINES_ENV, PiTaskConfig, STORE_TTL_MS_ENV, getDelegationTimeoutMs, getMaxTasks, getMaxWidgetLines, getStoreTtlMs, parsePiTaskConfig, resolveCollapseKey } from "./types/config.cjs";
+export { COLLAPSE_KEY_ENV, COLLAPSE_KEY_OFF, DEFAULT_COLLAPSE_KEY, DEFAULT_DELEGATION_TIMEOUT_MS, DEFAULT_MAX_TASKS, DEFAULT_MAX_WIDGET_LINES, DEFAULT_STORE_TTL_MS, DELEGATION_TIMEOUT_MS_ENV, MAX_TASKS_ENV, MAX_WIDGET_LINES_ENV, PiTaskConfig, STORE_TTL_MS_ENV, getDelegationTimeoutMs, getMaxTasks, getMaxWidgetLines, getStoreTtlMs, parsePiTaskConfig, resolveCollapseKey };

package/dist/config.d.mts

@@ -1,38 +1,2 @@
-//#region src/config.d.ts
-/**
- * Extension configuration, read from the environment.
- *
- * Env rather than a config file: doom-pi already carries per-launch state to Pi
- * through env vars, so this keeps doom-task consistent with how the harness
- * configures the rest of the extension set.
- */
-declare const MAX_WIDGET_LINES_ENV = "DOOM_TASK_MAX_WIDGET_LINES";
-declare const COLLAPSE_KEY_ENV = "DOOM_TASK_COLLAPSE_KEY";
-declare const STORE_TTL_MS_ENV = "DOOM_TASK_STORE_TTL_MS";
-declare const DELEGATION_TIMEOUT_MS_ENV = "DOOM_TASK_DELEGATION_TIMEOUT_MS";
-declare const DEFAULT_MAX_WIDGET_LINES = 12;
-declare const DEFAULT_COLLAPSE_KEY = "ctrl+shift+t";
-declare const DEFAULT_STORE_TTL_MS: number;
-/** Deliberately under the subagents auto-drain ceiling (30 min) so a headless
- * session still gets the failure and a model turn before draining gives up. */
-declare const DEFAULT_DELEGATION_TIMEOUT_MS: number;
-declare const COLLAPSE_KEY_OFF = "off";
-interface PiTaskConfig {
-  maxWidgetLines: number;
-  storeTtlMs: number;
-  collapseKey: string;
-  delegationTimeoutMs: number;
-}
-/** Parse configuration only after the Pi host has applied its project-trust policy. */
-declare function parsePiTaskConfig(value: unknown): PiTaskConfig;
-/** Rows the overlay may use for content, clamped to a sane range. */
-declare function getMaxWidgetLines(env?: NodeJS.ProcessEnv): number;
-/** Retention window for inactive session-tree stores. */
-declare function getStoreTtlMs(env?: NodeJS.ProcessEnv): number;
-/** How long a delegated run may go without reporting a result. */
-declare function getDelegationTimeoutMs(env?: NodeJS.ProcessEnv): number;
-/** Collapse shortcut, or the `off` sentinel when the user disabled it. */
-declare function resolveCollapseKey(env?: NodeJS.ProcessEnv): string;
-//#endregion
-export { COLLAPSE_KEY_ENV, COLLAPSE_KEY_OFF, DEFAULT_COLLAPSE_KEY, DEFAULT_DELEGATION_TIMEOUT_MS, DEFAULT_MAX_WIDGET_LINES, DEFAULT_STORE_TTL_MS, DELEGATION_TIMEOUT_MS_ENV, MAX_WIDGET_LINES_ENV, PiTaskConfig, STORE_TTL_MS_ENV, getDelegationTimeoutMs, getMaxWidgetLines, getStoreTtlMs, parsePiTaskConfig, resolveCollapseKey };
-//# sourceMappingURL=config.d.mts.map
+import { COLLAPSE_KEY_ENV, COLLAPSE_KEY_OFF, DEFAULT_COLLAPSE_KEY, DEFAULT_DELEGATION_TIMEOUT_MS, DEFAULT_MAX_TASKS, DEFAULT_MAX_WIDGET_LINES, DEFAULT_STORE_TTL_MS, DELEGATION_TIMEOUT_MS_ENV, MAX_TASKS_ENV, MAX_WIDGET_LINES_ENV, PiTaskConfig, STORE_TTL_MS_ENV, getDelegationTimeoutMs, getMaxTasks, getMaxWidgetLines, getStoreTtlMs, parsePiTaskConfig, resolveCollapseKey } from "./types/config.mjs";
+export { COLLAPSE_KEY_ENV, COLLAPSE_KEY_OFF, DEFAULT_COLLAPSE_KEY, DEFAULT_DELEGATION_TIMEOUT_MS, DEFAULT_MAX_TASKS, DEFAULT_MAX_WIDGET_LINES, DEFAULT_STORE_TTL_MS, DELEGATION_TIMEOUT_MS_ENV, MAX_TASKS_ENV, MAX_WIDGET_LINES_ENV, PiTaskConfig, STORE_TTL_MS_ENV, getDelegationTimeoutMs, getMaxTasks, getMaxWidgetLines, getStoreTtlMs, parsePiTaskConfig, resolveCollapseKey };

package/dist/config.mjs

@@ -1,2 +1 @@
-const e=`DOOM_TASK_MAX_WIDGET_LINES`,t=`DOOM_TASK_COLLAPSE_KEY`,n=`DOOM_TASK_STORE_TTL_MS`,r=`DOOM_TASK_DELEGATION_TIMEOUT_MS`,i=12,a=`ctrl+shift+t`,o=2592e6,s=12e5,c=`off`;function l(e){return typeof e==`object`&&e&&!Array.isArray(e)?e:{}}function u(e){let t=l(e),n=typeof t.maxWidgetLines==`number`&&Number.isFinite(t.maxWidgetLines)?Math.min(Math.max(t.maxWidgetLines,3),60):12,r=typeof t.storeTtlMs==`number`&&Number.isFinite(t.storeTtlMs)&&t.storeTtlMs>0?t.storeTtlMs:o,i=typeof t.delegationTimeoutMs==`number`&&Number.isFinite(t.delegationTimeoutMs)&&t.delegationTimeoutMs>0?t.delegationTimeoutMs:s;return{maxWidgetLines:n,storeTtlMs:r,collapseKey:typeof t.collapseKey==`string`&&t.collapseKey.trim()?t.collapseKey.trim().toLowerCase()===`off`?`off`:t.collapseKey.trim():a,delegationTimeoutMs:i}}function d(e=process.env){let t=Number.parseInt(e.DOOM_TASK_MAX_WIDGET_LINES??``,10);return Number.isFinite(t)?Math.min(Math.max(t,3),60):12}function f(e=process.env){let t=Number(e[n]);return Number.isFinite(t)&&t>0?t:o}function p(e=process.env){let t=Number(e[r]);return Number.isFinite(t)&&t>0?t:s}function m(e=process.env){let n=e[t]?.trim();return n?n.toLowerCase()===`off`?`off`:n:a}export{t as COLLAPSE_KEY_ENV,c as COLLAPSE_KEY_OFF,a as DEFAULT_COLLAPSE_KEY,s as DEFAULT_DELEGATION_TIMEOUT_MS,i as DEFAULT_MAX_WIDGET_LINES,o as DEFAULT_STORE_TTL_MS,r as DELEGATION_TIMEOUT_MS_ENV,e as MAX_WIDGET_LINES_ENV,n as STORE_TTL_MS_ENV,p as getDelegationTimeoutMs,d as getMaxWidgetLines,f as getStoreTtlMs,u as parsePiTaskConfig,m as resolveCollapseKey};
-//# sourceMappingURL=config.mjs.map
+import{COLLAPSE_KEY_ENV as e,COLLAPSE_KEY_OFF as t,DEFAULT_COLLAPSE_KEY as n,DEFAULT_DELEGATION_TIMEOUT_MS as r,DEFAULT_MAX_TASKS as i,DEFAULT_MAX_WIDGET_LINES as a,DEFAULT_STORE_TTL_MS as o,DELEGATION_TIMEOUT_MS_ENV as s,MAX_TASKS_ENV as c,MAX_WIDGET_LINES_ENV as l,STORE_TTL_MS_ENV as u,getDelegationTimeoutMs as d,getMaxTasks as f,getMaxWidgetLines as p,getStoreTtlMs as m,parsePiTaskConfig as h,resolveCollapseKey as g}from"./types/config.mjs";export{e as COLLAPSE_KEY_ENV,t as COLLAPSE_KEY_OFF,n as DEFAULT_COLLAPSE_KEY,r as DEFAULT_DELEGATION_TIMEOUT_MS,i as DEFAULT_MAX_TASKS,a as DEFAULT_MAX_WIDGET_LINES,o as DEFAULT_STORE_TTL_MS,s as DELEGATION_TIMEOUT_MS_ENV,c as MAX_TASKS_ENV,l as MAX_WIDGET_LINES_ENV,u as STORE_TTL_MS_ENV,d as getDelegationTimeoutMs,f as getMaxTasks,p as getMaxWidgetLines,m as getStoreTtlMs,h as parsePiTaskConfig,g as resolveCollapseKey};

package/dist/delegation/manager.cjs

@@ -1,6 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../_virtual/_rolldown/runtime.cjs"),t=require("../logSinkTelemetry.cjs"),n=require("../store/types.cjs"),r=require("../store/reconcile.cjs"),i=require("../store/taskGraph.cjs");let a=require("node:crypto"),o=require("node:path");o=e.__toESM(o,1);let s=require("@agimon-ai/doompi-extension-contracts/delegation"),c=require("@agimon-ai/doompi-extension-contracts/protocol");const l=`doom-task-notify`,u=`completed`,d=`failed`,f=`cancelled`,p=`task.id`,m=`delegation.request_id`,h=`delegation.agent_name`,g=`delegation.context_present`,_=`delegation.context_file_count`,v=`delegation.context_notes_length`,y=`No subagent runtime responded. Delegation needs the subagents extension — relaunch doom-pi with agents enabled.`,b=`assign is only available in the main session. Update this task directly instead of re-delegating it.`,x=`Subagent did not acknowledge the cancel request`;function S(e,t=4e3){if(e)return e.length<=t?e:`${e.slice(0,t)}\n… (truncated)`}function C(e){return e instanceof Error?e.message:String(e)}function w(e,t){if(!o.default.isAbsolute(e))return o.default.normalize(e);let n=o.default.relative(t,e);return n&&!n.startsWith(`..`)?n:e}function T(e,t){let n=new Set;for(let r of e.relevantFiles??[]){if(n.size>=12)break;let e=w(r.trim(),t);e&&e!==`.`&&n.add(e)}return{files:[...n],notes:S(e.priorFindings?.trim(),1500)}}function E(e,t,n){let r=[`Task #${e.id}: ${e.subject}`];if(e.description&&r.push(e.description),t&&r.push(t),n.files.length>0||n.notes){let e=[`Parent context — consume before repository discovery:`];n.files.length>0&&e.push(`- Parent-verified files (read these first with direct reads): ${n.files.join(`, `)}`),n.notes&&e.push(`- Established facts (do not re-derive unless direct evidence contradicts them): ${n.notes}`),e.push(`This pack satisfies initial repository/context exploration. Do not begin with repository-wide listing, find, or grep. Expand only after consuming the pack and naming a concrete missing dependency or invalid path; search narrowly for that item and state why.`),r.push(e.join(`
-`))}return r.push(`Coordination: work directly without changing the task record; ask main through intercom only for blockers or decisions; report changed files and verification when done.`),r.join(`
-
-`)}var D=class e{options;progress=new Map;pendingTasks=new Map;timers=new Map;subscriptions=[];protocol;constructor(e){this.options=e}now(){return this.options.now?.()??new Date().toISOString()}nowMs(){return this.options.nowMs?.()??Date.now()}get env(){return this.options.env??process.env}get runTimeoutMs(){return this.options.runTimeoutMs??12e5}report(e,t,n){this.options.report?.error(e,t,n)}get isChildSession(){return!!this.env.PI_SUBAGENT_CHILD}progressFor(e){let t=e.delegation?.requestId;return t?this.progress.get(t):void 0}static elapsedMs(e,t=Date.now()){let n=e.durationMs??0,r=e.durationObservedAt??t;return n+Math.max(0,t-r)}start(){if(this.subscriptions.length>0)return;let e=this.options.getSessionId?.();e&&(this.protocol=(0,c.createProtocolRuntime)({bus:this.options.events,source:`@agimon-ai/doompi-task`,sessionId:e}),this.subscriptions.push(this.protocol.onNotification(s.DelegationAccepted,e=>{this.handleAccepted(e)}),this.protocol.onNotification(s.DelegationStarted,e=>{this.handleStarted(e)}),this.protocol.onNotification(s.DelegationUpdated,e=>{this.handleUpdate(e)}),this.protocol.onNotification(s.DelegationFinished,e=>{this.handleResponse(e).catch(n=>{this.report(t.TASK_EVENT.delegationResponseFailed,n,{[m]:e.requestId})})})))}listActiveWork(){let e=this.options.getSessionId?.()??``;return[...this.pendingTasks.entries()].map(([t,n])=>({id:`task-${n}:${t}`,sessionId:e}))}async reconcile(){let{value:e}=await this.options.store.mutate(e=>{let t=r.reconcileOrphanedDelegations(e,this.now(),void 0,{pid:process.pid,liveRequestIds:new Set(this.pendingTasks.keys())});return t.orphaned.length===0?{value:[]}:{document:t.document,value:t.orphaned}});for(let n of e)this.options.report?.warn(t.TASK_EVENT.delegationOrphaned,Error(n.delegation?.result?.error??``),{[p]:n.id,...n.delegation?.agent?{[h]:n.delegation.agent}:{},...n.delegation?.pid===void 0?{}:{"delegation.pid":n.delegation.pid}});return e.length>0&&this.options.onChange?.(),e}async assign(e,r){let o=r.agent?.trim();if(!o)return{ok:!1,message:`agent required for assign`};if(this.isChildSession)return{ok:!1,message:b};if(r.signal?.aborted)return{ok:!1,message:`delegation cancelled before it started`};let c=(0,a.randomUUID)(),l=this.now(),f=T(r,this.options.cwd),{value:x}=await this.options.store.mutate(t=>{let a=t.tasks.findIndex(t=>t.id===e);if(a===-1)return{value:{ok:!1,message:`#${e} not found`}};let s=t.tasks[a];if(s.status===`deleted`)return{value:{ok:!1,message:`#${e} is deleted`}};if(s.status===u)return{value:{ok:!1,message:`#${e} is already completed`}};if(n.isDelegationActive(s))return{value:{ok:!1,message:`#${e} is already delegated to ${s.delegation?.agent}`}};if(i.isBlocked(t.tasks,s))return{value:{ok:!1,message:`#${e} is blocked by ${(s.blockedBy??[]).map(e=>`#${e}`).join(`, `)}`}};let d={requestId:c,agent:o,state:`requested`,pid:process.pid,startedAt:l,...this.options.getSessionId?.()?{sessionId:this.options.getSessionId()}:{},...r.model?{model:r.model}:{}},f=[...t.tasks];return f[a]={...s,owner:o,updatedAt:l,delegation:d},{document:{...t,tasks:f},value:{ok:!0,message:``,task:f[a]}}});if(!x.ok||!x.task)return{ok:!1,message:x.message};let S=f.notes?.length??0;this.pendingTasks.set(c,e),this.progress.set(c,{agent:o,contextFileCount:f.files.length,contextNotesLength:S}),this.armStartedTimeout(c);let w={requestId:c,taskId:e,agent:o,...r.inlineAgent?{inlineAgent:r.inlineAgent}:{},prompt:E(x.task,r.instructions,f),...r.context?{context:r.context}:{},cwd:this.options.cwd,artifacts:!0,timeoutMs:this.runTimeoutMs,runMode:`detached`,teamTask:{id:String(x.task.id),subject:x.task.subject},...r.model?{model:r.model}:{}};try{if(!this.protocol)throw Error(y);this.protocol.notify(s.DelegationRequested,w)}catch(n){this.report(t.TASK_EVENT.delegationRequestFailed,n,{[p]:e,[m]:c,[h]:o});let r=C(n);return await this.settle(c,d,{status:d,error:`Delegation request failed: ${r}`}),{ok:!1,message:`Could not dispatch #${e} to ${o}: ${r}`}}return this.options.report?.event(t.TASK_EVENT.delegationAssigned,{[p]:e,[m]:c,[h]:o,[g]:f.files.length>0||S>0,[_]:f.files.length,[v]:S,"delegation.brief_length":w.prompt.length}),this.options.onChange?.(),{ok:!0,message:`Delegated #${e} to ${o} in the background. It runs independently of this turn and will notify you when it finishes. Continue non-overlapping work, or end the turn and wait.`}}async cancel(e){let t=this.options.store.read().tasks.find(t=>t.id===e);if(!t)return{ok:!1,message:`#${e} not found`};if(!t.delegation||!n.isDelegationActive(t))return{ok:!1,message:`#${e} has no running delegation`};let{requestId:r}=t.delegation;return this.protocol?.notify(s.DelegationCancelled,{requestId:r}),this.armCancelTimeout(r),{ok:!0,message:`Cancelling delegation for #${e} (${t.delegation.agent})`}}settleDetached(e,n,r,i=t.TASK_EVENT.delegationSettleFailed){this.settle(e,n,r).catch(t=>{this.report(i,t,{[m]:e})})}armStartedTimeout(e){this.armTimer(e,this.options.startedTimeoutMs??5e3,()=>{this.settleDetached(e,d,{status:d,error:y})})}armRunTimeout(e){let n=Math.min(6e4,this.runTimeoutMs);this.armTimer(e,this.runTimeoutMs+n,()=>{let n=this.pendingTasks.get(e),r=this.progress.get(e)?.agent,i=Error(`Delegation produced no result within ${this.runTimeoutMs}ms`);this.options.report?.warn(t.TASK_EVENT.delegationTimedOut,i,{...n===void 0?{}:{[p]:n},[m]:e,...r?{[h]:r}:{}}),this.protocol?.notify(s.DelegationCancelled,{requestId:e,reason:i.message}),this.settleDetached(e,d,{status:`timed_out`,error:i.message})})}armCancelTimeout(e){this.pendingTasks.has(e)&&this.armTimer(e,this.options.cancelTimeoutMs??1e4,()=>{this.settleDetached(e,f,{status:f,error:x})})}armTimer(e,t,n){this.clearTimer(e);let r=setTimeout(n,t);r.unref?.(),this.timers.set(e,r)}clearTimer(e){let t=this.timers.get(e);t&&clearTimeout(t),this.timers.delete(e)}handleAccepted(e){this.pendingTasks.has(e.requestId)&&this.armRunTimeout(e.requestId)}handleStarted(e){let{runId:n}=e,r=this.pendingTasks.get(e.requestId);if(r===void 0)return;this.armRunTimeout(e.requestId);let i=this.progress.get(e.requestId);i&&this.progress.set(e.requestId,{...i,durationMs:i.durationMs??0,durationObservedAt:i.durationObservedAt??this.nowMs()}),this.options.store.mutate(t=>this.patchDelegation(t,e.requestId,(e,t)=>({...e,status:e.status===u?e.status:`in_progress`,delegation:{...t,state:`running`,startedAt:t.startedAt??this.now(),...n?{runId:n}:{}}}))).then(()=>this.options.onChange?.()).catch(n=>{this.report(t.TASK_EVENT.delegationStartFailed,n,{[p]:r,[m]:e.requestId})})}handleUpdate(t){let n=this.progress.get(t.requestId);if(!n)return;let r=this.nowMs(),i=e.elapsedMs(n,r),a=t.durationMs!==void 0;this.progress.set(t.requestId,{...n,currentTool:t.currentTool??n.currentTool,toolCount:t.toolCount===void 0?n.toolCount:Math.max(n.toolCount??0,t.toolCount),tokens:t.tokens===void 0?n.tokens:Math.max(n.tokens??0,t.tokens),durationMs:a?Math.max(i,t.durationMs):n.durationMs,durationObservedAt:a?r:n.durationObservedAt}),this.options.onChange?.()}async handleResponse(e){if(!this.pendingTasks.has(e.requestId))return;let t=e.status===u&&!e.error?u:e.status===f?f:d;await this.settle(e.requestId,t,{status:e.status,error:e.error,output:S(e.output),outputPath:e.outputPath,sessionFile:e.sessionFile,durationMs:e.durationMs,toolCount:e.toolCount})}async settle(e,n,r){let a=this.pendingTasks.get(e);if(a===void 0)return;this.pendingTasks.delete(e),this.clearTimer(e);let o=this.progress.get(e);this.progress.delete(e);let s=this.now(),c;try{let{value:t}=await this.options.store.mutate(t=>this.patchDelegation(t,e,(e,t)=>({...e,status:n===u?u:n===f?`pending`:d,updatedAt:s,delegation:{...t,state:n,endedAt:s,...r?{result:r}:{}}})));c=t}catch(n){this.report(t.TASK_EVENT.delegationSettleFailed,n,{[p]:a,[m]:e})}this.options.onChange?.();let l=c?.delegation?.agent??o?.agent??`subagent`,y=c?.subject??`#${a}`;this.options.report?.event(t.TASK_EVENT.delegationCompleted,{[p]:a,[m]:e,[h]:l,"delegation.outcome":n,[g]:(o?.contextFileCount??0)>0||(o?.contextNotesLength??0)>0,[_]:o?.contextFileCount??0,[v]:o?.contextNotesLength??0,...r?.toolCount===void 0?{}:{"delegation.tool_count":r.toolCount},...r?.durationMs===void 0?{}:{"delegation.duration_ms":r.durationMs}});let b=n===u&&c!==void 0&&i.isTaskListComplete(this.options.store.snapshot.tasks);this.notifyModel(n,a,y,l,r,b)}notifyModel(e,t,n,r,i,a){let o=this.options.notify;if(!o)return;let s=[e===u?`Subagent ${r} completed task #${t}: ${n}`:e===f?`Subagent ${r} was cancelled on task #${t}: ${n} (returned to pending)`:`Subagent ${r} failed task #${t}: ${n}`];a&&s.push(``,`All tasks are completed. Review the full task list once more, then close it with task {"action":"clear"}.`),i?.error&&s.push(`Error: ${i.error}`),i?.output&&s.push(``,i.output),i?.outputPath&&s.push(``,`Full output: ${i.outputPath}`);try{o({customType:l,content:s.join(`
-`),display:!0},{triggerTurn:!0,deliverAs:`steer`})}catch(e){this.options.onNotifyError(e,t)}}patchDelegation(e,t,r){let i=e.tasks.findIndex(e=>e.delegation?.requestId===t);if(i===-1)return{value:void 0};let a=e.tasks[i];if(!n.isDelegationActive(a))return{value:a};let o=r(a,a.delegation);if(o===a)return{value:a};let s=[...e.tasks];return s[i]=o,{document:{...e,tasks:s},value:o}}dispose(){for(let e of this.subscriptions)e();this.subscriptions.length=0,this.protocol=void 0;for(let e of this.timers.values())clearTimeout(e);this.timers.clear(),this.pendingTasks.clear(),this.progress.clear()}};exports.BACKGROUND_WORK_PROVIDER=`doom-task`,exports.DelegationManager=D,exports.ERR_CANCEL_UNACKNOWLEDGED=x,exports.ERR_CHILD_SESSION=b,exports.ERR_NO_RUNTIME=y,exports.MAX_BRIEF_FILES=12,exports.NOTIFY_CUSTOM_TYPE=l;
-//# sourceMappingURL=manager.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../services/delegation/manager.cjs");exports.BACKGROUND_WORK_PROVIDER=e.BACKGROUND_WORK_PROVIDER,exports.DelegationManager=e.DelegationManager,exports.ERR_CANCEL_UNACKNOWLEDGED=e.ERR_CANCEL_UNACKNOWLEDGED,exports.ERR_CHILD_SESSION=e.ERR_CHILD_SESSION,exports.ERR_NO_RUNTIME=e.ERR_NO_RUNTIME,exports.MAX_BRIEF_FILES=e.MAX_BRIEF_FILES,exports.NOTIFY_CUSTOM_TYPE=e.NOTIFY_CUSTOM_TYPE;

package/dist/delegation/manager.d.cts

@@ -1,189 +1,2 @@
-import { TaskFailureReporter } from "../logSinkTelemetry.cjs";
-import { Task } from "../store/types.cjs";
-import { TaskStore } from "../store/taskStore.cjs";
-import { InlineAgent } from "@agimon-ai/doompi-extension-contracts/subagent-tool";
-import { EventBusLike } from "@agimon-ai/doompi-extension-contracts/protocol";
-//#region src/delegation/manager.d.ts
-declare const NOTIFY_CUSTOM_TYPE = "doom-task-notify";
-declare const BACKGROUND_WORK_PROVIDER = "doom-task";
-/**
- * Cap on files rendered into a brief. Exported so the tool schema can state the
- * same number to the model rather than restating it and drifting.
- */
-declare const MAX_BRIEF_FILES = 12;
-declare const ERR_NO_RUNTIME = "No subagent runtime responded. Delegation needs the subagents extension — relaunch doom-pi with agents enabled.";
-declare const ERR_CHILD_SESSION = "assign is only available in the main session. Update this task directly instead of re-delegating it.";
-declare const ERR_CANCEL_UNACKNOWLEDGED = "Subagent did not acknowledge the cancel request";
-/** Live progress from a running subagent. Kept in memory: persisting per-tool
- * ticks would rewrite the store file every second for no durable benefit. */
-interface DelegationProgress {
-  agent: string;
-  currentTool?: string;
-  toolCount?: number;
-  tokens?: number;
-  /** Latest child-runtime duration baseline, excluding assignment wait. */
-  durationMs?: number;
-  /** Wall-clock time at which durationMs was observed or rebased. */
-  durationObservedAt?: number;
-  /** Assign-time context-pack shape, carried so the completion event can be
-   * grouped by it without joining back to the assignment event. */
-  contextFileCount?: number;
-  contextNotesLength?: number;
-}
-interface DelegationNotifier {
-  (message: {
-    customType: string;
-    content: string;
-    display: boolean;
-  }, options?: {
-    triggerTurn?: boolean;
-    deliverAs?: 'steer' | 'followUp' | 'nextTurn';
-  }): void;
-}
-interface DelegationManagerOptions {
-  events: EventBusLike;
-  store: TaskStore;
-  cwd: string;
-  notify?: DelegationNotifier;
-  getSessionId?: () => string | undefined;
-  env?: NodeJS.ProcessEnv;
-  onChange?: () => void;
-  startedTimeoutMs?: number;
-  /** How long a started run may go without reporting a result. */
-  runTimeoutMs?: number;
-  /** How long to wait for a cancelled run to report back before forcing it. */
-  cancelTimeoutMs?: number;
-  now?: () => string;
-  nowMs?: () => number;
-  /** Called when a completion notification could not be delivered. */
-  onNotifyError: (error: unknown, taskId: number) => void;
-  /** Where other swallowed delegation failures go. */
-  report?: TaskFailureReporter;
-}
-interface AssignOptions {
-  agent?: string;
-  inlineAgent?: InlineAgent;
-  instructions?: string;
-  /** Paths the parent already located, rendered into the brief so the child
-   * skips rediscovering them. */
-  relevantFiles?: string[];
-  /** Facts the parent already established, rendered into the brief so the child
-   * does not re-derive them. */
-  priorFindings?: string;
-  model?: string;
-  context?: 'fresh' | 'fork';
-  signal?: AbortSignal;
-}
-interface DelegationOutcome {
-  ok: boolean;
-  message: string;
-}
-/**
- * Owns the lifecycle of tasks delegated to subagents.
- *
- * Delegation rides the Doom Team event bus rather than spawning
- * processes directly, so doom-task stays decoupled from the subagent runtime
- * and degrades to a clear error when that runtime is not loaded.
- *
- * Liveness rule: every entry in `pendingTasks` has a timer armed against it, so
- * a delegation always has a deadline no matter which phase it is in. Losing
- * that pairing is what previously left tasks running forever.
- */
-declare class DelegationManager {
-  private readonly options;
-  private readonly progress;
-  private readonly pendingTasks;
-  private readonly timers;
-  private readonly subscriptions;
-  private protocol;
-  constructor(options: DelegationManagerOptions);
-  private now;
-  private nowMs;
-  private get env();
-  private get runTimeoutMs();
-  private report;
-  /** True in a session that is itself a subagent child. */
-  get isChildSession(): boolean;
-  /** Live progress for a task, for the overlay to render. */
-  progressFor(task: Task): DelegationProgress | undefined;
-  /** Displayed runtime duration, rebased from the latest child observation. */
-  static elapsedMs(progress: DelegationProgress, nowMs?: number): number;
-  /** Idempotent: a session restart re-subscribes without stacking handlers. */
-  start(): void;
-  /** Items still in flight, surfaced so auto-stop will not kill the harness. */
-  listActiveWork(): Array<{
-    id: string;
-    sessionId: string;
-  }>;
-  /**
-   * Return tasks nothing can finish to `pending`.
-   *
-   * The live request set is read inside the mutation so a delegation assigned
-   * while the lock was contended is not mistaken for a leftover.
-   */
-  reconcile(): Promise<Task[]>;
-  assign(taskId: number, options: AssignOptions): Promise<DelegationOutcome>;
-  cancel(taskId: number): Promise<DelegationOutcome>;
-  /** Settle without awaiting, reporting rather than dropping a failure. */
-  private settleDetached;
-  /**
-   * Fail a delegation that nobody acknowledged.
-   *
-   * The bus cannot be probed for listeners, so silence is the only available
-   * signal that the subagents runtime is absent. Without this the task would
-   * sit in `requested` forever.
-   */
-  private armStartedTimeout;
-  /**
-   * Bound a run that already started.
-   *
-   * The request carries the same budget, so in the normal case the runtime ends
-   * the run itself and reports a richer result. The grace period biases toward
-   * that answer; this timer only covers a runtime that goes silent, which is
-   * precisely the case where no response event will ever arrive.
-   */
-  private armRunTimeout;
-  /**
-   * Guarantee a cancel reaches a terminal state.
-   *
-   * Emitting the cancel event is a request, not an outcome: a runtime that has
-   * already forgotten the request answers nothing at all. The window still
-   * favours a real response, which carries the run's partial output.
-   */
-  private armCancelTimeout;
-  private armTimer;
-  private clearTimer;
-  /** Runtime acknowledgement moves the request off the short extension-presence watchdog while launch is in flight. */
-  private handleAccepted;
-  private handleStarted;
-  private handleUpdate;
-  private handleResponse;
-  /**
-   * Apply the terminal state of a delegation and tell the model about it.
-   *
-   * A cancelled run returns the task to `pending` (the work is still wanted,
-   * just not by that agent); a failure marks it `failed` so it stays visible
-   * rather than silently rejoining the backlog.
-   *
-   * Dropping the pending entry first makes this single-shot: a response racing
-   * the watchdog cannot settle the same run twice. A failed write therefore
-   * must not abort the rest — the model still gets told, the run stops counting
-   * as active work, and `reconcile` repairs the file at the next session start.
-   */
-  private settle;
-  private notifyModel;
-  /**
-   * Rewrite the task carrying `requestId`, returning the updated task as the mutation value.
-   *
-   * Terminal delegations are left alone. The document here is the freshest one,
-   * read under the store lock, which is the only place the check is meaningful:
-   * a `started` event can land after a cancel already settled the run, and
-   * without this guard its write would resurrect a delegation that nothing is
-   * tracking any more.
-   */
-  private patchDelegation;
-  dispose(): void;
-}
-//#endregion
-export { AssignOptions, BACKGROUND_WORK_PROVIDER, DelegationManager, DelegationManagerOptions, DelegationNotifier, DelegationOutcome, DelegationProgress, ERR_CANCEL_UNACKNOWLEDGED, ERR_CHILD_SESSION, ERR_NO_RUNTIME, MAX_BRIEF_FILES, NOTIFY_CUSTOM_TYPE };
-//# sourceMappingURL=manager.d.cts.map
+import { AssignOptions, BACKGROUND_WORK_PROVIDER, DelegationManager, DelegationManagerOptions, DelegationNotifier, DelegationOutcome, DelegationProgress, ERR_CANCEL_UNACKNOWLEDGED, ERR_CHILD_SESSION, ERR_NO_RUNTIME, MAX_BRIEF_FILES, NOTIFY_CUSTOM_TYPE } from "../services/delegation/manager.cjs";
+export { AssignOptions, BACKGROUND_WORK_PROVIDER, DelegationManager, DelegationManagerOptions, DelegationNotifier, DelegationOutcome, DelegationProgress, ERR_CANCEL_UNACKNOWLEDGED, ERR_CHILD_SESSION, ERR_NO_RUNTIME, MAX_BRIEF_FILES, NOTIFY_CUSTOM_TYPE };