@xopcai/xopc 0.0.409 → 0.0.411

package/dist/src/workflows/index.d.ts

@@ -1,11 +0,0 @@
-export * from './domain/index.js';
-export * from './engine/index.js';
-export * from './runtime/index.js';
-export * from './registry/index.js';
-export * from './service/workflow-run-service.js';
-export * from './service/workflow-session-bridge.js';
-export * from './service/workflow-session-key.js';
-export * from './service/run-view-to-snapshot.js';
-export * from './store/event-store.js';
-export * from './store/paths.js';
-export * from './store/run-store.js';

package/dist/src/workflows/index.js

@@ -1,19 +0,0 @@
-import { DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, buildWorkflowDefinition, deriveWorkflowPhases, hashWorkflowStableValue, normalizeWorkflowDefinitionId, toWorkflowDefinitionTitle } from "./domain/definition-utils.js";
-import { validateWorkflowDefinitionInput, validateWorkflowGraph } from "./domain/validation.js";
-import { isTerminalWorkflowRunStatus } from "./domain/run.js";
-import { validateWorkflowJsonSchema } from "./domain/schema-validation.js";
-import "./domain/index.js";
-import { CatalogWorkflowDefinitionRegistry } from "./registry/catalog-workflow-definition-registry.js";
-import { projectWorkflowRunView } from "./engine/projector.js";
-import { GraphWorkflowRuntime, createGraphWorkflowRuntime, renderWorkflowTemplate } from "./runtime/graph-workflow-runtime.js";
-import { WorkflowEngine } from "./engine/workflow-engine.js";
-import "./engine/index.js";
-import { WorkflowEventStore, createWorkflowEventStore } from "./store/event-store.js";
-import { WorkflowRunStore, createWorkflowRunStore } from "./store/run-store.js";
-import { WorkflowRunService, buildWorkflowContextInstructions, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunConversationId, preparationDefinition, resolveWorkflowReplayTargets } from "./service/workflow-run-service.js";
-import { runViewToSnapshot } from "./service/run-view-to-snapshot.js";
-import { buildWorkflowRunConversationId, readWorkflowRunIdFromSessionCustomData } from "./service/workflow-session-key.js";
-import { WORKFLOW_RUN_LINK_CONTEXT_KIND, WORKFLOW_SESSION_TYPE, WorkflowSessionBridge, formatParentRunLinkText } from "./service/workflow-session-bridge.js";
-import "./registry/index.js";
-import { resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunsDir } from "./store/paths.js";
-export { CatalogWorkflowDefinitionRegistry, DEFAULT_WORKFLOW_CONCURRENCY, DEFAULT_WORKFLOW_MAX_SUBAGENTS, DEFAULT_WORKFLOW_TIMEOUT_SEC, GraphWorkflowRuntime, WORKFLOW_RUN_LINK_CONTEXT_KIND, WORKFLOW_SESSION_TYPE, WorkflowEngine, WorkflowEventStore, WorkflowRunService, WorkflowRunStore, WorkflowSessionBridge, buildWorkflowContextInstructions, buildWorkflowDefinition, buildWorkflowRunConversationId, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, createGraphWorkflowRuntime, createWorkflowEventStore, createWorkflowRunStore, deriveWorkflowPhases, extractWorkflowRunConversationId, formatParentRunLinkText, hashWorkflowStableValue, isTerminalWorkflowRunStatus, normalizeWorkflowDefinitionId, preparationDefinition, projectWorkflowRunView, readWorkflowRunIdFromSessionCustomData, renderWorkflowTemplate, resolveWorkflowReplayTargets, resolveWorkflowRootDir, resolveWorkflowRunArtifactsDir, resolveWorkflowRunDir, resolveWorkflowRunsDir, runViewToSnapshot, toWorkflowDefinitionTitle, validateWorkflowDefinitionInput, validateWorkflowGraph, validateWorkflowJsonSchema };

package/dist/src/workflows/project-presets/project-workflow-preset-repository.d.ts

@@ -1,20 +0,0 @@
-import type { WorkflowRunContextRef } from '../domain/index.js';
-export interface ProjectWorkflowPreset {
-    projectId: string;
-    definitionId: string;
-    contextRefs: WorkflowRunContextRef[];
-    createdAt: number;
-    updatedAt: number;
-}
-export declare class ProjectWorkflowPresetRepository {
-    list(projectId: string): ProjectWorkflowPreset[];
-    get(projectId: string, definitionId: string): ProjectWorkflowPreset | undefined;
-    save(input: {
-        projectId: string;
-        definitionId: string;
-        contextRefs: WorkflowRunContextRef[];
-        now?: number;
-    }): ProjectWorkflowPreset;
-    remove(projectId: string, definitionId: string): boolean;
-    removeDefinition(definitionId: string): number;
-}

package/dist/src/workflows/project-presets/project-workflow-preset-repository.js

@@ -1,39 +0,0 @@
-import { getSqliteDatabase, init_transaction } from "../../storage/sqlite/transaction.js";
-//#region src/workflows/project-presets/project-workflow-preset-repository.ts
-init_transaction();
-function fromRow(row) {
-	return {
-		projectId: row.project_id,
-		definitionId: row.definition_id,
-		contextRefs: JSON.parse(row.context_refs_json),
-		createdAt: row.created_at,
-		updatedAt: row.updated_at
-	};
-}
-var ProjectWorkflowPresetRepository = class {
-	list(projectId) {
-		return getSqliteDatabase().prepare("SELECT * FROM project_workflow_presets WHERE project_id = ? ORDER BY updated_at DESC").all(projectId).map(fromRow);
-	}
-	get(projectId, definitionId) {
-		const row = getSqliteDatabase().prepare("SELECT * FROM project_workflow_presets WHERE project_id = ? AND definition_id = ?").get(projectId, definitionId);
-		return row ? fromRow(row) : void 0;
-	}
-	save(input) {
-		const now = input.now ?? Date.now();
-		getSqliteDatabase().prepare(`INSERT INTO project_workflow_presets (
-        project_id, definition_id, context_refs_json, created_at, updated_at
-      ) VALUES (?, ?, ?, ?, ?)
-      ON CONFLICT(project_id, definition_id) DO UPDATE SET
-        context_refs_json = excluded.context_refs_json,
-        updated_at = excluded.updated_at`).run(input.projectId, input.definitionId, JSON.stringify(input.contextRefs), now, now);
-		return this.get(input.projectId, input.definitionId);
-	}
-	remove(projectId, definitionId) {
-		return getSqliteDatabase().prepare("DELETE FROM project_workflow_presets WHERE project_id = ? AND definition_id = ?").run(projectId, definitionId).changes > 0;
-	}
-	removeDefinition(definitionId) {
-		return Number(getSqliteDatabase().prepare("DELETE FROM project_workflow_presets WHERE definition_id = ?").run(definitionId).changes);
-	}
-};
-//#endregion
-export { ProjectWorkflowPresetRepository };

package/dist/src/workflows/registry/catalog-workflow-definition-registry.d.ts

@@ -1,9 +0,0 @@
-import { type WorkflowCatalog } from '../../agent/workflow/catalog.js';
-import type { WorkflowDefinition } from '../domain/definition.js';
-import type { WorkflowDefinitionRegistry, WorkflowDefinitionSummary } from './workflow-definition-registry.js';
-export declare class CatalogWorkflowDefinitionRegistry implements WorkflowDefinitionRegistry {
-    private readonly catalog;
-    constructor(catalog?: WorkflowCatalog);
-    list(): Promise<WorkflowDefinitionSummary[]>;
-    get(id: string): Promise<WorkflowDefinition | null>;
-}

package/dist/src/workflows/registry/catalog-workflow-definition-registry.js

@@ -1,30 +0,0 @@
-import { createWorkflowCatalog } from "../../agent/workflow/catalog.js";
-//#region src/workflows/registry/catalog-workflow-definition-registry.ts
-var CatalogWorkflowDefinitionRegistry = class {
-	constructor(catalog = createWorkflowCatalog()) {
-		this.catalog = catalog;
-	}
-	async list() {
-		return this.catalog.list().map((entry) => ({
-			id: entry.name,
-			name: entry.name,
-			title: entry.title ?? toTitle(entry.name),
-			description: entry.description,
-			source: entry.source,
-			tags: entry.tags,
-			whenToUse: entry.whenToUse
-		}));
-	}
-	async get(id) {
-		try {
-			return this.catalog.load(id);
-		} catch {
-			return null;
-		}
-	}
-};
-function toTitle(value) {
-	return value.split(/[_-]+/g).filter(Boolean).map((part) => `${part.slice(0, 1).toUpperCase()}${part.slice(1)}`).join(" ");
-}
-//#endregion
-export { CatalogWorkflowDefinitionRegistry };

package/dist/src/workflows/registry/index.d.ts

@@ -1,2 +0,0 @@
-export * from './workflow-definition-registry.js';
-export * from './catalog-workflow-definition-registry.js';

package/dist/src/workflows/registry/index.js

@@ -1,2 +0,0 @@
-import { CatalogWorkflowDefinitionRegistry } from "./catalog-workflow-definition-registry.js";
-export { CatalogWorkflowDefinitionRegistry };

package/dist/src/workflows/registry/workflow-definition-registry.d.ts

@@ -1,15 +0,0 @@
-import type { WorkflowDefinition } from '../domain/definition.js';
-export interface WorkflowDefinitionSummary {
-    id: string;
-    name: string;
-    title: string;
-    description: string;
-    source: 'builtin' | 'user';
-    tags?: string[];
-    whenToUse?: string;
-}
-/** Definition source port: filesystem, built-ins, remote packages, extensions. */
-export interface WorkflowDefinitionRegistry {
-    list(): Promise<WorkflowDefinitionSummary[]>;
-    get(id: string): Promise<WorkflowDefinition | null>;
-}

package/dist/src/workflows/registry/workflow-definition-registry.js

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

package/dist/src/workflows/runtime/graph-workflow-runtime.d.ts

@@ -1,10 +0,0 @@
-import type { WorkflowGraph } from '../domain/definition.js';
-import type { WorkflowRuntime, WorkflowRuntimeDeps, WorkflowRuntimeRunOptions, WorkflowRuntimeRunResult } from './workflow-runtime-port.js';
-export declare class GraphWorkflowRuntime implements WorkflowRuntime {
-    run<T = unknown>(graph: WorkflowGraph, deps: WorkflowRuntimeDeps, options: WorkflowRuntimeRunOptions): Promise<WorkflowRuntimeRunResult<T>>;
-}
-export declare function createGraphWorkflowRuntime(): WorkflowRuntime;
-export declare function renderWorkflowTemplate(template: string, input: unknown, outputs: Map<string, unknown>, predecessors: Array<{
-    id: string;
-    value: unknown;
-}>, goal?: string): string;

package/dist/src/workflows/runtime/graph-workflow-runtime.js

@@ -1,289 +0,0 @@
-import { validateWorkflowGraph } from "../domain/validation.js";
-import { availableParallelism } from "node:os";
-//#region src/workflows/runtime/graph-workflow-runtime.ts
-const MAX_CONCURRENCY = 16;
-var GraphWorkflowRuntime = class {
-	async run(graph, deps, options) {
-		const startedAtMs = Date.now();
-		const validation = validateWorkflowGraph(graph);
-		if (!validation.valid) throw new Error(validation.errors.map((issue) => issue.message).join(" "));
-		const nodes = new Map(graph.nodes.map((node) => [node.id, node]));
-		const incoming = indexEdges(graph.edges, "target");
-		const pending = new Set(graph.nodes.map((node) => node.id));
-		const completed = /* @__PURE__ */ new Set();
-		const skipped = /* @__PURE__ */ new Set();
-		const outputs = /* @__PURE__ */ new Map();
-		const decisions = /* @__PURE__ */ new Map();
-		const logs = [];
-		const phases = [];
-		let currentPhase;
-		let agentCount = 0;
-		const maxSubagents = Math.max(1, options.maxSubagents ?? 100);
-		const limiter = createLimiter(resolveConcurrency(options.concurrency));
-		const throwIfAborted = () => {
-			if (!options.signal?.aborted) return;
-			const reason = options.signal.reason;
-			throw reason instanceof Error ? reason : new Error(reason ? String(reason) : "workflow aborted");
-		};
-		while (pending.size > 0) {
-			throwIfAborted();
-			let progressed = false;
-			for (const nodeId of [...pending]) {
-				const edges = incoming.get(nodeId) ?? [];
-				if (edges.length === 0 || !edges.every((edge) => completed.has(edge.source) || skipped.has(edge.source))) continue;
-				if (edges.some((edge) => !skipped.has(edge.source) && isActiveEdge(edge, nodes, decisions))) continue;
-				pending.delete(nodeId);
-				skipped.add(nodeId);
-				const skippedNode = nodes.get(nodeId);
-				options.onNodeEnd?.({
-					nodeId,
-					kind: skippedNode.kind,
-					title: skippedNode.title,
-					status: "skipped"
-				});
-				progressed = true;
-			}
-			const ready = [...pending].map((id) => nodes.get(id)).filter((node) => {
-				const edges = incoming.get(node.id) ?? [];
-				if (edges.length === 0) return node.kind === "input";
-				const active = edges.filter((edge) => !skipped.has(edge.source) && isActiveEdge(edge, nodes, decisions));
-				return active.length > 0 && active.every((edge) => completed.has(edge.source));
-			});
-			if (ready.length === 0) {
-				if (progressed) continue;
-				throw new Error("workflow graph stalled before all nodes could run");
-			}
-			await Promise.all(ready.map((node) => limiter(async () => {
-				throwIfAborted();
-				options.onNodeStart?.({
-					nodeId: node.id,
-					kind: node.kind,
-					title: node.title
-				});
-				try {
-					if (node.phaseId && node.phaseId !== currentPhase) {
-						currentPhase = node.phaseId;
-						if (!phases.includes(node.phaseId)) phases.push(node.phaseId);
-						options.onPhase?.(node.phaseId);
-					}
-					const predecessors = (incoming.get(node.id) ?? []).filter((edge) => !skipped.has(edge.source) && isActiveEdge(edge, nodes, decisions)).map((edge) => ({
-						id: edge.source,
-						value: outputs.get(edge.source)
-					}));
-					let value;
-					if (node.kind === "input") value = options.args ?? {};
-					else if (node.kind === "agent") {
-						if (agentCount >= maxSubagents) throw new Error(`workflow agent quota exhausted (max ${maxSubagents})`);
-						agentCount += 1;
-						value = await runAgentNode({
-							id: agentCount,
-							node,
-							deps,
-							options,
-							outputs,
-							predecessors,
-							goal: options.goal,
-							signal: options.signal
-						});
-					} else if (node.kind === "decision") {
-						const candidate = predecessors.at(-1)?.value;
-						const result = evaluateDecision(node, candidate);
-						decisions.set(node.id, result);
-						value = {
-							result,
-							input: candidate
-						};
-					} else if (node.kind === "merge") value = node.config.mode === "array" ? predecessors.map((entry) => entry.value) : Object.fromEntries(predecessors.map((entry) => [entry.id, entry.value]));
-					else {
-						const outputData = predecessors.length === 1 ? predecessors[0].value : Object.fromEntries(predecessors.map((entry) => [entry.id, entry.value]));
-						value = {
-							summary: node.config.summary ? renderTemplate(node.config.summary, options.args, outputs, predecessors, options.goal) : renderResultContent(outputData),
-							...typeof outputData === "string" ? {} : { data: outputData }
-						};
-					}
-					outputs.set(node.id, value);
-					pending.delete(node.id);
-					completed.add(node.id);
-					options.onNodeEnd?.({
-						nodeId: node.id,
-						kind: node.kind,
-						title: node.title,
-						status: "done",
-						result: value
-					});
-				} catch (error) {
-					options.onNodeEnd?.({
-						nodeId: node.id,
-						kind: node.kind,
-						title: node.title,
-						status: options.signal?.aborted ? "skipped" : "error",
-						error: error instanceof Error ? error.message : String(error)
-					});
-					throw error;
-				}
-			})));
-		}
-		const outputNode = graph.nodes.find((node) => node.kind === "output");
-		return {
-			result: outputs.get(outputNode.id),
-			logs,
-			phases,
-			agentCount,
-			durationMs: Date.now() - startedAtMs
-		};
-	}
-};
-function createGraphWorkflowRuntime() {
-	return new GraphWorkflowRuntime();
-}
-async function runAgentNode(params) {
-	const { node } = params;
-	const prompt = renderTemplate(node.config.prompt, params.options.args, params.outputs, params.predecessors, params.goal);
-	const model = resolveModel(node.config.model, params.deps.resolveModelId);
-	const invocation = {
-		nodeId: node.id,
-		prompt,
-		label: node.title,
-		phase: node.phaseId,
-		modelRef: node.config.model,
-		resolvedModelRef: model ? `${model.provider}/${model.id}` : void 0,
-		schema: node.config.outputSchema,
-		toolset: node.config.toolset,
-		maxIterations: node.config.maxIterations
-	};
-	params.options.onAgentQueued?.({
-		id: params.id,
-		nodeId: node.id,
-		label: node.title,
-		phase: node.phaseId,
-		prompt,
-		invocation
-	});
-	params.options.onAgentStart?.({
-		id: params.id,
-		nodeId: node.id,
-		label: node.title,
-		phase: node.phaseId,
-		prompt
-	});
-	try {
-		const enhanced = params.options.enhanceSubagentRun?.({
-			id: params.id,
-			nodeId: node.id,
-			label: node.title,
-			phase: node.phaseId,
-			prompt
-		});
-		const result = await params.deps.runner.run(prompt, {
-			label: node.title,
-			schema: node.config.outputSchema,
-			allowedToolNames: node.config.toolset,
-			maxIterations: node.config.maxIterations,
-			model,
-			phase: node.phaseId,
-			signal: params.signal,
-			...enhanced
-		});
-		if (result === null) throw new Error(`workflow node '${node.title}' did not return a result`);
-		params.options.onAgentEnd?.({
-			id: params.id,
-			nodeId: node.id,
-			label: node.title,
-			phase: node.phaseId,
-			result,
-			status: "done"
-		});
-		return result;
-	} catch (error) {
-		const status = params.signal?.aborted ? "skipped" : "error";
-		params.options.onAgentEnd?.({
-			id: params.id,
-			nodeId: node.id,
-			label: node.title,
-			phase: node.phaseId,
-			result: null,
-			status
-		});
-		throw error;
-	}
-}
-function resolveModel(modelRef, resolver) {
-	if (!modelRef) return void 0;
-	if (!resolver) throw new Error("workflow runtime cannot resolve the selected model");
-	return resolver(modelRef);
-}
-function renderWorkflowTemplate(template, input, outputs, predecessors, goal) {
-	return renderTemplate(template, input, outputs, predecessors, goal);
-}
-function renderTemplate(template, input, outputs, predecessors, goal) {
-	const context = {
-		input,
-		goal,
-		nodes: Object.fromEntries(outputs),
-		predecessors: Object.fromEntries(predecessors.map((entry) => [entry.id, entry.value]))
-	};
-	return template.replace(/\{\{\s*([^}]+?)\s*\}\}/g, (_match, path) => stringifyTemplateValue(readPath(context, path)));
-}
-function readPath(value, path) {
-	return path.split(".").reduce((current, key) => {
-		if (current === null || typeof current !== "object") return void 0;
-		return current[key];
-	}, value);
-}
-function stringifyTemplateValue(value) {
-	if (value === void 0 || value === null) return "";
-	if (typeof value === "string") return value;
-	return JSON.stringify(value, null, 2);
-}
-function evaluateDecision(node, value) {
-	const candidate = node.config.rule.path ? readPath(value, node.config.rule.path) : value;
-	if (node.config.rule.operator === "exists") return candidate !== void 0 && candidate !== null;
-	if (node.config.rule.operator === "equals") return Object.is(candidate, node.config.rule.value);
-	if (node.config.rule.operator === "not_equals") return !Object.is(candidate, node.config.rule.value);
-	return Array.isArray(candidate) ? candidate.includes(node.config.rule.value) : String(candidate ?? "").includes(String(node.config.rule.value ?? ""));
-}
-function isActiveEdge(edge, nodes, decisions) {
-	if (nodes.get(edge.source)?.kind !== "decision") return true;
-	if (!decisions.has(edge.source)) return false;
-	if (!edge.sourcePort || edge.sourcePort === "default") return true;
-	return edge.sourcePort === (decisions.get(edge.source) ? "true" : "false");
-}
-function indexEdges(edges, field) {
-	const result = /* @__PURE__ */ new Map();
-	for (const edge of edges) result.set(edge[field], [...result.get(edge[field]) ?? [], edge]);
-	return result;
-}
-function resolveConcurrency(requested) {
-	if (requested && Number.isFinite(requested)) return Math.max(1, Math.min(MAX_CONCURRENCY, Math.floor(requested)));
-	return Math.max(1, Math.min(MAX_CONCURRENCY, availableParallelism() - 2));
-}
-function createLimiter(limit) {
-	let active = 0;
-	const queue = [];
-	return async (work) => {
-		if (active >= limit) await new Promise((resolve) => queue.push(resolve));
-		active += 1;
-		try {
-			return await work();
-		} finally {
-			active -= 1;
-			queue.shift()?.();
-		}
-	};
-}
-function renderResultContent(value) {
-	if (typeof value === "string") return value.trim();
-	if (value && typeof value === "object") {
-		const record = value;
-		for (const key of [
-			"content",
-			"summary",
-			"executiveSummary",
-			"result",
-			"answer"
-		]) if (typeof record[key] === "string") return record[key].trim();
-	}
-	return "Workflow completed.";
-}
-//#endregion
-export { GraphWorkflowRuntime, createGraphWorkflowRuntime, renderWorkflowTemplate };

package/dist/src/workflows/runtime/index.d.ts

@@ -1,2 +0,0 @@
-export * from './workflow-runtime-port.js';
-export * from './graph-workflow-runtime.js';

package/dist/src/workflows/runtime/index.js

@@ -1,2 +0,0 @@
-import { GraphWorkflowRuntime, createGraphWorkflowRuntime, renderWorkflowTemplate } from "./graph-workflow-runtime.js";
-export { GraphWorkflowRuntime, createGraphWorkflowRuntime, renderWorkflowTemplate };

package/dist/src/workflows/runtime/workflow-runtime-port.d.ts

@@ -1,13 +0,0 @@
-import type { Api, Model } from '@earendil-works/pi-ai';
-import type { SubagentRunner, WorkflowRunOptions, WorkflowRunResult } from '../../agent/workflow/types.js';
-import type { WorkflowGraph } from '../domain/definition.js';
-export type WorkflowRuntimeSubagentRunner = SubagentRunner;
-export type WorkflowRuntimeRunOptions = WorkflowRunOptions;
-export type WorkflowRuntimeRunResult<T = unknown> = WorkflowRunResult<T>;
-export interface WorkflowRuntimeDeps {
-    runner: WorkflowRuntimeSubagentRunner;
-    resolveModelId?: (modelId: string) => Model<Api>;
-}
-export interface WorkflowRuntime {
-    run<T = unknown>(graph: WorkflowGraph, deps: WorkflowRuntimeDeps, options: WorkflowRuntimeRunOptions): Promise<WorkflowRuntimeRunResult<T>>;
-}

package/dist/src/workflows/runtime/workflow-runtime-port.js

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

package/dist/src/workflows/service/run-view-to-snapshot.d.ts

@@ -1,4 +0,0 @@
-import type { WorkflowSnapshot } from '../../agent/workflow/types.js';
-import type { WorkflowRunView } from '../domain/index.js';
-/** Map persisted {@link WorkflowRunView} into chat {@link WorkflowSnapshot}. */
-export declare function runViewToSnapshot(view: WorkflowRunView): WorkflowSnapshot;

package/dist/src/workflows/service/run-view-to-snapshot.js

@@ -1,64 +0,0 @@
-//#region src/workflows/service/run-view-to-snapshot.ts
-function agentNumericId(id, index) {
-	const parsed = Number.parseInt(id, 10);
-	if (Number.isFinite(parsed)) return parsed;
-	return index + 1;
-}
-function resolveResultPayload(result) {
-	if (result == null) return void 0;
-	if (typeof result === "object" && result !== null && "raw" in result) {
-		const raw = result.raw;
-		return raw !== void 0 ? raw : result;
-	}
-	return result;
-}
-/** Map persisted {@link WorkflowRunView} into chat {@link WorkflowSnapshot}. */
-function runViewToSnapshot(view) {
-	const phaseTitleById = new Map(view.phases.map((phase) => [phase.id, phase.title]));
-	const runningPhase = view.phases.find((phase) => phase.status === "running");
-	const agents = view.agents.map((agent, index) => ({
-		id: agentNumericId(agent.id, index),
-		label: agent.label,
-		phase: agent.phaseId ? phaseTitleById.get(agent.phaseId) : void 0,
-		prompt: agent.prompt ?? "",
-		conversationId: agent.conversationId,
-		transcriptMessageCount: agent.transcriptMessageCount,
-		status: agent.status,
-		resultPreview: agent.resultPreview,
-		error: agent.error,
-		startedAtMs: agent.startedAtMs,
-		durationMs: agent.startedAtMs != null && agent.completedAtMs != null ? agent.completedAtMs - agent.startedAtMs : void 0,
-		currentStep: agent.currentStep,
-		steps: agent.steps?.map((step) => ({
-			id: step.id,
-			kind: step.kind,
-			toolName: step.toolName,
-			label: step.label,
-			detail: step.detail,
-			status: step.status,
-			resultPreview: step.resultPreview,
-			error: step.error,
-			startedAtMs: step.startedAtMs,
-			durationMs: step.startedAtMs != null && step.completedAtMs != null ? step.completedAtMs - step.startedAtMs : void 0
-		}))
-	}));
-	const { metrics } = view.run;
-	return {
-		runId: view.run.id,
-		name: view.run.definitionId,
-		description: view.run.goal || view.run.title,
-		phases: view.phases.map((phase) => phase.title),
-		currentPhase: runningPhase?.title,
-		logs: view.logs.map((entry) => entry.message),
-		agents,
-		agentCount: metrics.agentCount,
-		runningCount: Math.max(0, metrics.agentCount - metrics.doneAgentCount - metrics.errorAgentCount - metrics.skippedAgentCount),
-		doneCount: metrics.doneAgentCount,
-		errorCount: metrics.errorAgentCount,
-		skippedCount: metrics.skippedAgentCount,
-		durationMs: metrics.durationMs,
-		result: resolveResultPayload(view.run.result)
-	};
-}
-//#endregion
-export { runViewToSnapshot };

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

@@ -1,63 +0,0 @@
-import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { BuildChildToolsOptions } from '../../agent/child-agent-factory.js';
-import type { GatewayWorkflowHost } from '../../gateway/gateway-workflow-host.types.js';
-import type { WorkflowDefinitionRegistry } from '../registry/workflow-definition-registry.js';
-import type { WorkflowDefinition, WorkflowRunDefinitionSnapshot, WorkflowRunInputEnvelope, WorkflowRunMetadata, WorkflowRunSource } from '../domain/index.js';
-import { WorkflowRunStore } from '../store/run-store.js';
-import type { WorkflowSessionBridge } from './workflow-session-bridge.js';
-export type { CancelWorkflowRunResult, CancelWorkflowRunServiceParams, CancelWorkflowRunServiceResult, ReplayWorkflowRunServiceParams, RetryWorkflowRunServiceParams, StartWorkflowRunServiceParams, StartWorkflowRunServiceResult, WorkflowRunServiceErrorCode, WorkflowRunServiceErrorResult, WorkflowRunServiceResult, } from './workflow-run-service.types.js';
-import type { CancelWorkflowRunResult, CancelWorkflowRunServiceParams, ReplayWorkflowRunServiceParams, RetryWorkflowRunServiceParams, StartWorkflowRunServiceParams, WorkflowRunServiceResult } from './workflow-run-service.types.js';
-import type { WorkflowRunReplayMetadata, WorkflowRunReplayScope, WorkflowRunView } from '../domain/run.js';
-import type { WorkflowReplayAgentTarget } from '../engine/index.js';
-export interface WorkflowRunServiceOptions {
-    service: GatewayWorkflowHost;
-    sessionBridge: WorkflowSessionBridge;
-    buildChildTools: (childOptions: BuildChildToolsOptions) => AgentTool<any, any>[];
-    definitionRegistry?: WorkflowDefinitionRegistry;
-}
-export declare class WorkflowRunService {
-    private readonly options;
-    private readonly activeRuns;
-    private readonly timeoutHandles;
-    private readonly definitionRegistry;
-    private readonly emittedTerminalAutomationEvents;
-    constructor(options: WorkflowRunServiceOptions);
-    dispatchTaskRuns(): Promise<void>;
-    startWorkflowRun(params: StartWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
-    retryWorkflowRun(params: RetryWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
-    replayWorkflowRun(params: ReplayWorkflowRunServiceParams): Promise<WorkflowRunServiceResult>;
-    cancelWorkflowRun(params: CancelWorkflowRunServiceParams): Promise<CancelWorkflowRunResult>;
-    createRunStore(agentId: string): WorkflowRunStore;
-    readWorkflowRunView(agentId: string, runId: string): Promise<WorkflowRunView>;
-    reconcileInterruptedRuns(agentId: string): Promise<number>;
-    private loadDefinition;
-    private findRunByIdempotencyKey;
-    private createWorkflowEngine;
-    private publishTerminalWorkflowAutomationEvent;
-}
-export declare function buildWorkflowRunInputEnvelope(input: unknown, goal?: string): WorkflowRunInputEnvelope;
-export declare function buildWorkflowContextInstructions(resolvedInstructions: string | undefined, context: Record<string, unknown> | undefined, skillInstructions?: string): string | undefined;
-export declare function buildWorkflowRunMetadata(params: {
-    preparationOnly?: boolean;
-    definition: WorkflowDefinition;
-    agentId: string;
-    taskRunId?: string;
-    projectId?: string;
-    contextRefs?: WorkflowRunMetadata['contextRefs'];
-    contextSnapshot?: WorkflowRunMetadata['contextSnapshot'];
-    writebackPolicy?: WorkflowRunMetadata['writebackPolicy'];
-    conversationId: string;
-    source: WorkflowRunSource;
-    input: WorkflowRunInputEnvelope;
-    retryOfRunId?: string;
-    idempotencyKey?: string;
-    replay?: WorkflowRunReplayMetadata;
-}): WorkflowRunMetadata;
-export declare function resolveWorkflowReplayTargets(view: WorkflowRunView, scope: WorkflowRunReplayScope): {
-    targets: WorkflowReplayAgentTarget[];
-    phaseIds?: string[];
-};
-export declare function buildWorkflowRunDefinitionSnapshot(definition: WorkflowDefinition): WorkflowRunDefinitionSnapshot;
-export declare function extractWorkflowRunConversationId(source: WorkflowRunSource): string | null;
-/** Preparation runs can only transform supplied context into a reviewable result. */
-export declare function preparationDefinition(original: WorkflowDefinition): WorkflowDefinition;