@xopcai/xopc 0.0.142 → 0.0.144

package/dist/src/agent/workflow/last-run-memory.js

@@ -1,60 +0,0 @@
-//#region src/agent/workflow/last-run-memory.ts
-/**
-* Per-session memory of the most recent workflow script that ran successfully.
-*
-* Purpose: enable `/workflow save <name>` — the user sees a workflow run,
-* likes it, types `/workflow save audit_repo_strict`, and the model-generated
-* script lands in `~/.xopc/workflows/`.
-*
-* Scope decision (KISS):
-* - In-memory only, keyed by sessionKey. Cleared on process restart. OPC is
-*   long-lived per session, so the practical window is "from when the user
-*   ran the workflow until they save it" — minutes, not days. Persisting
-*   across restarts would require either session-store coupling or a separate
-*   sidecar file, both bigger than the value.
-* - Records on EVERY successful workflow tool execution, including runs by
-*   name (so users can re-save a slightly modified built-in too).
-* - Bounded by a small LRU so a runaway never grows the heap.
-*/
-const DEFAULT_MAX_ENTRIES = 64;
-var LastWorkflowMemoryImpl = class {
-	entries = /* @__PURE__ */ new Map();
-	constructor(maxEntries = DEFAULT_MAX_ENTRIES) {
-		this.maxEntries = maxEntries;
-	}
-	record(sessionKey, entry) {
-		if (!sessionKey) return;
-		if (this.entries.has(sessionKey)) this.entries.delete(sessionKey);
-		this.entries.set(sessionKey, entry);
-		while (this.entries.size > this.maxEntries) {
-			const oldestKey = this.entries.keys().next().value;
-			if (oldestKey === void 0) break;
-			this.entries.delete(oldestKey);
-		}
-	}
-	get(sessionKey) {
-		if (!sessionKey) return void 0;
-		return this.entries.get(sessionKey);
-	}
-	clear(sessionKey) {
-		if (sessionKey === void 0) this.entries.clear();
-		else this.entries.delete(sessionKey);
-	}
-	/** Visible for tests; do not consume from production code. */
-	_size() {
-		return this.entries.size;
-	}
-};
-let singleton = null;
-function getLastWorkflowMemory() {
-	if (!singleton) singleton = new LastWorkflowMemoryImpl();
-	return singleton;
-}
-/** Reset the singleton (tests only). */
-function _resetLastWorkflowMemoryForTests() {
-	singleton = null;
-}
-//#endregion
-export { _resetLastWorkflowMemoryForTests, getLastWorkflowMemory };
-
-//# sourceMappingURL=last-run-memory.js.map

package/dist/src/agent/workflow/last-run-memory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"last-run-memory.js","names":[],"sources":["../../../../src/agent/workflow/last-run-memory.ts"],"sourcesContent":["/**\n * Per-session memory of the most recent workflow script that ran successfully.\n *\n * Purpose: enable `/workflow save <name>` — the user sees a workflow run,\n * likes it, types `/workflow save audit_repo_strict`, and the model-generated\n * script lands in `~/.xopc/workflows/`.\n *\n * Scope decision (KISS):\n * - In-memory only, keyed by sessionKey. Cleared on process restart. OPC is\n *   long-lived per session, so the practical window is \"from when the user\n *   ran the workflow until they save it\" — minutes, not days. Persisting\n *   across restarts would require either session-store coupling or a separate\n *   sidecar file, both bigger than the value.\n * - Records on EVERY successful workflow tool execution, including runs by\n *   name (so users can re-save a slightly modified built-in too).\n * - Bounded by a small LRU so a runaway never grows the heap.\n */\n\nconst DEFAULT_MAX_ENTRIES = 64;\n\nexport interface LastWorkflowEntry {\n  /** Raw workflow script as the runtime saw it (post-fence-strip, pre-parse). */\n  script: string;\n  /** meta.name from the script (used to default a save target). */\n  metaName: string;\n  /** Where the script came from on this run — for save-time UX hints. */\n  source: 'name' | 'script';\n  /** ms since epoch when recorded — UI uses this for \"ran 2 min ago\". */\n  recordedAt: number;\n}\n\nclass LastWorkflowMemoryImpl {\n  private readonly entries = new Map<string, LastWorkflowEntry>();\n\n  constructor(private readonly maxEntries: number = DEFAULT_MAX_ENTRIES) {}\n\n  record(sessionKey: string | undefined, entry: LastWorkflowEntry): void {\n    if (!sessionKey) return;\n    // Move-to-end semantics: delete then set so iteration order = LRU.\n    if (this.entries.has(sessionKey)) this.entries.delete(sessionKey);\n    this.entries.set(sessionKey, entry);\n    while (this.entries.size > this.maxEntries) {\n      const oldestKey = this.entries.keys().next().value;\n      if (oldestKey === undefined) break;\n      this.entries.delete(oldestKey);\n    }\n  }\n\n  get(sessionKey: string | undefined): LastWorkflowEntry | undefined {\n    if (!sessionKey) return undefined;\n    return this.entries.get(sessionKey);\n  }\n\n  clear(sessionKey?: string): void {\n    if (sessionKey === undefined) this.entries.clear();\n    else this.entries.delete(sessionKey);\n  }\n\n  /** Visible for tests; do not consume from production code. */\n  _size(): number {\n    return this.entries.size;\n  }\n}\n\nexport type LastWorkflowMemory = LastWorkflowMemoryImpl;\n\nlet singleton: LastWorkflowMemoryImpl | null = null;\n\nexport function getLastWorkflowMemory(): LastWorkflowMemoryImpl {\n  if (!singleton) singleton = new LastWorkflowMemoryImpl();\n  return singleton;\n}\n\n/** Reset the singleton (tests only). */\nexport function _resetLastWorkflowMemoryForTests(): void {\n  singleton = null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAkBA,MAAM,sBAAsB;AAa5B,IAAM,yBAAN,MAA6B;CAC3B,0BAA2B,IAAI,KAAgC;CAE/D,YAAY,aAAsC,qBAAqB;AAA1C,OAAA,aAAA;;CAE7B,OAAO,YAAgC,OAAgC;AACrE,MAAI,CAAC,WAAY;AAEjB,MAAI,KAAK,QAAQ,IAAI,WAAW,CAAE,MAAK,QAAQ,OAAO,WAAW;AACjE,OAAK,QAAQ,IAAI,YAAY,MAAM;AACnC,SAAO,KAAK,QAAQ,OAAO,KAAK,YAAY;GAC1C,MAAM,YAAY,KAAK,QAAQ,MAAM,CAAC,MAAM,CAAC;AAC7C,OAAI,cAAc,KAAA,EAAW;AAC7B,QAAK,QAAQ,OAAO,UAAU;;;CAIlC,IAAI,YAA+D;AACjE,MAAI,CAAC,WAAY,QAAO,KAAA;AACxB,SAAO,KAAK,QAAQ,IAAI,WAAW;;CAGrC,MAAM,YAA2B;AAC/B,MAAI,eAAe,KAAA,EAAW,MAAK,QAAQ,OAAO;MAC7C,MAAK,QAAQ,OAAO,WAAW;;;CAItC,QAAgB;AACd,SAAO,KAAK,QAAQ;;;AAMxB,IAAI,YAA2C;AAE/C,SAAgB,wBAAgD;AAC9D,KAAI,CAAC,UAAW,aAAY,IAAI,wBAAwB;AACxD,QAAO;;;AAIT,SAAgB,mCAAyC;AACvD,aAAY"}

package/dist/src/agent/workflow/lint.d.ts

@@ -1,38 +0,0 @@
-/**
- * Static lint for workflow scripts.
- *
- * Catches the single most common AI-authoring bug: calling `agent()`,
- * `parallel()`, or `pipeline()` without `await` and then using the returned
- * Promise as if it were a value. The runtime would throw a cryptic TypeError
- * like `results.map is not a function`; this lint converts it into an
- * actionable error before the script ever runs.
- *
- * Rules (per matching CallExpression):
- *   Allowed parents
- *     - AwaitExpression argument                  `await parallel(...)`
- *     - ReturnStatement argument                  `return agent(...)` (auto-unwraps)
- *     - ExpressionStatement                       fire-and-forget; pending agents drain
- *     - ArrowFunctionExpression expression body   `() => agent(...)` (thunk for parallel/pipeline)
- *   Anything else (VariableDeclarator init, MemberExpression object, template
- *   interpolation, binary/logical operand, call argument, property/array
- *   element, ...) is rejected with a teaching message.
- *
- * Out of scope (handled by the runtime):
- *   - `parallel([agent(...), agent(...)])` (promises instead of thunks) — caught
- *     by the runtime's TypeError ("expects an array of functions, not promises").
- *   - Promise-as-value bugs that survive lint (dynamic indirection, late await).
- */
-import type { Node } from 'acorn';
-type AnyNode = Node & {
-    [key: string]: any;
-    start: number;
-    end: number;
-    loc?: {
-        start: {
-            line: number;
-            column: number;
-        };
-    };
-};
-export declare function lintAwaits(ast: AnyNode): void;
-export {};

package/dist/src/agent/workflow/lint.js

@@ -1,74 +0,0 @@
-//#region src/agent/workflow/lint.ts
-const LINT_TARGETS = new Set([
-	"agent",
-	"parallel",
-	"pipeline"
-]);
-function lintAwaits(ast) {
-	walk(ast, null, (node, parent) => {
-		if (!isLintTarget(node)) return;
-		if (isAcceptableParent(parent, node)) return;
-		const calleeName = node.callee.name;
-		const line = node.loc?.start.line ?? "?";
-		throw new Error(formatError(calleeName, line, parent));
-	});
-}
-function isLintTarget(node) {
-	if (node.type !== "CallExpression") return false;
-	const callee = node.callee;
-	if (!callee || callee.type !== "Identifier") return false;
-	return LINT_TARGETS.has(callee.name);
-}
-function isAcceptableParent(parent, call) {
-	if (!parent) return false;
-	switch (parent.type) {
-		case "AwaitExpression": return parent.argument === call;
-		case "ReturnStatement": return parent.argument === call;
-		case "ExpressionStatement": return parent.expression === call;
-		case "ArrowFunctionExpression": return parent.expression === true && parent.body === call;
-		default: return false;
-	}
-}
-function formatError(name, line, parent) {
-	const ctx = parentContextHint(parent);
-	return [
-		`workflow lint error at line ${line}: \`${name}(...)\` returns a Promise but is used without 'await'${ctx ? ` (${ctx})` : ""}.`,
-		`  ❌ const x = ${name}(...); x.map(...)`,
-		`  ✅ const x = await ${name}(...); x.map(...)`,
-		`Workflow scripts run in an async IIFE — 'await' parallel()/pipeline()/agent() before using their results, or 'return' them directly.`
-	].join("\n");
-}
-function parentContextHint(parent) {
-	if (!parent) return "";
-	switch (parent.type) {
-		case "VariableDeclarator": return "assigned to variable";
-		case "AssignmentExpression": return "assigned via =";
-		case "MemberExpression": return "method/property access on Promise";
-		case "TemplateLiteral": return "interpolated in template string";
-		case "BinaryExpression":
-		case "LogicalExpression": return "used in expression";
-		case "ConditionalExpression": return "used as ternary operand";
-		case "CallExpression": return "passed as argument";
-		case "Property": return "used as object property value";
-		case "ArrayExpression": return "placed in array (use a thunk: () => call)";
-		case "SpreadElement": return "spread";
-		case "IfStatement":
-		case "WhileStatement":
-		case "DoWhileStatement":
-		case "ForStatement": return "used as condition";
-		default: return parent.type;
-	}
-}
-function walk(node, parent, visit) {
-	visit(node, parent);
-	for (const value of Object.values(node)) if (Array.isArray(value)) {
-		for (const v of value) if (isAstNode(v)) walk(v, node, visit);
-	} else if (isAstNode(value)) walk(value, node, visit);
-}
-function isAstNode(value) {
-	return !!value && typeof value === "object" && typeof value.type === "string";
-}
-//#endregion
-export { lintAwaits };
-
-//# sourceMappingURL=lint.js.map

package/dist/src/agent/workflow/lint.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lint.js","names":[],"sources":["../../../../src/agent/workflow/lint.ts"],"sourcesContent":["/**\n * Static lint for workflow scripts.\n *\n * Catches the single most common AI-authoring bug: calling `agent()`,\n * `parallel()`, or `pipeline()` without `await` and then using the returned\n * Promise as if it were a value. The runtime would throw a cryptic TypeError\n * like `results.map is not a function`; this lint converts it into an\n * actionable error before the script ever runs.\n *\n * Rules (per matching CallExpression):\n *   Allowed parents\n *     - AwaitExpression argument                  `await parallel(...)`\n *     - ReturnStatement argument                  `return agent(...)` (auto-unwraps)\n *     - ExpressionStatement                       fire-and-forget; pending agents drain\n *     - ArrowFunctionExpression expression body   `() => agent(...)` (thunk for parallel/pipeline)\n *   Anything else (VariableDeclarator init, MemberExpression object, template\n *   interpolation, binary/logical operand, call argument, property/array\n *   element, ...) is rejected with a teaching message.\n *\n * Out of scope (handled by the runtime):\n *   - `parallel([agent(...), agent(...)])` (promises instead of thunks) — caught\n *     by the runtime's TypeError (\"expects an array of functions, not promises\").\n *   - Promise-as-value bugs that survive lint (dynamic indirection, late await).\n */\n\nimport type { Node } from 'acorn';\n\ntype AnyNode = Node & {\n  [key: string]: any;\n  start: number;\n  end: number;\n  loc?: { start: { line: number; column: number } };\n};\n\nconst LINT_TARGETS = new Set(['agent', 'parallel', 'pipeline']);\n\nexport function lintAwaits(ast: AnyNode): void {\n  walk(ast, null, (node, parent) => {\n    if (!isLintTarget(node)) return;\n    if (isAcceptableParent(parent, node)) return;\n    const calleeName = (node.callee as AnyNode).name as string;\n    const line = node.loc?.start.line ?? '?';\n    throw new Error(formatError(calleeName, line, parent));\n  });\n}\n\nfunction isLintTarget(node: AnyNode): boolean {\n  if (node.type !== 'CallExpression') return false;\n  const callee = node.callee as AnyNode | undefined;\n  if (!callee || callee.type !== 'Identifier') return false;\n  return LINT_TARGETS.has(callee.name);\n}\n\nfunction isAcceptableParent(parent: AnyNode | null, call: AnyNode): boolean {\n  if (!parent) return false;\n  switch (parent.type) {\n    case 'AwaitExpression':\n      return parent.argument === call;\n    case 'ReturnStatement':\n      return parent.argument === call;\n    case 'ExpressionStatement':\n      return parent.expression === call;\n    case 'ArrowFunctionExpression':\n      // `() => agent(...)` — thunk-style body that the runtime invokes/awaits.\n      return parent.expression === true && parent.body === call;\n    default:\n      return false;\n  }\n}\n\nfunction formatError(name: string, line: number | string, parent: AnyNode | null): string {\n  const ctx = parentContextHint(parent);\n  return [\n    `workflow lint error at line ${line}: \\`${name}(...)\\` returns a Promise but is used without 'await'${ctx ? ` (${ctx})` : ''}.`,\n    `  ❌ const x = ${name}(...); x.map(...)`,\n    `  ✅ const x = await ${name}(...); x.map(...)`,\n    `Workflow scripts run in an async IIFE — 'await' parallel()/pipeline()/agent() before using their results, or 'return' them directly.`,\n  ].join('\\n');\n}\n\nfunction parentContextHint(parent: AnyNode | null): string {\n  if (!parent) return '';\n  switch (parent.type) {\n    case 'VariableDeclarator':\n      return 'assigned to variable';\n    case 'AssignmentExpression':\n      return 'assigned via =';\n    case 'MemberExpression':\n      return 'method/property access on Promise';\n    case 'TemplateLiteral':\n      return 'interpolated in template string';\n    case 'BinaryExpression':\n    case 'LogicalExpression':\n      return 'used in expression';\n    case 'ConditionalExpression':\n      return 'used as ternary operand';\n    case 'CallExpression':\n      return 'passed as argument';\n    case 'Property':\n      return 'used as object property value';\n    case 'ArrayExpression':\n      return 'placed in array (use a thunk: () => ' + 'call)';\n    case 'SpreadElement':\n      return 'spread';\n    case 'IfStatement':\n    case 'WhileStatement':\n    case 'DoWhileStatement':\n    case 'ForStatement':\n      return 'used as condition';\n    default:\n      return parent.type;\n  }\n}\n\nfunction walk(\n  node: AnyNode,\n  parent: AnyNode | null,\n  visit: (n: AnyNode, p: AnyNode | null) => void,\n): void {\n  visit(node, parent);\n  for (const value of Object.values(node)) {\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (isAstNode(v)) walk(v, node, visit);\n      }\n    } else if (isAstNode(value)) {\n      walk(value, node, visit);\n    }\n  }\n}\n\nfunction isAstNode(value: unknown): value is AnyNode {\n  return !!value && typeof value === 'object' && typeof (value as AnyNode).type === 'string';\n}\n"],"mappings":";AAkCA,MAAM,eAAe,IAAI,IAAI;CAAC;CAAS;CAAY;CAAW,CAAC;AAE/D,SAAgB,WAAW,KAAoB;AAC7C,MAAK,KAAK,OAAO,MAAM,WAAW;AAChC,MAAI,CAAC,aAAa,KAAK,CAAE;AACzB,MAAI,mBAAmB,QAAQ,KAAK,CAAE;EACtC,MAAM,aAAc,KAAK,OAAmB;EAC5C,MAAM,OAAO,KAAK,KAAK,MAAM,QAAQ;AACrC,QAAM,IAAI,MAAM,YAAY,YAAY,MAAM,OAAO,CAAC;GACtD;;AAGJ,SAAS,aAAa,MAAwB;AAC5C,KAAI,KAAK,SAAS,iBAAkB,QAAO;CAC3C,MAAM,SAAS,KAAK;AACpB,KAAI,CAAC,UAAU,OAAO,SAAS,aAAc,QAAO;AACpD,QAAO,aAAa,IAAI,OAAO,KAAK;;AAGtC,SAAS,mBAAmB,QAAwB,MAAwB;AAC1E,KAAI,CAAC,OAAQ,QAAO;AACpB,SAAQ,OAAO,MAAf;EACE,KAAK,kBACH,QAAO,OAAO,aAAa;EAC7B,KAAK,kBACH,QAAO,OAAO,aAAa;EAC7B,KAAK,sBACH,QAAO,OAAO,eAAe;EAC/B,KAAK,0BAEH,QAAO,OAAO,eAAe,QAAQ,OAAO,SAAS;EACvD,QACE,QAAO;;;AAIb,SAAS,YAAY,MAAc,MAAuB,QAAgC;CACxF,MAAM,MAAM,kBAAkB,OAAO;AACrC,QAAO;EACL,+BAA+B,KAAK,MAAM,KAAK,uDAAuD,MAAM,KAAK,IAAI,KAAK,GAAG;EAC7H,iBAAiB,KAAK;EACtB,uBAAuB,KAAK;EAC5B;EACD,CAAC,KAAK,KAAK;;AAGd,SAAS,kBAAkB,QAAgC;AACzD,KAAI,CAAC,OAAQ,QAAO;AACpB,SAAQ,OAAO,MAAf;EACE,KAAK,qBACH,QAAO;EACT,KAAK,uBACH,QAAO;EACT,KAAK,mBACH,QAAO;EACT,KAAK,kBACH,QAAO;EACT,KAAK;EACL,KAAK,oBACH,QAAO;EACT,KAAK,wBACH,QAAO;EACT,KAAK,iBACH,QAAO;EACT,KAAK,WACH,QAAO;EACT,KAAK,kBACH,QAAO;EACT,KAAK,gBACH,QAAO;EACT,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,eACH,QAAO;EACT,QACE,QAAO,OAAO;;;AAIpB,SAAS,KACP,MACA,QACA,OACM;AACN,OAAM,MAAM,OAAO;AACnB,MAAK,MAAM,SAAS,OAAO,OAAO,KAAK,CACrC,KAAI,MAAM,QAAQ,MAAM;OACjB,MAAM,KAAK,MACd,KAAI,UAAU,EAAE,CAAE,MAAK,GAAG,MAAM,MAAM;YAE/B,UAAU,MAAM,CACzB,MAAK,OAAO,MAAM,MAAM;;AAK9B,SAAS,UAAU,OAAkC;AACnD,QAAO,CAAC,CAAC,SAAS,OAAO,UAAU,YAAY,OAAQ,MAAkB,SAAS"}

package/dist/src/agent/workflow/meta-locale.d.ts

@@ -1,12 +0,0 @@
-import type { WorkflowMeta, WorkflowMetaExamplePrompt, WorkflowMetaLocale } from './types.js';
-export type WorkflowLocaleCode = 'en' | 'zh';
-export declare function normalizeWorkflowLocale(language: string | undefined): WorkflowLocaleCode;
-export interface WorkflowLocalizedCopy {
-    description: string;
-    whenToUse?: string;
-    examplePrompts: WorkflowMetaExamplePrompt[];
-}
-export declare function resolveWorkflowLocalizedCopy(meta: Pick<WorkflowMeta, 'description' | 'whenToUse' | 'examplePrompts' | 'i18n'>, locale: WorkflowLocaleCode): WorkflowLocalizedCopy;
-export declare function validateExamplePrompts(value: unknown, path: string): WorkflowMetaExamplePrompt[] | undefined;
-export declare function validateMetaLocale(value: unknown, path: string): WorkflowMetaLocale;
-export declare function validateMetaI18n(value: unknown): Record<string, WorkflowMetaLocale> | undefined;

package/dist/src/agent/workflow/meta-locale.js

@@ -1,62 +0,0 @@
-//#region src/agent/workflow/meta-locale.ts
-function normalizeWorkflowLocale(language) {
-	return language === "zh" ? "zh" : "en";
-}
-function resolveWorkflowLocalizedCopy(meta, locale) {
-	const bundle = locale !== "en" ? meta.i18n?.[locale] : void 0;
-	const examplePrompts = bundle?.examplePrompts && bundle.examplePrompts.length > 0 ? bundle.examplePrompts : meta.examplePrompts ?? [];
-	return {
-		description: pickNonEmpty(bundle?.description, meta.description),
-		whenToUse: pickOptional(bundle?.whenToUse, meta.whenToUse),
-		examplePrompts
-	};
-}
-function pickNonEmpty(localized, fallback) {
-	const trimmed = localized?.trim();
-	return trimmed ? trimmed : fallback;
-}
-function pickOptional(localized, fallback) {
-	const trimmed = localized?.trim();
-	if (trimmed) return trimmed;
-	return fallback?.trim() || void 0;
-}
-function validateExamplePrompts(value, path) {
-	if (value === void 0) return void 0;
-	if (!Array.isArray(value)) throw new Error(`${path} must be an array`);
-	const prompts = [];
-	for (let index = 0; index < value.length; index++) {
-		const item = value[index];
-		if (!item || typeof item !== "object") throw new Error(`${path}[${index}] must be an object`);
-		const field = item.field;
-		const text = item.text;
-		if (typeof field !== "string" || !field.trim()) throw new Error(`${path}[${index}].field must be a non-empty string`);
-		if (typeof text !== "string" || !text.trim()) throw new Error(`${path}[${index}].text must be a non-empty string`);
-		prompts.push({
-			field: field.trim(),
-			text: text.trim()
-		});
-	}
-	return prompts;
-}
-function validateMetaLocale(value, path) {
-	if (!value || typeof value !== "object") throw new Error(`${path} must be an object`);
-	const record = value;
-	if (record.description !== void 0 && (typeof record.description !== "string" || !record.description.trim())) throw new Error(`${path}.description must be a non-empty string`);
-	if (record.whenToUse !== void 0 && typeof record.whenToUse !== "string") throw new Error(`${path}.whenToUse must be a string`);
-	validateExamplePrompts(record.examplePrompts, `${path}.examplePrompts`);
-	return record;
-}
-function validateMetaI18n(value) {
-	if (value === void 0) return void 0;
-	if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("meta.i18n must be an object");
-	const locales = {};
-	for (const [locale, bundle] of Object.entries(value)) {
-		if (!/^[a-z]{2}(-[A-Za-z]{2})?$/.test(locale)) throw new Error(`meta.i18n key "${locale}" must be a language tag like "zh" or "en"`);
-		locales[locale] = validateMetaLocale(bundle, `meta.i18n.${locale}`);
-	}
-	return locales;
-}
-//#endregion
-export { normalizeWorkflowLocale, resolveWorkflowLocalizedCopy, validateExamplePrompts, validateMetaI18n, validateMetaLocale };
-
-//# sourceMappingURL=meta-locale.js.map

package/dist/src/agent/workflow/meta-locale.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"meta-locale.js","names":[],"sources":["../../../../src/agent/workflow/meta-locale.ts"],"sourcesContent":["import type { WorkflowMeta, WorkflowMetaExamplePrompt, WorkflowMetaLocale } from './types.js';\n\nexport type WorkflowLocaleCode = 'en' | 'zh';\n\nexport function normalizeWorkflowLocale(language: string | undefined): WorkflowLocaleCode {\n  return language === 'zh' ? 'zh' : 'en';\n}\n\nexport interface WorkflowLocalizedCopy {\n  description: string;\n  whenToUse?: string;\n  examplePrompts: WorkflowMetaExamplePrompt[];\n}\n\nexport function resolveWorkflowLocalizedCopy(\n  meta: Pick<WorkflowMeta, 'description' | 'whenToUse' | 'examplePrompts' | 'i18n'>,\n  locale: WorkflowLocaleCode,\n): WorkflowLocalizedCopy {\n  const bundle = locale !== 'en' ? meta.i18n?.[locale] : undefined;\n  const examplePrompts =\n    bundle?.examplePrompts && bundle.examplePrompts.length > 0\n      ? bundle.examplePrompts\n      : (meta.examplePrompts ?? []);\n  return {\n    description: pickNonEmpty(bundle?.description, meta.description),\n    whenToUse: pickOptional(bundle?.whenToUse, meta.whenToUse),\n    examplePrompts,\n  };\n}\n\nfunction pickNonEmpty(localized: string | undefined, fallback: string): string {\n  const trimmed = localized?.trim();\n  return trimmed ? trimmed : fallback;\n}\n\nfunction pickOptional(localized: string | undefined, fallback: string | undefined): string | undefined {\n  const trimmed = localized?.trim();\n  if (trimmed) return trimmed;\n  const fb = fallback?.trim();\n  return fb || undefined;\n}\n\nexport function validateExamplePrompts(value: unknown, path: string): WorkflowMetaExamplePrompt[] | undefined {\n  if (value === undefined) return undefined;\n  if (!Array.isArray(value)) {\n    throw new Error(`${path} must be an array`);\n  }\n  const prompts: WorkflowMetaExamplePrompt[] = [];\n  for (let index = 0; index < value.length; index++) {\n    const item = value[index];\n    if (!item || typeof item !== 'object') {\n      throw new Error(`${path}[${index}] must be an object`);\n    }\n    const field = (item as WorkflowMetaExamplePrompt).field;\n    const text = (item as WorkflowMetaExamplePrompt).text;\n    if (typeof field !== 'string' || !field.trim()) {\n      throw new Error(`${path}[${index}].field must be a non-empty string`);\n    }\n    if (typeof text !== 'string' || !text.trim()) {\n      throw new Error(`${path}[${index}].text must be a non-empty string`);\n    }\n    prompts.push({ field: field.trim(), text: text.trim() });\n  }\n  return prompts;\n}\n\nexport function validateMetaLocale(value: unknown, path: string): WorkflowMetaLocale {\n  if (!value || typeof value !== 'object') {\n    throw new Error(`${path} must be an object`);\n  }\n  const record = value as WorkflowMetaLocale;\n  if (record.description !== undefined && (typeof record.description !== 'string' || !record.description.trim())) {\n    throw new Error(`${path}.description must be a non-empty string`);\n  }\n  if (record.whenToUse !== undefined && typeof record.whenToUse !== 'string') {\n    throw new Error(`${path}.whenToUse must be a string`);\n  }\n  validateExamplePrompts(record.examplePrompts, `${path}.examplePrompts`);\n  return record;\n}\n\nexport function validateMetaI18n(value: unknown): Record<string, WorkflowMetaLocale> | undefined {\n  if (value === undefined) return undefined;\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    throw new Error('meta.i18n must be an object');\n  }\n  const locales: Record<string, WorkflowMetaLocale> = {};\n  for (const [locale, bundle] of Object.entries(value as Record<string, unknown>)) {\n    if (!/^[a-z]{2}(-[A-Za-z]{2})?$/.test(locale)) {\n      throw new Error(`meta.i18n key \"${locale}\" must be a language tag like \"zh\" or \"en\"`);\n    }\n    locales[locale] = validateMetaLocale(bundle, `meta.i18n.${locale}`);\n  }\n  return locales;\n}\n"],"mappings":";AAIA,SAAgB,wBAAwB,UAAkD;AACxF,QAAO,aAAa,OAAO,OAAO;;AASpC,SAAgB,6BACd,MACA,QACuB;CACvB,MAAM,SAAS,WAAW,OAAO,KAAK,OAAO,UAAU,KAAA;CACvD,MAAM,iBACJ,QAAQ,kBAAkB,OAAO,eAAe,SAAS,IACrD,OAAO,iBACN,KAAK,kBAAkB,EAAE;AAChC,QAAO;EACL,aAAa,aAAa,QAAQ,aAAa,KAAK,YAAY;EAChE,WAAW,aAAa,QAAQ,WAAW,KAAK,UAAU;EAC1D;EACD;;AAGH,SAAS,aAAa,WAA+B,UAA0B;CAC7E,MAAM,UAAU,WAAW,MAAM;AACjC,QAAO,UAAU,UAAU;;AAG7B,SAAS,aAAa,WAA+B,UAAkD;CACrG,MAAM,UAAU,WAAW,MAAM;AACjC,KAAI,QAAS,QAAO;AAEpB,QADW,UAAU,MAAM,IACd,KAAA;;AAGf,SAAgB,uBAAuB,OAAgB,MAAuD;AAC5G,KAAI,UAAU,KAAA,EAAW,QAAO,KAAA;AAChC,KAAI,CAAC,MAAM,QAAQ,MAAM,CACvB,OAAM,IAAI,MAAM,GAAG,KAAK,mBAAmB;CAE7C,MAAM,UAAuC,EAAE;AAC/C,MAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS;EACjD,MAAM,OAAO,MAAM;AACnB,MAAI,CAAC,QAAQ,OAAO,SAAS,SAC3B,OAAM,IAAI,MAAM,GAAG,KAAK,GAAG,MAAM,qBAAqB;EAExD,MAAM,QAAS,KAAmC;EAClD,MAAM,OAAQ,KAAmC;AACjD,MAAI,OAAO,UAAU,YAAY,CAAC,MAAM,MAAM,CAC5C,OAAM,IAAI,MAAM,GAAG,KAAK,GAAG,MAAM,oCAAoC;AAEvE,MAAI,OAAO,SAAS,YAAY,CAAC,KAAK,MAAM,CAC1C,OAAM,IAAI,MAAM,GAAG,KAAK,GAAG,MAAM,mCAAmC;AAEtE,UAAQ,KAAK;GAAE,OAAO,MAAM,MAAM;GAAE,MAAM,KAAK,MAAM;GAAE,CAAC;;AAE1D,QAAO;;AAGT,SAAgB,mBAAmB,OAAgB,MAAkC;AACnF,KAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,OAAM,IAAI,MAAM,GAAG,KAAK,oBAAoB;CAE9C,MAAM,SAAS;AACf,KAAI,OAAO,gBAAgB,KAAA,MAAc,OAAO,OAAO,gBAAgB,YAAY,CAAC,OAAO,YAAY,MAAM,EAC3G,OAAM,IAAI,MAAM,GAAG,KAAK,yCAAyC;AAEnE,KAAI,OAAO,cAAc,KAAA,KAAa,OAAO,OAAO,cAAc,SAChE,OAAM,IAAI,MAAM,GAAG,KAAK,6BAA6B;AAEvD,wBAAuB,OAAO,gBAAgB,GAAG,KAAK,iBAAiB;AACvE,QAAO;;AAGT,SAAgB,iBAAiB,OAAgE;AAC/F,KAAI,UAAU,KAAA,EAAW,QAAO,KAAA;AAChC,KAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,OAAM,IAAI,MAAM,8BAA8B;CAEhD,MAAM,UAA8C,EAAE;AACtD,MAAK,MAAM,CAAC,QAAQ,WAAW,OAAO,QAAQ,MAAiC,EAAE;AAC/E,MAAI,CAAC,4BAA4B,KAAK,OAAO,CAC3C,OAAM,IAAI,MAAM,kBAAkB,OAAO,4CAA4C;AAEvF,UAAQ,UAAU,mBAAmB,QAAQ,aAAa,SAAS;;AAErE,QAAO"}

package/dist/src/agent/workflow/parser.d.ts

@@ -1,20 +0,0 @@
-/**
- * Workflow script parser.
- *
- * Responsibilities:
- *   1. Parse the script with acorn (latest ECMA, top-level await + return allowed).
- *   2. Enforce determinism — reject `Date.now()`, `Math.random()`, `new Date()`,
- *      `require`, `import`, dynamic eval. This keeps future resume/replay possible
- *      and surfaces non-deterministic mistakes early.
- *   3. Require the first statement to be `export const meta = <literal>`, validate
- *      the literal shape, and strip that line from the body returned to the runtime.
- *
- * Returning a `{ meta, body }` pair means the runtime can `vm.Script(body)` without
- * any further AST work.
- */
-import type { WorkflowMeta } from './types.js';
-export interface ParsedWorkflow {
-    meta: WorkflowMeta;
-    body: string;
-}
-export declare function parseWorkflowScript(script: string): ParsedWorkflow;

package/dist/src/agent/workflow/parser.js

@@ -1,152 +0,0 @@
-import { lintAwaits } from "./lint.js";
-import { validateExamplePrompts, validateMetaI18n } from "./meta-locale.js";
-import { parse } from "acorn";
-//#region src/agent/workflow/parser.ts
-/**
-* Workflow script parser.
-*
-* Responsibilities:
-*   1. Parse the script with acorn (latest ECMA, top-level await + return allowed).
-*   2. Enforce determinism — reject `Date.now()`, `Math.random()`, `new Date()`,
-*      `require`, `import`, dynamic eval. This keeps future resume/replay possible
-*      and surfaces non-deterministic mistakes early.
-*   3. Require the first statement to be `export const meta = <literal>`, validate
-*      the literal shape, and strip that line from the body returned to the runtime.
-*
-* Returning a `{ meta, body }` pair means the runtime can `vm.Script(body)` without
-* any further AST work.
-*/
-const NONDETERMINISM_ERROR = "Workflow scripts must be deterministic: Date.now()/Math.random()/new Date() are unavailable. Pass timestamps via args or stamp them after the workflow returns.";
-function parseWorkflowScript(script) {
-	let ast;
-	try {
-		ast = parse(script, {
-			ecmaVersion: "latest",
-			sourceType: "module",
-			allowAwaitOutsideFunction: true,
-			allowReturnOutsideFunction: true,
-			ranges: false,
-			locations: true
-		});
-	} catch (e) {
-		const msg = e instanceof Error ? e.message : String(e);
-		throw new Error(`Workflow script parse error: ${msg}`);
-	}
-	assertDeterministicAst(ast);
-	assertNoDangerousImports(ast);
-	lintAwaits(ast);
-	const first = ast.body?.[0];
-	if (first?.type !== "ExportNamedDeclaration") throw new Error("`export const meta = { name, description }` must be the first statement in the script");
-	const declaration = first.declaration;
-	if (declaration?.type !== "VariableDeclaration" || declaration.kind !== "const") throw new Error("meta export must be `export const meta = ...`");
-	if (declaration.declarations.length !== 1) throw new Error("meta export must declare only `meta`");
-	const declarator = declaration.declarations[0];
-	if (declarator.id?.type !== "Identifier" || declarator.id.name !== "meta") throw new Error("meta export must declare `meta`");
-	if (!declarator.init) throw new Error("meta must have a literal value");
-	const meta = evaluateLiteral(declarator.init, "meta");
-	validateMeta(meta);
-	return {
-		meta,
-		body: script.slice(0, first.start) + script.slice(first.end)
-	};
-}
-function assertDeterministicAst(node) {
-	if (isDateNowCall(node) || isMathRandomCall(node) || isNewDateExpression(node)) throw new Error(NONDETERMINISM_ERROR);
-	for (const child of astChildren(node)) assertDeterministicAst(child);
-}
-function assertNoDangerousImports(node) {
-	if (node.type === "ImportDeclaration" || node.type === "ImportExpression") throw new Error("Workflow scripts cannot use `import` — only the exposed globals (agent, parallel, pipeline, phase, log, args, cwd, budget) are available.");
-	if (node.type === "CallExpression") {
-		const callee = node.callee;
-		if (callee?.type === "Identifier" && (callee.name === "require" || callee.name === "eval")) throw new Error(`Workflow scripts cannot call \`${callee.name}\`.`);
-	}
-	for (const child of astChildren(node)) assertNoDangerousImports(child);
-}
-function astChildren(node) {
-	const children = [];
-	for (const value of Object.values(node)) if (Array.isArray(value)) {
-		for (const v of value) if (isAstNode(v)) children.push(v);
-	} else if (isAstNode(value)) children.push(value);
-	return children;
-}
-function isAstNode(value) {
-	return !!value && typeof value === "object" && typeof value.type === "string";
-}
-function isDateNowCall(node) {
-	return node.type === "CallExpression" && isMemberExpression(node.callee, "Date", "now");
-}
-function isMathRandomCall(node) {
-	return node.type === "CallExpression" && isMemberExpression(node.callee, "Math", "random");
-}
-function isNewDateExpression(node) {
-	return node.type === "NewExpression" && node.callee?.type === "Identifier" && node.callee.name === "Date";
-}
-function isMemberExpression(node, objectName, propertyName) {
-	if (node?.type !== "MemberExpression" || node.object?.type !== "Identifier" || node.object.name !== objectName) return false;
-	const prop = node.property;
-	if (!node.computed && prop?.type === "Identifier") return prop.name === propertyName;
-	if (prop?.type === "Literal" && typeof prop.value === "string") return prop.value === propertyName;
-	return false;
-}
-function evaluateLiteral(node, path) {
-	switch (node.type) {
-		case "ObjectExpression": {
-			const out = {};
-			for (const prop of node.properties) {
-				if (prop.type === "SpreadElement") throw new Error(`spread not allowed in ${path}`);
-				if (prop.type !== "Property") throw new Error(`only plain properties allowed in ${path}`);
-				if (prop.computed) throw new Error(`computed keys not allowed in ${path}`);
-				if (prop.kind !== "init" || prop.method) throw new Error(`methods/accessors not allowed in ${path}`);
-				const key = propertyKey(prop.key, path);
-				if (key === "__proto__" || key === "constructor" || key === "prototype") throw new Error(`reserved key name not allowed in ${path}: ${key}`);
-				out[key] = evaluateLiteral(prop.value, `${path}.${key}`);
-			}
-			return out;
-		}
-		case "ArrayExpression": return node.elements.map((element, index) => {
-			if (!element) throw new Error(`sparse arrays not allowed in ${path}`);
-			if (element.type === "SpreadElement") throw new Error(`spread not allowed in ${path}`);
-			return evaluateLiteral(element, `${path}[${index}]`);
-		});
-		case "Literal": return node.value;
-		case "TemplateLiteral":
-			if (node.expressions.length > 0) throw new Error(`template interpolation not allowed in ${path}`);
-			return node.quasis.map((quasi) => quasi.value.cooked ?? quasi.value.raw).join("");
-		case "UnaryExpression":
-			if (node.operator === "-" && node.argument?.type === "Literal" && typeof node.argument.value === "number") return -node.argument.value;
-			throw new Error(`only negative-number unary allowed in ${path}`);
-		default: throw new Error(`non-literal node type in ${path}: ${node.type}`);
-	}
-}
-function propertyKey(node, path) {
-	if (node.type === "Identifier") return node.name;
-	if (node.type === "Literal" && (typeof node.value === "string" || typeof node.value === "number")) return String(node.value);
-	throw new Error(`unsupported key type in ${path}: ${node.type}`);
-}
-function validateMeta(meta) {
-	if (!meta || typeof meta !== "object") throw new Error("meta must be an object");
-	const value = meta;
-	if (typeof value.name !== "string" || !value.name.trim()) throw new Error("meta.name must be a non-empty string");
-	if (!/^[a-z][a-z0-9_-]*$/.test(value.name)) throw new Error(`meta.name must be lowercase snake_case (got "${value.name}"). Example: "audit_repo".`);
-	if (typeof value.description !== "string" || !value.description.trim()) throw new Error("meta.description must be a non-empty string");
-	if (value.whenToUse !== void 0 && typeof value.whenToUse !== "string") throw new Error("meta.whenToUse must be a string");
-	if (value.phases !== void 0) {
-		if (!Array.isArray(value.phases)) throw new Error("meta.phases must be an array");
-		for (const phase of value.phases) if (!phase || typeof phase !== "object" || typeof phase.title !== "string") throw new Error("each meta phase must have a title string");
-	}
-	if (value.tags !== void 0) {
-		if (!Array.isArray(value.tags) || value.tags.some((tag) => typeof tag !== "string" || !tag.trim())) throw new Error("meta.tags must be an array of non-empty strings");
-	}
-	if (value.estimatedAgents !== void 0) {
-		const est = value.estimatedAgents;
-		if (!est || typeof est !== "object") throw new Error("meta.estimatedAgents must be an object");
-		if (typeof est.min !== "number" || typeof est.max !== "number" || !Number.isFinite(est.min) || !Number.isFinite(est.max)) throw new Error("meta.estimatedAgents.min and .max must be finite numbers");
-		if (est.min < 1 || est.max < est.min) throw new Error("meta.estimatedAgents requires min >= 1 and max >= min");
-	}
-	validateExamplePrompts(value.examplePrompts, "meta.examplePrompts");
-	validateMetaI18n(value.i18n);
-}
-//#endregion
-export { parseWorkflowScript };
-
-//# sourceMappingURL=parser.js.map

package/dist/src/agent/workflow/parser.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parser.js","names":[],"sources":["../../../../src/agent/workflow/parser.ts"],"sourcesContent":["/**\n * Workflow script parser.\n *\n * Responsibilities:\n *   1. Parse the script with acorn (latest ECMA, top-level await + return allowed).\n *   2. Enforce determinism — reject `Date.now()`, `Math.random()`, `new Date()`,\n *      `require`, `import`, dynamic eval. This keeps future resume/replay possible\n *      and surfaces non-deterministic mistakes early.\n *   3. Require the first statement to be `export const meta = <literal>`, validate\n *      the literal shape, and strip that line from the body returned to the runtime.\n *\n * Returning a `{ meta, body }` pair means the runtime can `vm.Script(body)` without\n * any further AST work.\n */\n\nimport { parse } from 'acorn';\nimport type { Node } from 'acorn';\n\nimport { lintAwaits } from './lint.js';\nimport { validateExamplePrompts, validateMetaI18n } from './meta-locale.js';\nimport type { WorkflowMeta, WorkflowMetaPhase } from './types.js';\n\ntype AnyNode = Node & { [key: string]: any; start: number; end: number };\n\nconst NONDETERMINISM_ERROR =\n  'Workflow scripts must be deterministic: Date.now()/Math.random()/new Date() are unavailable. ' +\n  'Pass timestamps via args or stamp them after the workflow returns.';\n\nexport interface ParsedWorkflow {\n  meta: WorkflowMeta;\n  body: string;\n}\n\nexport function parseWorkflowScript(script: string): ParsedWorkflow {\n  let ast: AnyNode;\n  try {\n    ast = parse(script, {\n      ecmaVersion: 'latest',\n      sourceType: 'module',\n      allowAwaitOutsideFunction: true,\n      allowReturnOutsideFunction: true,\n      ranges: false,\n      locations: true,\n    }) as AnyNode;\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    throw new Error(`Workflow script parse error: ${msg}`);\n  }\n\n  assertDeterministicAst(ast);\n  assertNoDangerousImports(ast);\n  lintAwaits(ast);\n\n  const first = ast.body?.[0] as AnyNode | undefined;\n  if (first?.type !== 'ExportNamedDeclaration') {\n    throw new Error(\n      '`export const meta = { name, description }` must be the first statement in the script',\n    );\n  }\n\n  const declaration = first.declaration as AnyNode | null;\n  if (declaration?.type !== 'VariableDeclaration' || declaration.kind !== 'const') {\n    throw new Error('meta export must be `export const meta = ...`');\n  }\n  if (declaration.declarations.length !== 1) {\n    throw new Error('meta export must declare only `meta`');\n  }\n  const declarator = declaration.declarations[0] as AnyNode;\n  if (declarator.id?.type !== 'Identifier' || declarator.id.name !== 'meta') {\n    throw new Error('meta export must declare `meta`');\n  }\n  if (!declarator.init) {\n    throw new Error('meta must have a literal value');\n  }\n\n  const meta = evaluateLiteral(declarator.init, 'meta');\n  validateMeta(meta);\n\n  return {\n    meta,\n    body: script.slice(0, first.start) + script.slice(first.end),\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Determinism / safety guards\n// ---------------------------------------------------------------------------\n\nfunction assertDeterministicAst(node: AnyNode): void {\n  if (isDateNowCall(node) || isMathRandomCall(node) || isNewDateExpression(node)) {\n    throw new Error(NONDETERMINISM_ERROR);\n  }\n  for (const child of astChildren(node)) {\n    assertDeterministicAst(child);\n  }\n}\n\nfunction assertNoDangerousImports(node: AnyNode): void {\n  if (node.type === 'ImportDeclaration' || node.type === 'ImportExpression') {\n    throw new Error(\n      \"Workflow scripts cannot use `import` — only the exposed globals (agent, parallel, pipeline, phase, log, args, cwd, budget) are available.\",\n    );\n  }\n  if (node.type === 'CallExpression') {\n    const callee = node.callee as AnyNode | undefined;\n    if (callee?.type === 'Identifier' && (callee.name === 'require' || callee.name === 'eval')) {\n      throw new Error(`Workflow scripts cannot call \\`${callee.name}\\`.`);\n    }\n  }\n  for (const child of astChildren(node)) {\n    assertNoDangerousImports(child);\n  }\n}\n\nfunction astChildren(node: AnyNode): AnyNode[] {\n  const children: AnyNode[] = [];\n  for (const value of Object.values(node)) {\n    if (Array.isArray(value)) {\n      for (const v of value) {\n        if (isAstNode(v)) children.push(v);\n      }\n    } else if (isAstNode(value)) {\n      children.push(value);\n    }\n  }\n  return children;\n}\n\nfunction isAstNode(value: unknown): value is AnyNode {\n  return !!value && typeof value === 'object' && typeof (value as AnyNode).type === 'string';\n}\n\nfunction isDateNowCall(node: AnyNode): boolean {\n  return node.type === 'CallExpression' && isMemberExpression(node.callee, 'Date', 'now');\n}\n\nfunction isMathRandomCall(node: AnyNode): boolean {\n  return node.type === 'CallExpression' && isMemberExpression(node.callee, 'Math', 'random');\n}\n\nfunction isNewDateExpression(node: AnyNode): boolean {\n  return (\n    node.type === 'NewExpression' &&\n    (node.callee as AnyNode | undefined)?.type === 'Identifier' &&\n    (node.callee as AnyNode).name === 'Date'\n  );\n}\n\nfunction isMemberExpression(\n  node: AnyNode | undefined,\n  objectName: string,\n  propertyName: string,\n): boolean {\n  if (\n    node?.type !== 'MemberExpression' ||\n    (node.object as AnyNode | undefined)?.type !== 'Identifier' ||\n    (node.object as AnyNode).name !== objectName\n  ) {\n    return false;\n  }\n  const prop = node.property as AnyNode | undefined;\n  if (!node.computed && prop?.type === 'Identifier') return prop.name === propertyName;\n  if (prop?.type === 'Literal' && typeof prop.value === 'string') return prop.value === propertyName;\n  return false;\n}\n\n// ---------------------------------------------------------------------------\n// Literal evaluator (meta must be a pure literal)\n// ---------------------------------------------------------------------------\n\nfunction evaluateLiteral(node: AnyNode, path: string): any {\n  switch (node.type) {\n    case 'ObjectExpression': {\n      const out: Record<string, unknown> = {};\n      for (const prop of node.properties as AnyNode[]) {\n        if (prop.type === 'SpreadElement') {\n          throw new Error(`spread not allowed in ${path}`);\n        }\n        if (prop.type !== 'Property') {\n          throw new Error(`only plain properties allowed in ${path}`);\n        }\n        if (prop.computed) {\n          throw new Error(`computed keys not allowed in ${path}`);\n        }\n        if (prop.kind !== 'init' || prop.method) {\n          throw new Error(`methods/accessors not allowed in ${path}`);\n        }\n        const key = propertyKey(prop.key as AnyNode, path);\n        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {\n          throw new Error(`reserved key name not allowed in ${path}: ${key}`);\n        }\n        out[key] = evaluateLiteral(prop.value as AnyNode, `${path}.${key}`);\n      }\n      return out;\n    }\n    case 'ArrayExpression':\n      return (node.elements as Array<AnyNode | null>).map((element, index) => {\n        if (!element) throw new Error(`sparse arrays not allowed in ${path}`);\n        if (element.type === 'SpreadElement') {\n          throw new Error(`spread not allowed in ${path}`);\n        }\n        return evaluateLiteral(element, `${path}[${index}]`);\n      });\n    case 'Literal':\n      return node.value;\n    case 'TemplateLiteral':\n      if (node.expressions.length > 0) {\n        throw new Error(`template interpolation not allowed in ${path}`);\n      }\n      return node.quasis\n        .map((quasi: AnyNode) => quasi.value.cooked ?? quasi.value.raw)\n        .join('');\n    case 'UnaryExpression':\n      if (\n        node.operator === '-' &&\n        node.argument?.type === 'Literal' &&\n        typeof node.argument.value === 'number'\n      ) {\n        return -node.argument.value;\n      }\n      throw new Error(`only negative-number unary allowed in ${path}`);\n    default:\n      throw new Error(`non-literal node type in ${path}: ${node.type}`);\n  }\n}\n\nfunction propertyKey(node: AnyNode, path: string): string {\n  if (node.type === 'Identifier') return node.name;\n  if (node.type === 'Literal' && (typeof node.value === 'string' || typeof node.value === 'number')) {\n    return String(node.value);\n  }\n  throw new Error(`unsupported key type in ${path}: ${node.type}`);\n}\n\nfunction validateMeta(meta: unknown): asserts meta is WorkflowMeta {\n  if (!meta || typeof meta !== 'object') {\n    throw new Error('meta must be an object');\n  }\n  const value = meta as WorkflowMeta;\n  if (typeof value.name !== 'string' || !value.name.trim()) {\n    throw new Error('meta.name must be a non-empty string');\n  }\n  if (!/^[a-z][a-z0-9_-]*$/.test(value.name)) {\n    throw new Error(\n      `meta.name must be lowercase snake_case (got \"${value.name}\"). Example: \"audit_repo\".`,\n    );\n  }\n  if (typeof value.description !== 'string' || !value.description.trim()) {\n    throw new Error('meta.description must be a non-empty string');\n  }\n  if (value.whenToUse !== undefined && typeof value.whenToUse !== 'string') {\n    throw new Error('meta.whenToUse must be a string');\n  }\n  if (value.phases !== undefined) {\n    if (!Array.isArray(value.phases)) {\n      throw new Error('meta.phases must be an array');\n    }\n    for (const phase of value.phases) {\n      if (!phase || typeof phase !== 'object' || typeof (phase as WorkflowMetaPhase).title !== 'string') {\n        throw new Error('each meta phase must have a title string');\n      }\n    }\n  }\n  if (value.tags !== undefined) {\n    if (!Array.isArray(value.tags) || value.tags.some((tag) => typeof tag !== 'string' || !tag.trim())) {\n      throw new Error('meta.tags must be an array of non-empty strings');\n    }\n  }\n  if (value.estimatedAgents !== undefined) {\n    const est = value.estimatedAgents;\n    if (!est || typeof est !== 'object') {\n      throw new Error('meta.estimatedAgents must be an object');\n    }\n    if (typeof est.min !== 'number' || typeof est.max !== 'number' || !Number.isFinite(est.min) || !Number.isFinite(est.max)) {\n      throw new Error('meta.estimatedAgents.min and .max must be finite numbers');\n    }\n    if (est.min < 1 || est.max < est.min) {\n      throw new Error('meta.estimatedAgents requires min >= 1 and max >= min');\n    }\n  }\n  validateExamplePrompts(value.examplePrompts, 'meta.examplePrompts');\n  validateMetaI18n(value.i18n);\n}\n"],"mappings":"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"}

package/dist/src/agent/workflow/runtime.d.ts

@@ -1,34 +0,0 @@
-/**
- * Sandboxed workflow runtime.
- *
- * Parses the script via {@link parseWorkflowScript} (which strips the `meta`
- * export), wraps the remaining body in an async IIFE, and runs it inside a
- * Node `vm` context with a curated set of globals:
- *
- *   - `agent(prompt, opts)` — spawns a subagent through the injected
- *     {@link SubagentRunner} and returns its result (string, or schema-validated
- *     object). Failures resolve to `null`.
- *   - `parallel(thunks)` — concurrent fan-out; thunks (not promises!) so the
- *     limiter sees each agent() call.
- *   - `pipeline(items, ...stages)` — per-item sequential stages, items run
- *     concurrently (no stage barrier). Each stage receives
- *     `(prevResult, originalItem, index)`. A stage that throws drops that item
- *     to `null` and skips remaining stages.
- *   - `phase(title)` — marks the current phase; surfaces through `onPhase`.
- *   - `log(message)` — appends to the workflow log.
- *   - `budget` — `{ total, spent(), remaining() }` for self-pacing scripts.
- *   - `args`, `cwd`, `process.cwd()`.
- *
- * The runtime is the only code that touches `vm`. It exposes no IO surface,
- * carries no LLM dependency, and is fully driven by injected callbacks — that
- * means the workflow tool, tests, and any future runner share one runtime.
- */
-import type { Api, Model } from '@earendil-works/pi-ai';
-import type { SubagentRunner, WorkflowRunOptions, WorkflowRunResult } from './types.js';
-export interface RunWorkflowDeps {
-    runner: SubagentRunner;
-    /** Resolve a model ref (`provider/model` or configured typed id) to a {@link Model}. Throws on unknown ref. */
-    resolveModelId?: (modelId: string) => Model<Api>;
-}
-export declare function runWorkflow<T = unknown>(script: string, deps: RunWorkflowDeps, options: WorkflowRunOptions): Promise<WorkflowRunResult<T>>;
-export { emptySnapshotFor } from './snapshot-empty.js';