@oxgeneral/orch 0.3.2 → 0.3.4

package/dist/context-OL4BVUV5.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+import { printSuccess, printError, dim, formatDurationSince, printTable } from './chunk-7X2GI5OV.js';
+
+// src/cli/commands/context.ts
+function registerContextCommand(program, container) {
+  const ctx = program.command("context").description("Shared context store for inter-agent data exchange");
+  ctx.command("set <key> <value>").description("Set a shared context entry").option("--ttl <ms>", "Time-to-live in milliseconds").action(async (key, value, opts) => {
+    await container.paths.requireInit();
+    const ttlMs = opts.ttl ? parseInt(opts.ttl, 10) : void 0;
+    await container.contextStore.set(key, value, ttlMs);
+    if (container.context.json) {
+      const entry = await container.contextStore.get(key);
+      console.log(JSON.stringify(entry, null, 2));
+    } else if (container.context.quiet) {
+      console.log(key);
+    } else {
+      printSuccess(`Set context "${key}"`);
+    }
+  });
+  ctx.command("get <key>").description("Get a shared context entry").action(async (key) => {
+    await container.paths.requireInit();
+    const entry = await container.contextStore.get(key);
+    if (!entry) {
+      if (container.context.json) {
+        console.log("null");
+      } else {
+        printError(`Context key "${key}" not found`);
+      }
+      return;
+    }
+    if (container.context.json) {
+      console.log(JSON.stringify(entry, null, 2));
+    } else if (container.context.quiet) {
+      console.log(entry.value);
+    } else {
+      console.log(`
+  ${key} = ${entry.value}`);
+      if (entry.expires_at) {
+        console.log(`  ${dim(`expires: ${entry.expires_at}`)}`);
+      }
+      console.log();
+    }
+  });
+  ctx.command("list").description("List all shared context entries").action(async () => {
+    await container.paths.requireInit();
+    const entries = await container.contextStore.list();
+    if (container.context.json) {
+      console.log(JSON.stringify(entries, null, 2));
+      return;
+    }
+    if (container.context.quiet) {
+      entries.forEach((e) => console.log(`${e.key}=${e.value}`));
+      return;
+    }
+    if (entries.length === 0) {
+      console.log(`
+  No shared context entries. Set one: ${dim("orch context set key value")}
+`);
+      return;
+    }
+    const headers = ["KEY", "VALUE", "UPDATED", "TTL"];
+    const rows = entries.map((e) => [
+      e.key,
+      e.value.length > 50 ? e.value.slice(0, 47) + "..." : e.value,
+      formatDurationSince(e.updated_at),
+      e.expires_at ? formatDurationSince(e.expires_at) : dim("\u2014")
+    ]);
+    console.log();
+    printTable(headers, rows);
+    console.log(`
+  ${entries.length} entries
+`);
+  });
+  ctx.command("delete <key>").description("Delete a shared context entry").action(async (key) => {
+    await container.paths.requireInit();
+    await container.contextStore.delete(key);
+    if (!container.context.quiet && !container.context.json) {
+      printSuccess(`Deleted context "${key}"`);
+    }
+  });
+}
+
+export { registerContextCommand };

package/dist/{cursor-4QIOTDBW.js → cursor-C3TR2IJC.js}

@@ -1,6 +1,7 @@
-import { createStreamingEvents, extractTokens } from './chunk-MGFMVPRD.js';
-import './chunk-XDVMX2FO.js';
-import './chunk-O2MSGW3V.js';
+#!/usr/bin/env node
+import { createStreamingEvents, extractTokens } from './chunk-W6RSVMXR.js';
+import './chunk-CHIP7O6V.js';
+import { classifyAdapterError } from './chunk-2C2TFQ7K.js';
 import { execFile } from 'child_process';
 import { promisify } from 'util';
 
@@ -29,7 +30,8 @@ var CursorAdapter = class {
     }
     return {
       ok: false,
-      error: "Cursor Agent CLI not found. The headless agent CLI is required (cursor-agent or agent)."
+      error: "Cursor Agent CLI not found. The headless agent CLI is required (cursor-agent or agent).",
+      errorKind: "adapter_not_found" /* ADAPTER_NOT_FOUND */
     };
   }
   execute(params) {
@@ -75,8 +77,11 @@ function parseCursorEvent(line) {
         return { type: "tool_call", timestamp, data: parsed };
       case "tool_result":
         return { type: "output", timestamp, data: parsed };
-      case "error":
-        return { type: "error", timestamp, data: parsed.error ?? parsed };
+      case "error": {
+        const errData = parsed.error ?? parsed;
+        const errMsg = typeof errData === "string" ? errData : JSON.stringify(errData);
+        return { type: "error", timestamp, data: errData, errorKind: classifyAdapterError(errMsg) };
+      }
       case "result": {
         const tokens = extractTokens(parsed);
         return { type: "done", timestamp, data: parsed, tokens };
@@ -90,5 +95,3 @@ function parseCursorEvent(line) {
 }
 
 export { CursorAdapter };
-//# sourceMappingURL=cursor-4QIOTDBW.js.map
-//# sourceMappingURL=cursor-4QIOTDBW.js.map

package/dist/cursor-KQJTQ73D.js

@@ -0,0 +1,99 @@
+import { createStreamingEvents, extractTokens } from './chunk-S3QYSBW4.js';
+import './chunk-XDVMX2FO.js';
+import { classifyAdapterError } from './chunk-NLQAJ7TW.js';
+import './chunk-O2MSGW3V.js';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+
+var execFileAsync = promisify(execFile);
+async function findCommand() {
+  for (const cmd of ["cursor-agent", "agent"]) {
+    try {
+      const { stdout } = await execFileAsync(cmd, ["--version"]);
+      return { command: cmd, version: stdout.trim() };
+    } catch {
+    }
+  }
+  return null;
+}
+var CursorAdapter = class {
+  constructor(processManager) {
+    this.processManager = processManager;
+  }
+  kind = "cursor";
+  resolvedCommand = "cursor-agent";
+  async test() {
+    const found = await findCommand();
+    if (found) {
+      this.resolvedCommand = found.command;
+      return { ok: true, version: found.version };
+    }
+    return {
+      ok: false,
+      error: "Cursor Agent CLI not found. The headless agent CLI is required (cursor-agent or agent).",
+      errorKind: "adapter_not_found" /* ADAPTER_NOT_FOUND */
+    };
+  }
+  execute(params) {
+    const args = [
+      "-p",
+      "--output-format",
+      "stream-json",
+      "--workspace",
+      params.workspace,
+      "--yolo"
+      // bypass interactive prompts for autonomous agents
+    ];
+    if (params.config.model) {
+      args.push("--model", params.config.model);
+    }
+    const { process: proc, pid } = this.processManager.spawn(this.resolvedCommand, args, {
+      cwd: params.workspace,
+      env: { ...process.env, ...params.env },
+      signal: params.signal,
+      stdio: ["pipe", "pipe", "pipe"]
+      // stdin must be 'pipe' to send prompt
+    });
+    if (proc.stdin) {
+      proc.stdin.write(params.prompt);
+      proc.stdin.end();
+    }
+    const events = createStreamingEvents(proc, parseCursorEvent, "Cursor agent", params.signal);
+    return { pid, events };
+  }
+  async stop(pid) {
+    await this.processManager.killWithGrace(pid);
+  }
+};
+function parseCursorEvent(line) {
+  if (!line.trim()) return null;
+  try {
+    const parsed = JSON.parse(line);
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+    switch (parsed.type) {
+      case "assistant":
+        return { type: "output", timestamp, data: parsed.message ?? parsed };
+      case "tool_use":
+        return { type: "tool_call", timestamp, data: parsed };
+      case "tool_result":
+        return { type: "output", timestamp, data: parsed };
+      case "error": {
+        const errData = parsed.error ?? parsed;
+        const errMsg = typeof errData === "string" ? errData : JSON.stringify(errData);
+        return { type: "error", timestamp, data: errData, errorKind: classifyAdapterError(errMsg) };
+      }
+      case "result": {
+        const tokens = extractTokens(parsed);
+        return { type: "done", timestamp, data: parsed, tokens };
+      }
+      default:
+        return { type: "output", timestamp, data: parsed };
+    }
+  } catch {
+    return { type: "output", timestamp: (/* @__PURE__ */ new Date()).toISOString(), data: line };
+  }
+}
+
+export { CursorAdapter };
+//# sourceMappingURL=cursor-KQJTQ73D.js.map
+//# sourceMappingURL=cursor-KQJTQ73D.js.map

package/dist/cursor-KQJTQ73D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/infrastructure/adapters/cursor.ts"],"names":[],"mappings":"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","file":"cursor-KQJTQ73D.js","sourcesContent":["/**\n * Cursor Agent adapter.\n *\n * Spawns `cursor-agent` (Cursor's headless agent CLI) with `--output-format stream-json`.\n * Falls back to `agent` command if `cursor-agent` is not found.\n * Parses JSON-lines from stdout into AgentEvent stream.\n *\n * Note: This requires Cursor Agent CLI, not the regular `cursor` IDE command.\n * Install via: npm i -g @anthropic-ai/cursor-agent (when available)\n */\n\nimport type { IAgentAdapter, AdapterTestResult, ExecuteParams, AgentEvent, ExecuteHandle } from './interface.js';\nimport type { IProcessManager } from '../process/process-manager.js';\nimport { extractTokens, createStreamingEvents } from './utils.js';\nimport { classifyAdapterError, AdapterErrorKind } from '../../domain/errors.js';\nimport { execFile } from 'node:child_process';\nimport { promisify } from 'node:util';\n\nconst execFileAsync = promisify(execFile);\n\n/** Try multiple command names and return the first that works */\nasync function findCommand(): Promise<{ command: string; version: string } | null> {\n  for (const cmd of ['cursor-agent', 'agent']) {\n    try {\n      const { stdout } = await execFileAsync(cmd, ['--version']);\n      return { command: cmd, version: stdout.trim() };\n    } catch {\n      // try next\n    }\n  }\n  return null;\n}\n\nexport class CursorAdapter implements IAgentAdapter {\n  readonly kind = 'cursor';\n\n  private resolvedCommand: string = 'cursor-agent';\n\n  constructor(private readonly processManager: IProcessManager) {}\n\n  async test(): Promise<AdapterTestResult> {\n    const found = await findCommand();\n    if (found) {\n      this.resolvedCommand = found.command;\n      return { ok: true, version: found.version };\n    }\n    return {\n      ok: false,\n      error: 'Cursor Agent CLI not found. The headless agent CLI is required (cursor-agent or agent).',\n      errorKind: AdapterErrorKind.ADAPTER_NOT_FOUND,\n    };\n  }\n\n  execute(params: ExecuteParams): ExecuteHandle {\n    const args = [\n      '-p',\n      '--output-format', 'stream-json',\n      '--workspace', params.workspace,\n      '--yolo', // bypass interactive prompts for autonomous agents\n    ];\n\n    if (params.config.model) {\n      args.push('--model', params.config.model);\n    }\n\n    const { process: proc, pid } = this.processManager.spawn(this.resolvedCommand, args, {\n      cwd: params.workspace,\n      env: { ...process.env, ...params.env },\n      signal: params.signal,\n      stdio: ['pipe', 'pipe', 'pipe'], // stdin must be 'pipe' to send prompt\n    });\n\n    // Pipe prompt via stdin\n    if (proc.stdin) {\n      proc.stdin.write(params.prompt);\n      proc.stdin.end();\n    }\n\n    const events = createStreamingEvents(proc, parseCursorEvent, 'Cursor agent', params.signal);\n\n    return { pid, events };\n  }\n\n  async stop(pid: number): Promise<void> {\n    await this.processManager.killWithGrace(pid);\n  }\n}\n\nfunction parseCursorEvent(line: string): AgentEvent | null {\n  if (!line.trim()) return null;\n\n  try {\n    const parsed: Record<string, unknown> = JSON.parse(line);\n    const timestamp = new Date().toISOString();\n\n    // Cursor stream-json uses the same format as Claude stream-json\n    switch (parsed.type) {\n      case 'assistant':\n        return { type: 'output', timestamp, data: (parsed.message as unknown) ?? parsed };\n      case 'tool_use':\n        return { type: 'tool_call', timestamp, data: parsed };\n      case 'tool_result':\n        return { type: 'output', timestamp, data: parsed };\n      case 'error': {\n        const errData = (parsed.error as unknown) ?? parsed;\n        const errMsg = typeof errData === 'string' ? errData : JSON.stringify(errData);\n        return { type: 'error', timestamp, data: errData, errorKind: classifyAdapterError(errMsg) };\n      }\n      case 'result': {\n        const tokens = extractTokens(parsed);\n        return { type: 'done', timestamp, data: parsed, tokens };\n      }\n      default:\n        return { type: 'output', timestamp, data: parsed };\n    }\n  } catch {\n    return { type: 'output', timestamp: new Date().toISOString(), data: line };\n  }\n}\n"]}

package/dist/doctor-V2FPS236.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { DoctorService } from './chunk-K6DMQERQ.js';
+import { amber, getIcon, dim } from './chunk-7X2GI5OV.js';
+import { AdapterRegistry } from './chunk-45K2XID7.js';
+import { ClaudeAdapter } from './chunk-D6RFF3KN.js';
+import './chunk-W6RSVMXR.js';
+import { ShellAdapter } from './chunk-52BFUGDD.js';
+import { ProcessManager } from './chunk-CHIP7O6V.js';
+import { Paths } from './chunk-LV6GDBBI.js';
+import './chunk-2C2TFQ7K.js';
+import chalk from 'chalk';
+
+function registerDoctorCommand(program, container) {
+  program.command("doctor").description("Check adapters and dependencies").action(async () => {
+    let doctorService;
+    let paths;
+    let hasContainer = false;
+    if (container) {
+      doctorService = container.doctorService;
+      paths = container.paths;
+      hasContainer = true;
+    } else {
+      const pm = new ProcessManager();
+      const registry = new AdapterRegistry();
+      registry.register(new ClaudeAdapter(pm));
+      registry.register(new ShellAdapter(pm));
+      doctorService = new DoctorService(registry, pm, process.cwd());
+      paths = new Paths(process.cwd());
+    }
+    console.log();
+    console.log(`  ${amber("orch doctor")} \xB7 checking adapters and dependencies`);
+    console.log();
+    const report = await doctorService.runAll();
+    if (container?.context.json) {
+      console.log(JSON.stringify(report, null, 2));
+      return;
+    }
+    for (const check of report.checks) {
+      const icon = check.status === "ok" ? chalk.ansi256(72)(getIcon("done")) : check.status === "fail" ? chalk.ansi256(167)(getIcon("failed")) : dim("\u2014");
+      const detail = check.detail ? dim(` ${check.detail}`) : "";
+      console.log(`  ${icon}  ${check.name.padEnd(12)}${detail}`);
+    }
+    if (paths) {
+      const initialized = await paths.isInitialized();
+      if (initialized && hasContainer) {
+        const agents = await container.agentService.list();
+        const tasks = await container.taskService.list();
+        console.log();
+        console.log(
+          `  ${chalk.ansi256(72)(getIcon("done"))}  .orchestry/   ${dim(`exists \xB7 ${agents.length} agents \xB7 ${tasks.length} tasks`)}`
+        );
+      } else if (!initialized) {
+        console.log();
+        console.log(
+          `  ${chalk.ansi256(167)(getIcon("failed"))}  .orchestry/   ${dim("not found \u2014 run: orch init")}`
+        );
+      }
+    }
+    console.log();
+    console.log(
+      `  ${report.adaptersReady} of ${report.adaptersTotal} adapters ready`
+    );
+    console.log();
+  });
+}
+
+export { registerDoctorCommand };

package/dist/doctor-service-TPOMFAIG.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export { DoctorService } from './chunk-K6DMQERQ.js';

package/dist/goal-FMYYN2FR.js

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+import { GOAL_STATUSES } from './chunk-HXYAZGLP.js';
+import { printSuccess, dim, printTable, printKeyValue, statusIcon, agentName, printError } from './chunk-7X2GI5OV.js';
+
+// src/cli/commands/goal.ts
+var STATUS_ICON = {
+  active: "\u25CF",
+  // ●
+  paused: "\u2016",
+  // ‖
+  achieved: "\u2713",
+  // ✓
+  abandoned: "\u2715"
+  // ✕
+};
+function registerGoalCommand(program, container) {
+  const goal = program.command("goal").description("Manage goals");
+  goal.command("add <title>").description("Create a new goal").option("--description <desc>", "Goal description").option("--assignee <agentId>", "Assign to a specific agent").action(async (title, opts) => {
+    await container.paths.requireInit();
+    const g = await container.goalService.create({
+      title,
+      description: opts.description,
+      assignee: opts.assignee
+    });
+    if (container.context.json) {
+      console.log(JSON.stringify(g, null, 2));
+    } else if (container.context.quiet) {
+      console.log(g.id);
+    } else {
+      printSuccess(`Created goal "${g.title}" (${g.id})`);
+    }
+  });
+  goal.command("list").alias("ls").description("List all goals").option("--status <status>", "Filter by status").action(async (opts) => {
+    await container.paths.requireInit();
+    const goals = await container.goalService.list(
+      opts.status ? { status: opts.status } : void 0
+    );
+    if (container.context.json) {
+      console.log(JSON.stringify(goals, null, 2));
+      return;
+    }
+    if (goals.length === 0) {
+      console.log(dim("No goals found."));
+      return;
+    }
+    const rows = goals.map((g) => [
+      STATUS_ICON[g.status] ?? "?",
+      g.id,
+      g.title,
+      g.status,
+      g.assignee ?? dim("any")
+    ]);
+    printTable(["", "ID", "Title", "Status", "Assignee"], rows);
+  });
+  goal.command("show <id>").description("Show goal details").action(async (id) => {
+    await container.paths.requireInit();
+    const [g, tasks, progress] = await Promise.all([
+      container.goalService.get(id),
+      container.goalService.listTasksForGoal(id),
+      container.goalService.getProgressReport(id)
+    ]);
+    if (container.context.json) {
+      console.log(JSON.stringify({ ...g, tasks, progress }, null, 2));
+      return;
+    }
+    printKeyValue([
+      ["ID", g.id],
+      ["Title", g.title],
+      ["Status", g.status],
+      ["Assignee", g.assignee ?? dim("any")],
+      ["Description", g.description || dim("none")],
+      ["Created", g.created_at],
+      ["Updated", g.updated_at ?? dim("never")]
+    ]);
+    if (tasks.length > 0) {
+      console.log(`
+  Tasks (${tasks.length})
+  ${"\u2500".repeat(42)}`);
+      const rows = tasks.map((t) => [
+        `${statusIcon(t.status)} ${t.status}`,
+        t.id,
+        t.title.slice(0, 40),
+        t.assignee ? agentName(t.assignee) : dim("\u2014")
+      ]);
+      printTable(["STATUS", "ID", "TITLE", "AGENT"], rows);
+    } else {
+      console.log(`
+  ${dim("No tasks linked to this goal yet.")}`);
+    }
+    if (progress) {
+      console.log(`
+  Progress Report
+  ${"\u2500".repeat(42)}`);
+      for (const line of progress.split("\n")) {
+        console.log(`  ${line}`);
+      }
+    }
+    console.log();
+  });
+  goal.command("status <id> <status>").description("Change goal status (active, paused, achieved, abandoned)").action(async (id, status) => {
+    await container.paths.requireInit();
+    if (!GOAL_STATUSES.includes(status)) {
+      printError(`Invalid status "${status}". Valid: ${GOAL_STATUSES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    const g = await container.goalService.updateStatus(id, status);
+    if (container.context.json) {
+      console.log(JSON.stringify(g, null, 2));
+    } else if (container.context.quiet) {
+      console.log(g.id);
+    } else {
+      printSuccess(`Goal "${g.title}" \u2192 ${g.status}`);
+    }
+  });
+  goal.command("update <id>").description("Update goal fields").option("--title <title>", "New title").option("--description <desc>", "New description").option("--assignee <agentId>", "New assignee (empty string to unassign)").action(async (id, opts) => {
+    await container.paths.requireInit();
+    const g = await container.goalService.update(id, opts);
+    if (container.context.json) {
+      console.log(JSON.stringify(g, null, 2));
+    } else if (container.context.quiet) {
+      console.log(g.id);
+    } else {
+      printSuccess(`Updated goal "${g.title}"`);
+    }
+  });
+  goal.command("delete <id>").alias("rm").description("Delete a goal").action(async (id) => {
+    await container.paths.requireInit();
+    await container.goalService.delete(id);
+    if (container.context.json) {
+      console.log(JSON.stringify({ deleted: id }));
+    } else if (!container.context.quiet) {
+      printSuccess(`Deleted goal ${id}`);
+    }
+  });
+}
+
+export { registerGoalCommand };

package/dist/index.d.ts

@@ -86,6 +86,11 @@ interface AgentStats {
     total_runtime_ms: number;
     tokens_used?: number;
 }
+interface AgentLastError {
+    message: string;
+    kind: string;
+    timestamp: string;
+}
 interface Agent {
     id: string;
     name: string;
@@ -96,6 +101,7 @@ interface Agent {
     current_task?: string;
     autonomous?: boolean;
     stats: AgentStats;
+    last_error?: AgentLastError;
 }
 interface CreateAgentInput {
     name: string;
@@ -212,6 +218,7 @@ interface OrchestratorState {
     version: 1;
     pid?: number;
     started_at?: string;
+    onboardingCompleted?: boolean;
     running: Record<string, RunningEntry>;
     claimed: Set<string>;
     retry_queue: RetryEntry[];
@@ -228,6 +235,54 @@ interface OrchestratorState {
     };
 }
 
+/**
+ * Typed error hierarchy for the orchestrator.
+ *
+ * Every error carries an exit code (matching CLI_UI_DESIGN.md §11)
+ * and an optional hint for the user.
+ *
+ * Exit codes:
+ *   0 - Success
+ *   1 - General error
+ *   2 - Invalid arguments
+ *   3 - Not initialized (.orchestry/ not found)
+ *   4 - Lock conflict (orchestrator already running)
+ *   5 - Agent error (adapter test failed)
+ */
+declare class OrchestryError extends Error {
+    readonly exitCode: number;
+    readonly hint?: string | undefined;
+    constructor(message: string, exitCode: number, hint?: string | undefined);
+}
+declare class NotInitializedError extends OrchestryError {
+    constructor();
+}
+declare class TaskNotFoundError extends OrchestryError {
+    constructor(taskId: string);
+}
+declare class AgentNotFoundError extends OrchestryError {
+    constructor(agentId: string);
+}
+declare class WorkspaceError extends OrchestryError {
+    constructor(message: string, hint?: string);
+}
+declare enum AdapterErrorKind {
+    ADAPTER_NOT_FOUND = "adapter_not_found",
+    AUTH_FAILED = "auth_failed",
+    TIMEOUT = "timeout",
+    RATE_LIMIT = "rate_limit",
+    PROCESS_CRASH = "process_crash",
+    SPAWN_FAILED = "spawn_failed",
+    UNKNOWN = "unknown"
+}
+interface AdapterErrorHint {
+    message: string;
+    fix: string;
+    doctorHint?: boolean;
+}
+declare const ERROR_HINTS: Record<AdapterErrorKind, AdapterErrorHint>;
+declare function classifyAdapterError(error: string, exitCode?: number): AdapterErrorKind;
+
 /**
  * Goal domain model.
  *
@@ -288,14 +343,6 @@ interface CreateMessageInput {
     reply_to?: string;
 }
 
-/**
- * Orchestrator event system.
- *
- * All communication between layers goes through typed events.
- * The EventBus emits these synchronously; subscribers (TUI, logger,
- * run store, state) react independently.
- */
-
 type OrchestratorEvent = {
     type: 'task:created';
     task: Task;
@@ -338,6 +385,7 @@ type OrchestratorEvent = {
     runId: string;
     agentId: string;
     error: string;
+    errorKind?: AdapterErrorKind;
 } | {
     type: 'run:retry';
     runId: string;
@@ -439,38 +487,6 @@ type EventPayload<T extends OrchestratorEventType> = Extract<OrchestratorEvent,
     type: T;
 }>;
 
-/**
- * Typed error hierarchy for the orchestrator.
- *
- * Every error carries an exit code (matching CLI_UI_DESIGN.md §11)
- * and an optional hint for the user.
- *
- * Exit codes:
- *   0 - Success
- *   1 - General error
- *   2 - Invalid arguments
- *   3 - Not initialized (.orchestry/ not found)
- *   4 - Lock conflict (orchestrator already running)
- *   5 - Agent error (adapter test failed)
- */
-declare class OrchestryError extends Error {
-    readonly exitCode: number;
-    readonly hint?: string | undefined;
-    constructor(message: string, exitCode: number, hint?: string | undefined);
-}
-declare class NotInitializedError extends OrchestryError {
-    constructor();
-}
-declare class TaskNotFoundError extends OrchestryError {
-    constructor(taskId: string);
-}
-declare class AgentNotFoundError extends OrchestryError {
-    constructor(agentId: string);
-}
-declare class WorkspaceError extends OrchestryError {
-    constructor(message: string, hint?: string);
-}
-
 /**
  * Task state machine — pure functions, no side effects.
  *
@@ -878,6 +894,7 @@ interface AdapterTestResult {
     ok: boolean;
     version?: string;
     error?: string;
+    errorKind?: AdapterErrorKind;
     details?: Record<string, unknown>;
 }
 interface ExecuteParams {
@@ -896,6 +913,7 @@ interface AgentEvent {
         output: number;
         total: number;
     };
+    errorKind?: AdapterErrorKind;
 }
 interface ExecuteHandle {
     pid: number;
@@ -1257,8 +1275,13 @@ interface CliContext {
  */
 /** Activity feed filter preset name */
 type ActivityFilterPreset = 'all' | 'text' | 'tools' | 'errors' | 'events';
+interface NotificationPreferences {
+    toast: boolean;
+    bell: boolean;
+}
 interface TuiPreferences {
     activity_filter: ActivityFilterPreset;
+    notifications: NotificationPreferences;
 }
 interface GlobalConfig {
     tui: TuiPreferences;
@@ -1431,4 +1454,4 @@ declare function buildFullContainer(context: CliContext): Promise<Container>;
  */
 declare function buildContainer(context: CliContext): Promise<Container>;
 
-export { AdapterRegistry, type AdapterTestResult, type Agent, type AgentConfig, type AgentEvent, AgentNotFoundError, AgentService, type AgentStats, type AgentStatus, type ApprovalPolicy, type ClipboardContentType, type ClipboardImage, type Container, type CreateAgentInput, type CreateTaskInput, EventBus, type EventPayload, type ExecuteParams, type IAgentAdapter, type LightContainer, NotInitializedError, Orchestrator, type OrchestratorConfig, type OrchestratorEvent, type OrchestratorEventType, type OrchestratorState, OrchestryError, type ProjectConfig, type RetryEntry, type Run, type RunEvent, type RunEventType, RunService, type RunStatus, type RunningEntry, type SchedulingConfig, type Task, TaskNotFoundError, type TaskProof, TaskService, type TaskStatus, type TokenUsage, WorkspaceError, type WorkspaceMode, buildContainer, buildFullContainer, buildLightContainer, canTransition, createTokenUsage, detectClipboardType, getClipboardImage, isBlocked, isClipboardToolAvailable, isDispatchable, isTerminal, resolveFailureStatus };
+export { type AdapterErrorHint, AdapterErrorKind, AdapterRegistry, type AdapterTestResult, type Agent, type AgentConfig, type AgentEvent, type AgentLastError, AgentNotFoundError, AgentService, type AgentStats, type AgentStatus, type ApprovalPolicy, type ClipboardContentType, type ClipboardImage, type Container, type CreateAgentInput, type CreateTaskInput, ERROR_HINTS, EventBus, type EventPayload, type ExecuteParams, type IAgentAdapter, type LightContainer, NotInitializedError, Orchestrator, type OrchestratorConfig, type OrchestratorEvent, type OrchestratorEventType, type OrchestratorState, OrchestryError, type ProjectConfig, type RetryEntry, type Run, type RunEvent, type RunEventType, RunService, type RunStatus, type RunningEntry, type SchedulingConfig, type Task, TaskNotFoundError, type TaskProof, TaskService, type TaskStatus, type TokenUsage, WorkspaceError, type WorkspaceMode, buildContainer, buildFullContainer, buildLightContainer, canTransition, classifyAdapterError, createTokenUsage, detectClipboardType, getClipboardImage, isBlocked, isClipboardToolAvailable, isDispatchable, isTerminal, resolveFailureStatus };