@agimon-ai/po-workflow 0.0.0-alpha.2 → 0.0.0-alpha.4

package/dist/extensions/server.d.mts

@@ -1,5 +1,5 @@
 //#region generated/server.d.ts
-export declare const facet: import("@agimon-ai/po-core/serverFacet").DoomServerFacet;
+export declare const facet: import("@agimon-ai/po-core/serverFacet").PoServerFacet;
 //#endregion
 export { facet as default };
 //# sourceMappingURL=server.d.mts.map

package/dist/extensions/server.mjs

@@ -1,23 +1,23 @@
 import { n as resolveWorkflowEntry, r as validateWorkflowLaunch, t as parseWorkflowLaunchCommand } from "../workflowLaunchCommand-GGqimmTC.mjs";
 import { composeServerProviderOverrides, defineServerPlugin } from "@agimon-ai/po-core/serverFacet";
 import { composeRootHooks, defineChannel, defineRoot, defineRoutedContribution } from "@agimon-ai/po-core/extensionFile";
-import { randomUUID } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 import { readFile } from "node:fs/promises";
 import path, { basename, isAbsolute, join, relative, resolve } from "node:path";
-import { BACKGROUND_WORK_HOLDING_PROVIDERS, DOOM_BACKGROUND_WORK_SERVICE, holdsSettledSession, readDoomBackgroundWorkService } from "@agimon-ai/po-core/backgroundWork";
+import { BACKGROUND_WORK_HOLDING_PROVIDERS, PO_BACKGROUND_WORK_SERVICE, holdsSettledSession, readPoBackgroundWorkService } from "@agimon-ai/po-core/backgroundWork";
 import { SUBAGENT_PARENT_SESSION_ENV, readChildProcessContext, resolveRootSessionId } from "@agimon-ai/po-core/childProcess";
-import { DOOM_NARRATION_SERVICE, createNarrationRequest, requireDoomNarrationService } from "@agimon-ai/po-core/narration";
-import { DOOM_NOTIFICATION_ENTRY_TYPE, createDoomNotificationEntryData } from "@agimon-ai/po-core/notification";
-import { createDoomReadinessCoordinator, readDoomReadinessCoordinator } from "@agimon-ai/po-core/readiness";
+import { PO_NARRATION_SERVICE, createNarrationRequest, requirePoNarrationService } from "@agimon-ai/po-core/narration";
+import { PO_NOTIFICATION_ENTRY_TYPE, createPoNotificationEntryData } from "@agimon-ai/po-core/notification";
+import { createPoReadinessCoordinator, readPoReadinessCoordinator } from "@agimon-ai/po-core/readiness";
 import { defineMinorMode, serverMinorModes } from "@agimon-ai/po-minor-mode";
-import { createDoomTelemetry } from "@agimon-ai/po-telemetry";
+import { createPoTelemetry } from "@agimon-ai/po-telemetry";
 import { NativeTerminalService, WORKFLOW_DECISION_FILE_ENV, WORKFLOW_DECISION_STEERING_ENV, WORKFLOW_DECISION_STEERING_HOST, WorkflowRegistryService, WorkflowTerminalService, connectNativeTerminal, createEmbeddedWorkflowFeature, diagnoseWorkflow, gateStepDecision, readStepDecision, readWorkflowCatalog, readWorkflowProgress, serveNativeTerminal, summarizeWorkflow, summarizeWorkflowProgress, terminalSocketPath } from "@agimon-ai/workflow-mcp";
 import { z } from "zod";
 import fs, { existsSync, statSync } from "node:fs";
-import { WORKFLOW_STEP_SESSION_PROVENANCE } from "@agimon-ai/po-core/hubChannel";
+import { HOME_ENTITY_LIMIT, WORKFLOW_STEP_SESSION_PROVENANCE } from "@agimon-ai/po-core/hubChannel";
 import { execFile } from "node:child_process";
 import { Readable } from "node:stream";
-import { doomApiCallerFrom } from "@agimon-ai/po-core/packageApi";
+import { poApiCallerFrom } from "@agimon-ai/po-core/packageApi";
 import { Hono } from "hono";
 import { streamSSE } from "hono/streaming";
 import { fileURLToPath } from "node:url";
@@ -178,9 +178,9 @@ function registerRunProvider(ctx) {
 	let items = [];
 	let provider;
 	let disposed = false;
-	ctx.inject([DOOM_BACKGROUND_WORK_SERVICE], (serviceContext) => {
+	ctx.inject([PO_BACKGROUND_WORK_SERVICE], (serviceContext) => {
 		if (disposed) return void 0;
-		const service = readDoomBackgroundWorkService(serviceContext);
+		const service = readPoBackgroundWorkService(serviceContext);
 		if (!service) return void 0;
 		const registration = service.register({
 			provider: PROVIDER_NAME,
@@ -940,14 +940,14 @@ const PENDING_LINE_LIMIT = 500;
 const STOP_TIMEOUT_MS = 1e4;
 const SESSION_CLOSED_REASON = "The session that runs this workflow closed.";
 const RUNNING_STAGE$1 = "running";
-const LAUNCH_REQUESTED_EVENT = "doom_workflow.launch_requested";
-const RUN_STARTED_EVENT = "doom_workflow.run_started";
-const RUN_FINISHED_EVENT = "doom_workflow.run_finished";
-const RUN_FAILED_EVENT = "doom_workflow.run_failed";
-const ENGINE_ERROR_EVENT = "doom_workflow.engine_error";
-const ENGINE_WARNING_EVENT = "doom_workflow.engine_warning";
-const RUN_LOG_FAILED_EVENT = "doom_workflow.run_log_failed";
-const RUN_STOP_FAILED_EVENT = "doom_workflow.run_stop_failed";
+const LAUNCH_REQUESTED_EVENT = "po_workflow.launch_requested";
+const RUN_STARTED_EVENT = "po_workflow.run_started";
+const RUN_FINISHED_EVENT = "po_workflow.run_finished";
+const RUN_FAILED_EVENT = "po_workflow.run_failed";
+const ENGINE_ERROR_EVENT = "po_workflow.engine_error";
+const ENGINE_WARNING_EVENT = "po_workflow.engine_warning";
+const RUN_LOG_FAILED_EVENT = "po_workflow.run_log_failed";
+const RUN_STOP_FAILED_EVENT = "po_workflow.run_stop_failed";
 function delay$1(ms) {
 	return new Promise((settle) => {
 		setTimeout(settle, ms).unref?.();
@@ -1179,12 +1179,12 @@ const BUSY_RETRY_MS = 2e3;
 const RELEASE_TIMEOUT_MS = 1e4;
 /** What the runtime says when a turn is already running; the reminder then waits for it. */
 const BUSY_SESSION_PATTERN = /\bbusy\b|LaneBusy/i;
-const STEP_SESSION_STARTED_EVENT = "doom_workflow.step_session_started";
-const STEP_SESSION_FAILED_EVENT = "doom_workflow.step_session_failed";
-const STEP_REMINDER_EVENT = "doom_workflow.step_reminder";
-const STEP_WAITING_EVENT = "doom_workflow.step_waiting";
-const STEP_SESSION_RELEASE_FAILED_EVENT = "doom_workflow.step_session_release_failed";
-const STEP_PANE_FAILED_EVENT = "doom_workflow.step_pane_failed";
+const STEP_SESSION_STARTED_EVENT = "po_workflow.step_session_started";
+const STEP_SESSION_FAILED_EVENT = "po_workflow.step_session_failed";
+const STEP_REMINDER_EVENT = "po_workflow.step_reminder";
+const STEP_WAITING_EVENT = "po_workflow.step_waiting";
+const STEP_SESSION_RELEASE_FAILED_EVENT = "po_workflow.step_session_release_failed";
+const STEP_PANE_FAILED_EVENT = "po_workflow.step_pane_failed";
 const PO_KEYS = new Set(PO_RUN_CONFIG_KEYS);
 /**
 * A step's `runConfig`, validated against the keys Po understands.
@@ -2346,7 +2346,7 @@ function createWorkflowHubApi(options = {}) {
 		return context.json({ deleted: true });
 	});
 	app.post(routes.openRunDirectory.path, async (context) => {
-		if (doomApiCallerFrom(context.req.raw.headers)?.locality !== "local") return context.json({ error: "Opening Finder is only available on the host." }, 403);
+		if (poApiCallerFrom(context.req.raw.headers)?.locality !== "local") return context.json({ error: "Opening Finder is only available on the host." }, 403);
 		const workspace = context.req.param("workspace");
 		const runKey = context.req.param("runKey");
 		const record = await runOf(workspace, runKey);
@@ -3045,8 +3045,8 @@ function createWorkflowServerRuntime(host, serverHost) {
 	let deliveryRetry;
 	const catalogDeps = defaultCatalogDeps();
 	const catalogReader = createWorkflowCatalogReader(catalogDeps);
-	const telemetry = createDoomTelemetry({
-		serviceName: "doom-workflow",
+	const telemetry = createPoTelemetry({
+		serviceName: "po-workflow",
 		packageName: SOURCE,
 		cwd: host.context.cwd,
 		env: host.context.environment,
@@ -3060,12 +3060,12 @@ function createWorkflowServerRuntime(host, serverHost) {
 		parentSessionId: host.context.sessionContext?.parentSessionId,
 		publishActivity: (activity) => serverHost.context.publishActivity?.(activity),
 		postNotice: async (notice) => {
-			const data = createDoomNotificationEntryData({
+			const data = createPoNotificationEntryData({
 				title: notice.title,
 				body: notice.body,
 				level: notice.level
 			});
-			if (data !== void 0) await host.context.session.appendCustomEntry(DOOM_NOTIFICATION_ENTRY_TYPE, data);
+			if (data !== void 0) await host.context.session.appendCustomEntry(PO_NOTIFICATION_ENTRY_TYPE, data);
 		},
 		isIdle: async () => {
 			const activity = await host.context.session.activity();
@@ -3077,7 +3077,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 		}
 	}) : void 0;
 	const reportLifecycleFailure = (error) => {
-		telemetry.recordWarning("doom_workflow.session_lifecycle_failed", error);
+		telemetry.recordWarning("po_workflow.session_lifecycle_failed", error);
 	};
 	/** This session's runs, published to its panel and counted as its background work. */
 	const publishRuns = (executionContext) => {
@@ -3109,9 +3109,9 @@ function createWorkflowServerRuntime(host, serverHost) {
 					const request = createNarrationRequest(text);
 					if (request === void 0 || narration === void 0) return;
 					try {
-						Promise.resolve(narration.request(request)).catch((error) => telemetry.recordWarning("doom_workflow.narration_failed", error));
+						Promise.resolve(narration.request(request)).catch((error) => telemetry.recordWarning("po_workflow.narration_failed", error));
 					} catch (error) {
-						telemetry.recordWarning("doom_workflow.narration_failed", error);
+						telemetry.recordWarning("po_workflow.narration_failed", error);
 					}
 				} }, view, previous, previous === void 0 && (!Number.isFinite(startedAt) || startedAt >= sessionStartedAt));
 			}
@@ -3159,7 +3159,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 				} catch (error) {
 					if (disposed) return;
 					pending.attempts += 1;
-					await telemetry.recordError("doom_workflow.terminal_delivery_failed", error, { "workflow.pending_terminal_count": pendingCompletions.size });
+					await telemetry.recordError("po_workflow.terminal_delivery_failed", error, { "workflow.pending_terminal_count": pendingCompletions.size });
 				}
 			}
 			for (const quiet of [true, false]) {
@@ -3207,12 +3207,12 @@ function createWorkflowServerRuntime(host, serverHost) {
 						deliveredCompletions.add(identity);
 						pendingCompletions.delete(identity);
 					}
-					for (const outcome of batch.outcomes) telemetry.recordEvent("doom_workflow.run_transition", { outcome });
+					for (const outcome of batch.outcomes) telemetry.recordEvent("po_workflow.run_transition", { outcome });
 					publishRuns(host.context);
 				} catch (error) {
 					if (disposed) return;
 					batch.attempts += 1;
-					await telemetry.recordError("doom_workflow.terminal_delivery_failed", error, { "workflow.pending_terminal_count": pendingCompletions.size });
+					await telemetry.recordError("po_workflow.terminal_delivery_failed", error, { "workflow.pending_terminal_count": pendingCompletions.size });
 				}
 			}
 		})().finally(() => {
@@ -3267,7 +3267,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 				publishRuns(executionContext);
 				deliverCompletions().then(() => done?.(activeRunCount > 0 || pendingCompletions.size > 0));
 			} catch (error) {
-				telemetry.recordWarning("doom_workflow.publish_failed", error);
+				telemetry.recordWarning("po_workflow.publish_failed", error);
 			}
 		}, RUNS_PUBLISH_DEBOUNCE_MS);
 		runsTimer.unref?.();
@@ -3470,7 +3470,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 		if (owned.length === 0 || !owned.every(succeeded)) return;
 		if (!owned.some((run) => runLaunchedBySession(run, host.context.sessionId))) return;
 		await sessionService.release(source);
-		telemetry.recordEvent("doom_workflow.session_released", { outcome: "released" });
+		telemetry.recordEvent("po_workflow.session_released", { outcome: "released" });
 	};
 	const stopReleaseRequests = communication?.subscribe(WORKFLOW_SESSION_RELEASE_TYPE, (source) => {
 		releaseWorkflowSession(source).catch(reportLifecycleFailure);
@@ -3597,7 +3597,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 			return launchFromApi(parameters);
 		})],
 		async onStart() {
-			readiness ??= ownedReadiness = createDoomReadinessCoordinator({ notify: (notice) => {
+			readiness ??= ownedReadiness = createPoReadinessCoordinator({ notify: (notice) => {
 				host.context.client.notify({
 					body: `${SOURCE} initialization ${notice.state}: ${notice.error?.message ?? notice.diagnostics.join("; ")}`,
 					level: "warning"
@@ -3616,9 +3616,9 @@ function createWorkflowServerRuntime(host, serverHost) {
 		},
 		services: [
 			(context) => {
-				readiness = readDoomReadinessCoordinator(context);
-				context.inject([DOOM_NARRATION_SERVICE], (serviceContext) => {
-					const service = requireDoomNarrationService(serviceContext);
+				readiness = readPoReadinessCoordinator(context);
+				context.inject([PO_NARRATION_SERVICE], (serviceContext) => {
+					const service = requirePoNarrationService(serviceContext);
 					narration = service;
 					return () => {
 						if (narration === service) narration = void 0;
@@ -3669,7 +3669,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 					try {
 						const activity = await execution.session.activity();
 						if (disposed || !activity.isIdle || activity.hasPendingMessages) return;
-						const snapshot = serviceContext === void 0 ? void 0 : readDoomBackgroundWorkService(serviceContext)?.snapshot(execution.sessionId);
+						const snapshot = serviceContext === void 0 ? void 0 : readPoBackgroundWorkService(serviceContext)?.snapshot(execution.sessionId);
 						if (snapshot === void 0 || snapshot.items.some(holdsSettledSession) || snapshot.errors.some((error) => BACKGROUND_WORK_HOLDING_PROVIDERS.includes(error.provider))) return;
 						const gate = await gateStepDecision(environment);
 						if (disposed || gate.action !== "block") return;
@@ -3904,7 +3904,7 @@ function createWorkflowServerRuntime(host, serverHost) {
 							dryRun: input.dryRun,
 							runner: input.runner
 						}));
-						telemetry.recordEvent("doom_workflow.recovery_evidence_requested", { outcome: "requested" });
+						telemetry.recordEvent("po_workflow.recovery_evidence_requested", { outcome: "requested" });
 						const sections = [];
 						for (const name of [
 							"changelog.md",
@@ -4146,6 +4146,81 @@ function createWorkflowsChannel(options = {}) {
 				}
 			};
 			return {
+				homeFor(scope) {
+					if (!scopes.has(scope.sessionId)) return {
+						coverage: "unavailable",
+						entities: []
+					};
+					const runs = [];
+					const slices = delegated.get(scope.sessionId);
+					if ((slices?.size ?? 0) > HOME_ENTITY_LIMIT) return {
+						coverage: "partial",
+						entities: []
+					};
+					for (const slice of [own.get(scope.sessionId) ?? [], ...slices?.values() ?? []]) {
+						if (runs.length + slice.length > HOME_ENTITY_LIMIT) return {
+							coverage: "partial",
+							entities: []
+						};
+						for (const run of slice) runs.push(run);
+					}
+					const entities = /* @__PURE__ */ new Map();
+					let partial = false;
+					let remaining = HOME_ENTITY_LIMIT;
+					for (const run of runs) {
+						const owner = run.ownerSessionId ?? scope.sessionId;
+						const refs = /* @__PURE__ */ new Set([owner]);
+						if (run.launcherSessionId) refs.add(run.launcherSessionId);
+						if (run.jobs.length > remaining) {
+							partial = true;
+							break;
+						}
+						remaining -= run.jobs.length;
+						let complete = true;
+						for (const job of run.jobs) {
+							if (job.steps.length > remaining) {
+								complete = false;
+								break;
+							}
+							remaining -= job.steps.length;
+							for (const step of job.steps) {
+								if (step.ref?.kind === "session") refs.add(step.ref.id);
+								if (refs.size > 65) {
+									complete = false;
+									break;
+								}
+							}
+							if (!complete) break;
+						}
+						if (!complete) {
+							partial = true;
+							break;
+						}
+						const id = createHash("sha256").update(JSON.stringify([
+							run.workspace,
+							run.runId ?? run.runKey,
+							run.startedAt
+						])).digest("hex");
+						if (entities.has(id)) continue;
+						if (entities.size >= HOME_ENTITY_LIMIT) {
+							partial = true;
+							continue;
+						}
+						entities.set(id, {
+							id,
+							kind: run.outcome === "interrupted" ? "paused" : run.stage === "error" || run.outcome === "failed" ? "failure" : run.stale === true ? "blocked" : run.stage === "completed" ? "completed" : run.executionState === "paused" || run.executionState === "pause_requested" ? "paused" : "running",
+							title: (run.displayName.trim() || run.runKey).slice(0, 160),
+							...run.errorMessage?.trim() || (run.stale === true ? run.staleReason?.trim() || "Recorded workflow is stale." : void 0) ? { detail: (run.errorMessage?.trim() || run.staleReason?.trim() || "Recorded workflow is stale.").slice(0, 320) } : {},
+							updatedAt: run.finishedAt ?? run.startedAt,
+							sessionId: owner,
+							relatedSessionIds: [...refs].filter((id) => id !== owner)
+						});
+					}
+					return {
+						coverage: partial ? "partial" : "ready",
+						entities: [...entities.values()]
+					};
+				},
 				payloadFor(scope) {
 					return scopes.has(scope.sessionId) ? latest.get(scope.sessionId) : void 0;
 				},