@fragno-dev/pi-harness 0.0.0-stage → 0.0.3

package/dist/node/pi/workflows/interactive-chat-workflow.js

@@ -0,0 +1,219 @@
+import { PI_SESSION_COMMAND_STEP_PREFIX } from "../types.js";
+import { agentMessageSchema, piSessionCommandPayloadSchema } from "../route-schemas.js";
+import { schedulePiOperationCompletedHook } from "../harness/pi-operation-completed.js";
+import { applyWorkflowAgentHarnessStepResult, createPiHarnessSessionState, hasSummarizableCompactionHistory, restoreWorkflowBackedSession, withWorkflowAgentHarness } from "./workflow-agent-harness.js";
+import { AgentHarness, AgentHarnessError, CompactionError, DEFAULT_COMPACTION_SETTINGS, prepareCompaction } from "@earendil-works/pi-agent-core";
+import { z } from "zod";
+import { NonRetryableError, defineWorkflow } from "@fragno-dev/workflows/workflow";
+//#region src/pi/workflows/interactive-chat-workflow.ts
+const WAIT_FOR_COMMAND_TIMEOUT = "7 days";
+const INTERACTIVE_CHAT_WORKFLOW_NAME = "interactive-chat-workflow";
+const interactiveChatWorkflowParamsSchema = z.object({
+	metadata: z.record(z.string(), z.unknown()).optional(),
+	actor: z.unknown().optional(),
+	initialMessages: z.array(agentMessageSchema).optional(),
+	systemPrompt: z.string().optional(),
+	thinkingLevel: z.enum([
+		"off",
+		"minimal",
+		"low",
+		"medium",
+		"high",
+		"xhigh",
+		"max"
+	]).optional()
+});
+const logInteractiveChatAssistantError = (assistant, context) => {
+	if (assistant.stopReason !== "error") return;
+	console.error("Pi interactive chat model operation failed.", {
+		...context,
+		provider: assistant.provider,
+		model: assistant.model,
+		...assistant.errorMessage !== void 0 ? { errorMessage: assistant.errorMessage } : {}
+	});
+};
+/**
+* Creates an interactive command loop backed entirely by workflow history.
+*
+* Each prompt is a separate `step.do`, while `sessionState` carries the reduced Pi session between
+* those steps. Workflow replay rebuilds the same state by replaying completed step results in order.
+*/
+const createInteractiveChatWorkflow = (config) => {
+	const workflowName = config.name ?? "interactive-chat-workflow";
+	const commandTimeout = config.commandTimeout ?? WAIT_FOR_COMMAND_TIMEOUT;
+	return defineWorkflow({
+		name: workflowName,
+		schema: interactiveChatWorkflowParamsSchema
+	}, async (event, step) => {
+		const params = interactiveChatWorkflowParamsSchema.parse(event.payload ?? {});
+		const initialEvent = {
+			...event,
+			payload: params
+		};
+		const harnessOptions = typeof config.options === "function" ? await config.options(initialEvent) : config.options;
+		let sessionState = createPiHarnessSessionState({
+			metadata: {
+				id: event.instanceId,
+				createdAt: event.timestamp.toISOString()
+			},
+			initialMessages: params.initialMessages
+		});
+		while (true) {
+			const commandEvent = await step.waitForEvent("wait-command", {
+				type: "command",
+				timeout: commandTimeout
+			});
+			const queuedCommand = piSessionCommandPayloadSchema.parse(commandEvent.payload);
+			const command = queuedCommand.kind === "steer" || queuedCommand.kind === "followUp" ? {
+				...queuedCommand,
+				kind: "prompt"
+			} : queuedCommand;
+			if (command.kind === "abort") continue;
+			const invocation = {
+				stepName: `${PI_SESSION_COMMAND_STEP_PREFIX}${command.commandId}`,
+				operationId: `${workflowName}:${event.instanceId}:command:${command.commandId}`
+			};
+			const committedResult = await step.do(invocation.stepName, async (tx) => {
+				const restored = restoreWorkflowBackedSession({
+					operationId: invocation.operationId,
+					state: sessionState,
+					previousEmissions: await tx.previousEmissions(),
+					models: harnessOptions.models
+				});
+				const harness = new AgentHarness({
+					...harnessOptions,
+					...restored.options
+				});
+				return await withWorkflowAgentHarness({
+					restored,
+					harness,
+					tx,
+					observeLiveEvents: (onLiveEvent) => {
+						onLiveEvent("command", async (event) => {
+							const controlCommand = piSessionCommandPayloadSchema.parse(event.payload);
+							switch (controlCommand.kind) {
+								case "abort":
+									await harness.abort();
+									event.consume();
+									break;
+								case "steer":
+								case "followUp": {
+									const { text, images } = controlCommand.input;
+									const promptOptions = images ? { images } : void 0;
+									if (controlCommand.kind === "steer") await harness.steer(text, promptOptions);
+									else await harness.followUp(text, promptOptions);
+									event.consume();
+									break;
+								}
+								case "prompt":
+								case "skill":
+								case "promptFromTemplate":
+								case "compact": break;
+							}
+						});
+					},
+					checkpointTerminalAssistantError: true,
+					runDurableStep: async () => {
+						await config.beforeOperation?.({
+							actor: params.actor ?? null,
+							workflowName,
+							sessionId: event.instanceId,
+							metadata: params.metadata ?? null,
+							stepName: invocation.stepName,
+							operationId: invocation.operationId,
+							operation: command.kind
+						});
+						tx.emit({
+							kind: "pi-session-command-start",
+							command: {
+								commandId: command.commandId,
+								kind: command.kind
+							}
+						});
+						const logAssistantError = (commandKind, assistant) => {
+							logInteractiveChatAssistantError(assistant, {
+								workflowName,
+								sessionId: event.instanceId,
+								commandId: command.commandId,
+								commandKind
+							});
+						};
+						switch (command.kind) {
+							case "prompt": {
+								const assistant = await harness.prompt(command.input.text, command.input.images ? { images: command.input.images } : void 0);
+								logAssistantError("prompt", assistant);
+								return assistant;
+							}
+							case "skill": {
+								const assistant = await harness.skill(command.input.name, command.input.additionalInstructions);
+								logAssistantError("skill", assistant);
+								return assistant;
+							}
+							case "promptFromTemplate": {
+								const assistant = await harness.promptFromTemplate(command.input.name, command.input.args);
+								logAssistantError("promptFromTemplate", assistant);
+								return assistant;
+							}
+							case "compact": {
+								const preparationResult = prepareCompaction(await restored.session.getBranch(), DEFAULT_COMPACTION_SETTINGS);
+								if (!preparationResult.ok) {
+									if (preparationResult.error.code === "invalid_session") throw new NonRetryableError(`PI_COMPACTION_INVALID_SESSION: ${preparationResult.error.message}`);
+									throw preparationResult.error;
+								}
+								if (!preparationResult.value || !hasSummarizableCompactionHistory(preparationResult.value)) return {
+									kind: "compact",
+									commandId: command.commandId,
+									status: "rejected",
+									code: "nothing_to_compact",
+									message: "Nothing to compact."
+								};
+								try {
+									await harness.compact(command.input.customInstructions);
+									return {
+										kind: "compact",
+										commandId: command.commandId,
+										status: "succeeded"
+									};
+								} catch (error) {
+									if (!(error instanceof AgentHarnessError) || error.code !== "compaction") throw error;
+									if (!(error.cause instanceof CompactionError)) throw error;
+									switch (error.cause.code) {
+										case "aborted":
+										case "summarization_failed": return {
+											kind: "compact",
+											commandId: command.commandId,
+											status: "rejected",
+											code: "compaction_failed",
+											message: error.cause.message
+										};
+										case "invalid_session": throw new NonRetryableError(`PI_COMPACTION_INVALID_SESSION: ${error.cause.message}`);
+										case "unknown": throw error;
+									}
+								}
+							}
+						}
+						throw new Error("Unsupported durable Pi session command.");
+					},
+					onTerminalOutcome: ({ operationEntries }) => {
+						schedulePiOperationCompletedHook({
+							tx,
+							actor: params.actor ?? null,
+							workflowName,
+							sessionId: sessionState.metadata.id,
+							metadata: params.metadata ?? null,
+							stepName: invocation.stepName,
+							operationId: invocation.operationId,
+							operation: command.kind,
+							operationEntries
+						});
+					}
+				});
+			});
+			sessionState = applyWorkflowAgentHarnessStepResult(sessionState, committedResult);
+		}
+	});
+};
+//#endregion
+export { INTERACTIVE_CHAT_WORKFLOW_NAME, createInteractiveChatWorkflow, interactiveChatWorkflowParamsSchema };
+
+//# sourceMappingURL=interactive-chat-workflow.js.map

package/dist/node/pi/workflows/interactive-chat-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-chat-workflow.js","names":[],"sources":["../../../../src/pi/workflows/interactive-chat-workflow.ts"],"sourcesContent":["import type { WorkflowDuration, WorkflowEvent } from \"@fragno-dev/workflows/workflow\";\nimport { defineWorkflow, NonRetryableError } from \"@fragno-dev/workflows/workflow\";\nimport { z } from \"zod\";\n\nimport {\n  AgentHarness,\n  AgentHarnessError,\n  CompactionError,\n  DEFAULT_COMPACTION_SETTINGS,\n  prepareCompaction,\n  type AgentMessage,\n  type ThinkingLevel,\n} from \"@earendil-works/pi-agent-core\";\nimport type { AssistantMessage } from \"@earendil-works/pi-ai\";\n\nimport { schedulePiOperationCompletedHook } from \"../harness/pi-operation-completed\";\nimport { agentMessageSchema, piSessionCommandPayloadSchema } from \"../route-schemas\";\nimport type { PiSessionCommandStartEmission } from \"../session-command-protocol\";\nimport {\n  PI_SESSION_COMMAND_STEP_PREFIX,\n  type PiCompactCommandOutcome,\n  type PiOperationDetails,\n  type PiSessionMetadata,\n} from \"../types\";\nimport {\n  applyWorkflowAgentHarnessStepResult,\n  createPiHarnessSessionState,\n  hasSummarizableCompactionHistory,\n  restoreWorkflowBackedSession,\n  withWorkflowAgentHarness,\n  type WorkflowAgentHarnessOptions,\n} from \"./workflow-agent-harness\";\n\nconst WAIT_FOR_COMMAND_TIMEOUT = \"7 days\" as const;\nexport const INTERACTIVE_CHAT_WORKFLOW_NAME = \"interactive-chat-workflow\";\n\nexport type InteractiveChatWorkflowParams = {\n  /** Application-owned session metadata supplied by the session creation route. */\n  metadata?: PiSessionMetadata;\n  /** Opaque workflow-owned value forwarded to operation completion hooks. */\n  actor?: unknown;\n  initialMessages?: AgentMessage[];\n  systemPrompt?: string;\n  thinkingLevel?: ThinkingLevel;\n};\n\nexport const interactiveChatWorkflowParamsSchema: z.ZodType<InteractiveChatWorkflowParams> =\n  z.object({\n    metadata: z.record(z.string(), z.unknown()).optional(),\n    actor: z.unknown().optional(),\n    initialMessages: z.array(agentMessageSchema).optional(),\n    systemPrompt: z.string().optional(),\n    thinkingLevel: z.enum([\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"]).optional(),\n  });\n\nconst logInteractiveChatAssistantError = (\n  assistant: AssistantMessage,\n  context: {\n    workflowName: string;\n    sessionId: string;\n    commandId: string;\n    commandKind: \"prompt\" | \"skill\" | \"promptFromTemplate\";\n  },\n): void => {\n  if (assistant.stopReason !== \"error\") {\n    return;\n  }\n\n  console.error(\"Pi interactive chat model operation failed.\", {\n    ...context,\n    provider: assistant.provider,\n    model: assistant.model,\n    ...(assistant.errorMessage !== undefined ? { errorMessage: assistant.errorMessage } : {}),\n  });\n};\n\nexport type CreateInteractiveChatWorkflowOptions = {\n  name?: string;\n  commandTimeout?: WorkflowDuration;\n  /**\n   * Runs inside each durable command attempt before Pi invokes a model. Throw to reject the\n   * operation; retries may call this again until the command step commits.\n   */\n  beforeOperation?: (input: PiOperationDetails) => Promise<void> | void;\n  options:\n    | WorkflowAgentHarnessOptions\n    | ((\n        event: WorkflowEvent<InteractiveChatWorkflowParams>,\n      ) => WorkflowAgentHarnessOptions | Promise<WorkflowAgentHarnessOptions>);\n};\n\n/**\n * Creates an interactive command loop backed entirely by workflow history.\n *\n * Each prompt is a separate `step.do`, while `sessionState` carries the reduced Pi session between\n * those steps. Workflow replay rebuilds the same state by replaying completed step results in order.\n */\nexport const createInteractiveChatWorkflow = (config: CreateInteractiveChatWorkflowOptions) => {\n  const workflowName = config.name ?? INTERACTIVE_CHAT_WORKFLOW_NAME;\n  const commandTimeout = config.commandTimeout ?? WAIT_FOR_COMMAND_TIMEOUT;\n\n  return defineWorkflow(\n    {\n      name: workflowName,\n      schema: interactiveChatWorkflowParamsSchema,\n    },\n    async (event, step) => {\n      const params = interactiveChatWorkflowParamsSchema.parse(event.payload ?? {});\n      const initialEvent: WorkflowEvent<InteractiveChatWorkflowParams> = {\n        ...event,\n        payload: params,\n      };\n      // AgentHarness options are runtime dependencies, so resolve them outside durable model steps\n      // and reconstruct them whenever the workflow replays.\n      const harnessOptions =\n        typeof config.options === \"function\" ? await config.options(initialEvent) : config.options;\n      let sessionState = createPiHarnessSessionState({\n        metadata: {\n          id: event.instanceId,\n          createdAt: event.timestamp.toISOString(),\n        },\n        initialMessages: params.initialMessages,\n      });\n      while (true) {\n        const commandEvent = await step.waitForEvent(\"wait-command\", {\n          type: \"command\",\n          timeout: commandTimeout,\n        });\n        const queuedCommand = piSessionCommandPayloadSchema.parse(commandEvent.payload);\n\n        // Controls consumed by a live harness normally never reach this durable wait. If steer or\n        // followUp does reach it, the targeted operation is no longer active, so preserve its text.\n\n        const command =\n          queuedCommand.kind === \"steer\" || queuedCommand.kind === \"followUp\"\n            ? { ...queuedCommand, kind: \"prompt\" as const }\n            : queuedCommand;\n\n        if (command.kind === \"abort\") {\n          continue;\n        }\n\n        const invocation = {\n          stepName: `${PI_SESSION_COMMAND_STEP_PREFIX}${command.commandId}`,\n          operationId: `${workflowName}:${event.instanceId}:command:${command.commandId}`,\n        };\n        const committedResult = await step.do(invocation.stepName, async (tx) => {\n          const restored = restoreWorkflowBackedSession({\n            operationId: invocation.operationId,\n            state: sessionState,\n            previousEmissions: await tx.previousEmissions(),\n            models: harnessOptions.models,\n          });\n          const harness = new AgentHarness({ ...harnessOptions, ...restored.options });\n\n          return await withWorkflowAgentHarness({\n            restored,\n            harness,\n            tx,\n            observeLiveEvents: (onLiveEvent) => {\n              // Durable commands stay unconsumed so the outer loop executes them as the next step.\n              onLiveEvent(\"command\", async (event) => {\n                const controlCommand = piSessionCommandPayloadSchema.parse(event.payload);\n\n                switch (controlCommand.kind) {\n                  case \"abort\":\n                    await harness.abort();\n                    event.consume();\n                    break;\n                  case \"steer\":\n                  case \"followUp\": {\n                    const { text, images } = controlCommand.input;\n                    const promptOptions = images ? { images } : undefined;\n                    if (controlCommand.kind === \"steer\") {\n                      await harness.steer(text, promptOptions);\n                    } else {\n                      await harness.followUp(text, promptOptions);\n                    }\n                    event.consume();\n                    break;\n                  }\n                  case \"prompt\":\n                  case \"skill\":\n                  case \"promptFromTemplate\":\n                  case \"compact\":\n                    break;\n                }\n              });\n            },\n            checkpointTerminalAssistantError: true,\n            runDurableStep: async () => {\n              await config.beforeOperation?.({\n                actor: params.actor ?? null,\n                workflowName,\n                sessionId: event.instanceId,\n                metadata: params.metadata ?? null,\n                stepName: invocation.stepName,\n                operationId: invocation.operationId,\n                operation: command.kind,\n              });\n\n              tx.emit({\n                kind: \"pi-session-command-start\",\n                command: { commandId: command.commandId, kind: command.kind },\n              } satisfies PiSessionCommandStartEmission);\n\n              const logAssistantError = (\n                commandKind: \"prompt\" | \"skill\" | \"promptFromTemplate\",\n                assistant: AssistantMessage,\n              ) => {\n                logInteractiveChatAssistantError(assistant, {\n                  workflowName,\n                  sessionId: event.instanceId,\n                  commandId: command.commandId,\n                  commandKind,\n                });\n              };\n\n              switch (command.kind) {\n                case \"prompt\": {\n                  const assistant = await harness.prompt(\n                    command.input.text,\n                    command.input.images ? { images: command.input.images } : undefined,\n                  );\n                  logAssistantError(\"prompt\", assistant);\n                  return assistant;\n                }\n                case \"skill\": {\n                  const assistant = await harness.skill(\n                    command.input.name,\n                    command.input.additionalInstructions,\n                  );\n                  logAssistantError(\"skill\", assistant);\n                  return assistant;\n                }\n                case \"promptFromTemplate\": {\n                  const assistant = await harness.promptFromTemplate(\n                    command.input.name,\n                    command.input.args,\n                  );\n                  logAssistantError(\"promptFromTemplate\", assistant);\n                  return assistant;\n                }\n                case \"compact\": {\n                  const preparationResult = prepareCompaction(\n                    await restored.session.getBranch(),\n                    DEFAULT_COMPACTION_SETTINGS,\n                  );\n                  if (!preparationResult.ok) {\n                    if (preparationResult.error.code === \"invalid_session\") {\n                      throw new NonRetryableError(\n                        `PI_COMPACTION_INVALID_SESSION: ${preparationResult.error.message}`,\n                      );\n                    }\n                    throw preparationResult.error;\n                  }\n                  if (\n                    !preparationResult.value ||\n                    !hasSummarizableCompactionHistory(preparationResult.value)\n                  ) {\n                    return {\n                      kind: \"compact\",\n                      commandId: command.commandId,\n                      status: \"rejected\",\n                      code: \"nothing_to_compact\",\n                      message: \"Nothing to compact.\",\n                    } satisfies PiCompactCommandOutcome;\n                  }\n\n                  try {\n                    await harness.compact(command.input.customInstructions);\n                    return {\n                      kind: \"compact\",\n                      commandId: command.commandId,\n                      status: \"succeeded\",\n                    } satisfies PiCompactCommandOutcome;\n                  } catch (error) {\n                    if (!(error instanceof AgentHarnessError) || error.code !== \"compaction\") {\n                      throw error;\n                    }\n                    if (!(error.cause instanceof CompactionError)) {\n                      throw error;\n                    }\n\n                    switch (error.cause.code) {\n                      case \"aborted\":\n                      case \"summarization_failed\":\n                        return {\n                          kind: \"compact\",\n                          commandId: command.commandId,\n                          status: \"rejected\",\n                          code: \"compaction_failed\",\n                          message: error.cause.message,\n                        } satisfies PiCompactCommandOutcome;\n                      case \"invalid_session\":\n                        throw new NonRetryableError(\n                          `PI_COMPACTION_INVALID_SESSION: ${error.cause.message}`,\n                        );\n                      case \"unknown\":\n                        throw error;\n                    }\n                  }\n                }\n              }\n\n              throw new Error(\"Unsupported durable Pi session command.\");\n            },\n            // Accounting is registered before the adapter accepts or rejects the terminal\n            // assistant, so failed model calls are still recorded by the terminal-error\n            // transaction path.\n            onTerminalOutcome: ({ operationEntries }) => {\n              schedulePiOperationCompletedHook({\n                tx,\n                actor: params.actor ?? null,\n                workflowName,\n                sessionId: sessionState.metadata.id,\n                metadata: params.metadata ?? null,\n                stepName: invocation.stepName,\n                operationId: invocation.operationId,\n                operation: command.kind,\n                operationEntries,\n              });\n            },\n          });\n        });\n        // Only reduce after the durable step completes; interrupted attempts reconstruct their\n        // uncommitted entries from step emissions instead.\n        sessionState = applyWorkflowAgentHarnessStepResult(sessionState, committedResult);\n      }\n    },\n  );\n};\n"],"mappings":"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"}

package/dist/node/pi/workflows/workflow-agent-harness.d.ts

@@ -0,0 +1,142 @@
+import { PiHarnessEncodedEventEmission } from "../harness/agent-harness-event-protocol.js";
+import { WorkflowBackedSessionStorage } from "../harness/session-storage.js";
+import { AgentHarness, AgentHarnessOptions, AgentHarnessTool, AgentMessage, CompactionPreparation, PromptTemplate, Session, SessionMetadata, SessionTreeEntry, Skill } from "@earendil-works/pi-agent-core";
+import { WorkflowStepEmission, WorkflowStepEventHandler, WorkflowStepTx } from "@fragno-dev/workflows/workflow";
+import { ToolCall } from "@earendil-works/pi-ai";
+//#region src/pi/workflows/workflow-agent-harness.d.ts
+type PiHarnessOperation = {
+  kind: "prompt";
+  args: Parameters<AgentHarness["prompt"]>;
+  stopOnTools?: readonly string[];
+} | {
+  kind: "skill";
+  args: Parameters<AgentHarness["skill"]>;
+} | {
+  kind: "promptFromTemplate";
+  args: Parameters<AgentHarness["promptFromTemplate"]>;
+} | {
+  kind: "compact";
+  args: Parameters<AgentHarness["compact"]>;
+} | {
+  kind: "navigateTree";
+  args: Parameters<AgentHarness["navigateTree"]>;
+};
+type PiHarnessStepResult = {
+  type: "harness-run";
+  appendedEntries: SessionTreeEntry[];
+  leafId: string | null;
+};
+type PiHarnessSessionEntryEmission = {
+  kind: "harness-session-entry";
+  entry: SessionTreeEntry;
+};
+type PiHarnessOperationStartEmission = {
+  kind: "harness-operation-start";
+  operationId: string;
+  replay: {
+    protocol: "pi-harness-operation";
+    version: 1;
+  };
+};
+type PiHarnessOperationCompleteEmission<TResult = PiHarnessStepResult> = {
+  kind: "harness-operation-complete";
+  operationId: string;
+  result: TResult;
+};
+type PiHarnessEmission<TResult = PiHarnessStepResult> = PiHarnessSessionEntryEmission | PiHarnessEncodedEventEmission | PiHarnessOperationStartEmission | PiHarnessOperationCompleteEmission<TResult>;
+type WorkflowAgentHarnessOptions<TContext extends object | undefined = undefined, TSkill extends Skill = Skill, TPromptTemplate extends PromptTemplate = PromptTemplate, TTool extends AgentHarnessTool<TContext> = AgentHarnessTool<TContext>> = Omit<AgentHarnessOptions<TContext, TSkill, TPromptTemplate, TTool>, "session">;
+type PiHarnessSessionStepState = {
+  metadata: SessionMetadata;
+  entries: readonly SessionTreeEntry[];
+  checkpointedEntryCount: number;
+};
+type CreatePiHarnessSessionStateOptions = {
+  metadata: SessionMetadata;
+  /** Messages must carry timestamps created outside workflow replay. */
+  initialMessages?: readonly AgentMessage[];
+};
+declare const createPiHarnessSessionState: (options: CreatePiHarnessSessionStateOptions) => PiHarnessSessionStepState;
+/**
+ * Restore one runner-selected attempt from emissions in persisted order. Session entries are an
+ * immutable append log; repeated IDs or mixed attempt identities are corruption.
+ */
+type AppendEntryListener = (entry: SessionTreeEntry) => void | Promise<void>;
+/** Starts an AgentHarness operation when the selected workflow attempt has no prior journal. */
+type ExecuteWorkflowAgentHarnessRecovery = {
+  readonly kind: "execute";
+};
+/** Checkpoints durable transcript progress from an interrupted workflow attempt without rerunning it. */
+type InterruptedWorkflowAgentHarnessRecovery = {
+  readonly kind: "interrupted";
+  readonly transcript: InterruptedTranscript;
+  readonly replayedEntries: readonly SessionTreeEntry[];
+};
+/** Replays a finished AgentHarness operation whose entries and result were emitted before the process died, but whose workflow step had not committed. */
+type CompletedWorkflowAgentHarnessRecovery = {
+  readonly kind: "completed";
+  readonly result: WorkflowAgentHarnessStepResult;
+};
+/** Tells withWorkflowAgentHarness whether to run, recover, or replay the operation. */
+type WorkflowAgentHarnessRecovery = ExecuteWorkflowAgentHarnessRecovery | InterruptedWorkflowAgentHarnessRecovery | CompletedWorkflowAgentHarnessRecovery;
+type WorkflowAgentHarnessStorageMetadata = {
+  readonly operationId: string;
+  readonly operationEntryStart: number;
+  readonly checkpointEntryStart: number;
+  readonly recovery: WorkflowAgentHarnessRecovery;
+};
+type RestoredWorkflowAgentHarnessOptions = Pick<AgentHarnessOptions, "session"> & Partial<Pick<AgentHarnessOptions, "model" | "thinkingLevel" | "activeToolNames">>;
+type RestoredWorkflowBackedSession = WorkflowAgentHarnessStorageMetadata & {
+  session: Session;
+  storage: WorkflowBackedSessionStorage;
+  options: RestoredWorkflowAgentHarnessOptions;
+  subscribeToAppendedEntries: (listener: AppendEntryListener) => () => void;
+};
+type RestoreWorkflowBackedSessionOptions = {
+  operationId: string;
+  state: PiHarnessSessionStepState;
+  previousEmissions: readonly WorkflowStepEmission[];
+  models: AgentHarnessOptions["models"];
+};
+type InterruptedTranscript = {
+  recoverableLeafId: string | null;
+  missingToolCalls: ToolCall[];
+};
+declare const restoreWorkflowBackedSession: (options: RestoreWorkflowBackedSessionOptions) => RestoredWorkflowBackedSession;
+/**
+ * Execute a fresh invocation, replay a completed result, or checkpoint interrupted progress as
+ * aborted. Recovery never calls runDurableStep and never re-executes provider or tool work.
+ */
+type WorkflowAgentHarnessStepResultBase = Pick<PiHarnessStepResult, "type" | "appendedEntries" | "leafId">;
+type WorkflowAgentHarnessStepResult<TResult = unknown> = WorkflowAgentHarnessStepResultBase & ({
+  readonly outcome: "completed";
+  readonly value: TResult;
+} | {
+  readonly outcome: "aborted";
+});
+type WorkflowAgentHarnessTerminalOutcome<TResult = unknown> = {
+  operationId: string;
+  operationEntries: readonly SessionTreeEntry[];
+  result: WorkflowAgentHarnessStepResult<TResult>;
+};
+type WorkflowAgentHarnessOnLiveEvent = <TPayload = unknown>(type: string, handler: WorkflowStepEventHandler<TPayload>) => void;
+type WorkflowAgentHarnessTerminalOptions<TResult> = {
+  /** Persist terminal provider errors as completed operations instead of failing the workflow step. */
+  checkpointTerminalAssistantError?: boolean;
+  /** May run more than once before the enclosing workflow step commits. */
+  onTerminalOutcome?: (outcome: WorkflowAgentHarnessTerminalOutcome<TResult>) => Promise<void> | void;
+};
+type WithWorkflowAgentHarnessOptions<TResult = unknown> = WorkflowAgentHarnessTerminalOptions<TResult> & {
+  restored: RestoredWorkflowBackedSession;
+  harness: AgentHarness;
+  tx: WorkflowAgentHarnessExecutionTx;
+  observeLiveEvents?: (onLiveEvent: WorkflowAgentHarnessOnLiveEvent) => void;
+  runDurableStep: () => Promise<TResult>;
+};
+type WorkflowAgentHarnessExecutionTx = Pick<WorkflowStepTx, "emit" | "onEvent">;
+declare const hasSummarizableCompactionHistory: (preparation: CompactionPreparation) => boolean;
+declare const withWorkflowAgentHarness: <TResult>({ restored, harness, tx, observeLiveEvents, runDurableStep, checkpointTerminalAssistantError, onTerminalOutcome }: WithWorkflowAgentHarnessOptions<TResult>) => Promise<WorkflowAgentHarnessStepResult<TResult>>;
+/** Append one completed checkpoint suffix and verify its derived active leaf. */
+declare const applyWorkflowAgentHarnessStepResult: (state: PiHarnessSessionStepState, result: Pick<WorkflowAgentHarnessStepResult, "appendedEntries" | "leafId">) => PiHarnessSessionStepState;
+//#endregion
+export { CreatePiHarnessSessionStateOptions, PiHarnessEmission, PiHarnessOperation, PiHarnessOperationCompleteEmission, PiHarnessOperationStartEmission, PiHarnessSessionEntryEmission, PiHarnessSessionStepState, PiHarnessStepResult, RestoredWorkflowAgentHarnessOptions, RestoredWorkflowBackedSession, WithWorkflowAgentHarnessOptions, WorkflowAgentHarnessOnLiveEvent, WorkflowAgentHarnessOptions, WorkflowAgentHarnessStepResult, WorkflowAgentHarnessTerminalOutcome, applyWorkflowAgentHarnessStepResult, createPiHarnessSessionState, hasSummarizableCompactionHistory, restoreWorkflowBackedSession, withWorkflowAgentHarness };
+//# sourceMappingURL=workflow-agent-harness.d.ts.map

package/dist/node/pi/workflows/workflow-agent-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-agent-harness.d.ts","names":[],"sources":["../../../../src/pi/workflows/workflow-agent-harness.ts"],"mappings":";;;;;;KAiCY;EACN;EAAgB,MAAM,WAAW;EAAyB;;EAC1D;EAAe,MAAM,WAAW;;EAChC;EAA4B,MAAM,WAAW;;EAC7C;EAAiB,MAAM,WAAW;;EAClC;EAAsB,MAAM,WAAW;;KAEjC;EACV;EACA,iBAAiB;EACjB;;KAGU;EACV;EACA,OAAO;;KAGG;EACV;EACA;EACA;IACE;IACA;;;KAIQ,mCAAmC,UAAU;EACvD;EACA;EACA,QAAQ;;KAGE,kBAAkB,UAAU,uBACpC,gCACA,gCACA,kCACA,mCAAmC;KAE3B,4BACV,iDACA,eAAe,QAAQ,OACvB,wBAAwB,iBAAiB,gBACzC,cAAc,iBAAiB,YAAY,iBAAiB,aAC1D,KAAK,oBAAoB,UAAU,QAAQ,iBAAiB;KAEpD;EACV,UAAU;EACV,kBAAkB;EAClB;;KAGU;EACV,UAAU;;EAEV,2BAA2B;;cAyBhB,8BACX,SAAS,uCACR;;;;;KAWE,uBAAuB,OAAO,4BAA4B;;KAO1D;WAAiD;;;KAGjD;WACM;WACA,YAAY;WACZ,0BAA0B;;;KAIhC;WACM;WACA,QAAQ;;;KAId,+BACD,sCACA,0CACA;KAEC;WACM;WACA;WACA;WACA,UAAU;;KAGT,sCAAsC,KAAK,kCACrD,QAAQ,KAAK;KAEH,gCAAgC;EAC1C,SAAS;EACT,SAAS;EACT,SAAS;EACT,6BAA6B,UAAU;;KAGpC;EACH;EACA,OAAO;EACP,4BAA4B;EAC5B,QAAQ;;KAmGL;EACH;EACA,kBAAkB;;cAiMP,+BACX,SAAS,wCACR;;;;;KAgFE,qCAAqC,KACxC;KAIU,+BAA+B,qBAAqB;WAClD;WAA+B,OAAO;;WAAuB;;KAE/D,oCAAoC;EAC9C;EACA,2BAA2B;EAC3B,QAAQ,+BAA+B;;KAG7B,mCAAmC,oBAC7C,cACA,SAAS,yBAAyB;KAG/B,oCAAoC;;EAEvC;;EAEA,qBACE,SAAS,oCAAoC,aAC1C;;KAGK,gCAAgC,qBAC1C,oCAAoC;EAClC,UAAU;EACV,SAAS;EACT,IAAI;EACJ,qBAAqB,aAAa;EAClC,sBAAsB,QAAQ;;KAG7B,kCAAkC,KAAK;cA+C/B,mCAAoC,aAAa;cAqBjD,2BAAkC,WAAS,UAAA,SAAA,IAAA,mBAAA,gBAAA,kCAAA,qBAQrD,gCAAgC,aAAW,QAAQ,+BAA+B;;cAqNxE,sCACX,OAAO,2BACP,QAAQ,KAAK,kEACZ"}