@osolmaz/pi-workflows 0.12.1 → 0.13.1

package/dist/builtins/monitor.workflow.js

@@ -2,20 +2,20 @@ import { action, agent, compute, defineWorkflow, includeWorkflow, includedResult
 import { estimateProgress, formatProgressReport, } from "../workflows/progress.js";
 import { validateProgressData } from "../workflows/updates.js";
 import autoimplementWorkflow, {} from "./autoimplement.workflow.js";
-import { parsePlanApprovalPolicy } from "./plan-approval.workflow.js";
+import { parsePlanApprovalPolicy, } from "./plan-approval.workflow.js";
 import planChangeWorkflow, {} from "./plan-change.workflow.js";
 const MIN_INTERVAL_MINUTES = 1;
 const MAX_INTERVAL_MINUTES = 24 * 60;
 const DEFAULT_INTERVAL_MINUTES = 30;
-const MIN_CHECK_TIMEOUT_MINUTES = 5;
-const MAX_CHECK_TIMEOUT_MINUTES = 24 * 60;
-const DEFAULT_MIN_CHECK_TIMEOUT_MINUTES = 60;
+const DEFAULT_CHECK_TIMEOUT_MINUTES = 60;
 const DEFAULT_MAX_CHECKS = 1_000;
 const MAX_CHECKS = 1_000;
 const MAX_TRACKS = 256;
 const MAX_OBSERVATION_CHARS = 8_000;
 const MAX_REPORT_CHARS = 4_000;
 const MAX_REASON_CHARS = 2_000;
+const MAX_ACTION_TEXT_CHARS = 8_000;
+const MAX_ID_CHARS = 256;
 const SLEEP_TIMEOUT_MARGIN_MS = 60_000;
 const NODE_TIMEOUT_MARGIN_MS = 2 * 60_000;
 function requireRecord(value, label) {
@@ -24,6 +24,11 @@ function requireRecord(value, label) {
     }
     return value;
 }
+function requireExactKeys(value, allowed, label) {
+    const unexpected = Object.keys(value).find((key) => !allowed.includes(key));
+    if (unexpected !== undefined)
+        throw new Error(`${label} field ${unexpected} is not supported`);
+}
 function requireBoundedString(value, label, maxChars) {
     if (typeof value !== "string")
         throw new Error(`${label} must be a string`);
@@ -34,6 +39,12 @@ function requireBoundedString(value, label, maxChars) {
         throw new Error(`${label} must be at most ${maxChars} characters`);
     return trimmed;
 }
+function requireStringArray(value, label) {
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`${label} must be an array of strings`);
+    }
+    return value.map((item, index) => requireBoundedString(item, `${label}[${index}]`, MAX_ACTION_TEXT_CHARS));
+}
 async function waitForUpdateSlot(signal) {
     await new Promise((resolve, reject) => {
         const onAbort = () => {
@@ -52,18 +63,8 @@ async function waitForUpdateSlot(signal) {
 }
 export function prepareMonitorInput(input) {
     const value = requireRecord(input, "monitor input");
-    const allowed = new Set([
-        "task",
-        "everyMinutes",
-        "stopWhen",
-        "maxChecks",
-        "checkTimeoutMinutes",
-        "repair",
-    ]);
-    for (const field of Object.keys(value)) {
-        if (!allowed.has(field))
-            throw new Error(`monitor input field ${field} is not supported`);
-    }
+    const allowed = ["task", "everyMinutes", "stopWhen", "maxChecks"];
+    requireExactKeys(value, allowed, "monitor input");
     const task = requireBoundedString(value.task, "task", 8_000);
     const everyMinutes = value.everyMinutes ?? DEFAULT_INTERVAL_MINUTES;
     if (!Number.isInteger(everyMinutes) ||
@@ -75,41 +76,6 @@ export function prepareMonitorInput(input) {
     if (!Number.isInteger(maxChecks) || maxChecks <= 0 || maxChecks > MAX_CHECKS) {
         throw new Error(`maxChecks must be an integer from 1 through ${MAX_CHECKS}`);
     }
-    const checkTimeoutMinutes = value.checkTimeoutMinutes ?? Math.max(DEFAULT_MIN_CHECK_TIMEOUT_MINUTES, everyMinutes);
-    if (!Number.isInteger(checkTimeoutMinutes) ||
-        checkTimeoutMinutes < MIN_CHECK_TIMEOUT_MINUTES ||
-        checkTimeoutMinutes > MAX_CHECK_TIMEOUT_MINUTES) {
-        throw new Error(`checkTimeoutMinutes must be an integer from ${MIN_CHECK_TIMEOUT_MINUTES} through ${MAX_CHECK_TIMEOUT_MINUTES}`);
-    }
-    let repair;
-    if (value.repair !== undefined) {
-        const raw = requireRecord(value.repair, "repair policy");
-        if (raw.authorized !== true)
-            throw new Error("repair policy must set authorized to true");
-        if (raw.constraints !== undefined &&
-            (!Array.isArray(raw.constraints) || raw.constraints.some((item) => typeof item !== "string"))) {
-            throw new Error("repair constraints must be an array of strings");
-        }
-        if (raw.merge !== undefined && typeof raw.merge !== "boolean") {
-            throw new Error("repair merge must be a boolean");
-        }
-        const approval = parsePlanApprovalPolicy(raw.approval);
-        repair = {
-            authorized: true,
-            ...(raw.scope !== undefined
-                ? { scope: requireBoundedString(raw.scope, "repair scope", 4_000) }
-                : {}),
-            ...(raw.constraints !== undefined ? { constraints: [...raw.constraints] } : {}),
-            ...(raw.repository !== undefined
-                ? { repository: requireBoundedString(raw.repository, "repair repository", 4_000) }
-                : {}),
-            ...(raw.baseBranch !== undefined
-                ? { baseBranch: requireBoundedString(raw.baseBranch, "repair base branch", 256) }
-                : {}),
-            ...(raw.merge !== undefined ? { merge: raw.merge !== false } : {}),
-            approval,
-        };
-    }
     return {
         task,
         everyMinutes,
@@ -117,66 +83,243 @@ export function prepareMonitorInput(input) {
             ? "Stop only when the user explicitly asks to stop."
             : requireBoundedString(value.stopWhen, "stopWhen", 4_000),
         maxChecks,
-        checkTimeoutMinutes,
-        ...(repair !== undefined ? { repair } : {}),
     };
 }
 function configFrom(outputs) {
     return outputs.prepare;
 }
-function completedChecks(context) {
-    return context.state.steps.filter((step) => step.nodeId === "check" && step.outcome === "ok")
+function completedObservations(context) {
+    return context.state.steps.filter((step) => step.nodeId === "observe" && step.outcome === "ok")
         .length;
 }
-export function validateMonitorCheck(output, repairAuthorized = false) {
-    const value = requireRecord(output, "monitor check output");
-    const allowed = new Set(["route", "observation", "report", "progress", "repair", "reason"]);
-    for (const key of Object.keys(value))
-        if (!allowed.has(key))
-            throw new Error(`monitor check field ${key} is not supported`);
-    if (value.route !== "continue" && value.route !== "repair" && value.route !== "stop") {
-        throw new Error("route must be continue, repair, or stop");
-    }
-    if (value.route === "repair" && !repairAuthorized) {
-        throw new Error("route repair requires explicit monitor repair authorization");
-    }
-    const check = {
+function parseAuthority(input) {
+    const value = requireRecord(input, "action authority");
+    requireExactKeys(value, [
+        "status",
+        "basis",
+        "allowedMutations",
+        "forbiddenMutations",
+        "costLimit",
+        "providerRuntime",
+        "requiredChecks",
+        "stopConditions",
+        "allowedRecoveryActions",
+        "repository",
+        "baseBranch",
+        "merge",
+        "repairApproval",
+    ], "action authority");
+    if (value.status !== "authorized" && value.status !== "outside") {
+        throw new Error("action authority status must be authorized or outside");
+    }
+    if (typeof value.merge !== "boolean")
+        throw new Error("action authority merge must be boolean");
+    const approval = value.repairApproval === undefined
+        ? undefined
+        : requireRecord(value.repairApproval, "repair approval");
+    return {
+        status: value.status,
+        basis: requireBoundedString(value.basis, "action authority basis", MAX_ACTION_TEXT_CHARS),
+        allowedMutations: requireStringArray(value.allowedMutations, "action authority allowedMutations"),
+        forbiddenMutations: requireStringArray(value.forbiddenMutations, "action authority forbiddenMutations"),
+        costLimit: requireBoundedString(value.costLimit, "action authority costLimit", MAX_ACTION_TEXT_CHARS),
+        providerRuntime: requireBoundedString(value.providerRuntime, "action authority providerRuntime", MAX_ACTION_TEXT_CHARS),
+        requiredChecks: requireStringArray(value.requiredChecks, "action authority requiredChecks"),
+        stopConditions: requireStringArray(value.stopConditions, "action authority stopConditions"),
+        allowedRecoveryActions: requireStringArray(value.allowedRecoveryActions, "action authority allowedRecoveryActions"),
+        ...(value.repository !== undefined
+            ? {
+                repository: requireBoundedString(value.repository, "action authority repository", 4_000),
+            }
+            : {}),
+        ...(value.baseBranch !== undefined
+            ? {
+                baseBranch: requireBoundedString(value.baseBranch, "action authority baseBranch", 256),
+            }
+            : {}),
+        merge: value.merge,
+        repairApproval: parsePlanApprovalPolicy(approval),
+    };
+}
+function parseCostSafety(input) {
+    const value = requireRecord(input, "action cost");
+    requireExactKeys(value, ["paidAction", "status", "evidence"], "action cost");
+    if (typeof value.paidAction !== "boolean")
+        throw new Error("action cost paidAction must be boolean");
+    if (value.status !== "not-applicable" &&
+        value.status !== "within-limit" &&
+        value.status !== "missing" &&
+        value.status !== "exceeded") {
+        throw new Error("action cost status is invalid");
+    }
+    return {
+        paidAction: value.paidAction,
+        status: value.status,
+        evidence: requireBoundedString(value.evidence, "action cost evidence", MAX_ACTION_TEXT_CHARS),
+    };
+}
+function parseDefectSafety(input) {
+    const value = requireRecord(input, "action defect");
+    requireExactKeys(value, ["sharedCodeOrDataDefect", "paidWorkers", "evidence"], "action defect");
+    if (typeof value.sharedCodeOrDataDefect !== "boolean") {
+        throw new Error("action defect sharedCodeOrDataDefect must be boolean");
+    }
+    if (value.paidWorkers !== "not-applicable" &&
+        value.paidWorkers !== "stopped" &&
+        value.paidWorkers !== "running") {
+        throw new Error("action defect paidWorkers is invalid");
+    }
+    return {
+        sharedCodeOrDataDefect: value.sharedCodeOrDataDefect,
+        paidWorkers: value.paidWorkers,
+        evidence: requireBoundedString(value.evidence, "action defect evidence", MAX_ACTION_TEXT_CHARS),
+    };
+}
+function parseActionRequest(input) {
+    const value = requireRecord(input, "monitor action request");
+    requireExactKeys(value, [
+        "kind",
+        "incomplete",
+        "evidence",
+        "nextAction",
+        "authority",
+        "cost",
+        "defect",
+        "verification",
+        "failureId",
+        "targetStateId",
+    ], "monitor action request");
+    if (value.kind !== "advance" && value.kind !== "recover" && value.kind !== "repair") {
+        throw new Error("monitor action kind must be advance, recover, or repair");
+    }
+    const request = {
+        kind: value.kind,
+        incomplete: requireBoundedString(value.incomplete, "monitor action incomplete work", MAX_ACTION_TEXT_CHARS),
+        evidence: value.evidence ?? null,
+        nextAction: requireBoundedString(value.nextAction, "monitor action nextAction", MAX_ACTION_TEXT_CHARS),
+        authority: parseAuthority(value.authority),
+        cost: parseCostSafety(value.cost),
+        defect: parseDefectSafety(value.defect),
+        verification: requireBoundedString(value.verification, "monitor action verification", MAX_ACTION_TEXT_CHARS),
+        failureId: requireBoundedString(value.failureId, "monitor action failureId", MAX_ID_CHARS),
+        targetStateId: requireBoundedString(value.targetStateId, "monitor action targetStateId", MAX_ID_CHARS),
+    };
+    if (request.authority.status !== "authorized") {
+        throw new Error("route act requires action authority status authorized");
+    }
+    if (request.authority.allowedMutations.length === 0) {
+        throw new Error("route act requires at least one allowed mutation");
+    }
+    if (request.cost.paidAction &&
+        (request.cost.status === "missing" || request.cost.status === "exceeded")) {
+        throw new Error("route act cannot launch paid work without verified remaining authority");
+    }
+    if (request.cost.paidAction && request.cost.status !== "within-limit") {
+        throw new Error("paid route act requires cost status within-limit");
+    }
+    if (!request.cost.paidAction && request.cost.status !== "not-applicable") {
+        throw new Error("unpaid route act requires cost status not-applicable");
+    }
+    if (request.kind === "repair" &&
+        request.defect.sharedCodeOrDataDefect &&
+        request.defect.paidWorkers === "running") {
+        throw new Error("paid workers must stop before a shared code or data repair");
+    }
+    return request;
+}
+export function validateMonitorObservation(output) {
+    const value = requireRecord(output, "monitor observation output");
+    requireExactKeys(value, [
+        "route",
+        "goalState",
+        "workState",
+        "observation",
+        "report",
+        "targetStateId",
+        "authorizedActions",
+        "progress",
+        "action",
+        "reason",
+    ], "monitor observation");
+    if (value.route !== "wait" && value.route !== "act" && value.route !== "stop") {
+        throw new Error("route must be wait, act, or stop");
+    }
+    if (value.goalState !== "complete" &&
+        value.goalState !== "incomplete" &&
+        value.goalState !== "blocked") {
+        throw new Error("goalState must be complete, incomplete, or blocked");
+    }
+    if (value.workState !== "running" &&
+        value.workState !== "waiting" &&
+        value.workState !== "idle" &&
+        value.workState !== "failed" &&
+        value.workState !== "stopped" &&
+        value.workState !== "unknown") {
+        throw new Error("workState is invalid");
+    }
+    const observation = {
         route: value.route,
+        goalState: value.goalState,
+        workState: value.workState,
         observation: requireBoundedString(value.observation, "observation", MAX_OBSERVATION_CHARS),
         report: requireBoundedString(value.report, "report", MAX_REPORT_CHARS),
+        targetStateId: requireBoundedString(value.targetStateId, "targetStateId", MAX_ID_CHARS),
+        authorizedActions: requireStringArray(value.authorizedActions, "authorizedActions"),
         reason: requireBoundedString(value.reason, "reason", MAX_REASON_CHARS),
     };
     if (value.progress !== undefined)
-        check.progress = validateMonitorProgress(value.progress);
-    if (value.repair !== undefined) {
-        const repair = requireRecord(value.repair, "monitor repair request");
-        check.repair = {
-            problem: requireBoundedString(repair.problem, "repair problem", 8_000),
-            evidence: repair.evidence ?? null,
-            issueFingerprint: requireBoundedString(repair.issueFingerprint, "repair issue fingerprint", 256),
-        };
+        observation.progress = validateMonitorProgress(value.progress);
+    if (value.action !== undefined)
+        observation.action = parseActionRequest(value.action);
+    if (observation.route === "act" && observation.action === undefined) {
+        throw new Error("route act requires action details");
+    }
+    if (observation.action !== undefined &&
+        observation.action.targetStateId !== observation.targetStateId) {
+        throw new Error("monitor action targetStateId must match the observed targetStateId");
+    }
+    if (observation.route !== "act" && observation.action !== undefined) {
+        throw new Error("action details are only valid for route act");
+    }
+    if (observation.route === "act" && observation.goalState !== "incomplete") {
+        throw new Error("route act requires goalState incomplete");
+    }
+    if (observation.route === "act" &&
+        observation.workState !== "idle" &&
+        observation.workState !== "failed" &&
+        observation.workState !== "stopped") {
+        throw new Error("route act requires idle, failed, or stopped work");
     }
-    if (value.route === "repair" && check.repair === undefined) {
-        throw new Error("route repair requires repair details");
+    if (observation.route === "wait" && observation.goalState !== "incomplete") {
+        throw new Error("route wait requires goalState incomplete");
     }
-    return check;
+    if (observation.route === "wait" &&
+        observation.workState !== "running" &&
+        observation.workState !== "waiting") {
+        throw new Error("route wait requires running work or an external wait");
+    }
+    if (observation.goalState === "complete" && observation.route !== "stop") {
+        throw new Error("goalState complete requires route stop");
+    }
+    if (observation.goalState === "blocked" && observation.route !== "stop") {
+        throw new Error("goalState blocked requires route stop");
+    }
+    return observation;
 }
 function validateMonitorProgress(input) {
     const value = requireRecord(input, "progress");
-    if (Object.keys(value).some((key) => key !== "tracks"))
-        throw new Error("progress only supports tracks");
+    requireExactKeys(value, ["tracks"], "progress");
     if (!Array.isArray(value.tracks) || value.tracks.length < 1 || value.tracks.length > MAX_TRACKS) {
         throw new Error(`progress.tracks must contain 1 through ${MAX_TRACKS} entries`);
     }
     const keys = new Set();
     const tracks = value.tracks.map((raw, index) => {
         const track = requireRecord(raw, `progress.tracks[${index}]`);
-        if (Object.keys(track).some((key) => key !== "key" && key !== "data")) {
-            throw new Error(`progress.tracks[${index}] has an unsupported field`);
-        }
+        requireExactKeys(track, ["key", "data"], `progress.tracks[${index}]`);
         const key = requireBoundedString(track.key, `progress.tracks[${index}].key`, 128);
-        if (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(key))
+        if (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(key)) {
             throw new Error(`progress.tracks[${index}].key is invalid`);
+        }
         if (keys.has(key))
             throw new Error(`progress track key ${key} is duplicated`);
         keys.add(key);
@@ -187,15 +330,18 @@ function validateMonitorProgress(input) {
     });
     return { tracks };
 }
+function currentObservation(outputs) {
+    return (outputs.guard ?? outputs.observe);
+}
 function estimateTracks(outputs) {
-    const check = outputs.check;
-    if (check.progress === undefined)
+    const observation = currentObservation(outputs);
+    if (observation.progress === undefined)
         return { tracks: [] };
     const previous = outputs.estimate;
     const previousByKey = new Map((previous?.tracks ?? []).map((track) => [track.key, track]));
     const at = new Date().toISOString();
     return {
-        tracks: check.progress.tracks.map((track) => {
+        tracks: observation.progress.tracks.map((track) => {
             const samples = [
                 ...(previousByKey.get(track.key)?.samples ?? []),
                 { at, data: track.data },
@@ -204,26 +350,71 @@ function estimateTracks(outputs) {
         }),
     };
 }
-function repeatedRepairWithoutProgress(context) {
-    const current = context.outputs.check;
-    const fingerprint = current.repair?.issueFingerprint;
-    if (fingerprint === undefined)
+function actionFrom(outputs) {
+    const request = currentObservation(outputs).action;
+    if (request === undefined)
+        throw new Error("monitor action details are missing");
+    return request;
+}
+function repeatedCompletedRepair(context) {
+    const action = context.outputs.observe.action;
+    if (action?.kind !== "repair")
         return false;
-    const steps = context.state.steps;
-    const currentCheckIndex = steps.findLastIndex((step) => step.nodeId === "check");
-    for (let index = currentCheckIndex - 1; index >= 0; index -= 1) {
-        const step = steps[index];
-        if (step?.nodeId !== "check")
+    const currentIndex = context.state.steps.findLastIndex((step) => step.nodeId === "observe");
+    for (let index = currentIndex - 1; index >= 0; index -= 1) {
+        const step = context.state.steps[index];
+        if (step?.nodeId !== "observe")
             continue;
         const prior = step.output;
-        if (prior.repair?.issueFingerprint !== fingerprint)
+        if (prior.action?.kind !== "repair" ||
+            prior.action.failureId !== action.failureId ||
+            prior.action.targetStateId !== action.targetStateId) {
             continue;
-        return steps
-            .slice(index + 1, currentCheckIndex)
-            .some((candidate) => candidate.nodeId === "implementation");
+        }
+        return context.state.steps
+            .slice(index + 1, currentIndex)
+            .some((candidate) => candidate.nodeId === "repairComplete" && candidate.outcome === "ok");
     }
     return false;
 }
+function guardObservation(context) {
+    const observation = context.outputs.observe;
+    if (!repeatedCompletedRepair(context))
+        return observation;
+    const action = observation.action;
+    if (action === undefined)
+        return observation;
+    return {
+        route: "stop",
+        goalState: "blocked",
+        workState: observation.workState,
+        observation: observation.observation,
+        report: "The same failure and target state returned after one completed repair.",
+        targetStateId: observation.targetStateId,
+        authorizedActions: observation.authorizedActions,
+        ...(observation.progress !== undefined ? { progress: observation.progress } : {}),
+        reason: `Repair stopped because ${action.failureId} returned in target state ${action.targetStateId}.`,
+    };
+}
+export function validateMonitorActionResult(output, expected) {
+    const value = requireRecord(output, "monitor action result");
+    requireExactKeys(value, ["status", "summary", "evidence", "verification", "failureId", "targetStateId"], "monitor action result");
+    if (value.status !== "succeeded" && value.status !== "failed" && value.status !== "blocked") {
+        throw new Error("monitor action result status must be succeeded, failed, or blocked");
+    }
+    const result = {
+        status: value.status,
+        summary: requireBoundedString(value.summary, "monitor action result summary", MAX_REPORT_CHARS),
+        evidence: value.evidence ?? null,
+        verification: requireBoundedString(value.verification, "monitor action result verification", MAX_ACTION_TEXT_CHARS),
+        failureId: requireBoundedString(value.failureId, "monitor action result failureId", MAX_ID_CHARS),
+        targetStateId: requireBoundedString(value.targetStateId, "monitor action result targetStateId", MAX_ID_CHARS),
+    };
+    if (result.failureId !== expected.failureId || result.targetStateId !== expected.targetStateId) {
+        throw new Error("monitor action result must preserve the requested failure and target-state IDs");
+    }
+    return result;
+}
 function currentRepairPlan(outputs) {
     const result = includedResult(planChangeWorkflow, outputs.planChange);
     if (result.exit !== "ready")
@@ -234,35 +425,100 @@ function currentRepairPlan(outputs) {
         documents: result.output.documents,
     };
 }
+function authorityScope(actionRequest) {
+    const authority = actionRequest.authority;
+    return [
+        `Authorization basis: ${authority.basis}`,
+        `Allowed mutations: ${authority.allowedMutations.join("; ")}`,
+        `Forbidden mutations: ${authority.forbiddenMutations.join("; ") || "none recorded"}`,
+        `Cost limit: ${authority.costLimit}`,
+        `Provider/runtime contract: ${authority.providerRuntime}`,
+        `Allowed recovery actions: ${authority.allowedRecoveryActions.join("; ") || "none recorded"}`,
+    ].join("\n");
+}
+function authorityConstraints(actionRequest) {
+    const authority = actionRequest.authority;
+    return [
+        ...authority.forbiddenMutations.map((item) => `Forbidden: ${item}`),
+        `Cost limit: ${authority.costLimit}`,
+        `Provider/runtime contract: ${authority.providerRuntime}`,
+        ...authority.requiredChecks.map((item) => `Required check: ${item}`),
+        ...authority.stopConditions.map((item) => `Stop condition: ${item}`),
+        `Repair verification: ${actionRequest.verification}`,
+    ];
+}
 function repairBlockedReason(outputs) {
-    const guard = outputs.repairGuard;
-    if (guard?.route === "blocked" && guard.reason !== undefined)
-        return guard.reason;
     const planChange = outputs.planChange;
     const implementation = outputs.implementation;
     return (implementation?.output?.reason ??
         planChange?.output?.reason ??
-        "The repair did not produce new verified progress.");
+        "The repair did not produce a verified result.");
+}
+function recordedActionFromStep(step) {
+    if (step.outcome !== "ok")
+        return undefined;
+    if (step.nodeId === "act") {
+        const result = step.output;
+        return {
+            status: result.status,
+            summary: result.summary,
+            evidence: result.evidence,
+            verification: result.verification,
+            failureId: result.failureId,
+            targetStateId: result.targetStateId,
+        };
+    }
+    if (step.nodeId === "repairComplete")
+        return step.output;
+    return undefined;
+}
+function latestRecordedAction(context) {
+    for (let index = context.state.steps.length - 1; index >= 0; index -= 1) {
+        const step = context.state.steps[index];
+        if (step === undefined)
+            continue;
+        const recorded = recordedActionFromStep(step);
+        if (recorded !== undefined)
+            return recorded;
+    }
+    return undefined;
 }
 function reportMessage(context) {
-    const check = context.outputs.check;
+    const observation = currentObservation(context.outputs);
     const estimate = context.outputs.estimate;
     const config = configFrom(context.outputs);
-    const suffix = [];
-    if (estimate.tracks.length > 0) {
-        suffix.push(formatProgressReport(estimate.tracks.map((track) => track.estimate), check.route === "continue" ? config.everyMinutes : undefined, new Date(), 2_000));
-    }
-    if (check.route === "continue" && completedChecks(context) >= config.maxChecks) {
-        suffix.push(`Reached the ${config.maxChecks}-check safety limit.`);
-    }
-    const suffixText = suffix.filter(Boolean).join("\n");
-    if (suffixText.length === 0)
-        return check.report;
-    const reportBudget = Math.max(1, MAX_REPORT_CHARS - suffixText.length - 1);
-    const report = check.report.length <= reportBudget
-        ? check.report
-        : `${check.report.slice(0, Math.max(0, reportBudget - 1))}…`;
-    return `${report}\n${suffixText}`;
+    const progress = estimate.tracks.length === 0
+        ? "Progress: unavailable"
+        : formatProgressReport(estimate.tracks.map((track) => track.estimate), undefined, new Date(), 2_000);
+    const lines = [
+        `Monitor: ${observation.route === "stop" ? "stopping" : "active"}`,
+        `Goal: ${observation.goalState}`,
+        `Work: ${observation.workState}`,
+        progress,
+    ];
+    const lastAction = latestRecordedAction(context);
+    if (lastAction !== undefined)
+        lines.push(`Last action: ${lastAction.summary}`);
+    if (observation.action !== undefined && completedObservations(context) < config.maxChecks) {
+        lines.push(`Next action: ${observation.action.nextAction}`);
+    }
+    if (observation.route === "wait" && completedObservations(context) < config.maxChecks) {
+        lines.push(`Next check: ${config.everyMinutes} minutes`);
+    }
+    if (completedObservations(context) >= config.maxChecks && observation.route !== "stop") {
+        lines.push(`Safety limit: reached ${config.maxChecks} observations`);
+    }
+    lines.push(`Status: ${observation.report}`);
+    const message = lines.join("\n");
+    return message.length <= MAX_REPORT_CHARS
+        ? message
+        : `${message.slice(0, MAX_REPORT_CHARS - 1)}…`;
+}
+function previousActionPrompt(context) {
+    const actionRecord = latestRecordedAction(context);
+    return actionRecord === undefined
+        ? "There is no previous completed action."
+        : `Previous action result: ${JSON.stringify(actionRecord)}`;
 }
 const monitorWorkflow = defineWorkflow({
     source: import.meta.url,
@@ -282,25 +538,24 @@ const monitorWorkflow = defineWorkflow({
     includes: {
         planChange: includeWorkflow(planChangeWorkflow, {
             input: ({ outputs }) => {
-                const config = configFrom(outputs);
-                const repair = outputs.check.repair;
-                if (repair === undefined)
-                    throw new Error("monitor repair details are missing");
-                const prior = outputs.planChange;
+                const request = actionFrom(outputs);
+                if (request.kind !== "repair")
+                    throw new Error("monitor repair action is missing");
                 return {
-                    task: repair.problem,
-                    ...(config.repair?.scope !== undefined ? { scope: config.repair.scope } : {}),
-                    ...(config.repair?.constraints !== undefined
-                        ? { constraints: config.repair.constraints }
+                    task: request.nextAction,
+                    scope: authorityScope(request),
+                    constraints: authorityConstraints(request),
+                    ...(request.authority.repository !== undefined
+                        ? { repository: request.authority.repository }
                         : {}),
-                    ...(config.repair?.repository !== undefined
-                        ? { repository: config.repair.repository }
-                        : {}),
-                    ...(prior?.exit === "ready" && prior.output?.plan !== undefined
-                        ? { previousPlan: prior.output.plan }
-                        : {}),
-                    newEvidence: repair.evidence,
-                    approval: parsePlanApprovalPolicy(config.repair?.approval),
+                    newEvidence: {
+                        incomplete: request.incomplete,
+                        evidence: request.evidence,
+                        failureId: request.failureId,
+                        targetStateId: request.targetStateId,
+                        defect: request.defect,
+                    },
+                    approval: request.authority.repairApproval,
                 };
             },
         }),
@@ -308,120 +563,145 @@ const monitorWorkflow = defineWorkflow({
             workflow: "autoimplement",
             contract: autoimplementWorkflow,
             input: ({ outputs }) => {
-                const config = configFrom(outputs);
-                const repair = outputs.check.repair;
+                const request = actionFrom(outputs);
                 const documented = currentRepairPlan(outputs);
-                if (repair === undefined)
-                    throw new Error("monitor repair details are missing");
-                const request = {
-                    task: repair.problem,
+                if (request.kind !== "repair")
+                    throw new Error("monitor repair action is missing");
+                if (request.authority.repository === undefined) {
+                    throw new Error("monitor repair requires an absolute repository for workspace preparation");
+                }
+                const implementationInput = {
+                    task: request.nextAction,
                     plan: documented.plan,
                     documentation: {
                         status: "current",
                         planDigest: documented.planDigest,
                         documents: documented.documents,
                     },
-                    ...(config.repair?.scope !== undefined ? { scope: config.repair.scope } : {}),
-                    ...(config.repair?.constraints !== undefined
-                        ? { constraints: config.repair.constraints }
-                        : {}),
-                    ...(config.repair?.repository !== undefined
-                        ? { repository: config.repair.repository }
+                    scope: authorityScope(request),
+                    constraints: authorityConstraints(request),
+                    repository: request.authority.repository,
+                    ...(request.authority.baseBranch !== undefined
+                        ? { baseBranch: request.authority.baseBranch }
                         : {}),
-                    ...(config.repair?.baseBranch !== undefined
-                        ? { baseBranch: config.repair.baseBranch }
-                        : {}),
-                    approval: parsePlanApprovalPolicy(config.repair?.approval),
-                    merge: config.repair?.merge === true,
+                    approval: request.authority.repairApproval,
+                    merge: request.authority.merge,
                 };
-                return request;
+                return implementationInput;
             },
         }),
     },
     nodes: {
         prepare: compute({ run: ({ input }) => prepareMonitorInput(input) }),
-        check: agent({
-            statusDetail: "checking monitored target",
-            timeoutMs: ({ outputs }) => configFrom(outputs).checkTimeoutMinutes * 60_000,
+        observe: agent({
+            statusDetail: "observing monitored goal",
+            timeoutMs: DEFAULT_CHECK_TIMEOUT_MINUTES * 60_000,
             prompt: (context) => {
                 const config = configFrom(context.outputs);
-                const previous = context.outputs.check;
+                const previous = context.outputs.observe;
                 const priorEstimate = context.outputs.estimate;
                 return [
-                    `Perform monitoring check ${completedChecks(context) + 1} of at most ${config.maxChecks}.`,
-                    `Task: ${config.task}`,
+                    `Perform read-only observation ${completedObservations(context) + 1} of at most ${config.maxChecks}.`,
+                    `Goal and authority: ${config.task}`,
                     `Stop when: ${config.stopWhen}`,
+                    "Use normal read-only tools to inspect authoritative target state, durable outputs, failures, checkpoints, active work, and applicable authority. Do not mutate any file, process, Job, service, remote resource, or configuration during this step.",
+                    "Preserve the exact goal, allowed files and systems, forbidden changes, cost ceiling, provider/runtime contract, required checks, stop conditions, and allowed recovery actions from the task, conversation, and repository instructions. Do not invent permission.",
+                    "List the safe actions the user has already authorized, even when no action is needed now. Choose wait only when useful target work is moving or an external event must finish. Choose act only when the goal is incomplete, work is idle, failed, or stopped, and one safe action is fully authorized. Choose stop when the goal is complete or safe continuation is blocked.",
+                    "For act, describe one exact action. Use advance for normal next work, recover for an operational restart or resume, and repair only for a code or configuration defect. A normal start, resume, or restart must not become repair. If a paid action lacks verified remaining authority or exceeds its limit, choose stop. Before repair of a shared code or data defect, affected paid workers must already be stopped.",
+                    "You are the regular Pi model and observation adapter. Publish measured facts with workflow update when useful. Do not require the target to implement a Pi-specific API, file, store, schema, command, service, transport, or dependency. Do not invent counts, rates, or ETA values.",
                     previous === undefined
-                        ? "There is no previous observation."
-                        : `Previous accepted observation: ${previous.observation}`,
+                        ? "There is no previous accepted observation."
+                        : `Previous accepted observation: ${JSON.stringify(previous)}`,
+                    previousActionPrompt(context),
                     priorEstimate?.tracks.length
                         ? `Previous progress: ${formatProgressReport(priorEstimate.tracks.map((track) => track.estimate))}`
                         : "There is no previous measured progress.",
-                    config.repair === undefined
-                        ? "Observe only. This monitor has no mutation authorization."
-                        : "Repair is explicitly authorized within the supplied repair policy. Choose repair only for a concrete issue that can be changed within that scope. Include a stable issue fingerprint based on the issue and observed target state. Do not change protected model, benchmark, credential, hardware, spending, or scope decisions.",
-                    "Use available tools to inspect the current source of truth.",
-                    "You are the regular Pi model running this check and the observation adapter. When useful measurable facts appear during the check, publish them with workflow action update. Include the latest tracks in the final submission. Do not require the monitored target to implement a Pi-specific progress API, file, store, schema, or command.",
-                    "Every accepted check must include a concise user-facing report. Add progress tracks only when the target provides measurable facts. Submit observed counts and target-provided finish times; do not invent rates or an ETA.",
-                    config.repair === undefined
-                        ? "Choose route continue or stop."
-                        : "Choose route continue, repair, or stop.",
                 ].join("\n\n");
             },
-            expectedOutput: '{ "route": "continue" | "repair" | "stop", "observation": "current factual state", "report": "concise status update", "progress": { "tracks": [{ "key": "stable-key", "data": { "schema": "pi-workflows.progress.v1", "status": "running", "completed": 1, "total": 2, "unit": "items" } }] } (optional), "repair": { "problem": "fixable issue", "evidence": "observed evidence", "issueFingerprint": "stable issue and target-state fingerprint" } (required for repair), "reason": "short reason" }',
-            validate: (output, context) => validateMonitorCheck(output, configFrom(context.outputs).repair !== undefined),
+            expectedOutput: '{ "route": "wait" | "act" | "stop", "goalState": "complete" | "incomplete" | "blocked", "workState": "running" | "waiting" | "idle" | "failed" | "stopped" | "unknown", "observation": "factual state", "report": "concise factual summary", "targetStateId": "stable observed target-state ID", "authorizedActions": ["safe action already authorized by the user"], "progress": { "tracks": [{ "key": "stable-key", "data": { "schema": "pi-workflows.progress.v1", "status": "running", "completed": 1, "total": 2, "unit": "items" } }] } (optional), "action": { "kind": "advance" | "recover" | "repair", "incomplete": "what remains", "evidence": {}, "nextAction": "one exact action", "authority": { "status": "authorized", "basis": "existing authority", "allowedMutations": ["allowed file, system, or resource"], "forbiddenMutations": [], "costLimit": "recorded limit or not applicable", "providerRuntime": "recorded contract or not applicable", "requiredChecks": [], "stopConditions": [], "allowedRecoveryActions": [], "repository": "optional absolute path", "baseBranch": "optional branch", "merge": false, "repairApproval": { "mode": "auto" | "required" | "skip" } }, "cost": { "paidAction": false, "status": "not-applicable" | "within-limit", "evidence": "cost evidence" }, "defect": { "sharedCodeOrDataDefect": false, "paidWorkers": "not-applicable" | "stopped" | "running", "evidence": "worker evidence" }, "verification": "how to prove success", "failureId": "stable failure ID", "targetStateId": "stable target-state ID" } (required only for act), "reason": "short reason" }',
+            validate: validateMonitorObservation,
         }),
+        guard: compute({ run: guardObservation }),
         estimate: compute({ run: ({ outputs }) => estimateTracks(outputs) }),
         publish_progress: action({
             statusDetail: "publishing monitor progress",
             run: async ({ outputs, publishUpdate, signal }) => {
-                const check = outputs.check;
-                if (check.progress === undefined)
+                const observation = currentObservation(outputs);
+                if (observation.progress === undefined)
                     return { published: 0 };
-                for (const track of check.progress.tracks) {
+                for (const track of observation.progress.tracks) {
                     await waitForUpdateSlot(signal);
                     await publishUpdate({ type: "progress", key: track.key, data: track.data });
                 }
-                return { published: check.progress.tracks.length };
+                return { published: observation.progress.tracks.length };
             },
         }),
         report: notify({
             statusDetail: "queueing monitor update",
-            message: (context) => reportMessage(context),
+            message: reportMessage,
             kind: "progress",
         }),
         decide: compute({
             run: (context) => {
-                const check = context.outputs.check;
+                const observation = currentObservation(context.outputs);
                 const config = configFrom(context.outputs);
-                const checks = completedChecks(context);
-                if (check.route === "stop")
-                    return { route: "stop", reason: check.reason, checks };
+                const checks = completedObservations(context);
+                if (observation.route === "stop")
+                    return { route: "stop", reason: observation.reason, checks };
                 if (checks >= config.maxChecks) {
                     return {
                         route: "stop",
-                        reason: `Reached the ${config.maxChecks}-check safety limit.`,
+                        reason: `Reached the ${config.maxChecks}-observation safety limit.`,
                         checks,
                     };
                 }
-                if (check.route === "repair")
-                    return { route: "repair", reason: check.reason, checks };
-                return { route: "continue", reason: check.reason, checks };
+                if (observation.route === "wait")
+                    return { route: "wait", reason: observation.reason, checks };
+                const request = actionFrom(context.outputs);
+                return { route: request.kind, reason: observation.reason, checks };
             },
         }),
-        repairGuard: compute({
-            run: (context) => repeatedRepairWithoutProgress(context)
-                ? {
-                    route: "blocked",
-                    reason: "The same issue returned after a completed repair with no changed target evidence.",
-                }
-                : { route: "repair", reason: "The issue is new or has changed evidence." },
+        act: agent({
+            statusDetail: "performing authorized monitor action",
+            timeoutMs: DEFAULT_CHECK_TIMEOUT_MINUTES * 60_000,
+            prompt: ({ outputs }) => {
+                const request = actionFrom(outputs);
+                if (request.kind === "repair")
+                    throw new Error("repair must use the composed repair path");
+                return [
+                    `Perform this one ${request.kind} action with normal tools: ${request.nextAction}`,
+                    `Incomplete work: ${request.incomplete}`,
+                    `Evidence: ${JSON.stringify(request.evidence)}`,
+                    `Authorization: ${JSON.stringify(request.authority)}`,
+                    `Cost safety: ${JSON.stringify(request.cost)}`,
+                    `Defect safety: ${JSON.stringify(request.defect)}`,
+                    `Verification: ${request.verification}`,
+                    "Perform only the stated action and only on the allowed files, systems, and resources. Do not plan, document, redesign, broaden scope, change a protected contract, or perform another action. Verify the direct result before submitting. Preserve the supplied failure and target-state IDs exactly.",
+                ].join("\n\n");
+            },
+            expectedOutput: '{ "status": "succeeded" | "failed" | "blocked", "summary": "action performed and real result", "evidence": {}, "verification": "verification performed", "failureId": "unchanged failure ID", "targetStateId": "unchanged target-state ID" }',
+            validate: (output, context) => validateMonitorActionResult(output, actionFrom(context.outputs)),
+        }),
+        repairComplete: compute({
+            run: ({ outputs }) => {
+                const request = actionFrom(outputs);
+                if (request.kind !== "repair")
+                    throw new Error("monitor repair action is missing");
+                return {
+                    status: "succeeded",
+                    summary: request.nextAction,
+                    evidence: outputs.implementation,
+                    verification: request.verification,
+                    failureId: request.failureId,
+                    targetStateId: request.targetStateId,
+                };
+            },
         }),
         repairBlocked: compute({
             run: (context) => ({
                 reason: repairBlockedReason(context.outputs),
-                observation: context.outputs.check.observation,
-                checks: completedChecks(context),
+                observation: currentObservation(context.outputs).observation,
+                checks: completedObservations(context),
                 reported: true,
             }),
         }),
@@ -430,11 +710,11 @@ const monitorWorkflow = defineWorkflow({
             kind: "final",
             message: ({ outputs }) => {
                 const result = outputs.repairBlocked;
-                return `Automatic repair stopped: ${result.reason}`;
+                return `Monitor repair stopped: ${result.reason}`;
             },
         }),
         schedule: action({
-            statusDetail: "scheduling next monitor check",
+            statusDetail: "scheduling next monitor observation",
             run: async ({ outputs, publishUpdate }) => {
                 const config = configFrom(outputs);
                 const lastCheckAt = new Date().toISOString();
@@ -453,7 +733,7 @@ const monitorWorkflow = defineWorkflow({
             },
         }),
         sleep: shell({
-            statusDetail: "waiting for next monitor check",
+            statusDetail: "waiting for next monitor observation",
             timeoutMs: MAX_INTERVAL_MINUTES * 60_000 + NODE_TIMEOUT_MARGIN_MS,
             exec: ({ outputs }) => {
                 const sleepMs = configFrom(outputs).everyMinutes * 60_000;
@@ -468,26 +748,24 @@ const monitorWorkflow = defineWorkflow({
         }),
         finish: compute({
             run: ({ outputs }) => {
-                const check = outputs.check;
+                const observation = currentObservation(outputs);
                 const decision = outputs.decide;
                 const repair = outputs.repairBlocked;
                 return {
-                    reason: repair?.reason ?? decision?.reason ?? check.reason,
-                    observation: check.observation,
+                    reason: repair?.reason ?? decision?.reason ?? observation.reason,
+                    observation: observation.observation,
+                    goalState: repair === undefined ? observation.goalState : "blocked",
+                    workState: observation.workState,
                     checks: decision?.checks ?? 1,
                     reported: true,
-                    ...(outputs.implementation !== undefined
-                        ? { repair: outputs.implementation }
-                        : repair !== undefined
-                            ? { repair }
-                            : {}),
                 };
             },
         }),
     },
     edges: [
-        { from: "prepare", to: "check" },
-        { from: "check", to: "estimate" },
+        { from: "prepare", to: "observe" },
+        { from: "observe", to: "guard" },
+        { from: "guard", to: "estimate" },
         { from: "estimate", to: "publish_progress" },
         { from: "publish_progress", to: "report" },
         { from: "report", to: "decide" },
@@ -495,21 +773,25 @@ const monitorWorkflow = defineWorkflow({
             from: "decide",
             switch: {
                 on: "$.route",
-                cases: { stop: "finish", continue: "schedule", repair: "repairGuard" },
+                cases: {
+                    stop: "finish",
+                    wait: "schedule",
+                    advance: "act",
+                    recover: "act",
+                    repair: "planChange",
+                },
             },
         },
-        {
-            from: "repairGuard",
-            switch: { on: "$.route", cases: { repair: "planChange", blocked: "repairBlocked" } },
-        },
+        { from: "act", to: "observe" },
         { from: "planChange.ready", to: "implementation" },
         { from: "planChange.blocked", to: "repairBlocked" },
-        { from: "implementation.completed", to: "check" },
+        { from: "implementation.completed", to: "repairComplete" },
         { from: "implementation.blocked", to: "repairBlocked" },
+        { from: "repairComplete", to: "observe" },
         { from: "repairBlocked", to: "repairReport" },
         { from: "repairReport", to: "finish" },
         { from: "schedule", to: "sleep" },
-        { from: "sleep", to: "check" },
+        { from: "sleep", to: "observe" },
     ],
 });
 export default monitorWorkflow;