@pellux/goodvibes-tui 0.18.11 → 0.18.12

package/src/runtime/shell-command-ops.ts

@@ -1,207 +0,0 @@
-import { handlePlanCommand } from '@pellux/goodvibes-sdk/platform/core/plan-command-handler';
-import type { AdaptivePlanner } from '@pellux/goodvibes-sdk/platform/core/adaptive-planner';
-import type { SubagentTask } from '@pellux/goodvibes-sdk/platform/acp/protocol';
-import { exportRemoteArtifactForAgent } from '@pellux/goodvibes-sdk/platform/runtime/remote/runner-registry';
-import type { RuntimeEventBus } from '@pellux/goodvibes-sdk/platform/runtime/events/index';
-import type { RuntimeStore } from './store/index.ts';
-import type { AgentInput } from '@pellux/goodvibes-sdk/platform/tools/agent/schema';
-import type { AgentRecord } from '@pellux/goodvibes-sdk/platform/tools/agent/manager';
-import type { AcpConnection } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/acp';
-import type { UiRemoteSnapshot } from './ui-read-models.ts';
-import type { RemoteRunnerRegistry } from '@pellux/goodvibes-sdk/platform/runtime/remote/index';
-import type {
-  RemoteExecutionArtifact,
-  RemoteRunnerContract,
-  RemoteRunnerPool,
-  RemoteSessionBundle,
-} from '@pellux/goodvibes-sdk/platform/runtime/remote/types';
-import type {
-  AutomationJob,
-  AutomationRun,
-  CreateAutomationJobInput,
-  AutomationManager,
-} from '@pellux/goodvibes-sdk/platform/automation/index';
-import type {
-  CancellationRequest,
-  CancellationResult,
-  CrossSessionTaskRef,
-  SessionTaskGraphSnapshot,
-  TaskHandoffRecord,
-} from '@pellux/goodvibes-sdk/platform/sessions/orchestration/index';
-import type { ExecutionPlan, PlanItem } from '@pellux/goodvibes-sdk/platform/core/execution-plan';
-import type { DomainVerbosity } from '@pellux/goodvibes-sdk/platform/runtime/notifications/types';
-import type { HITLMode, HITLModeDefinition } from '@pellux/goodvibes-sdk/platform/state/mode-manager';
-
-export interface ShellAgentManagerService {
-  spawn(input: AgentInput): AgentRecord;
-  cancel(agentId: string): boolean;
-  cancelGraph(graphId: string): string[];
-  cancelSubtree(rootAgentId: string): string[];
-  clear(): void;
-  exportState(): AgentRecord[];
-  importState(records: AgentRecord[]): void;
-}
-
-export interface ShellAcpManagerService {
-  spawn(task: SubagentTask): Promise<string>;
-  cancel(agentId: string): Promise<void>;
-}
-
-export interface ShellAutomationManagerService {
-  start(): Promise<void>;
-  listJobs(): AutomationJob[];
-  createJob(input: CreateAutomationJobInput): Promise<AutomationJob>;
-  removeJob(id: string): Promise<boolean>;
-  setEnabled(id: string, enabled: boolean): Promise<AutomationJob | null>;
-  runNow(id: string): Promise<AutomationRun>;
-}
-
-export type ShellAutomationManagerRuntimeService = ShellAutomationManagerService & AutomationManager;
-
-export interface ShellModeManagerService {
-  getHITLMode(): HITLMode;
-  getHITLPreset(): HITLModeDefinition;
-  listHITLPresets(): HITLModeDefinition[];
-  setHITLMode(mode: HITLMode): void;
-  setDomainVerbosity(domain: string, verbosity: DomainVerbosity): void;
-  getDomainOverrides(): Record<string, DomainVerbosity>;
-}
-
-export interface ShellPlanManagerService {
-  getActive(sessionId?: string): ExecutionPlan | null;
-  getSummary(plan: ExecutionPlan): string;
-  list(): ExecutionPlan[];
-  toMarkdown(plan: ExecutionPlan): string;
-  create(title: string, items: Omit<PlanItem, 'id' | 'status'>[], sessionId?: string): ExecutionPlan;
-  save(plan: ExecutionPlan): void;
-}
-
-export interface ShellSessionOrchestrationService {
-  linkTask(ref: CrossSessionTaskRef, dependsOn?: { sessionId: string; taskId: string }): { ok: boolean; error?: string };
-  initiateHandoff(
-    taskRef: { sessionId: string; taskId: string },
-    fromSessionId: string,
-    toSessionId: string,
-    reason?: string,
-  ): { ok: boolean; error?: string; handoffId?: string };
-  snapshot(): SessionTaskGraphSnapshot;
-  getDependencies(sessionId: string, taskId: string): CrossSessionTaskRef[];
-  getDependents(sessionId: string, taskId: string): CrossSessionTaskRef[];
-  getHandoffs(): TaskHandoffRecord[];
-  cancel(request: CancellationRequest): CancellationResult;
-}
-
-export interface RemoteCommandService {
-  listActiveConnections(): readonly AcpConnection[];
-  getSnapshot(): UiRemoteSnapshot;
-  listPools(): readonly RemoteRunnerPool[];
-  getPool(id: string): RemoteRunnerPool | null;
-  createPool(input: { id: string; label: string }): RemoteRunnerPool;
-  assignRunnerToPool(poolId: string, runnerId: string): RemoteRunnerPool | null;
-  removeRunnerFromPool(poolId: string, runnerId: string): RemoteRunnerPool | null;
-  listContracts(): readonly RemoteRunnerContract[];
-  getContract(runnerId: string): RemoteRunnerContract | null;
-  registerContract(contract: RemoteRunnerContract): RemoteRunnerContract;
-  upsertContractForAgent(runnerId: string): RemoteRunnerContract | null;
-  listArtifacts(): readonly RemoteExecutionArtifact[];
-  getArtifact(artifactId: string): RemoteExecutionArtifact | null;
-  buildReviewSummary(artifactId: string): string | null;
-  exportArtifact(artifactId: string, path?: string): Promise<{ artifact: RemoteExecutionArtifact; path: string } | null>;
-  exportArtifactForAgent(agentId: string, path?: string): Promise<{ artifact: RemoteExecutionArtifact; path: string } | null>;
-  importArtifact(path: string): Promise<RemoteExecutionArtifact>;
-  exportSessionBundle(path: string): Promise<{ bundle: RemoteSessionBundle; path: string }>;
-  importSessionBundle(path: string): Promise<RemoteSessionBundle>;
-}
-
-export type PlanRuntimeService = (subcommand: string, args: string[]) => {
-  readonly output: string;
-  readonly ok: boolean;
-};
-
-export interface CommandOpsShellServices {
-  agentManager?: ShellAgentManagerService;
-  acpManager?: ShellAcpManagerService;
-  automationManager?: ShellAutomationManagerRuntimeService;
-  modeManager?: ShellModeManagerService;
-  planManager?: ShellPlanManagerService;
-  adaptivePlanner?: unknown;
-  sessionOrchestration?: ShellSessionOrchestrationService;
-  remoteRuntime?: RemoteCommandService;
-  planRuntime?: PlanRuntimeService;
-}
-
-export interface CreateShellOpsServicesOptions extends CommandOpsShellServices {}
-
-export function createShellOpsServices(
-  options: CreateShellOpsServicesOptions,
-): CommandOpsShellServices {
-  const {
-    agentManager,
-    acpManager,
-    automationManager,
-    modeManager,
-    planManager,
-    adaptivePlanner,
-    sessionOrchestration,
-    remoteRuntime,
-    planRuntime,
-  } = options;
-
-  return {
-    agentManager,
-    acpManager,
-    automationManager,
-    modeManager,
-    planManager,
-    adaptivePlanner,
-    sessionOrchestration,
-    remoteRuntime,
-    planRuntime,
-  };
-}
-
-export function createShellRemoteCommandService(options: {
-  readonly readModels: import('./ui-read-models.ts').UiReadModels;
-  readonly remoteRunnerRegistry?: RemoteRunnerRegistry;
-  readonly runtimeStore: RuntimeStore;
-}): RemoteCommandService | undefined {
-  const { readModels, remoteRunnerRegistry, runtimeStore } = options;
-  if (!remoteRunnerRegistry) return undefined;
-  return {
-    listActiveConnections: () => readModels.remote.getSnapshot().acp.activeConnections,
-    getSnapshot: () => readModels.remote.getSnapshot(),
-    listPools: () => remoteRunnerRegistry.listPools(),
-    getPool: (id) => remoteRunnerRegistry.getPool(id),
-    createPool: (input) => remoteRunnerRegistry.createPool(input),
-    assignRunnerToPool: (poolId, runnerId) => remoteRunnerRegistry.assignRunnerToPool(poolId, runnerId),
-    removeRunnerFromPool: (poolId, runnerId) => remoteRunnerRegistry.removeRunnerFromPool(poolId, runnerId),
-    listContracts: () => remoteRunnerRegistry.listContracts(),
-    getContract: (runnerId) => remoteRunnerRegistry.getContract(runnerId),
-    registerContract: (contract) => remoteRunnerRegistry.registerContract(contract),
-    upsertContractForAgent: (runnerId) => remoteRunnerRegistry.upsertContractForAgent(runnerId, runtimeStore),
-    listArtifacts: () => remoteRunnerRegistry.listArtifacts(),
-    getArtifact: (artifactId) => remoteRunnerRegistry.getArtifact(artifactId),
-    buildReviewSummary: (artifactId) => remoteRunnerRegistry.buildReviewSummary(artifactId),
-    exportArtifact: (artifactId, path) => remoteRunnerRegistry.exportArtifact(artifactId, path),
-    exportArtifactForAgent: async (agentId, path) => (
-      await exportRemoteArtifactForAgent(remoteRunnerRegistry, agentId, runtimeStore, path)
-      ?? await (async () => {
-        const artifact = remoteRunnerRegistry.captureArtifactForRunner(agentId, runtimeStore);
-        if (!artifact) return null;
-        return remoteRunnerRegistry.exportArtifact(artifact.id, path);
-      })()
-    ),
-    importArtifact: (path) => remoteRunnerRegistry.importArtifact(path),
-    exportSessionBundle: (path) => remoteRunnerRegistry.exportSessionBundle(runtimeStore, path),
-    importSessionBundle: (path) => remoteRunnerRegistry.importSessionBundle(path),
-  };
-}
-
-export function createShellPlanRuntime(options: {
-  readonly adaptivePlanner?: AdaptivePlanner;
-  readonly runtimeBus?: RuntimeEventBus;
-}): PlanRuntimeService | undefined {
-  const { adaptivePlanner, runtimeBus } = options;
-  if (!adaptivePlanner) return undefined;
-  return (subcommand, args) => handlePlanCommand({ adaptivePlanner, runtimeBus }, subcommand, args);
-}

package/src/runtime/shell-command-platform.ts

@@ -1,47 +0,0 @@
-import type { DeterministicReplayEngine } from '@pellux/goodvibes-sdk/platform/core/deterministic-replay';
-import type { ServiceRegistry } from '../config/service-registry.ts';
-import type { SecretsManager } from '../config/secrets.ts';
-import type { SubscriptionManager } from '@pellux/goodvibes-sdk/platform/config/subscriptions';
-import type { UserAuthManager } from '@pellux/goodvibes-sdk/platform/security/user-auth';
-import type { ApiTokenAuditor } from '@pellux/goodvibes-sdk/platform/security/token-audit';
-import type { WebhookNotifier } from '@pellux/goodvibes-sdk/platform/integrations/webhooks';
-import type { UiReadModels } from './ui-read-models.ts';
-
-export interface CommandPlatformShellServices {
-  readonly readModels?: UiReadModels;
-  readonly serviceRegistry?: ServiceRegistry;
-  readonly subscriptionManager?: SubscriptionManager;
-  readonly secretsManager?: SecretsManager;
-  readonly localUserAuthManager?: UserAuthManager;
-  readonly tokenAuditor?: ApiTokenAuditor;
-  readonly replayEngine?: DeterministicReplayEngine;
-  readonly webhookNotifier?: WebhookNotifier;
-}
-
-export interface CreateShellPlatformServicesOptions extends CommandPlatformShellServices {}
-
-export function createShellPlatformServices(
-  options: CreateShellPlatformServicesOptions,
-): CommandPlatformShellServices {
-  const {
-    readModels,
-    serviceRegistry,
-    subscriptionManager,
-    secretsManager,
-    localUserAuthManager,
-    tokenAuditor,
-    replayEngine,
-    webhookNotifier,
-  } = options;
-
-  return {
-    readModels,
-    serviceRegistry,
-    subscriptionManager,
-    secretsManager,
-    localUserAuthManager,
-    tokenAuditor,
-    replayEngine,
-    webhookNotifier,
-  };
-}

package/src/runtime/shell-command-services.ts

@@ -1,143 +0,0 @@
-import type { AdaptivePlanner } from '@pellux/goodvibes-sdk/platform/core/adaptive-planner';
-import type { ForensicsRegistry } from '@pellux/goodvibes-sdk/platform/runtime/forensics/index';
-import type { IntegrationHelperService } from '@pellux/goodvibes-sdk/platform/runtime/integration/helpers';
-import type { HookWorkbench } from '@pellux/goodvibes-sdk/platform/hooks/workbench';
-import type { KnowledgeService } from '@pellux/goodvibes-sdk/platform/knowledge/index';
-import type { PluginManager } from '@pellux/goodvibes-sdk/platform/plugins/manager';
-import type { PolicyRuntimeState } from '@pellux/goodvibes-sdk/platform/runtime/permissions/policy-runtime';
-import type { PanelHealthMonitor } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-health-monitor';
-import type { ShellPathService } from '@pellux/goodvibes-sdk/platform/runtime/shell-paths';
-import type { WorktreeRegistry } from '@pellux/goodvibes-sdk/platform/runtime/worktree/registry';
-import type { SandboxSessionRegistry } from '@pellux/goodvibes-sdk/platform/runtime/sandbox/session-registry';
-import { createShellExtensionServices, type CommandExtensionShellServices } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-extensions';
-import { createShellOpsServices, createShellPlanRuntime, createShellRemoteCommandService, type CommandOpsShellServices, type PlanRuntimeService, type RemoteCommandService } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-ops';
-import { createShellPlatformServices, type CommandPlatformShellServices } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-platform';
-import { createShellWorkspaceServices, type CommandWorkspaceShellServices } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-workspace';
-
-export type { CommandWorkspaceShellServices } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-workspace';
-export type { CommandPlatformShellServices } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-platform';
-export type {
-  ShellAgentManagerService,
-  ShellAcpManagerService,
-  ShellAutomationManagerService,
-  ShellAutomationManagerRuntimeService,
-  ShellModeManagerService,
-  ShellPlanManagerService,
-  ShellSessionOrchestrationService,
-} from '@pellux/goodvibes-sdk/platform/runtime/shell-command-ops';
-export type { CommandOpsShellServices, PlanRuntimeService, RemoteCommandService } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-ops';
-export type { CommandExtensionShellServices } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-extensions';
-
-export interface BootstrapCommandShellServices {
-  readonly workspace: CommandWorkspaceShellServices;
-  readonly platform: CommandPlatformShellServices;
-  readonly ops: CommandOpsShellServices;
-  readonly extensions: CommandExtensionShellServices;
-}
-
-export interface CreateBootstrapCommandShellServicesOptions {
-  readonly agentManager?: import('./shell-command-ops.ts').ShellAgentManagerService;
-  readonly acpManager?: import('./shell-command-ops.ts').ShellAcpManagerService;
-  readonly automationManager?: import('./shell-command-ops.ts').ShellAutomationManagerRuntimeService;
-  readonly modeManager?: import('./shell-command-ops.ts').ShellModeManagerService;
-  readonly planManager?: import('./shell-command-ops.ts').ShellPlanManagerService;
-  readonly adaptivePlanner?: AdaptivePlanner;
-  readonly sessionOrchestration?: import('./shell-command-ops.ts').ShellSessionOrchestrationService;
-  readonly shellPaths: ShellPathService;
-  readonly panelHealthMonitor: PanelHealthMonitor;
-  readonly worktreeRegistry: WorktreeRegistry;
-  readonly sandboxSessionRegistry: SandboxSessionRegistry;
-  readonly readModels: import('./ui-read-models.ts').UiReadModels;
-  readonly serviceRegistry?: import('../config/service-registry.ts').ServiceRegistry;
-  readonly subscriptionManager?: import('@pellux/goodvibes-sdk/platform/config/subscriptions').SubscriptionManager;
-  readonly secretsManager?: import('../config/secrets.ts').SecretsManager;
-  readonly localUserAuthManager?: import('@pellux/goodvibes-sdk/platform/security/user-auth').UserAuthManager;
-  readonly tokenAuditor?: import('@pellux/goodvibes-sdk/platform/security/token-audit').ApiTokenAuditor;
-  readonly replayEngine?: import('@pellux/goodvibes-sdk/platform/core/deterministic-replay').DeterministicReplayEngine;
-  readonly webhookNotifier?: import('../integrations/webhooks.ts').WebhookNotifier;
-  readonly remoteRuntime?: RemoteCommandService;
-  readonly planRuntime?: PlanRuntimeService;
-  readonly forensicsRegistry: ForensicsRegistry;
-  readonly policyRuntimeState: PolicyRuntimeState;
-  readonly memoryRegistry?: import('../state/memory-store.ts').MemoryRegistry;
-  readonly integrationHelpers?: IntegrationHelperService;
-  readonly knowledgeService?: KnowledgeService;
-  readonly pluginManager?: PluginManager;
-  readonly hookWorkbench?: HookWorkbench;
-}
-
-export function createBootstrapCommandShellServices(
-  options: CreateBootstrapCommandShellServicesOptions,
-): BootstrapCommandShellServices {
-  const {
-    agentManager,
-    acpManager,
-    automationManager,
-    modeManager,
-    planManager,
-    adaptivePlanner,
-    sessionOrchestration,
-    shellPaths,
-    panelHealthMonitor,
-    worktreeRegistry,
-    sandboxSessionRegistry,
-    readModels,
-    serviceRegistry,
-    subscriptionManager,
-    secretsManager,
-    localUserAuthManager,
-    tokenAuditor,
-    replayEngine,
-    webhookNotifier,
-    remoteRuntime,
-    planRuntime,
-    forensicsRegistry,
-    policyRuntimeState,
-    memoryRegistry,
-    integrationHelpers,
-    knowledgeService,
-    pluginManager,
-    hookWorkbench,
-  } = options;
-
-  return {
-    workspace: createShellWorkspaceServices({
-      shellPaths,
-      panelHealthMonitor,
-      worktreeRegistry,
-      sandboxSessionRegistry,
-    }),
-    platform: createShellPlatformServices({
-      readModels,
-      serviceRegistry,
-      subscriptionManager,
-      secretsManager,
-      localUserAuthManager,
-      tokenAuditor,
-      replayEngine,
-      webhookNotifier,
-    }),
-    ops: createShellOpsServices({
-      agentManager,
-      acpManager,
-      automationManager,
-      modeManager,
-      planManager,
-      adaptivePlanner,
-      sessionOrchestration,
-      remoteRuntime,
-      planRuntime,
-    }),
-    extensions: createShellExtensionServices({
-      forensicsRegistry,
-      policyRuntimeState,
-      memoryRegistry,
-      integrationHelpers,
-      knowledgeService,
-      pluginManager,
-      hookWorkbench,
-    }),
-  };
-}
-
-export { createShellRemoteCommandService, createShellPlanRuntime } from '@pellux/goodvibes-sdk/platform/runtime/shell-command-ops';

package/src/runtime/shell-command-workspace.ts

@@ -1,31 +0,0 @@
-import type { PanelHealthMonitor } from '@pellux/goodvibes-sdk/platform/runtime/perf/panel-health-monitor';
-import type { SandboxSessionRegistry } from '@pellux/goodvibes-sdk/platform/runtime/sandbox/session-registry';
-import type { ShellPathService } from '@pellux/goodvibes-sdk/platform/runtime/shell-paths';
-import type { WorktreeRegistry } from '@pellux/goodvibes-sdk/platform/runtime/worktree/registry';
-
-export interface CommandWorkspaceShellServices {
-  readonly shellPaths?: ShellPathService;
-  readonly panelHealthMonitor?: PanelHealthMonitor;
-  readonly worktreeRegistry?: WorktreeRegistry;
-  readonly sandboxSessionRegistry?: SandboxSessionRegistry;
-}
-
-export interface CreateShellWorkspaceServicesOptions extends CommandWorkspaceShellServices {}
-
-export function createShellWorkspaceServices(
-  options: CreateShellWorkspaceServicesOptions,
-): CommandWorkspaceShellServices {
-  const {
-    shellPaths,
-    panelHealthMonitor,
-    worktreeRegistry,
-    sandboxSessionRegistry,
-  } = options;
-
-  return {
-    shellPaths,
-    panelHealthMonitor,
-    worktreeRegistry,
-    sandboxSessionRegistry,
-  };
-}

package/src/runtime/tasks/adapters/acp-adapter.ts

@@ -1,211 +0,0 @@
-/**
- * AcpTaskAdapter — bridges ACP remote subagent tasks (managed by AcpManager)
- * into the unified RuntimeTask registry.
- *
- * Each spawned ACP subagent gets a corresponding RuntimeTask of kind 'acp'.
- * The adapter maps SubagentStatus strings to task lifecycle transitions.
- */
-
-import { randomUUID } from 'node:crypto';
-import { createDomainDispatch } from '../../store/index.ts';
-import type { RuntimeStore, DomainDispatch } from '../../store/index.ts';
-import type { RuntimeTask } from '@pellux/goodvibes-sdk/platform/runtime/store/domains/tasks';
-import type { SubagentStatus } from '@pellux/goodvibes-sdk/platform/acp/protocol';
-import type { AcpManager } from '@pellux/goodvibes-sdk/platform/acp/manager';
-
-/**
- * Maps an ACP SubagentStatus to a RuntimeTask lifecycle state.
- *
- * @param status - SubagentStatus from the ACP protocol.
- * @returns Corresponding task lifecycle state.
- */
-function mapAcpStatusToTask(
-  status: SubagentStatus,
-): 'running' | 'completed' | 'failed' | 'cancelled' {
-  switch (status) {
-    case 'running':
-      return 'running';
-    case 'complete':
-      return 'completed';
-    case 'error':
-      return 'failed';
-    case 'cancelled':
-      return 'cancelled';
-  }
-}
-
-/** Terminal ACP statuses. */
-const TERMINAL_ACP_STATUSES: ReadonlySet<SubagentStatus> = new Set([
-  'complete',
-  'error',
-  'cancelled',
-]);
-
-/**
- * Bridges ACP remote subagent tasks into the RuntimeTask registry.
- *
- * NOTE: This adapter writes directly to the Zustand store for performance,
- * bypassing TaskManager. Lifecycle validation is the caller's responsibility.
- * This is intentional — adapters are authoritative sources for their subsystem.
- *
- * @example
- * ```ts
- * const adapter = new AcpTaskAdapter(store);
- * const taskId = adapter.wrapRemoteTask(acpId, 'Refactor auth module');
- * adapter.handleRemoteUpdate(acpId, 'complete');
- * ```
- */
-export class AcpTaskAdapter {
-  /** Maps ACP remote ID → task ID. */
-  private readonly _remoteToTask = new Map<string, string>();
-  /** Maps task ID → ACP remote ID. */
-  private readonly _taskToRemote = new Map<string, string>();
-
-  private readonly _dispatch: DomainDispatch;
-
-  constructor(private readonly _store: RuntimeStore) {
-    this._dispatch = createDomainDispatch(_store);
-  }
-
-  // ── Core API ────────────────────────────────────────────────────────────────
-
-  /**
-   * Wrap an ACP remote subagent task as a RuntimeTask.
-   *
-   * @param remoteId - The ACP subagent ID from AcpManager.spawn().
-   * @param title - Human-readable title for display in the task monitor.
-   * @returns The new task ID.
-   */
-  wrapRemoteTask(remoteId: string, title: string): string {
-    // Idempotent: return existing task ID if already wrapped
-    const existing = this._remoteToTask.get(remoteId);
-    if (existing !== undefined) return existing;
-
-    const taskId = randomUUID();
-    const now = Date.now();
-
-    const task: RuntimeTask = {
-      id: taskId,
-      kind: 'acp',
-      title: title.length > 80 ? `${title.slice(0, 77)}...` : title,
-      description: title,
-      status: 'running',
-      owner: remoteId,
-      cancellable: true,
-      childTaskIds: [],
-      queuedAt: now,
-      startedAt: now,
-      correlationId: remoteId,
-    };
-
-    this._remoteToTask.set(remoteId, taskId);
-    this._taskToRemote.set(taskId, remoteId);
-
-    this._upsertTask(task);
-    return taskId;
-  }
-
-  /**
-   * Handle an ACP status update and transition the task accordingly.
-   *
-   * @param remoteId - The ACP subagent ID.
-   * @param status - New status string (SubagentStatus).
-   */
-  handleRemoteUpdate(remoteId: string, status: SubagentStatus): void {
-    const taskId = this._remoteToTask.get(remoteId);
-    if (taskId === undefined) return;
-
-    const acpStatus = status;
-    const taskStatus = mapAcpStatusToTask(acpStatus);
-    const isTerminal = TERMINAL_ACP_STATUSES.has(acpStatus);
-
-    this._transitionTask(taskId, taskStatus, {
-      isTerminal,
-      error: acpStatus === 'error' ? `ACP subagent ${remoteId} reported an error` : undefined,
-    });
-
-    if (isTerminal) {
-      this._remoteToTask.delete(remoteId);
-      this._taskToRemote.delete(taskId);
-    }
-  }
-
-  /**
-   * Cancel an ACP remote task by task ID.
-   * Cancels the underlying ACP connection via AcpManager and marks the task cancelled.
-   *
-   * @param taskId - The RuntimeTask ID to cancel.
-   * @param manager - The AcpManager instance to use for cancellation.
-   */
-  cancelRemote(taskId: string, manager?: AcpManager): void {
-    const remoteId = this._taskToRemote.get(taskId);
-    if (remoteId === undefined) return;
-
-    if (manager) {
-      // Fire-and-forget cancellation; errors are non-fatal
-      void manager.cancel(remoteId).catch(() => {
-        // Non-fatal: process may have already exited
-      });
-    }
-
-    this._transitionTask(taskId, 'cancelled', { isTerminal: true });
-    this._remoteToTask.delete(remoteId);
-    this._taskToRemote.delete(taskId);
-  }
-
-  /**
-   * Reconcile adapter state with the current AcpManager snapshot.
-   *
-   * @param manager - The AcpManager whose active subagents to sync from.
-   */
-  sync(manager: AcpManager): void {
-    const active = manager.getActive();
-    const liveIds = new Set(active.map((a) => a.id));
-
-    // Wrap newly discovered subagents
-    for (const subagent of active) {
-      if (!this._remoteToTask.has(subagent.id)) {
-        this.wrapRemoteTask(subagent.id, subagent.task);
-      }
-
-      // Sync status if non-running
-      if (subagent.status !== 'running') {
-        this.handleRemoteUpdate(subagent.id, subagent.status);
-      }
-    }
-
-    // Mark stale tracked subagents as cancelled
-    const staleRemoteIds: string[] = [];
-    for (const [remoteId] of this._remoteToTask.entries()) {
-      if (!liveIds.has(remoteId)) staleRemoteIds.push(remoteId);
-    }
-    for (const remoteId of staleRemoteIds) {
-      const taskId = this._remoteToTask.get(remoteId)!;
-      this._transitionTask(taskId, 'cancelled', { isTerminal: true });
-      this._remoteToTask.delete(remoteId);
-      this._taskToRemote.delete(taskId);
-    }
-  }
-
-  // ── Private helpers ─────────────────────────────────────────────────────────
-
-  private _upsertTask(task: RuntimeTask): void {
-    this._dispatch.syncRuntimeTask(task, 'acp-adapter');
-  }
-
-  private _transitionTask(
-    taskId: string,
-    status: 'running' | 'completed' | 'failed' | 'cancelled',
-    opts: { isTerminal?: boolean; error?: string },
-  ): void {
-    this._dispatch.transitionRuntimeTask(
-      taskId,
-      status,
-      {
-        endedAt: opts.isTerminal ? Date.now() : undefined,
-        error: opts.error,
-      },
-      'acp-adapter',
-    );
-  }
-}