@agimon-ai/po-workflow 0.0.0-alpha.66 → 0.0.0-alpha.68

package/dist/extensions/server.cjs

@@ -409,7 +409,7 @@ function runBelongsToSession(run, sessionId) {
 }
 /** Whether the session handed this run to a workflow session of its own: it lists the run but does not own it. */
 function runLaunchedBySession(run, sessionId) {
-	return run.launcherSessionId !== void 0 && run.launcherSessionId === sessionId && !runBelongsToSession(run, sessionId);
+	return run.piSessionId !== void 0 && run.launcherSessionId !== void 0 && run.launcherSessionId === sessionId && !runBelongsToSession(run, sessionId);
 }
 function parseTime(value) {
 	if (value === void 0) return 0;
@@ -2912,6 +2912,155 @@ const WORKFLOW_API_BASE_PATH = "workflow";
 /** The SSE event name the screen stream writes. */
 const WORKFLOW_SCREEN_EVENT = "screen";
 //#endregion
+//#region src/services/piToolBridge/index.ts
+/**
+* Environment variable stamped onto every run launched from a Pi session.
+*
+* `RunWorkflowService` forwards `env` to the inner CLI invocation across the
+* `launch-command` delegation boundary and persists it on the run record, so
+* this survives backgrounding and identifies the launching session afterwards.
+*/
+const PO_SESSION_ENV = "PO_SESSION_ID";
+/** Operator override for the per-session launch ceiling. */
+const MAX_CONCURRENT_ENV = "WORKFLOW_MCP_MAX_CONCURRENT";
+const DEFAULT_MAX_CONCURRENT = 5;
+/** Resolve the per-session launch ceiling from the environment. */
+function resolveMaxConcurrent(env) {
+	const parsed = Number(env[MAX_CONCURRENT_ENV]);
+	return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_MAX_CONCURRENT;
+}
+/**
+* True when this session launched the run.
+*
+* Fails closed on a missing session id: an unstamped record (a CLI launch) and
+* a call arriving before the session id is known both match nothing, so no run
+* ever leaks across sessions through an undefined-equals-undefined comparison.
+*/
+function isSessionRun(record, sessionId) {
+	return sessionId !== void 0 && record.env?.["PO_SESSION_ID"] === sessionId;
+}
+/** True when this session handed the run to a workflow session of its own: it is told, but does not own it. */
+function isLaunchedRun(record, sessionId) {
+	const owner = record.env?.[PO_SESSION_ENV];
+	return sessionId !== void 0 && typeof owner === "string" && owner !== "" && record.env?.["PO_WORKFLOW_LAUNCHER_SESSION_ID"] === sessionId && !isSessionRun(record, sessionId);
+}
+/** The line a launcher's finish notice adds: where the run lived, and where to take it up. */
+function launchedRunHint(record) {
+	return `It ran in workflow session ${record.env?.["PO_SESSION_ID"] ?? "unknown"}; troubleshoot and recover it there.`;
+}
+/**
+* True when this session owns a run another session handed to it: it is the
+* run's workflow session, so a finished run is posted without starting a turn.
+*/
+function isOwnedDelegatedRun(record, sessionId) {
+	const launcher = record.env?.[WORKFLOW_LAUNCHER_SESSION_ENV];
+	return isSessionRun(record, sessionId) && typeof launcher === "string" && launcher !== "" && launcher !== sessionId;
+}
+/**
+* What the caller is told when the registry, not the launcher, acknowledged a
+* launch.
+*
+* Leads with the run key because it is the handle every other workflow action
+* takes, and it is no longer available any other way: the launcher's own output
+* is not waited for, so nothing else in this result carries it.
+*/
+function launchedRunSummary(record) {
+	return [
+		`Started ${record.displayName} in workspace ${record.workspace}.`,
+		`Run key: ${record.runKey}`,
+		"The run is registered and going. This call returned at that point rather than waiting for the launcher process to exit."
+	].join("\n");
+}
+/**
+* What the caller is told when the launch was handed off but no run has
+* registered inside the acknowledgement budget.
+*
+* Deliberately not an error: the launcher is slow rather than broken often
+* enough that failing here would strand runs that go on to start normally.
+* There is no run key to offer yet, so it points at the surfaces that do not
+* need one.
+*/
+function launchHandoffSummary(workflowPath) {
+	return [
+		`Launch handed off for ${workflowPath}, but no run has registered yet.`,
+		"Nothing was cancelled: the launcher is still starting, and a run that registers later still reports back here when it finishes.",
+		"Do not launch it again. Ask the user to check the active workflow list if they need to see it sooner."
+	].join("\n");
+}
+new RegExp([
+	"\\u001B\\[[0-9;?]*[ -/]*[@-~]",
+	"\\u001B\\][^\\u0007\\u001B]*(?:\\u0007|\\u001B\\\\)",
+	"\\u001B[@-Z\\\\-_]"
+].join("|"), "g");
+/** Flatten MCP tool content to text for Pi. */
+function toolResultText(result) {
+	return result.content.map((part) => part.type === "text" ? part.text : "").filter(Boolean).join("\n").trim();
+}
+/**
+* Attach a short menu of next steps to a problem.
+*
+* An error with no route forward is where an agent invents one: retrying a
+* capacity limit, relaunching a run that should be recovered, or silently
+* giving up on work the user is waiting for. Naming two or three real options
+* turns an error into a decision, and the decision belongs to the user.
+*/
+function withOptions(problem, options) {
+	if (options.length === 0) return problem;
+	return [
+		problem,
+		"",
+		"Options, put these to the user rather than picking one yourself:",
+		...options.map(bullet)
+	].join("\n");
+}
+function bullet(option) {
+	return `- ${option}`;
+}
+/** The job and step a run died on, preferring the progress log to the record. */
+function failurePosition(record, jobs) {
+	const failedJob = jobs.find((job) => job.status === "failed");
+	const failedStep = failedJob?.steps.find((step) => step.status === "failed");
+	return {
+		job: failedJob?.name ?? record.failedJob,
+		step: failedStep?.name,
+		reason: failedStep?.reason ?? failedJob?.reason
+	};
+}
+/**
+* Describe a finished run for the agent that launched it.
+*
+* Carries the job identifiers back so a dispatching agent can match the run to
+* the work item it launched it for without another lookup. When the run failed,
+* carries the failing step and a set of options too: the agent is being told
+* about this out of band, with no user question in flight, so without them it
+* has to guess whether to recover, relaunch, or report.
+*/
+function finishedRunSummary(record, jobs = []) {
+	const outcome = record.stage === "completed" ? "completed" : `ended in ${record.stage}`;
+	const failure = failurePosition(record, jobs);
+	const lines = [
+		`Workflow run ${record.runKey} in workspace ${record.workspace} ${outcome}.`,
+		record.workflowId ? `Workflow: ${record.workflowId}` : void 0,
+		failure.job ? `Failed job: ${failure.job}${failure.step ? ` (step: ${failure.step})` : ""}` : void 0,
+		record.errorMessage ? `Error: ${record.errorMessage}` : void 0,
+		failure.reason && failure.reason !== record.errorMessage ? `Step reported: ${failure.reason}` : void 0
+	];
+	const jobId = record.env?.AGIFLOW_JOB_ID;
+	if (jobId) lines.push(`Agiflow job: ${record.env?.AGIFLOW_JOB_KIND ?? "unknown"} ${jobId}`);
+	const summary = lines.filter((line) => Boolean(line)).join("\n");
+	if (record.stage === "completed") return summary;
+	if (record.outcome === "interrupted") return withOptions(summary, [`workflow_run {"action":"recover","runKey":${JSON.stringify(record.runKey)}}: pick it up where it stopped.`, "Leave it stopped and move on."]);
+	const diagnosticText = [record.errorMessage, failure.reason].filter(Boolean).join("\n");
+	if (diagnosticText.includes("JOB_ALREADY_CLAIMED")) return withOptions(summary, ["Report contention: another worker owns this job. Do not unlock, release, or retry the claim automatically."]);
+	if (diagnosticText.includes("WORKFLOW_NOT_OWNED") || /release failed/i.test(diagnosticText)) return withOptions(summary, ["Inspect the current workflow ownership and ask the user before any release or unlock. Never force another worker’s lock."]);
+	if (/running workflow not found/i.test(diagnosticText)) return withOptions(summary, [`workflow_run {"action":"status","runKey":${JSON.stringify(record.runKey)}}: re-check current state before retrying.`, "Report the recorded terminal state when no running owner remains."]);
+	return withOptions(summary, [
+		`workflow_run {"action":"tail","runKey":${JSON.stringify(record.runKey)}}: read the run's own output first, when the error above does not explain the failure.`,
+		`workflow_run {"action":"recover","runKey":${JSON.stringify(record.runKey)}}: resume from the failed job, keeping the work already done. Fits a transient or external cause.`,
+		"Report the failure and stop, when it needs a code change or a decision you cannot make."
+	]);
+}
+//#endregion
 //#region src/schemas/workflowRenderGrid.ts
 const renderGridStyleSchema = zod.z.object({
 	id: zod.z.number().int().nonnegative(),
@@ -3937,7 +4086,7 @@ function createWorkflowApi(runtime, launch) {
 				app = createWorkflowHubApi({
 					runtime,
 					registry: new require_RecoverWorkflowService.WorkflowRegistryService(runtime, homeDir),
-					recordFilter: (record) => context.sessionId === void 0 || record.env?.PO_SESSION_ID === context.sessionId || record.env?.["PO_WORKFLOW_LAUNCHER_SESSION_ID"] === context.sessionId,
+					recordFilter: (record) => context.sessionId === void 0 || isSessionRun(record, context.sessionId) || isLaunchedRun(record, context.sessionId),
 					...steer === void 0 ? {} : { steer: (sessionId, message) => steer(sessionId, message) },
 					...launch === void 0 ? {} : { launch }
 				});
@@ -4815,154 +4964,6 @@ function registerRunProvider(ctx) {
 	};
 }
 //#endregion
-//#region src/services/piToolBridge/index.ts
-/**
-* Environment variable stamped onto every run launched from a Pi session.
-*
-* `RunWorkflowService` forwards `env` to the inner CLI invocation across the
-* `launch-command` delegation boundary and persists it on the run record, so
-* this survives backgrounding and identifies the launching session afterwards.
-*/
-const PO_SESSION_ENV = "PO_SESSION_ID";
-/** Operator override for the per-session launch ceiling. */
-const MAX_CONCURRENT_ENV = "WORKFLOW_MCP_MAX_CONCURRENT";
-const DEFAULT_MAX_CONCURRENT = 5;
-/** Resolve the per-session launch ceiling from the environment. */
-function resolveMaxConcurrent(env) {
-	const parsed = Number(env[MAX_CONCURRENT_ENV]);
-	return Number.isInteger(parsed) && parsed > 0 ? parsed : DEFAULT_MAX_CONCURRENT;
-}
-/**
-* True when this session launched the run.
-*
-* Fails closed on a missing session id: an unstamped record (a CLI launch) and
-* a call arriving before the session id is known both match nothing, so no run
-* ever leaks across sessions through an undefined-equals-undefined comparison.
-*/
-function isSessionRun(record, sessionId) {
-	return sessionId !== void 0 && record.env?.["PO_SESSION_ID"] === sessionId;
-}
-/** True when this session handed the run to a workflow session of its own: it is told, but does not own it. */
-function isLaunchedRun(record, sessionId) {
-	return sessionId !== void 0 && record.env?.["PO_WORKFLOW_LAUNCHER_SESSION_ID"] === sessionId && !isSessionRun(record, sessionId);
-}
-/** The line a launcher's finish notice adds: where the run lived, and where to take it up. */
-function launchedRunHint(record) {
-	return `It ran in workflow session ${record.env?.["PO_SESSION_ID"] ?? "unknown"}; troubleshoot and recover it there.`;
-}
-/**
-* True when this session owns a run another session handed to it: it is the
-* run's workflow session, so a finished run is posted without starting a turn.
-*/
-function isOwnedDelegatedRun(record, sessionId) {
-	const launcher = record.env?.[WORKFLOW_LAUNCHER_SESSION_ENV];
-	return isSessionRun(record, sessionId) && typeof launcher === "string" && launcher !== "" && launcher !== sessionId;
-}
-/**
-* What the caller is told when the registry, not the launcher, acknowledged a
-* launch.
-*
-* Leads with the run key because it is the handle every other workflow action
-* takes, and it is no longer available any other way: the launcher's own output
-* is not waited for, so nothing else in this result carries it.
-*/
-function launchedRunSummary(record) {
-	return [
-		`Started ${record.displayName} in workspace ${record.workspace}.`,
-		`Run key: ${record.runKey}`,
-		"The run is registered and going. This call returned at that point rather than waiting for the launcher process to exit."
-	].join("\n");
-}
-/**
-* What the caller is told when the launch was handed off but no run has
-* registered inside the acknowledgement budget.
-*
-* Deliberately not an error: the launcher is slow rather than broken often
-* enough that failing here would strand runs that go on to start normally.
-* There is no run key to offer yet, so it points at the surfaces that do not
-* need one.
-*/
-function launchHandoffSummary(workflowPath) {
-	return [
-		`Launch handed off for ${workflowPath}, but no run has registered yet.`,
-		"Nothing was cancelled: the launcher is still starting, and a run that registers later still reports back here when it finishes.",
-		"Do not launch it again. Ask the user to check the active workflow list if they need to see it sooner."
-	].join("\n");
-}
-new RegExp([
-	"\\u001B\\[[0-9;?]*[ -/]*[@-~]",
-	"\\u001B\\][^\\u0007\\u001B]*(?:\\u0007|\\u001B\\\\)",
-	"\\u001B[@-Z\\\\-_]"
-].join("|"), "g");
-/** Flatten MCP tool content to text for Pi. */
-function toolResultText(result) {
-	return result.content.map((part) => part.type === "text" ? part.text : "").filter(Boolean).join("\n").trim();
-}
-/**
-* Attach a short menu of next steps to a problem.
-*
-* An error with no route forward is where an agent invents one: retrying a
-* capacity limit, relaunching a run that should be recovered, or silently
-* giving up on work the user is waiting for. Naming two or three real options
-* turns an error into a decision, and the decision belongs to the user.
-*/
-function withOptions(problem, options) {
-	if (options.length === 0) return problem;
-	return [
-		problem,
-		"",
-		"Options, put these to the user rather than picking one yourself:",
-		...options.map(bullet)
-	].join("\n");
-}
-function bullet(option) {
-	return `- ${option}`;
-}
-/** The job and step a run died on, preferring the progress log to the record. */
-function failurePosition(record, jobs) {
-	const failedJob = jobs.find((job) => job.status === "failed");
-	const failedStep = failedJob?.steps.find((step) => step.status === "failed");
-	return {
-		job: failedJob?.name ?? record.failedJob,
-		step: failedStep?.name,
-		reason: failedStep?.reason ?? failedJob?.reason
-	};
-}
-/**
-* Describe a finished run for the agent that launched it.
-*
-* Carries the job identifiers back so a dispatching agent can match the run to
-* the work item it launched it for without another lookup. When the run failed,
-* carries the failing step and a set of options too: the agent is being told
-* about this out of band, with no user question in flight, so without them it
-* has to guess whether to recover, relaunch, or report.
-*/
-function finishedRunSummary(record, jobs = []) {
-	const outcome = record.stage === "completed" ? "completed" : `ended in ${record.stage}`;
-	const failure = failurePosition(record, jobs);
-	const lines = [
-		`Workflow run ${record.runKey} in workspace ${record.workspace} ${outcome}.`,
-		record.workflowId ? `Workflow: ${record.workflowId}` : void 0,
-		failure.job ? `Failed job: ${failure.job}${failure.step ? ` (step: ${failure.step})` : ""}` : void 0,
-		record.errorMessage ? `Error: ${record.errorMessage}` : void 0,
-		failure.reason && failure.reason !== record.errorMessage ? `Step reported: ${failure.reason}` : void 0
-	];
-	const jobId = record.env?.AGIFLOW_JOB_ID;
-	if (jobId) lines.push(`Agiflow job: ${record.env?.AGIFLOW_JOB_KIND ?? "unknown"} ${jobId}`);
-	const summary = lines.filter((line) => Boolean(line)).join("\n");
-	if (record.stage === "completed") return summary;
-	if (record.outcome === "interrupted") return withOptions(summary, [`workflow_run {"action":"recover","runKey":${JSON.stringify(record.runKey)}}: pick it up where it stopped.`, "Leave it stopped and move on."]);
-	const diagnosticText = [record.errorMessage, failure.reason].filter(Boolean).join("\n");
-	if (diagnosticText.includes("JOB_ALREADY_CLAIMED")) return withOptions(summary, ["Report contention: another worker owns this job. Do not unlock, release, or retry the claim automatically."]);
-	if (diagnosticText.includes("WORKFLOW_NOT_OWNED") || /release failed/i.test(diagnosticText)) return withOptions(summary, ["Inspect the current workflow ownership and ask the user before any release or unlock. Never force another worker’s lock."]);
-	if (/running workflow not found/i.test(diagnosticText)) return withOptions(summary, [`workflow_run {"action":"status","runKey":${JSON.stringify(record.runKey)}}: re-check current state before retrying.`, "Report the recorded terminal state when no running owner remains."]);
-	return withOptions(summary, [
-		`workflow_run {"action":"tail","runKey":${JSON.stringify(record.runKey)}}: read the run's own output first, when the error above does not explain the failure.`,
-		`workflow_run {"action":"recover","runKey":${JSON.stringify(record.runKey)}}: resume from the failed job, keeping the work already done. Fits a transient or external cause.`,
-		"Report the failure and stop, when it needs a code change or a decision you cannot make."
-	]);
-}
-//#endregion
 //#region src/services/workflowExecution/index.ts
 const AGIFLOW_JOB_ID_ENV = "AGIFLOW_JOB_ID";
 const AGIFLOW_JOB_KIND_ENV = "AGIFLOW_JOB_KIND";