@jshookmcp/jshook 0.2.8 → 0.2.9

package/dist/WorkflowEngine-CuvkZtWu.mjs

@@ -0,0 +1,598 @@
+import { t as __exportAll } from "./chunk-CjcI7cDX.mjs";
+import { t as logger } from "./logger-Dh_xb7_2.mjs";
+import { a as getEffectivePrerequisites, c as getRoutingState } from "./ToolRouter.policy-BWV67ZK-.mjs";
+import { randomUUID } from "node:crypto";
+//#region src/server/workflows/WorkflowRunStore.ts
+var WorkflowRunStore = class {
+	runs = /* @__PURE__ */ new Map();
+	lastSuccess = /* @__PURE__ */ new Map();
+	recordSuccess(result) {
+		const entry = {
+			workflowId: result.workflowId,
+			runId: result.runId,
+			startedAt: result.startedAt,
+			finishedAt: result.finishedAt,
+			durationMs: result.durationMs,
+			status: "success",
+			stepResultKeys: Object.keys(result.stepResults)
+		};
+		this.runs.set(result.runId, entry);
+		this.lastSuccess.set(result.workflowId, result);
+		logger.debug(`workflow run recorded: ${result.runId} (${result.workflowId})`);
+	}
+	recordError(workflowId, runId, startedAt, error) {
+		const entry = {
+			workflowId,
+			runId,
+			startedAt,
+			finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			durationMs: Date.now() - new Date(startedAt).getTime(),
+			status: "error",
+			stepResultKeys: []
+		};
+		this.runs.set(runId, entry);
+		logger.debug(`workflow run error: ${runId} (${workflowId}): ${error}`);
+	}
+	getRun(runId) {
+		return this.runs.get(runId);
+	}
+	getLastSuccess(workflowId) {
+		return this.lastSuccess.get(workflowId);
+	}
+	listRuns(workflowId) {
+		const entries = [...this.runs.values()];
+		if (workflowId) return entries.filter((e) => e.workflowId === workflowId);
+		return entries;
+	}
+	clear() {
+		this.runs.clear();
+		this.lastSuccess.clear();
+	}
+};
+//#endregion
+//#region src/server/workflows/WorkflowEngine.ts
+var WorkflowEngine_exports = /* @__PURE__ */ __exportAll({ executeExtensionWorkflow: () => executeExtensionWorkflow });
+/**
+* WorkflowDataBus — cross-node data bus for dynamic parameter passing.
+*
+* Supports expression templates like "${get-requests.scriptId}" to reference
+* outputs from previous steps.
+*/
+var WorkflowDataBus = class {
+	store = /* @__PURE__ */ new Map();
+	set(key, value) {
+		this.store.set(key, value);
+	}
+	get(key) {
+		return this.store.get(key);
+	}
+	/**
+	* Get a value at a specific path within a stored object.
+	* @param key - The key in the store
+	* @param path - Dot-separated path (e.g., "content.0.text")
+	*/
+	getValueAtPath(key, path) {
+		const value = this.store.get(key);
+		if (!value || typeof value !== "object") return value;
+		const obj = parseToolPayload(value) || value;
+		return path.split(".").reduce((current, segment) => {
+			if (current && typeof current === "object") {
+				const arrayMatch = segment.match(/^(\d+)$/);
+				if (arrayMatch && Array.isArray(current)) return current[Number(arrayMatch[1])];
+				return current[segment];
+			}
+		}, obj);
+	}
+	/**
+	* Resolve expression templates like "${stepId.fieldPath}".
+	* If the value is not an expression, returns it as-is.
+	*/
+	resolve(template) {
+		const match = template.match(/^\$\{(.+)\}$/);
+		if (!match || !match[1]) return template;
+		const ref = match[1];
+		const dotIndex = ref.indexOf(".");
+		if (dotIndex === -1) return this.store.get(ref);
+		const stepId = ref.slice(0, dotIndex);
+		const fieldPath = ref.slice(dotIndex + 1);
+		return this.getValueAtPath(stepId, fieldPath);
+	}
+};
+var PreflightError = class extends Error {
+	constructor(warnings) {
+		super(`Workflow preflight failed with ${warnings.length} unsatisfied prerequisite(s)`);
+		this.warnings = warnings;
+		this.name = "PreflightError";
+	}
+};
+const globalRunStore = new WorkflowRunStore();
+function extractConfigValue(config, path, fallback) {
+	const segments = path.split(".").filter(Boolean);
+	let current = config;
+	for (const segment of segments) {
+		if (!current || typeof current !== "object") return fallback;
+		current = current[segment];
+	}
+	return current ?? fallback;
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withTimeout(promise, timeoutMs, label) {
+	if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) return promise;
+	return new Promise((resolve, reject) => {
+		const timeoutId = setTimeout(() => reject(/* @__PURE__ */ new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);
+		promise.then((value) => {
+			clearTimeout(timeoutId);
+			resolve(value);
+		}, (error) => {
+			clearTimeout(timeoutId);
+			reject(error);
+		});
+	});
+}
+function parseToolPayload(response) {
+	if (!response || typeof response !== "object") return void 0;
+	const text = response.content?.find((item) => item.type === "text")?.text;
+	if (typeof text !== "string") return void 0;
+	try {
+		const parsed = JSON.parse(text);
+		return parsed && typeof parsed === "object" ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+function responseIndicatesFailure(response) {
+	if (!response || typeof response !== "object") return void 0;
+	if (response.isError) return "Tool returned MCP error response";
+	const payload = parseToolPayload(response);
+	if (payload?.success === false) return typeof payload.error === "string" ? payload.error : "Tool reported success=false";
+}
+function collectSuccessStats(value) {
+	if (Array.isArray(value)) return value.reduce((acc, item) => {
+		const next = collectSuccessStats(item);
+		acc.success += next.success;
+		acc.failure += next.failure;
+		return acc;
+	}, {
+		success: 0,
+		failure: 0
+	});
+	if (!value || typeof value !== "object") return {
+		success: 0,
+		failure: 0
+	};
+	const obj = value;
+	if (Array.isArray(obj["__order"])) return obj["__order"].reduce((acc, key) => {
+		const next = collectSuccessStats(obj[key]);
+		acc.success += next.success;
+		acc.failure += next.failure;
+		return acc;
+	}, {
+		success: 0,
+		failure: 0
+	});
+	const payload = parseToolPayload(value);
+	if (payload?.success === true) return {
+		success: 1,
+		failure: 0
+	};
+	/* istanbul ignore next */
+	if (payload?.success === false) return {
+		success: 0,
+		failure: 1
+	};
+	if ("error" in value) return {
+		success: 0,
+		failure: 1
+	};
+	return {
+		success: 0,
+		failure: 0
+	};
+}
+function resolveInputFrom(mapping, dataBus) {
+	const resolved = {};
+	for (const [targetKey, sourceRef] of Object.entries(mapping)) {
+		const template = sourceRef.startsWith("${") ? sourceRef : `\${${sourceRef}}`;
+		resolved[targetKey] = dataBus.resolve(template);
+	}
+	return resolved;
+}
+/**
+* Recursively resolve expression templates in input values.
+* Handles nested objects and arrays.
+*/
+function resolveInputValues(input, dataBus) {
+	if (!input) return {};
+	const resolved = {};
+	for (const [key, value] of Object.entries(input)) resolved[key] = resolveValue(value, dataBus);
+	return resolved;
+}
+function resolveValue(value, dataBus) {
+	if (typeof value === "string") return dataBus.resolve(value);
+	if (Array.isArray(value)) return value.map((item) => resolveValue(item, dataBus));
+	if (value && typeof value === "object") {
+		const resolved = {};
+		for (const [k, v] of Object.entries(value)) resolved[k] = resolveValue(v, dataBus);
+		return resolved;
+	}
+	return value;
+}
+async function runToolNode(ctx, node, overrides, executionContext) {
+	const fromResolved = node.inputFrom ? resolveInputFrom(node.inputFrom, executionContext.dataBus) : {};
+	const mergedInput = {
+		...node.input ? resolveInputValues(node.input, executionContext.dataBus) : {},
+		...fromResolved,
+		...overrides?.[node.id]
+	};
+	const runAttempt = async () => {
+		const response = await withTimeout(ctx.executeToolWithTracking(node.toolName, mergedInput), node.timeoutMs ?? 0, `Workflow tool node "${node.id}"`);
+		const failure = responseIndicatesFailure(response);
+		if (failure) throw new Error(failure);
+		executionContext.dataBus.set(node.id, response);
+		return response;
+	};
+	const retry = node.retry;
+	if (!retry) return runAttempt();
+	let attempt = 0;
+	let backoffMs = retry.backoffMs;
+	while (attempt < retry.maxAttempts) try {
+		return await runAttempt();
+	} catch (error) {
+		attempt += 1;
+		if (attempt >= retry.maxAttempts) throw error;
+		await sleep(backoffMs);
+		backoffMs = Math.max(0, Math.floor(backoffMs * (retry.multiplier ?? 1)));
+	}
+	throw new Error(`Workflow tool node "${node.id}" exhausted retries`);
+}
+async function runParallelNode(ctx, node, executionContext, options) {
+	const concurrency = Math.max(1, node.maxConcurrency ?? 4);
+	const keyedResults = { __order: [] };
+	let nextIndex = 0;
+	let stopped = false;
+	const worker = async () => {
+		while (true) {
+			if (stopped) return;
+			const currentIndex = nextIndex;
+			nextIndex += 1;
+			if (currentIndex >= node.steps.length) return;
+			const step = node.steps[currentIndex];
+			/* istanbul ignore next */
+			if (!step) return;
+			try {
+				const result = await executeNode(ctx, step, executionContext, options);
+				keyedResults[step.id] = result;
+				keyedResults.__order.push(step.id);
+			} catch (error) {
+				if (node.failFast) {
+					stopped = true;
+					throw error;
+				}
+				keyedResults[step.id] = {
+					success: false,
+					error: error instanceof Error ? error.message : String(error)
+				};
+				keyedResults.__order.push(step.id);
+			}
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(concurrency, node.steps.length) }, () => worker()));
+	return keyedResults;
+}
+/**
+* Get a variable value from workflow context by key path.
+* Supports dot notation for nested access within step results.
+*/
+function getWorkflowVariable(stepResults, keyPath) {
+	if (stepResults.has(keyPath)) return stepResults.get(keyPath);
+	const segments = keyPath.split(".");
+	const stepId = segments[0];
+	const fieldSegments = segments.slice(1);
+	if (!stepId || !stepResults.has(stepId)) return;
+	let current = stepResults.get(stepId);
+	if (current && typeof current === "object") {
+		const payload = parseToolPayload(current);
+		if (payload) current = payload;
+	}
+	for (const segment of fieldSegments) if (current && typeof current === "object") {
+		const arrayMatch = segment.match(/^(\d+)$/);
+		if (arrayMatch && Array.isArray(current)) {
+			current = current[Number(arrayMatch[1])];
+			continue;
+		}
+		current = current[segment];
+	} else return;
+	return current;
+}
+async function evaluatePredicate(node, ctx) {
+	if (node.predicateFn) return await node.predicateFn(ctx);
+	if (node.predicateId === "always_true") return true;
+	if (node.predicateId === "always_false") return false;
+	if (node.predicateId === "any_step_failed") return [...ctx.stepResults.values()].some((value) => collectSuccessStats(value).failure > 0);
+	const successRateMatch = node.predicateId.match(/success_rate_gte_(\d+)/i);
+	if (successRateMatch) {
+		const threshold = Number(successRateMatch[1]);
+		const aggregate = [...ctx.stepResults.values()].reduce((acc, value) => {
+			const next = collectSuccessStats(value);
+			acc.success += next.success;
+			acc.failure += next.failure;
+			return acc;
+		}, {
+			success: 0,
+			failure: 0
+		});
+		const total = aggregate.success + aggregate.failure;
+		if (total === 0) return false;
+		return aggregate.success / total >= threshold / 100;
+	}
+	const equalsMatch = node.predicateId.match(/^variable_equals_(.+?)_(.+)$/);
+	if (equalsMatch && equalsMatch[1] && equalsMatch[2]) {
+		const keyPath = equalsMatch[1];
+		const expectedValue = equalsMatch[2];
+		return deepEquals(getWorkflowVariable(ctx.stepResults, keyPath), expectedValue);
+	}
+	const containsMatch = node.predicateId.match(/^variable_contains_(.+?)_(.+)$/);
+	if (containsMatch && containsMatch[1] && containsMatch[2]) {
+		const keyPath = containsMatch[1];
+		const substring = containsMatch[2];
+		const value = getWorkflowVariable(ctx.stepResults, keyPath);
+		if (typeof value !== "string" && !Array.isArray(value)) return false;
+		return String(value).includes(substring);
+	}
+	const matchesMatch = node.predicateId.match(/^variable_matches_(.+?)_(.+)$/);
+	if (matchesMatch && matchesMatch[1] && matchesMatch[2]) {
+		const keyPath = matchesMatch[1];
+		const pattern = matchesMatch[2];
+		const value = getWorkflowVariable(ctx.stepResults, keyPath);
+		if (typeof value !== "string") return false;
+		try {
+			return new RegExp(pattern).test(value);
+		} catch {
+			return false;
+		}
+	}
+	throw new Error(`Unknown workflow predicateId "${node.predicateId}"`);
+}
+/**
+* Deep equality check for two values.
+*/
+function deepEquals(a, b) {
+	if (a === b) return true;
+	if (typeof a !== typeof b) return false;
+	if (a && b && typeof a === "object" && typeof b === "object") {
+		if (Array.isArray(a) !== Array.isArray(b)) return false;
+		if (Array.isArray(a)) {
+			const arrA = a;
+			const arrB = b;
+			return arrA.length === arrB.length && arrA.every((v, i) => deepEquals(v, arrB[i]));
+		}
+		const keysA = Object.keys(a);
+		const keysB = Object.keys(b);
+		if (keysA.length !== keysB.length) return false;
+		return keysA.every((key) => deepEquals(a[key], b[key]));
+	}
+	return false;
+}
+async function executeNode(ctx, node, executionContext, options) {
+	executionContext.emitSpan("workflow.node.start", {
+		nodeId: node.id,
+		kind: node.kind
+	});
+	let result;
+	switch (node.kind) {
+		case "tool":
+			result = await runToolNode(ctx, node, options.nodeInputOverrides, executionContext);
+			break;
+		case "sequence": {
+			const sequenceNode = node;
+			const items = [];
+			for (const step of sequenceNode.steps) items.push(await executeNode(ctx, step, executionContext, options));
+			result = items;
+			break;
+		}
+		case "parallel":
+			result = await runParallelNode(ctx, node, executionContext, options);
+			break;
+		case "branch": {
+			const branchNode = node;
+			const selected = await evaluatePredicate(branchNode, executionContext) ? branchNode.whenTrue : branchNode.whenFalse;
+			if (selected) result = await executeNode(ctx, selected, executionContext, options);
+			else result = void 0;
+			break;
+		}
+		case "fallback": {
+			const fallbackNode = node;
+			try {
+				result = await executeNode(ctx, fallbackNode.primary, executionContext, options);
+			} catch (error) {
+				executionContext.emitSpan("workflow.node.fallback", {
+					nodeId: fallbackNode.id,
+					primaryNodeId: fallbackNode.primary.id,
+					fallbackNodeId: fallbackNode.fallback.id,
+					error: error instanceof Error ? error.message : String(error)
+				});
+				result = await executeNode(ctx, fallbackNode.fallback, executionContext, options);
+			}
+			break;
+		}
+		default: throw new Error(`Unsupported workflow node kind: ${node.kind}`);
+	}
+	executionContext.stepResults.set(node.id, result);
+	executionContext.emitSpan("workflow.node.finish", {
+		nodeId: node.id,
+		kind: node.kind
+	});
+	return result;
+}
+/** Recursively collect all ToolNode instances from a workflow graph. */
+function collectToolNodes(node) {
+	switch (node.kind) {
+		case "tool": return [node];
+		case "sequence":
+		case "parallel": return node.steps.flatMap((step) => collectToolNodes(step));
+		case "branch": return [...collectToolNodes(node.whenTrue), ...node.whenFalse ? collectToolNodes(node.whenFalse) : []];
+		case "fallback": {
+			const fallbackNode = node;
+			return [...collectToolNodes(fallbackNode.primary), ...collectToolNodes(fallbackNode.fallback)];
+		}
+		default: return [];
+	}
+}
+/**
+* Collect unsatisfied prerequisites for all tool nodes in the workflow graph.
+* Returns an array of warnings (not errors — preflight is warn-only mode).
+*/
+function getEvidenceState(ctx) {
+	try {
+		const evidenceGraph = ctx.getDomainInstance("evidenceGraph");
+		return evidenceGraph ? {
+			hasGraph: true,
+			nodeCount: evidenceGraph.nodeCount,
+			edgeCount: evidenceGraph.edgeCount
+		} : {
+			hasGraph: false,
+			nodeCount: 0,
+			edgeCount: 0
+		};
+	} catch {
+		return {
+			hasGraph: false,
+			nodeCount: 0,
+			edgeCount: 0
+		};
+	}
+}
+function collectUnsatisfiedPrerequisites(graph, routingState) {
+	const prerequisites = getEffectivePrerequisites();
+	const warnings = [];
+	for (const toolNode of collectToolNodes(graph)) {
+		const toolPrerequisites = prerequisites[toolNode.toolName] ?? [];
+		for (const prerequisite of toolPrerequisites) {
+			if (prerequisite.check(routingState)) continue;
+			warnings.push({
+				nodeId: toolNode.id,
+				toolName: toolNode.toolName,
+				condition: prerequisite.condition,
+				fix: prerequisite.fix
+			});
+		}
+	}
+	return warnings;
+}
+async function executeExtensionWorkflow(ctx, workflow, options = {}) {
+	const runId = randomUUID();
+	const profile = options.profile ?? String(ctx.baseTier ?? "workflow");
+	const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+	const startedAtMs = Date.now();
+	const metrics = [];
+	const spans = [];
+	const stepResults = /* @__PURE__ */ new Map();
+	const dataBus = new WorkflowDataBus();
+	const mergedConfig = options.config ? {
+		...ctx.config,
+		...options.config
+	} : ctx.config;
+	const executionContext = {
+		workflowRunId: runId,
+		profile,
+		stepResults,
+		dataBus,
+		invokeTool(toolName, args) {
+			return ctx.executeToolWithTracking(toolName, args);
+		},
+		emitSpan(name, attrs) {
+			spans.push({
+				name,
+				attrs,
+				at: (/* @__PURE__ */ new Date()).toISOString()
+			});
+		},
+		emitMetric(name, value, type, attrs) {
+			metrics.push({
+				name,
+				value,
+				type,
+				attrs,
+				at: (/* @__PURE__ */ new Date()).toISOString()
+			});
+		},
+		getConfig(path, fallback) {
+			return extractConfigValue(mergedConfig, path, fallback);
+		}
+	};
+	try {
+		await workflow.onStart?.(executionContext);
+		const graph = workflow.build(executionContext);
+		const preflightMode = options.preflightMode ?? "warn";
+		let preflightWarnings = [];
+		if (preflightMode === "skip") executionContext.emitSpan("workflow.preflight", {
+			mode: preflightMode,
+			skipped: true,
+			evidenceState: getEvidenceState(ctx),
+			warningCount: 0
+		});
+		else try {
+			const routingState = await getRoutingState(ctx);
+			const evidenceState = getEvidenceState(ctx);
+			preflightWarnings = collectUnsatisfiedPrerequisites(graph, routingState);
+			executionContext.emitSpan("workflow.preflight", {
+				mode: preflightMode,
+				routingState,
+				evidenceState,
+				warningCount: preflightWarnings.length,
+				warnings: preflightWarnings
+			});
+			if (preflightMode === "strict" && preflightWarnings.length > 0) throw new PreflightError(preflightWarnings);
+		} catch (error) {
+			if (error instanceof PreflightError) throw error;
+			executionContext.emitSpan("workflow.preflight", {
+				mode: preflightMode,
+				warningCount: 0,
+				skipped: true,
+				error: error instanceof Error ? error.message : String(error),
+				evidenceState: getEvidenceState(ctx)
+			});
+		}
+		const result = await withTimeout(executeNode(ctx, graph, executionContext, options), options.timeoutMs ?? workflow.timeoutMs ?? 0, `Workflow "${workflow.id}"`);
+		await workflow.onFinish?.(executionContext, result);
+		try {
+			const evidenceGraph = typeof ctx.getDomainInstance === "function" ? ctx.getDomainInstance("evidenceGraph") : void 0;
+			if (evidenceGraph && evidenceGraph.nodeCount > 0) {
+				stepResults.set("__evidenceSnapshot", evidenceGraph.exportJson());
+				executionContext.emitSpan("workflow.evidence.auto-export", {
+					nodeCount: evidenceGraph.nodeCount,
+					edgeCount: evidenceGraph.edgeCount
+				});
+			}
+		} catch (exportError) {
+			executionContext.emitSpan("workflow.evidence.auto-export", {
+				skipped: true,
+				error: exportError instanceof Error ? exportError.message : String(exportError)
+			});
+		}
+		const runResult = {
+			workflowId: workflow.id,
+			displayName: workflow.displayName,
+			runId,
+			profile,
+			startedAt,
+			finishedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			durationMs: Date.now() - startedAtMs,
+			result,
+			stepResults: Object.fromEntries(stepResults.entries()),
+			metrics,
+			spans
+		};
+		globalRunStore.recordSuccess(runResult);
+		return runResult;
+	} catch (error) {
+		const workflowError = error instanceof Error ? error : new Error(String(error));
+		globalRunStore.recordError(workflow.id, runId, startedAt, workflowError);
+		await workflow.onError?.(executionContext, workflowError);
+		throw workflowError;
+	}
+}
+//#endregion
+export { executeExtensionWorkflow as n, WorkflowEngine_exports as t };