@agimon-ai/po-workflow 0.0.0-alpha.30 → 0.0.0-alpha.31

package/dist/{RecoverWorkflowService-Xo-OZAJ4.mjs → RecoverWorkflowService-CYXGatEx.mjs}

@@ -1,9 +1,9 @@
+import { i as substituteShellPlaceholder, n as workflowCommandTemplateVariables, r as escapeShellArg, t as renderWorkflowCommandTemplate } from "./workflowCommandTemplate-r57z3b46.mjs";
 import { createRequire } from "node:module";
 import { BACKGROUND_CONTEXT, createSerialRunner, getOrThrow, nodeHost, pathExists, removePath, writeFileAtomic } from "@agimon-ai/po-core/platform";
 import { z } from "zod";
 import path, { basename, dirname, extname, join, relative, resolve } from "node:path";
 import { dump, load } from "js-yaml";
-import { Liquid } from "liquidjs";
 import { execFileSync, spawn } from "node:child_process";
 import fs, { constants, mkdirSync, rmSync } from "node:fs";
 import { chmod, link, mkdir, open, writeFile } from "node:fs/promises";
@@ -863,65 +863,6 @@ async function workflowShellOutput(runtime, command, options = {}) {
 	return output;
 }
 //#endregion
-//#region src/services/workflowShell/index.ts
-/**
-* Shell-quoting helpers for safely interpolating values into shell command strings.
-*
-* DESIGN PATTERNS:
-* - Pure functions with no side effects
-* - Context-aware escaping driven by the surrounding quote character
-*
-* AVOID:
-* - String.prototype.replace with a value as the replacement string: its replacement
-*   patterns ($&, $1, $$, ...) would corrupt any value containing `$`. Build the result
-*   with slice/concat or a function replacer instead.
-*/
-/**
-* Escape a string for safe use as a single-quoted shell argument.
-*
-* Wraps the value in single quotes and neutralises embedded single quotes via the
-* quote-break-escape-requote pattern (`'\''`).
-*/
-function escapeShellArg(value) {
-	return `'${value.replace(/'/g, "'\\''")}'`;
-}
-/**
-* Escape a value for safe insertion inside a double-quoted shell string (`"..."`).
-*
-* Inside double quotes only `\`, `$`, `` ` `` and `"` retain special meaning, so each is
-* backslash-escaped in a single pass. A function replacer is used so a `$` in the value is
-* never interpreted as a replacement pattern.
-*/
-function escapeForDoubleQuotes(value) {
-	return value.replace(/[\\$`"]/g, (char) => `\\${char}`);
-}
-/**
-* Replace every occurrence of `placeholder` in `template` with `value`, escaping the value
-* for the shell-quoting context of the character immediately preceding the placeholder:
-*
-* - preceded by `"`  -> escape for a double-quoted slot (`\ $ ` ` " `)
-* - preceded by `'`  -> escape embedded single quotes (the template supplies the surrounding quotes)
-* - otherwise (bare) -> wrap the value as a single safe single-quoted token
-*
-* The result is assembled with slice/concat so `value` is never treated as a
-* String.prototype.replace replacement pattern.
-*/
-function substituteShellPlaceholder(template, placeholder, value) {
-	let result = "";
-	let searchFrom = 0;
-	for (;;) {
-		const index = template.indexOf(placeholder, searchFrom);
-		if (index === -1) return result + template.slice(searchFrom);
-		result += template.slice(searchFrom, index) + escapeForPrecedingQuote(value, template[index - 1]);
-		searchFrom = index + placeholder.length;
-	}
-}
-function escapeForPrecedingQuote(value, precedingChar) {
-	if (precedingChar === "\"") return escapeForDoubleQuotes(value);
-	if (precedingChar === "'") return value.replace(/'/g, "'\\''");
-	return escapeShellArg(value);
-}
-//#endregion
 //#region src/services/WorkflowParserService/index.ts
 /**
 * WorkflowParserService
@@ -947,17 +888,6 @@ const CHOICE_SETTING_KEYS = new Set(Object.keys(ChoiceSettingsSchema.shape));
 /** A prompt printed raw would be split and expanded by the shell, so templates must quote it. */
 const UNQUOTED_PROMPT_PATTERN = /\{\{-?\s*(prompt|systemPrompt)\s*-?\}\}/;
 const LEGACY_INTERPOLATION_MARKER = "${{";
-/**
-* Renders command templates. Strict, so a variable a launch does not provide
-* fails the step instead of rendering an empty flag; lenient in `if` and
-* `default`, so optional values such as the system prompt can be tested.
-*/
-const commandTemplates = new Liquid({
-	strictVariables: true,
-	strictFilters: true,
-	lenientIf: true
-});
-commandTemplates.registerFilter("shell", (value) => escapeShellArg(Array.isArray(value) ? value.join(",") : String(value ?? "")));
 /** A declared command's template and host options, whichever form it was written in. */
 function commandTemplateOf(command) {
 	return typeof command === "string" ? {
@@ -1079,6 +1009,22 @@ var WorkflowParserService = class {
 		return parsed;
 	}
 	/**
+	* Read and import-merge a partial workflow definition without concrete schema
+	* validation or extends resolution. This is intentionally for inspection only.
+	*/
+	async parseWorkflowTemplateFile(workflowPath) {
+		const resolved = resolve(this.runtime.cwd, workflowPath);
+		if (!await pathExists(this.runtime.fs, resolved, this.runtime.ioContext)) throw new Error(`Workflow file not found: ${resolved}`);
+		const content = getOrThrow(await this.runtime.fs.readTextFile(resolved, this.runtime.ioContext));
+		const parsed = load(content);
+		if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error(`Workflow template must be a YAML object: ${resolved}`);
+		const workflow = parsed;
+		workflow.jobs ??= {};
+		if (workflow.imports) await this.resolveImports(workflow, resolved);
+		workflow.jobs ??= {};
+		return workflow;
+	}
+	/**
 	* Render a command template into the shell command a step runs.
 	*
 	* Values enter as data and are never rendered again, so `${{ }}` text a
@@ -1086,15 +1032,15 @@ var WorkflowParserService = class {
 	* is. Use the `shell` filter to quote a value as one shell word.
 	*/
 	renderCommandTemplate(template, values) {
-		return commandTemplates.parseAndRenderSync(template, values).trim();
+		return renderWorkflowCommandTemplate(template, values);
 	}
 	/** The top-level values a command template reads. */
 	templateVariables(template) {
-		return commandTemplates.globalVariablesSync(template);
+		return workflowCommandTemplateVariables(template);
 	}
 	/** Whether a template passes the system prompt itself; when not, it is folded into the prompt. */
 	templateUsesSystemPrompt(template) {
-		return commandTemplates.globalVariablesSync(template).includes(SYSTEM_PROMPT_VARIABLE);
+		return workflowCommandTemplateVariables(template).includes(SYSTEM_PROMPT_VARIABLE);
 	}
 	/**
 	* Check what the schema cannot see once imports and templates are merged:
@@ -1112,9 +1058,9 @@ var WorkflowParserService = class {
 			if (run.includes(LEGACY_INTERPOLATION_MARKER)) problems.push(`Command "${name}" uses \${{ }}; command templates are Liquid, use {{ }} instead.`);
 			if (UNQUOTED_PROMPT_PATTERN.test(run)) problems.push(`Command "${name}" prints a prompt unquoted; write {{ prompt | shell }}.`);
 			try {
-				if (!commandTemplates.globalVariablesSync(run).includes(PROMPT_VARIABLE)) problems.push(`Command "${name}" never passes {{ prompt | shell }} to the agent.`);
+				if (!workflowCommandTemplateVariables(run).includes(PROMPT_VARIABLE)) problems.push(`Command "${name}" never passes {{ prompt | shell }} to the agent.`);
 			} catch (error) {
-				problems.push(`Command "${name}" is not a valid Liquid template: ${error.message}`);
+				problems.push(`Command "${name}" is not a valid Liquid template: ${error instanceof Error ? error.message : String(error)}`);
 			}
 		}
 		for (const [name, choice] of Object.entries(choices)) for (const key of Object.keys(choice)) if (!CHOICE_SETTING_KEYS.has(key) && !(key in commands)) problems.push(`Choice "${name}" overrides "${key}", which is not a declared command.`);
@@ -9861,7 +9807,8 @@ var RunWorkflowService = class {
 				const innerCommand = await this.createLaunchScriptCommand(input, workflowPath, workflow);
 				const launchBaseName = input.name || workflow.name || basename(workflowPath);
 				const launchDisplayName = input.name ? launchBaseName : `${launchBaseName}-${this.parser.generateHumanReadableId()}`;
-				const shell = substituteShellPlaceholder(substituteShellPlaceholder(launchCommand, LAUNCH_NAME_PLACEHOLDER, launchDisplayName), LAUNCH_COMMAND_PLACEHOLDER, innerCommand);
+				const namedLaunchCommand = substituteShellPlaceholder(launchCommand, LAUNCH_NAME_PLACEHOLDER, launchDisplayName);
+				const shell = substituteShellPlaceholder(namedLaunchCommand, LAUNCH_COMMAND_PLACEHOLDER, innerCommand);
 				this.logger.info(`${DIM}Delegating via launch-command: ${shell}${RESET}`);
 				delegated = true;
 				const launched = await this.spawnLaunchCommand(shell, {
@@ -10873,9 +10820,10 @@ var RunWorkflowService = class {
 	* adding --skip-launch to prevent infinite recursion.
 	*/
 	buildLaunchCliCommand(input, workflowPath, workflow) {
+		const cliPath = this.resolveCliPath();
 		const parts = [
 			"node",
-			escapeShellArg(this.resolveCliPath()),
+			escapeShellArg(cliPath),
 			"run-workflow",
 			escapeShellArg(workflowPath),
 			"--skip-launch"
@@ -11260,6 +11208,6 @@ var RecoverWorkflowService = class {
 	}
 };
 //#endregion
-export { workflowShellOutput as A, readWorkflowPackageVersion as C, WorkflowParserService as D, diagnoseWorkflows as E, summarizeWorkflow as M, listWorkflows as N, escapeShellArg as O, createWorkflowHost as S, diagnoseWorkflow as T, RunDirectoryService as _, WorkflowRegistryService as a, serveNativeTerminal as b, summarizeWorkflowProgress as c, WORKFLOW_DECISION_STEERING_ENV as d, WORKFLOW_DECISION_STEERING_HOST as f, recordStepDecision as g, readStepDecision as h, CodexQuotaService as i, readWorkflowCatalog as j, createWorkflowRuntime as k, workflowRunPhase as l, gateStepDecision as m, RunWorkflowService as n, readWorkflowProgress as o, formatArtifactWarning as p, createEmbeddedRunWorkflowService as r, readWorkflowProgressFrom as s, RecoverWorkflowService as t, WORKFLOW_DECISION_FILE_ENV as u, NativeTerminalService as v, resolveWorkflowCliPath as w, terminalSocketPath as x, connectNativeTerminal as y };
+export { readWorkflowCatalog as A, readWorkflowPackageVersion as C, WorkflowParserService as D, diagnoseWorkflows as E, listWorkflows as M, createWorkflowRuntime as O, createWorkflowHost as S, diagnoseWorkflow as T, RunDirectoryService as _, WorkflowRegistryService as a, serveNativeTerminal as b, summarizeWorkflowProgress as c, WORKFLOW_DECISION_STEERING_ENV as d, WORKFLOW_DECISION_STEERING_HOST as f, recordStepDecision as g, readStepDecision as h, CodexQuotaService as i, summarizeWorkflow as j, workflowShellOutput as k, workflowRunPhase as l, gateStepDecision as m, RunWorkflowService as n, readWorkflowProgress as o, formatArtifactWarning as p, createEmbeddedRunWorkflowService as r, readWorkflowProgressFrom as s, RecoverWorkflowService as t, WORKFLOW_DECISION_FILE_ENV as u, NativeTerminalService as v, resolveWorkflowCliPath as w, terminalSocketPath as x, connectNativeTerminal as y };
 
-//# sourceMappingURL=RecoverWorkflowService-Xo-OZAJ4.mjs.map
+//# sourceMappingURL=RecoverWorkflowService-CYXGatEx.mjs.map