@osolmaz/pi-workflows 0.16.0 → 0.16.2

package/dist/workflows/tool-input.d.ts

@@ -9,6 +9,27 @@ export declare const WorkflowActionSchemas: {
         workflow: Type.TString;
         input: Type.TOptional<Type.TUnknown>;
     }>;
+    readonly restart: TObject<{
+        action: Type.TLiteral<"restart">;
+        runId: Type.TString;
+    }>;
+    readonly "change-settings": TObject<{
+        action: Type.TLiteral<"change-settings">;
+        runId: Type.TOptional<Type.TString>;
+        scopeId: Type.TOptional<Type.TString>;
+        expectedChangeNumber: Type.TOptional<Type.TInteger>;
+        patch: Type.TUnknown;
+    }>;
+    readonly "queue-follow-up": TObject<{
+        action: Type.TLiteral<"queue-follow-up">;
+        runId: Type.TOptional<Type.TString>;
+        prompt: Type.TString;
+    }>;
+    readonly "remove-follow-up": TObject<{
+        action: Type.TLiteral<"remove-follow-up">;
+        runId: Type.TOptional<Type.TString>;
+        followUpId: Type.TString;
+    }>;
     readonly status: TObject<{
         action: Type.TLiteral<"status">;
         runId: Type.TOptional<Type.TString>;

package/dist/workflows/tool-input.js

@@ -9,7 +9,7 @@ const inputSchema = Type.Unknown({
     description: "Ordinary checkpoint answer for answer; protected human decisions require a human channel; optional structured workflow input for start",
 });
 const runIdSchema = Type.String({
-    description: "Run id; optional for status, cancel, and answer",
+    description: "Run id; required for restart and optional for status, cancel, answer, settings, and follow-ups",
 });
 const stepSchema = Type.String({
     description: "Workflow step id; required when action is update or submit",
@@ -32,6 +32,24 @@ export const WorkflowActionSchemas = {
         workflow: workflowSchema,
         input: Type.Optional(inputSchema),
     }, noExtraProperties),
+    restart: Type.Object({ action: Type.Literal("restart"), runId: runIdSchema }, noExtraProperties),
+    "change-settings": Type.Object({
+        action: Type.Literal("change-settings"),
+        runId: Type.Optional(runIdSchema),
+        scopeId: Type.Optional(Type.String()),
+        expectedChangeNumber: Type.Optional(Type.Integer({ minimum: 0 })),
+        patch: Type.Unknown(),
+    }, noExtraProperties),
+    "queue-follow-up": Type.Object({
+        action: Type.Literal("queue-follow-up"),
+        runId: Type.Optional(runIdSchema),
+        prompt: Type.String({ minLength: 1 }),
+    }, noExtraProperties),
+    "remove-follow-up": Type.Object({
+        action: Type.Literal("remove-follow-up"),
+        runId: Type.Optional(runIdSchema),
+        followUpId: Type.String(),
+    }, noExtraProperties),
     status: Type.Object({ action: Type.Literal("status"), runId: Type.Optional(runIdSchema) }, noExtraProperties),
     pause: Type.Object({ action: Type.Literal("pause") }, noExtraProperties),
     resume: Type.Object({ action: Type.Literal("resume") }, noExtraProperties),
@@ -63,6 +81,10 @@ export const WorkflowSubmissionToolParameters = providerObjectSchema(Object.valu
 const workflowInputParsers = {
     list: (value) => parseToolInput(WorkflowActionSchemas.list, value, "workflow"),
     start: (value) => parseToolInput(WorkflowActionSchemas.start, value, "workflow"),
+    restart: (value) => parseToolInput(WorkflowActionSchemas.restart, value, "workflow"),
+    "change-settings": (value) => parseToolInput(WorkflowActionSchemas["change-settings"], value, "workflow"),
+    "queue-follow-up": (value) => parseToolInput(WorkflowActionSchemas["queue-follow-up"], value, "workflow"),
+    "remove-follow-up": (value) => parseToolInput(WorkflowActionSchemas["remove-follow-up"], value, "workflow"),
     status: (value) => parseToolInput(WorkflowActionSchemas.status, value, "workflow"),
     pause: (value) => parseToolInput(WorkflowActionSchemas.pause, value, "workflow"),
     resume: (value) => parseToolInput(WorkflowActionSchemas.resume, value, "workflow"),

package/dist/workflows/tool-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-input.js","sourceRoot":"","sources":["../../src/workflows/tool-input.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-input.js","sourceRoot":"","sources":["../../src/workflows/tool-input.ts"],"names":[],"mappings":"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"}

package/dist/workflows/types.d.ts

@@ -44,9 +44,7 @@ export type WorkflowEffectRecovery = "idempotent" | "manual";
 export type WorkflowManagedEffect = {
     /** Stable external effect category, for example `github.comment`. */
     type: string;
-    /** Stable key. Idempotent adapters must pass this key to the external system. */
-    idempotencyKey: string | ((context: WorkflowNodeContext) => MaybePromise<string>);
-    /** Canonical request data used to reject key reuse with another operation. */
+    /** Canonical request data used to reject engine-owned key reuse with another operation. */
     request: unknown | ((context: WorkflowNodeContext) => MaybePromise<unknown>);
     /** `manual` never retries after an uncertain child exit. */
     recovery: WorkflowEffectRecovery;
@@ -79,9 +77,9 @@ export type WorkflowProgressData = {
 };
 export type WorkflowNodeCommon = {
     /**
-     * Per-node timeout or a callback that derives it from the run context.
-     * Null disables the wall-clock deadline. Omission falls back to the engine
-     * default (15 minutes).
+     * Per-node active-execution timeout or a callback that derives it from the run context.
+     * Waiting, paused, disconnected, and host-down origin-session time does not count.
+     * Null disables the deadline. Omission falls back to the engine default (15 minutes).
      */
     timeoutMs?: number | null | ((context: WorkflowNodeContext) => MaybePromise<number | null>);
     /** Short human-readable label shown in the viewer while the node runs. */
@@ -361,7 +359,7 @@ export type HumanDecisionSettlementRecord = {
     decisionId: string;
     requestDigest: string;
     channel: string;
-    state: "confirmed" | "failed";
+    state: "confirmed" | "failed" | "unknown";
     createdAt: string;
     finishedAt: string;
     errorCode?: string;
@@ -589,7 +587,7 @@ export type WorkflowRunState = {
     currentNode?: string;
     currentAttemptId?: string;
     currentNodeStartedAt?: string;
-    /** Durable wall-clock deadline for the current attempt. Null disables the deadline. */
+    /** Durable active-execution deadline for the current attempt. Null disables the deadline. */
     currentNodeDeadlineAt?: string | null;
     currentSettingsScopeId?: string;
     currentSettingsChangeNumber?: number;

package/dist/workflows/workflow-message-content.d.ts

@@ -0,0 +1,38 @@
+import type { JsonValue } from "../state/json.js";
+import { type WorkflowMessageContent, type WorkflowStepReason } from "../state/workflow-messages.js";
+export declare const WORKFLOW_STEP_MESSAGE_TYPE = "pi-workflows-step";
+export declare const WORKFLOW_DECISION_MESSAGE_TYPE = "pi-workflows-interaction";
+export declare const WORKFLOW_NOTIFICATION_MESSAGE_TYPE = "pi-workflows-notification";
+export declare const WORKFLOW_TERMINAL_MESSAGE_TYPE = "pi-workflows-presentation";
+export declare const WORKFLOW_FOLLOW_UP_MESSAGE_TYPE = "pi-workflows-follow-up";
+export declare function stepWorkflowMessageContent(options: {
+    workflowMessageId: string;
+    requestId: string;
+    contract: JsonValue;
+    reason: WorkflowStepReason;
+}): WorkflowMessageContent;
+export declare function decisionWorkflowMessageContent(options: {
+    workflowMessageId: string;
+    requestId: string;
+    runId: string;
+    contract: JsonValue;
+}): WorkflowMessageContent;
+export declare function notificationWorkflowMessageContent(options: {
+    workflowMessageId: string;
+    notificationId: string;
+    runId: string;
+    kind: "progress" | "final";
+    content: string;
+}): WorkflowMessageContent;
+export declare function terminalWorkflowMessageContent(options: {
+    workflowMessageId: string;
+    runId: string;
+    content: string;
+    details: JsonValue;
+}): WorkflowMessageContent;
+export declare function followUpWorkflowMessageContent(options: {
+    workflowMessageId: string;
+    followUpId: string;
+    runId: string;
+    prompt: string;
+}): WorkflowMessageContent;

package/dist/workflows/workflow-message-content.js

@@ -0,0 +1,157 @@
+import { WORKFLOW_MESSAGE_CONTENT_SCHEMA, } from "../state/workflow-messages.js";
+export const WORKFLOW_STEP_MESSAGE_TYPE = "pi-workflows-step";
+export const WORKFLOW_DECISION_MESSAGE_TYPE = "pi-workflows-interaction";
+export const WORKFLOW_NOTIFICATION_MESSAGE_TYPE = "pi-workflows-notification";
+export const WORKFLOW_TERMINAL_MESSAGE_TYPE = "pi-workflows-presentation";
+export const WORKFLOW_FOLLOW_UP_MESSAGE_TYPE = "pi-workflows-follow-up";
+export function stepWorkflowMessageContent(options) {
+    const outer = requireRecord(options.contract, "Stored workflow step contract");
+    const agent = requireAgentContract(outer.contract);
+    const details = {
+        schema: "pi-workflows.agent-step-message.v1",
+        kind: "step",
+        contract: agent,
+        requestId: options.requestId,
+        workflowMessageId: options.workflowMessageId,
+        reason: options.reason,
+    };
+    if (isRecord(outer.presentation))
+        details.presentation = outer.presentation;
+    return {
+        schema: WORKFLOW_MESSAGE_CONTENT_SCHEMA,
+        customType: WORKFLOW_STEP_MESSAGE_TYPE,
+        content: typeof outer.prompt === "string" ? outer.prompt : "Continue the workflow step.",
+        display: true,
+        details,
+        triggerTurn: true,
+    };
+}
+export function decisionWorkflowMessageContent(options) {
+    const contract = requireRecord(options.contract, "Stored workflow decision contract");
+    return {
+        schema: WORKFLOW_MESSAGE_CONTENT_SCHEMA,
+        customType: WORKFLOW_DECISION_MESSAGE_TYPE,
+        content: decisionPrompt(contract),
+        display: true,
+        details: {
+            workflowMessageId: options.workflowMessageId,
+            requestId: options.requestId,
+            runId: options.runId,
+            kind: "decision",
+        },
+        triggerTurn: false,
+    };
+}
+export function notificationWorkflowMessageContent(options) {
+    return {
+        schema: WORKFLOW_MESSAGE_CONTENT_SCHEMA,
+        customType: WORKFLOW_NOTIFICATION_MESSAGE_TYPE,
+        content: options.content,
+        display: true,
+        details: {
+            workflowMessageId: options.workflowMessageId,
+            notificationId: options.notificationId,
+            runId: options.runId,
+            kind: options.kind,
+        },
+        triggerTurn: false,
+    };
+}
+export function terminalWorkflowMessageContent(options) {
+    return {
+        schema: WORKFLOW_MESSAGE_CONTENT_SCHEMA,
+        customType: WORKFLOW_TERMINAL_MESSAGE_TYPE,
+        content: options.content,
+        display: false,
+        details: {
+            workflowMessageId: options.workflowMessageId,
+            runId: options.runId,
+            kind: "terminal",
+            terminal: options.details,
+        },
+        triggerTurn: true,
+    };
+}
+export function followUpWorkflowMessageContent(options) {
+    return {
+        schema: WORKFLOW_MESSAGE_CONTENT_SCHEMA,
+        customType: WORKFLOW_FOLLOW_UP_MESSAGE_TYPE,
+        content: options.prompt,
+        display: true,
+        details: {
+            workflowMessageId: options.workflowMessageId,
+            followUpId: options.followUpId,
+            runId: options.runId,
+            kind: "followUp",
+        },
+        triggerTurn: true,
+    };
+}
+function requireAgentContract(value) {
+    if (!isRecord(value) ||
+        typeof value.runId !== "string" ||
+        typeof value.workflowName !== "string" ||
+        typeof value.nodeId !== "string" ||
+        typeof value.attemptId !== "string" ||
+        (value.completion !== "submit" && value.completion !== "assistant")) {
+        throw new Error("Stored workflow agent contract is invalid");
+    }
+    return value;
+}
+function decisionPrompt(contract) {
+    const title = typeof contract.title === "string" ? contract.title : "Workflow decision";
+    const presentation = isRecord(contract.presentation) ? contract.presentation : {};
+    const blocks = Array.isArray(presentation.blocks)
+        ? presentation.blocks.flatMap((block) => decisionBlockText(block))
+        : [];
+    const choices = isRecord(contract.choices)
+        ? Object.entries(contract.choices).map(([key, value]) => {
+            const choice = isRecord(value) ? value : {};
+            const label = typeof choice.label === "string" ? choice.label : key;
+            const input = isRecord(choice.input) ? choice.input : undefined;
+            const prompt = input === undefined ? "" : `; input: ${String(input.prompt ?? "text")}`;
+            return `- ${key}: ${label}${prompt}`;
+        })
+        : [];
+    return [
+        title,
+        typeof presentation.summary === "string" ? presentation.summary : "",
+        ...blocks,
+        choices.length === 0 ? "" : `Choices:\n${choices.join("\n")}`,
+        "A human must answer this protected decision with `/workflow answer`.",
+    ]
+        .filter(Boolean)
+        .join("\n\n");
+}
+function decisionBlockText(value) {
+    if (!isRecord(value))
+        return [];
+    if (value.kind === "paragraph" && typeof value.text === "string")
+        return [value.text];
+    if (value.kind === "section" && typeof value.title === "string")
+        return [value.title];
+    if (value.kind === "preformatted" && typeof value.text === "string")
+        return [value.text];
+    if (value.kind === "bullets" && Array.isArray(value.items)) {
+        return [value.items.map((item) => `- ${String(item)}`).join("\n")];
+    }
+    if (value.kind === "fields" && Array.isArray(value.items)) {
+        return [
+            value.items
+                .flatMap((item) => isRecord(item) && typeof item.label === "string" && typeof item.value === "string"
+                ? [`${item.label}: ${item.value}`]
+                : [])
+                .join("\n"),
+        ];
+    }
+    return [];
+}
+function requireRecord(value, label) {
+    if (!isRecord(value))
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=workflow-message-content.js.map

package/dist/workflows/workflow-message-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-message-content.js","sourceRoot":"","sources":["../../src/workflows/workflow-message-content.ts"],"names":[],"mappings":"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"}

package/docs/2026-08-18-herdr-piw-plan.md

@@ -26,7 +26,7 @@ When pi-workflows runs inside Herdr, show a shortcut that opens the current run
 
 ### One package with two host entry points
 
-The package root will contain `herdr-plugin.toml`. Pi loads the existing extension entry point. Herdr loads a `piw` pane entry point from the same package root. A small checked-in JavaScript launcher validates `PI_WORKFLOWS_RUN_DIR` and starts `piw` with an argv array.
+The package root will contain `herdr-plugin.toml`. Pi loads the existing extension entry point. Herdr loads a `piw` pane entry point from the same package root. A small checked-in JavaScript launcher validates the workflow run ID and starts `piw` with an argv array. It uses Herdr's configured executable path when that path works. If Herdr replaced its executable after the server started and the configured path no longer exists, the launcher retries the pane label command through `PATH`.
 
 `pi-workflows herdr setup` explicitly links the current package root with `herdr plugin link`. It is idempotent and never changes plugin registration during normal Pi startup.
 
@@ -58,6 +58,7 @@ Herdr's public snapshot does not expose plugin metadata tokens. The launcher wil
 - All six placements work and preserve the calling pane unless the user selects a focused viewer.
 - Repeated opens and Pi reloads focus the existing run viewer.
 - Failures produce bounded, useful messages and leave no empty tab or workspace.
+- A viewer still opens when the Herdr server supplies a replaced executable path and the current `herdr` command is in `PATH`.
 - The package tarball contains the Herdr manifest and launcher.
 - `osolmaz/pi-workflows` is public, has a root `herdr-plugin.toml`, and has the `herdr-plugin` GitHub topic.
 

package/docs/2026-08-20-durable-workflow-launch-plan.md

@@ -6,7 +6,7 @@ date: 2026-08-20
 
 # Make deferred workflow launches durable
 
-The launch queue and activation contract in this plan remain current. [Deferred workflow turns](DEFERRED_TURNS.md) replaces the launch-specific failure-notification mechanism with the general successor-turn intent contract.
+The launch queue and activation contract in this plan remain current. The send-specific parts are historical. [Terminal workflow messages](DEFERRED_TURNS.md) and the approved [workflow-message restoration plan](2026-09-02-unify-workflow-messages-plan.md) replace every deferred-turn intent and launch-failure sender in this plan with the shared `workflow_messages` path.
 
 ## Goal
 

package/docs/2026-08-25-workflow-follow-ups.md

@@ -6,9 +6,9 @@ date: 2026-08-25
 
 # Continue normal work after a workflow finishes
 
-A workflow can save several normal user prompts while it runs. Pi Workflows sends them in order only after the workflow is officially terminal, its one terminal decision intent is resolved, and its final-response barrier has settled. The completed workflow stays terminal and does not enter its start node again.
+A workflow can save several prompts for normal work while it runs. Pi Workflows sends them in order only after the workflow is officially terminal, its terminal message is sent, and its terminal model turn has ended. The completed workflow stays terminal and does not enter its start node again.
 
-Follow-up prompts are separate from workflow settings. JSON Patch changes future workflow behavior. Follow-up actions create later normal user turns.
+Follow-up prompts are separate from workflow settings. JSON Patch changes future workflow behavior. Follow-up actions create later normal conversation turns.
 
 ## Queue and remove prompts
 
@@ -61,74 +61,50 @@ The host creates the actor and stable request identity. Prompt data cannot claim
 
 ## Ordering and run states
 
-Prompts keep database acceptance order. Several user messages can therefore add several prompts while one workflow response is in progress.
+Prompts keep database acceptance order. Several requests can add several prompts while one workflow response is in progress.
 
 - Running, paused, parked, and waiting workflows accept new prompts.
 - Pause and park keep prompts queued.
-- A checkpoint continuation takes the queued prompts with it in the same transaction that creates the new run.
-- Successful completion records the terminal run and terminal decision intent before prompts can be delivered.
+- A checkpoint continuation keeps queued prompt rows attached to the chain member that accepted them. The host walks the continuation chain to determine their final source outcome; it does not rewrite the rows.
+- Successful completion records the terminal run and terminal workflow message before a follow-up can send.
 - Failed, timed-out, and cancelled workflows cancel every unsent prompt.
 - A terminal workflow rejects new prompts. Repeating an earlier request ID can still return its first result.
 
 A repeated request ID with the same prompt returns the first result. Reusing that ID with different content fails.
 
-## Final response barrier
+Each accepted prompt creates its `workflow_follow_ups` source record and one `followUp` workflow message in one transaction. The message points to its source through `sourceId`; the source row stores no message pointer. The host derives eligibility from saved domain facts. A follow-up is eligible only after the source continuation chain completes successfully, its terminal message turn ends, every earlier accepted follow-up is settled or cancelled, and no nonterminal run, including one waiting for a checkpoint or protected decision, reserves the origin session.
 
-Each run saves one final-response state:
+## One message path
 
-- `not-needed`: the workflow has no final presentation;
-- `pending`: the terminal run has a final response that has not settled;
-- `settled`: the active session branch contains the presentation message and its completed assistant response;
-- `unavailable`: the extension recorded a definite timeout, failure, or restart gap.
+The shared `WorkflowMessageCoordinator` handles follow-ups. There is no follow-up sender.
 
-Successful completion changes queued prompts to `pending_presentation` when a presentation prompt is present. It changes them directly to `ready` when no presentation prompt is present. A settled or unavailable presentation changes pending prompts to ready. Ready prompts still wait while the run's terminal decision intent is unresolved.
+1. Wait for the terminal outcome, sent terminal workflow message, and matching model-turn end.
+2. After every host connection, wait for the complete origin-session view and report the active branch.
+3. Wait until the host view names this `followUp` as the next eligible pending message, Pi is idle, and no earlier workflow message is active.
+4. Keep its ID in the coordinator's in-memory queued map and report a matching active-branch entry when one already exists.
+5. Otherwise, recheck synchronously that Pi is idle, has no pending input, the message is absent, and the connection still owns the active coordinator epoch. Call documented `pi.sendMessage()` with the follow-up prompt and `triggerTurn: true` without an `await` between the check and call.
+6. Report the active branch so the host saves the observed Pi entry ID and marks the message `sent`.
+7. Wait for that turn and any workflow it starts to finish before the next follow-up becomes eligible.
 
-The extension includes the run ID in documented presentation-message details. On restart, it scans the active durable branch for the presentation message and completed assistant response. It also recovers the terminal intent before follow-up delivery. It saves observed entry IDs and does not treat an in-memory event alone as proof.
-
-## Delivery
-
-The follow-up coordinator handles one prompt at a time:
-
-1. Wait for terminal workflow state, a resolved terminal decision intent, and a completed final-response barrier.
-2. Wait for the target session to be idle and have no active workflow.
-3. Claim the first ready prompt with a lease.
-4. Scan the active session branch for its stable follow-up ID.
-5. If the message already exists, save its session entry ID without sending it again.
-6. Otherwise, call documented `pi.sendUserMessage` with the prompt and a short nonsecret ID in a Markdown comment.
-7. After Pi saves the normal user message, scan the branch and save its entry ID and send time.
-8. Wait for that user turn and any workflow it starts to finish before taking the next prompt.
-
-`pi.sendUserMessage` returns no message ID. Branch evidence is required after a new send and after restart.
-
-The follow-up message is a normal user message. It can start normal work or a different workflow. It cannot resume or reactivate the completed workflow. A `restart` selected from the terminal decision is a separate immutable workflow run, not a follow-up prompt.
+The follow-up custom message starts normal conversation work and can use a user-style renderer. Its internal workflow message ID stays in custom details and does not enter provider-facing content. It can ask the model to start another workflow, but it cannot resume or reactivate the completed workflow. Text that starts with `/` remains plain model input; a custom message cannot dispatch a Pi slash command or expand a prompt template. A `restart` chosen from the terminal turn creates a separate immutable workflow run.
 
 Follow-up storage contains only prompts explicitly queued through this feature. Terminal restart does not find, copy, hash, or store an original user message. Conversation history remains owned by Pi.
 
 ## Failure handling
 
-- A crash before claim leaves the prompt ready.
-- A crash after claim lets another process continue after the lease expires.
-- A crash before message append leaves no branch evidence and permits a retry.
-- A crash after append but before the database update is resolved by finding the follow-up ID in the active branch.
-- A definite send failure releases the claim.
-- An unavailable session leaves the prompt pending.
-- Branching follows the active Pi branch. A message on another branch does not count as delivered on the active branch.
+- A crash before send leaves the workflow message `pending`.
+- A crash after send but before the branch report also leaves it `pending`; reconnect reports the active branch before another send.
+- A matching hidden workflow message ID changes a pending or cancelled message to `sent` because the Pi entry already exists.
+- An unavailable session leaves the workflow message `pending`.
+- An entry on another Pi branch does not confirm the send on the active branch.
+- A stale coordinator epoch cannot send or report message state.
 
-Current documented Pi APIs cannot guarantee exactly-once model execution. Pi Workflows can guarantee only its saved order, claim, active-branch evidence, and local delivery state. Delivery also needs a later live Pi process, database, target session, and provider. This feature adds no external service.
+Documented Pi APIs do not prove cross-branch absence or exactly-once model execution. Pi Workflows guarantees only its saved order, message state, active-branch evidence, and local state. Sending also needs a later live Pi process, target session, and provider. This feature adds no external service.
 
 ## Saved states
 
-A follow-up is in one of these states:
-
-- `queued`;
-- `pending_presentation`;
-- `ready`;
-- `sent`;
-- `removed`;
-- `cancelled`.
-
-A lease is temporary claim data, not another follow-up state.
+`workflow_follow_ups` stores each prompt, source, queue order, and whether the source was removed or cancelled. It does not copy a workflow message ID, message state, or Pi entry ID. `workflow_messages` owns `pending`, `sent`, and `cancelled` state and points back to the source row.
 
-`workflow_follow_up_queues` stores presentation state and per-run order. `workflow_follow_ups` stores each prompt, source, state, session entry ID, and times. Prompt text stays in the existing content-addressed value store. Normal status views show IDs, order, source type, and state without printing full prompts.
+Prompt text stays in the existing content-addressed value store. Normal status views show IDs, order, source type, and state without printing full prompts.
 
-This is part of the same alpha hard change as workflow settings. It adds no Pi core change, private Pi API, external queue, compatibility reader, dual write, alias, fallback, or second schema.
+This is an alpha hard change. It keeps schema version 1 and adds no Pi core change, private Pi API, external queue, compatibility reader, dual write, alias, fallback, or second schema.

package/docs/2026-08-30-out-of-process-workflow-host-plan.md

@@ -6,7 +6,7 @@ date: 2026-08-30
 
 # Run workflows outside Pi
 
-Status: implemented on the `feat/out-of-process-workflow-host` branch. The implementation keeps schema version 1, uses one global on-demand host, and has no embedded production fallback.
+Status: implemented. The implementation keeps schema version 1, uses one global on-demand host, and has no embedded production fallback. The approved [workflow-message restoration plan](2026-09-02-unify-workflow-messages-plan.md) fixes the later model-turn status bug and restores session features that the hard cut removed.
 
 A live workflow lost its lease while it was still working. The workflow engine kept the Node.js event loop busy, so its renewal timer did not run before the 30-second lease expired. The next state write used a generic error, the extension treated the error as a crash, and durable state was left with a running queue row, a running attempt, an expired lease, and a separate failed audit event.
 
@@ -209,7 +209,7 @@ Keep one active interactive request per Pi session. Other requests remain ordere
 
 A protected human decision is displayed without starting a model turn. The model-facing workflow tool rejects it. A person answers it through the origin Pi session, while an ordinary checkpoint keeps its model-facing answer path.
 
-Notify nodes use the durable notification outbox. A root presentation prompt creates a durable terminal turn intent before completion and becomes eligible in the terminal transaction. The origin Pi session claims and adopts both message types through the host.
+Notify nodes and terminal results create `workflow_messages` records in the same transaction as their source facts. The origin Pi session claims and adopts both message kinds through the one shared coordinator. There is no notification outbox or terminal-turn intent send path.
 
 Detached workflows can use host-managed `pi --mode rpc` children. Their execution mode and origin are durable provenance.
 
@@ -236,7 +236,7 @@ The new state shape will add the minimum durable records needed for:
 - child process epochs and exits;
 - uncertain effects when existing effect rows cannot express the state.
 
-Reuse current notifications, turn intents, attempts, and effects when they already provide the required contract. Add no parallel record for the same fact.
+Reuse attempts, effects, and feature-specific source records when they already provide the required contract. `workflow_messages` is the only record for content that Pi must add to an origin session. Add no parallel send record for the same fact.
 
 ## Part 10: Hard cutover
 

package/docs/2026-09-01-restore-session-delivery-controls-plan.md

@@ -6,6 +6,10 @@ date: 2026-09-01
 
 # Restore workflow session delivery and controls
 
+## Follow-up
+
+This repair restored the widget, Escape pause, and the first shared sender. Version 0.16.0 still has a model-turn status bug and did not preserve all earlier session features. The approved [workflow-message restoration plan](2026-09-02-unify-workflow-messages-plan.md) replaces separate send records with one workflow-message contract and restores the remaining behavior.
+
 The out-of-process workflow host removed the Pi workflow widget and Escape-to-pause behavior. A later delivery safety fix also caused normal polling to report `Interactive request presentation claim conflict`. This plan restores those features and fixes delivery without bringing back the embedded workflow runtime.
 
 [Workflow host](WORKFLOW_HOST.md) remains the process and state specification. [Workflow step messages](WORKFLOW_STEP_MESSAGES.md) remains the session message specification. This plan records the cause, scope, implementation order, and acceptance checks for the repair.

package/docs/2026-09-01-unified-workflow-client-plan.md

@@ -7,6 +7,10 @@ status: implemented
 
 # Unify live workflow clients
 
+## Follow-up
+
+The single host, client protocol, and run view remain the correct base. Version 0.16.0 still uses a short activity lease, clears terminal session display too soon, and did not preserve all session features during the cut. [Unify workflow messages and restore hosted behavior](2026-09-02-unify-workflow-messages-plan.md) is the approved follow-up. It replaces the activity lease with Pi turn events and gives all Pi-bound workflow content one shared message path.
+
 ## Goal
 
 Give every live Pi Workflows interface one source of truth.
@@ -131,7 +135,7 @@ The host produces `pi-workflows.run-view.v1` from one consistent host-side read.
 - live and interruption facts;
 - a `display` object with effective status, activity kind, allowed controls, and either the complete inline reason or a small notice plus a digest-bound `reasonContent` reference.
 
-The run-list row contains the same `display` object. The origin-session response contains the complete active run view or no active run plus an ordered byte-bounded window of pending delivery records and their complete count. It does not retain an older terminal run after the active session reservation ends. Those records include the request, delivery, contract, revision, presentation entry, and claim facts that the shared delivery coordinator needs for steps, decisions, notifications, and terminal turns. The host returns this session response from one consistent read. A client does not resolve a reservation, load a run, or inspect delivery tables in separate reads.
+The run-list row contains the same `display` object. The origin-session response contains the complete active run view or no active run plus an ordered byte-bounded window of workflow messages and their complete count. The approved follow-up also retains the newest terminal run for its bounded display period. Message records include the source, content reference, order, send state, and Pi entry needed by the shared coordinator. The host returns this session response from one consistent read. A client does not resolve a reservation, load a run, or inspect message tables in separate reads.
 
 Large history remains available through byte-bounded pages. The host counts histories and reads only the selected SQLite ranges. A page has an item limit and an encoded byte budget. It echoes the requested cursor and run-view revision, and a client rejects a response that no longer matches its request or current snapshot. Large workflow topology has bounded node, edge, graph-step, and transition projections plus durable references to the complete original definition and complete graph history. TypeScript clients assemble every run-history page for one revision and hydrate the complete definition. Values that do not fit inline use digest-bound opaque content references, and `view.content` returns the complete value in verified chunks before a TypeScript non-interactive viewer emits the complete run or the extension updates its widget. TypeScript and Rust load the complete graph steps and transitions through the same verified content interface. Rust also requests and verifies the complete referenced workflow definition, decodes only the complete value, and then builds the graph layout. Session-event pages include the replay checkpoint immediately before their first event. A large checkpoint uses the same content protocol. TypeScript hydrates it with the run view, and Rust requests and resolves it before replay. The complete logical result remains available. The client protocol does not add an arbitrary user-visible truncation.
 

package/docs/2026-09-02-installed-live-e2e-plan.md

@@ -78,6 +78,14 @@ An API-key run can use an ephemeral agent directory. Pi receives the caller's ex
 
 Before a model call, the runner will execute Pi's documented `auth check` command for the exact provider and model. It will stop before the workflow starts when authentication or model resolution fails.
 
+## Startup recovery
+
+Before Pi starts, the runner creates an incompatible state fixture inside the guarded temporary home. It then starts Pi and waits for the extension's one bounded host-unavailable warning. The runner moves the fixture intact, as the alpha reset instruction requires, and starts the host through the installed client.
+
+The same Pi process must establish its origin-session subscription without a restart. An observer subscription verifies that the host has a coordinator epoch for that session. More polling must not produce a second host-unavailable warning. The normal runtime workflow then proves that the recovered session receives live widget updates.
+
+This check reproduces the case where Pi starts before the host can open durable state. It changes no operator database or Pi session.
+
 ## Runtime workflow
 
 The first workflow does not call a model. It has one delayed compute step and a fixed final output.
@@ -179,8 +187,14 @@ Add tests for:
 - timeout, missing-run, and host connection failures;
 - packed npm installation with production dependencies;
 - extension source isolation in base Pi;
+- origin-session reconnection after initial host startup fails;
+- one warning during the simulated outage;
 - RPC widget and status transitions;
 - pause with no active worker;
+- abort of an active origin-session model turn;
+- one new resumed step message and one fresh model turn after resume;
+- protected decision revision stability across pause and resume;
+- a complete session capture with no false host-interruption diagnostic;
 - resume and completion;
 - exact provider and model validation;
 - model fallback rejection;
@@ -222,4 +236,4 @@ The implementation uses documented Pi package installation and CLI model selecti
 
 ## Completion criteria
 
-The work is complete when a clean base Pi process loads only the packed Pi Workflows package. The deterministic runtime workflow must pass every widget and lifecycle check, while `piw --once` must agree with Pi and the host. An explicitly selected built-in model must complete the structured agent workflow. Cleanup must leave no process or large temporary directory, and all repository checks must pass.
+The work is complete when a clean base Pi process loads only the packed Pi Workflows package. The same Pi process must recover after the temporary incompatible-state gate is removed. The deterministic runtime workflow must pass every widget and lifecycle check, while `piw --once` must agree with Pi and the host. The full Pi mock-provider test must abort an active origin-session workflow turn, resume it through a distinct resumed step message, complete through one fresh model turn, and leave a complete session capture. The installed real-model check must reject a false host-interruption diagnostic. An explicitly selected built-in model must complete the structured agent workflow. Cleanup must leave no process or large temporary directory, and all repository checks must pass.