@osolmaz/pi-workflows 0.16.2 → 0.16.4

package/dist/{host/runner.js → server/server.js}

@@ -7,11 +7,11 @@ import { channelResponse, } from "../channels/protocol.js";
 import { WorkflowClient } from "../client/client.js";
 import { CLIENT_PROTOCOL_SCHEMA, encodeProtocolLine, clientSocketPath, NdjsonFrameDecoder, parseClientRequest, } from "../client/protocol.js";
 import { WORKFLOW_TURN_REPORT_RECEIPT_SCHEMA, } from "../client/view.js";
-import { applyStatusPatch } from "../controllers/conditions.js";
-import { ResourceConflictError } from "../controllers/errors.js";
-import { controllerFileStem, controllerSearchDirs, discoverControllers, } from "../controllers/loader.js";
-import { SqliteControllerStore } from "../controllers/sqlite.js";
-import { ControllerWorkflowCoordinator, } from "../controllers/workflows.js";
+import { applyStatusPatch } from "../resource-managers/conditions.js";
+import { ManagedResourceConflictError } from "../resource-managers/errors.js";
+import { resourceManagerFileStem, resourceManagerSearchDirs, discoverResourceManagers, } from "../resource-managers/loader.js";
+import { SqliteResourceManagerStore, } from "../resource-managers/sqlite.js";
+import { ResourceManagerWorkflowCoordinator, } from "../resource-managers/workflows.js";
 import { StateDatabase, workflowStatePath } from "../state/database.js";
 import { canonicalJson } from "../state/json.js";
 import { resourceIdFor } from "../state/mutation.js";
@@ -27,31 +27,32 @@ import { validateWorkflowUpdate } from "../workflows/updates.js";
 import { notificationWorkflowMessageContent, terminalWorkflowMessageContent, } from "../workflows/workflow-message-content.js";
 import { ChannelEffectStore, channelEffectAttemptId, channelEffectId, } from "./channel-effects.js";
 import { ChannelAdapterSupervisor } from "./channel-supervisor.js";
-import { ControllerWorkerSupervisor } from "./controller-worker-supervisor.js";
-import { HostProcessRegistry, matchesProcessIdentity, processParentPid, processStartIdentity, } from "./processes.js";
-import { HostStateStore, } from "./state.js";
-import { HostViewStore, WORKFLOW_PAGE_KINDS } from "./view.js";
-import { WorkflowWorkerSupervisor } from "./worker-supervisor.js";
-const HOST_LEASE_MS = 30_000;
-const HOST_RENEW_MS = 10_000;
+import { ServerProcessRegistry, matchesProcessIdentity, processParentPid, processStartIdentity, } from "./processes.js";
+import { ResourceRunnerSupervisor } from "./resource-runner-supervisor.js";
+import { ServerStateStore, } from "./state.js";
+import { ServerViewStore, WORKFLOW_PAGE_KINDS } from "./view.js";
+import { boundRunnerResponse, readRunnerContentChunk } from "./workflow-runner-content.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;
-/** Global package-owned host. It writes state and supervises code-only workers. */
-export class WorkflowHost {
+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;
+/** Global package-owned server. It writes state and supervises code-only runners. */
+export class WorkflowServer {
     options;
-    hostId;
+    serverId;
     databasePath;
     stateDirectory;
     socketPath;
     lockPath;
     state;
-    hostState;
+    serverState;
     queue;
     decisions;
     channelEffects;
@@ -59,8 +60,8 @@ export class WorkflowHost {
     views;
     registry;
     activeRuns = new Map();
-    workerDescendants = new Map();
-    activeControllers = new Map();
+    runnerDescendants = new Map();
+    activeResourceManagers = new Map();
     activeChannels = new Map();
     controlClaims = new Map();
     activationTasks = new Map();
@@ -80,7 +81,7 @@ export class WorkflowHost {
     viewTimer = null;
     stopping = false;
     started = false;
-    controllerPollActive = false;
+    resourceManagerPollActive = false;
     decisionTimeoutActive = false;
     decisionChannelConfig = null;
     decisionChannelError = null;
@@ -88,14 +89,17 @@ export class WorkflowHost {
     nextTerminalMessageReconciliationAt = 0;
     constructor(options = {}) {
         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) => {
@@ -111,13 +115,13 @@ 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.state, this.queue, this.hostState, this.runStore, (runId) => this.activeRuns.has(runId), (targetSessionId) => {
+        this.views = new ServerViewStore(this.state, this.queue, this.serverState, this.runStore, (runId) => this.activeRuns.has(runId), (targetSessionId) => {
             const coordinator = this.sessionCoordinators.get(targetSessionId);
             return coordinator?.branchReported === true && coordinator.modelTurnActive;
         });
-        this.registry = options.registry ?? new HostProcessRegistry(this.stateDirectory);
+        this.registry = options.registry ?? new ServerProcessRegistry(this.stateDirectory);
     }
     get endpoint() {
         return this.socketPath;
@@ -132,23 +136,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);
-            const previousHeartbeatAt = previousHost.heartbeatAt === null ? undefined : Date.parse(previousHost.heartbeatAt);
-            this.hostState.recoverInactiveModelTurns(previousHeartbeatAt);
+            this.recoverPreviousServer(previousServer.serverId, this.claim.epoch);
+            const previousHeartbeatAt = previousServer.heartbeatAt === null ? undefined : Date.parse(previousServer.heartbeatAt);
+            this.serverState.recoverInactiveModelTurns(previousHeartbeatAt);
             this.discoverMissingTerminalWorkflowMessages();
             this.reconcilePendingTerminalWorkflowMessages(Date.now(), true);
             await this.listen();
@@ -158,7 +162,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)}`);
             });
@@ -169,7 +173,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.
@@ -209,11 +213,11 @@ export class WorkflowHost {
             await active.supervisor.stop("orphaned");
             this.queue.parkWorkflowRun({ runId: active.record.runId, claimToken: active.claimToken });
         }));
-        await Promise.allSettled([...this.activeControllers.values()].map(async (active) => {
+        await Promise.allSettled([...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" }, new Date().toISOString());
+                active.store.requeueClaim(active.claim, { availableAt: new Date().toISOString(), error: "Workflow server stopped" }, new Date().toISOString());
             }
         }));
         await Promise.allSettled([...this.activeChannels.values()].map(async (active) => {
@@ -225,14 +229,14 @@ export class WorkflowHost {
         await Promise.allSettled(this.maintenanceCommands.values());
         this.registry.killAll();
         if (this.claim !== null)
-            this.hostState.releaseHost(this.claim);
+            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;
     }
@@ -254,19 +258,19 @@ export class WorkflowHost {
         await closed;
         this.sockets.clear();
     }
-    recoverPreviousHost(previousHostId, hostEpoch) {
-        if (previousHostId === null || previousHostId === this.hostId)
+    recoverPreviousServer(previousServerId, serverEpoch) {
+        if (previousServerId === null || previousServerId === this.serverId)
             return;
         const now = Date.now();
         this.state.transaction(() => {
             this.state.connection
                 .prepare(`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);
         });
     }
     startTimers() {
@@ -274,7 +278,7 @@ export class WorkflowHost {
             try {
                 if (this.claim === null)
                     return;
-                this.claim = this.hostState.renewHost(this.claim, this.options.hostLeaseMs ?? HOST_LEASE_MS);
+                this.claim = this.serverState.renewServer(this.claim, this.options.serverLeaseMs ?? SERVER_LEASE_MS);
                 for (const active of this.activeRuns.values()) {
                     if (active.control !== undefined || active.exiting)
                         continue;
@@ -289,16 +293,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?.();
@@ -393,7 +397,7 @@ export class WorkflowHost {
         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;
         }
@@ -437,7 +441,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,
@@ -530,7 +534,7 @@ export class WorkflowHost {
                             before,
                             apply,
                             ...(backupPath === undefined ? {} : { backupPath }),
-                        });
+                        }, () => this.activeRunnerContentHashes());
                         return toJsonValue(report);
                     });
                 default:
@@ -542,18 +546,18 @@ export class WorkflowHost {
         }
     }
     async executeMaintenanceCommand(request, operation) {
-        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) {
-            return clientResponse(request.requestId, "unavailable", undefined, "Workflow host is stopping");
+            return clientResponse(request.requestId, "unavailable", undefined, "Workflow server is stopping");
         }
         const key = canonicalJson([request.clientId, request.idempotencyKey]);
         const active = this.maintenanceCommands.get(key);
         if (active !== undefined) {
             await active;
-            return (this.hostState.adoptCommand(request) ??
+            return (this.serverState.adoptCommand(request) ??
                 clientResponse(request.requestId, "unavailable", undefined, "Workflow maintenance command did not complete durably"));
         }
         const execution = (async () => {
@@ -564,7 +568,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 {
@@ -625,16 +629,16 @@ export class WorkflowHost {
     reportWorkflowBranch(connection, request) {
         const report = parseWorkflowBranchReport(request.payload);
         const coordinator = this.requireSessionCoordinator(connection, 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();
         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(report.targetSessionId)) {
+                for (const turn of this.serverState.workflowMessages.openTurnsForSession(report.targetSessionId)) {
                     reconciledRunIds.add(turn.runId);
                     this.applyWorkflowTurnEnd({
                         state: "ended",
@@ -648,13 +652,13 @@ 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);
                     if (sourceMessages.some((message) => message.status === "sent") &&
                         !sourceMessages.some((message) => branchIds.has(message.workflowMessageId))) {
-                        this.hostState.workflowMessages.cancelPendingForSource(interaction.requestId);
-                        this.hostState.ensureInteractionMessage(interaction, interaction.kind === "decision" ? "initial" : "resumed");
+                        this.serverState.workflowMessages.cancelPendingForSource(interaction.requestId);
+                        this.serverState.ensureInteractionMessage(interaction, interaction.kind === "decision" ? "initial" : "resumed");
                     }
                 }
             }
@@ -679,7 +683,7 @@ export class WorkflowHost {
         }
         let outcome = "accepted";
         const receipt = this.state.transaction(() => {
-            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";
@@ -701,7 +705,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);
             }
@@ -715,7 +719,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" &&
                 (queuedRun === undefined || ["done", "failed", "cancelled"].includes(queuedRun.status))) {
@@ -724,11 +728,11 @@ 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);
-                return workflowTurnReceipt("active", this.hostState.workflowMessages.startTurn({ ...report, now }));
+                this.serverState.beginInteractionModelTurn(message.sourceId, now);
+                this.serverState.workflowMessages.cancelPendingForSource(message.sourceId, "step", now);
+                return workflowTurnReceipt("active", 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();
@@ -738,27 +742,27 @@ export class WorkflowHost {
         return clientResponse(request.requestId, outcome, receipt);
     }
     applyWorkflowTurnEnd(report) {
-        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)
+        if (this.serverState.validatingInteraction(report.runId) !== undefined)
             return turn;
         const changed = this.state.connection
             .prepare(`UPDATE interactive_requests
@@ -768,14 +772,14 @@ 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 = ?
          WHERE request_id = ? AND status = 'pending'`)
@@ -854,9 +858,9 @@ export class WorkflowHost {
         const submissionId = requireString(startedReceipt.submissionId, "submissionId");
         for (;;) {
             if (this.stopping) {
-                return clientResponse(request.requestId, "unavailable", undefined, "Workflow host stopped while validating the submission");
+                return clientResponse(request.requestId, "unavailable", undefined, "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, started.outcome, submission.receipt ?? { requestId, submissionId });
             }
@@ -867,7 +871,7 @@ export class WorkflowHost {
                     : "Workflow step output failed validation";
                 return clientResponse(request.requestId, "rejected", receipt, detail);
             }
-            await hostDelay(25);
+            await serverDelay(25);
         }
     }
     handleRequest(request, connection) {
@@ -877,13 +881,13 @@ export class WorkflowHost {
                 type: "response",
                 requestId: request.requestId,
                 outcome: "unavailable",
-                error: "Workflow host is stopping",
+                error: "Workflow server is stopping",
             };
         }
         const afterCommit = [];
         let response;
         try {
-            response = this.hostState.executeCommand(request, this.claim.epoch, () => this.executeOperation(request, afterCommit, connection));
+            response = this.serverState.executeCommand(request, this.claim.epoch, () => this.executeOperation(request, afterCommit, connection));
         }
         catch (error) {
             response = {
@@ -900,9 +904,9 @@ export class WorkflowHost {
     }
     executeOperation(request, afterCommit, connection) {
         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":
@@ -962,7 +966,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.",
                             },
                         };
                     }
@@ -994,7 +998,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.",
                         },
                     };
                 }
@@ -1016,12 +1020,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) {
@@ -1053,7 +1057,7 @@ export class WorkflowHost {
                 const token = randomUUID();
                 const claimed = this.queue.claimWorkflowRun({
                     runId,
-                    runnerId: this.hostId,
+                    runnerId: this.serverId,
                     claimToken: token,
                     leaseMs: this.runClaimLeaseMs,
                 });
@@ -1090,12 +1094,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":
@@ -1142,7 +1146,7 @@ export class WorkflowHost {
         }
         const payload = requireRecord(request.payload, "run.restart payload");
         const workflowMessageId = requireString(payload.workflowMessageId, "workflowMessageId");
-        const terminal = this.hostState.workflowMessages.latestForSource("terminal", `terminal:${sourceRunId}`);
+        const terminal = this.serverState.workflowMessages.latestForSource("terminal", `terminal:${sourceRunId}`);
         if (terminal === undefined ||
             terminal.workflowMessageId !== workflowMessageId ||
             terminal.targetSessionId !== session.targetSessionId ||
@@ -1153,7 +1157,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" };
         }
@@ -1199,7 +1203,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,
         });
@@ -1212,7 +1216,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,
@@ -1399,56 +1403,68 @@ export class WorkflowHost {
             ...(entrySequence === undefined ? {} : { entrySequence }),
         };
     }
-    executeControllerOperation(request) {
-        const payload = requireRecord(request.payload, "controller payload");
+    executeResourceManagerOperation(request) {
+        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() };
         }
-        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 };
         }
-        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;
             const initialStatus = payload.initialStatus;
-            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 };
         }
         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 };
         }
@@ -1457,20 +1473,20 @@ export class WorkflowHost {
         return { outcome: "accepted", receipt: deleting };
     }
     statusReceipt() {
-        const host = this.hostState.hostStatus();
+        const serverStatus = this.serverState.serverStatus();
         const count = (sql, ...params) => {
             const row = this.state.connection.prepare(sql).get(...params);
             return typeof row?.count === "number" ? row.count : 0;
         };
         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("SELECT COUNT(*) AS count FROM run_queue WHERE status IN ('starting', 'running')"),
@@ -1483,8 +1499,8 @@ export class WorkflowHost {
            AND l.owner_id IS NOT NULL AND l.expires_at <= ?`, now),
             pendingInteractions: count("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
          WHERE NOT (
@@ -1497,6 +1513,14 @@ export class WorkflowHost {
          )`),
         };
     }
+    activeRunnerContentHashes() {
+        const digests = new Set();
+        for (const active of this.activeRuns.values()) {
+            for (const digest of active.contentDigests)
+                digests.add(digest);
+        }
+        return [...digests].map((digest) => Buffer.from(digest, "hex"));
+    }
     stateStatusReceipt() {
         const count = (sql, ...params) => {
             const row = this.state.connection.prepare(sql).get(...params);
@@ -1508,7 +1532,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("SELECT COUNT(*) AS count FROM interactive_requests WHERE status = 'pending'"),
@@ -1576,7 +1600,7 @@ export class WorkflowHost {
     answerDecision(command, afterCommit) {
         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}` };
         }
@@ -1611,7 +1635,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,
@@ -1655,7 +1679,7 @@ export class WorkflowHost {
     }
     prepareContinuation(options, afterCommit) {
         const token = randomUUID();
-        const scoped = new SqliteControllerStore(this.databasePath, {
+        const scoped = new SqliteResourceManagerStore(this.databasePath, {
             state: this.state,
             projectPath: options.projectPath,
         });
@@ -1668,7 +1692,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,
@@ -1691,7 +1715,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,
         });
@@ -1704,7 +1728,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,
@@ -1729,7 +1753,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}` };
         }
@@ -1754,7 +1778,7 @@ export class WorkflowHost {
         const token = randomUUID();
         const claimed = this.queue.claimWorkflowRunForControl({
             runId,
-            runnerId: this.hostId,
+            runnerId: this.serverId,
             claimToken: token,
             leaseMs: this.runClaimLeaseMs,
         });
@@ -1785,7 +1809,7 @@ export class WorkflowHost {
     submitInteraction(request) {
         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}` };
         }
@@ -1801,7 +1825,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,
@@ -1825,7 +1849,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,
             });
@@ -1863,7 +1887,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);
@@ -1878,13 +1902,13 @@ export class WorkflowHost {
             throw new Error("Channel recovery action must be confirm or retry");
         }
         if (this.claim === null)
-            throw new Error("Workflow host claim is unavailable");
+            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);
@@ -2102,9 +2126,9 @@ export class WorkflowHost {
         if (config === undefined ||
             !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;
             return request.decisionId === message.decisionId;
         });
@@ -2138,7 +2162,7 @@ export class WorkflowHost {
             setImmediate(effect);
     }
     async nextChannelCommand(active) {
-        const interactions = this.hostState.listPendingDecisionInteractions();
+        const interactions = this.serverState.listPendingDecisionInteractions();
         for (const interaction of interactions) {
             const request = interaction.contract;
             if (!audienceChannels(this.decisionChannelConfig, request.audience).includes(active.channelId)) {
@@ -2214,7 +2238,7 @@ export class WorkflowHost {
     }
     ensureApplyingChannelEffect(active, request, purpose) {
         if (this.claim === null)
-            throw new Error("Workflow host claim is unavailable");
+            throw new Error("Workflow server claim is unavailable");
         return this.state.transaction(() => {
             const effect = this.channelEffects.ensureApplying({
                 channelResourceId: active.resourceId,
@@ -2223,7 +2247,7 @@ export class WorkflowHost {
                 decisionId: request.decisionId,
                 purpose,
                 request,
-                ownerId: this.hostId,
+                ownerId: this.serverId,
                 leaseGeneration: this.claim?.epoch ?? 0,
                 maxAutomaticAttempts: 3,
             });
@@ -2323,14 +2347,14 @@ export class WorkflowHost {
         }
         return row.revision;
     }
-    async claimControllerOne() {
+    async claimResourceManagerOne() {
         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(`SELECT DISTINCT p.canonical_path AS projectPath
@@ -2344,84 +2368,87 @@ export class WorkflowHost {
             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;
         }
     }
-    async activateController(projectPath, definitionPath, store, claim, resource) {
+    async activateResourceManager(projectPath, definitionPath, store, claim, resource) {
         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 = {
             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;
-        const supervisor = new ControllerWorkerSupervisor(envelope, {
+        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,
@@ -2435,9 +2462,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",
@@ -2447,36 +2474,36 @@ export class WorkflowHost {
             await supervisor.start();
             const result = await supervisor.wait();
             if (result.outcome !== "exited" && !active.settled) {
-                this.finishControllerFailure(active, result.diagnostic ?? `Controller worker ${result.outcome}`);
+                this.finishResourceManagerFailure(active, result.diagnostic ?? `Resource runner ${result.outcome}`);
             }
         }
         catch (error) {
             await supervisor.stop("crashed");
             if (!active.settled)
-                this.finishControllerFailure(active, errorMessage(error));
+                this.finishResourceManagerFailure(active, errorMessage(error));
         }
         finally {
             clearInterval(renewTimer);
-            this.activeControllers.delete(key);
+            this.activeResourceManagers.delete(key);
             if (!this.stopping)
-                setImmediate(() => void this.claimControllerOne());
+                setImmediate(() => void this.claimResourceManagerOne());
         }
     }
-    async handleControllerWorkerMessage(active, message) {
-        const current = this.activeControllers.get(active.key);
+    async handleResourceRunnerMessage(active, message) {
+        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(message, "claimLost", undefined, "Controller worker is stale");
+            return resourceRunnerResponse(message, "claimLost", undefined, "Resource runner is stale");
         }
-        if (!active.store.renewClaim(active.claim, CONTROLLER_CLAIM_LEASE_MS)) {
-            return controllerWorkerResponse(message, "claimLost", undefined, "Controller claim expired");
+        if (!active.store.renewClaim(active.claim, RESOURCE_MANAGER_CLAIM_LEASE_MS)) {
+            return resourceRunnerResponse(message, "claimLost", undefined, "ResourceManager 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"),
@@ -2486,12 +2513,12 @@ export class WorkflowHost {
                         kind: requireString(payload.kind, "kind"),
                         requestFingerprint: requireString(payload.requestFingerprint, "requestFingerprint"),
                     });
-                    return controllerWorkerResponse(message, "accepted", reservation);
+                    return resourceRunnerResponse(message, "accepted", reservation);
                 }
                 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,
@@ -2504,19 +2531,19 @@ 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);
+                    return resourceRunnerResponse(message, "accepted", record);
                 }
                 case "workflow.ensure":
                 case "workflow.changeSettings":
                 case "workflow.queueFollowUp":
                 case "workflow.removeFollowUp": {
-                    const workflows = new ControllerWorkflowCoordinator(active.store, this.controllerWorkflowScheduler(active)).forResource(active.resource, active.claim, new AbortController().signal);
+                    const workflows = new ResourceManagerWorkflowCoordinator(active.store, this.resourceManagerWorkflowScheduler(active)).forResource(active.resource, active.claim, new AbortController().signal);
                     const result = message.operation === "workflow.ensure"
                         ? await workflows.ensure(payload)
                         : message.operation === "workflow.changeSettings"
@@ -2524,34 +2551,34 @@ export class WorkflowHost {
                             : message.operation === "workflow.queueFollowUp"
                                 ? await workflows.queueFollowUp(payload)
                                 : await workflows.removeFollowUp(payload);
-                    return controllerWorkerResponse(message, "accepted", result);
+                    return resourceRunnerResponse(message, "accepted", result);
                 }
-                case "worker.finished":
-                    this.finishControllerSuccess(active, message.payload);
-                    return controllerWorkerResponse(message, "accepted", {});
-                case "worker.failed":
-                    this.finishControllerFailure(active, requireString(payload.error, "error"));
-                    return controllerWorkerResponse(message, "accepted", {});
+                case "runner.finished":
+                    this.finishResourceManagerSuccess(active, message.payload);
+                    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));
         }
     }
-    controllerWorkflowScheduler(active) {
+    resourceManagerWorkflowScheduler(active) {
         return {
-            ensure: async (request, _signal, _onComplete) => await this.ensureControllerWorkflow(active, request),
-            changeSettings: async (request) => await this.changeControllerWorkflowSettings(active, request),
+            ensure: async (request, _signal, _onComplete) => await this.ensureResourceManagerWorkflow(active, request),
+            changeSettings: async (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,
                 });
@@ -2567,7 +2594,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 {
@@ -2580,14 +2607,14 @@ export class WorkflowHost {
             },
         };
     }
-    async changeControllerWorkflowSettings(_active, request) {
+    async changeResourceManagerWorkflowSettings(_active, request) {
         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) {
@@ -2614,7 +2641,7 @@ export class WorkflowHost {
             mountPath: scope.mountPath,
             current: scope.settings,
             patch: request.patch,
-            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");
@@ -2635,7 +2662,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,
         });
@@ -2646,10 +2673,10 @@ export class WorkflowHost {
             adopted: result.adopted,
         };
     }
-    async ensureControllerWorkflow(active, request) {
+    async ensureResourceManagerWorkflow(active, request) {
         const existing = this.queue.getWorkflowRun(request.runId);
         if (existing !== undefined)
-            return controllerWorkflowResult(existing);
+            return resourceManagerWorkflowResult(existing);
         const resolver = new WorkflowClient({
             databasePath: this.databasePath,
             ...(this.options.env === undefined ? {} : { env: this.options.env }),
@@ -2659,7 +2686,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,
         });
@@ -2672,23 +2699,23 @@ 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);
     }
-    finishControllerSuccess(active, result) {
+    finishResourceManagerSuccess(active, result) {
         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, active.resource.metadata.generation, now.toISOString());
         try {
             const updated = active.store.updateStatus({
@@ -2735,7 +2762,7 @@ export class WorkflowHost {
             active.settled = true;
         }
         catch (error) {
-            if (error instanceof ResourceConflictError) {
+            if (error instanceof ManagedResourceConflictError) {
                 active.store.recordEvent({
                     ...ref,
                     claim: active.claim,
@@ -2749,14 +2776,14 @@ export class WorkflowHost {
             throw error;
         }
     }
-    finishControllerFailure(active, failure) {
+    finishResourceManagerFailure(active, failure) {
         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",
@@ -2780,7 +2807,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 }) => interaction?.kind === "decision" &&
                 interaction.runId === request.runId &&
@@ -2796,7 +2823,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,
             });
@@ -2809,7 +2836,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,
@@ -2850,7 +2877,7 @@ export class WorkflowHost {
         const activeSessionIds = new Set([...this.sessionCoordinators.entries()]
             .filter(([, coordinator]) => coordinator.branchReported && coordinator.modelTurnActive)
             .map(([sessionId]) => sessionId));
-        const expired = this.hostState
+        const expired = this.serverState
             .expiredInteractionRuns()
             .find((candidate) => activeSessionIds.has(candidate.targetSessionId) &&
             !this.activeRuns.has(candidate.runId) &&
@@ -2861,7 +2888,7 @@ export class WorkflowHost {
         const claimToken = randomUUID();
         const claimed = this.queue.claimWorkflowRunForControl({
             runId,
-            runnerId: this.hostId,
+            runnerId: this.serverId,
             claimToken,
             leaseMs: this.runClaimLeaseMs,
         });
@@ -2906,14 +2933,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,
             });
@@ -2925,7 +2952,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],
@@ -2983,30 +3010,30 @@ export class WorkflowHost {
             schema: "pi-workflows.worker-launch.v1",
             runId,
             generation,
-            workerEpoch: randomUUID(),
+            runnerEpoch: randomUUID(),
             projectPath,
             workflowSource: record.workflowSource,
             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;
-        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, identity.pid, identity.startIdentity);
+                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,
@@ -3015,6 +3042,7 @@ export class WorkflowHost {
             supervisor,
             launchProgressRevision: runRevision(this.state, runId),
             exiting: false,
+            contentDigests: new Set(),
         };
         this.activeRuns.set(runId, active);
         this.clearPendingStart(runId, claimToken);
@@ -3025,8 +3053,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",
                 });
@@ -3034,8 +3062,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,
@@ -3043,17 +3071,17 @@ export class WorkflowHost {
             });
             if (active.control === undefined &&
                 (result.outcome !== "exited" ||
-                    this.hostState.validatingInteraction(active.record.runId) !== undefined)) {
-                await this.recoverWorkerExit(active, result.outcome);
+                    this.serverState.validatingInteraction(active.record.runId) !== undefined)) {
+                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,
@@ -3061,14 +3089,14 @@ export class WorkflowHost {
                 });
             }
             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);
         }
     }
@@ -3078,7 +3106,7 @@ export class WorkflowHost {
         const token = randomUUID();
         const claimed = this.queue.claimWorkflowRunForInteractionValidation({
             runId,
-            runnerId: this.hostId,
+            runnerId: this.serverId,
             claimToken: token,
             leaseMs: this.runClaimLeaseMs,
         });
@@ -3089,66 +3117,68 @@ export class WorkflowHost {
         this.markPendingStart(runId, token);
         await this.activateRun(claimed, token);
     }
-    async handleWorkerMessage(message) {
+    async handleRunnerMessage(message) {
         const active = this.activeRuns.get(message.runId);
         if (active === undefined ||
             active.generation !== message.generation ||
-            active.supervisor.envelope.workerEpoch !== message.workerEpoch) {
-            return workerResponse(message, "claimLost", undefined, "Worker 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);
+            active.supervisor.envelope.runnerEpoch !== message.runnerEpoch) {
+            return runnerResponse(message, "claimLost", undefined, "Runner epoch is stale");
+        }
+        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);
     }
-    async handleFreshWorkerMessage(active, message) {
-        if (message.operation === "worker.ready") {
+    async handleFreshRunnerMessage(active, message) {
+        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);
+            const candidateInteraction = 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(message, "accepted", {
-                command: workerRunCommand(record, resumeInteractionAttemptId),
+            return runnerResponse(message, "accepted", {
+                command: runnerRunCommand(record, resumeInteractionAttemptId),
                 originSessionId: record.originSessionId,
                 stateDirectory: this.stateDirectory,
                 ...(candidateInteraction === undefined ? {} : { candidateInteraction }),
                 ...(this.options.piArgs === undefined ? {} : { piArgs: this.options.piArgs }),
             }, undefined, 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, 8_192);
             }
             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(message, "rejected", undefined, `Workflow run revision conflict: expected ${message.expectedRevision}, got ${currentRevision}`, currentRevision);
+            return runnerResponse(message, "rejected", undefined, `Workflow run revision conflict: expected ${message.expectedRevision}, got ${currentRevision}`, currentRevision);
         }
         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");
         }
         try {
-            const payload = requireRecord(message.payload, "worker payload");
+            const payload = requireRecord(message.payload, "runner payload");
             let result;
             switch (message.operation) {
                 case "store.initializeRun":
@@ -3158,8 +3188,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);
+                case "store.readRunState":
+                    result = this.runStore.readRunState(requireString(payload.runId, "runId"));
                     break;
                 case "store.writeSnapshot": {
                     const state = payload.state;
@@ -3185,7 +3215,7 @@ export class WorkflowHost {
                     const decision = payload.request;
                     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,
@@ -3211,6 +3241,9 @@ 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;
                     await this.runStore.settleEffect(payload.options);
@@ -3225,16 +3258,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);
@@ -3248,91 +3281,91 @@ export class WorkflowHost {
                     break;
                 }
                 default:
-                    return workerResponse(message, "rejected", undefined, "Unknown worker operation");
+                    return runnerResponse(message, "rejected", undefined, "Unknown runner operation");
             }
-            return workerResponse(message, "accepted", result === undefined ? null : result, undefined, runRevision(this.state, message.runId));
+            return runnerResponse(message, "accepted", result === undefined ? null : result, undefined, runRevision(this.state, message.runId));
         }
         catch (error) {
-            return workerResponse(message, "rejected", undefined, errorMessage(error));
+            return runnerResponse(message, "rejected", undefined, errorMessage(error));
         }
     }
-    handleWorkerProcessOperation(active, message) {
+    handleRunnerProcessOperation(active, message) {
         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);
+                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 });
+                    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();
             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));
         }
     }
-    reapWorkerDescendants(workerEpoch) {
-        const descendants = this.workerDescendants.get(workerEpoch);
+    reapRunnerDescendants(runnerEpoch) {
+        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);
     }
-    acceptWorkerInteraction(message, payload) {
-        const candidate = this.requireWorkerInteraction(message, payload, true);
-        return this.hostState.finishInteractionValidation({
+    acceptRunnerInteraction(message, payload) {
+        const candidate = this.requireRunnerInteraction(message, payload, true);
+        return this.serverState.finishInteractionValidation({
             requestId: candidate.requestId,
             submissionId: candidate.submissionId,
             accepted: true,
             receipt: { status: "accepted" },
         });
     }
-    rejectWorkerInteraction(active, message, payload) {
-        const candidate = this.requireWorkerInteraction(message, payload, false);
+    rejectRunnerInteraction(active, message, payload) {
+        const candidate = this.requireRunnerInteraction(message, payload, false);
         return this.settleRejectedInteraction(active, candidate, requireString(payload.error, "interaction validation error"));
     }
-    requireWorkerInteraction(message, payload, acceptSettled) {
-        const candidate = this.hostState.validatingInteraction(message.runId) ??
-            (acceptSettled ? this.hostState.acceptedInteraction(message.runId) : undefined);
+    requireRunnerInteraction(message, payload, acceptSettled) {
+        const candidate = this.serverState.validatingInteraction(message.runId) ??
+            (acceptSettled ? this.serverState.acceptedInteraction(message.runId) : undefined);
         if (candidate === undefined ||
             candidate.requestId !== requireString(payload.requestId, "interaction requestId") ||
             candidate.submissionId !== requireString(payload.submissionId, "interaction submissionId") ||
             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;
     }
     settleRejectedInteraction(active, candidate, error) {
         const result = this.state.transaction(() => {
-            const submission = this.hostState.finishInteractionValidation({
+            const submission = this.serverState.finishInteractionValidation({
                 requestId: candidate.requestId,
                 submissionId: candidate.submissionId,
                 accepted: false,
@@ -3359,7 +3392,7 @@ export class WorkflowHost {
         active.control = "handoff";
         return result;
     }
-    enqueueWorkerNotification(active, message, payload) {
+    enqueueRunnerNotification(active, message, payload) {
         if (active.record.originSessionId === null) {
             throw new Error("Workflow notification has no origin Pi session");
         }
@@ -3381,7 +3414,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,
@@ -3401,7 +3434,7 @@ export class WorkflowHost {
             targetSessionId: record.targetSessionId,
         };
     }
-    requestWorkerPresentation(active, message, payload) {
+    requestRunnerPresentation(active, message, payload) {
         if (active.record.originSessionId === null) {
             throw new Error("Workflow presentation has no origin Pi session");
         }
@@ -3434,7 +3467,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,
@@ -3460,9 +3493,9 @@ export class WorkflowHost {
         });
     }
     async prepareInteractionResume(runId) {
-        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);
@@ -3495,7 +3528,7 @@ export class WorkflowHost {
         if (active === undefined)
             return;
         if (context.event.type === "node_finished" && context.event.attemptId !== undefined) {
-            this.hostState.consumeAcceptedInteraction(context.runId, context.event.attemptId, context.now);
+            this.serverState.consumeAcceptedInteraction(context.runId, context.event.attemptId, context.now);
         }
         if (context.state.status === "running") {
             if (context.event.type === "run_started" || context.event.type === "run_resumed") {
@@ -3506,10 +3539,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(context.runId, context.now, context.state.status === "completed" ? ["step", "decision"] : undefined);
+            this.serverState.workflowMessages.settleOpenTurnsForRun(context.runId, "lost", context.now);
+            this.serverState.workflowMessages.cancelPendingForRun(context.runId, context.now, context.state.status === "completed" ? ["step", "decision"] : undefined);
         }
         const queueStatus = context.state.status === "completed"
             ? "done"
@@ -3588,7 +3621,7 @@ export class WorkflowHost {
             "Workflow result:",
             canonicalJson({ ...terminalFacts, terminalFingerprint }),
         ].join("\n");
-        this.hostState.workflowMessages.create({
+        this.serverState.workflowMessages.create({
             workflowMessageId,
             runId,
             targetSessionId: queue.originSessionId,
@@ -3630,7 +3663,8 @@ export class WorkflowHost {
     }
     terminalWorkflowMessageMissing(runId) {
         return (this.terminalWorkflowMessageRequired(runId) &&
-            this.hostState.workflowMessages.latestForSource("terminal", `terminal:${runId}`) === undefined);
+            this.serverState.workflowMessages.latestForSource("terminal", `terminal:${runId}`) ===
+                undefined);
     }
     discoverMissingTerminalWorkflowMessages() {
         for (const run of this.queue.listWorkflowRuns({
@@ -3689,9 +3723,9 @@ export class WorkflowHost {
             };
         });
     }
-    completeControllerWorkflow(runId, state) {
+    completeResourceManagerWorkflow(runId, state) {
         const row = this.state.connection
-            .prepare(`SELECT w.request_id AS requestId, c.controller_name AS controller,
+            .prepare(`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
@@ -3699,12 +3733,12 @@ export class WorkflowHost {
          WHERE w.run_id = ? LIMIT 1`)
             .get(runId);
         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,
         });
@@ -3718,7 +3752,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 });
     }
     commitActivePause(active) {
         const now = Date.now();
@@ -3734,7 +3768,7 @@ export class WorkflowHost {
             }
         });
     }
-    async recoverWorkerExit(active, outcome) {
+    async recoverRunnerExit(active, outcome) {
         if (!this.queue.verifyWorkflowRunClaim({
             runId: active.record.runId,
             claimToken: active.claimToken,
@@ -3753,9 +3787,9 @@ 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`);
+            this.settleRejectedInteraction(active, validating, `Workflow runner ${outcome} before it completed interaction validation`);
             this.log(`run ${active.record.runId} rejected an interrupted interaction validation`);
             return;
         }
@@ -3769,7 +3803,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`);
             }
@@ -3777,23 +3811,23 @@ 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}`);
     }
     releaseLock() {
         try {
             const current = JSON.parse(fs.readFileSync(this.lockPath, "utf8"));
-            if (isLockRecord(current) && current.hostId === this.hostId)
+            if (isLockRecord(current) && current.serverId === this.serverId)
                 fs.rmSync(this.lockPath);
         }
         catch {
@@ -3871,21 +3905,21 @@ function channelEventPayload(message) {
     const { expectedRevision: _expectedRevision, sequence: _sequence, ...payload } = message;
     return payload;
 }
-function acquireHostLock(lockPath, record) {
+function acquireServerLock(lockPath, record) {
     try {
         const existing = JSON.parse(fs.readFileSync(lockPath, "utf8"));
         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(lockPath, `${JSON.stringify({ schema: "pi-workflows.host-lock.v1", ...record })}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
 }
-function workerRunCommand(record, resumeInteractionAttemptId) {
+function runnerRunCommand(record, resumeInteractionAttemptId) {
     if (record.initialized) {
         return {
             kind: "resume",
@@ -3914,7 +3948,7 @@ function workerRunCommand(record, resumeInteractionAttemptId) {
     }
     return { kind: "start", input };
 }
-function workerResponse(message, outcome, result, error, revision) {
+function runnerResponse(message, outcome, result, error, revision) {
     return {
         schema: "pi-workflows.worker-response.v1",
         messageId: message.messageId,
@@ -3924,7 +3958,7 @@ function workerResponse(message, outcome, result, error, revision) {
         ...(error === undefined ? {} : { error }),
     };
 }
-function controllerWorkerResponse(message, outcome, result, error) {
+function resourceRunnerResponse(message, outcome, result, error) {
     return {
         schema: "pi-workflows.controller-worker-response.v1",
         messageId: message.messageId,
@@ -3933,7 +3967,7 @@ function controllerWorkerResponse(message, outcome, result, error) {
         ...(error === undefined ? {} : { error }),
     };
 }
-function controllerWorkflowResult(record) {
+function resourceManagerWorkflowResult(record) {
     switch (record.status) {
         case "queued":
         case "starting":
@@ -3968,12 +4002,12 @@ function hasUncertainEffect(state, runId) {
         .get(runId);
     return row !== undefined;
 }
-function controllerPathAllowed(projectPath, controllerName, controllerPath) {
-    if (controllerFileStem(controllerPath) !== controllerName ||
-        !/\.controller\.(?:ts|js|mts|mjs)$/u.test(controllerPath)) {
+function resourceManagerPathAllowed(projectPath, resourceManagerName, resourceManagerPath) {
+    if (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));
 }
 function waitForSocketDrain(socket) {
     if (socket.destroyed)
@@ -4003,7 +4037,7 @@ function waitForSocketDrain(socket) {
             onClose();
     });
 }
-function hostDelay(ms) {
+function serverDelay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function runPageReceipt(view, kind, cursor) {
@@ -4223,6 +4257,6 @@ function isLockRecord(value) {
         value.schema === "pi-workflows.host-lock.v1" &&
         typeof value.pid === "number" &&
         typeof value.startIdentity === "string" &&
-        typeof value.hostId === "string");
+        typeof value.serverId === "string");
 }
-//# sourceMappingURL=runner.js.map
+//# sourceMappingURL=server.js.map