@duckmind/dm-windows-x64 0.60.6 → 0.60.9

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

@@ -1,6 +1,614 @@
-import{execSync as YQ}from"node:child_process";import*as j from"node:fs";import*as w from"node:os";import*as W from"node:path";import*as E from"node:fs";import*as S from"node:os";import*as F from"node:path";import*as N from"node:os";import*as I from"node:path";function x(Q){return Q.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function i(Q){let Z=Q?.env??process.env,Y=Q&&Object.hasOwn(Q,"getuid")?Q.getuid:process.getuid?.bind(process);if(typeof Y==="function")return`uid-${Y()}`;for(let B of["USERNAME","USER","LOGNAME"]){let U=Z[B];if(U)return`user-${x(U)}`}let $=Q&&Object.hasOwn(Q,"userInfo")?Q.userInfo:N.userInfo;try{let B=$?.().username;if(B)return`user-${x(B)}`}catch{}let J=Z.USERPROFILE??Z.HOME;if(J)return`home-${x(J)}`;let X=Q&&Object.hasOwn(Q,"homedir")?Q.homedir:N.homedir;try{let B=X?.();if(B)return`home-${x(B)}`}catch{}return"shared"}var y=I.join(N.tmpdir(),`dm-subagents-${i()}`),EQ=I.join(y,"async-subagent-results"),FQ=I.join(y,"async-subagent-runs"),r=I.join(y,"chain-runs"),MQ=I.join(y,"artifacts");var a=".dm",s="@duckmind/dm-coding-agent",t="DM_SUBAGENTS_PI_CODING_AGENT_PACKAGE_ROOT";function g(Q){return typeof Q==="string"&&Q.trim()?Q:void 0}function c(Q){if(!Q)return;try{let Z=JSON.parse(E.readFileSync(F.join(Q,"package.json"),"utf-8"));if(Z.name!==s)return;return g(Z.piConfig?.configDir)}catch{return}}function e(Q=process.argv[1],Z=process.env[t]){let Y=c(Z);if(Y)return Y;if(!Q)return;try{let $=F.dirname(E.realpathSync(Q));while($!==F.dirname($)){let J=c($);if(J)return J;$=F.dirname($)}}catch{}return}function QQ(Q,Z,Y){return(Q&&typeof Q==="object"?g(Q.CONFIG_DIR_NAME):void 0)??e(Z,Y)??a}function u(){return QQ()}function C(Q){return F.join(Q,u())}function d(){let Q=process.env.DM_CODING_AGENT_DIR;if(Q==="~")return S.homedir();if(Q?.startsWith("~/"))return F.join(S.homedir(),Q.slice(2));return Q||F.join(S.homedir(),u(),"agent")}var b=new Map,ZQ=50,R=null,$Q=5000,n="dm-subagents",O={project:700,"project-settings":650,"project-package":600,user:300,"user-settings":250,"user-package":200,extension:150,builtin:100,unknown:0};function JQ(Q){let Z=Q.replace(/\r\n/g,`
-`);if(!Z.startsWith("---"))return Z;let Y=Z.indexOf(`
----`,3);if(Y===-1)return Z;return Z.slice(Y+4).trim()}function T(Q,Z){let Y=W.relative(Z,Q);return Y===""||!Y.startsWith("..")&&!W.isAbsolute(Y)}function m(Q,Z){try{return JSON.parse(j.readFileSync(Q,"utf-8"))}catch(Y){if((typeof Y==="object"&&Y!==null&&"code"in Y?Y.code:void 0)==="ENOENT")return null;let J=Y instanceof Error?Y.message:String(Y);throw Error(`Failed to read ${Z} '${Q}': ${J}`,{cause:Y instanceof Error?Y:void 0})}}function WQ(Q){try{return JSON.parse(j.readFileSync(Q,"utf-8"))}catch{return null}}function v(Q,Z,Y=!1){let $=W.join(Q,"package.json"),J=Y?WQ($):m($,"package manifest");if(!J||typeof J!=="object"||Array.isArray(J))return[];let X=J.pi;if(!X||typeof X!=="object"||Array.isArray(X))return[];let B=X.skills;if(!Array.isArray(B))return[];return B.filter((U)=>typeof U==="string").map((U)=>({path:W.resolve(Q,U),source:Z}))}var D=null;function o(){if(D!==null)return D;try{return D=YQ("npm root -g",{encoding:"utf-8",timeout:5000}).trim(),D}catch{return D="",null}}function XQ(Q,Z){let Y=C(Q),$=[{path:W.join(Y,"npm","node_modules"),source:"project-package"},{path:W.join(Z,"npm","node_modules"),source:"user-package"}],J=o();if(J)$.push({path:J,source:"user-package"});let X=[];for(let B of $){if(!j.existsSync(B.path))continue;let U;try{U=j.readdirSync(B.path,{withFileTypes:!0})}catch{continue}for(let V of U){if(V.name.startsWith("."))continue;if(!V.isDirectory()&&!V.isSymbolicLink())continue;if(V.name.startsWith("@")){let _=W.join(B.path,V.name),q;try{q=j.readdirSync(_,{withFileTypes:!0})}catch{continue}for(let K of q){if(K.name.startsWith("."))continue;if(!K.isDirectory()&&!K.isSymbolicLink())continue;let L=W.join(_,K.name);X.push(...v(L,B.source,!0))}continue}let z=W.join(B.path,V.name);X.push(...v(z,B.source,!0))}}return X}function qQ(Q,Z){let Y=[],$=C(Q),J=[{file:W.join($,"settings.json"),base:$,source:"project-settings"},{file:W.join(Z,"settings.json"),base:Z,source:"user-settings"}];for(let{file:X,base:B,source:U}of J){let V=m(X,"skills settings file");if(!V||typeof V!=="object"||Array.isArray(V))continue;let z=V.skills;if(!Array.isArray(z))continue;for(let _ of z){if(typeof _!=="string")continue;let q=_;if(q.startsWith("~/"))q=W.join(w.homedir(),q.slice(2));else if(!W.isAbsolute(q))q=W.resolve(B,q);Y.push({path:q,source:U})}}return Y}function f(Q){return Q.length>0&&!W.isAbsolute(Q)&&Q.split(/[\\/]/).every((Z)=>Z.length>0&&Z!=="."&&Z!=="..")}function BQ(Q){let Z=Q.slice(4).trim();if(!Z)return;let $=Z.match(/^(@?[^@]+(?:\/[^@]+)?)(?:@(.+))?$/)?.[1]??Z;return f($)?$:void 0}function UQ(Q){let Z=Q.indexOf("@"),Y=Q.indexOf("#"),$=[Z,Y].filter((J)=>J>=0).sort((J,X)=>J-X)[0];return $===void 0?Q:Q.slice(0,$)}function VQ(Q){let Z=Q.slice(4).trim();if(!Z)return;let Y="",$="",J=Z.match(/^git@([^:]+):(.+)$/);if(J)Y=J[1]??"",$=J[2]??"";else if(/^[a-z][a-z0-9+.-]*:\/\//i.test(Z))try{let B=new URL(Z);Y=B.hostname,$=B.pathname.replace(/^\/+/,"")}catch{return}else{let B=Z.indexOf("/");if(B<0)return;Y=Z.slice(0,B),$=Z.slice(B+1)}let X=UQ($).replace(/\.git$/,"").replace(/^\/+/,"");if(!Y||!f(Y)||!f(X)||X.split(/[\\/]/).length<2)return;return{host:Y,repoPath:X}}function GQ(Q,Z){let Y=Q.trim();if(!Y)return;if(Y.startsWith("git:")){let J=VQ(Y);return J?W.join(Z,"git",J.host,J.repoPath):void 0}if(Y.startsWith("npm:")){let J=BQ(Y);return J?W.join(Z,"npm","node_modules",J):void 0}let $=Y.startsWith("file:")?Y.slice(5):Y;if($==="~")return w.homedir();if($.startsWith("~/"))return W.join(w.homedir(),$.slice(2));if(W.isAbsolute($))return $;if($==="."||$===".."||$.startsWith("./")||$.startsWith("../"))return W.resolve(Z,$);return}function KQ(Q,Z){let Y=C(Q),$=[{file:W.join(Y,"settings.json"),base:Y,source:"project-package"},{file:W.join(Z,"settings.json"),base:Z,source:"user-package"}],J=[];for(let{file:X,base:B,source:U}of $){let V=m(X,"skills settings file");if(!V||typeof V!=="object"||Array.isArray(V))continue;let z=V.packages;if(!Array.isArray(z))continue;for(let _ of z){let q=typeof _==="string"?_:typeof _==="object"&&_!==null&&typeof _.source==="string"?_.source:void 0;if(!q)continue;let K=GQ(q,B);if(!K)continue;J.push(...v(K,U))}}return J}function jQ(Q,Z){let Y=C(Q),$=[{path:W.join(Y,"skills"),source:"project"},{path:W.join(Q,".agents","skills"),source:"project"},{path:W.join(Z,"skills"),source:"user"},{path:W.join(w.homedir(),".agents","skills"),source:"user"},...XQ(Q,Z),...KQ(Q,Z),...v(Q,"project-package"),...qQ(Q,Z)],J=new Map;for(let X of $){let B=W.resolve(X.path),U=J.get(B);if(!U||(O[X.source]??0)>(O[U.source]??0))J.set(B,{path:B,source:X.source})}return[...J.values()]}function _Q(Q,Z,Y,$){if($)return $;let J=W.resolve(C(Z)),X=W.resolve(J,"skills"),B=W.resolve(J,"npm","node_modules"),U=W.resolve(Z,".agents"),V=W.resolve(Y,"skills"),z=W.resolve(Y,"npm","node_modules"),_=W.resolve(Y),q=W.resolve(w.homedir(),".agents");if(T(Q,B))return"project-package";if(T(Q,X)||T(Q,U))return"project";if(T(Q,J))return"project-settings";if(T(Q,z))return"user-package";if(T(Q,V)||T(Q,q))return"user";if(T(Q,_))return"user-settings";let K=o();if(K&&T(Q,K))return"user-package";return"unknown"}function HQ(Q,Z){if(!Q)return Z;let Y=O[Q.source]??0,$=O[Z.source]??0;if($>Y)return Z;if($<Y)return Q;return Z.order<Q.order?Z:Q}function k(Q){try{let Y=j.readFileSync(Q,"utf-8").replace(/\r\n/g,`
-`);if(!Y.startsWith("---"))return;let $=Y.indexOf(`
----`,3);if($===-1)return;let X=Y.slice(3,$).trim().match(/^description:\s*(.+)$/m);if(!X)return;return X[1]?.trim().replace(/^['\"]|['\"]$/g,"")}catch{return}}function zQ(Q,Z,Y){let $=[],J=new Map,X=new Map,B=0,U=(q,K,L)=>{let H=W.resolve(K);if(!j.existsSync(H))return;let G=_Q(H,Q,Z,L),A=J.get(H);if(A!==void 0){let M=$[A];if(M&&(O[G]??0)>(O[M.source]??0))$[A]={...M,name:q,source:G,description:k(H)};return}J.set(H,$.length),$.push({name:q,filePath:H,source:G,description:k(H),order:B++})},V=(q)=>q.startsWith(".")||q==="node_modules",z=(q,K)=>{let L;try{L=j.realpathSync(q)}catch{L=W.resolve(q)}let H=K?O[K]??0:O.unknown,G=X.get(L);if(G!==void 0&&G>=H)return!1;return X.set(L,H),!0},_=(q,K)=>{if(!z(q,K))return;let L=W.join(q,"SKILL.md");if(j.existsSync(L)){U(W.basename(q),L,K);return}let H;try{H=j.readdirSync(q,{withFileTypes:!0})}catch{return}for(let G of H){if(V(G.name))continue;if(!G.isDirectory()&&!G.isSymbolicLink())continue;let A=W.join(q,G.name),M;try{M=j.statSync(A)}catch{continue}if(M.isDirectory())_(A,K)}};for(let q of Y){if(!j.existsSync(q.path))continue;let K;try{K=j.statSync(q.path)}catch{continue}if(K.isFile()){let G=W.basename(q.path);if(!G.toLowerCase().endsWith(".md"))continue;let A=G.toLowerCase()==="skill.md"?W.basename(W.dirname(q.path)):W.basename(G,W.extname(G));U(A,q.path,q.source);continue}if(!K.isDirectory())continue;let L=W.join(q.path,"SKILL.md");if(j.existsSync(L)){U(W.basename(q.path),L,q.source);continue}z(q.path,q.source);let H;try{H=j.readdirSync(q.path,{withFileTypes:!0})}catch{continue}for(let G of H){if(G.name.startsWith("."))continue;let A=W.join(q.path,G.name);if(G.isDirectory()||G.isSymbolicLink()){if(V(G.name))continue;let M;try{M=j.statSync(A)}catch{continue}if(M.isDirectory())_(A,q.source);continue}if(G.isFile()&&G.name.toLowerCase().endsWith(".md"))U(W.basename(G.name,W.extname(G.name)),A,q.source)}}return $}function l(Q){let Z=Date.now(),Y=d();if(R&&R.cwd===Q&&R.agentDir===Y&&Z-R.timestamp<$Q)return R.skills;let $=jQ(Q,Y),J=zQ(Q,Y,$),X=new Map;for(let U of J){let V=X.get(U.name);X.set(U.name,HQ(V,U))}let B=[...X.values()].sort((U,V)=>U.order-V.order);return R={cwd:Q,agentDir:Y,skills:B,timestamp:Z},B}function LQ(Q,Z){let $=l(Z).find((J)=>J.name===Q);if(!$)return;return{path:$.filePath,source:$.source}}function AQ(Q,Z,Y){try{let $=j.statSync(Z),J=b.get(Z);if(J&&J.mtime===$.mtimeMs)return J.skill;let X=j.readFileSync(Z,"utf-8"),B=JQ(X),U=k(Z),V={name:Q,path:Z,content:B,description:U,source:Y};if(b.set(Z,{mtime:$.mtimeMs,skill:V}),b.size>ZQ){let z=b.keys().next().value;if(z)b.delete(z)}return V}catch{return}}function p(Q,Z){let Y=[],$=[];for(let J of Q){let X=J.trim();if(!X)continue;if(X===n){$.push(X);continue}let B=LQ(X,Z);if(!B){$.push(X);continue}let U=AQ(X,B.path,B.source);if(U)Y.push(U);else $.push(X)}return{resolved:Y,missing:$}}function pQ(Q,Z,Y){let $=p(Q,Z);if(!Y||$.missing.length===0)return $;if(W.resolve(Z)===W.resolve(Y))return $;let J=p($.missing,Y);return{resolved:[...$.resolved,...J.resolved],missing:J.missing}}function nQ(Q){if(Q.length===0)return"";let Z=["The following configured skills are available to this subagent.","Use the read tool to load a skill's file when the task matches its description.","When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.","","<available_skills>"];for(let Y of Q)Z.push("  <skill>"),Z.push(`    <name>${P(Y.name)}</name>`),Z.push(`    <description>${P(Y.description??"")}</description>`),Z.push(`    <location>${P(Y.path)}</location>`),Z.push("  </skill>");return Z.push("</available_skills>"),Z.join(`
-`)}function P(Q){return Q.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function h(Q){if(Q===!1)return!1;if(Q===!0||Q===void 0)return;if(Array.isArray(Q))return[...new Set(Q.map((Y)=>Y.trim()).filter((Y)=>Y.length>0))];let Z=Q.trim();if(Z.startsWith("["))try{let Y=JSON.parse(Z);if(Array.isArray(Y))return h(Y)}catch{}return[...new Set(Q.split(",").map((Y)=>Y.trim()).filter((Y)=>Y.length>0))]}function oQ(Q){return l(Q).filter((Y)=>Y.name!==n).map((Y)=>({name:Y.name,source:Y.source,description:Y.description})).sort((Y,$)=>Y.name.localeCompare($.name))}function lQ(){b.clear(),R=null}export{pQ as resolveSkillsWithFallback,p as resolveSkills,LQ as resolveSkillPath,h as normalizeSkillInput,oQ as discoverAvailableSkills,lQ as clearSkillCache,nQ as buildSkillInjection};
+import { execSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { getAgentDir, getProjectConfigDir } from "../shared/utils.js";
+const skillCache = new Map;
+const MAX_CACHE_SIZE = 50;
+let loadSkillsCache = null;
+const LOAD_SKILLS_CACHE_TTL_MS = 5000;
+const SUBAGENT_ORCHESTRATION_SKILL = "dm-subagents";
+const SOURCE_PRIORITY = {
+  project: 700,
+  "project-settings": 650,
+  "project-package": 600,
+  user: 300,
+  "user-settings": 250,
+  "user-package": 200,
+  extension: 150,
+  builtin: 100,
+  unknown: 0
+};
+function stripSkillFrontmatter(content) {
+  const normalized = content.replace(/\r\n/g, `
+`);
+  if (!normalized.startsWith("---"))
+    return normalized;
+  const endIndex = normalized.indexOf(`
+---`, 3);
+  if (endIndex === -1)
+    return normalized;
+  return normalized.slice(endIndex + 4).trim();
+}
+function isWithinPath(filePath, dir) {
+  const relative = path.relative(dir, filePath);
+  return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+function readOptionalJsonFile(filePath, label) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch (error) {
+    const code = typeof error === "object" && error !== null && "code" in error ? error.code : undefined;
+    if (code === "ENOENT")
+      return null;
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to read ${label} '${filePath}': ${message}`, {
+      cause: error instanceof Error ? error : undefined
+    });
+  }
+}
+function readJsonFileBestEffort(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function extractSkillPathsFromPackageRoot(packageRoot, source, bestEffort = false) {
+  const packageJsonPath = path.join(packageRoot, "package.json");
+  const pkg = bestEffort ? readJsonFileBestEffort(packageJsonPath) : readOptionalJsonFile(packageJsonPath, "package manifest");
+  if (!pkg || typeof pkg !== "object" || Array.isArray(pkg))
+    return [];
+  const pi = pkg.pi;
+  if (!pi || typeof pi !== "object" || Array.isArray(pi))
+    return [];
+  const skills = pi.skills;
+  if (!Array.isArray(skills))
+    return [];
+  return skills.filter((entry) => typeof entry === "string").map((entry) => ({ path: path.resolve(packageRoot, entry), source }));
+}
+let cachedGlobalNpmRoot = null;
+function getGlobalNpmRoot() {
+  if (cachedGlobalNpmRoot !== null)
+    return cachedGlobalNpmRoot;
+  try {
+    cachedGlobalNpmRoot = execSync("npm root -g", { encoding: "utf-8", timeout: 5000 }).trim();
+    return cachedGlobalNpmRoot;
+  } catch {
+    cachedGlobalNpmRoot = "";
+    return null;
+  }
+}
+function collectInstalledPackageSkillPaths(cwd, agentDir) {
+  const projectConfigDir = getProjectConfigDir(cwd);
+  const dirs = [
+    { path: path.join(projectConfigDir, "npm", "node_modules"), source: "project-package" },
+    { path: path.join(agentDir, "npm", "node_modules"), source: "user-package" }
+  ];
+  const globalRoot = getGlobalNpmRoot();
+  if (globalRoot) {
+    dirs.push({ path: globalRoot, source: "user-package" });
+  }
+  const results = [];
+  for (const dir of dirs) {
+    if (!fs.existsSync(dir.path))
+      continue;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir.path, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith("."))
+        continue;
+      if (!entry.isDirectory() && !entry.isSymbolicLink())
+        continue;
+      if (entry.name.startsWith("@")) {
+        const scopeDir = path.join(dir.path, entry.name);
+        let scopeEntries;
+        try {
+          scopeEntries = fs.readdirSync(scopeDir, { withFileTypes: true });
+        } catch {
+          continue;
+        }
+        for (const scopeEntry of scopeEntries) {
+          if (scopeEntry.name.startsWith("."))
+            continue;
+          if (!scopeEntry.isDirectory() && !scopeEntry.isSymbolicLink())
+            continue;
+          const pkgRoot = path.join(scopeDir, scopeEntry.name);
+          results.push(...extractSkillPathsFromPackageRoot(pkgRoot, dir.source, true));
+        }
+        continue;
+      }
+      const pkgRoot = path.join(dir.path, entry.name);
+      results.push(...extractSkillPathsFromPackageRoot(pkgRoot, dir.source, true));
+    }
+  }
+  return results;
+}
+function collectSettingsSkillPaths(cwd, agentDir) {
+  const results = [];
+  const projectConfigDir = getProjectConfigDir(cwd);
+  const settingsFiles = [
+    { file: path.join(projectConfigDir, "settings.json"), base: projectConfigDir, source: "project-settings" },
+    { file: path.join(agentDir, "settings.json"), base: agentDir, source: "user-settings" }
+  ];
+  for (const { file, base, source } of settingsFiles) {
+    const settings = readOptionalJsonFile(file, "skills settings file");
+    if (!settings || typeof settings !== "object" || Array.isArray(settings))
+      continue;
+    const skills = settings.skills;
+    if (!Array.isArray(skills))
+      continue;
+    for (const entry of skills) {
+      if (typeof entry !== "string")
+        continue;
+      let resolved = entry;
+      if (resolved.startsWith("~/")) {
+        resolved = path.join(os.homedir(), resolved.slice(2));
+      } else if (!path.isAbsolute(resolved)) {
+        resolved = path.resolve(base, resolved);
+      }
+      results.push({ path: resolved, source });
+    }
+  }
+  return results;
+}
+function isSafePackagePath(value) {
+  return value.length > 0 && !path.isAbsolute(value) && value.split(/[\\/]/).every((part) => part.length > 0 && part !== "." && part !== "..");
+}
+function parseNpmPackageName(source) {
+  const spec = source.slice(4).trim();
+  if (!spec)
+    return;
+  const match = spec.match(/^(@?[^@]+(?:\/[^@]+)?)(?:@(.+))?$/);
+  const packageName = match?.[1] ?? spec;
+  return isSafePackagePath(packageName) ? packageName : undefined;
+}
+function stripGitRef(repoPath) {
+  const atIndex = repoPath.indexOf("@");
+  const hashIndex = repoPath.indexOf("#");
+  const refIndex = [atIndex, hashIndex].filter((index) => index >= 0).sort((a, b) => a - b)[0];
+  return refIndex === undefined ? repoPath : repoPath.slice(0, refIndex);
+}
+function parseGitPackagePath(source) {
+  const spec = source.slice(4).trim();
+  if (!spec)
+    return;
+  let host = "";
+  let repoPath = "";
+  const scpLike = spec.match(/^git@([^:]+):(.+)$/);
+  if (scpLike) {
+    host = scpLike[1] ?? "";
+    repoPath = scpLike[2] ?? "";
+  } else if (/^[a-z][a-z0-9+.-]*:\/\//i.test(spec)) {
+    try {
+      const url = new URL(spec);
+      host = url.hostname;
+      repoPath = url.pathname.replace(/^\/+/, "");
+    } catch {
+      return;
+    }
+  } else {
+    const slashIndex = spec.indexOf("/");
+    if (slashIndex < 0)
+      return;
+    host = spec.slice(0, slashIndex);
+    repoPath = spec.slice(slashIndex + 1);
+  }
+  const normalizedPath = stripGitRef(repoPath).replace(/\.git$/, "").replace(/^\/+/, "");
+  if (!host || !isSafePackagePath(host) || !isSafePackagePath(normalizedPath) || normalizedPath.split(/[\\/]/).length < 2) {
+    return;
+  }
+  return { host, repoPath: normalizedPath };
+}
+function resolveSettingsPackageRoot(source, baseDir) {
+  const trimmed = source.trim();
+  if (!trimmed)
+    return;
+  if (trimmed.startsWith("git:")) {
+    const parsed = parseGitPackagePath(trimmed);
+    return parsed ? path.join(baseDir, "git", parsed.host, parsed.repoPath) : undefined;
+  }
+  if (trimmed.startsWith("npm:")) {
+    const packageName = parseNpmPackageName(trimmed);
+    return packageName ? path.join(baseDir, "npm", "node_modules", packageName) : undefined;
+  }
+  const normalized = trimmed.startsWith("file:") ? trimmed.slice(5) : trimmed;
+  if (normalized === "~")
+    return os.homedir();
+  if (normalized.startsWith("~/"))
+    return path.join(os.homedir(), normalized.slice(2));
+  if (path.isAbsolute(normalized))
+    return normalized;
+  if (normalized === "." || normalized === ".." || normalized.startsWith("./") || normalized.startsWith("../")) {
+    return path.resolve(baseDir, normalized);
+  }
+  return;
+}
+function collectSettingsPackageSkillPaths(cwd, agentDir) {
+  const projectConfigDir = getProjectConfigDir(cwd);
+  const settingsFiles = [
+    { file: path.join(projectConfigDir, "settings.json"), base: projectConfigDir, source: "project-package" },
+    { file: path.join(agentDir, "settings.json"), base: agentDir, source: "user-package" }
+  ];
+  const results = [];
+  for (const { file, base, source } of settingsFiles) {
+    const settings = readOptionalJsonFile(file, "skills settings file");
+    if (!settings || typeof settings !== "object" || Array.isArray(settings))
+      continue;
+    const packages = settings.packages;
+    if (!Array.isArray(packages))
+      continue;
+    for (const entry of packages) {
+      const packageSource = typeof entry === "string" ? entry : typeof entry === "object" && entry !== null && typeof entry.source === "string" ? entry.source : undefined;
+      if (!packageSource)
+        continue;
+      const packageRoot = resolveSettingsPackageRoot(packageSource, base);
+      if (!packageRoot)
+        continue;
+      results.push(...extractSkillPathsFromPackageRoot(packageRoot, source));
+    }
+  }
+  return results;
+}
+function buildSkillPaths(cwd, agentDir) {
+  const projectConfigDir = getProjectConfigDir(cwd);
+  const skillPaths = [
+    { path: path.join(projectConfigDir, "skills"), source: "project" },
+    { path: path.join(cwd, ".agents", "skills"), source: "project" },
+    { path: path.join(agentDir, "skills"), source: "user" },
+    { path: path.join(os.homedir(), ".agents", "skills"), source: "user" },
+    ...collectInstalledPackageSkillPaths(cwd, agentDir),
+    ...collectSettingsPackageSkillPaths(cwd, agentDir),
+    ...extractSkillPathsFromPackageRoot(cwd, "project-package"),
+    ...collectSettingsSkillPaths(cwd, agentDir)
+  ];
+  const deduped = new Map;
+  for (const entry of skillPaths) {
+    const resolvedPath = path.resolve(entry.path);
+    const existing = deduped.get(resolvedPath);
+    if (!existing || (SOURCE_PRIORITY[entry.source] ?? 0) > (SOURCE_PRIORITY[existing.source] ?? 0)) {
+      deduped.set(resolvedPath, { path: resolvedPath, source: entry.source });
+    }
+  }
+  return [...deduped.values()];
+}
+function inferSkillSource(filePath, cwd, agentDir, sourceHint) {
+  if (sourceHint)
+    return sourceHint;
+  const projectConfigRoot = path.resolve(getProjectConfigDir(cwd));
+  const projectSkillsRoot = path.resolve(projectConfigRoot, "skills");
+  const projectPackagesRoot = path.resolve(projectConfigRoot, "npm", "node_modules");
+  const projectAgentsRoot = path.resolve(cwd, ".agents");
+  const userSkillsRoot = path.resolve(agentDir, "skills");
+  const userPackagesRoot = path.resolve(agentDir, "npm", "node_modules");
+  const userAgentRoot = path.resolve(agentDir);
+  const userAgentsRoot = path.resolve(os.homedir(), ".agents");
+  if (isWithinPath(filePath, projectPackagesRoot))
+    return "project-package";
+  if (isWithinPath(filePath, projectSkillsRoot) || isWithinPath(filePath, projectAgentsRoot))
+    return "project";
+  if (isWithinPath(filePath, projectConfigRoot))
+    return "project-settings";
+  if (isWithinPath(filePath, userPackagesRoot))
+    return "user-package";
+  if (isWithinPath(filePath, userSkillsRoot) || isWithinPath(filePath, userAgentsRoot))
+    return "user";
+  if (isWithinPath(filePath, userAgentRoot))
+    return "user-settings";
+  const globalRoot = getGlobalNpmRoot();
+  if (globalRoot && isWithinPath(filePath, globalRoot))
+    return "user-package";
+  return "unknown";
+}
+function chooseHigherPrioritySkill(existing, candidate) {
+  if (!existing)
+    return candidate;
+  const existingPriority = SOURCE_PRIORITY[existing.source] ?? 0;
+  const candidatePriority = SOURCE_PRIORITY[candidate.source] ?? 0;
+  if (candidatePriority > existingPriority)
+    return candidate;
+  if (candidatePriority < existingPriority)
+    return existing;
+  return candidate.order < existing.order ? candidate : existing;
+}
+function maybeReadSkillDescription(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, "utf-8");
+    const normalized = content.replace(/\r\n/g, `
+`);
+    if (!normalized.startsWith("---"))
+      return;
+    const endIndex = normalized.indexOf(`
+---`, 3);
+    if (endIndex === -1)
+      return;
+    const frontmatter = normalized.slice(3, endIndex).trim();
+    const match = frontmatter.match(/^description:\s*(.+)$/m);
+    if (!match)
+      return;
+    return match[1]?.trim().replace(/^['\"]|['\"]$/g, "");
+  } catch {
+    return;
+  }
+}
+function collectFilesystemSkills(cwd, agentDir, skillPaths) {
+  const entries = [];
+  const seen = new Map;
+  const visitedDirectories = new Map;
+  let order = 0;
+  const pushEntry = (name, filePath, sourceHint) => {
+    const resolvedFile = path.resolve(filePath);
+    if (!fs.existsSync(resolvedFile))
+      return;
+    const source = inferSkillSource(resolvedFile, cwd, agentDir, sourceHint);
+    const existingIndex = seen.get(resolvedFile);
+    if (existingIndex !== undefined) {
+      const existing = entries[existingIndex];
+      if (existing && (SOURCE_PRIORITY[source] ?? 0) > (SOURCE_PRIORITY[existing.source] ?? 0)) {
+        entries[existingIndex] = {
+          ...existing,
+          name,
+          source,
+          description: maybeReadSkillDescription(resolvedFile)
+        };
+      }
+      return;
+    }
+    seen.set(resolvedFile, entries.length);
+    entries.push({
+      name,
+      filePath: resolvedFile,
+      source,
+      description: maybeReadSkillDescription(resolvedFile),
+      order: order++
+    });
+  };
+  const shouldSkipDirectory = (name) => name.startsWith(".") || name === "node_modules";
+  const markDirectoryVisited = (dirPath, sourceHint) => {
+    let resolvedDir;
+    try {
+      resolvedDir = fs.realpathSync(dirPath);
+    } catch {
+      resolvedDir = path.resolve(dirPath);
+    }
+    const priority = sourceHint ? SOURCE_PRIORITY[sourceHint] ?? 0 : SOURCE_PRIORITY.unknown;
+    const previousPriority = visitedDirectories.get(resolvedDir);
+    if (previousPriority !== undefined && previousPriority >= priority)
+      return false;
+    visitedDirectories.set(resolvedDir, priority);
+    return true;
+  };
+  const walkSkillDirectories = (dirPath, sourceHint) => {
+    if (!markDirectoryVisited(dirPath, sourceHint))
+      return;
+    const skillFile = path.join(dirPath, "SKILL.md");
+    if (fs.existsSync(skillFile)) {
+      pushEntry(path.basename(dirPath), skillFile, sourceHint);
+      return;
+    }
+    let entriesInDir;
+    try {
+      entriesInDir = fs.readdirSync(dirPath, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entriesInDir) {
+      if (shouldSkipDirectory(entry.name))
+        continue;
+      if (!entry.isDirectory() && !entry.isSymbolicLink())
+        continue;
+      const entryPath = path.join(dirPath, entry.name);
+      let stat;
+      try {
+        stat = fs.statSync(entryPath);
+      } catch {
+        continue;
+      }
+      if (stat.isDirectory()) {
+        walkSkillDirectories(entryPath, sourceHint);
+      }
+    }
+  };
+  for (const skillPath of skillPaths) {
+    if (!fs.existsSync(skillPath.path))
+      continue;
+    let stat;
+    try {
+      stat = fs.statSync(skillPath.path);
+    } catch {
+      continue;
+    }
+    if (stat.isFile()) {
+      const fileName = path.basename(skillPath.path);
+      if (!fileName.toLowerCase().endsWith(".md"))
+        continue;
+      const skillName = fileName.toLowerCase() === "skill.md" ? path.basename(path.dirname(skillPath.path)) : path.basename(fileName, path.extname(fileName));
+      pushEntry(skillName, skillPath.path, skillPath.source);
+      continue;
+    }
+    if (!stat.isDirectory())
+      continue;
+    const rootSkillFile = path.join(skillPath.path, "SKILL.md");
+    if (fs.existsSync(rootSkillFile)) {
+      pushEntry(path.basename(skillPath.path), rootSkillFile, skillPath.source);
+      continue;
+    }
+    markDirectoryVisited(skillPath.path, skillPath.source);
+    let childEntries;
+    try {
+      childEntries = fs.readdirSync(skillPath.path, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const child of childEntries) {
+      if (child.name.startsWith("."))
+        continue;
+      const childPath = path.join(skillPath.path, child.name);
+      if (child.isDirectory() || child.isSymbolicLink()) {
+        if (shouldSkipDirectory(child.name))
+          continue;
+        let childStat;
+        try {
+          childStat = fs.statSync(childPath);
+        } catch {
+          continue;
+        }
+        if (childStat.isDirectory())
+          walkSkillDirectories(childPath, skillPath.source);
+        continue;
+      }
+      if (child.isFile() && child.name.toLowerCase().endsWith(".md")) {
+        pushEntry(path.basename(child.name, path.extname(child.name)), childPath, skillPath.source);
+      }
+    }
+  }
+  return entries;
+}
+function getCachedSkills(cwd) {
+  const now = Date.now();
+  const agentDir = getAgentDir();
+  if (loadSkillsCache && loadSkillsCache.cwd === cwd && loadSkillsCache.agentDir === agentDir && now - loadSkillsCache.timestamp < LOAD_SKILLS_CACHE_TTL_MS) {
+    return loadSkillsCache.skills;
+  }
+  const skillPaths = buildSkillPaths(cwd, agentDir);
+  const loaded = collectFilesystemSkills(cwd, agentDir, skillPaths);
+  const dedupedByName = new Map;
+  for (const entry of loaded) {
+    const current = dedupedByName.get(entry.name);
+    dedupedByName.set(entry.name, chooseHigherPrioritySkill(current, entry));
+  }
+  const skills = [...dedupedByName.values()].sort((a, b) => a.order - b.order);
+  loadSkillsCache = { cwd, agentDir, skills, timestamp: now };
+  return skills;
+}
+export function resolveSkillPath(skillName, cwd) {
+  const skills = getCachedSkills(cwd);
+  const skill = skills.find((s) => s.name === skillName);
+  if (!skill)
+    return;
+  return { path: skill.filePath, source: skill.source };
+}
+function readSkill(skillName, skillPath, source) {
+  try {
+    const stat = fs.statSync(skillPath);
+    const cached = skillCache.get(skillPath);
+    if (cached && cached.mtime === stat.mtimeMs) {
+      return cached.skill;
+    }
+    const raw = fs.readFileSync(skillPath, "utf-8");
+    const content = stripSkillFrontmatter(raw);
+    const description = maybeReadSkillDescription(skillPath);
+    const skill = {
+      name: skillName,
+      path: skillPath,
+      content,
+      description,
+      source
+    };
+    skillCache.set(skillPath, { mtime: stat.mtimeMs, skill });
+    if (skillCache.size > MAX_CACHE_SIZE) {
+      const firstKey = skillCache.keys().next().value;
+      if (firstKey)
+        skillCache.delete(firstKey);
+    }
+    return skill;
+  } catch {
+    return;
+  }
+}
+export function resolveSkills(skillNames, cwd) {
+  const resolved = [];
+  const missing = [];
+  for (const name of skillNames) {
+    const trimmed = name.trim();
+    if (!trimmed)
+      continue;
+    if (trimmed === SUBAGENT_ORCHESTRATION_SKILL) {
+      missing.push(trimmed);
+      continue;
+    }
+    const location = resolveSkillPath(trimmed, cwd);
+    if (!location) {
+      missing.push(trimmed);
+      continue;
+    }
+    const skill = readSkill(trimmed, location.path, location.source);
+    if (skill) {
+      resolved.push(skill);
+    } else {
+      missing.push(trimmed);
+    }
+  }
+  return { resolved, missing };
+}
+export function resolveSkillsWithFallback(skillNames, primaryCwd, fallbackCwd) {
+  const primary = resolveSkills(skillNames, primaryCwd);
+  if (!fallbackCwd || primary.missing.length === 0)
+    return primary;
+  if (path.resolve(primaryCwd) === path.resolve(fallbackCwd))
+    return primary;
+  const fallback = resolveSkills(primary.missing, fallbackCwd);
+  return {
+    resolved: [...primary.resolved, ...fallback.resolved],
+    missing: fallback.missing
+  };
+}
+export function buildSkillInjection(skills) {
+  if (skills.length === 0)
+    return "";
+  const lines = [
+    "The following configured skills are available to this subagent.",
+    "Use the read tool to load a skill's file when the task matches its description.",
+    "When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.",
+    "",
+    "<available_skills>"
+  ];
+  for (const skill of skills) {
+    lines.push("  <skill>");
+    lines.push(`    <name>${escapeXmlText(skill.name)}</name>`);
+    lines.push(`    <description>${escapeXmlText(skill.description ?? "")}</description>`);
+    lines.push(`    <location>${escapeXmlText(skill.path)}</location>`);
+    lines.push("  </skill>");
+  }
+  lines.push("</available_skills>");
+  return lines.join(`
+`);
+}
+function escapeXmlText(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+export function normalizeSkillInput(input) {
+  if (input === false)
+    return false;
+  if (input === true || input === undefined)
+    return;
+  if (Array.isArray(input)) {
+    return [...new Set(input.map((s) => s.trim()).filter((s) => s.length > 0))];
+  }
+  const trimmed = input.trim();
+  if (trimmed.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(trimmed);
+      if (Array.isArray(parsed)) {
+        return normalizeSkillInput(parsed);
+      }
+    } catch {}
+  }
+  return [...new Set(input.split(",").map((s) => s.trim()).filter((s) => s.length > 0))];
+}
+export function discoverAvailableSkills(cwd) {
+  const skills = getCachedSkills(cwd);
+  return skills.filter((s) => s.name !== SUBAGENT_ORCHESTRATION_SKILL).map((s) => ({
+    name: s.name,
+    source: s.source,
+    description: s.description
+  })).sort((a, b) => a.name.localeCompare(b.name));
+}
+export function clearSkillCache() {
+  skillCache.clear();
+  loadSkillsCache = null;
+}

package/extensions/dm-subagents/src/extension/config.js

@@ -1,2 +1,35 @@
-import*as X from"node:fs";import*as E from"node:path";import*as Q from"node:fs";import*as G from"node:os";import*as Z from"node:path";import*as B from"node:os";import*as U from"node:path";function K($){return $.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function O($){let J=$?.env??process.env,Y=$&&Object.hasOwn($,"getuid")?$.getuid:process.getuid?.bind(process);if(typeof Y==="function")return`uid-${Y()}`;for(let q of["USERNAME","USER","LOGNAME"]){let z=J[q];if(z)return`user-${K(z)}`}let W=$&&Object.hasOwn($,"userInfo")?$.userInfo:B.userInfo;try{let q=W?.().username;if(q)return`user-${K(q)}`}catch{}let V=J.USERPROFILE??J.HOME;if(V)return`home-${K(V)}`;let M=$&&Object.hasOwn($,"homedir")?$.homedir:B.homedir;try{let q=M?.();if(q)return`home-${K(q)}`}catch{}return"shared"}var j=U.join(B.tmpdir(),`dm-subagents-${O()}`),f=U.join(j,"async-subagent-results"),v=U.join(j,"async-subagent-runs"),T=U.join(j,"chain-runs"),P=U.join(j,"artifacts");var N=".dm",R="@duckmind/dm-coding-agent",C="DM_SUBAGENTS_PI_CODING_AGENT_PACKAGE_ROOT";function L($){return typeof $==="string"&&$.trim()?$:void 0}function A($){if(!$)return;try{let J=JSON.parse(Q.readFileSync(Z.join($,"package.json"),"utf-8"));if(J.name!==R)return;return L(J.piConfig?.configDir)}catch{return}}function I($=process.argv[1],J=process.env[C]){let Y=A(J);if(Y)return Y;if(!$)return;try{let W=Z.dirname(Q.realpathSync($));while(W!==Z.dirname(W)){let V=A(W);if(V)return V;W=Z.dirname(W)}}catch{}return}function b($,J,Y){return($&&typeof $==="object"?L($.CONFIG_DIR_NAME):void 0)??I(J,Y)??N}function w(){return b()}function H(){let $=process.env.DM_CODING_AGENT_DIR;if($==="~")return G.homedir();if($?.startsWith("~/"))return Z.join(G.homedir(),$.slice(2));return $||Z.join(G.homedir(),w(),"agent")}function _(){return E.join(H(),"extensions","subagent","config.json")}function F($=_()){if(!X.existsSync($))return{};let J=JSON.parse(X.readFileSync($,"utf-8"));if(!J||typeof J!=="object"||Array.isArray(J))throw Error(`Subagent config at '${$}' must be a JSON object`);return J}function S($,J=_()){X.mkdirSync(E.dirname(J),{recursive:!0}),X.writeFileSync(J,`${JSON.stringify($,null,"\t")}
-`,"utf-8")}function W$($){let J=_(),Y=$(F(J));return S(Y,J),Y}function X$(){let $=_();try{return F($)}catch(J){console.error(`Failed to load subagent config from '${$}':`,J)}return{}}export{W$ as updateConfig,S as saveConfig,X$ as loadConfig,_ as getConfigPath};
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir } from "../shared/utils.js";
+export function getConfigPath() {
+  return path.join(getAgentDir(), "extensions", "subagent", "config.json");
+}
+function readConfigForUpdate(configPath = getConfigPath()) {
+  if (!fs.existsSync(configPath))
+    return {};
+  const parsed = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`Subagent config at '${configPath}' must be a JSON object`);
+  }
+  return parsed;
+}
+export function saveConfig(config, configPath = getConfigPath()) {
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, `${JSON.stringify(config, null, "\t")}
+`, "utf-8");
+}
+export function updateConfig(updater) {
+  const configPath = getConfigPath();
+  const next = updater(readConfigForUpdate(configPath));
+  saveConfig(next, configPath);
+  return next;
+}
+export function loadConfig() {
+  const configPath = getConfigPath();
+  try {
+    return readConfigForUpdate(configPath);
+  } catch (error) {
+    console.error(`Failed to load subagent config from '${configPath}':`, error);
+  }
+  return {};
+}