@duckmind/dm-windows-x64 0.60.6 → 0.60.9

package/extensions/dm-subagents/src/agents/chain-serializer.js

@@ -1,12 +1,300 @@
-var l=/^[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*)*$/;function s($){let J=$?.trim();if(!J)return;return J.toLowerCase().replace(/\s+/g,"-").replace(/[^a-z0-9.-]/g,"").replace(/-+/g,"-").replace(/\.+/g,".").replace(/(?:^[-.]+|[-.]+$)/g,"")}function I($,J="package"){if($===void 0||$===!1||$==="")return{packageName:void 0};if(typeof $!=="string")return{error:`${J} must be a string or false when provided.`};let B=s($);if(!B||!l.test(B))return{error:`${J} is invalid after sanitization.`};return{packageName:B}}function L($,J){let B=J?.trim();return B?`${B}.${$}`:$}function D($){if($.localName)return $.localName;if($.packageName&&$.name.startsWith(`${$.packageName}.`))return $.name.slice($.packageName.length+1);return $.name}function P($){return $.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function x($){let J={},B=$.replace(/\r\n/g,`
-`);if(!B.startsWith("---"))return{frontmatter:J,body:B};let j=B.indexOf(`
----`,3);if(j===-1)return{frontmatter:J,body:B};let Q=B.slice(4,j),W=B.slice(j+4).trim(),U=Q.split(`
-`),Z=null,Y=null,G=null;for(let X of U){let q=X.search(/\S|$/),A=X.trim();if(Z!==null&&Y!==null&&q>(G??0)){Y.push(X);continue}if(Z!==null&&Y!==null){let z=Y.join(`
-`),R=z.match(/^([ \t]+)/m)?.[1]??"",w=R?z.replace(new RegExp(`^${P(R)}`,"gm"),"").replace(/^\n/,""):z;J[Z]=w,Z=null,Y=null,G=null}let V=X.match(/^([\w-]+):\s*(.*)$/);if(V){let z=V[2].trim();if(z.startsWith('"')&&z.endsWith('"')||z.startsWith("'")&&z.endsWith("'"))z=z.slice(1,-1);if(z==="")Z=V[1],Y=[],G=q;else J[V[1]]=z}}if(Z!==null&&Y!==null){let X=Y.join(`
-`),A=X.match(/^([ \t]+)/m)?.[1]??"",V=A?X.replace(new RegExp(`^${P(A)}`,"gm"),"").replace(/^\n/,""):X;J[Z]=V}return{frontmatter:J,body:W}}import*as O from"node:os";import*as M from"node:path";function E($){return $.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function i($){let J=$?.env??process.env,B=$&&Object.hasOwn($,"getuid")?$.getuid:process.getuid?.bind(process);if(typeof B==="function")return`uid-${B()}`;for(let U of["USERNAME","USER","LOGNAME"]){let Z=J[U];if(Z)return`user-${E(Z)}`}let j=$&&Object.hasOwn($,"userInfo")?$.userInfo:O.userInfo;try{let U=j?.().username;if(U)return`user-${E(U)}`}catch{}let Q=J.USERPROFILE??J.HOME;if(Q)return`home-${E(Q)}`;let W=$&&Object.hasOwn($,"homedir")?$.homedir:O.homedir;try{let U=W?.();if(U)return`home-${E(U)}`}catch{}return"shared"}var S=M.join(O.tmpdir(),`dm-subagents-${i()}`),x$=M.join(S,"async-subagent-results"),k$=M.join(S,"async-subagent-runs"),a=M.join(S,"chain-runs"),g$=M.join(S,"artifacts");function C($){return"parallel"in $&&Array.isArray($.parallel)}function K($){return"expand"in $&&"collect"in $&&"parallel"in $&&!Array.isArray($.parallel)}import{Compile as p$}from"typebox/compile";class _ extends Error{}var t=/^[A-Za-z_][A-Za-z0-9_]*$/,e=/^[A-Za-z_][A-Za-z0-9_]*$/,f=/\{([A-Za-z_][A-Za-z0-9_]*)(?:\.([^{}]+))?\}/g,$$=new Set(["task","previous","chain_dir","outputs"]),v=new Set(["expand","parallel","collect","concurrency","failFast","phase","label","acceptance"]),B$=new Set([...v,"effectiveAcceptance","sessionFiles","thinkingOverrides"]),J$=new Set(["from","item","key","maxItems","onEmpty"]),j$=new Set(["output","path"]),h=new Set(["agent","task","phase","label","outputSchema","cwd","output","outputMode","reads","progress","skill","model","toolBudget","acceptance"]),U$=new Set([...h,"outputName","structured","inheritProjectContext","inheritSkills","skills","outputPath","maxSubagentDepth","structuredOutput","structuredOutputSchema","tools","extensions","subagentOnlyExtensions","mcpDirectTools","completionGuard","systemPrompt","systemPromptMode","thinking","modelCandidates","sessionFile","effectiveAcceptance","parentSessionId"]),Q$=new Set(["as","outputSchema"]);function k($){return t.test($)}function g($,J){if($==="")return;if(!$.startsWith("/"))throw new _(`${J} must be a JSON Pointer starting with '/'.`);for(let B of $.slice(1).split("/"))if(/~(?![01])/.test(B))throw new _(`${J} contains invalid JSON Pointer escape.`)}function T($,J,B){if(!$||typeof $!=="object"||Array.isArray($))throw new _(`${B} must be an object.`);for(let j of Object.keys($))if(!J.has(j))throw new _(`${B} does not support field '${j}'.`)}function Z$($,J,B){for(let j of $.matchAll(/\{([^{}]*)\}/g)){let Q=j[0],W=j[1];if(W===J||W.startsWith(`${J}.`)){if(!f.test(Q)||W===`${J}.`||W.includes(".."))throw new _(`Invalid item reference '${Q}' in ${B}.`);f.lastIndex=0;continue}f.lastIndex=0;let U=W.match(/^[A-Za-z_][A-Za-z0-9_]*/)?.[0];if(U===J)throw new _(`Invalid item reference '${Q}' in ${B}.`);if(U&&$$.has(U))continue;if(U)throw new _(`Unsupported template reference '${Q}' in ${B}.`)}if(f.lastIndex=0,$.includes(`{${J}.}`)||new RegExp(`\\{${J}(?:\\.|$)[^}]*$`).test($))throw new _(`Invalid item reference in ${B}.`)}function m($){return!!$&&typeof $==="object"&&!Array.isArray($)&&(Object.prototype.hasOwnProperty.call($,"expand")||Object.prototype.hasOwnProperty.call($,"collect"))}function d($,J,B={}){let j=`Dynamic chain step ${J+1}`;if(T($,B.allowRunnerFields?B$:v,j),!$.expand||!$.expand.from)throw new _(`${j} requires expand.from.`);if(T($.expand,J$,`${j} expand`),T($.expand.from,j$,`${j} expand.from`),!k($.expand.from.output))throw new _(`${j} has invalid expand.from.output '${$.expand.from.output}'.`);if(g($.expand.from.path,`${j} expand.from.path`),$.expand.key!==void 0)g($.expand.key,`${j} expand.key`);let Q=$.expand.item??"item";if(!e.test(Q))throw new _(`${j} has invalid expand.item '${Q}'.`);if($.expand.maxItems===void 0&&B.maxItems===void 0)throw new _(`${j} requires expand.maxItems or config.chain.dynamicFanout.maxItems.`);if($.expand.maxItems!==void 0&&(!Number.isInteger($.expand.maxItems)||$.expand.maxItems<0))throw new _(`${j} expand.maxItems must be an integer >= 0.`);if(B.maxItems!==void 0&&(!Number.isInteger(B.maxItems)||B.maxItems<0))throw new _("config.chain.dynamicFanout.maxItems must be an integer >= 0.");if(!$.parallel||Array.isArray($.parallel))throw new _(`${j} requires a single parallel template object and cannot mix dynamic expand/collect with static parallel arrays.`);if(T($.parallel,B.allowRunnerFields?U$:h,`${j} parallel`),"expand"in $.parallel)throw new _(`${j} does not support nested dynamic fanout.`);if(!$.parallel.agent)throw new _(`${j} parallel.agent is required.`);if(!$.collect?.as||!k($.collect.as))throw new _(`${j} requires collect.as with a safe output name.`);T($.collect,Q$,`${j} collect`);for(let[W,U]of[["parallel.task",$.parallel.task],["parallel.label",$.parallel.label]])if(U)Z$(U,Q,`${j} ${W}`)}var W$=/\{outputs\.([^}]*)\}/g,u=/^[A-Za-z_][A-Za-z0-9_]*$/;class H extends Error{}function c($){if(C($))return $.parallel.map((B)=>B.as).filter((B)=>Boolean(B));if(K($))return[$.collect.as];let J=$.as;return J?[J]:[]}function X$($){if(C($))return $.parallel.map((J)=>J.task??"{previous}");if(K($))return[$.parallel.task??"{previous}",$.parallel.label??""].filter(Boolean);return[$.task??"{previous}"]}function o($,J={}){Y$($,J)}function Y$($,J={},B={}){let j=[...B.priorOutputNames??[]],Q=new Set(j),W=new Set(j);for(let U=0;U<$.length;U++){let Z=(B.startStepIndex??0)+U+1,Y=$[U];if(m(Y)){if(!K(Y))throw new H(`Dynamic chain step ${Z} requires expand, a single parallel template object, and collect; dynamic expand/collect cannot be mixed with static parallel arrays.`);try{d(Y,Z-1,J)}catch(G){if(G instanceof _)throw new H(G.message);throw G}if(!Q.has(Y.expand.from.output))throw new H(`Dynamic chain step ${Z} references unknown output '${Y.expand.from.output}'. Named outputs are only available after producing step/group completes.`)}for(let G of c(Y)){if(!u.test(G))throw new H(`Invalid chain output name '${G}' at step ${Z}. Use /^[A-Za-z_][A-Za-z0-9_]*$/.`);if(W.has(G))throw new H(`Duplicate chain output name '${G}'. Each as name must be unique.`);W.add(G)}for(let G of X$(Y))for(let X of G.matchAll(W$)){let q=X[0],A=X[1];if(!u.test(A))throw new H(`Invalid chain output reference '${q}' at step ${Z}. Use {outputs.name} with /^[A-Za-z_][A-Za-z0-9_]*$/ names.`);if(!Q.has(A))throw new H(`Unknown chain output reference '${q}' at step ${Z}. Named outputs are only available after producing step/group completes.`)}for(let G of c(Y))Q.add(G)}}var n=new Set(["auto","none","attested","checked","verified","reviewed"]),p=new Set(["changed-files","tests-added","commands-run","validation-output","residual-risks","no-staged-files","diff-summary","review-findings","manual-notes"]),G$=new Set(["level","criteria","evidence","verify","review","stopRules","reason"]),q$=new Set(["id","must","evidence","severity"]),A$=new Set(["id","command","timeoutMs","cwd","env","allowFailure"]),_$=new Set(["agent","focus","required"]);function F($,J="acceptance"){let B=[];if($===void 0)return B;if($===!1)return B;if(typeof $==="string"){if(!n.has($))B.push(`${J} has invalid level '${$}'.`);return B}if(!$||typeof $!=="object"||Array.isArray($))return B.push(`${J} must be a string level, false, or an object.`),B;let j=$;for(let Q of Object.keys(j))if(!G$.has(Q))B.push(`${J}.${Q} is not supported.`);if(j.level!==void 0&&(typeof j.level!=="string"||!n.has(j.level)))B.push(`${J}.level must be one of auto, none, attested, checked, verified, reviewed.`);if(j.level==="none"&&(typeof j.reason!=="string"||!j.reason.trim()))B.push(`${J}.reason is required when level is none.`);if(j.reason!==void 0&&typeof j.reason!=="string")B.push(`${J}.reason must be a string.`);if(j.criteria!==void 0&&!Array.isArray(j.criteria))B.push(`${J}.criteria must be an array.`);if(Array.isArray(j.criteria))for(let[Q,W]of j.criteria.entries()){if(typeof W==="string")continue;let U=`${J}.criteria[${Q}]`;if(!W||typeof W!=="object"||Array.isArray(W)){B.push(`${U} must be a string or an object.`);continue}let Z=W;for(let Y of Object.keys(Z))if(!q$.has(Y))B.push(`${U}.${Y} is not supported.`);if(typeof Z.id!=="string"||!Z.id.trim())B.push(`${U}.id is required.`);if(typeof Z.must!=="string"||!Z.must.trim())B.push(`${U}.must is required.`);if(Z.evidence!==void 0&&!Array.isArray(Z.evidence))B.push(`${U}.evidence must be an array.`);if(Array.isArray(Z.evidence)){for(let[Y,G]of Z.evidence.entries())if(typeof G!=="string"||!p.has(G))B.push(`${U}.evidence[${Y}] is not a supported evidence kind.`)}if(Z.severity!==void 0&&Z.severity!=="required"&&Z.severity!=="recommended")B.push(`${U}.severity must be required or recommended.`)}if(Array.isArray(j.evidence)){for(let[Q,W]of j.evidence.entries())if(typeof W!=="string"||!p.has(W))B.push(`${J}.evidence[${Q}] is not a supported evidence kind.`)}else if(j.evidence!==void 0)B.push(`${J}.evidence must be an array.`);if(j.verify!==void 0&&!Array.isArray(j.verify))B.push(`${J}.verify must be an array.`);if(Array.isArray(j.verify))for(let[Q,W]of j.verify.entries()){if(!W||typeof W!=="object"||Array.isArray(W)){B.push(`${J}.verify[${Q}] must be an object.`);continue}let U=W;for(let Z of Object.keys(U))if(!A$.has(Z))B.push(`${J}.verify[${Q}].${Z} is not supported.`);if(typeof U.id!=="string"||!U.id.trim())B.push(`${J}.verify[${Q}].id is required.`);if(typeof U.command!=="string"||!U.command.trim())B.push(`${J}.verify[${Q}].command is required.`);if(U.timeoutMs!==void 0&&(typeof U.timeoutMs!=="number"||!Number.isInteger(U.timeoutMs)||U.timeoutMs<1))B.push(`${J}.verify[${Q}].timeoutMs must be an integer >= 1.`);if(U.cwd!==void 0&&typeof U.cwd!=="string")B.push(`${J}.verify[${Q}].cwd must be a string.`);if(U.env!==void 0){if(!U.env||typeof U.env!=="object"||Array.isArray(U.env))B.push(`${J}.verify[${Q}].env must be an object.`);else for(let[Z,Y]of Object.entries(U.env))if(typeof Y!=="string")B.push(`${J}.verify[${Q}].env.${Z} must be a string.`)}if(U.allowFailure!==void 0&&typeof U.allowFailure!=="boolean")B.push(`${J}.verify[${Q}].allowFailure must be a boolean.`)}if(j.review!==void 0&&j.review!==!1)if(!j.review||typeof j.review!=="object"||Array.isArray(j.review))B.push(`${J}.review must be false or an object.`);else{let Q=j.review;for(let W of Object.keys(Q))if(!_$.has(W))B.push(`${J}.review.${W} is not supported.`);if(Q.agent!==void 0&&typeof Q.agent!=="string")B.push(`${J}.review.agent must be a string.`);if(Q.focus!==void 0&&typeof Q.focus!=="string")B.push(`${J}.review.focus must be a string.`);if(Q.required!==void 0&&typeof Q.required!=="boolean")B.push(`${J}.review.required must be a boolean.`)}if(j.stopRules!==void 0&&!Array.isArray(j.stopRules))B.push(`${J}.stopRules must be an array.`);if(Array.isArray(j.stopRules)){for(let[Q,W]of j.stopRules.entries())if(typeof W!=="string")B.push(`${J}.stopRules[${Q}] must be a string.`)}return B}var V$=["read","grep","find","ls"];function z$($){if($==="*")return"*";if($===void 0)return[...V$];return[...new Set($.map((J)=>J.trim()).filter(Boolean))]}function b($,J="toolBudget"){if($===void 0)return{};if(!$||typeof $!=="object"||Array.isArray($))return{error:`${J} must be an object with hard and optional soft/block.`};let B=$;if(typeof B.hard!=="number"||!Number.isInteger(B.hard)||B.hard<1)return{error:`${J}.hard must be an integer >= 1.`};if(B.soft!==void 0&&(typeof B.soft!=="number"||!Number.isInteger(B.soft)||B.soft<1))return{error:`${J}.soft must be an integer >= 1 when provided.`};if(B.soft!==void 0&&B.soft>B.hard)return{error:`${J}.soft must be <= ${J}.hard.`};if(B.block!==void 0&&B.block!=="*"){if(!Array.isArray(B.block))return{error:`${J}.block must be "*" or an array of tool names.`};if(B.block.length===0)return{error:`${J}.block must contain at least one tool name.`};for(let j of B.block)if(typeof j!=="string"||!j.trim())return{error:`${J}.block must contain non-empty tool names.`}}return{budget:{hard:B.hard,...B.soft!==void 0?{soft:B.soft}:{},block:z$(B.block)}}}function H$($,J){let B=J.split(`
-`),j=B.findIndex((Z)=>Z.trim()===""),Q=j===-1?B:B.slice(0,j),W=(j===-1?"":B.slice(j+1).join(`
-`)).trim(),U={agent:$,task:W};for(let Z of Q){let Y=Z.match(/^([\w-]+):\s*(.*)$/);if(!Y)continue;let G=Y[1].trim().toLowerCase(),X=Y[2].trim();if(G==="output"){if(X==="false")U.output=!1;else if(X)U.output=X;continue}if(G==="phase"){if(X)U.phase=X;continue}if(G==="label"){if(X)U.label=X;continue}if(G==="as"){if(X)U.as=X;continue}if(G==="outputschema"){if(X.startsWith("{")||X.startsWith("["))throw Error("Inline outputSchema values are not supported in .chain.md files; use a schema file path.");if(X)U.outputSchema=X;continue}if(G==="outputmode"){if(X==="inline"||X==="file-only")U.outputMode=X;continue}if(G==="reads"){if(X==="false")U.reads=!1;else{let q=X.split(",").map((A)=>A.trim()).filter(Boolean);U.reads=q.length>0?q:!1}continue}if(G==="model"){if(X)U.model=X;continue}if(G==="skills"){if(X==="false")U.skills=!1;else{let q=X.split(",").map((A)=>A.trim()).filter(Boolean);U.skills=q.length>0?q:!1}continue}if(G==="progress"){if(X==="true")U.progress=!0;else if(X==="false")U.progress=!1;continue}if(G==="toolbudget"){let q;try{q=JSON.parse(X)}catch(V){let z=V instanceof Error?V.message:String(V);throw Error(`Invalid toolBudget in .chain.md step '${$}': ${z}`)}let A=b(q,`toolBudget for step '${$}'`);if(A.error)throw Error(A.error);U.toolBudget=q}}return U}function YB($,J,B){let{frontmatter:j,body:Q}=x($);if(!j.name||!j.description)throw Error("Chain frontmatter must include name and description");let W=[...Q.matchAll(/^##\s+(.+)[^\S\n]*$/gm)],U=[];for(let q=0;q<W.length;q++){let A=W[q],V=A[1].trim(),z=Q[A.index+A[0].length]===`
-`?1:0,N=A.index+A[0].length+z,R=q+1<W.length?W[q+1].index:Q.length,w=Q.slice(N,R).trimEnd();U.push(H$(V,w))}let Z=j.name,Y=I(j.package,`Chain '${Z}' package`);if(Y.error)throw Error(Y.error);let G=Y.packageName,X={};for(let[q,A]of Object.entries(j)){if(q==="name"||q==="package"||q==="description")continue;X[q]=A}return{name:L(Z,G),localName:Z,packageName:G,description:j.description,source:J,filePath:B,steps:U,extraFields:Object.keys(X).length>0?X:void 0}}function y($,J){let B=b($,J);if(B.error)throw Error(B.error)}function GB($,J,B){let j;try{j=JSON.parse($)}catch(Z){let Y=Z instanceof Error?Z.message:String(Z);throw Error(`Invalid JSON chain '${B}': ${Y}`)}if(!j||typeof j!=="object"||Array.isArray(j))throw Error(`JSON chain '${B}' must contain an object root.`);let Q=j;if(typeof Q.name!=="string"||!Q.name.trim())throw Error(`JSON chain '${B}' must include string name.`);if(typeof Q.description!=="string"||!Q.description.trim())throw Error(`JSON chain '${B}' must include string description.`);if(!Array.isArray(Q.chain))throw Error(`JSON chain '${B}' must include array chain.`);for(let Z=0;Z<Q.chain.length;Z++){let Y=Q.chain[Z];if(!Y||typeof Y!=="object"||Array.isArray(Y))throw Error(`JSON chain '${B}' step ${Z+1} must be an object.`);let G=Y;if(G.toolBudget!==void 0)y(G.toolBudget,`step ${Z+1} toolBudget`);let X=F(G.acceptance,`step ${Z+1} acceptance`);if(X.length>0)throw Error(`Invalid JSON chain '${B}': ${X.join(" ")}`);let q=G.parallel;if(Array.isArray(q))for(let A=0;A<q.length;A++){let V=q[A];if(!V||typeof V!=="object"||Array.isArray(V))continue;let z=V;if(z.toolBudget!==void 0)y(z.toolBudget,`step ${Z+1} parallel task ${A+1} toolBudget`);let N=F(z.acceptance,`step ${Z+1} parallel task ${A+1} acceptance`);if(N.length>0)throw Error(`Invalid JSON chain '${B}': ${N.join(" ")}`)}else if(q&&typeof q==="object"){let A=q;if(A.toolBudget!==void 0)y(A.toolBudget,`step ${Z+1} dynamic template toolBudget`);let V=F(A.acceptance,`step ${Z+1} dynamic template acceptance`);if(V.length>0)throw Error(`Invalid JSON chain '${B}': ${V.join(" ")}`)}}try{o(Q.chain,{maxItems:Number.MAX_SAFE_INTEGER})}catch(Z){if(Z instanceof H)throw Error(`Invalid JSON chain '${B}': ${Z.message}`);throw Z}let W=I(typeof Q.package==="string"?Q.package:void 0,`Chain '${Q.name}' package`);if(W.error)throw Error(W.error);let U={};for(let[Z,Y]of Object.entries(Q)){if(Z==="name"||Z==="package"||Z==="description"||Z==="chain")continue;if(typeof Y==="string")U[Z]=Y}return{name:L(Q.name.trim(),W.packageName),localName:Q.name.trim(),packageName:W.packageName,description:Q.description.trim(),source:J,filePath:B,steps:Q.chain,extraFields:Object.keys(U).length>0?U:void 0}}function qB($){let J={name:D($),description:$.description,chain:$.steps};if($.packageName)J.package=$.packageName;if($.extraFields){for(let[B,j]of Object.entries($.extraFields))if(B!=="name"&&B!=="description"&&B!=="package"&&B!=="chain")J[B]=j}return`${JSON.stringify(J,null,2)}
-`}function AB($){let J=[];if(J.push("---"),J.push(`name: ${D($)}`),$.packageName)J.push(`package: ${$.packageName}`);if(J.push(`description: ${$.description}`),$.extraFields)for(let[B,j]of Object.entries($.extraFields))J.push(`${B}: ${j}`);J.push("---"),J.push("");for(let B=0;B<$.steps.length;B++){let j=$.steps[B];if(J.push(`## ${j.agent}`),j.output===!1)J.push("output: false");else if(j.output)J.push(`output: ${j.output}`);if(j.phase)J.push(`phase: ${j.phase}`);if(j.label)J.push(`label: ${j.label}`);if(j.as)J.push(`as: ${j.as}`);if(j.outputSchema)J.push(`outputSchema: ${j.outputSchema}`);if(j.outputMode)J.push(`outputMode: ${j.outputMode}`);if(j.reads===!1)J.push("reads: false");else if(Array.isArray(j.reads)&&j.reads.length>0)J.push(`reads: ${j.reads.join(", ")}`);if(j.model)J.push(`model: ${j.model}`);if(j.skills===!1)J.push("skills: false");else if(Array.isArray(j.skills)&&j.skills.length>0)J.push(`skills: ${j.skills.join(", ")}`);if(j.progress!==void 0)J.push(`progress: ${j.progress?"true":"false"}`);if(j.toolBudget!==void 0)J.push(`toolBudget: ${JSON.stringify(j.toolBudget)}`);if(J.push(""),J.push(j.task??""),B<$.steps.length-1)J.push("")}return`${J.join(`
+import { buildRuntimeName, frontmatterNameForConfig, parsePackageName } from "./identity.js";
+import { parseFrontmatter } from "./frontmatter.js";
+import { ChainOutputValidationError, validateChainOutputBindings } from "../runs/shared/chain-outputs.js";
+import { validateAcceptanceInput } from "../runs/shared/acceptance.js";
+import { validateToolBudgetConfig } from "../runs/shared/tool-budget.js";
+function parseStepBody(agent, sectionBody) {
+  const lines = sectionBody.split(`
+`);
+  const blankIndex = lines.findIndex((line) => line.trim() === "");
+  const configLines = blankIndex === -1 ? lines : lines.slice(0, blankIndex);
+  const task = (blankIndex === -1 ? "" : lines.slice(blankIndex + 1).join(`
+`)).trim();
+  const step = { agent, task };
+  for (const line of configLines) {
+    const match = line.match(/^([\w-]+):\s*(.*)$/);
+    if (!match)
+      continue;
+    const key = match[1].trim().toLowerCase();
+    const rawValue = match[2].trim();
+    if (key === "output") {
+      if (rawValue === "false")
+        step.output = false;
+      else if (rawValue)
+        step.output = rawValue;
+      continue;
+    }
+    if (key === "phase") {
+      if (rawValue)
+        step.phase = rawValue;
+      continue;
+    }
+    if (key === "label") {
+      if (rawValue)
+        step.label = rawValue;
+      continue;
+    }
+    if (key === "as") {
+      if (rawValue)
+        step.as = rawValue;
+      continue;
+    }
+    if (key === "outputschema") {
+      if (rawValue.startsWith("{") || rawValue.startsWith("[")) {
+        throw new Error("Inline outputSchema values are not supported in .chain.md files; use a schema file path.");
+      }
+      if (rawValue)
+        step.outputSchema = rawValue;
+      continue;
+    }
+    if (key === "outputmode") {
+      if (rawValue === "inline" || rawValue === "file-only")
+        step.outputMode = rawValue;
+      continue;
+    }
+    if (key === "reads") {
+      if (rawValue === "false") {
+        step.reads = false;
+      } else {
+        const reads = rawValue.split(",").map((v) => v.trim()).filter(Boolean);
+        step.reads = reads.length > 0 ? reads : false;
+      }
+      continue;
+    }
+    if (key === "model") {
+      if (rawValue)
+        step.model = rawValue;
+      continue;
+    }
+    if (key === "skills") {
+      if (rawValue === "false") {
+        step.skills = false;
+      } else {
+        const skills = rawValue.split(",").map((v) => v.trim()).filter(Boolean);
+        step.skills = skills.length > 0 ? skills : false;
+      }
+      continue;
+    }
+    if (key === "progress") {
+      if (rawValue === "true")
+        step.progress = true;
+      else if (rawValue === "false")
+        step.progress = false;
+      continue;
+    }
+    if (key === "toolbudget") {
+      let parsed;
+      try {
+        parsed = JSON.parse(rawValue);
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid toolBudget in .chain.md step '${agent}': ${message}`);
+      }
+      const validation = validateToolBudgetConfig(parsed, `toolBudget for step '${agent}'`);
+      if (validation.error)
+        throw new Error(validation.error);
+      step.toolBudget = parsed;
+    }
+  }
+  return step;
+}
+export function parseChain(content, source, filePath) {
+  const { frontmatter, body } = parseFrontmatter(content);
+  if (!frontmatter.name || !frontmatter.description) {
+    throw new Error("Chain frontmatter must include name and description");
+  }
+  const matches = [...body.matchAll(/^##\s+(.+)[^\S\n]*$/gm)];
+  const steps = [];
+  for (let i = 0;i < matches.length; i++) {
+    const match = matches[i];
+    const agent = match[1].trim();
+    const lineEndOffset = body[match.index + match[0].length] === `
+` ? 1 : 0;
+    const sectionStart = match.index + match[0].length + lineEndOffset;
+    const sectionEnd = i + 1 < matches.length ? matches[i + 1].index : body.length;
+    const sectionBody = body.slice(sectionStart, sectionEnd).trimEnd();
+    steps.push(parseStepBody(agent, sectionBody));
+  }
+  const localName = frontmatter.name;
+  const parsedPackage = parsePackageName(frontmatter.package, `Chain '${localName}' package`);
+  if (parsedPackage.error)
+    throw new Error(parsedPackage.error);
+  const packageName = parsedPackage.packageName;
+  const extraFields = {};
+  for (const [key, value] of Object.entries(frontmatter)) {
+    if (key === "name" || key === "package" || key === "description")
+      continue;
+    extraFields[key] = value;
+  }
+  return {
+    name: buildRuntimeName(localName, packageName),
+    localName,
+    packageName,
+    description: frontmatter.description,
+    source,
+    filePath,
+    steps,
+    extraFields: Object.keys(extraFields).length > 0 ? extraFields : undefined
+  };
+}
+function validateJsonChainToolBudget(value, label) {
+  const validation = validateToolBudgetConfig(value, label);
+  if (validation.error)
+    throw new Error(validation.error);
+}
+export function parseJsonChain(content, source, filePath) {
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid JSON chain '${filePath}': ${message}`);
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`JSON chain '${filePath}' must contain an object root.`);
+  }
+  const input = parsed;
+  if (typeof input.name !== "string" || !input.name.trim()) {
+    throw new Error(`JSON chain '${filePath}' must include string name.`);
+  }
+  if (typeof input.description !== "string" || !input.description.trim()) {
+    throw new Error(`JSON chain '${filePath}' must include string description.`);
+  }
+  if (!Array.isArray(input.chain)) {
+    throw new Error(`JSON chain '${filePath}' must include array chain.`);
+  }
+  for (let i = 0;i < input.chain.length; i++) {
+    const step = input.chain[i];
+    if (!step || typeof step !== "object" || Array.isArray(step)) {
+      throw new Error(`JSON chain '${filePath}' step ${i + 1} must be an object.`);
+    }
+    const stepRecord = step;
+    if (stepRecord.toolBudget !== undefined)
+      validateJsonChainToolBudget(stepRecord.toolBudget, `step ${i + 1} toolBudget`);
+    const acceptanceErrors = validateAcceptanceInput(stepRecord.acceptance, `step ${i + 1} acceptance`);
+    if (acceptanceErrors.length > 0) {
+      throw new Error(`Invalid JSON chain '${filePath}': ${acceptanceErrors.join(" ")}`);
+    }
+    const parallel = stepRecord.parallel;
+    if (Array.isArray(parallel)) {
+      for (let taskIndex = 0;taskIndex < parallel.length; taskIndex++) {
+        const task = parallel[taskIndex];
+        if (!task || typeof task !== "object" || Array.isArray(task))
+          continue;
+        const taskRecord = task;
+        if (taskRecord.toolBudget !== undefined)
+          validateJsonChainToolBudget(taskRecord.toolBudget, `step ${i + 1} parallel task ${taskIndex + 1} toolBudget`);
+        const taskErrors = validateAcceptanceInput(taskRecord.acceptance, `step ${i + 1} parallel task ${taskIndex + 1} acceptance`);
+        if (taskErrors.length > 0) {
+          throw new Error(`Invalid JSON chain '${filePath}': ${taskErrors.join(" ")}`);
+        }
+      }
+    } else if (parallel && typeof parallel === "object") {
+      const parallelRecord = parallel;
+      if (parallelRecord.toolBudget !== undefined)
+        validateJsonChainToolBudget(parallelRecord.toolBudget, `step ${i + 1} dynamic template toolBudget`);
+      const templateErrors = validateAcceptanceInput(parallelRecord.acceptance, `step ${i + 1} dynamic template acceptance`);
+      if (templateErrors.length > 0) {
+        throw new Error(`Invalid JSON chain '${filePath}': ${templateErrors.join(" ")}`);
+      }
+    }
+  }
+  try {
+    validateChainOutputBindings(input.chain, { maxItems: Number.MAX_SAFE_INTEGER });
+  } catch (error) {
+    if (error instanceof ChainOutputValidationError)
+      throw new Error(`Invalid JSON chain '${filePath}': ${error.message}`);
+    throw error;
+  }
+  const parsedPackage = parsePackageName(typeof input.package === "string" ? input.package : undefined, `Chain '${input.name}' package`);
+  if (parsedPackage.error)
+    throw new Error(parsedPackage.error);
+  const extraFields = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (key === "name" || key === "package" || key === "description" || key === "chain")
+      continue;
+    if (typeof value === "string")
+      extraFields[key] = value;
+  }
+  return {
+    name: buildRuntimeName(input.name.trim(), parsedPackage.packageName),
+    localName: input.name.trim(),
+    packageName: parsedPackage.packageName,
+    description: input.description.trim(),
+    source,
+    filePath,
+    steps: input.chain,
+    extraFields: Object.keys(extraFields).length > 0 ? extraFields : undefined
+  };
+}
+export function serializeJsonChain(config) {
+  const root = {
+    name: frontmatterNameForConfig(config),
+    description: config.description,
+    chain: config.steps
+  };
+  if (config.packageName)
+    root.package = config.packageName;
+  if (config.extraFields) {
+    for (const [key, value] of Object.entries(config.extraFields)) {
+      if (key !== "name" && key !== "description" && key !== "package" && key !== "chain")
+        root[key] = value;
+    }
+  }
+  return `${JSON.stringify(root, null, 2)}
+`;
+}
+export function serializeChain(config) {
+  const lines = [];
+  lines.push("---");
+  lines.push(`name: ${frontmatterNameForConfig(config)}`);
+  if (config.packageName)
+    lines.push(`package: ${config.packageName}`);
+  lines.push(`description: ${config.description}`);
+  if (config.extraFields) {
+    for (const [key, value] of Object.entries(config.extraFields)) {
+      lines.push(`${key}: ${value}`);
+    }
+  }
+  lines.push("---");
+  lines.push("");
+  for (let i = 0;i < config.steps.length; i++) {
+    const step = config.steps[i];
+    lines.push(`## ${step.agent}`);
+    if (step.output === false)
+      lines.push("output: false");
+    else if (step.output)
+      lines.push(`output: ${step.output}`);
+    if (step.phase)
+      lines.push(`phase: ${step.phase}`);
+    if (step.label)
+      lines.push(`label: ${step.label}`);
+    if (step.as)
+      lines.push(`as: ${step.as}`);
+    if (step.outputSchema)
+      lines.push(`outputSchema: ${step.outputSchema}`);
+    if (step.outputMode)
+      lines.push(`outputMode: ${step.outputMode}`);
+    if (step.reads === false)
+      lines.push("reads: false");
+    else if (Array.isArray(step.reads) && step.reads.length > 0)
+      lines.push(`reads: ${step.reads.join(", ")}`);
+    if (step.model)
+      lines.push(`model: ${step.model}`);
+    if (step.skills === false)
+      lines.push("skills: false");
+    else if (Array.isArray(step.skills) && step.skills.length > 0)
+      lines.push(`skills: ${step.skills.join(", ")}`);
+    if (step.progress !== undefined)
+      lines.push(`progress: ${step.progress ? "true" : "false"}`);
+    if (step.toolBudget !== undefined)
+      lines.push(`toolBudget: ${JSON.stringify(step.toolBudget)}`);
+    lines.push("");
+    lines.push(step.task ?? "");
+    if (i < config.steps.length - 1)
+      lines.push("");
+  }
+  return `${lines.join(`
 `)}
-`}export{qB as serializeJsonChain,AB as serializeChain,GB as parseJsonChain,YB as parseChain};
+`;
+}

package/extensions/dm-subagents/src/agents/frontmatter.js

@@ -1,6 +1,65 @@
-function Q(H){return H.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function X(H){let D={},E=H.replace(/\r\n/g,`
-`);if(!E.startsWith("---"))return{frontmatter:D,body:E};let J=E.indexOf(`
----`,3);if(J===-1)return{frontmatter:D,body:E};let S=E.slice(4,J),T=E.slice(J+4).trim(),U=S.split(`
-`),C=null,q=null,M=null;for(let A of U){let N=A.search(/\S|$/),O=A.trim();if(C!==null&&q!==null&&N>(M??0)){q.push(A);continue}if(C!==null&&q!==null){let j=q.join(`
-`),P=j.match(/^([ \t]+)/m)?.[1]??"",V=P?j.replace(new RegExp(`^${Q(P)}`,"gm"),"").replace(/^\n/,""):j;D[C]=V,C=null,q=null,M=null}let G=A.match(/^([\w-]+):\s*(.*)$/);if(G){let j=G[2].trim();if(j.startsWith('"')&&j.endsWith('"')||j.startsWith("'")&&j.endsWith("'"))j=j.slice(1,-1);if(j==="")C=G[1],q=[],M=N;else D[G[1]]=j}}if(C!==null&&q!==null){let A=q.join(`
-`),O=A.match(/^([ \t]+)/m)?.[1]??"",G=O?A.replace(new RegExp(`^${Q(O)}`,"gm"),"").replace(/^\n/,""):A;D[C]=G}return{frontmatter:D,body:T}}export{X as parseFrontmatter};
+function escapeRegex(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function parseFrontmatter(content) {
+  const frontmatter = {};
+  const normalized = content.replace(/\r\n/g, `
+`);
+  if (!normalized.startsWith("---")) {
+    return { frontmatter, body: normalized };
+  }
+  const endIndex = normalized.indexOf(`
+---`, 3);
+  if (endIndex === -1) {
+    return { frontmatter, body: normalized };
+  }
+  const frontmatterBlock = normalized.slice(4, endIndex);
+  const body = normalized.slice(endIndex + 4).trim();
+  const lines = frontmatterBlock.split(`
+`);
+  let currentKey = null;
+  let currentBlockLines = null;
+  let currentIndent = null;
+  for (const line of lines) {
+    const indent = line.search(/\S|$/);
+    const trimmed = line.trim();
+    if (currentKey !== null && currentBlockLines !== null && indent > (currentIndent ?? 0)) {
+      currentBlockLines.push(line);
+      continue;
+    }
+    if (currentKey !== null && currentBlockLines !== null) {
+      const rawBlock = currentBlockLines.join(`
+`);
+      const leadingSpaces = rawBlock.match(/^([ \t]+)/m);
+      const prefix = leadingSpaces?.[1] ?? "";
+      const stripped = prefix ? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, "gm"), "").replace(/^\n/, "") : rawBlock;
+      frontmatter[currentKey] = stripped;
+      currentKey = null;
+      currentBlockLines = null;
+      currentIndent = null;
+    }
+    const match = line.match(/^([\w-]+):\s*(.*)$/);
+    if (match) {
+      let value = match[2].trim();
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        value = value.slice(1, -1);
+      }
+      if (value === "") {
+        currentKey = match[1];
+        currentBlockLines = [];
+        currentIndent = indent;
+      } else {
+        frontmatter[match[1]] = value;
+      }
+    }
+  }
+  if (currentKey !== null && currentBlockLines !== null) {
+    const rawBlock = currentBlockLines.join(`
+`);
+    const leadingSpaces = rawBlock.match(/^([ \t]+)/m);
+    const prefix = leadingSpaces?.[1] ?? "";
+    const stripped = prefix ? rawBlock.replace(new RegExp(`^${escapeRegex(prefix)}`, "gm"), "").replace(/^\n/, "") : rawBlock;
+    frontmatter[currentKey] = stripped;
+  }
+  return { frontmatter, body };
+}

package/extensions/dm-subagents/src/agents/identity.js

@@ -1 +1,29 @@
-var n=/^[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*)*$/;function t(e){let r=e?.trim();if(!r)return;return r.toLowerCase().replace(/\s+/g,"-").replace(/[^a-z0-9.-]/g,"").replace(/-+/g,"-").replace(/\.+/g,".").replace(/(?:^[-.]+|[-.]+$)/g,"")}function i(e,r="package"){if(e===void 0||e===!1||e==="")return{packageName:void 0};if(typeof e!=="string")return{error:`${r} must be a string or false when provided.`};let a=t(e);if(!a||!n.test(a))return{error:`${r} is invalid after sanitization.`};return{packageName:a}}function m(e,r){let a=r?.trim();return a?`${a}.${e}`:e}function g(e){if(e.localName)return e.localName;if(e.packageName&&e.name.startsWith(`${e.packageName}.`))return e.name.slice(e.packageName.length+1);return e.name}export{i as parsePackageName,g as frontmatterNameForConfig,m as buildRuntimeName};
+const IDENTIFIER_PATTERN = /^[a-z0-9][a-z0-9-]*(?:\.[a-z0-9][a-z0-9-]*)*$/;
+function normalizePackageName(value) {
+  const trimmed = value?.trim();
+  if (!trimmed)
+    return;
+  return trimmed.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9.-]/g, "").replace(/-+/g, "-").replace(/\.+/g, ".").replace(/(?:^[-.]+|[-.]+$)/g, "");
+}
+export function parsePackageName(value, label = "package") {
+  if (value === undefined || value === false || value === "")
+    return { packageName: undefined };
+  if (typeof value !== "string")
+    return { error: `${label} must be a string or false when provided.` };
+  const packageName = normalizePackageName(value);
+  if (!packageName || !IDENTIFIER_PATTERN.test(packageName))
+    return { error: `${label} is invalid after sanitization.` };
+  return { packageName };
+}
+export function buildRuntimeName(localName, packageName) {
+  const trimmedPackage = packageName?.trim();
+  return trimmedPackage ? `${trimmedPackage}.${localName}` : localName;
+}
+export function frontmatterNameForConfig(config) {
+  if (config.localName)
+    return config.localName;
+  if (config.packageName && config.name.startsWith(`${config.packageName}.`)) {
+    return config.name.slice(config.packageName.length + 1);
+  }
+  return config.name;
+}

package/extensions/dm-subagents/src/agents/proactive-skills.js

@@ -1 +1,141 @@
-var Z=["reviewer","context-builder","delegate"];function V(j){if(typeof j!=="number")return;if(!Number.isInteger(j)||!Number.isFinite(j)||j<1)return;return j}function X(j){if(j===!1)return{enabled:!1,minReferences:2,maxRecommendations:3,preferredAgent:"reviewer"};let q=V(j?.maxRecommendations)??3;return{enabled:j?.enabled??!0,minReferences:V(j?.minReferences)??2,maxRecommendations:Math.min(q,5),preferredAgent:typeof j?.preferredAgent==="string"&&j.preferredAgent.trim()?j.preferredAgent.trim():"reviewer"}}function $(j){if(j===!1||j===!0||j===void 0||j===null)return[];if(Array.isArray(j))return[...new Set(j.filter((q)=>typeof q==="string").map((q)=>q.trim()).filter(Boolean))];if(typeof j==="string")return[...new Set(j.split(",").map((q)=>q.trim()).filter(Boolean))];return[]}function U(j,q){for(let w of $(j.skills??j.skill))q.add(w);let I=j.parallel;if(!I)return;if(Array.isArray(I)){for(let w of I)if(w&&typeof w==="object"&&!Array.isArray(w))U(w,q);return}if(typeof I==="object")U(I,q)}function z(j,q){let I=j.filter((w)=>!w.disabled);if(I.some((w)=>w.name===q))return q;for(let w of Z)if(I.some((M)=>M.name===w))return w;return I[0]?.name}function W(j,q,I){if(q==="dm-subagents")return;let w=j.get(q)??new Set;w.add(I),j.set(q,w)}function C(j){let q=X(j.config);if(!q.enabled)return[];let I=z(j.agents,q.preferredAgent);if(!I)return[];let w=j.availableSkills?new Map(j.availableSkills.map((H)=>[H.name,H])):void 0,M=new Map;for(let H of j.agents){if(H.disabled)continue;for(let J of H.skills??[])W(M,J,`agent:${H.name}`)}for(let H of j.chains??[]){let J=new Set;for(let Q of H.steps)U(Q,J);for(let Q of J)W(M,Q,`chain:${H.name}`)}return[...M.entries()].filter(([H,J])=>J.size>=q.minReferences&&(!w||w.has(H))).map(([H,J])=>({skill:H,agent:I,references:J.size,sources:[...J].sort((Q,Y)=>Q.localeCompare(Y)),description:w?.get(H)?.description,reason:`referenced by ${J.size} configured agents/chains`})).sort((H,J)=>J.references-H.references||H.skill.localeCompare(J.skill)).slice(0,q.maxRecommendations)}function D(j){if(j.length===0)return[];return["Proactive skill subagent suggestions:",...j.map((q)=>{let I=q.sources.slice(0,3).join(", "),w=q.sources.length>3?`, +${q.sources.length-3} more`:"",M=q.description?` - ${q.description}`:"";return`- ${q.skill} via ${q.agent} (${q.reason}; ${I}${w})${M}`}),"Guardrails: use these for broad tasks where a skill-specialist pass is useful; keep fanout small, use fresh context unless private/session context is explicitly needed, and skip when the user asks for a direct answer."]}function F(j){if(!X(j.config).enabled)return[];let q;try{q=j.discoverAvailableSkills()}catch{q=[]}return D(C({agents:j.agents,chains:j.chains,availableSkills:q,config:j.config}))}export{X as resolveProactiveSkillSubagentsConfig,C as recommendProactiveSkillSubagents,D as formatProactiveSkillSubagentRecommendations,F as buildProactiveSkillSubagentRecommendationLines};
+const SUBAGENT_ORCHESTRATION_SKILL = "dm-subagents";
+const DEFAULT_MIN_REFERENCES = 2;
+const DEFAULT_MAX_RECOMMENDATIONS = 3;
+const DEFAULT_PREFERRED_AGENT = "reviewer";
+const FALLBACK_AGENT_ORDER = ["reviewer", "context-builder", "delegate"];
+const MAX_RECOMMENDATION_CAP = 5;
+function positiveInteger(value) {
+  if (typeof value !== "number")
+    return;
+  if (!Number.isInteger(value) || !Number.isFinite(value) || value < 1)
+    return;
+  return value;
+}
+export function resolveProactiveSkillSubagentsConfig(config) {
+  if (config === false) {
+    return {
+      enabled: false,
+      minReferences: DEFAULT_MIN_REFERENCES,
+      maxRecommendations: DEFAULT_MAX_RECOMMENDATIONS,
+      preferredAgent: DEFAULT_PREFERRED_AGENT
+    };
+  }
+  const maxRecommendations = positiveInteger(config?.maxRecommendations) ?? DEFAULT_MAX_RECOMMENDATIONS;
+  return {
+    enabled: config?.enabled ?? true,
+    minReferences: positiveInteger(config?.minReferences) ?? DEFAULT_MIN_REFERENCES,
+    maxRecommendations: Math.min(maxRecommendations, MAX_RECOMMENDATION_CAP),
+    preferredAgent: typeof config?.preferredAgent === "string" && config.preferredAgent.trim() ? config.preferredAgent.trim() : DEFAULT_PREFERRED_AGENT
+  };
+}
+function normalizeSkillNames(value) {
+  if (value === false || value === true || value === undefined || value === null)
+    return [];
+  if (Array.isArray(value)) {
+    return [...new Set(value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean))];
+  }
+  if (typeof value === "string") {
+    return [...new Set(value.split(",").map((entry) => entry.trim()).filter(Boolean))];
+  }
+  return [];
+}
+function collectStepSkills(step, out) {
+  for (const skill of normalizeSkillNames(step.skills ?? step.skill)) {
+    out.add(skill);
+  }
+  const parallel = step.parallel;
+  if (!parallel)
+    return;
+  if (Array.isArray(parallel)) {
+    for (const child of parallel) {
+      if (child && typeof child === "object" && !Array.isArray(child)) {
+        collectStepSkills(child, out);
+      }
+    }
+    return;
+  }
+  if (typeof parallel === "object") {
+    collectStepSkills(parallel, out);
+  }
+}
+function chooseRecommendationAgent(agents, preferredAgent) {
+  const enabled = agents.filter((agent) => !agent.disabled);
+  if (enabled.some((agent) => agent.name === preferredAgent))
+    return preferredAgent;
+  for (const name of FALLBACK_AGENT_ORDER) {
+    if (enabled.some((agent) => agent.name === name))
+      return name;
+  }
+  return enabled[0]?.name;
+}
+function addSource(counts, skill, source) {
+  if (skill === SUBAGENT_ORCHESTRATION_SKILL)
+    return;
+  const sources = counts.get(skill) ?? new Set;
+  sources.add(source);
+  counts.set(skill, sources);
+}
+export function recommendProactiveSkillSubagents(input) {
+  const config = resolveProactiveSkillSubagentsConfig(input.config);
+  if (!config.enabled)
+    return [];
+  const agent = chooseRecommendationAgent(input.agents, config.preferredAgent);
+  if (!agent)
+    return [];
+  const availableByName = input.availableSkills ? new Map(input.availableSkills.map((skill) => [skill.name, skill])) : undefined;
+  const counts = new Map;
+  for (const candidate of input.agents) {
+    if (candidate.disabled)
+      continue;
+    for (const skill of candidate.skills ?? []) {
+      addSource(counts, skill, `agent:${candidate.name}`);
+    }
+  }
+  for (const chain of input.chains ?? []) {
+    const chainSkills = new Set;
+    for (const step of chain.steps) {
+      collectStepSkills(step, chainSkills);
+    }
+    for (const skill of chainSkills) {
+      addSource(counts, skill, `chain:${chain.name}`);
+    }
+  }
+  return [...counts.entries()].filter(([skill, sources]) => sources.size >= config.minReferences && (!availableByName || availableByName.has(skill))).map(([skill, sources]) => ({
+    skill,
+    agent,
+    references: sources.size,
+    sources: [...sources].sort((a, b) => a.localeCompare(b)),
+    description: availableByName?.get(skill)?.description,
+    reason: `referenced by ${sources.size} configured agents/chains`
+  })).sort((a, b) => b.references - a.references || a.skill.localeCompare(b.skill)).slice(0, config.maxRecommendations);
+}
+export function formatProactiveSkillSubagentRecommendations(recommendations) {
+  if (recommendations.length === 0)
+    return [];
+  return [
+    "Proactive skill subagent suggestions:",
+    ...recommendations.map((recommendation) => {
+      const sampleSources = recommendation.sources.slice(0, 3).join(", ");
+      const extra = recommendation.sources.length > 3 ? `, +${recommendation.sources.length - 3} more` : "";
+      const description = recommendation.description ? ` - ${recommendation.description}` : "";
+      return `- ${recommendation.skill} via ${recommendation.agent} (${recommendation.reason}; ${sampleSources}${extra})${description}`;
+    }),
+    "Guardrails: use these for broad tasks where a skill-specialist pass is useful; keep fanout small, use fresh context unless private/session context is explicitly needed, and skip when the user asks for a direct answer."
+  ];
+}
+export function buildProactiveSkillSubagentRecommendationLines(input) {
+  if (!resolveProactiveSkillSubagentsConfig(input.config).enabled)
+    return [];
+  let availableSkills;
+  try {
+    availableSkills = input.discoverAvailableSkills();
+  } catch {
+    availableSkills = [];
+  }
+  return formatProactiveSkillSubagentRecommendations(recommendProactiveSkillSubagents({
+    agents: input.agents,
+    chains: input.chains,
+    availableSkills,
+    config: input.config
+  }));
+}