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

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

@@ -0,0 +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 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/taskToolFormat.ts

@@ -0,0 +1,330 @@
+/**
+ * Pure view logic for the task tool card, the browser counterpart of
+ * src/tui/format.ts (renderTaskCall, renderTaskResult). The plugin may reach
+ * only its own files and src/types, so the store shapes it reads are
+ * restated here as the wire JSON of a tool_execution frame.
+ */
+
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'deleted';
+export type TaskAction = 'upsert' | 'list' | 'get' | 'delete' | 'clear' | 'assign' | 'cancel';
+
+export const STATUS_GLYPH: Record<TaskStatus, string> = {
+  pending: '○',
+  in_progress: '◐',
+  completed: '●',
+  failed: '✗',
+  deleted: '⊘',
+};
+
+export const STATUS_LABEL: Record<TaskStatus, string> = {
+  pending: 'pending',
+  in_progress: 'in progress',
+  completed: 'completed',
+  failed: 'failed',
+  deleted: 'deleted',
+};
+
+export const ACTION_GLYPH: Record<TaskAction, string> = {
+  upsert: '✎',
+  delete: '×',
+  get: '›',
+  list: '☰',
+  clear: '∅',
+  assign: '⇒',
+  cancel: '⊗',
+};
+
+/**
+ * `upsert` is two operations behind one name, so a homogeneous batch narrows to
+ * the glyph the operator already reads: `+` means new work appeared, `→` means
+ * work moved. A mixed batch keeps the neutral write glyph.
+ */
+const UPSERT_CREATE_GLYPH = '+';
+const UPSERT_UPDATE_GLYPH = '→';
+/** Task rows kept in a collapsed result, before the card is expanded. */
+const TRANSCRIPT_TASK_ROWS = 8;
+const TASK_STATUSES: readonly TaskStatus[] = ['pending', 'in_progress', 'completed', 'failed', 'deleted'];
+const TASK_ACTIONS: readonly TaskAction[] = ['upsert', 'list', 'get', 'delete', 'clear', 'assign', 'cancel'];
+const INLINE_WHITESPACE = /\s+/gu;
+
+/** One task as the result details carry it (src/services/store/types.ts Task). */
+export interface TaskView {
+  id: number;
+  subject: string;
+  status: TaskStatus;
+  activeForm?: string;
+  blockedBy?: number[];
+  delegation?: { agent?: string; state?: string };
+}
+
+/** The result details (src/services/store/types.ts TaskDetails), narrowed to what the card reads. */
+export interface TaskDetailsView {
+  action: TaskAction;
+  params: Record<string, unknown>;
+  tasks: TaskView[];
+  error?: string;
+  upsert?: { applied: number[]; failed: number };
+  assignment?: { assigned: number[]; failed: number };
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function isStatus(value: unknown): value is TaskStatus {
+  return typeof value === 'string' && (TASK_STATUSES as readonly string[]).includes(value);
+}
+
+function isAction(value: unknown): value is TaskAction {
+  return typeof value === 'string' && (TASK_ACTIONS as readonly string[]).includes(value);
+}
+
+function taskView(value: unknown): TaskView | null {
+  if (!isRecord(value) || typeof value.id !== 'number' || typeof value.subject !== 'string') return null;
+  if (!isStatus(value.status)) return null;
+  const task: TaskView = { id: value.id, subject: value.subject, status: value.status };
+  if (typeof value.activeForm === 'string') task.activeForm = value.activeForm;
+  if (Array.isArray(value.blockedBy)) {
+    task.blockedBy = value.blockedBy.filter((id): id is number => typeof id === 'number');
+  }
+  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;
+}
+
+function idList(value: unknown): number[] {
+  return Array.isArray(value) ? value.filter((id): id is number => typeof id === 'number') : [];
+}
+
+/** Narrows the wire details; null when they are not a task result at all. */
+export function taskDetailsView(details: unknown): TaskDetailsView | null {
+  if (!isRecord(details) || !isAction(details.action) || !Array.isArray(details.tasks)) return null;
+  const view: TaskDetailsView = {
+    action: details.action,
+    params: isRecord(details.params) ? details.params : {},
+    tasks: details.tasks.map(taskView).filter((task): task is TaskView => task !== null),
+  };
+  if (typeof details.error === 'string') view.error = details.error;
+  if (isRecord(details.upsert)) {
+    view.upsert = {
+      applied: idList(details.upsert.applied),
+      failed: typeof details.upsert.failed === 'number' ? details.upsert.failed : 0,
+    };
+  }
+  if (isRecord(details.assignment)) {
+    view.assignment = {
+      assigned: idList(details.assignment.assigned),
+      failed: typeof details.assignment.failed === 'number' ? details.assignment.failed : 0,
+    };
+  }
+  return view;
+}
+
+/** `#id` for the wire's id, which the TUI would resolve to a subject through the store. */
+function idLabel(value: unknown): string {
+  return typeof value === 'number' || typeof value === 'string' ? `#${value}` : '#?';
+}
+
+/** Keep dynamic content on one line. */
+function inlineText(text: string): string {
+  return text.replace(INLINE_WHITESPACE, ' ').trim();
+}
+
+export type TaskCallTone = 'dim' | 'accent';
+
+/** The call header: glyph, action, then the subject or a count, as renderTaskCall lays it out. */
+export interface TaskCallView {
+  glyph: string;
+  action: string;
+  subject?: string;
+  subjectTone: TaskCallTone;
+  /** The assignee (`→ agent`) or the list filter. */
+  detail?: string;
+}
+
+function upsertGlyph(items: readonly Record<string, unknown>[]): string {
+  if (items.length === 0) return ACTION_GLYPH.upsert;
+  if (items.every((item) => item.id === undefined)) return UPSERT_CREATE_GLYPH;
+  if (items.every((item) => item.id !== undefined)) return UPSERT_UPDATE_GLYPH;
+  return ACTION_GLYPH.upsert;
+}
+
+/**
+ * The TUI resolves an id to its subject through the task store; the card has
+ * no store and shows `#id` until the result names the task.
+ */
+export function taskCallView(args: Record<string, unknown>): TaskCallView {
+  const action = typeof args.action === 'string' ? args.action : 'task';
+  if (!isAction(action)) return { glyph: '?', action, subjectTone: 'dim' };
+  const items = action === 'upsert' && Array.isArray(args.tasks) ? args.tasks.filter(isRecord) : [];
+  const view: TaskCallView = {
+    glyph: action === 'upsert' ? upsertGlyph(items) : ACTION_GLYPH[action],
+    action,
+    subjectTone: 'dim',
+  };
+
+  if (action === 'upsert') {
+    // One entry reads exactly as create or update did; a batch reads as a count
+    // rather than a subject it would have to pick arbitrarily.
+    if (items.length === 1) {
+      const only = items[0] ?? {};
+      if (only.id === undefined) {
+        if (typeof only.subject === 'string') view.subject = inlineText(only.subject);
+      } else {
+        view.subject = typeof only.subject === 'string' ? inlineText(only.subject) : idLabel(only.id);
+        view.subjectTone = 'accent';
+      }
+    } else if (items.length > 1) {
+      view.subject = `${items.length} tasks`;
+    }
+  } else if (action === 'assign') {
+    const assignments = Array.isArray(args.assignments) ? args.assignments.filter(isRecord) : [];
+    if (assignments.length === 1) {
+      const only = assignments[0] ?? {};
+      view.subject = idLabel(only.id);
+      view.subjectTone = 'accent';
+      if (typeof only.agent === 'string') view.detail = `→ ${only.agent}`;
+    } else if (assignments.length > 1) {
+      view.subject = `${assignments.length} tasks`;
+    }
+  } else if ((action === 'get' || action === 'delete' || action === 'cancel') && args.id !== undefined) {
+    view.subject = idLabel(args.id);
+    view.subjectTone = 'accent';
+  } else if (action === 'list' && isStatus(args.status)) {
+    view.detail = STATUS_LABEL[args.status];
+  }
+  return view;
+}
+
+/** One row of the result: the task line on the left, its status flushed right. */
+export interface TaskRow {
+  id: number;
+  glyph: string;
+  subject: string;
+  status: TaskStatus;
+  /** Struck through: the task is done with. */
+  closed: boolean;
+  agent?: string;
+  activeForm?: string;
+  blockedBy: number[];
+}
+
+export type TaskResultTone = 'running' | 'ok' | 'error' | 'warning';
+
+export interface TaskResultView {
+  rows: TaskRow[];
+  /** Error text lines when the tool threw or the reducer reported an error. */
+  errorLines: string[];
+  status: { glyph: string; tone: TaskResultTone; text: string } | null;
+}
+
+export function taskRow(task: TaskView): TaskRow {
+  const row: TaskRow = {
+    id: task.id,
+    glyph: STATUS_GLYPH[task.status],
+    subject: inlineText(task.subject),
+    status: task.status,
+    closed: task.status === 'completed' || task.status === 'deleted',
+    blockedBy: task.blockedBy ?? [],
+  };
+  if (task.delegation?.agent) row.agent = inlineText(task.delegation.agent);
+  if (task.status === 'in_progress' && task.activeForm) row.activeForm = inlineText(task.activeForm);
+  return row;
+}
+
+function nonEmptyLines(text: string): string[] {
+  return text.split('\n').filter((line) => line.trim().length > 0);
+}
+
+/**
+ * The rows `list` reported to the model: `details.tasks` is the whole
+ * document, so the call's filters apply again here or the card would disagree
+ * with the text the model was given.
+ */
+function listedTasks(details: TaskDetailsView): TaskView[] {
+  let view = details.tasks;
+  if (details.params.includeDeleted !== true) view = view.filter((task) => task.status !== 'deleted');
+  if (isStatus(details.params.status)) view = view.filter((task) => task.status === details.params.status);
+  return view;
+}
+
+function byIds(details: TaskDetailsView, ids: readonly number[]): TaskView[] {
+  return ids.flatMap((id) => details.tasks.find((task) => task.id === id) ?? []);
+}
+
+function batch(
+  tasks: readonly TaskView[],
+  failed: number,
+  verb: string,
+  expanded: boolean,
+): Pick<TaskResultView, 'rows' | 'status'> {
+  // One applied task and nothing failed is the common case: keep the single
+  // row it has always had rather than dressing it as a bulk report.
+  if (tasks.length === 1 && failed === 0) return { rows: [taskRow(tasks[0] as TaskView)], status: null };
+  const shown = expanded ? tasks : tasks.slice(0, TRANSCRIPT_TASK_ROWS);
+  let summary = `${tasks.length} ${verb}`;
+  if (failed > 0) summary += ` · ${failed} failed`;
+  if (tasks.length > shown.length) summary += ` · ${tasks.length - shown.length} more`;
+  return {
+    rows: shown.map(taskRow),
+    status: { glyph: failed > 0 ? '!' : '✓', tone: failed > 0 ? 'warning' : 'ok', text: summary },
+  };
+}
+
+export function taskResultView(input: {
+  details: unknown;
+  output: string;
+  expanded: boolean;
+  isPartial: boolean;
+  isError: boolean;
+}): TaskResultView {
+  const details = taskDetailsView(input.details);
+
+  // Running. `assign` and `cancel` stream a placeholder before the run settles.
+  if (input.isPartial) {
+    const text = nonEmptyLines(input.output).at(-1) ?? 'working';
+    return { rows: [], errorLines: [], status: { glyph: '◐', tone: 'running', text } };
+  }
+
+  // Failed. Every failure path throws, so Pi hands back error text and no
+  // details; without this the card would show a green tick on a failure.
+  if (input.isError || details?.error !== undefined) {
+    const all = nonEmptyLines(details?.error ?? input.output);
+    if (all.length <= 1) return { rows: [], errorLines: [], status: { glyph: '✗', tone: 'error', text: all[0] ?? '' } };
+    const errorLines = input.expanded ? all : all.slice(0, TRANSCRIPT_TASK_ROWS);
+    return { rows: [], errorLines, status: { glyph: '✗', tone: 'error', text: '' } };
+  }
+
+  if (details === null) return { rows: [], errorLines: [], status: { glyph: '✓', tone: 'ok', text: '' } };
+
+  if (details.action === 'list') {
+    const tasks = listedTasks(details);
+    const shown = input.expanded ? tasks : tasks.slice(0, TRANSCRIPT_TASK_ROWS);
+    let summary = tasks.length === 0 ? 'no tasks' : `${tasks.length} task${tasks.length === 1 ? '' : 's'}`;
+    if (tasks.length > shown.length) summary += ` · ${tasks.length - shown.length} more`;
+    return { rows: shown.map(taskRow), errorLines: [], status: { glyph: '✓', tone: 'ok', text: summary } };
+  }
+
+  if (details.action === 'clear') {
+    return { rows: [], errorLines: [], status: { glyph: '✓', tone: 'ok', text: 'cleared' } };
+  }
+
+  if (details.action === 'assign' && details.assignment) {
+    const assigned = byIds(details, details.assignment.assigned);
+    return { errorLines: [], ...batch(assigned, details.assignment.failed, 'assigned', input.expanded) };
+  }
+
+  if (details.action === 'upsert') {
+    const touched = byIds(details, details.upsert?.applied ?? []);
+    return { errorLines: [], ...batch(touched, details.upsert?.failed ?? 0, 'applied', input.expanded) };
+  }
+
+  // The single task an id-bearing action acted on, so the card names it rather than a bare tick.
+  const id = details.params.id;
+  const task = typeof id === 'number' ? details.tasks.find((candidate) => candidate.id === id) : undefined;
+  if (!task) return { rows: [], errorLines: [], status: { glyph: '✓', tone: 'ok', text: '' } };
+  return { rows: [taskRow(task)], errorLines: [], status: null };
+}

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.`,
+  });
+}

package/web/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noImplicitAny": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true,
+    "forceConsistentCasingInFileNames": true,
+    "types": ["node"]
+  },
+  "include": [".", "../src/types"]
+}

package/dist/commands.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.cjs","names":["COMMAND_NAME","ERR_REQUIRES_INTERACTIVE","openTaskSpace"],"sources":["../src/commands.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { TaskStore } from './store/taskStore.ts';\nimport { COMMAND_NAME, ERR_REQUIRES_INTERACTIVE } from './tool/schema.ts';\nimport { openTaskSpace } from './tui/taskSpace.ts';\n\n/**\n * `/tasks`, reachable from the leader palette as `SPC t t`.\n *\n * The command opens the Task Space overlay rather than printing a listing: the\n * overlay is the readable surface and it can edit, while a transcript dump could\n * only be read.\n */\nexport function registerTasksCommand(pi: ExtensionAPI, store: TaskStore): void {\n  pi.registerCommand(COMMAND_NAME, {\n    description: 'Open Task Space for this session tree',\n    handler: async (_args, ctx) => {\n      if (!ctx.hasUI) {\n        ctx.ui.notify(ERR_REQUIRES_INTERACTIVE, 'error');\n        return;\n      }\n\n      store.read();\n      await openTaskSpace(ctx, { store });\n    },\n  });\n}\n"],"mappings":"yIAYA,SAAgB,EAAqB,EAAkB,EAAwB,CAC7E,EAAG,gBAAgBA,EAAAA,aAAc,CAC/B,YAAa,wCACb,QAAS,MAAO,EAAO,IAAQ,CAC7B,GAAI,CAAC,EAAI,MAAO,CACd,EAAI,GAAG,OAAOC,EAAAA,yBAA0B,OAAO,EAC/C,MACF,CAEA,EAAM,KAAK,EACX,MAAMC,EAAAA,cAAc,EAAK,CAAE,OAAM,CAAC,CACpC,CACF,CAAC,CACH"}

package/dist/commands.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.d.cts","names":[],"sources":["../src/commands.ts"],"mappings":";;;;;;;;;;iBAYgB,qBAAqB,IAAI,cAAc,OAAO"}

package/dist/commands.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.d.mts","names":[],"sources":["../src/commands.ts"],"mappings":";;;;;;;;;;iBAYgB,qBAAqB,IAAI,cAAc,OAAO"}

package/dist/commands.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"commands.mjs","names":[],"sources":["../src/commands.ts"],"sourcesContent":["import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';\nimport type { TaskStore } from './store/taskStore.ts';\nimport { COMMAND_NAME, ERR_REQUIRES_INTERACTIVE } from './tool/schema.ts';\nimport { openTaskSpace } from './tui/taskSpace.ts';\n\n/**\n * `/tasks`, reachable from the leader palette as `SPC t t`.\n *\n * The command opens the Task Space overlay rather than printing a listing: the\n * overlay is the readable surface and it can edit, while a transcript dump could\n * only be read.\n */\nexport function registerTasksCommand(pi: ExtensionAPI, store: TaskStore): void {\n  pi.registerCommand(COMMAND_NAME, {\n    description: 'Open Task Space for this session tree',\n    handler: async (_args, ctx) => {\n      if (!ctx.hasUI) {\n        ctx.ui.notify(ERR_REQUIRES_INTERACTIVE, 'error');\n        return;\n      }\n\n      store.read();\n      await openTaskSpace(ctx, { store });\n    },\n  });\n}\n"],"mappings":"mIAYA,SAAgB,EAAqB,EAAkB,EAAwB,CAC7E,EAAG,gBAAgB,EAAc,CAC/B,YAAa,wCACb,QAAS,MAAO,EAAO,IAAQ,CAC7B,GAAI,CAAC,EAAI,MAAO,CACd,EAAI,GAAG,OAAO,EAA0B,OAAO,EAC/C,MACF,CAEA,EAAM,KAAK,EACX,MAAM,EAAc,EAAK,CAAE,OAAM,CAAC,CACpC,CACF,CAAC,CACH"}

package/dist/config.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.cjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["/**\n * Extension configuration, read from the environment.\n *\n * Env rather than a config file: doom-pi already carries per-launch state to Pi\n * through env vars, so this keeps doom-task consistent with how the harness\n * configures the rest of the extension set.\n */\n\nexport const MAX_WIDGET_LINES_ENV = 'DOOM_TASK_MAX_WIDGET_LINES';\nexport const COLLAPSE_KEY_ENV = 'DOOM_TASK_COLLAPSE_KEY';\nexport const STORE_TTL_MS_ENV = 'DOOM_TASK_STORE_TTL_MS';\nexport const DELEGATION_TIMEOUT_MS_ENV = 'DOOM_TASK_DELEGATION_TIMEOUT_MS';\n\nexport const DEFAULT_MAX_WIDGET_LINES = 12;\nexport const DEFAULT_COLLAPSE_KEY = 'ctrl+shift+t';\nexport const DEFAULT_STORE_TTL_MS = 30 * 24 * 60 * 60 * 1000;\n/** Deliberately under the subagents auto-drain ceiling (30 min) so a headless\n * session still gets the failure and a model turn before draining gives up. */\nexport const DEFAULT_DELEGATION_TIMEOUT_MS = 20 * 60 * 1000;\nexport const COLLAPSE_KEY_OFF = 'off';\n\nconst MIN_WIDGET_LINES = 3;\nconst MAX_WIDGET_LINES = 60;\n\nexport interface PiTaskConfig {\n  maxWidgetLines: number;\n  storeTtlMs: number;\n  collapseKey: string;\n  delegationTimeoutMs: number;\n}\n\nfunction configRecord(value: unknown): Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value) ? (value as Record<string, unknown>) : {};\n}\n\n/** Parse configuration only after the Pi host has applied its project-trust policy. */\nexport function parsePiTaskConfig(value: unknown): PiTaskConfig {\n  const config = configRecord(value);\n  const maxWidgetLines =\n    typeof config.maxWidgetLines === 'number' && Number.isFinite(config.maxWidgetLines)\n      ? Math.min(Math.max(config.maxWidgetLines, MIN_WIDGET_LINES), MAX_WIDGET_LINES)\n      : DEFAULT_MAX_WIDGET_LINES;\n  const storeTtlMs =\n    typeof config.storeTtlMs === 'number' && Number.isFinite(config.storeTtlMs) && config.storeTtlMs > 0\n      ? config.storeTtlMs\n      : DEFAULT_STORE_TTL_MS;\n  const delegationTimeoutMs =\n    typeof config.delegationTimeoutMs === 'number' &&\n    Number.isFinite(config.delegationTimeoutMs) &&\n    config.delegationTimeoutMs > 0\n      ? config.delegationTimeoutMs\n      : DEFAULT_DELEGATION_TIMEOUT_MS;\n  const collapseKey =\n    typeof config.collapseKey === 'string' && config.collapseKey.trim()\n      ? config.collapseKey.trim().toLowerCase() === COLLAPSE_KEY_OFF\n        ? COLLAPSE_KEY_OFF\n        : config.collapseKey.trim()\n      : DEFAULT_COLLAPSE_KEY;\n\n  return { maxWidgetLines, storeTtlMs, collapseKey, delegationTimeoutMs };\n}\n\n/** Rows the overlay may use for content, clamped to a sane range. */\nexport function getMaxWidgetLines(env: NodeJS.ProcessEnv = process.env): number {\n  const raw = Number.parseInt(env[MAX_WIDGET_LINES_ENV] ?? '', 10);\n  if (!Number.isFinite(raw)) return DEFAULT_MAX_WIDGET_LINES;\n  return Math.min(Math.max(raw, MIN_WIDGET_LINES), MAX_WIDGET_LINES);\n}\n\n/** Retention window for inactive session-tree stores. */\nexport function getStoreTtlMs(env: NodeJS.ProcessEnv = process.env): number {\n  const raw = Number(env[STORE_TTL_MS_ENV]);\n  return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_STORE_TTL_MS;\n}\n\n/** How long a delegated run may go without reporting a result. */\nexport function getDelegationTimeoutMs(env: NodeJS.ProcessEnv = process.env): number {\n  const raw = Number(env[DELEGATION_TIMEOUT_MS_ENV]);\n  return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_DELEGATION_TIMEOUT_MS;\n}\n\n/** Collapse shortcut, or the `off` sentinel when the user disabled it. */\nexport function resolveCollapseKey(env: NodeJS.ProcessEnv = process.env): string {\n  const configured = env[COLLAPSE_KEY_ENV]?.trim();\n  if (!configured) return DEFAULT_COLLAPSE_KEY;\n  return configured.toLowerCase() === COLLAPSE_KEY_OFF ? COLLAPSE_KEY_OFF : configured;\n}\n"],"mappings":"mEAQA,MACa,EAAmB,yBACnB,EAAmB,yBACnB,EAA4B,kCAG5B,EAAuB,eACvB,EAAuB,OAGvB,EAAgC,KAa7C,SAAS,EAAa,EAAyC,CAC7D,OAAyB,OAAO,GAAU,UAAnC,GAA+C,CAAC,MAAM,QAAQ,CAAK,EAAK,EAAoC,CAAC,CACtH,CAGA,SAAgB,EAAkB,EAA8B,CAC9D,IAAM,EAAS,EAAa,CAAK,EAC3B,EACJ,OAAO,EAAO,gBAAmB,UAAY,OAAO,SAAS,EAAO,cAAc,EAC9E,KAAK,IAAI,KAAK,IAAI,EAAO,eAAgB,CAAgB,EAAG,EAAgB,EAAA,GAE5E,EACJ,OAAO,EAAO,YAAe,UAAY,OAAO,SAAS,EAAO,UAAU,GAAK,EAAO,WAAa,EAC/F,EAAO,WACP,EACA,EACJ,OAAO,EAAO,qBAAwB,UACtC,OAAO,SAAS,EAAO,mBAAmB,GAC1C,EAAO,oBAAsB,EACzB,EAAO,oBACP,EAQN,MAAO,CAAE,iBAAgB,aAAY,YANnC,OAAO,EAAO,aAAgB,UAAY,EAAO,YAAY,KAAK,EAC9D,EAAO,YAAY,KAAK,CAAC,CAAC,YAAY,IAAA,MAAA,MAEpC,EAAO,YAAY,KAAK,EAC1B,EAE4C,qBAAoB,CACxE,CAGA,SAAgB,EAAkB,EAAyB,QAAQ,IAAa,CAC9E,IAAM,EAAM,OAAO,SAAS,EAAA,4BAA6B,GAAI,EAAE,EAE/D,OADK,OAAO,SAAS,CAAG,EACjB,KAAK,IAAI,KAAK,IAAI,EAAK,CAAgB,EAAG,EAAgB,EADtC,EAE7B,CAGA,SAAgB,EAAc,EAAyB,QAAQ,IAAa,CAC1E,IAAM,EAAM,OAAO,EAAI,EAAiB,EACxC,OAAO,OAAO,SAAS,CAAG,GAAK,EAAM,EAAI,EAAM,CACjD,CAGA,SAAgB,EAAuB,EAAyB,QAAQ,IAAa,CACnF,IAAM,EAAM,OAAO,EAAI,EAA0B,EACjD,OAAO,OAAO,SAAS,CAAG,GAAK,EAAM,EAAI,EAAM,CACjD,CAGA,SAAgB,EAAmB,EAAyB,QAAQ,IAAa,CAC/E,IAAM,EAAa,EAAI,EAAiB,EAAE,KAAK,EAE/C,OADK,EACE,EAAW,YAAY,IAAA,MAAA,MAA4C,EADlD,CAE1B"}