@xopcai/xopc 0.0.88 → 0.0.89

package/dist/src/workflows/service/workflow-run-service.js

@@ -0,0 +1,279 @@
+import { extractProfileAgentId } from "../../config/agent-profile.js";
+import { init_providers, resolveModel } from "../../providers/index.js";
+import { createWorkflowCatalog } from "../../agent/workflow/catalog.js";
+import { DelegateSubagentRunner } from "../../agent/workflow/subagent-runner.js";
+import { resolveModelRef } from "../../config/agent-typed-models.js";
+import { buildWorkflowDefinition } from "../domain/definition-utils.js";
+import { isTerminalWorkflowRunStatus } from "../domain/run.js";
+import "../domain/index.js";
+import { WorkflowEngine } from "../engine/workflow-engine.js";
+import "../engine/index.js";
+import { WorkflowEventStore } from "../store/event-store.js";
+import { WorkflowRunStore } from "../store/run-store.js";
+import { randomUUID } from "node:crypto";
+//#region src/workflows/service/workflow-run-service.ts
+init_providers();
+var WorkflowRunService = class {
+	activeRuns = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+	}
+	async startWorkflowRun(params) {
+		const definition = this.loadDefinition(params.definitionId);
+		if (!definition) return {
+			ok: false,
+			code: "definition_not_found",
+			message: "Workflow definition not found",
+			httpStatus: 404
+		};
+		const runId = randomUUID();
+		const goal = params.goal ?? "";
+		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
+			runId,
+			agentId: params.agentId,
+			definitionId: params.definitionId,
+			definitionTitle: definition.title,
+			goal,
+			parentSessionKey: params.parentSessionKey
+		});
+		const source = normalizeWorkflowRunSourceForSession(params.source, sessionKey, params.parentSessionKey);
+		const abortController = new AbortController();
+		const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);
+		const runStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);
+		const engine = this.createWorkflowEngine({
+			eventStore,
+			runStore,
+			sessionKey
+		});
+		const inputEnvelope = params.inputEnvelope ?? buildWorkflowRunInputEnvelope(params.input, params.goal);
+		this.activeRuns.set(runId, abortController);
+		engine.startRun(definition, {
+			runId,
+			input: inputEnvelope.payload,
+			goal: inputEnvelope.goal ?? params.goal,
+			source,
+			metadata: buildWorkflowRunMetadata({
+				definition,
+				agentId: params.agentId,
+				sessionKey,
+				source,
+				input: inputEnvelope,
+				retryOfRunId: params.retryOfRunId,
+				idempotencyKey: params.idempotencyKey
+			}),
+			signal: abortController.signal,
+			concurrency: params.concurrency,
+			maxSubagents: params.maxSubagents,
+			tokenBudget: params.tokenBudget
+		}).catch((err) => {
+			this.options.service.emit("workflow.run.error", {
+				runId,
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}).finally(() => {
+			this.activeRuns.delete(runId);
+		});
+		return {
+			ok: true,
+			runId,
+			sessionKey
+		};
+	}
+	async retryWorkflowRun(params) {
+		const existing = await this.createRunStore(params.agentId).readRunView(params.runId);
+		if (!existing) return {
+			ok: false,
+			code: "run_not_found",
+			message: "Workflow run not found",
+			httpStatus: 404
+		};
+		const parentSessionKey = existing.run.source.kind === "chat" ? existing.run.source.sessionKey : void 0;
+		return this.startWorkflowRun({
+			agentId: params.agentId,
+			definitionId: existing.run.definitionId,
+			input: existing.run.input,
+			goal: existing.run.goal,
+			source: existing.run.source,
+			parentSessionKey,
+			retryOfRunId: existing.run.id
+		});
+	}
+	async cancelWorkflowRun(params) {
+		const controller = this.activeRuns.get(params.runId);
+		if (controller) {
+			controller.abort();
+			this.activeRuns.delete(params.runId);
+			return {
+				ok: true,
+				cancelled: true
+			};
+		}
+		const runStore = this.createRunStore(params.agentId);
+		const view = await runStore.readRunView(params.runId);
+		if (!view) return {
+			ok: false,
+			code: "run_not_found",
+			message: "Workflow run not found",
+			httpStatus: 404
+		};
+		if (isTerminalWorkflowRunStatus(view.run.status)) return {
+			ok: true,
+			cancelled: true,
+			alreadyFinished: true
+		};
+		await new WorkflowEventStore(this.options.service.currentConfig, params.agentId).append({
+			runId: params.runId,
+			type: "run_cancelled",
+			payload: { reason: params.reason ?? "Cancelled by user" }
+		});
+		const updated = await runStore.rebuildRunView(params.runId);
+		if (updated) {
+			this.options.service.emit("workflow.run.updated", {
+				runId: params.runId,
+				view: updated
+			});
+			this.options.sessionBridge.handleRunViewUpdated(updated);
+		}
+		return {
+			ok: true,
+			cancelled: true
+		};
+	}
+	createRunStore(agentId) {
+		const eventStore = new WorkflowEventStore(this.options.service.currentConfig, agentId);
+		return new WorkflowRunStore(this.options.service.currentConfig, agentId, eventStore);
+	}
+	loadDefinition(definitionId) {
+		const catalog = createWorkflowCatalog();
+		try {
+			const loaded = catalog.load(definitionId);
+			return buildWorkflowDefinition({
+				name: loaded.name,
+				source: loaded.source,
+				script: loaded.script,
+				meta: loaded.meta
+			});
+		} catch {
+			return null;
+		}
+	}
+	createWorkflowEngine(params) {
+		const gatewayService = this.options.service;
+		const runner = new DelegateSubagentRunner({
+			workspace: gatewayService.currentWorkspacePath,
+			bus: gatewayService.messageBusInstance,
+			getDefaultModel: () => resolveModel(gatewayService.agentService.getModelForSession(params.sessionKey)),
+			getConfig: () => gatewayService.currentConfig,
+			buildChildTools: (childOptions) => this.options.buildChildTools(childOptions)
+		});
+		return new WorkflowEngine({
+			cwd: gatewayService.currentWorkspacePath,
+			eventStore: params.eventStore,
+			runStore: params.runStore,
+			runner,
+			resolveModelId: (modelId) => {
+				const agentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);
+				return resolveModel(resolveModelRef(gatewayService.currentConfig, agentId, modelId));
+			},
+			onEventAppended: (event) => {
+				gatewayService.emit("workflow.event.appended", {
+					runId: event.runId,
+					event
+				});
+			},
+			onRunViewUpdated: (view) => {
+				gatewayService.emit("workflow.run.updated", {
+					runId: view.run.id,
+					view
+				});
+				this.options.sessionBridge.handleRunViewUpdated(view);
+			}
+		});
+	}
+};
+function normalizeWorkflowRunSourceForSession(source, workflowSessionKey, parentSessionKey) {
+	if (parentSessionKey?.trim()) return {
+		kind: "chat",
+		sessionKey: parentSessionKey.trim()
+	};
+	if (source.kind === "webui") return {
+		...source,
+		sessionKey: workflowSessionKey
+	};
+	if (source.kind === "chat") return source;
+	return source;
+}
+function buildWorkflowRunInputEnvelope(input, goal) {
+	if (isWorkflowRunInputEnvelope(input)) return input;
+	return {
+		payload: input ?? {},
+		goal
+	};
+}
+function buildWorkflowRunMetadata(params) {
+	return {
+		sessionKey: params.sessionKey,
+		triggerSource: params.source.kind,
+		agentId: params.agentId,
+		retryOfRunId: params.retryOfRunId,
+		definition: buildWorkflowRunDefinitionSnapshot(params.definition),
+		input: params.input,
+		correlation: { idempotencyKey: params.idempotencyKey },
+		origin: buildWorkflowRunOrigin(params.source),
+		schedule: params.source.kind === "cron" ? {
+			scheduleId: params.source.scheduleId,
+			fireId: params.source.fireId
+		} : void 0
+	};
+}
+function buildWorkflowRunDefinitionSnapshot(definition) {
+	return {
+		id: definition.id,
+		name: definition.name,
+		title: definition.title,
+		version: definition.version,
+		source: definition.metadata.source,
+		tags: [...definition.metadata.tags],
+		phaseCount: definition.phases.length,
+		estimatedAgents: definition.metadata.estimatedAgents
+	};
+}
+function extractWorkflowRunSessionKey(source) {
+	if ("sessionKey" in source && typeof source.sessionKey === "string" && source.sessionKey.trim()) return source.sessionKey.trim();
+	return null;
+}
+function buildWorkflowRunOrigin(source) {
+	switch (source.kind) {
+		case "chat": return {
+			channel: "chat",
+			sessionKey: source.sessionKey,
+			messageId: source.messageId
+		};
+		case "webui": return {
+			channel: "webui",
+			sessionKey: source.sessionKey
+		};
+		case "cron": return {
+			channel: "cron",
+			scheduleId: source.scheduleId,
+			fireId: source.fireId
+		};
+		case "api": return {
+			channel: "api",
+			requestId: source.requestId
+		};
+		case "im": return {
+			channel: source.channel,
+			chatId: source.chatId,
+			messageId: source.messageId
+		};
+	}
+}
+function isWorkflowRunInputEnvelope(input) {
+	if (!input || typeof input !== "object" || Array.isArray(input)) return false;
+	return "payload" in input || "variables" in input || "context" in input;
+}
+//#endregion
+export { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunSessionKey };
+
+//# sourceMappingURL=workflow-run-service.js.map

package/dist/src/workflows/service/workflow-run-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-run-service.js","names":["resolveModelById"],"sources":["../../../../src/workflows/service/workflow-run-service.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { AgentTool } from '@earendil-works/pi-agent-core';\n\nimport type { BuildChildToolsOptions } from '../../agent/child-agent-factory.js';\nimport { extractProfileAgentId } from '../../config/agent-profile.js';\nimport { resolveModelRef } from '../../config/agent-typed-models.js';\nimport type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';\nimport { resolveModel as resolveModelById } from '../../providers/index.js';\nimport { createWorkflowCatalog } from '../../agent/workflow/catalog.js';\nimport { DelegateSubagentRunner } from '../../agent/workflow/subagent-runner.js';\nimport type {\n  WorkflowDefinition,\n  WorkflowRunDefinitionSnapshot,\n  WorkflowRunInputEnvelope,\n  WorkflowRunMetadata,\n  WorkflowRunSource,\n} from '../domain/index.js';\nimport { buildWorkflowDefinition, isTerminalWorkflowRunStatus } from '../domain/index.js';\nimport { WorkflowEngine } from '../engine/index.js';\nimport { WorkflowEventStore } from '../store/event-store.js';\nimport { WorkflowRunStore } from '../store/run-store.js';\nimport type { WorkflowSessionBridge } from './workflow-session-bridge.js';\nexport type {\n  CancelWorkflowRunResult,\n  CancelWorkflowRunServiceParams,\n  CancelWorkflowRunServiceResult,\n  RetryWorkflowRunServiceParams,\n  StartWorkflowRunServiceParams,\n  StartWorkflowRunServiceResult,\n  WorkflowRunServiceErrorCode,\n  WorkflowRunServiceErrorResult,\n  WorkflowRunServiceResult,\n} from './workflow-run-service.types.js';\n\nimport type {\n  CancelWorkflowRunResult,\n  CancelWorkflowRunServiceParams,\n  RetryWorkflowRunServiceParams,\n  StartWorkflowRunServiceParams,\n  WorkflowRunServiceResult,\n} from './workflow-run-service.types.js';\n\nexport interface WorkflowRunServiceOptions {\n  service: GatewayWorkflowHost;\n  sessionBridge: WorkflowSessionBridge;\n  buildChildTools: (childOptions: BuildChildToolsOptions) => AgentTool<any, any>[];\n}\n\nexport class WorkflowRunService {\n  private readonly activeRuns = new Map<string, AbortController>();\n\n  constructor(private readonly options: WorkflowRunServiceOptions) {}\n\n  async startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult> {\n    const definition = this.loadDefinition(params.definitionId);\n    if (!definition) {\n      return {\n        ok: false,\n        code: 'definition_not_found',\n        message: 'Workflow definition not found',\n        httpStatus: 404,\n      };\n    }\n\n    const runId = randomUUID();\n    const goal = params.goal ?? '';\n    const { sessionKey } = await this.options.sessionBridge.prepareRunSession({\n      runId,\n      agentId: params.agentId,\n      definitionId: params.definitionId,\n      definitionTitle: definition.title,\n      goal,\n      parentSessionKey: params.parentSessionKey,\n    });\n    const source = normalizeWorkflowRunSourceForSession(params.source, sessionKey, params.parentSessionKey);\n    const abortController = new AbortController();\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);\n    const runStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);\n    const engine = this.createWorkflowEngine({\n      eventStore,\n      runStore,\n      sessionKey,\n    });\n    const inputEnvelope = params.inputEnvelope ?? buildWorkflowRunInputEnvelope(params.input, params.goal);\n\n    this.activeRuns.set(runId, abortController);\n    void engine.startRun(definition, {\n      runId,\n      input: inputEnvelope.payload,\n      goal: inputEnvelope.goal ?? params.goal,\n      source,\n      metadata: buildWorkflowRunMetadata({\n        definition,\n        agentId: params.agentId,\n        sessionKey,\n        source,\n        input: inputEnvelope,\n        retryOfRunId: params.retryOfRunId,\n        idempotencyKey: params.idempotencyKey,\n      }),\n      signal: abortController.signal,\n      concurrency: params.concurrency,\n      maxSubagents: params.maxSubagents,\n      tokenBudget: params.tokenBudget,\n    }).catch((err) => {\n      this.options.service.emit('workflow.run.error', {\n        runId,\n        error: err instanceof Error ? err.message : String(err),\n      });\n    }).finally(() => {\n      this.activeRuns.delete(runId);\n    });\n\n    return { ok: true, runId, sessionKey };\n  }\n\n  async retryWorkflowRun(params: RetryWorkflowRunServiceParams): Promise<WorkflowRunServiceResult> {\n    const runStore = this.createRunStore(params.agentId);\n    const existing = await runStore.readRunView(params.runId);\n    if (!existing) {\n      return {\n        ok: false,\n        code: 'run_not_found',\n        message: 'Workflow run not found',\n        httpStatus: 404,\n      };\n    }\n\n    const parentSessionKey =\n      existing.run.source.kind === 'chat' ? existing.run.source.sessionKey : undefined;\n\n    return this.startWorkflowRun({\n      agentId: params.agentId,\n      definitionId: existing.run.definitionId,\n      input: existing.run.input,\n      goal: existing.run.goal,\n      source: existing.run.source,\n      parentSessionKey,\n      retryOfRunId: existing.run.id,\n    });\n  }\n\n  async cancelWorkflowRun(params: CancelWorkflowRunServiceParams): Promise<CancelWorkflowRunResult> {\n    const controller = this.activeRuns.get(params.runId);\n    if (controller) {\n      controller.abort();\n      this.activeRuns.delete(params.runId);\n      return { ok: true, cancelled: true };\n    }\n\n    const runStore = this.createRunStore(params.agentId);\n    const view = await runStore.readRunView(params.runId);\n    if (!view) {\n      return {\n        ok: false,\n        code: 'run_not_found',\n        message: 'Workflow run not found',\n        httpStatus: 404,\n      };\n    }\n\n    if (isTerminalWorkflowRunStatus(view.run.status)) {\n      return { ok: true, cancelled: true, alreadyFinished: true };\n    }\n\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);\n    await eventStore.append({\n      runId: params.runId,\n      type: 'run_cancelled',\n      payload: { reason: params.reason ?? 'Cancelled by user' },\n    });\n    const updated = await runStore.rebuildRunView(params.runId);\n    if (updated) {\n      this.options.service.emit('workflow.run.updated', { runId: params.runId, view: updated });\n      void this.options.sessionBridge.handleRunViewUpdated(updated);\n    }\n    return { ok: true, cancelled: true };\n  }\n\n  createRunStore(agentId: string): WorkflowRunStore {\n    const eventStore = new WorkflowEventStore(this.options.service.currentConfig, agentId);\n    return new WorkflowRunStore(this.options.service.currentConfig, agentId, eventStore);\n  }\n\n  private loadDefinition(definitionId: string): WorkflowDefinition | null {\n    const catalog = createWorkflowCatalog();\n    try {\n      const loaded = catalog.load(definitionId);\n      return buildWorkflowDefinition({\n        name: loaded.name,\n        source: loaded.source,\n        script: loaded.script,\n        meta: loaded.meta,\n      });\n    } catch {\n      return null;\n    }\n  }\n\n  private createWorkflowEngine(params: {\n    eventStore: WorkflowEventStore;\n    runStore: WorkflowRunStore;\n    sessionKey: string;\n  }): WorkflowEngine {\n    const gatewayService = this.options.service;\n    const runner = new DelegateSubagentRunner({\n      workspace: gatewayService.currentWorkspacePath,\n      bus: gatewayService.messageBusInstance,\n      getDefaultModel: () => resolveModelById(gatewayService.agentService.getModelForSession(params.sessionKey)),\n      getConfig: () => gatewayService.currentConfig,\n      buildChildTools: (childOptions) => this.options.buildChildTools(childOptions),\n    });\n\n    return new WorkflowEngine({\n      cwd: gatewayService.currentWorkspacePath,\n      eventStore: params.eventStore,\n      runStore: params.runStore,\n      runner,\n      resolveModelId: (modelId) => {\n        const agentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);\n        return resolveModelById(resolveModelRef(gatewayService.currentConfig, agentId, modelId));\n      },\n      onEventAppended: (event) => {\n        gatewayService.emit('workflow.event.appended', { runId: event.runId, event });\n      },\n      onRunViewUpdated: (view) => {\n        gatewayService.emit('workflow.run.updated', { runId: view.run.id, view });\n        void this.options.sessionBridge.handleRunViewUpdated(view);\n      },\n    });\n  }\n}\n\nfunction normalizeWorkflowRunSourceForSession(\n  source: WorkflowRunSource,\n  workflowSessionKey: string,\n  parentSessionKey?: string,\n): WorkflowRunSource {\n  if (parentSessionKey?.trim()) {\n    return { kind: 'chat', sessionKey: parentSessionKey.trim() };\n  }\n  if (source.kind === 'webui') {\n    return { ...source, sessionKey: workflowSessionKey };\n  }\n  if (source.kind === 'chat') {\n    return source;\n  }\n  return source;\n}\n\nexport function buildWorkflowRunInputEnvelope(input: unknown, goal?: string): WorkflowRunInputEnvelope {\n  if (isWorkflowRunInputEnvelope(input)) {\n    return input;\n  }\n  return {\n    payload: input ?? {},\n    goal,\n  };\n}\n\nexport function buildWorkflowRunMetadata(params: {\n  definition: WorkflowDefinition;\n  agentId: string;\n  sessionKey: string;\n  source: WorkflowRunSource;\n  input: WorkflowRunInputEnvelope;\n  retryOfRunId?: string;\n  idempotencyKey?: string;\n}): WorkflowRunMetadata {\n  return {\n    sessionKey: params.sessionKey,\n    triggerSource: params.source.kind,\n    agentId: params.agentId,\n    retryOfRunId: params.retryOfRunId,\n    definition: buildWorkflowRunDefinitionSnapshot(params.definition),\n    input: params.input,\n    correlation: {\n      idempotencyKey: params.idempotencyKey,\n    },\n    origin: buildWorkflowRunOrigin(params.source),\n    schedule: params.source.kind === 'cron'\n      ? { scheduleId: params.source.scheduleId, fireId: params.source.fireId }\n      : undefined,\n  };\n}\n\nexport function buildWorkflowRunDefinitionSnapshot(definition: WorkflowDefinition): WorkflowRunDefinitionSnapshot {\n  return {\n    id: definition.id,\n    name: definition.name,\n    title: definition.title,\n    version: definition.version,\n    source: definition.metadata.source,\n    tags: [...definition.metadata.tags],\n    phaseCount: definition.phases.length,\n    estimatedAgents: definition.metadata.estimatedAgents,\n  };\n}\n\nexport function extractWorkflowRunSessionKey(source: WorkflowRunSource): string | null {\n  if ('sessionKey' in source && typeof source.sessionKey === 'string' && source.sessionKey.trim()) {\n    return source.sessionKey.trim();\n  }\n  return null;\n}\n\nfunction buildWorkflowRunOrigin(source: WorkflowRunSource): WorkflowRunMetadata['origin'] {\n  switch (source.kind) {\n    case 'chat':\n      return { channel: 'chat', sessionKey: source.sessionKey, messageId: source.messageId };\n    case 'webui':\n      return { channel: 'webui', sessionKey: source.sessionKey };\n    case 'cron':\n      return { channel: 'cron', scheduleId: source.scheduleId, fireId: source.fireId };\n    case 'api':\n      return { channel: 'api', requestId: source.requestId };\n    case 'im':\n      return { channel: source.channel, chatId: source.chatId, messageId: source.messageId };\n  }\n}\n\nfunction isWorkflowRunInputEnvelope(input: unknown): input is WorkflowRunInputEnvelope {\n  if (!input || typeof input !== 'object' || Array.isArray(input)) {\n    return false;\n  }\n  return 'payload' in input || 'variables' in input || 'context' in input;\n}\n"],"mappings":"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"}

package/dist/src/workflows/service/workflow-run-service.types.d.ts

@@ -0,0 +1,47 @@
+import type { WorkflowRunInputEnvelope, WorkflowRunSource } from '../domain/index.js';
+export interface StartWorkflowRunServiceParams {
+    agentId: string;
+    definitionId: string;
+    parentSessionKey?: string;
+    input?: unknown;
+    inputEnvelope?: WorkflowRunInputEnvelope;
+    goal?: string;
+    source: WorkflowRunSource;
+    concurrency?: number;
+    maxSubagents?: number;
+    tokenBudget?: number | null;
+    retryOfRunId?: string;
+    idempotencyKey?: string;
+}
+export interface StartWorkflowRunServiceResult {
+    ok: true;
+    runId: string;
+    sessionKey: string;
+}
+export type WorkflowRunServiceErrorCode = 'definition_not_found' | 'run_not_found' | 'invalid_state';
+export interface WorkflowRunServiceErrorResult {
+    ok: false;
+    code: WorkflowRunServiceErrorCode;
+    message: string;
+    httpStatus: 400 | 404 | 409;
+}
+export type WorkflowRunServiceResult = StartWorkflowRunServiceResult | WorkflowRunServiceErrorResult;
+export interface RetryWorkflowRunServiceParams {
+    agentId: string;
+    runId: string;
+}
+export interface CancelWorkflowRunServiceParams {
+    agentId: string;
+    runId: string;
+    reason?: string;
+}
+export interface CancelWorkflowRunServiceResult {
+    ok: true;
+    cancelled: boolean;
+    alreadyFinished?: boolean;
+}
+export type CancelWorkflowRunResult = CancelWorkflowRunServiceResult | WorkflowRunServiceErrorResult;
+/** Minimal surface for agent/cron callers (avoids importing the service class). */
+export interface WorkflowRunServiceLike {
+    startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
+}

package/dist/src/workflows/service/workflow-run-service.types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/workflows/service/workflow-session-bridge.d.ts

@@ -0,0 +1,29 @@
+import type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';
+import type { WorkflowRunView } from '../domain/index.js';
+export declare const WORKFLOW_SESSION_TYPE = "workflow";
+export declare const WORKFLOW_RUN_LINK_CONTEXT_KIND = "workflow-run-link";
+export interface PrepareWorkflowRunSessionParams {
+    runId: string;
+    agentId: string;
+    definitionId: string;
+    definitionTitle: string;
+    goal: string;
+    parentSessionKey?: string;
+}
+export interface PrepareWorkflowRunSessionResult {
+    sessionKey: string;
+}
+export declare class WorkflowSessionBridge {
+    private readonly gateway;
+    private readonly terminalPersistedRunIds;
+    constructor(gateway: GatewayWorkflowHost);
+    prepareRunSession(params: PrepareWorkflowRunSessionParams): Promise<PrepareWorkflowRunSessionResult>;
+    handleRunViewUpdated(view: WorkflowRunView): Promise<void>;
+    private persistTerminalTranscript;
+    private writeParentRunLink;
+}
+export declare function formatParentRunLinkText(params: {
+    definitionId: string;
+    goal: string;
+    status: WorkflowRunView['run']['status'];
+}): string;

package/dist/src/workflows/service/workflow-session-bridge.js

@@ -0,0 +1,177 @@
+import { appendPiTranscriptContextEntry, appendPiTranscriptMessage } from "../../session/parity/jsonl-transcript-io.js";
+import { renderWorkflowText } from "../../agent/workflow/snapshot.js";
+import "../../session/types.js";
+import { isTerminalWorkflowRunStatus } from "../domain/run.js";
+import "../domain/index.js";
+import { runViewToSnapshot } from "./run-view-to-snapshot.js";
+import { buildWorkflowRunSessionKey } from "./workflow-session-key.js";
+import { randomUUID } from "node:crypto";
+//#region src/workflows/service/workflow-session-bridge.ts
+const WORKFLOW_SESSION_TYPE = "workflow";
+const WORKFLOW_RUN_LINK_CONTEXT_KIND = "workflow-run-link";
+var WorkflowSessionBridge = class {
+	terminalPersistedRunIds = /* @__PURE__ */ new Set();
+	constructor(gateway) {
+		this.gateway = gateway;
+	}
+	async prepareRunSession(params) {
+		const sessionKey = buildWorkflowRunSessionKey(params.agentId, params.runId);
+		const goalText = formatWorkflowGoalUserMessage(params.definitionId, params.goal);
+		const sessionName = truncateSessionName(params.goal.trim() || params.definitionTitle || params.definitionId);
+		const store = this.gateway.sessionIndexInstance.getStore();
+		await store.resolveTranscriptPath(sessionKey);
+		await store.updateMetadata(sessionKey, {
+			sessionType: WORKFLOW_SESSION_TYPE,
+			name: sessionName,
+			tags: ["workflow", params.definitionId],
+			customData: {
+				workflowRunId: params.runId,
+				workflowDefinitionId: params.definitionId,
+				workflowGoal: params.goal,
+				...params.parentSessionKey ? { parentSessionKey: params.parentSessionKey } : {}
+			}
+		});
+		const { absPath } = await store.resolveTranscriptPath(sessionKey);
+		await appendPiTranscriptMessage({
+			absPath,
+			cwd: process.cwd(),
+			sessionKey,
+			message: {
+				role: "user",
+				content: [{
+					type: "text",
+					text: goalText
+				}],
+				timestamp: Date.now()
+			}
+		});
+		if (params.parentSessionKey?.trim()) await this.writeParentRunLink({
+			parentSessionKey: params.parentSessionKey.trim(),
+			runId: params.runId,
+			workflowSessionKey: sessionKey,
+			definitionId: params.definitionId,
+			goal: params.goal,
+			status: "running"
+		});
+		this.gateway.emit("session.updated", {
+			key: sessionKey,
+			name: sessionName
+		});
+		return { sessionKey };
+	}
+	async handleRunViewUpdated(view) {
+		const runId = view.run.id;
+		const sessionKey = view.run.metadata?.sessionKey?.trim();
+		if (!sessionKey || !isTerminalWorkflowRunStatus(view.run.status)) return;
+		if (this.terminalPersistedRunIds.has(runId)) return;
+		this.terminalPersistedRunIds.add(runId);
+		await this.persistTerminalTranscript(sessionKey, view);
+		const parentSessionKey = readParentSessionKey(view);
+		if (parentSessionKey) await this.writeParentRunLink({
+			parentSessionKey,
+			runId,
+			workflowSessionKey: sessionKey,
+			definitionId: view.run.definitionId,
+			goal: view.run.goal,
+			status: view.run.status
+		});
+	}
+	async persistTerminalTranscript(sessionKey, view) {
+		const store = this.gateway.sessionIndexInstance.getStore();
+		const { absPath } = await store.resolveTranscriptPath(sessionKey);
+		const snapshot = runViewToSnapshot(view);
+		const toolCallId = randomUUID();
+		const envelope = {
+			content: [{
+				type: "text",
+				text: renderWorkflowText(snapshot, view.run.status === "succeeded", { showResultPreviews: true })
+			}],
+			details: snapshot
+		};
+		const isError = view.run.status === "failed" || view.run.status === "timeout";
+		await appendPiTranscriptMessage({
+			absPath,
+			cwd: process.cwd(),
+			sessionKey,
+			message: {
+				role: "assistant",
+				content: [{
+					type: "toolCall",
+					id: toolCallId,
+					name: "workflow",
+					arguments: { name: view.run.definitionId }
+				}],
+				timestamp: Date.now()
+			}
+		});
+		await appendPiTranscriptMessage({
+			absPath,
+			cwd: process.cwd(),
+			sessionKey,
+			message: {
+				role: "toolResult",
+				toolCallId,
+				content: [{
+					type: "text",
+					text: JSON.stringify(envelope)
+				}],
+				details: snapshot,
+				isError,
+				timestamp: Date.now()
+			}
+		});
+		await store.updateMetadata(sessionKey, { status: "active" });
+	}
+	async writeParentRunLink(params) {
+		const { absPath } = await this.gateway.sessionIndexInstance.getStore().resolveTranscriptPath(params.parentSessionKey);
+		const text = formatParentRunLinkText(params);
+		await appendPiTranscriptContextEntry({
+			absPath,
+			cwd: process.cwd(),
+			sessionKey: params.parentSessionKey,
+			entry: {
+				kind: "context",
+				id: `workflow-run-link:${params.runId}`,
+				text,
+				data: {
+					kind: WORKFLOW_RUN_LINK_CONTEXT_KIND,
+					runId: params.runId,
+					workflowSessionKey: params.workflowSessionKey,
+					definitionId: params.definitionId,
+					goal: params.goal,
+					status: params.status
+				},
+				createdAt: (/* @__PURE__ */ new Date()).toISOString()
+			}
+		});
+	}
+};
+function formatWorkflowGoalUserMessage(definitionId, goal) {
+	const trimmedGoal = goal.trim();
+	if (trimmedGoal) return `Run workflow \`${definitionId}\`:\n\n${trimmedGoal}`;
+	return `Run workflow \`${definitionId}\``;
+}
+function truncateSessionName(name) {
+	const trimmed = name.trim();
+	if (trimmed.length <= 80) return trimmed;
+	return `${trimmed.slice(0, 77)}…`;
+}
+function readParentSessionKey(view) {
+	if (view.run.source.kind === "chat") {
+		const originKey = view.run.source.sessionKey?.trim();
+		if (originKey) return originKey;
+	}
+	const customParent = view.run.metadata?.origin?.sessionKey?.trim();
+	if (customParent && view.run.metadata?.triggerSource === "chat") return customParent;
+	return null;
+}
+function formatParentRunLinkText(params) {
+	const label = params.goal.trim() || params.definitionId;
+	if (params.status === "running" || params.status === "queued") return `Workflow \`${params.definitionId}\` is running: ${label}`;
+	if (params.status === "succeeded") return `Workflow \`${params.definitionId}\` completed: ${label}`;
+	return `Workflow \`${params.definitionId}\` finished (${params.status}): ${label}`;
+}
+//#endregion
+export { WORKFLOW_RUN_LINK_CONTEXT_KIND, WORKFLOW_SESSION_TYPE, WorkflowSessionBridge, formatParentRunLinkText };
+
+//# sourceMappingURL=workflow-session-bridge.js.map

package/dist/src/workflows/service/workflow-session-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-session-bridge.js","names":[],"sources":["../../../../src/workflows/service/workflow-session-bridge.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';\nimport { renderWorkflowText } from '../../agent/workflow/snapshot.js';\nimport {\n  appendPiTranscriptContextEntry,\n  appendPiTranscriptMessage,\n} from '../../session/parity/jsonl-transcript-io.js';\nimport { SessionStatus } from '../../session/types.js';\nimport type { WorkflowRunView } from '../domain/index.js';\nimport { isTerminalWorkflowRunStatus } from '../domain/index.js';\n\nimport { runViewToSnapshot } from './run-view-to-snapshot.js';\nimport { buildWorkflowRunSessionKey } from './workflow-session-key.js';\n\nexport const WORKFLOW_SESSION_TYPE = 'workflow';\nexport const WORKFLOW_RUN_LINK_CONTEXT_KIND = 'workflow-run-link';\n\nexport interface PrepareWorkflowRunSessionParams {\n  runId: string;\n  agentId: string;\n  definitionId: string;\n  definitionTitle: string;\n  goal: string;\n  parentSessionKey?: string;\n}\n\nexport interface PrepareWorkflowRunSessionResult {\n  sessionKey: string;\n}\n\nexport class WorkflowSessionBridge {\n  private readonly terminalPersistedRunIds = new Set<string>();\n\n  constructor(private readonly gateway: GatewayWorkflowHost) {}\n\n  async prepareRunSession(params: PrepareWorkflowRunSessionParams): Promise<PrepareWorkflowRunSessionResult> {\n    const sessionKey = buildWorkflowRunSessionKey(params.agentId, params.runId);\n    const goalText = formatWorkflowGoalUserMessage(params.definitionId, params.goal);\n    const sessionName = truncateSessionName(params.goal.trim() || params.definitionTitle || params.definitionId);\n\n    const store = this.gateway.sessionIndexInstance.getStore();\n    await store.resolveTranscriptPath(sessionKey);\n    await store.updateMetadata(sessionKey, {\n      sessionType: WORKFLOW_SESSION_TYPE,\n      name: sessionName,\n      tags: ['workflow', params.definitionId],\n      customData: {\n        workflowRunId: params.runId,\n        workflowDefinitionId: params.definitionId,\n        workflowGoal: params.goal,\n        ...(params.parentSessionKey ? { parentSessionKey: params.parentSessionKey } : {}),\n      },\n    });\n\n    const { absPath } = await store.resolveTranscriptPath(sessionKey);\n    await appendPiTranscriptMessage({\n      absPath,\n      cwd: process.cwd(),\n      sessionKey,\n      message: {\n        role: 'user',\n        content: [{ type: 'text', text: goalText }],\n        timestamp: Date.now(),\n      },\n    });\n\n    if (params.parentSessionKey?.trim()) {\n      await this.writeParentRunLink({\n        parentSessionKey: params.parentSessionKey.trim(),\n        runId: params.runId,\n        workflowSessionKey: sessionKey,\n        definitionId: params.definitionId,\n        goal: params.goal,\n        status: 'running',\n      });\n    }\n\n    this.gateway.emit('session.updated', { key: sessionKey, name: sessionName });\n    return { sessionKey };\n  }\n\n  async handleRunViewUpdated(view: WorkflowRunView): Promise<void> {\n    const runId = view.run.id;\n    const sessionKey = view.run.metadata?.sessionKey?.trim();\n    if (!sessionKey || !isTerminalWorkflowRunStatus(view.run.status)) {\n      return;\n    }\n    if (this.terminalPersistedRunIds.has(runId)) {\n      return;\n    }\n    this.terminalPersistedRunIds.add(runId);\n\n    await this.persistTerminalTranscript(sessionKey, view);\n\n    const parentSessionKey = readParentSessionKey(view);\n    if (parentSessionKey) {\n      await this.writeParentRunLink({\n        parentSessionKey,\n        runId,\n        workflowSessionKey: sessionKey,\n        definitionId: view.run.definitionId,\n        goal: view.run.goal,\n        status: view.run.status,\n      });\n    }\n  }\n\n  private async persistTerminalTranscript(sessionKey: string, view: WorkflowRunView): Promise<void> {\n    const store = this.gateway.sessionIndexInstance.getStore();\n    const { absPath } = await store.resolveTranscriptPath(sessionKey);\n    const snapshot = runViewToSnapshot(view);\n    const toolCallId = randomUUID();\n    const completed = view.run.status === 'succeeded';\n    const resultText = renderWorkflowText(snapshot, completed, { showResultPreviews: true });\n    const envelope = {\n      content: [{ type: 'text', text: resultText }],\n      details: snapshot,\n    };\n    const isError = view.run.status === 'failed' || view.run.status === 'timeout';\n\n    await appendPiTranscriptMessage({\n      absPath,\n      cwd: process.cwd(),\n      sessionKey,\n      message: {\n        role: 'assistant',\n        content: [\n          {\n            type: 'toolCall',\n            id: toolCallId,\n            name: 'workflow',\n            arguments: { name: view.run.definitionId },\n          },\n        ],\n        timestamp: Date.now(),\n      } as unknown as Parameters<typeof appendPiTranscriptMessage>[0]['message'],\n    });\n\n    await appendPiTranscriptMessage({\n      absPath,\n      cwd: process.cwd(),\n      sessionKey,\n      message: {\n        role: 'toolResult',\n        toolCallId,\n        content: [{ type: 'text', text: JSON.stringify(envelope) }],\n        details: snapshot,\n        isError,\n        timestamp: Date.now(),\n      } as Parameters<typeof appendPiTranscriptMessage>[0]['message'],\n    });\n\n    await store.updateMetadata(sessionKey, {\n      status: SessionStatus.ACTIVE,\n    });\n  }\n\n  private async writeParentRunLink(params: {\n    parentSessionKey: string;\n    runId: string;\n    workflowSessionKey: string;\n    definitionId: string;\n    goal: string;\n    status: WorkflowRunView['run']['status'];\n  }): Promise<void> {\n    const store = this.gateway.sessionIndexInstance.getStore();\n    const { absPath } = await store.resolveTranscriptPath(params.parentSessionKey);\n    const text = formatParentRunLinkText(params);\n    await appendPiTranscriptContextEntry({\n      absPath,\n      cwd: process.cwd(),\n      sessionKey: params.parentSessionKey,\n      entry: {\n        kind: 'context',\n        id: `workflow-run-link:${params.runId}`,\n        text,\n        data: {\n          kind: WORKFLOW_RUN_LINK_CONTEXT_KIND,\n          runId: params.runId,\n          workflowSessionKey: params.workflowSessionKey,\n          definitionId: params.definitionId,\n          goal: params.goal,\n          status: params.status,\n        },\n        createdAt: new Date().toISOString(),\n      },\n    });\n  }\n}\n\nfunction formatWorkflowGoalUserMessage(definitionId: string, goal: string): string {\n  const trimmedGoal = goal.trim();\n  if (trimmedGoal) {\n    return `Run workflow \\`${definitionId}\\`:\\n\\n${trimmedGoal}`;\n  }\n  return `Run workflow \\`${definitionId}\\``;\n}\n\nfunction truncateSessionName(name: string): string {\n  const trimmed = name.trim();\n  if (trimmed.length <= 80) return trimmed;\n  return `${trimmed.slice(0, 77)}…`;\n}\n\nfunction readParentSessionKey(view: WorkflowRunView): string | null {\n  if (view.run.source.kind === 'chat') {\n    const originKey = view.run.source.sessionKey?.trim();\n    if (originKey) return originKey;\n  }\n  const customParent = view.run.metadata?.origin?.sessionKey?.trim();\n  if (customParent && view.run.metadata?.triggerSource === 'chat') {\n    return customParent;\n  }\n  return null;\n}\n\nexport function formatParentRunLinkText(params: {\n  definitionId: string;\n  goal: string;\n  status: WorkflowRunView['run']['status'];\n}): string {\n  const label = params.goal.trim() || params.definitionId;\n  if (params.status === 'running' || params.status === 'queued') {\n    return `Workflow \\`${params.definitionId}\\` is running: ${label}`;\n  }\n  if (params.status === 'succeeded') {\n    return `Workflow \\`${params.definitionId}\\` completed: ${label}`;\n  }\n  return `Workflow \\`${params.definitionId}\\` finished (${params.status}): ${label}`;\n}\n"],"mappings":"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"}

package/dist/src/workflows/service/workflow-session-key.d.ts

@@ -0,0 +1,3 @@
+/** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */
+export declare function buildWorkflowRunSessionKey(agentId: string, runId: string): string;
+export declare function readWorkflowRunIdFromSessionCustomData(customData: Record<string, unknown> | undefined): string | null;

package/dist/src/workflows/service/workflow-session-key.js

@@ -0,0 +1,21 @@
+import { buildSessionKey, init_session_key } from "../../routing/session-key.js";
+//#region src/workflows/service/workflow-session-key.ts
+init_session_key();
+/** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */
+function buildWorkflowRunSessionKey(agentId, runId) {
+	return buildSessionKey({
+		agentId,
+		source: "webchat",
+		accountId: "default",
+		peerKind: "direct",
+		peerId: `wf_${runId}`
+	});
+}
+function readWorkflowRunIdFromSessionCustomData(customData) {
+	const raw = customData?.workflowRunId;
+	return typeof raw === "string" && raw.trim() ? raw.trim() : null;
+}
+//#endregion
+export { buildWorkflowRunSessionKey, readWorkflowRunIdFromSessionCustomData };
+
+//# sourceMappingURL=workflow-session-key.js.map

package/dist/src/workflows/service/workflow-session-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-session-key.js","names":[],"sources":["../../../../src/workflows/service/workflow-session-key.ts"],"sourcesContent":["import { buildSessionKey } from '../../routing/session-key.js';\n\n/** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */\nexport function buildWorkflowRunSessionKey(agentId: string, runId: string): string {\n  return buildSessionKey({\n    agentId,\n    source: 'webchat',\n    accountId: 'default',\n    peerKind: 'direct',\n    peerId: `wf_${runId}`,\n  });\n}\n\nexport function readWorkflowRunIdFromSessionCustomData(\n  customData: Record<string, unknown> | undefined,\n): string | null {\n  const raw = customData?.workflowRunId;\n  return typeof raw === 'string' && raw.trim() ? raw.trim() : null;\n}\n"],"mappings":";;kBAA+D;;AAG/D,SAAgB,2BAA2B,SAAiB,OAAuB;AACjF,QAAO,gBAAgB;EACrB;EACA,QAAQ;EACR,WAAW;EACX,UAAU;EACV,QAAQ,MAAM;EACf,CAAC;;AAGJ,SAAgB,uCACd,YACe;CACf,MAAM,MAAM,YAAY;AACxB,QAAO,OAAO,QAAQ,YAAY,IAAI,MAAM,GAAG,IAAI,MAAM,GAAG"}

package/dist/src/workflows/store/event-store.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { resolveWorkflowRunEventsPath, resolveWorkflowRunsDir } from "./paths.js";
+import { dirname } from "node:path";
 import { randomUUID } from "node:crypto";
 import { appendFile, mkdir, readFile, readdir } from "node:fs/promises";
-import { dirname } from "node:path";
 //#region src/workflows/store/event-store.ts
 init_logger();
 const log = createLogger("WorkflowEventStore");

package/dist/src/workflows/store/run-store.js

@@ -1,6 +1,6 @@
-import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { init_write_file_atomic, writeTextAtomic } from "../../infra/write-file-atomic.js";
 import { projectWorkflowRunView } from "../engine/projector.js";
 import { resolveWorkflowRunViewPath } from "./paths.js";
 import { WorkflowEventStore } from "./event-store.js";
@@ -49,6 +49,7 @@ var WorkflowRunStore = class {
 				title: view.run.title,
 				status: view.run.status,
 				source: view.run.source,
+				metadata: view.run.metadata,
 				createdAtMs: view.run.createdAtMs,
 				startedAtMs: view.run.startedAtMs,
 				completedAtMs: view.run.completedAtMs,