@osolmaz/pi-workflows 0.16.2 → 0.16.3

package/src/{host/runner.ts → server/server.ts}

@@ -34,28 +34,31 @@ import {
   type WorkflowTurnReport,
   type WorkflowTurnReportReceipt,
 } from "../client/view.js";
-import { applyStatusPatch } from "../controllers/conditions.js";
-import { ResourceConflictError } from "../controllers/errors.js";
+import { applyStatusPatch } from "../resource-managers/conditions.js";
+import { ManagedResourceConflictError } from "../resource-managers/errors.js";
 import {
-  controllerFileStem,
-  controllerSearchDirs,
-  discoverControllers,
-} from "../controllers/loader.js";
-import { SqliteControllerStore, type WorkflowRunQueueRecord } from "../controllers/sqlite.js";
+  resourceManagerFileStem,
+  resourceManagerSearchDirs,
+  discoverResourceManagers,
+} from "../resource-managers/loader.js";
+import {
+  SqliteResourceManagerStore,
+  type WorkflowRunQueueRecord,
+} from "../resource-managers/sqlite.js";
 import type {
-  ControllerQueueClaim,
-  ControllerResource,
-  ControllerSettingsChangeRequest,
-  ControllerSettingsChangeResult,
+  ResourceManagerQueueClaim,
+  ManagedResource,
+  ResourceManagerSettingsChangeRequest,
+  ResourceManagerSettingsChangeResult,
   ReconcileResult,
-} from "../controllers/types.js";
+} from "../resource-managers/types.js";
 import {
-  ControllerWorkflowCoordinator,
-  type ControllerWorkflowControlRequest,
-  type ControllerWorkflowScheduler,
+  ResourceManagerWorkflowCoordinator,
+  type ResourceManagerWorkflowControlRequest,
+  type ResourceManagerWorkflowScheduler,
   type WorkflowSchedulerRequest,
   type WorkflowSchedulerResult,
-} from "../controllers/workflows.js";
+} from "../resource-managers/workflows.js";
 import { StateDatabase, workflowStatePath } from "../state/database.js";
 import { canonicalJson, type JsonValue } from "../state/json.js";
 import { resourceIdFor } from "../state/mutation.js";
@@ -99,55 +102,60 @@ import {
   type ChannelEffectRecord,
 } from "./channel-effects.js";
 import { ChannelAdapterSupervisor } from "./channel-supervisor.js";
-import type {
-  ControllerWorkerLaunchEnvelope,
-  ControllerWorkerMessage,
-  ControllerWorkerResponse,
-} from "./controller-worker-protocol.js";
-import { ControllerWorkerSupervisor } from "./controller-worker-supervisor.js";
 import {
-  HostProcessRegistry,
+  ServerProcessRegistry,
   matchesProcessIdentity,
   processParentPid,
   processStartIdentity,
 } from "./processes.js";
+import type {
+  ResourceRunnerLaunchEnvelope,
+  ResourceRunnerMessage,
+  ResourceRunnerResponse,
+} from "./resource-runner-protocol.js";
+import { ResourceRunnerSupervisor } from "./resource-runner-supervisor.js";
 import {
-  HostStateStore,
-  type HostClaim,
+  ServerStateStore,
+  type ServerClaim,
   type InteractiveRequestRecord,
   type InteractiveSubmissionRecord,
-  type WorkerLaunchEnvelope,
+  type WorkflowRunnerLaunchEnvelope,
 } from "./state.js";
-import { HostViewStore, WORKFLOW_PAGE_KINDS, type WorkflowPageKind } from "./view.js";
-import type { WorkerMessage, WorkerResponse, WorkerRunCommand } from "./worker-protocol.js";
-import { WorkflowWorkerSupervisor } from "./worker-supervisor.js";
-
-const HOST_LEASE_MS = 30_000;
-const HOST_RENEW_MS = 10_000;
+import { ServerViewStore, WORKFLOW_PAGE_KINDS, type WorkflowPageKind } from "./view.js";
+import { boundRunnerResponse, readRunnerContentChunk } from "./workflow-runner-content.js";
+import type {
+  WorkflowRunnerMessage,
+  WorkflowRunnerResponse,
+  WorkflowRunnerCommand,
+} from "./workflow-runner-protocol.js";
+import { WorkflowRunnerSupervisor } from "./workflow-runner-supervisor.js";
+
+const SERVER_LEASE_MS = 30_000;
+const SERVER_RENEW_MS = 10_000;
 const PACKAGE_VERSION = runtimePackageVersion();
 const CLAIM_POLL_MS = 2_000;
 const TERMINAL_MESSAGE_RECONCILE_MS = 1_000;
 const RUN_CLAIM_LEASE_MS = 30_000;
-const CONTROLLER_CLAIM_LEASE_MS = 120_000;
-const CONTROLLER_RENEW_MS = 30_000;
-const MAX_CONTROLLER_WORKERS = 4;
-const DEFAULT_CONTROLLER_TIMEOUT_MS = 60_000;
+const RESOURCE_MANAGER_CLAIM_LEASE_MS = 120_000;
+const RESOURCE_MANAGER_RENEW_MS = 30_000;
+const MAX_RESOURCE_RUNNERS = 4;
+const DEFAULT_RESOURCE_MANAGER_TIMEOUT_MS = 60_000;
 
-export type WorkflowHostOptions = {
-  /** Retained for callers; the host itself is global to the state database. */
+export type WorkflowServerOptions = {
+  /** Retained for callers; the server itself is global to the state database. */
   cwd?: string;
   runnerId?: string;
   databasePath?: string;
-  registry?: HostProcessRegistry;
+  registry?: ServerProcessRegistry;
   piArgs?: string[];
   env?: Record<string, string>;
   claimPollMs?: number;
-  hostLeaseMs?: number;
-  hostRenewMs?: number;
+  serverLeaseMs?: number;
+  serverRenewMs?: number;
   runClaimLeaseMs?: number;
-  workerEntryPath?: string;
-  workerStartupTimeoutMs?: number;
-  controllerWorkerEntryPath?: string;
+  runnerEntryPath?: string;
+  runnerStartupTimeoutMs?: number;
+  resourceRunnerEntryPath?: string;
   channelAdapterEntryPath?: string;
   onLog?: (message: string) => void;
 };
@@ -156,13 +164,14 @@ type ActiveRun = {
   record: WorkflowRunQueueRecord;
   claimToken: string;
   generation: number;
-  supervisor: WorkflowWorkerSupervisor;
+  supervisor: WorkflowRunnerSupervisor;
   launchProgressRevision: number;
-  workerPid?: number;
+  runnerPid?: number;
   exiting: boolean;
   workflowLoadFailure?: string;
   control?: "cancel" | "pause" | "handoff";
   claimLost?: boolean;
+  contentDigests: Set<string>;
 };
 
 type ClientSubscription = {
@@ -199,38 +208,38 @@ type ActiveChannel = {
   stopping: boolean;
 };
 
-type ActiveController = {
+type ActiveResourceManager = {
   key: string;
   projectPath: string;
-  store: SqliteControllerStore;
-  claim: ControllerQueueClaim;
-  resource: ControllerResource;
+  store: SqliteResourceManagerStore;
+  claim: ResourceManagerQueueClaim;
+  resource: ManagedResource;
   reconcileId: string;
   startedAt: number;
-  supervisor: ControllerWorkerSupervisor;
+  supervisor: ResourceRunnerSupervisor;
   renewTimer: ReturnType<typeof setInterval>;
   settled: boolean;
 };
 
-/** Global package-owned host. It writes state and supervises code-only workers. */
-export class WorkflowHost {
-  private readonly options: WorkflowHostOptions;
-  private readonly hostId: string;
+/** Global package-owned server. It writes state and supervises code-only runners. */
+export class WorkflowServer {
+  private readonly options: WorkflowServerOptions;
+  private readonly serverId: string;
   private readonly databasePath: string;
   private readonly stateDirectory: string;
   private readonly socketPath: string;
   private readonly lockPath: string;
   private readonly state: StateDatabase;
-  private readonly hostState: HostStateStore;
-  private readonly queue: SqliteControllerStore;
+  private readonly serverState: ServerStateStore;
+  private readonly queue: SqliteResourceManagerStore;
   private readonly decisions: HumanDecisionStore;
   private readonly channelEffects: ChannelEffectStore;
   private readonly runStore: WorkflowRunStore;
-  private readonly views: HostViewStore;
-  private readonly registry: HostProcessRegistry;
+  private readonly views: ServerViewStore;
+  private readonly registry: ServerProcessRegistry;
   private readonly activeRuns = new Map<string, ActiveRun>();
-  private readonly workerDescendants = new Map<string, Set<number>>();
-  private readonly activeControllers = new Map<string, ActiveController>();
+  private readonly runnerDescendants = new Map<string, Set<number>>();
+  private readonly activeResourceManagers = new Map<string, ActiveResourceManager>();
   private readonly activeChannels = new Map<string, ActiveChannel>();
   private readonly controlClaims = new Map<string, string>();
   private readonly activationTasks = new Map<string, Promise<void>>();
@@ -244,29 +253,32 @@ export class WorkflowHost {
   private readonly sockets = new Set<Socket>();
   private readonly connections = new Map<Socket, ClientConnection>();
   private server: net.Server | null = null;
-  private claim: HostClaim | null = null;
+  private claim: ServerClaim | null = null;
   private heartbeatTimer: ReturnType<typeof setInterval> | null = null;
   private pollTimer: ReturnType<typeof setInterval> | null = null;
   private viewTimer: ReturnType<typeof setInterval> | null = null;
   private stopping = false;
   private started = false;
-  private controllerPollActive = false;
+  private resourceManagerPollActive = false;
   private decisionTimeoutActive = false;
   private decisionChannelConfig: DecisionChannelConfig | null = null;
   private decisionChannelError: string | null = null;
   private channelReloading = false;
   private nextTerminalMessageReconciliationAt = 0;
 
-  constructor(options: WorkflowHostOptions = {}) {
+  constructor(options: WorkflowServerOptions = {}) {
     this.options = options;
-    this.hostId = options.runnerId ?? `host-${randomUUID()}`;
+    this.serverId = options.runnerId ?? `host-${randomUUID()}`;
     this.databasePath = path.resolve(options.databasePath ?? workflowStatePath());
     this.stateDirectory = path.join(path.dirname(this.databasePath), "host");
     this.socketPath = clientSocketPath(this.databasePath);
     this.lockPath = path.join(this.stateDirectory, "host.lock.json");
     this.state = new StateDatabase({ filePath: this.databasePath });
-    this.hostState = new HostStateStore(this.databasePath, { state: this.state });
-    this.queue = new SqliteControllerStore(this.databasePath, { state: this.state, global: true });
+    this.serverState = new ServerStateStore(this.databasePath, { state: this.state });
+    this.queue = new SqliteResourceManagerStore(this.databasePath, {
+      state: this.state,
+      global: true,
+    });
     this.decisions = new HumanDecisionStore(this.databasePath, {
       state: this.state,
       authorityProvider: (runId) => {
@@ -282,12 +294,12 @@ export class WorkflowHost {
         return token === undefined ? undefined : this.queue.workflowRunAuthority(runId, token);
       },
       snapshotLifecycle: (context) => this.applyLifecycleProjection(context),
-      allowHostSessionRecording: true,
+      allowServerSessionRecording: true,
     });
-    this.views = new HostViewStore(
+    this.views = new ServerViewStore(
       this.state,
       this.queue,
-      this.hostState,
+      this.serverState,
       this.runStore,
       (runId) => this.activeRuns.has(runId),
       (targetSessionId) => {
@@ -295,7 +307,7 @@ export class WorkflowHost {
         return coordinator?.branchReported === true && coordinator.modelTurnActive;
       },
     );
-    this.registry = options.registry ?? new HostProcessRegistry(this.stateDirectory);
+    this.registry = options.registry ?? new ServerProcessRegistry(this.stateDirectory);
   }
 
   get endpoint(): string {
@@ -312,23 +324,23 @@ export class WorkflowHost {
     fs.chmodSync(this.stateDirectory, 0o700);
     const startIdentity = processStartIdentity(process.pid);
     if (startIdentity === undefined) {
-      throw new Error("Cannot attest the workflow host process start identity");
+      throw new Error("Cannot attest the workflow server process start identity");
     }
-    acquireHostLock(this.lockPath, { pid: process.pid, startIdentity, hostId: this.hostId });
+    acquireServerLock(this.lockPath, { pid: process.pid, startIdentity, serverId: this.serverId });
     try {
       const reaped = this.registry.reapOrphans();
       if (reaped.length > 0) this.log(`reaped ${reaped.length} exact orphan process(es)`);
-      const previousHost = this.hostState.hostStatus();
-      this.claim = this.hostState.acquireHost({
-        hostId: this.hostId,
+      const previousServer = this.serverState.serverStatus();
+      this.claim = this.serverState.acquireServer({
+        serverId: this.serverId,
         pid: process.pid,
         processStartIdentity: startIdentity,
-        leaseMs: this.options.hostLeaseMs ?? HOST_LEASE_MS,
+        leaseMs: this.options.serverLeaseMs ?? SERVER_LEASE_MS,
       });
-      this.recoverPreviousHost(previousHost.hostId, this.claim.epoch);
+      this.recoverPreviousServer(previousServer.serverId, this.claim.epoch);
       const previousHeartbeatAt =
-        previousHost.heartbeatAt === null ? undefined : Date.parse(previousHost.heartbeatAt);
-      this.hostState.recoverInactiveModelTurns(previousHeartbeatAt);
+        previousServer.heartbeatAt === null ? undefined : Date.parse(previousServer.heartbeatAt);
+      this.serverState.recoverInactiveModelTurns(previousHeartbeatAt);
       this.discoverMissingTerminalWorkflowMessages();
       this.reconcilePendingTerminalWorkflowMessages(Date.now(), true);
       await this.listen();
@@ -338,7 +350,7 @@ export class WorkflowHost {
       this.expireTimedOutInteraction();
       void this.expireTimedOutDecision();
       void this.claimOne();
-      void this.claimControllerOne();
+      void this.claimResourceManagerOne();
       void this.reloadDecisionChannels().catch((error) => {
         this.log(`decision channel startup failed: ${errorMessage(error)}`);
       });
@@ -348,7 +360,7 @@ export class WorkflowHost {
       await this.closeServer(server);
       if (this.claim !== null) {
         try {
-          this.hostState.releaseHost(this.claim);
+          this.serverState.releaseServer(this.claim);
         } catch {
           // Preserve the startup error when cleanup cannot release an already-lost claim.
         }
@@ -386,13 +398,13 @@ export class WorkflowHost {
       }),
     );
     await Promise.allSettled(
-      [...this.activeControllers.values()].map(async (active) => {
+      [...this.activeResourceManagers.values()].map(async (active) => {
         clearInterval(active.renewTimer);
         await active.supervisor.stop("orphaned");
         if (!active.settled) {
           active.store.requeueClaim(
             active.claim,
-            { availableAt: new Date().toISOString(), error: "Workflow host stopped" },
+            { availableAt: new Date().toISOString(), error: "Workflow server stopped" },
             new Date().toISOString(),
           );
         }
@@ -408,13 +420,13 @@ export class WorkflowHost {
     await Promise.allSettled(this.activationTasks.values());
     await Promise.allSettled(this.maintenanceCommands.values());
     this.registry.killAll();
-    if (this.claim !== null) this.hostState.releaseHost(this.claim);
+    if (this.claim !== null) this.serverState.releaseServer(this.claim);
     this.claim = null;
     if (process.platform !== "win32") fs.rmSync(this.socketPath, { force: true });
     this.releaseLock();
     this.runStore.close();
     this.queue.close();
-    this.hostState.close();
+    this.serverState.close();
     this.state.close();
     this.started = false;
   }
@@ -436,8 +448,8 @@ export class WorkflowHost {
     this.sockets.clear();
   }
 
-  private recoverPreviousHost(previousHostId: string | null, hostEpoch: number): void {
-    if (previousHostId === null || previousHostId === this.hostId) return;
+  private recoverPreviousServer(previousServerId: string | null, serverEpoch: number): void {
+    if (previousServerId === null || previousServerId === this.serverId) return;
     const now = Date.now();
     this.state.transaction(() => {
       this.state.connection
@@ -445,13 +457,13 @@ export class WorkflowHost {
           `UPDATE leases SET expires_at = ?
            WHERE owner_id = ? AND owner_type IN ('host', 'controller') AND expires_at > ?`,
         )
-        .run(now, previousHostId, now);
+        .run(now, previousServerId, now);
       this.state.connection
         .prepare(
           `UPDATE run_workers SET status = 'orphaned', finished_at = ?
            WHERE host_epoch < ? AND status IN ('starting', 'ready', 'running')`,
         )
-        .run(now, hostEpoch);
+        .run(now, serverEpoch);
     });
   }
 
@@ -459,9 +471,9 @@ export class WorkflowHost {
     this.heartbeatTimer = setInterval(() => {
       try {
         if (this.claim === null) return;
-        this.claim = this.hostState.renewHost(
+        this.claim = this.serverState.renewServer(
           this.claim,
-          this.options.hostLeaseMs ?? HOST_LEASE_MS,
+          this.options.serverLeaseMs ?? SERVER_LEASE_MS,
         );
         for (const active of this.activeRuns.values()) {
           if (active.control !== undefined || active.exiting) continue;
@@ -477,16 +489,16 @@ export class WorkflowHost {
           }
         }
       } catch (error) {
-        this.log(`host claim lost: ${errorMessage(error)}`);
+        this.log(`server claim lost: ${errorMessage(error)}`);
         void this.stop();
       }
-    }, this.options.hostRenewMs ?? HOST_RENEW_MS);
+    }, this.options.serverRenewMs ?? SERVER_RENEW_MS);
     this.heartbeatTimer.unref?.();
     this.pollTimer = setInterval(() => {
       this.expireTimedOutInteraction();
       void this.expireTimedOutDecision();
       void this.claimOne();
-      void this.claimControllerOne();
+      void this.claimResourceManagerOne();
       this.reconcilePendingTerminalWorkflowMessages();
     }, this.options.claimPollMs ?? CLAIM_POLL_MS);
     this.pollTimer.unref?.();
@@ -580,7 +592,7 @@ export class WorkflowHost {
     let changed = false;
     for (const [sessionId, coordinator] of this.sessionCoordinators) {
       if (connectionId !== undefined && coordinator.connectionId !== connectionId) continue;
-      this.hostState.markSessionModelTurnsInactive(sessionId);
+      this.serverState.markSessionModelTurnsInactive(sessionId);
       this.sessionCoordinators.delete(sessionId);
       changed = true;
     }
@@ -646,7 +658,7 @@ export class WorkflowHost {
           if (payload.coordinator === true) {
             const previous = this.sessionCoordinators.get(sessionId);
             if (previous !== undefined && previous.connectionId !== connection.id) {
-              this.hostState.markSessionModelTurnsInactive(sessionId);
+              this.serverState.markSessionModelTurnsInactive(sessionId);
             }
             const coordinator = {
               connectionId: connection.id,
@@ -758,11 +770,16 @@ export class WorkflowHost {
               payload.backupPath === undefined
                 ? undefined
                 : requireAbsolutePath(payload.backupPath, "backupPath");
-            const report = await pruneState(this.state, this.databasePath, {
-              before,
-              apply,
-              ...(backupPath === undefined ? {} : { backupPath }),
-            });
+            const report = await pruneState(
+              this.state,
+              this.databasePath,
+              {
+                before,
+                apply,
+                ...(backupPath === undefined ? {} : { backupPath }),
+              },
+              () => this.activeRunnerContentHashes(),
+            );
             return toJsonValue(report);
           });
         default:
@@ -777,7 +794,7 @@ export class WorkflowHost {
     request: ClientRequest,
     operation: () => Promise<JsonValue>,
   ): Promise<ClientResponse> {
-    const adopted = this.hostState.adoptCommand(request);
+    const adopted = this.serverState.adoptCommand(request);
     if (adopted !== undefined) return adopted;
     const claim = this.claim;
     if (claim === null || this.stopping) {
@@ -785,7 +802,7 @@ export class WorkflowHost {
         request.requestId,
         "unavailable",
         undefined,
-        "Workflow host is stopping",
+        "Workflow server is stopping",
       );
     }
     const key = canonicalJson([request.clientId, request.idempotencyKey]);
@@ -793,7 +810,7 @@ export class WorkflowHost {
     if (active !== undefined) {
       await active;
       return (
-        this.hostState.adoptCommand(request) ??
+        this.serverState.adoptCommand(request) ??
         clientResponse(
           request.requestId,
           "unavailable",
@@ -810,7 +827,7 @@ export class WorkflowHost {
       } catch (error) {
         result = { outcome: "rejected", error: errorMessage(error) };
       }
-      return this.hostState.executeCommand(request, claim.epoch, () => result);
+      return this.serverState.executeCommand(request, claim.epoch, () => result);
     })();
     this.maintenanceCommands.set(key, execution);
     try {
@@ -903,16 +920,20 @@ export class WorkflowHost {
       report.targetSessionId,
       report.coordinatorEpoch,
     );
-    const messages = this.hostState.workflowMessages.listSession(report.targetSessionId);
+    const messages = this.serverState.workflowMessages.listSession(report.targetSessionId);
     const allowed = new Set(messages.map((message) => message.workflowMessageId));
     const reconciledRunIds = new Set<string>();
     this.state.transaction(() => {
       if (coordinator.needsTimerResume) {
-        this.hostState.resumeSessionModelTurns(report.targetSessionId);
+        this.serverState.resumeSessionModelTurns(report.targetSessionId);
       }
-      this.hostState.workflowMessages.adoptBranch(report.targetSessionId, report.entries, allowed);
+      this.serverState.workflowMessages.adoptBranch(
+        report.targetSessionId,
+        report.entries,
+        allowed,
+      );
       if (report.isIdle && !report.hasPendingMessages) {
-        for (const turn of this.hostState.workflowMessages.openTurnsForSession(
+        for (const turn of this.serverState.workflowMessages.openTurnsForSession(
           report.targetSessionId,
         )) {
           reconciledRunIds.add(turn.runId);
@@ -928,8 +949,10 @@ export class WorkflowHost {
           });
         }
         const branchIds = new Set(report.entries.map((entry) => entry.workflowMessageId));
-        const refreshed = this.hostState.workflowMessages.listSession(report.targetSessionId);
-        for (const interaction of this.hostState.listPendingInteractions(report.targetSessionId)) {
+        const refreshed = this.serverState.workflowMessages.listSession(report.targetSessionId);
+        for (const interaction of this.serverState.listPendingInteractions(
+          report.targetSessionId,
+        )) {
           const sourceMessages = refreshed.filter(
             (message) => message.sourceId === interaction.requestId,
           );
@@ -937,8 +960,8 @@ export class WorkflowHost {
             sourceMessages.some((message) => message.status === "sent") &&
             !sourceMessages.some((message) => branchIds.has(message.workflowMessageId))
           ) {
-            this.hostState.workflowMessages.cancelPendingForSource(interaction.requestId);
-            this.hostState.ensureInteractionMessage(
+            this.serverState.workflowMessages.cancelPendingForSource(interaction.requestId);
+            this.serverState.ensureInteractionMessage(
               interaction,
               interaction.kind === "decision" ? "initial" : "resumed",
             );
@@ -970,7 +993,7 @@ export class WorkflowHost {
     }
     let outcome: "accepted" | "adopted" = "accepted";
     const receipt = this.state.transaction((): WorkflowTurnReportReceipt => {
-      const existing = this.hostState.workflowMessages.getTurn(report.workflowTurnId);
+      const existing = this.serverState.workflowMessages.getTurn(report.workflowTurnId);
       if (report.state === "ended") {
         if (existing === undefined) {
           outcome = "adopted";
@@ -994,7 +1017,7 @@ export class WorkflowHost {
         return workflowTurnReceipt("settled", turn);
       }
       if (existing !== undefined) {
-        const turn = this.hostState.workflowMessages.startTurn(report);
+        const turn = this.serverState.workflowMessages.startTurn(report);
         outcome = "adopted";
         return workflowTurnReceipt(turn.state === "started" ? "active" : "settled", turn);
       }
@@ -1010,7 +1033,7 @@ export class WorkflowHost {
         outcome = "adopted";
         return workflowTurnReceipt("absent", null);
       }
-      const message = this.hostState.workflowMessages.require(report.workflowMessageId);
+      const message = this.serverState.workflowMessages.require(report.workflowMessageId);
       const queuedRun = this.queue.getWorkflowRun(report.runId);
       if (
         message.kind === "step" &&
@@ -1021,14 +1044,14 @@ export class WorkflowHost {
       }
       if (message.kind === "step") {
         const now = Date.now();
-        this.hostState.beginInteractionModelTurn(message.sourceId, now);
-        this.hostState.workflowMessages.cancelPendingForSource(message.sourceId, "step", now);
+        this.serverState.beginInteractionModelTurn(message.sourceId, now);
+        this.serverState.workflowMessages.cancelPendingForSource(message.sourceId, "step", now);
         return workflowTurnReceipt(
           "active",
-          this.hostState.workflowMessages.startTurn({ ...report, now }),
+          this.serverState.workflowMessages.startTurn({ ...report, now }),
         );
       }
-      return workflowTurnReceipt("active", this.hostState.workflowMessages.startTurn(report));
+      return workflowTurnReceipt("active", this.serverState.workflowMessages.startTurn(report));
     });
     coordinator.modelTurnActive = receipt.ownership === "active";
     this.views.noteOriginActivityChange();
@@ -1038,24 +1061,24 @@ export class WorkflowHost {
   }
 
   private applyWorkflowTurnEnd(report: Extract<WorkflowTurnReport, { state: "ended" }>) {
-    const current = this.hostState.workflowMessages.requireTurn(report.workflowTurnId);
+    const current = this.serverState.workflowMessages.requireTurn(report.workflowTurnId);
     if (current.state === "ended") {
-      return this.hostState.workflowMessages.endTurn(report);
+      return this.serverState.workflowMessages.endTurn(report);
     }
-    const turn = this.hostState.workflowMessages.endTurn(report);
-    const message = this.hostState.workflowMessages.require(report.workflowMessageId);
+    const turn = this.serverState.workflowMessages.endTurn(report);
+    const message = this.serverState.workflowMessages.require(report.workflowMessageId);
     if (message.kind !== "step") return turn;
-    const interaction = this.hostState.getInteraction(message.sourceId);
+    const interaction = this.serverState.getInteraction(message.sourceId);
     if (interaction === undefined || interaction.status !== "pending") return turn;
     if (report.stopReason === "aborted") {
       if (!this.queue.pauseParkedWorkflowRun({ runId: report.runId })) {
         throw new Error("Interrupted workflow turn could not pause its exact parked run");
       }
-      this.hostState.workflowMessages.cancelPendingForSource(interaction.requestId, "step");
+      this.serverState.workflowMessages.cancelPendingForSource(interaction.requestId, "step");
       return turn;
     }
     if (this.queue.isWorkflowRunPaused(report.runId)) return turn;
-    if (this.hostState.validatingInteraction(report.runId) !== undefined) return turn;
+    if (this.serverState.validatingInteraction(report.runId) !== undefined) return turn;
     const changed = this.state.connection
       .prepare(
         `UPDATE interactive_requests
@@ -1065,13 +1088,13 @@ export class WorkflowHost {
       )
       .run(Date.now(), interaction.requestId);
     if (changed.changes !== 1) return turn;
-    const updated = this.hostState.getInteraction(interaction.requestId);
+    const updated = this.serverState.getInteraction(interaction.requestId);
     if (updated === undefined) throw new Error("Workflow interaction disappeared after turn end");
     if (updated.unproductiveTurnEnds <= 2) {
-      this.hostState.ensureInteractionMessage(updated, "reminder");
+      this.serverState.ensureInteractionMessage(updated, "reminder");
       return turn;
     }
-    this.hostState.workflowMessages.cancelPendingForSource(updated.requestId, "step");
+    this.serverState.workflowMessages.cancelPendingForSource(updated.requestId, "step");
     this.state.connection
       .prepare(
         `UPDATE interactive_requests SET status = 'cancelled', revision = revision + 1, updated_at = ?
@@ -1160,10 +1183,10 @@ export class WorkflowHost {
           request.requestId,
           "unavailable",
           undefined,
-          "Workflow host stopped while validating the submission",
+          "Workflow server stopped while validating the submission",
         );
       }
-      const submission = this.hostState.interactionSubmission(requestId, submissionId);
+      const submission = this.serverState.interactionSubmission(requestId, submissionId);
       if (submission?.outcome === "accepted" || submission?.outcome === "adopted") {
         return clientResponse(
           request.requestId,
@@ -1179,7 +1202,7 @@ export class WorkflowHost {
             : "Workflow step output failed validation";
         return clientResponse(request.requestId, "rejected", receipt, detail);
       }
-      await hostDelay(25);
+      await serverDelay(25);
     }
   }
 
@@ -1190,13 +1213,13 @@ export class WorkflowHost {
         type: "response",
         requestId: request.requestId,
         outcome: "unavailable",
-        error: "Workflow host is stopping",
+        error: "Workflow server is stopping",
       };
     }
     const afterCommit: Array<() => void> = [];
     let response: ClientResponse;
     try {
-      response = this.hostState.executeCommand(request, this.claim.epoch, () =>
+      response = this.serverState.executeCommand(request, this.claim.epoch, () =>
         this.executeOperation(request, afterCommit, connection),
       );
     } catch (error) {
@@ -1218,9 +1241,9 @@ export class WorkflowHost {
     connection?: ClientConnection,
   ): Omit<ClientResponse, "schema" | "type" | "requestId"> {
     switch (request.operation) {
-      case "host.status":
+      case "server.status":
         return { outcome: "accepted", receipt: this.statusReceipt() };
-      case "host.stop":
+      case "server.stop":
         afterCommit.push(() => void this.stop());
         return { outcome: "accepted", receipt: { stopping: true } };
       case "run.list":
@@ -1281,7 +1304,7 @@ export class WorkflowHost {
                 status: "parked",
                 paused: true,
                 alreadyPaused: true,
-                detail: "The supervised worker is already stopping at the pause boundary.",
+                detail: "The supervised runner is already stopping at the pause boundary.",
               },
             };
           }
@@ -1313,7 +1336,7 @@ export class WorkflowHost {
               status: "parked",
               paused: true,
               alreadyPaused: false,
-              detail: "The run is durably paused; the supervised worker is stopping.",
+              detail: "The run is durably paused; the supervised runner is stopping.",
             },
           };
         }
@@ -1335,12 +1358,12 @@ export class WorkflowHost {
         const runId = requireRunId(request);
         const resumedInteraction = this.state.transaction(() => {
           const now = Date.now();
-          const pausedAt = this.hostState.interactionPauseStartedAt(runId);
+          const pausedAt = this.serverState.interactionPauseStartedAt(runId);
           if (!this.queue.resumePausedInteraction({ runId, now: new Date(now).toISOString() })) {
             return false;
           }
-          this.hostState.resumeInteractionModelTurn(runId, pausedAt, now);
-          this.hostState.resumePendingInteraction(runId, now);
+          this.serverState.resumeInteractionModelTurn(runId, pausedAt, now);
+          this.serverState.resumePendingInteraction(runId, now);
           return true;
         });
         if (resumedInteraction) {
@@ -1372,7 +1395,7 @@ export class WorkflowHost {
         const token = randomUUID();
         const claimed = this.queue.claimWorkflowRun({
           runId,
-          runnerId: this.hostId,
+          runnerId: this.serverId,
           claimToken: token,
           leaseMs: this.runClaimLeaseMs,
         });
@@ -1412,12 +1435,12 @@ export class WorkflowHost {
         return this.startRun(request, afterCommit);
       case "checkpoint.answer":
         return this.answerCheckpoint(request, afterCommit);
-      case "controller.list":
-      case "controller.get":
-      case "controller.apply":
-      case "controller.reconcile":
-      case "controller.delete":
-        return this.executeControllerOperation(request);
+      case "resourceManager.list":
+      case "resourceManager.get":
+      case "resourceManager.apply":
+      case "resourceManager.reconcile":
+      case "resourceManager.delete":
+        return this.executeResourceManagerOperation(request);
       case "interaction.update":
         return this.publishInteractionUpdate(request);
       case "interaction.submit":
@@ -1471,7 +1494,7 @@ export class WorkflowHost {
     }
     const payload = requireRecord(request.payload, "run.restart payload");
     const workflowMessageId = requireString(payload.workflowMessageId, "workflowMessageId");
-    const terminal = this.hostState.workflowMessages.latestForSource(
+    const terminal = this.serverState.workflowMessages.latestForSource(
       "terminal",
       `terminal:${sourceRunId}`,
     );
@@ -1487,7 +1510,7 @@ export class WorkflowHost {
     if (sessionView.run?.runId !== sourceRunId) {
       return { outcome: "rejected", error: "Workflow terminal result is no longer current" };
     }
-    const turn = this.hostState.workflowMessages.latestTurnForMessage(workflowMessageId);
+    const turn = this.serverState.workflowMessages.latestTurnForMessage(workflowMessageId);
     if (turn === undefined) {
       return { outcome: "rejected", error: "Workflow restart requires a terminal model turn" };
     }
@@ -1547,7 +1570,7 @@ export class WorkflowHost {
     }
     const runId = `restart-${createHash("sha256").update(workflowMessageId).digest("hex").slice(0, 40)}`;
     const claimToken = randomUUID();
-    const scoped = new SqliteControllerStore(this.databasePath, {
+    const scoped = new SqliteResourceManagerStore(this.databasePath, {
       state: this.state,
       projectPath,
     });
@@ -1560,7 +1583,7 @@ export class WorkflowHost {
       definitionSnapshot: this.state.readJson(definition.definitionHash),
       input: source.input,
       launchOptions: source.launchOptions,
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken,
       leaseMs: this.runClaimLeaseMs,
       originSessionId: session.targetSessionId,
@@ -1769,58 +1792,72 @@ export class WorkflowHost {
     };
   }
 
-  private executeControllerOperation(
+  private executeResourceManagerOperation(
     request: ClientRequest,
   ): Omit<ClientResponse, "schema" | "type" | "requestId"> {
-    const payload = requireRecord(request.payload, "controller payload");
+    const payload = requireRecord(request.payload, "resource manager payload");
     const projectPath = path.resolve(requireString(payload.projectPath, "projectPath"));
     if (payload.projectPath !== projectPath) {
       return {
         outcome: "rejected",
-        error: "Controller projectPath must be absolute and normalized",
+        error: "ResourceManager projectPath must be absolute and normalized",
       };
     }
-    const store = new SqliteControllerStore(this.databasePath, {
+    const store = new SqliteResourceManagerStore(this.databasePath, {
       state: this.state,
       projectPath,
     });
-    if (request.operation === "controller.list") {
+    if (request.operation === "resourceManager.list") {
       return { outcome: "accepted", receipt: store.listResources() as unknown as JsonValue };
     }
-    const controller = requireString(payload.controller, "controller");
+    const resourceManager = requireString(payload.resourceManager, "resourceManager");
     const key = requireString(payload.key, "key");
-    const ref = { controller, key };
-    if (request.operation === "controller.get") {
+    const ref = { resourceManager, key };
+    if (request.operation === "resourceManager.get") {
       const resource = store.getResource(ref);
       return resource === undefined
-        ? { outcome: "notFound", error: `Controller resource not found: ${controller}/${key}` }
+        ? { outcome: "notFound", error: `Managed resource not found: ${resourceManager}/${key}` }
         : { outcome: "accepted", receipt: resource as unknown as JsonValue };
     }
-    if (request.operation === "controller.apply") {
+    if (request.operation === "resourceManager.apply") {
       if (!Object.hasOwn(payload, "spec") || !Object.hasOwn(payload, "initialStatus")) {
-        return { outcome: "rejected", error: "Controller apply requires spec and initialStatus" };
+        return {
+          outcome: "rejected",
+          error: "ResourceManager apply requires spec and initialStatus",
+        };
       }
       const spec = payload.spec as JsonValue;
       const initialStatus = payload.initialStatus as JsonValue;
-      const controllerPath = path.resolve(requireString(payload.controllerPath, "controllerPath"));
+      const resourceManagerPath = path.resolve(
+        requireString(payload.resourceManagerPath, "resourceManagerPath"),
+      );
       const sourceHash = requireString(payload.sourceHash, "sourceHash");
-      if (!controllerPathAllowed(projectPath, controller, controllerPath)) {
-        return { outcome: "rejected", error: "Controller source does not match discovery rules" };
+      if (!resourceManagerPathAllowed(projectPath, resourceManager, resourceManagerPath)) {
+        return {
+          outcome: "rejected",
+          error: "ResourceManager source does not match discovery rules",
+        };
       }
       const observedHash = createHash("sha256")
-        .update(fs.readFileSync(controllerPath))
+        .update(fs.readFileSync(resourceManagerPath))
         .digest("hex");
       if (observedHash !== sourceHash) {
-        return { outcome: "conflict", error: "Controller source changed before apply committed" };
+        return {
+          outcome: "conflict",
+          error: "ResourceManager source changed before apply committed",
+        };
       }
-      const resource = store.putResource({ controller, key, spec, initialStatus });
+      const resource = store.putResource({ resourceManager, key, spec, initialStatus });
       return { outcome: "accepted", receipt: resource as unknown as JsonValue };
     }
     const existing = store.getResource(ref);
     if (existing === undefined) {
-      return { outcome: "notFound", error: `Controller resource not found: ${controller}/${key}` };
+      return {
+        outcome: "notFound",
+        error: `Managed resource not found: ${resourceManager}/${key}`,
+      };
     }
-    if (request.operation === "controller.reconcile") {
+    if (request.operation === "resourceManager.reconcile") {
       store.enqueue(ref);
       return { outcome: "accepted", receipt: existing as unknown as JsonValue };
     }
@@ -1830,7 +1867,7 @@ export class WorkflowHost {
   }
 
   private statusReceipt(): JsonValue {
-    const host = this.hostState.hostStatus();
+    const serverStatus = this.serverState.serverStatus();
     const count = (sql: string, ...params: unknown[]): number => {
       const row = this.state.connection.prepare(sql).get(...params) as
         | { count?: unknown }
@@ -1839,13 +1876,13 @@ export class WorkflowHost {
     };
     const now = Date.now();
     return {
-      state: host.live ? "running" : "stale",
-      epoch: host.epoch,
+      state: serverStatus.live ? "running" : "stale",
+      epoch: serverStatus.epoch,
       socketAvailable: this.server?.listening === true,
-      startedAt: host.startedAt,
-      heartbeatAt: host.heartbeatAt,
-      expiresAt: host.expiresAt,
-      activeWorkers: this.activeRuns.size,
+      startedAt: serverStatus.startedAt,
+      heartbeatAt: serverStatus.heartbeatAt,
+      expiresAt: serverStatus.expiresAt,
+      activeRunners: this.activeRuns.size,
       connectedClients: this.sockets.size,
       queuedRuns: count("SELECT COUNT(*) AS count FROM run_queue WHERE status = 'queued'"),
       runningRuns: count(
@@ -1865,8 +1902,8 @@ export class WorkflowHost {
         "SELECT COUNT(*) AS count FROM interactive_requests WHERE status = 'pending'",
       ),
       ambiguousEffects: count("SELECT COUNT(*) AS count FROM effects WHERE status = 'ambiguous'"),
-      pendingControllers: count("SELECT COUNT(*) AS count FROM controller_queue"),
-      activeControllerWorkers: this.activeControllers.size,
+      pendingResourceManagers: count("SELECT COUNT(*) AS count FROM controller_queue"),
+      activeResourceRunners: this.activeResourceManagers.size,
       lifecycleContradictions: count(
         `SELECT COUNT(*) AS count
          FROM runs r JOIN run_queue q ON q.run_id = r.run_id
@@ -1882,6 +1919,14 @@ export class WorkflowHost {
     };
   }
 
+  private activeRunnerContentHashes(): Buffer[] {
+    const digests = new Set<string>();
+    for (const active of this.activeRuns.values()) {
+      for (const digest of active.contentDigests) digests.add(digest);
+    }
+    return [...digests].map((digest) => Buffer.from(digest, "hex"));
+  }
+
   private stateStatusReceipt(): JsonValue {
     const count = (sql: string, ...params: unknown[]): number => {
       const row = this.state.connection.prepare(sql).get(...params) as
@@ -1895,7 +1940,7 @@ export class WorkflowHost {
       counts: {
         resources: count("SELECT COUNT(*) AS count FROM resources"),
         runs: count("SELECT COUNT(*) AS count FROM runs"),
-        controllers: count("SELECT COUNT(*) AS count FROM controller_resources"),
+        resourceManagers: count("SELECT COUNT(*) AS count FROM controller_resources"),
         decisions: count("SELECT COUNT(*) AS count FROM human_decisions"),
         settingsScopes: count("SELECT COUNT(*) AS count FROM workflow_settings"),
         pendingInteractions: count(
@@ -1985,7 +2030,7 @@ export class WorkflowHost {
   ): Omit<ClientResponse, "schema" | "type" | "requestId"> {
     const payload = requireRecord(command.payload, "decision answer payload");
     const requestId = requireString(payload.requestId, "requestId");
-    const interaction = this.hostState.getInteraction(requestId);
+    const interaction = this.serverState.getInteraction(requestId);
     if (interaction === undefined || interaction.kind !== "decision") {
       return { outcome: "notFound", error: `Decision request not found: ${requestId}` };
     }
@@ -2030,7 +2075,7 @@ export class WorkflowHost {
     if (accepted.status === "conflict") {
       return { outcome: "conflict", error: "Another human decision answer already won" };
     }
-    this.hostState.submitInteraction({
+    this.serverState.submitInteraction({
       requestId: options.interaction.requestId,
       submissionId: options.submissionId,
       idempotencyKey: options.idempotencyKey,
@@ -2100,7 +2145,7 @@ export class WorkflowHost {
     afterCommit: Array<() => void>,
   ) {
     const token = randomUUID();
-    const scoped = new SqliteControllerStore(this.databasePath, {
+    const scoped = new SqliteResourceManagerStore(this.databasePath, {
       state: this.state,
       projectPath: options.projectPath,
     });
@@ -2113,7 +2158,7 @@ export class WorkflowHost {
       definitionSnapshot: options.definitionSnapshot,
       input: options.input,
       launchOptions: options.launchOptions,
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken: token,
       leaseMs: this.runClaimLeaseMs,
       originSessionId: options.originSessionId,
@@ -2140,7 +2185,7 @@ export class WorkflowHost {
     const originSessionId = requireString(payload.originSessionId, "originSessionId");
     const executionMode = payload.executionMode === "headless" ? "headless" : "interactive";
     const token = randomUUID();
-    const scoped = new SqliteControllerStore(this.databasePath, {
+    const scoped = new SqliteResourceManagerStore(this.databasePath, {
       state: this.state,
       projectPath,
     });
@@ -2153,7 +2198,7 @@ export class WorkflowHost {
       definitionSnapshot: payload.definitionSnapshot,
       input: payload.input,
       launchOptions: payload.launchOptions ?? {},
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken: token,
       leaseMs: this.runClaimLeaseMs,
       originSessionId,
@@ -2181,7 +2226,7 @@ export class WorkflowHost {
     const runId = requireRunId(request);
     const payload = requireRecord(request.payload, "interaction update payload");
     const requestId = requireString(payload.requestId, "requestId");
-    const interaction = this.hostState.getInteraction(requestId);
+    const interaction = this.serverState.getInteraction(requestId);
     if (interaction === undefined || interaction.runId !== runId) {
       return { outcome: "notFound", error: `Interactive request not found: ${requestId}` };
     }
@@ -2210,7 +2255,7 @@ export class WorkflowHost {
     const token = randomUUID();
     const claimed = this.queue.claimWorkflowRunForControl({
       runId,
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken: token,
       leaseMs: this.runClaimLeaseMs,
     });
@@ -2249,7 +2294,7 @@ export class WorkflowHost {
   ): Omit<ClientResponse, "schema" | "type" | "requestId"> {
     const payload = requireRecord(request.payload, "interaction payload");
     const requestId = requireString(payload.requestId, "requestId");
-    const current = this.hostState.getInteraction(requestId);
+    const current = this.serverState.getInteraction(requestId);
     if (current === undefined || current.runId !== requireRunId(request)) {
       return { outcome: "notFound", error: `Interactive request not found: ${requestId}` };
     }
@@ -2267,7 +2312,7 @@ export class WorkflowHost {
       return { outcome: "conflict", error: "Interactive request attempt is stale" };
     }
     const submissionId = requireString(payload.submissionId, "submissionId");
-    const submission = this.hostState.beginInteractionValidation({
+    const submission = this.serverState.beginInteractionValidation({
       requestId,
       submissionId,
       idempotencyKey: request.idempotencyKey,
@@ -2290,7 +2335,7 @@ export class WorkflowHost {
       const token = randomUUID();
       const claimed = this.queue.claimWorkflowRunForInteractionValidation({
         runId: interaction.runId,
-        runnerId: this.hostId,
+        runnerId: this.serverId,
         claimToken: token,
         leaseMs: this.runClaimLeaseMs,
       });
@@ -2334,7 +2379,7 @@ export class WorkflowHost {
         ...(sourceResourceId === undefined ? {} : { sourceResourceId }),
         ...(stableMessageIds === undefined ? {} : { stableMessageIds }),
         error: errorCode,
-        actorId: this.hostId,
+        actorId: this.serverId,
       });
       for (const effect of effects) {
         this.recordChannelEffectResult(effect, "unknown", errorCode);
@@ -2349,13 +2394,13 @@ export class WorkflowHost {
     if (action !== "confirm" && action !== "retry") {
       throw new Error("Channel recovery action must be confirm or retry");
     }
-    if (this.claim === null) throw new Error("Workflow host claim is unavailable");
+    if (this.claim === null) throw new Error("Workflow server claim is unavailable");
     const effect = this.state.transaction(() => {
       const recovered = this.channelEffects.recover({
         stableMessageId: messageId,
         action,
         actorId,
-        ownerId: this.hostId,
+        ownerId: this.serverId,
         leaseGeneration: this.claim?.epoch ?? 0,
       });
       const attemptId = channelEffectAttemptId(recovered.effectId, recovered.attemptNumber);
@@ -2622,9 +2667,9 @@ export class WorkflowHost {
       !config.allowedUserIds.includes(message.actorId) ||
       !config.allowedChatIds.includes(message.chatId)
     ) {
-      throw new Error("Telegram answer source is not authorized by the host profile");
+      throw new Error("Telegram answer source is not authorized by the server profile");
     }
-    const interaction = this.hostState.listPendingDecisionInteractions().find((candidate) => {
+    const interaction = this.serverState.listPendingDecisionInteractions().find((candidate) => {
       const request = candidate.contract as unknown as HumanDecisionRequest;
       return request.decisionId === message.decisionId;
     });
@@ -2661,7 +2706,7 @@ export class WorkflowHost {
   }
 
   private async nextChannelCommand(active: ActiveChannel): Promise<ChannelAdapterCommand> {
-    const interactions = this.hostState.listPendingDecisionInteractions();
+    const interactions = this.serverState.listPendingDecisionInteractions();
     for (const interaction of interactions) {
       const request = interaction.contract as unknown as HumanDecisionRequest;
       if (
@@ -2751,7 +2796,7 @@ export class WorkflowHost {
     request: HumanDecisionChannelRequest,
     purpose: "delivery" | "settlement",
   ): ChannelEffectRecord {
-    if (this.claim === null) throw new Error("Workflow host claim is unavailable");
+    if (this.claim === null) throw new Error("Workflow server claim is unavailable");
     return this.state.transaction(() => {
       const effect = this.channelEffects.ensureApplying({
         channelResourceId: active.resourceId,
@@ -2760,7 +2805,7 @@ export class WorkflowHost {
         decisionId: request.decisionId,
         purpose,
         request,
-        ownerId: this.hostId,
+        ownerId: this.serverId,
         leaseGeneration: this.claim?.epoch ?? 0,
         maxAutomaticAttempts: 3,
       });
@@ -2950,16 +2995,16 @@ export class WorkflowHost {
     return row.revision;
   }
 
-  private async claimControllerOne(): Promise<void> {
+  private async claimResourceManagerOne(): Promise<void> {
     if (
       this.stopping ||
       this.claim === null ||
-      this.controllerPollActive ||
-      this.activeControllers.size >= MAX_CONTROLLER_WORKERS
+      this.resourceManagerPollActive ||
+      this.activeResourceManagers.size >= MAX_RESOURCE_RUNNERS
     ) {
       return;
     }
-    this.controllerPollActive = true;
+    this.resourceManagerPollActive = true;
     try {
       const rows = this.state.connection
         .prepare(
@@ -2974,87 +3019,90 @@ export class WorkflowHost {
         .all(Date.now(), Date.now()) as Array<{ projectPath?: unknown }>;
       for (const row of rows) {
         if (typeof row.projectPath !== "string") continue;
-        const discovered = await discoverControllers({ cwd: row.projectPath });
+        const discovered = await discoverResourceManagers({ cwd: row.projectPath });
         if (discovered.length === 0) continue;
         const byName = new Map(discovered.map((item) => [item.name, item.path]));
-        const store = new SqliteControllerStore(this.databasePath, {
+        const store = new SqliteResourceManagerStore(this.databasePath, {
           state: this.state,
           projectPath: row.projectPath,
         });
         const claim = store.claimNext({
-          controllers: [...byName.keys()],
-          ownerId: this.hostId,
-          leaseMs: CONTROLLER_CLAIM_LEASE_MS,
-          exclude: [...this.activeControllers.values()]
+          resourceManagers: [...byName.keys()],
+          ownerId: this.serverId,
+          leaseMs: RESOURCE_MANAGER_CLAIM_LEASE_MS,
+          exclude: [...this.activeResourceManagers.values()]
             .filter((active) => active.projectPath === row.projectPath)
             .map((active) => ({
-              controller: active.claim.controller,
+              resourceManager: active.claim.resourceManager,
               key: active.claim.key,
             })),
         });
         if (claim === undefined) continue;
-        const definitionPath = byName.get(claim.controller);
-        const resource = store.getResource({ controller: claim.controller, key: claim.key });
+        const definitionPath = byName.get(claim.resourceManager);
+        const resource = store.getResource({
+          resourceManager: claim.resourceManager,
+          key: claim.key,
+        });
         if (definitionPath === undefined || resource === undefined) {
           store.requeueClaim(claim, {
             availableAt: new Date().toISOString(),
-            error: "Controller source is unavailable",
+            error: "ResourceManager source is unavailable",
           });
           continue;
         }
-        void this.activateController(row.projectPath, definitionPath, store, claim, resource);
+        void this.activateResourceManager(row.projectPath, definitionPath, store, claim, resource);
         break;
       }
     } catch (error) {
-      this.log(`controller scheduling failed: ${errorMessage(error)}`);
+      this.log(`resource manager scheduling failed: ${errorMessage(error)}`);
     } finally {
-      this.controllerPollActive = false;
+      this.resourceManagerPollActive = false;
     }
   }
 
-  private async activateController(
+  private async activateResourceManager(
     projectPath: string,
     definitionPath: string,
-    store: SqliteControllerStore,
-    claim: ControllerQueueClaim,
-    resource: ControllerResource,
+    store: SqliteResourceManagerStore,
+    claim: ResourceManagerQueueClaim,
+    resource: ManagedResource,
   ): Promise<void> {
     if (this.claim === null || this.stopping) {
       store.requeueClaim(claim, { availableAt: new Date().toISOString() });
       return;
     }
-    const workerEpoch = randomUUID();
-    const key = `${projectPath}\u0000${claim.controller}\u0000${claim.key}`;
+    const runnerEpoch = randomUUID();
+    const key = `${projectPath}\u0000${claim.resourceManager}\u0000${claim.key}`;
     const reconcileId = randomUUID();
-    const envelope: ControllerWorkerLaunchEnvelope = {
+    const envelope: ResourceRunnerLaunchEnvelope = {
       schema: "pi-workflows.controller-worker-launch.v1",
-      workerEpoch,
-      hostEpoch: this.claim.epoch,
+      runnerEpoch,
+      serverEpoch: this.claim.epoch,
       generation: claim.generation,
       projectPath,
       definitionPath,
-      controllerName: claim.controller,
+      resourceManagerName: claim.resourceManager,
       resource,
-      timeoutMs: DEFAULT_CONTROLLER_TIMEOUT_MS,
+      timeoutMs: DEFAULT_RESOURCE_MANAGER_TIMEOUT_MS,
     };
-    let active: ActiveController;
-    const supervisor = new ControllerWorkerSupervisor(envelope, {
+    let active: ActiveResourceManager;
+    const supervisor = new ResourceRunnerSupervisor(envelope, {
       registry: this.registry,
-      onMessage: async (message) => await this.handleControllerWorkerMessage(active, message),
+      onMessage: async (message) => await this.handleResourceRunnerMessage(active, message),
       ...(this.options.env === undefined ? {} : { env: this.options.env }),
-      ...(this.options.controllerWorkerEntryPath === undefined
+      ...(this.options.resourceRunnerEntryPath === undefined
         ? {}
-        : { workerEntryPath: this.options.controllerWorkerEntryPath }),
-      ...(this.options.workerStartupTimeoutMs === undefined
+        : { runnerEntryPath: this.options.resourceRunnerEntryPath }),
+      ...(this.options.runnerStartupTimeoutMs === undefined
         ? {}
-        : { startupTimeoutMs: this.options.workerStartupTimeoutMs }),
-      onDiagnostic: (message) => this.log(`controller worker ${workerEpoch}: ${message}`),
+        : { startupTimeoutMs: this.options.runnerStartupTimeoutMs }),
+      onDiagnostic: (message) => this.log(`resource runner ${runnerEpoch}: ${message}`),
     });
     const renewTimer = setInterval(() => {
-      if (!store.renewClaim(claim, CONTROLLER_CLAIM_LEASE_MS)) {
+      if (!store.renewClaim(claim, RESOURCE_MANAGER_CLAIM_LEASE_MS)) {
         void supervisor.stop("claimLost");
       }
-    }, CONTROLLER_RENEW_MS);
+    }, RESOURCE_MANAGER_RENEW_MS);
     renewTimer.unref?.();
     active = {
       key,
@@ -3068,9 +3116,9 @@ export class WorkflowHost {
       renewTimer,
       settled: false,
     };
-    this.activeControllers.set(key, active);
+    this.activeResourceManagers.set(key, active);
     store.recordEvent({
-      controller: claim.controller,
+      resourceManager: claim.resourceManager,
       key: claim.key,
       claim,
       type: "reconcile_started",
@@ -3080,46 +3128,46 @@ export class WorkflowHost {
       await supervisor.start();
       const result = await supervisor.wait();
       if (result.outcome !== "exited" && !active.settled) {
-        this.finishControllerFailure(
+        this.finishResourceManagerFailure(
           active,
-          result.diagnostic ?? `Controller worker ${result.outcome}`,
+          result.diagnostic ?? `Resource runner ${result.outcome}`,
         );
       }
     } catch (error) {
       await supervisor.stop("crashed");
-      if (!active.settled) this.finishControllerFailure(active, errorMessage(error));
+      if (!active.settled) this.finishResourceManagerFailure(active, errorMessage(error));
     } finally {
       clearInterval(renewTimer);
-      this.activeControllers.delete(key);
-      if (!this.stopping) setImmediate(() => void this.claimControllerOne());
+      this.activeResourceManagers.delete(key);
+      if (!this.stopping) setImmediate(() => void this.claimResourceManagerOne());
     }
   }
 
-  private async handleControllerWorkerMessage(
-    active: ActiveController,
-    message: ControllerWorkerMessage,
-  ): Promise<ControllerWorkerResponse> {
-    const current = this.activeControllers.get(active.key);
+  private async handleResourceRunnerMessage(
+    active: ActiveResourceManager,
+    message: ResourceRunnerMessage,
+  ): Promise<ResourceRunnerResponse> {
+    const current = this.activeResourceManagers.get(active.key);
     if (
       current !== active ||
-      message.workerEpoch !== active.supervisor.envelope.workerEpoch ||
+      message.runnerEpoch !== active.supervisor.envelope.runnerEpoch ||
       message.generation !== active.claim.generation
     ) {
-      return controllerWorkerResponse(
+      return resourceRunnerResponse(message, "claimLost", undefined, "Resource runner is stale");
+    }
+    if (!active.store.renewClaim(active.claim, RESOURCE_MANAGER_CLAIM_LEASE_MS)) {
+      return resourceRunnerResponse(
         message,
         "claimLost",
         undefined,
-        "Controller worker is stale",
+        "ResourceManager claim expired",
       );
     }
-    if (!active.store.renewClaim(active.claim, CONTROLLER_CLAIM_LEASE_MS)) {
-      return controllerWorkerResponse(message, "claimLost", undefined, "Controller claim expired");
-    }
     try {
-      const payload = requireRecord(message.payload, "controller worker payload");
+      const payload = requireRecord(message.payload, "resource runner payload");
       switch (message.operation) {
-        case "worker.ready":
-          return controllerWorkerResponse(message, "accepted", {});
+        case "runner.ready":
+          return resourceRunnerResponse(message, "accepted", {});
         case "effect.reserve": {
           const reservation = active.store.reserveEffect({
             key: requireString(payload.key, "key"),
@@ -3129,12 +3177,12 @@ export class WorkflowHost {
             kind: requireString(payload.kind, "kind"),
             requestFingerprint: requireString(payload.requestFingerprint, "requestFingerprint"),
           });
-          return controllerWorkerResponse(message, "accepted", reservation as unknown as JsonValue);
+          return resourceRunnerResponse(message, "accepted", reservation as unknown as JsonValue);
         }
         case "effect.settle": {
           const state = requireString(payload.state, "state");
           if (!["applied", "rejected", "indeterminate"].includes(state)) {
-            throw new Error("Controller effect state is invalid");
+            throw new Error("ResourceManager effect state is invalid");
           }
           const record = active.store.updateEffect({
             resourceUid: active.resource.metadata.uid,
@@ -3147,21 +3195,21 @@ export class WorkflowHost {
             ...(typeof payload.error === "string" ? { error: payload.error } : {}),
           });
           active.store.recordEvent({
-            controller: active.claim.controller,
+            resourceManager: active.claim.resourceManager,
             key: active.claim.key,
             claim: active.claim,
             type: `effect_${state}`,
             payload: { effectKey: record.key },
           });
-          return controllerWorkerResponse(message, "accepted", record as unknown as JsonValue);
+          return resourceRunnerResponse(message, "accepted", record as unknown as JsonValue);
         }
         case "workflow.ensure":
         case "workflow.changeSettings":
         case "workflow.queueFollowUp":
         case "workflow.removeFollowUp": {
-          const workflows = new ControllerWorkflowCoordinator(
+          const workflows = new ResourceManagerWorkflowCoordinator(
             active.store,
-            this.controllerWorkflowScheduler(active),
+            this.resourceManagerWorkflowScheduler(active),
           ).forResource(active.resource, active.claim, new AbortController().signal);
           const result =
             message.operation === "workflow.ensure"
@@ -3171,39 +3219,41 @@ export class WorkflowHost {
                 : message.operation === "workflow.queueFollowUp"
                   ? await workflows.queueFollowUp(payload as never)
                   : await workflows.removeFollowUp(payload as never);
-          return controllerWorkerResponse(message, "accepted", result as unknown as JsonValue);
+          return resourceRunnerResponse(message, "accepted", result as unknown as JsonValue);
         }
-        case "worker.finished":
-          this.finishControllerSuccess(
+        case "runner.finished":
+          this.finishResourceManagerSuccess(
             active,
             message.payload as unknown as ReconcileResult<unknown>,
           );
-          return controllerWorkerResponse(message, "accepted", {});
-        case "worker.failed":
-          this.finishControllerFailure(active, requireString(payload.error, "error"));
-          return controllerWorkerResponse(message, "accepted", {});
+          return resourceRunnerResponse(message, "accepted", {});
+        case "runner.failed":
+          this.finishResourceManagerFailure(active, requireString(payload.error, "error"));
+          return resourceRunnerResponse(message, "accepted", {});
       }
     } catch (error) {
-      return controllerWorkerResponse(message, "rejected", undefined, errorMessage(error));
+      return resourceRunnerResponse(message, "rejected", undefined, errorMessage(error));
     }
   }
 
-  private controllerWorkflowScheduler(active: ActiveController): ControllerWorkflowScheduler {
+  private resourceManagerWorkflowScheduler(
+    active: ActiveResourceManager,
+  ): ResourceManagerWorkflowScheduler {
     return {
       ensure: async (request, _signal, _onComplete) =>
-        await this.ensureControllerWorkflow(active, request),
+        await this.ensureResourceManagerWorkflow(active, request),
       changeSettings: async (request) =>
-        await this.changeControllerWorkflowSettings(active, request),
+        await this.changeResourceManagerWorkflowSettings(active, request),
       queueFollowUp: async (request) => {
         const targetSessionId = this.runStore.originSessionId(request.runId);
         if (targetSessionId === undefined) {
-          throw new Error("Controller follow-up requires an origin Pi session");
+          throw new Error("ResourceManager follow-up requires an origin Pi session");
         }
         const result = this.runStore.queueFollowUp({
           runId: request.runId,
           requestId: request.actorRequestKey,
           targetSessionId,
-          actor: { type: "controller", id: request.controllerResourceUid },
+          actor: { type: "controller", id: request.managedResourceUid },
           source: "controller-request",
           prompt: request.prompt,
         });
@@ -3219,7 +3269,7 @@ export class WorkflowHost {
         const result = this.runStore.removeFollowUp({
           runId: request.runId,
           followUpId: request.followUpId,
-          actor: { type: "controller", id: request.controllerResourceUid },
+          actor: { type: "controller", id: request.managedResourceUid },
           source: "controller-request",
         });
         return {
@@ -3233,16 +3283,16 @@ export class WorkflowHost {
     };
   }
 
-  private async changeControllerWorkflowSettings(
-    _active: ActiveController,
-    request: ControllerWorkflowControlRequest<ControllerSettingsChangeRequest>,
-  ): Promise<ControllerSettingsChangeResult> {
+  private async changeResourceManagerWorkflowSettings(
+    _active: ActiveResourceManager,
+    request: ResourceManagerWorkflowControlRequest<ResourceManagerSettingsChangeRequest>,
+  ): Promise<ResourceManagerSettingsChangeResult> {
     const run = this.queue.getWorkflowRun(request.runId);
     if (run === undefined) throw new Error(`Workflow run not found: ${request.runId}`);
     const scopes = this.runStore.listSettingsScopes(request.runId);
     const scopeId = request.scopeId ?? (scopes.length === 1 ? scopes[0]?.scopeId : undefined);
     if (scopeId === undefined) {
-      throw new Error("Controller settings changes require scopeId when several scopes exist");
+      throw new Error("ResourceManager settings changes require scopeId when several scopes exist");
     }
     const scope = this.runStore.getSettingsScope(scopeId);
     if (scope === undefined || scope.activeRunId !== request.runId) {
@@ -3270,7 +3320,7 @@ export class WorkflowHost {
       mountPath: scope.mountPath,
       current: scope.settings,
       patch: request.patch as unknown as JsonValue,
-      actorId: request.controllerResourceUid,
+      actorId: request.managedResourceUid,
     });
     if (proposal.definitionDigest !== run.definitionDigest || !Array.isArray(proposal.paths)) {
       throw new Error("Workflow settings proposal does not match the durable source");
@@ -3291,7 +3341,7 @@ export class WorkflowHost {
       scopeId,
       requestId: request.actorRequestKey,
       expectedChangeNumber: request.expectedChangeNumber ?? scope.changeNumber,
-      actor: { type: "controller", id: request.controllerResourceUid },
+      actor: { type: "controller", id: request.managedResourceUid },
       source: "controller-request",
       patch: proposal.patch,
     });
@@ -3303,12 +3353,12 @@ export class WorkflowHost {
     };
   }
 
-  private async ensureControllerWorkflow(
-    active: ActiveController,
+  private async ensureResourceManagerWorkflow(
+    active: ActiveResourceManager,
     request: WorkflowSchedulerRequest,
   ): Promise<WorkflowSchedulerResult> {
     const existing = this.queue.getWorkflowRun(request.runId);
-    if (existing !== undefined) return controllerWorkflowResult(existing);
+    if (existing !== undefined) return resourceManagerWorkflowResult(existing);
     const resolver = new WorkflowClient({
       databasePath: this.databasePath,
       ...(this.options.env === undefined ? {} : { env: this.options.env }),
@@ -3318,7 +3368,7 @@ export class WorkflowHost {
       workflowRef: request.workflow,
     });
     const token = randomUUID();
-    const scoped = new SqliteControllerStore(this.databasePath, {
+    const scoped = new SqliteResourceManagerStore(this.databasePath, {
       state: this.state,
       projectPath: active.projectPath,
     });
@@ -3331,26 +3381,26 @@ export class WorkflowHost {
       definitionSnapshot: resolved.definitionSnapshot,
       input: request.input,
       launchOptions: {},
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken: token,
       leaseMs: this.runClaimLeaseMs,
-      originSessionId: `controller-${active.resource.metadata.uid}`,
+      originSessionId: `resource-manager-${active.resource.metadata.uid}`,
       executionMode: "headless",
     });
     if (prepared.state === "claimed") {
       this.markPendingStart(request.runId, token);
       setImmediate(() => void this.activateRun(prepared.run, token));
     }
-    return controllerWorkflowResult(prepared.run);
+    return resourceManagerWorkflowResult(prepared.run);
   }
 
-  private finishControllerSuccess(
-    active: ActiveController,
+  private finishResourceManagerSuccess(
+    active: ActiveResourceManager,
     result: ReconcileResult<unknown>,
   ): void {
     if (active.settled) return;
     const now = new Date();
-    const ref = { controller: active.claim.controller, key: active.claim.key };
+    const ref = { resourceManager: active.claim.resourceManager, key: active.claim.key };
     const status = applyStatusPatch(
       active.resource.status,
       result.status,
@@ -3405,7 +3455,7 @@ export class WorkflowHost {
       }
       active.settled = true;
     } catch (error) {
-      if (error instanceof ResourceConflictError) {
+      if (error instanceof ManagedResourceConflictError) {
         active.store.recordEvent({
           ...ref,
           claim: active.claim,
@@ -3424,13 +3474,13 @@ export class WorkflowHost {
     }
   }
 
-  private finishControllerFailure(active: ActiveController, failure: string): void {
+  private finishResourceManagerFailure(active: ActiveResourceManager, failure: string): void {
     if (active.settled) return;
     const now = new Date();
     const delay = Math.min(60_000, 1_000 * 2 ** Math.min(active.claim.consecutiveErrors, 6));
     const error = failure.slice(0, 8_192);
     active.store.recordEvent({
-      controller: active.claim.controller,
+      resourceManager: active.claim.resourceManager,
       key: active.claim.key,
       claim: active.claim,
       type: "reconcile_failed",
@@ -3458,7 +3508,7 @@ export class WorkflowHost {
       const candidate = requests
         .map((request) => ({
           request,
-          interaction: this.hostState.getInteraction(request.decisionId),
+          interaction: this.serverState.getInteraction(request.decisionId),
         }))
         .find(
           ({ request, interaction }) =>
@@ -3479,7 +3529,7 @@ export class WorkflowHost {
       const claimToken = randomUUID();
       const claimed = this.queue.claimWorkflowRunForControl({
         runId: request.runId,
-        runnerId: this.hostId,
+        runnerId: this.serverId,
         claimToken,
         leaseMs: this.runClaimLeaseMs,
       });
@@ -3491,7 +3541,7 @@ export class WorkflowHost {
         this.state.transaction(() => {
           const accepted = this.decisions.resolveTimeoutSync(request, new Date());
           const submissionId = `timeout-${request.decisionId}`;
-          this.hostState.submitInteraction({
+          this.serverState.submitInteraction({
             requestId: interaction.requestId,
             submissionId,
             idempotencyKey: submissionId,
@@ -3528,7 +3578,7 @@ export class WorkflowHost {
         .filter(([, coordinator]) => coordinator.branchReported && coordinator.modelTurnActive)
         .map(([sessionId]) => sessionId),
     );
-    const expired = this.hostState
+    const expired = this.serverState
       .expiredInteractionRuns()
       .find(
         (candidate) =>
@@ -3541,7 +3591,7 @@ export class WorkflowHost {
     const claimToken = randomUUID();
     const claimed = this.queue.claimWorkflowRunForControl({
       runId,
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken,
       leaseMs: this.runClaimLeaseMs,
     });
@@ -3583,14 +3633,14 @@ export class WorkflowHost {
       ...this.pendingStarts,
       ...this.blockedRuns,
     ]);
-    const validatingRunId = this.hostState
+    const validatingRunId = this.serverState
       .validatingInteractionRunIds()
       .find((runId) => !excluded.has(runId));
     if (validatingRunId !== undefined) {
       const validationToken = randomUUID();
       const validationRun = this.queue.claimWorkflowRunForInteractionValidation({
         runId: validatingRunId,
-        runnerId: this.hostId,
+        runnerId: this.serverId,
         claimToken: validationToken,
         leaseMs: this.runClaimLeaseMs,
       });
@@ -3602,7 +3652,7 @@ export class WorkflowHost {
     }
     const token = randomUUID();
     const claimed = this.queue.claimNextWorkflowRun({
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken: token,
       leaseMs: this.runClaimLeaseMs,
       excludeRunIds: [...excluded],
@@ -3653,38 +3703,38 @@ export class WorkflowHost {
       this.queue.parkWorkflowRun({ runId, claimToken });
       return;
     }
-    const envelope: WorkerLaunchEnvelope = {
+    const envelope: WorkflowRunnerLaunchEnvelope = {
       schema: "pi-workflows.worker-launch.v1",
       runId,
       generation,
-      workerEpoch: randomUUID(),
+      runnerEpoch: randomUUID(),
       projectPath,
       workflowSource: record.workflowSource as JsonValue,
       definitionDigest: record.definitionDigest,
       inputHash: `sha256:${createHash("sha256").update(canonicalJson(record.input)).digest("hex")}`,
       protocolVersion: 1,
     };
-    this.hostState.recordWorkerStart(envelope, this.claim.epoch);
+    this.serverState.recordRunnerStart(envelope, this.claim.epoch);
     let active: ActiveRun;
-    const supervisor = new WorkflowWorkerSupervisor(envelope, {
+    const supervisor = new WorkflowRunnerSupervisor(envelope, {
       registry: this.registry,
-      onMessage: async (message) => await this.handleWorkerMessage(message),
+      onMessage: async (message) => await this.handleRunnerMessage(message),
       ...(this.options.env === undefined ? {} : { env: this.options.env }),
-      ...(this.options.workerEntryPath === undefined
+      ...(this.options.runnerEntryPath === undefined
         ? {}
-        : { workerEntryPath: this.options.workerEntryPath }),
-      ...(this.options.workerStartupTimeoutMs === undefined
+        : { runnerEntryPath: this.options.runnerEntryPath }),
+      ...(this.options.runnerStartupTimeoutMs === undefined
         ? {}
-        : { startupTimeoutMs: this.options.workerStartupTimeoutMs }),
+        : { startupTimeoutMs: this.options.runnerStartupTimeoutMs }),
       onSpawn: (identity) => {
-        active.workerPid = identity.pid;
-        this.hostState.attachWorkerProcess(
-          envelope.workerEpoch,
+        active.runnerPid = identity.pid;
+        this.serverState.attachRunnerProcess(
+          envelope.runnerEpoch,
           identity.pid,
           identity.startIdentity,
         );
       },
-      onDiagnostic: (message) => this.log(`worker ${envelope.workerEpoch}: ${message}`),
+      onDiagnostic: (message) => this.log(`runner ${envelope.runnerEpoch}: ${message}`),
     });
     active = {
       record,
@@ -3693,6 +3743,7 @@ export class WorkflowHost {
       supervisor,
       launchProgressRevision: runRevision(this.state, runId),
       exiting: false,
+      contentDigests: new Set(),
     };
     this.activeRuns.set(runId, active);
     this.clearPendingStart(runId, claimToken);
@@ -3703,8 +3754,8 @@ export class WorkflowHost {
         if (!this.queue.parkWorkflowRunForAmbiguousEffect({ runId, claimToken })) {
           throw new Error("Run claim was lost during ambiguous-effect recovery");
         }
-        this.hostState.finishWorker({
-          workerEpoch: envelope.workerEpoch,
+        this.serverState.finishRunner({
+          runnerEpoch: envelope.runnerEpoch,
           outcome: "orphaned",
           diagnostic: "effect outcome is ambiguous",
         });
@@ -3712,8 +3763,8 @@ export class WorkflowHost {
       }
       await supervisor.start();
       const result = await supervisor.wait();
-      this.hostState.finishWorker({
-        workerEpoch: envelope.workerEpoch,
+      this.serverState.finishRunner({
+        runnerEpoch: envelope.runnerEpoch,
         outcome: result.outcome,
         exitCode: result.exitCode,
         signal: result.signal,
@@ -3722,30 +3773,30 @@ export class WorkflowHost {
       if (
         active.control === undefined &&
         (result.outcome !== "exited" ||
-          this.hostState.validatingInteraction(active.record.runId) !== undefined)
+          this.serverState.validatingInteraction(active.record.runId) !== undefined)
       ) {
-        await this.recoverWorkerExit(active, result.outcome);
+        await this.recoverRunnerExit(active, result.outcome);
       }
     } catch (error) {
-      this.log(`worker ${envelope.workerEpoch} failed: ${errorMessage(error)}`);
+      this.log(`runner ${envelope.runnerEpoch} failed: ${errorMessage(error)}`);
       await supervisor.stop("crashed");
       const result = await supervisor.wait();
       try {
-        this.hostState.finishWorker({
-          workerEpoch: envelope.workerEpoch,
+        this.serverState.finishRunner({
+          runnerEpoch: envelope.runnerEpoch,
           outcome: "crashed",
           exitCode: result.exitCode,
           signal: result.signal,
           diagnostic: result.diagnostic ?? errorMessage(error),
         });
       } catch {
-        // A completed worker record wins.
+        // A completed runner record wins.
       }
       if (active.control === undefined) {
-        await this.recoverWorkerExit(active, "crashed");
+        await this.recoverRunnerExit(active, "crashed");
       }
     } finally {
-      this.reapWorkerDescendants(envelope.workerEpoch);
+      this.reapRunnerDescendants(envelope.runnerEpoch);
       this.activeRuns.delete(runId);
     }
   }
@@ -3755,7 +3806,7 @@ export class WorkflowHost {
     const token = randomUUID();
     const claimed = this.queue.claimWorkflowRunForInteractionValidation({
       runId,
-      runnerId: this.hostId,
+      runnerId: this.serverId,
       claimToken: token,
       leaseMs: this.runClaimLeaseMs,
     });
@@ -3767,50 +3818,55 @@ export class WorkflowHost {
     await this.activateRun(claimed, token);
   }
 
-  private async handleWorkerMessage(message: WorkerMessage): Promise<WorkerResponse> {
+  private async handleRunnerMessage(
+    message: WorkflowRunnerMessage,
+  ): Promise<WorkflowRunnerResponse> {
     const active = this.activeRuns.get(message.runId);
     if (
       active === undefined ||
       active.generation !== message.generation ||
-      active.supervisor.envelope.workerEpoch !== message.workerEpoch
+      active.supervisor.envelope.runnerEpoch !== message.runnerEpoch
     ) {
-      return workerResponse(message, "claimLost", undefined, "Worker epoch is stale");
+      return runnerResponse(message, "claimLost", undefined, "Runner epoch is stale");
     }
-    const stored = this.hostState.readWorkerMessage(message);
-    if (stored !== undefined) return stored;
-    const response = await this.handleFreshWorkerMessage(active, message);
-    return this.hostState.recordWorkerMessage(message, response);
+    const stored = this.serverState.readRunnerMessage(message);
+    if (stored !== undefined) {
+      return boundRunnerResponse(this.state, active.contentDigests, stored);
+    }
+    const response = await this.handleFreshRunnerMessage(active, message);
+    const recorded = this.serverState.recordRunnerMessage(message, response);
+    return boundRunnerResponse(this.state, active.contentDigests, recorded);
   }
 
-  private async handleFreshWorkerMessage(
+  private async handleFreshRunnerMessage(
     active: ActiveRun,
-    message: WorkerMessage,
-  ): Promise<WorkerResponse> {
-    if (message.operation === "worker.ready") {
+    message: WorkflowRunnerMessage,
+  ): Promise<WorkflowRunnerResponse> {
+    if (message.operation === "runner.ready") {
       if (
         !this.queue.verifyWorkflowRunClaim({ runId: message.runId, claimToken: active.claimToken })
       ) {
         active.claimLost = true;
         setImmediate(() => void active.supervisor.stop("claimLost"));
-        return workerResponse(message, "claimLost", undefined, "Run claim expired");
+        return runnerResponse(message, "claimLost", undefined, "Run claim expired");
       }
-      this.hostState.markWorkerReady(message.workerEpoch);
+      this.serverState.markRunnerReady(message.runnerEpoch);
       this.queue.markWorkflowRunRunning({ runId: message.runId, claimToken: active.claimToken });
       const revision = this.runStore.synchronizeRevision(message.runId);
       active.launchProgressRevision = revision;
       const current = this.queue.getWorkflowRun(message.runId);
       const candidateInteraction =
-        this.hostState.acceptedInteraction(message.runId) ??
-        this.hostState.validatingInteraction(message.runId);
-      const timedOutInteraction = this.hostState.timedOutInteraction(message.runId);
+        this.serverState.acceptedInteraction(message.runId) ??
+        this.serverState.validatingInteraction(message.runId);
+      const timedOutInteraction = this.serverState.timedOutInteraction(message.runId);
       const resumeInteractionAttemptId =
         candidateInteraction?.attemptId ?? timedOutInteraction?.attemptId;
       const record = current ?? active.record;
-      return workerResponse(
+      return runnerResponse(
         message,
         "accepted",
         {
-          command: workerRunCommand(record, resumeInteractionAttemptId),
+          command: runnerRunCommand(record, resumeInteractionAttemptId),
           originSessionId: record.originSessionId,
           stateDirectory: this.stateDirectory,
           ...(candidateInteraction === undefined ? {} : { candidateInteraction }),
@@ -3820,8 +3876,8 @@ export class WorkflowHost {
         revision,
       );
     }
-    if (message.operation === "worker.exiting") {
-      const payload = requireRecord(message.payload, "worker exit payload");
+    if (message.operation === "runner.exiting") {
+      const payload = requireRecord(message.payload, "runner exit payload");
       if (payload.status === "workflowLoadFailed") {
         active.workflowLoadFailure = requireString(payload.error, "workflow load error").slice(
           0,
@@ -3829,14 +3885,14 @@ export class WorkflowHost {
         );
       }
       active.exiting = true;
-      return workerResponse(message, "accepted", {});
+      return runnerResponse(message, "accepted", {});
     }
     if (message.operation === "process.register" || message.operation === "process.unregister") {
-      return this.handleWorkerProcessOperation(active, message);
+      return this.handleRunnerProcessOperation(active, message);
     }
     const currentRevision = runRevision(this.state, message.runId);
     if (message.expectedRevision !== currentRevision) {
-      return workerResponse(
+      return runnerResponse(
         message,
         "rejected",
         undefined,
@@ -3849,10 +3905,10 @@ export class WorkflowHost {
     ) {
       active.claimLost = true;
       setImmediate(() => void active.supervisor.stop("claimLost"));
-      return workerResponse(message, "claimLost", undefined, "Run claim expired");
+      return runnerResponse(message, "claimLost", undefined, "Run claim expired");
     }
     try {
-      const payload = requireRecord(message.payload, "worker payload");
+      const payload = requireRecord(message.payload, "runner payload");
       let result: unknown;
       switch (message.operation) {
         case "store.initializeRun":
@@ -3867,11 +3923,8 @@ export class WorkflowHost {
           await this.prepareInteractionResume(message.runId);
           result = await this.runStore.prepareRunResume(message.runId);
           break;
-        case "store.readRun":
-          result = this.runStore.readRun(
-            requireString(payload.runId, "runId"),
-            payload.options as never,
-          );
+        case "store.readRunState":
+          result = this.runStore.readRunState(requireString(payload.runId, "runId"));
           break;
         case "store.writeSnapshot": {
           const state = payload.state as WorkflowRunState;
@@ -3914,7 +3967,7 @@ export class WorkflowHost {
           const decision = payload.request as HumanDecisionRequest;
           result = await this.runStore.createHumanDecisionRequest(decision);
           if (active.record.originSessionId !== null) {
-            this.hostState.createInteractiveRequest({
+            this.serverState.createInteractiveRequest({
               requestId: decision.decisionId,
               runId: decision.runId,
               attemptId: decision.attemptId,
@@ -3944,6 +3997,14 @@ export class WorkflowHost {
             throw new Error("Run claim was lost during ambiguous-effect recovery");
           }
           break;
+        case "content.read":
+          result = readRunnerContentChunk(
+            this.state,
+            active.contentDigests,
+            requireString(payload.sha256, "runner content digest"),
+            requireNonNegativeInteger(payload.offset, "runner content offset"),
+          );
+          break;
         case "store.settleEffect": {
           const options = payload.options as {
             outcome?: unknown;
@@ -3962,16 +4023,16 @@ export class WorkflowHost {
           break;
         }
         case "interaction.accept":
-          result = this.acceptWorkerInteraction(message, payload);
+          result = this.acceptRunnerInteraction(message, payload);
           break;
         case "interaction.reject":
-          result = this.rejectWorkerInteraction(active, message, payload);
+          result = this.rejectRunnerInteraction(active, message, payload);
           break;
         case "notification.request":
-          result = this.enqueueWorkerNotification(active, message, payload);
+          result = this.enqueueRunnerNotification(active, message, payload);
           break;
         case "presentation.request":
-          result = this.requestWorkerPresentation(active, message, payload);
+          result = this.requestRunnerPresentation(active, message, payload);
           break;
         case "interaction.request": {
           result = this.parkForInteraction(active, message, payload);
@@ -3985,9 +4046,9 @@ export class WorkflowHost {
           break;
         }
         default:
-          return workerResponse(message, "rejected", undefined, "Unknown worker operation");
+          return runnerResponse(message, "rejected", undefined, "Unknown runner operation");
       }
-      return workerResponse(
+      return runnerResponse(
         message,
         "accepted",
         result === undefined ? null : (result as JsonValue),
@@ -3995,64 +4056,67 @@ export class WorkflowHost {
         runRevision(this.state, message.runId),
       );
     } catch (error) {
-      return workerResponse(message, "rejected", undefined, errorMessage(error));
+      return runnerResponse(message, "rejected", undefined, errorMessage(error));
     }
   }
 
-  private handleWorkerProcessOperation(active: ActiveRun, message: WorkerMessage): WorkerResponse {
+  private handleRunnerProcessOperation(
+    active: ActiveRun,
+    message: WorkflowRunnerMessage,
+  ): WorkflowRunnerResponse {
     if (
       message.operation === "process.register" &&
       !this.queue.verifyWorkflowRunClaim({ runId: message.runId, claimToken: active.claimToken })
     ) {
       active.claimLost = true;
       setImmediate(() => void active.supervisor.stop("claimLost"));
-      return workerResponse(message, "claimLost", undefined, "Run claim expired");
+      return runnerResponse(message, "claimLost", undefined, "Run claim expired");
     }
     try {
-      const payload = requireRecord(message.payload, "worker process payload");
+      const payload = requireRecord(message.payload, "runner process payload");
       const pid = requireNonNegativeInteger(payload.pid, "pid");
-      if (pid === 0) throw new Error("Worker process PID must be positive");
-      const owned = this.workerDescendants.get(message.workerEpoch);
+      if (pid === 0) throw new Error("Runner process PID must be positive");
+      const owned = this.runnerDescendants.get(message.runnerEpoch);
       if (message.operation === "process.unregister") {
         if (owned?.has(pid) !== true) {
-          throw new Error("Worker process is not registered to this worker epoch");
+          throw new Error("Runner process is not registered to this runner epoch");
         }
         this.registry.unregister(pid);
         owned.delete(pid);
-        if (owned.size === 0) this.workerDescendants.delete(message.workerEpoch);
-        return workerResponse(message, "accepted", { pid });
+        if (owned.size === 0) this.runnerDescendants.delete(message.runnerEpoch);
+        return runnerResponse(message, "accepted", { pid });
       }
-      if (active.workerPid === undefined || processParentPid(pid) !== active.workerPid) {
-        throw new Error("Worker process is not a direct child of the active worker");
+      if (active.runnerPid === undefined || processParentPid(pid) !== active.runnerPid) {
+        throw new Error("Runner process is not a direct child of the active runner");
       }
-      for (const [workerEpoch, pids] of this.workerDescendants) {
-        if (workerEpoch !== message.workerEpoch && pids.has(pid)) {
-          throw new Error("Worker process is already registered to another worker epoch");
+      for (const [runnerEpoch, pids] of this.runnerDescendants) {
+        if (runnerEpoch !== message.runnerEpoch && pids.has(pid)) {
+          throw new Error("Runner process is already registered to another runner epoch");
         }
       }
       this.registry.register(pid);
       const descendants = owned ?? new Set<number>();
       descendants.add(pid);
-      this.workerDescendants.set(message.workerEpoch, descendants);
-      return workerResponse(message, "accepted", { pid });
+      this.runnerDescendants.set(message.runnerEpoch, descendants);
+      return runnerResponse(message, "accepted", { pid });
     } catch (error) {
-      return workerResponse(message, "rejected", undefined, errorMessage(error));
+      return runnerResponse(message, "rejected", undefined, errorMessage(error));
     }
   }
 
-  private reapWorkerDescendants(workerEpoch: string): void {
-    const descendants = this.workerDescendants.get(workerEpoch);
+  private reapRunnerDescendants(runnerEpoch: string): void {
+    const descendants = this.runnerDescendants.get(runnerEpoch);
     if (descendants === undefined) return;
-    this.workerDescendants.delete(workerEpoch);
+    this.runnerDescendants.delete(runnerEpoch);
     for (const pid of descendants) this.registry.kill(pid);
   }
 
-  private acceptWorkerInteraction(
-    message: WorkerMessage,
+  private acceptRunnerInteraction(
+    message: WorkflowRunnerMessage,
     payload: Record<string, unknown>,
   ): InteractiveSubmissionRecord {
-    const candidate = this.requireWorkerInteraction(message, payload, true);
-    return this.hostState.finishInteractionValidation({
+    const candidate = this.requireRunnerInteraction(message, payload, true);
+    return this.serverState.finishInteractionValidation({
       requestId: candidate.requestId,
       submissionId: candidate.submissionId,
       accepted: true,
@@ -4060,12 +4124,12 @@ export class WorkflowHost {
     });
   }
 
-  private rejectWorkerInteraction(
+  private rejectRunnerInteraction(
     active: ActiveRun,
-    message: WorkerMessage,
+    message: WorkflowRunnerMessage,
     payload: Record<string, unknown>,
   ): InteractiveSubmissionRecord {
-    const candidate = this.requireWorkerInteraction(message, payload, false);
+    const candidate = this.requireRunnerInteraction(message, payload, false);
     return this.settleRejectedInteraction(
       active,
       candidate,
@@ -4073,14 +4137,14 @@ export class WorkflowHost {
     );
   }
 
-  private requireWorkerInteraction(
-    message: WorkerMessage,
+  private requireRunnerInteraction(
+    message: WorkflowRunnerMessage,
     payload: Record<string, unknown>,
     acceptSettled: boolean,
   ) {
     const candidate =
-      this.hostState.validatingInteraction(message.runId) ??
-      (acceptSettled ? this.hostState.acceptedInteraction(message.runId) : undefined);
+      this.serverState.validatingInteraction(message.runId) ??
+      (acceptSettled ? this.serverState.acceptedInteraction(message.runId) : undefined);
     if (
       candidate === undefined ||
       candidate.requestId !== requireString(payload.requestId, "interaction requestId") ||
@@ -4088,7 +4152,7 @@ export class WorkflowHost {
       candidate.attemptId !== message.attemptId ||
       candidate.attemptId !== requireString(payload.attemptId, "interaction attemptId")
     ) {
-      throw new Error("Interactive submission does not match the worker candidate");
+      throw new Error("Interactive submission does not match the runner candidate");
     }
     return candidate;
   }
@@ -4103,7 +4167,7 @@ export class WorkflowHost {
     error: string,
   ): InteractiveSubmissionRecord {
     const result = this.state.transaction(() => {
-      const submission = this.hostState.finishInteractionValidation({
+      const submission = this.serverState.finishInteractionValidation({
         requestId: candidate.requestId,
         submissionId: candidate.submissionId,
         accepted: false,
@@ -4142,9 +4206,9 @@ export class WorkflowHost {
     return result;
   }
 
-  private enqueueWorkerNotification(
+  private enqueueRunnerNotification(
     active: ActiveRun,
-    message: WorkerMessage,
+    message: WorkflowRunnerMessage,
     payload: Record<string, unknown>,
   ): JsonValue {
     if (active.record.originSessionId === null) {
@@ -4172,7 +4236,7 @@ export class WorkflowHost {
     const content = requireString(request.content, "notification.content");
     const notificationId = `notification-${message.runId}-${attemptId}-${notificationIndex}`;
     const workflowMessageId = workflowMessageIdFor("notification", notificationId, "initial");
-    const record = this.hostState.workflowMessages.create({
+    const record = this.serverState.workflowMessages.create({
       workflowMessageId,
       runId: message.runId,
       targetSessionId: active.record.originSessionId,
@@ -4193,9 +4257,9 @@ export class WorkflowHost {
     };
   }
 
-  private requestWorkerPresentation(
+  private requestRunnerPresentation(
     active: ActiveRun,
-    message: WorkerMessage,
+    message: WorkflowRunnerMessage,
     payload: Record<string, unknown>,
   ): JsonValue {
     if (active.record.originSessionId === null) {
@@ -4227,7 +4291,7 @@ export class WorkflowHost {
 
   private parkForInteraction(
     active: ActiveRun,
-    message: WorkerMessage,
+    message: WorkflowRunnerMessage,
     payload: Record<string, unknown>,
   ): JsonValue {
     if (active.record.originSessionId === null) {
@@ -4236,7 +4300,7 @@ export class WorkflowHost {
     const attemptId = requireString(payload.attemptId, "attemptId");
     const requestId = `interaction-${message.runId}-${attemptId}`;
     return this.state.transaction(() => {
-      const request = this.hostState.createInteractiveRequest({
+      const request = this.serverState.createInteractiveRequest({
         requestId,
         runId: message.runId,
         attemptId,
@@ -4272,9 +4336,9 @@ export class WorkflowHost {
   }
 
   private async prepareInteractionResume(runId: string): Promise<void> {
-    const accepted = this.hostState.acceptedInteraction(runId);
-    const candidate = accepted ?? this.hostState.validatingInteraction(runId);
-    const timedOut = this.hostState.timedOutInteraction(runId);
+    const accepted = this.serverState.acceptedInteraction(runId);
+    const candidate = accepted ?? this.serverState.validatingInteraction(runId);
+    const timedOut = this.serverState.timedOutInteraction(runId);
     if (candidate === undefined && timedOut === undefined) return;
     const loaded = this.runStore.readRun(runId);
     if (loaded === null) return;
@@ -4310,7 +4374,7 @@ export class WorkflowHost {
     const active = this.activeRuns.get(context.runId);
     if (active === undefined) return;
     if (context.event.type === "node_finished" && context.event.attemptId !== undefined) {
-      this.hostState.consumeAcceptedInteraction(
+      this.serverState.consumeAcceptedInteraction(
         context.runId,
         context.event.attemptId,
         context.now,
@@ -4327,10 +4391,10 @@ export class WorkflowHost {
       }
       return;
     }
-    this.completeControllerWorkflow(context.runId, context.state);
+    this.completeResourceManagerWorkflow(context.runId, context.state);
     if (context.state.status !== "waiting") {
-      this.hostState.workflowMessages.settleOpenTurnsForRun(context.runId, "lost", context.now);
-      this.hostState.workflowMessages.cancelPendingForRun(
+      this.serverState.workflowMessages.settleOpenTurnsForRun(context.runId, "lost", context.now);
+      this.serverState.workflowMessages.cancelPendingForRun(
         context.runId,
         context.now,
         context.state.status === "completed" ? ["step", "decision"] : undefined,
@@ -4435,7 +4499,7 @@ export class WorkflowHost {
       "Workflow result:",
       canonicalJson({ ...terminalFacts, terminalFingerprint }),
     ].join("\n");
-    this.hostState.workflowMessages.create({
+    this.serverState.workflowMessages.create({
       workflowMessageId,
       runId,
       targetSessionId: queue.originSessionId,
@@ -4488,7 +4552,8 @@ export class WorkflowHost {
   private terminalWorkflowMessageMissing(runId: string): boolean {
     return (
       this.terminalWorkflowMessageRequired(runId) &&
-      this.hostState.workflowMessages.latestForSource("terminal", `terminal:${runId}`) === undefined
+      this.serverState.workflowMessages.latestForSource("terminal", `terminal:${runId}`) ===
+        undefined
     );
   }
 
@@ -4562,10 +4627,10 @@ export class WorkflowHost {
     });
   }
 
-  private completeControllerWorkflow(runId: string, state: WorkflowRunState): void {
+  private completeResourceManagerWorkflow(runId: string, state: WorkflowRunState): void {
     const row = this.state.connection
       .prepare(
-        `SELECT w.request_id AS requestId, c.controller_name AS controller,
+        `SELECT w.request_id AS requestId, c.controller_name AS resourceManager,
                 c.resource_key AS resourceKey, p.canonical_path AS projectPath
          FROM controller_workflows w
          JOIN controller_resources c ON c.controller_resource_id = w.controller_resource_id
@@ -4575,20 +4640,20 @@ export class WorkflowHost {
       .get(runId) as
       | {
           requestId?: unknown;
-          controller?: unknown;
+          resourceManager?: unknown;
           resourceKey?: unknown;
           projectPath?: unknown;
         }
       | undefined;
     if (
       typeof row?.requestId !== "string" ||
-      typeof row.controller !== "string" ||
+      typeof row.resourceManager !== "string" ||
       typeof row.resourceKey !== "string" ||
       typeof row.projectPath !== "string"
     ) {
       return;
     }
-    const store = new SqliteControllerStore(this.databasePath, {
+    const store = new SqliteResourceManagerStore(this.databasePath, {
       state: this.state,
       projectPath: row.projectPath,
     });
@@ -4603,7 +4668,7 @@ export class WorkflowHost {
       runId,
       ...(state.error === undefined ? {} : { error: state.error }),
     });
-    store.enqueue({ controller: row.controller, key: row.resourceKey });
+    store.enqueue({ resourceManager: row.resourceManager, key: row.resourceKey });
   }
 
   private commitActivePause(active: ActiveRun): void {
@@ -4623,7 +4688,7 @@ export class WorkflowHost {
     });
   }
 
-  private async recoverWorkerExit(active: ActiveRun, outcome: string): Promise<void> {
+  private async recoverRunnerExit(active: ActiveRun, outcome: string): Promise<void> {
     if (
       !this.queue.verifyWorkflowRunClaim({
         runId: active.record.runId,
@@ -4646,12 +4711,12 @@ export class WorkflowHost {
       this.log(`run ${active.record.runId} parked for ambiguous effect recovery`);
       return;
     }
-    const validating = this.hostState.validatingInteraction(active.record.runId);
+    const validating = this.serverState.validatingInteraction(active.record.runId);
     if (validating !== undefined) {
       this.settleRejectedInteraction(
         active,
         validating,
-        `Workflow worker ${outcome} before it completed interaction validation`,
+        `Workflow runner ${outcome} before it completed interaction validation`,
       );
       this.log(`run ${active.record.runId} rejected an interrupted interaction validation`);
       return;
@@ -4668,7 +4733,7 @@ export class WorkflowHost {
         this.tryEnsureTerminalWorkflowMessage(active.record.runId, Date.now(), {
           status: "failed",
           error: active.workflowLoadFailure,
-          statusDetail: "The supervised worker could not load the saved workflow source.",
+          statusDetail: "The supervised runner could not load the saved workflow source.",
         });
         this.log(`run ${active.record.runId} failed because its workflow source could not load`);
       }
@@ -4676,24 +4741,24 @@ export class WorkflowHost {
     }
     const currentProgressRevision = runRevision(this.state, active.record.runId);
     if (currentProgressRevision <= active.launchProgressRevision) {
-      const detail = `Workflow worker ${outcome} before it committed workflow progress`;
+      const detail = `Workflow runner ${outcome} before it committed workflow progress`;
       this.blockedRuns.add(active.record.runId);
-      this.queue.parkWorkflowRunForWorkerNoProgress({
+      this.queue.parkWorkflowRunForRunnerNoProgress({
         runId: active.record.runId,
         claimToken: active.claimToken,
         detail,
       });
-      this.log(`run ${active.record.runId} parked after a worker made no progress`);
+      this.log(`run ${active.record.runId} parked after a runner made no progress`);
       return;
     }
     this.queue.parkWorkflowRun({ runId: active.record.runId, claimToken: active.claimToken });
-    this.log(`run ${active.record.runId} parked after worker ${outcome}`);
+    this.log(`run ${active.record.runId} parked after runner ${outcome}`);
   }
 
   private releaseLock(): void {
     try {
       const current = JSON.parse(fs.readFileSync(this.lockPath, "utf8")) as unknown;
-      if (isLockRecord(current) && current.hostId === this.hostId) fs.rmSync(this.lockPath);
+      if (isLockRecord(current) && current.serverId === this.serverId) fs.rmSync(this.lockPath);
     } catch {
       // The lock is already gone.
     }
@@ -4795,18 +4860,18 @@ function channelEventPayload(message: ChannelAdapterMessage): JsonValue {
   return payload as unknown as JsonValue;
 }
 
-function acquireHostLock(
+function acquireServerLock(
   lockPath: string,
-  record: { pid: number; startIdentity: string; hostId: string },
+  record: { pid: number; startIdentity: string; serverId: string },
 ): void {
   try {
     const existing = JSON.parse(fs.readFileSync(lockPath, "utf8")) as unknown;
     if (isLockRecord(existing) && matchesProcessIdentity(existing)) {
-      throw new Error(`A workflow host is already running with PID ${existing.pid}`);
+      throw new Error(`A workflow server is already running with PID ${existing.pid}`);
     }
     fs.rmSync(lockPath, { force: true });
   } catch (error) {
-    if (error instanceof Error && error.message.startsWith("A workflow host is already"))
+    if (error instanceof Error && error.message.startsWith("A workflow server is already"))
       throw error;
   }
   fs.writeFileSync(
@@ -4816,10 +4881,10 @@ function acquireHostLock(
   );
 }
 
-function workerRunCommand(
+function runnerRunCommand(
   record: WorkflowRunQueueRecord,
   resumeInteractionAttemptId: string | undefined,
-): WorkerRunCommand {
+): WorkflowRunnerCommand {
   if (record.initialized) {
     return {
       kind: "resume",
@@ -4848,13 +4913,13 @@ function workerRunCommand(
   return { kind: "start", input };
 }
 
-function workerResponse(
-  message: WorkerMessage,
-  outcome: WorkerResponse["outcome"],
+function runnerResponse(
+  message: WorkflowRunnerMessage,
+  outcome: WorkflowRunnerResponse["outcome"],
   result?: JsonValue,
   error?: string,
   revision?: number,
-): WorkerResponse {
+): WorkflowRunnerResponse {
   return {
     schema: "pi-workflows.worker-response.v1",
     messageId: message.messageId,
@@ -4865,12 +4930,12 @@ function workerResponse(
   };
 }
 
-function controllerWorkerResponse(
-  message: ControllerWorkerMessage,
-  outcome: ControllerWorkerResponse["outcome"],
+function resourceRunnerResponse(
+  message: ResourceRunnerMessage,
+  outcome: ResourceRunnerResponse["outcome"],
   result?: JsonValue,
   error?: string,
-): ControllerWorkerResponse {
+): ResourceRunnerResponse {
   return {
     schema: "pi-workflows.controller-worker-response.v1",
     messageId: message.messageId,
@@ -4880,7 +4945,7 @@ function controllerWorkerResponse(
   };
 }
 
-function controllerWorkflowResult(record: WorkflowRunQueueRecord): WorkflowSchedulerResult {
+function resourceManagerWorkflowResult(record: WorkflowRunQueueRecord): WorkflowSchedulerResult {
   switch (record.status) {
     case "queued":
     case "starting":
@@ -4921,19 +4986,19 @@ function hasUncertainEffect(state: StateDatabase, runId: string): boolean {
   return row !== undefined;
 }
 
-function controllerPathAllowed(
+function resourceManagerPathAllowed(
   projectPath: string,
-  controllerName: string,
-  controllerPath: string,
+  resourceManagerName: string,
+  resourceManagerPath: string,
 ): boolean {
   if (
-    controllerFileStem(controllerPath) !== controllerName ||
-    !/\.controller\.(?:ts|js|mts|mjs)$/u.test(controllerPath)
+    resourceManagerFileStem(resourceManagerPath) !== resourceManagerName ||
+    !/\.resource-manager\.(?:ts|js|mts|mjs)$/u.test(resourceManagerPath)
   ) {
     return false;
   }
-  return controllerSearchDirs({ cwd: projectPath }).some(
-    ({ dir }) => path.dirname(controllerPath) === path.resolve(dir),
+  return resourceManagerSearchDirs({ cwd: projectPath }).some(
+    ({ dir }) => path.dirname(resourceManagerPath) === path.resolve(dir),
   );
 }
 
@@ -4964,7 +5029,7 @@ function waitForSocketDrain(socket: Socket): Promise<void> {
   });
 }
 
-function hostDelay(ms: number): Promise<void> {
+function serverDelay(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
@@ -5210,13 +5275,13 @@ function runtimePackageVersion(): string {
 
 function isLockRecord(
   value: unknown,
-): value is { schema: string; pid: number; startIdentity: string; hostId: string } {
+): value is { schema: string; pid: number; startIdentity: string; serverId: string } {
   return (
     typeof value === "object" &&
     value !== null &&
     (value as { schema?: unknown }).schema === "pi-workflows.host-lock.v1" &&
     typeof (value as { pid?: unknown }).pid === "number" &&
     typeof (value as { startIdentity?: unknown }).startIdentity === "string" &&
-    typeof (value as { hostId?: unknown }).hostId === "string"
+    typeof (value as { serverId?: unknown }).serverId === "string"
   );
 }