@duckmind/dm-windows-x64 0.60.6 → 0.60.9

package/extensions/dm-subagents/src/runs/shared/dynamic-fanout.js

@@ -1 +1,282 @@
-import*as j from"node:os";import*as V from"node:path";function z(J){return J.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function w(J){let Q=J?.env??process.env,U=J&&Object.hasOwn(J,"getuid")?J.getuid:process.getuid?.bind(process);if(typeof U==="function")return`uid-${U()}`;for(let q of["USERNAME","USER","LOGNAME"]){let B=Q[q];if(B)return`user-${z(B)}`}let $=J&&Object.hasOwn(J,"userInfo")?J.userInfo:j.userInfo;try{let q=$?.().username;if(q)return`user-${z(q)}`}catch{}let X=Q.USERPROFILE??Q.HOME;if(X)return`home-${z(X)}`;let Z=J&&Object.hasOwn(J,"homedir")?J.homedir:j.homedir;try{let q=Z?.();if(q)return`home-${z(q)}`}catch{}return"shared"}var A=V.join(j.tmpdir(),`dm-subagents-${w()}`),e=V.join(A,"async-subagent-results"),JJ=V.join(A,"async-subagent-runs"),b=V.join(A,"chain-runs"),UJ=V.join(A,"artifacts");function D(J){let Q=[];for(let U=J.length-1;U>=0;U--){let $=J[U];if($.role!=="assistant")continue;if("errorMessage"in $&&typeof $.errorMessage==="string"&&$.errorMessage.length>0||"stopReason"in $&&$.stopReason==="error")continue;for(let Z=$.content.length-1;Z>=0;Z--){let q=$.content[Z];if(q.type!=="text"||q.text.trim().length===0)continue;if(Q.push(q.text),/```acceptance-report\s*\n[\s\S]*?```/i.test(q.text))return q.text;for(let B of q.text.matchAll(/```(?:json|jsonc|json5)\s*\n([\s\S]*?)```/gi)){let Y=B[1]??"";if(/"criteriaSatisfied"/.test(Y)&&/"(?:changedFiles|testsAddedOrUpdated|commandsRun|validationOutput|residualRisks|noStagedFiles|diffSummary|reviewFindings|manualNotes)"/.test(Y))return q.text}if(/ACCEPTANCE_REPORT\s*:/i.test(q.text))return q.text}}return Q[0]??""}function E(J){return J.finalOutput??D(J.messages??[])}import{Compile as x}from"typebox/compile";function C(J,Q){let U;try{U=x(J)}catch(X){return{status:"invalid",message:`invalid outputSchema: ${X instanceof Error?X.message:String(X)}`}}if(U.Check(Q))return{status:"valid"};return{status:"invalid",message:[...U.Errors(Q)].slice(0,8).map((X)=>{return`${X.instancePath?X.instancePath.replace(/^\//,"").replace(/\//g,"."):"root"}: ${X.message}`}).join("; ")||"schema validation failed"}}class W extends Error{}var y=/^[A-Za-z_][A-Za-z0-9_]*$/,P=/^[A-Za-z_][A-Za-z0-9_]*$/,H=/\{([A-Za-z_][A-Za-z0-9_]*)(?:\.([^{}]+))?\}/g,v=new Set(["task","previous","chain_dir","outputs"]),S=new Set(["expand","parallel","collect","concurrency","failFast","phase","label","acceptance"]),f=new Set([...S,"effectiveAcceptance","sessionFiles","thinkingOverrides"]),k=new Set(["from","item","key","maxItems","onEmpty"]),h=new Set(["output","path"]),I=new Set(["agent","task","phase","label","outputSchema","cwd","output","outputMode","reads","progress","skill","model","toolBudget","acceptance"]),m=new Set([...I,"outputName","structured","inheritProjectContext","inheritSkills","skills","outputPath","maxSubagentDepth","structuredOutput","structuredOutputSchema","tools","extensions","subagentOnlyExtensions","mcpDirectTools","completionGuard","systemPrompt","systemPromptMode","thinking","modelCandidates","sessionFile","effectiveAcceptance","parentSessionId"]),c=new Set(["as","outputSchema"]);function F(J){return y.test(J)}function L(J,Q){if(J==="")return;if(!J.startsWith("/"))throw new W(`${Q} must be a JSON Pointer starting with '/'.`);for(let U of J.slice(1).split("/"))if(/~(?![01])/.test(U))throw new W(`${Q} contains invalid JSON Pointer escape.`)}function g(J){return J.replace(/~1/g,"/").replace(/~0/g,"~")}function M(J,Q,U){if(L(Q,U),Q==="")return J;let $=J;for(let X of Q.slice(1).split("/")){let Z=g(X);if(Array.isArray($)){if(!/^(0|[1-9][0-9]*)$/.test(Z))throw new W(`${U} segment '${Z}' does not address an array index.`);let B=Number(Z);if(B>=$.length)throw new W(`${U} does not exist.`);$=$[B];continue}if(!$||typeof $!=="object")throw new W(`${U} does not exist.`);let q=$;if(!Object.prototype.hasOwnProperty.call(q,Z))throw new W(`${U} does not exist.`);$=q[Z]}return $}function u(J,Q){if(typeof J==="string"||typeof J==="number"||typeof J==="boolean"){let U=String(J);if(!U.trim())throw new W(`${Q} resolved to an empty key.`);if(/[\u0000-\u001F\u007F]/.test(U))throw new W(`${Q} resolved to an unsafe key.`);if(U.length>200)throw new W(`${Q} resolved to a key longer than 200 characters.`);return U}throw new W(`${Q} must resolve to a string, number, or boolean.`)}function d(J){return J.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,80)||"item"}function p(J,Q){if(J===void 0)throw new W(`Unresolved item reference '${Q}'.`);if(typeof J==="string")return J;if(typeof J==="number"||typeof J==="boolean"||J===null)return String(J);return JSON.stringify(J)}function n(J,Q,U){if(!Q)return J;let $=`/${Q.split(".").map((X)=>X.replace(/~/g,"~0").replace(/\//g,"~1")).join("/")}`;return M(J,$,U)}function N(J,Q,U){return J.replace(H,($,X,Z)=>{if(X!==Q)return $;if(Z!==void 0&&(!Z.trim()||Z.includes("..")))throw new W(`Invalid item reference '${$}'.`);return p(n(U,Z,$),$)})}function K(J,Q,U){if(!J||typeof J!=="object"||Array.isArray(J))throw new W(`${U} must be an object.`);for(let $ of Object.keys(J))if(!Q.has($))throw new W(`${U} does not support field '${$}'.`)}function o(J,Q,U){for(let $ of J.matchAll(/\{([^{}]*)\}/g)){let X=$[0],Z=$[1];if(Z===Q||Z.startsWith(`${Q}.`)){if(!H.test(X)||Z===`${Q}.`||Z.includes(".."))throw new W(`Invalid item reference '${X}' in ${U}.`);H.lastIndex=0;continue}H.lastIndex=0;let q=Z.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];if(q===Q)throw new W(`Invalid item reference '${X}' in ${U}.`);if(q&&v.has(q))continue;if(q)throw new W(`Unsupported template reference '${X}' in ${U}.`)}if(H.lastIndex=0,J.includes(`{${Q}.}`)||new RegExp(`\\{${Q}(?:\\.|$)[^}]*$`).test(J))throw new W(`Invalid item reference in ${U}.`)}function SJ(J){return!!J&&typeof J==="object"&&!Array.isArray(J)&&(Object.prototype.hasOwnProperty.call(J,"expand")||Object.prototype.hasOwnProperty.call(J,"collect"))}function l(J,Q,U={}){let $=`Dynamic chain step ${Q+1}`;if(K(J,U.allowRunnerFields?f:S,$),!J.expand||!J.expand.from)throw new W(`${$} requires expand.from.`);if(K(J.expand,k,`${$} expand`),K(J.expand.from,h,`${$} expand.from`),!F(J.expand.from.output))throw new W(`${$} has invalid expand.from.output '${J.expand.from.output}'.`);if(L(J.expand.from.path,`${$} expand.from.path`),J.expand.key!==void 0)L(J.expand.key,`${$} expand.key`);let X=J.expand.item??"item";if(!P.test(X))throw new W(`${$} has invalid expand.item '${X}'.`);if(J.expand.maxItems===void 0&&U.maxItems===void 0)throw new W(`${$} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);if(J.expand.maxItems!==void 0&&(!Number.isInteger(J.expand.maxItems)||J.expand.maxItems<0))throw new W(`${$} expand.maxItems must be an integer >= 0.`);if(U.maxItems!==void 0&&(!Number.isInteger(U.maxItems)||U.maxItems<0))throw new W("config.chain.dynamicFanout.maxItems must be an integer >= 0.");if(!J.parallel||Array.isArray(J.parallel))throw new W(`${$} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);if(K(J.parallel,U.allowRunnerFields?m:I,`${$} parallel`),"expand"in J.parallel)throw new W(`${$} does not support nested dynamic fanout.`);if(!J.parallel.agent)throw new W(`${$} parallel.agent is required.`);if(!J.collect?.as||!F(J.collect.as))throw new W(`${$} requires collect.as with a safe output name.`);K(J.collect,c,`${$} collect`);for(let[Z,q]of[["parallel.task",J.parallel.task],["parallel.label",J.parallel.label]])if(q)o(q,X,`${$} ${Z}`)}function i(J,Q,U,$={}){l(J,U,$);let X=J.expand.from.output,Z=Q[X];if(!Z)throw new W(`Dynamic chain step ${U+1} references unknown output '${X}'.`);if(Z.structured===void 0)throw new W(`Dynamic chain step ${U+1} requires structured output '${X}'.`);let q=M(Z.structured,J.expand.from.path,`Dynamic chain step ${U+1} expand.from.path`);if(!Array.isArray(q))throw new W(`Dynamic chain step ${U+1} expand.from.path must resolve to an array.`);let B=J.expand.maxItems??$.maxItems;if(B===void 0)throw new W(`Dynamic chain step ${U+1} requires an effective maxItems.`);if(q.length>B)throw new W(`Dynamic chain step ${U+1} resolved ${q.length} items, exceeding maxItems ${B}.`);let Y=new Set,G=new Set;return q.map((R,T)=>{let _=J.expand.key===void 0?String(T):u(M(R,J.expand.key,`Dynamic chain step ${U+1} expand.key`),`Dynamic chain step ${U+1} expand.key`);if(Y.has(_))throw new W(`Dynamic chain step ${U+1} produced duplicate item key '${_}'.`);Y.add(_);let O=d(_);if(G.has(O))throw new W(`Dynamic chain step ${U+1} produced colliding item id '${O}'.`);return G.add(O),{index:T,key:_,idKey:O,item:R}})}function IJ(J,Q,U,$={}){let X=i(J,Q,U,$);if(X.length===0){if((J.expand.onEmpty??"skip")==="fail")throw new W(`Dynamic chain step ${U+1} source array is empty.`);return{items:X,parallel:[],collectedOnEmpty:[]}}let Z=J.expand.item??"item",q=X.map((B)=>{let Y=N(J.parallel.task??"{previous}",Z,B.item),G=J.parallel.label?N(J.parallel.label,Z,B.item):void 0;return{...J.parallel,task:Y,...G!==void 0?{label:G}:{}}});return{items:X,parallel:q}}function wJ(J,Q,U){return Q.map(($,X)=>{let Z=U[X],q=Z?"output"in Z&&typeof Z.output==="string"?Z.output:E(Z):"";return{key:$.key,index:$.index,item:$.item,agent:Z?.agent??J.parallel.agent,exitCode:Z?.exitCode??null,text:q,...Z?.structuredOutput!==void 0?{structured:Z.structuredOutput}:{},...Z?.error?{error:Z.error}:{},...Z?.timedOut?{timedOut:!0}:{},...Z?.savedOutputPath?{outputPath:Z.savedOutputPath}:{},...Z?.artifactPaths?{artifactPaths:Z.artifactPaths}:{}}})}function bJ(J,Q){if(!J)return;let U=C(J,Q);if(U.status==="invalid")throw new W(`Collected output validation failed: ${U.message}`)}export{l as validateDynamicStepShape,bJ as validateDynamicCollection,M as resolveJsonPointer,N as resolveItemTemplate,i as resolveDynamicFanoutItems,d as normalizeItemKeyForId,IJ as materializeDynamicParallelStep,F as isSafeOutputName,SJ as hasDynamicFanoutFields,wJ as collectDynamicResults,o as assertNoUnresolvedItemReferences,L as assertJsonPointer,W as DynamicFanoutError};
+import { getSingleResultOutput } from "../../shared/utils.js";
+import { validateStructuredOutputValue } from "./structured-output.js";
+
+export class DynamicFanoutError extends Error {
+}
+const SAFE_OUTPUT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const ITEM_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const ITEM_REF_PATTERN = /\{([A-Za-z_][A-Za-z0-9_]*)(?:\.([^{}]+))?\}/g;
+const RESERVED_TEMPLATE_NAMES = new Set(["task", "previous", "chain_dir", "outputs"]);
+const DYNAMIC_STEP_KEYS = new Set(["expand", "parallel", "collect", "concurrency", "failFast", "phase", "label", "acceptance"]);
+const RUNNER_DYNAMIC_STEP_KEYS = new Set([...DYNAMIC_STEP_KEYS, "effectiveAcceptance", "sessionFiles", "thinkingOverrides"]);
+const DYNAMIC_EXPAND_KEYS = new Set(["from", "item", "key", "maxItems", "onEmpty"]);
+const DYNAMIC_EXPAND_FROM_KEYS = new Set(["output", "path"]);
+const DYNAMIC_PARALLEL_KEYS = new Set(["agent", "task", "phase", "label", "outputSchema", "cwd", "output", "outputMode", "reads", "progress", "skill", "model", "toolBudget", "acceptance"]);
+const RUNNER_DYNAMIC_PARALLEL_KEYS = new Set([
+  ...DYNAMIC_PARALLEL_KEYS,
+  "outputName",
+  "structured",
+  "inheritProjectContext",
+  "inheritSkills",
+  "skills",
+  "outputPath",
+  "maxSubagentDepth",
+  "structuredOutput",
+  "structuredOutputSchema",
+  "tools",
+  "extensions",
+  "subagentOnlyExtensions",
+  "mcpDirectTools",
+  "completionGuard",
+  "systemPrompt",
+  "systemPromptMode",
+  "thinking",
+  "modelCandidates",
+  "sessionFile",
+  "effectiveAcceptance",
+  "parentSessionId"
+]);
+const DYNAMIC_COLLECT_KEYS = new Set(["as", "outputSchema"]);
+export function isSafeOutputName(name) {
+  return SAFE_OUTPUT_NAME_PATTERN.test(name);
+}
+export function assertJsonPointer(pointer, label) {
+  if (pointer === "")
+    return;
+  if (!pointer.startsWith("/")) {
+    throw new DynamicFanoutError(`${label} must be a JSON Pointer starting with '/'.`);
+  }
+  for (const segment of pointer.slice(1).split("/")) {
+    if (/~(?![01])/.test(segment)) {
+      throw new DynamicFanoutError(`${label} contains invalid JSON Pointer escape.`);
+    }
+  }
+}
+function decodePointerSegment(segment) {
+  return segment.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+export function resolveJsonPointer(value, pointer, label) {
+  assertJsonPointer(pointer, label);
+  if (pointer === "")
+    return value;
+  let current = value;
+  for (const rawSegment of pointer.slice(1).split("/")) {
+    const segment = decodePointerSegment(rawSegment);
+    if (Array.isArray(current)) {
+      if (!/^(0|[1-9][0-9]*)$/.test(segment)) {
+        throw new DynamicFanoutError(`${label} segment '${segment}' does not address an array index.`);
+      }
+      const index = Number(segment);
+      if (index >= current.length)
+        throw new DynamicFanoutError(`${label} does not exist.`);
+      current = current[index];
+      continue;
+    }
+    if (!current || typeof current !== "object") {
+      throw new DynamicFanoutError(`${label} does not exist.`);
+    }
+    const record = current;
+    if (!Object.prototype.hasOwnProperty.call(record, segment)) {
+      throw new DynamicFanoutError(`${label} does not exist.`);
+    }
+    current = record[segment];
+  }
+  return current;
+}
+function scalarToKey(value, label) {
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    const key = String(value);
+    if (!key.trim())
+      throw new DynamicFanoutError(`${label} resolved to an empty key.`);
+    if (/[\u0000-\u001F\u007F]/.test(key))
+      throw new DynamicFanoutError(`${label} resolved to an unsafe key.`);
+    if (key.length > 200)
+      throw new DynamicFanoutError(`${label} resolved to a key longer than 200 characters.`);
+    return key;
+  }
+  throw new DynamicFanoutError(`${label} must resolve to a string, number, or boolean.`);
+}
+export function normalizeItemKeyForId(key) {
+  const normalized = key.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+  return normalized || "item";
+}
+function valueToTemplateText(value, reference) {
+  if (value === undefined)
+    throw new DynamicFanoutError(`Unresolved item reference '${reference}'.`);
+  if (typeof value === "string")
+    return value;
+  if (typeof value === "number" || typeof value === "boolean" || value === null)
+    return String(value);
+  return JSON.stringify(value);
+}
+function resolveItemPath(item, pathText, reference) {
+  if (!pathText)
+    return item;
+  const pointer = `/${pathText.split(".").map((segment) => segment.replace(/~/g, "~0").replace(/\//g, "~1")).join("/")}`;
+  return resolveJsonPointer(item, pointer, reference);
+}
+export function resolveItemTemplate(template, itemName, item) {
+  return template.replace(ITEM_REF_PATTERN, (raw, name, pathText) => {
+    if (name !== itemName)
+      return raw;
+    if (pathText !== undefined && (!pathText.trim() || pathText.includes(".."))) {
+      throw new DynamicFanoutError(`Invalid item reference '${raw}'.`);
+    }
+    return valueToTemplateText(resolveItemPath(item, pathText, raw), raw);
+  });
+}
+function assertOnlyKeys(value, allowed, label) {
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    throw new DynamicFanoutError(`${label} must be an object.`);
+  for (const key of Object.keys(value)) {
+    if (!allowed.has(key))
+      throw new DynamicFanoutError(`${label} does not support field '${key}'.`);
+  }
+}
+export function assertNoUnresolvedItemReferences(template, itemName, label) {
+  for (const match of template.matchAll(/\{([^{}]*)\}/g)) {
+    const raw = match[0];
+    const reference = match[1];
+    if (reference === itemName || reference.startsWith(`${itemName}.`)) {
+      if (!ITEM_REF_PATTERN.test(raw) || reference === `${itemName}.` || reference.includes("..")) {
+        throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);
+      }
+      ITEM_REF_PATTERN.lastIndex = 0;
+      continue;
+    }
+    ITEM_REF_PATTERN.lastIndex = 0;
+    const name = reference.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];
+    if (name === itemName)
+      throw new DynamicFanoutError(`Invalid item reference '${raw}' in ${label}.`);
+    if (name && RESERVED_TEMPLATE_NAMES.has(name))
+      continue;
+    if (name)
+      throw new DynamicFanoutError(`Unsupported template reference '${raw}' in ${label}.`);
+  }
+  ITEM_REF_PATTERN.lastIndex = 0;
+  if (template.includes(`{${itemName}.}`) || new RegExp(`\\{${itemName}(?:\\.|$)[^}]*$`).test(template)) {
+    throw new DynamicFanoutError(`Invalid item reference in ${label}.`);
+  }
+}
+export function hasDynamicFanoutFields(step) {
+  return !!step && typeof step === "object" && !Array.isArray(step) && (Object.prototype.hasOwnProperty.call(step, "expand") || Object.prototype.hasOwnProperty.call(step, "collect"));
+}
+export function validateDynamicStepShape(step, stepIndex, config = {}) {
+  const prefix = `Dynamic chain step ${stepIndex + 1}`;
+  assertOnlyKeys(step, config.allowRunnerFields ? RUNNER_DYNAMIC_STEP_KEYS : DYNAMIC_STEP_KEYS, prefix);
+  if (!step.expand || !step.expand.from)
+    throw new DynamicFanoutError(`${prefix} requires expand.from.`);
+  assertOnlyKeys(step.expand, DYNAMIC_EXPAND_KEYS, `${prefix} expand`);
+  assertOnlyKeys(step.expand.from, DYNAMIC_EXPAND_FROM_KEYS, `${prefix} expand.from`);
+  if (!isSafeOutputName(step.expand.from.output))
+    throw new DynamicFanoutError(`${prefix} has invalid expand.from.output '${step.expand.from.output}'.`);
+  assertJsonPointer(step.expand.from.path, `${prefix} expand.from.path`);
+  if (step.expand.key !== undefined)
+    assertJsonPointer(step.expand.key, `${prefix} expand.key`);
+  const itemName = step.expand.item ?? "item";
+  if (!ITEM_NAME_PATTERN.test(itemName))
+    throw new DynamicFanoutError(`${prefix} has invalid expand.item '${itemName}'.`);
+  if (step.expand.maxItems === undefined && config.maxItems === undefined) {
+    throw new DynamicFanoutError(`${prefix} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);
+  }
+  if (step.expand.maxItems !== undefined && (!Number.isInteger(step.expand.maxItems) || step.expand.maxItems < 0)) {
+    throw new DynamicFanoutError(`${prefix} expand.maxItems must be an integer >= 0.`);
+  }
+  if (config.maxItems !== undefined && (!Number.isInteger(config.maxItems) || config.maxItems < 0)) {
+    throw new DynamicFanoutError("config.chain.dynamicFanout.maxItems must be an integer >= 0.");
+  }
+  if (!step.parallel || Array.isArray(step.parallel))
+    throw new DynamicFanoutError(`${prefix} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);
+  assertOnlyKeys(step.parallel, config.allowRunnerFields ? RUNNER_DYNAMIC_PARALLEL_KEYS : DYNAMIC_PARALLEL_KEYS, `${prefix} parallel`);
+  if ("expand" in step.parallel)
+    throw new DynamicFanoutError(`${prefix} does not support nested dynamic fanout.`);
+  if (!step.parallel.agent)
+    throw new DynamicFanoutError(`${prefix} parallel.agent is required.`);
+  if (!step.collect?.as || !isSafeOutputName(step.collect.as))
+    throw new DynamicFanoutError(`${prefix} requires collect.as with a safe output name.`);
+  assertOnlyKeys(step.collect, DYNAMIC_COLLECT_KEYS, `${prefix} collect`);
+  for (const [label, template] of [
+    ["parallel.task", step.parallel.task],
+    ["parallel.label", step.parallel.label]
+  ]) {
+    if (template)
+      assertNoUnresolvedItemReferences(template, itemName, `${prefix} ${label}`);
+  }
+}
+export function resolveDynamicFanoutItems(step, outputs, stepIndex, config = {}) {
+  validateDynamicStepShape(step, stepIndex, config);
+  const sourceName = step.expand.from.output;
+  const source = outputs[sourceName];
+  if (!source)
+    throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} references unknown output '${sourceName}'.`);
+  if (source.structured === undefined)
+    throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires structured output '${sourceName}'.`);
+  const value = resolveJsonPointer(source.structured, step.expand.from.path, `Dynamic chain step ${stepIndex + 1} expand.from.path`);
+  if (!Array.isArray(value))
+    throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} expand.from.path must resolve to an array.`);
+  const maxItems = step.expand.maxItems ?? config.maxItems;
+  if (maxItems === undefined)
+    throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} requires an effective maxItems.`);
+  if (value.length > maxItems)
+    throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} resolved ${value.length} items, exceeding maxItems ${maxItems}.`);
+  const seen = new Set;
+  const seenIds = new Set;
+  return value.map((item, index) => {
+    const key = step.expand.key === undefined ? String(index) : scalarToKey(resolveJsonPointer(item, step.expand.key, `Dynamic chain step ${stepIndex + 1} expand.key`), `Dynamic chain step ${stepIndex + 1} expand.key`);
+    if (seen.has(key))
+      throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced duplicate item key '${key}'.`);
+    seen.add(key);
+    const idKey = normalizeItemKeyForId(key);
+    if (seenIds.has(idKey))
+      throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} produced colliding item id '${idKey}'.`);
+    seenIds.add(idKey);
+    return { index, key, idKey, item };
+  });
+}
+export function materializeDynamicParallelStep(step, outputs, stepIndex, config = {}) {
+  const items = resolveDynamicFanoutItems(step, outputs, stepIndex, config);
+  if (items.length === 0) {
+    if ((step.expand.onEmpty ?? "skip") === "fail") {
+      throw new DynamicFanoutError(`Dynamic chain step ${stepIndex + 1} source array is empty.`);
+    }
+    return { items, parallel: [], collectedOnEmpty: [] };
+  }
+  const itemName = step.expand.item ?? "item";
+  const parallel = items.map((entry) => {
+    const task = resolveItemTemplate(step.parallel.task ?? "{previous}", itemName, entry.item);
+    const label = step.parallel.label ? resolveItemTemplate(step.parallel.label, itemName, entry.item) : undefined;
+    return {
+      ...step.parallel,
+      task,
+      ...label !== undefined ? { label } : {}
+    };
+  });
+  return { items, parallel };
+}
+export function collectDynamicResults(step, items, results) {
+  return items.map((entry, index) => {
+    const result = results[index];
+    const text = result ? "output" in result && typeof result.output === "string" ? result.output : getSingleResultOutput(result) : "";
+    return {
+      key: entry.key,
+      index: entry.index,
+      item: entry.item,
+      agent: result?.agent ?? step.parallel.agent,
+      exitCode: result?.exitCode ?? null,
+      text,
+      ...result?.structuredOutput !== undefined ? { structured: result.structuredOutput } : {},
+      ...result?.error ? { error: result.error } : {},
+      ...result?.timedOut ? { timedOut: true } : {},
+      ...result?.savedOutputPath ? { outputPath: result.savedOutputPath } : {},
+      ...result?.artifactPaths ? { artifactPaths: result.artifactPaths } : {}
+    };
+  });
+}
+export function validateDynamicCollection(schema, value) {
+  if (!schema)
+    return;
+  const validation = validateStructuredOutputValue(schema, value);
+  if (validation.status === "invalid") {
+    throw new DynamicFanoutError(`Collected output validation failed: ${validation.message}`);
+  }
+}

package/extensions/dm-subagents/src/runs/shared/long-running-guard.js

@@ -1 +1,148 @@
-var s=[/(^|[;&|()\s])rm\s+/,/(^|[;&|()\s])mv\s+/,/(^|[;&|()\s])cp\s+/,/(^|[;&|()\s])mkdir\s+/,/(^|[;&|()\s])touch\s+/,/(^|[;&|()\s])git\s+apply\b/,/(^|[;&|()\s])patch\s+/,/(^|[;&|()\s])sed\s+[^\n;&|]*\s-i\b/,/(^|[;&|()\s])perl\s+[^\n;&|]*\s-pi\b/,/(^|[;&|()]|\n)\s*tee\s+[^|&;]+/,/\b(writeFile|writeFileSync|appendFile|appendFileSync)\b/,/\bwrite_text\s*\(/,/\bopen\s*\([^)]*,\s*["'][wa]/],l=["failed","error","no exact match","did not match","malformed","rejected","unable","cannot","could not"];function f(e,t){if(!e||!t)return;let n=["path","file","filename","target","cwd"];for(let i of n){let r=t[i];if(typeof r==="string"&&r.trim())return r.trim()}if(e==="bash"){let i=typeof t.command==="string"?t.command:void 0;if(!i)return;let r=i.match(/(?:>|>>|tee\s+)(\S+)/);if(r?.[1])return r[1]}return}function c(e){let t=!1,n=!1;for(let i=0;i<e.length;i++){let r=e[i];if(r==="'"&&!n){t=!t;continue}if(r==='"'&&!t){n=!n;continue}if(t||n)continue;if(r!==">")continue;if(e[i-1]==="-")continue;let o=e[i+1]===">",u=i+(o?2:1);while(u<e.length&&/\s/.test(e[u]))u++;if(u>=e.length)continue;let a=e[u];if(a==="&"||a==="|"||a===";")continue;if(a==="("||a===")")continue;return!0}return!1}function d(e){return c(e)||s.some((t)=>t.test(e))}function g(e,t){if(!e)return!1;if(e==="edit"||e==="write")return!0;if(e!=="bash")return!1;let n=typeof t?.command==="string"?t.command:"";if(!n.trim())return!1;return d(n)}function h(e){let t=e.toLowerCase();return l.some((n)=>t.includes(n))}function F(e,t){if(t.now-t.startedAt>=e.activeNoticeAfterMs)return"time_threshold";if(e.activeNoticeAfterTurns!==void 0&&t.turns>=e.activeNoticeAfterTurns)return"turn_threshold";if(e.activeNoticeAfterTokens!==void 0&&t.tokens>=e.activeNoticeAfterTokens)return"token_threshold";return}function p(e){e.consecutiveFailures=0,e.lastFailureAt=void 0,e.recentFailures=[],e.lastMutatingPath=void 0,e.repeatedPathFailures=0}function b(){return{consecutiveFailures:0,recentFailures:[],repeatedPathFailures:0}}function M(e,t,n){if(e.lastFailureAt===void 0||t.ts-e.lastFailureAt>n)e.consecutiveFailures=0,e.recentFailures=[],e.repeatedPathFailures=0,e.lastMutatingPath=void 0;if(e.lastFailureAt=t.ts,e.consecutiveFailures+=1,t.path&&e.lastMutatingPath===t.path)e.repeatedPathFailures+=1;else if(t.path)e.lastMutatingPath=t.path,e.repeatedPathFailures=1;if(e.recentFailures.push(t),e.recentFailures.length>3)e.recentFailures.shift()}function m(e,t){return e.consecutiveFailures>=t||e.repeatedPathFailures>=t}function A(e){if(e.recentFailures.length===0)return;return e.recentFailures.map((t)=>`${t.tool}${t.path?`(${t.path})`:""}: ${t.error}`).join(" | ")}export{A as summarizeRecentMutatingFailures,m as shouldEscalateMutatingFailures,f as resolveCurrentPath,p as resetMutatingFailureState,M as recordMutatingFailure,F as nextLongRunningTrigger,g as isMutatingTool,d as isMutatingBashCommand,h as didMutatingToolFail,b as createMutatingFailureState};
+const MUTATING_BASH_PATTERNS = [
+  /(^|[;&|()\s])rm\s+/,
+  /(^|[;&|()\s])mv\s+/,
+  /(^|[;&|()\s])cp\s+/,
+  /(^|[;&|()\s])mkdir\s+/,
+  /(^|[;&|()\s])touch\s+/,
+  /(^|[;&|()\s])git\s+apply\b/,
+  /(^|[;&|()\s])patch\s+/,
+  /(^|[;&|()\s])sed\s+[^\n;&|]*\s-i\b/,
+  /(^|[;&|()\s])perl\s+[^\n;&|]*\s-pi\b/,
+  /(^|[;&|()]|\n)\s*tee\s+[^|&;]+/,
+  /\b(writeFile|writeFileSync|appendFile|appendFileSync)\b/,
+  /\bwrite_text\s*\(/,
+  /\bopen\s*\([^)]*,\s*["'][wa]/
+];
+const MUTATING_FAILURE_HINTS = [
+  "failed",
+  "error",
+  "no exact match",
+  "did not match",
+  "malformed",
+  "rejected",
+  "unable",
+  "cannot",
+  "could not"
+];
+export function resolveCurrentPath(toolName, args) {
+  if (!toolName || !args)
+    return;
+  const direct = ["path", "file", "filename", "target", "cwd"];
+  for (const key of direct) {
+    const value = args[key];
+    if (typeof value === "string" && value.trim())
+      return value.trim();
+  }
+  if (toolName === "bash") {
+    const command = typeof args.command === "string" ? args.command : undefined;
+    if (!command)
+      return;
+    const redirect = command.match(/(?:>|>>|tee\s+)(\S+)/);
+    if (redirect?.[1])
+      return redirect[1];
+  }
+  return;
+}
+function hasUnquotedFileRedirection(command) {
+  let inSingle = false;
+  let inDouble = false;
+  for (let i = 0;i < command.length; i++) {
+    const char = command[i];
+    if (char === "'" && !inDouble) {
+      inSingle = !inSingle;
+      continue;
+    }
+    if (char === '"' && !inSingle) {
+      inDouble = !inDouble;
+      continue;
+    }
+    if (inSingle || inDouble)
+      continue;
+    if (char !== ">")
+      continue;
+    if (command[i - 1] === "-")
+      continue;
+    const isDouble = command[i + 1] === ">";
+    let cursor = i + (isDouble ? 2 : 1);
+    while (cursor < command.length && /\s/.test(command[cursor]))
+      cursor++;
+    if (cursor >= command.length)
+      continue;
+    const targetStart = command[cursor];
+    if (targetStart === "&" || targetStart === "|" || targetStart === ";")
+      continue;
+    if (targetStart === "(" || targetStart === ")")
+      continue;
+    return true;
+  }
+  return false;
+}
+export function isMutatingBashCommand(command) {
+  return hasUnquotedFileRedirection(command) || MUTATING_BASH_PATTERNS.some((pattern) => pattern.test(command));
+}
+export function isMutatingTool(toolName, args) {
+  if (!toolName)
+    return false;
+  if (toolName === "edit" || toolName === "write")
+    return true;
+  if (toolName !== "bash")
+    return false;
+  const command = typeof args?.command === "string" ? args.command : "";
+  if (!command.trim())
+    return false;
+  return isMutatingBashCommand(command);
+}
+export function didMutatingToolFail(text) {
+  const lowered = text.toLowerCase();
+  return MUTATING_FAILURE_HINTS.some((hint) => lowered.includes(hint));
+}
+export function nextLongRunningTrigger(config, metrics) {
+  if (metrics.now - metrics.startedAt >= config.activeNoticeAfterMs)
+    return "time_threshold";
+  if (config.activeNoticeAfterTurns !== undefined && metrics.turns >= config.activeNoticeAfterTurns)
+    return "turn_threshold";
+  if (config.activeNoticeAfterTokens !== undefined && metrics.tokens >= config.activeNoticeAfterTokens)
+    return "token_threshold";
+  return;
+}
+export function resetMutatingFailureState(state) {
+  state.consecutiveFailures = 0;
+  state.lastFailureAt = undefined;
+  state.recentFailures = [];
+  state.lastMutatingPath = undefined;
+  state.repeatedPathFailures = 0;
+}
+export function createMutatingFailureState() {
+  return {
+    consecutiveFailures: 0,
+    recentFailures: [],
+    repeatedPathFailures: 0
+  };
+}
+export function recordMutatingFailure(state, input, windowMs) {
+  if (state.lastFailureAt === undefined || input.ts - state.lastFailureAt > windowMs) {
+    state.consecutiveFailures = 0;
+    state.recentFailures = [];
+    state.repeatedPathFailures = 0;
+    state.lastMutatingPath = undefined;
+  }
+  state.lastFailureAt = input.ts;
+  state.consecutiveFailures += 1;
+  if (input.path && state.lastMutatingPath === input.path) {
+    state.repeatedPathFailures += 1;
+  } else if (input.path) {
+    state.lastMutatingPath = input.path;
+    state.repeatedPathFailures = 1;
+  }
+  state.recentFailures.push(input);
+  if (state.recentFailures.length > 3)
+    state.recentFailures.shift();
+}
+export function shouldEscalateMutatingFailures(state, threshold) {
+  return state.consecutiveFailures >= threshold || state.repeatedPathFailures >= threshold;
+}
+export function summarizeRecentMutatingFailures(state) {
+  if (state.recentFailures.length === 0)
+    return;
+  return state.recentFailures.map((entry) => `${entry.tool}${entry.path ? `(${entry.path})` : ""}: ${entry.error}`).join(" | ");
+}