@miriad-systems/nuum 0.1.13 → 0.2.0

package/dist/index.js

@@ -13356,7 +13356,7 @@ var require_compile = __commonJS((exports) => {
     const schOrFunc = root.refs[ref];
     if (schOrFunc)
       return schOrFunc;
-    let _sch = resolve4.call(this, root, ref);
+    let _sch = resolve5.call(this, root, ref);
     if (_sch === undefined) {
       const schema = (_a17 = root.localRefs) === null || _a17 === undefined ? undefined : _a17[ref];
       const { schemaId } = this.opts;
@@ -13383,7 +13383,7 @@ var require_compile = __commonJS((exports) => {
   function sameSchemaEnv(s1, s2) {
     return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
   }
-  function resolve4(root, ref) {
+  function resolve5(root, ref) {
     let sch;
     while (typeof (sch = this.refs[ref]) == "string")
       ref = sch;
@@ -13913,7 +13913,7 @@ var require_fast_uri = __commonJS((exports, module) => {
     }
     return uri;
   }
-  function resolve4(baseURI, relativeURI, options) {
+  function resolve5(baseURI, relativeURI, options) {
     const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
     const resolved = resolveComponent(parse5(baseURI, schemelessOptions), parse5(relativeURI, schemelessOptions), schemelessOptions, true);
     schemelessOptions.skipEscape = true;
@@ -14141,7 +14141,7 @@ var require_fast_uri = __commonJS((exports, module) => {
   var fastUri = {
     SCHEMES,
     normalize,
-    resolve: resolve4,
+    resolve: resolve5,
     resolveComponent,
     equal,
     serialize,
@@ -16933,7 +16933,7 @@ var require_dist = __commonJS((exports, module) => {
   exports.default = formatsPlugin;
 });
 
-// node_modules/cross-spawn/node_modules/isexe/windows.js
+// node_modules/cross-spawn/node_modules/which/node_modules/isexe/windows.js
 var require_windows = __commonJS((exports, module) => {
   module.exports = isexe;
   isexe.sync = sync;
@@ -16971,7 +16971,7 @@ var require_windows = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/cross-spawn/node_modules/isexe/mode.js
+// node_modules/cross-spawn/node_modules/which/node_modules/isexe/mode.js
 var require_mode = __commonJS((exports, module) => {
   module.exports = isexe;
   isexe.sync = sync;
@@ -17002,7 +17002,7 @@ var require_mode = __commonJS((exports, module) => {
   }
 });
 
-// node_modules/cross-spawn/node_modules/isexe/index.js
+// node_modules/cross-spawn/node_modules/which/node_modules/isexe/index.js
 var require_isexe = __commonJS((exports, module) => {
   var fs7 = __require("fs");
   var core2;
@@ -17022,12 +17022,12 @@ var require_isexe = __commonJS((exports, module) => {
       if (typeof Promise !== "function") {
         throw new TypeError("callback not provided");
       }
-      return new Promise(function(resolve4, reject) {
+      return new Promise(function(resolve5, reject) {
         isexe(path8, options || {}, function(er, is2) {
           if (er) {
             reject(er);
           } else {
-            resolve4(is2);
+            resolve5(is2);
           }
         });
       });
@@ -17089,27 +17089,27 @@ var require_which = __commonJS((exports, module) => {
       opt = {};
     const { pathEnv, pathExt, pathExtExe } = getPathInfo(cmd, opt);
     const found = [];
-    const step = (i) => new Promise((resolve4, reject) => {
+    const step = (i) => new Promise((resolve5, reject) => {
       if (i === pathEnv.length)
-        return opt.all && found.length ? resolve4(found) : reject(getNotFoundError(cmd));
+        return opt.all && found.length ? resolve5(found) : reject(getNotFoundError(cmd));
       const ppRaw = pathEnv[i];
       const pathPart = /^".*"$/.test(ppRaw) ? ppRaw.slice(1, -1) : ppRaw;
       const pCmd = path8.join(pathPart, cmd);
       const p = !pathPart && /^\.[\\\/]/.test(cmd) ? cmd.slice(0, 2) + pCmd : pCmd;
-      resolve4(subStep(p, i, 0));
+      resolve5(subStep(p, i, 0));
     });
-    const subStep = (p, i, ii) => new Promise((resolve4, reject) => {
+    const subStep = (p, i, ii) => new Promise((resolve5, reject) => {
       if (ii === pathExt.length)
-        return resolve4(step(i + 1));
+        return resolve5(step(i + 1));
       const ext = pathExt[ii];
       isexe(p + ext, { pathExt: pathExtExe }, (er, is2) => {
         if (!er && is2) {
           if (opt.all)
             found.push(p + ext);
           else
-            return resolve4(p + ext);
+            return resolve5(p + ext);
         }
-        return resolve4(subStep(p, i, ii + 1));
+        return resolve5(subStep(p, i, ii + 1));
       });
     });
     return cb ? step(0).then((res) => cb(null, res), cb) : step(0);
@@ -34416,6 +34416,164 @@ var activity = {
   mcp: new ActivityLog("mcp")
 };
 
+// src/skills/index.ts
+import { readFileSync as readFileSync5, existsSync as existsSync5, readdirSync as readdirSync3, statSync as statSync6 } from "fs";
+import { join as join6, resolve as resolve4 } from "path";
+import { homedir as homedir2 } from "os";
+var MAX_DESCRIPTION_LENGTH = 255;
+function parseFrontmatter(content) {
+  if (!content.startsWith("---")) {
+    return null;
+  }
+  const endIndex = content.indexOf(`
+---`, 3);
+  if (endIndex === -1) {
+    return null;
+  }
+  const frontmatter = content.slice(4, endIndex).trim();
+  const result = {};
+  for (const line of frontmatter.split(`
+`)) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1)
+      continue;
+    const key = line.slice(0, colonIndex).trim();
+    let value = line.slice(colonIndex + 1).trim();
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    if (key === "name") {
+      result.name = value;
+    } else if (key === "description") {
+      result.description = value;
+    }
+  }
+  return result;
+}
+function isValidSkillName(name17) {
+  if (name17.length < 1 || name17.length > 64)
+    return false;
+  if (!/^[a-z0-9-]+$/.test(name17))
+    return false;
+  if (name17.startsWith("-") || name17.endsWith("-"))
+    return false;
+  if (name17.includes("--"))
+    return false;
+  return true;
+}
+function truncateDescription(description) {
+  if (description.length <= MAX_DESCRIPTION_LENGTH) {
+    return description;
+  }
+  return description.slice(0, MAX_DESCRIPTION_LENGTH - 3) + "...";
+}
+function scanDirectory(dir, skills) {
+  const skillDirs = [".nuum/skills", ".claude/skills", ".codex/skills"];
+  for (const skillDir of skillDirs) {
+    const skillsPath = join6(dir, skillDir);
+    if (!existsSync5(skillsPath))
+      continue;
+    try {
+      const entries = readdirSync3(skillsPath);
+      for (const entry of entries) {
+        const entryPath = join6(skillsPath, entry);
+        const stat = statSync6(entryPath);
+        if (!stat.isDirectory())
+          continue;
+        const skillFile = join6(entryPath, "SKILL.md");
+        if (!existsSync5(skillFile))
+          continue;
+        try {
+          const content = readFileSync5(skillFile, "utf-8");
+          const frontmatter = parseFrontmatter(content);
+          if (!frontmatter?.name || !frontmatter?.description)
+            continue;
+          if (!isValidSkillName(frontmatter.name))
+            continue;
+          if (!skills.has(frontmatter.name)) {
+            skills.set(frontmatter.name, {
+              name: frontmatter.name,
+              description: truncateDescription(frontmatter.description),
+              path: resolve4(skillFile)
+            });
+          }
+        } catch {}
+      }
+    } catch {}
+  }
+}
+function scanSubdirectories(dir, skills) {
+  try {
+    const entries = readdirSync3(dir);
+    for (const entry of entries) {
+      if (entry.startsWith("."))
+        continue;
+      const entryPath = join6(dir, entry);
+      try {
+        const stat = statSync6(entryPath);
+        if (stat.isDirectory()) {
+          scanDirectory(entryPath, skills);
+        }
+      } catch {}
+    }
+  } catch {}
+}
+function discoverSkills(cwd = process.cwd()) {
+  const skills = new Map;
+  const home = homedir2();
+  scanDirectory(cwd, skills);
+  scanSubdirectories(cwd, skills);
+  if (cwd !== home) {
+    scanDirectory(home, skills);
+  }
+  return Array.from(skills.values());
+}
+function formatSkillsCatalog(skills) {
+  if (skills.length === 0) {
+    return null;
+  }
+  const lines = [
+    "## Skills",
+    "",
+    "Skills are local instructions stored in `SKILL.md` files. Each entry below shows a name, description, and file path.",
+    "",
+    "### Available Skills"
+  ];
+  for (const skill of skills) {
+    lines.push(`- ${skill.name}: ${skill.description} (file: ${skill.path})`);
+  }
+  lines.push("");
+  lines.push("### Using Skills");
+  lines.push("");
+  lines.push("**When to use:** If a task matches a skill's description, use that skill. The user may also request a specific skill by name.");
+  lines.push("");
+  lines.push("**How to use (progressive disclosure):**");
+  lines.push("1. Read the skill's `SKILL.md` file - only what you need for the current task");
+  lines.push("2. If it references `scripts/`, `references/`, or `assets/`, load only the specific files needed");
+  lines.push("3. Prefer running existing scripts over rewriting code");
+  lines.push("");
+  lines.push("**Multiple skills:** Choose the minimal set that covers the request. State which skills you're using and why.");
+  lines.push("");
+  lines.push("**Context hygiene:** Summarize long sections instead of pasting them. Don't bulk-load reference files.");
+  lines.push("");
+  lines.push("**Fallback:** If a skill can't be applied (missing files, unclear instructions), state the issue and continue with your best approach.");
+  return lines.join(`
+`);
+}
+var cachedSkills = null;
+var cachedCwd = null;
+function getSkills(cwd = process.cwd()) {
+  if (cachedSkills === null || cachedCwd !== cwd) {
+    cachedSkills = discoverSkills(cwd);
+    cachedCwd = cwd;
+  }
+  return cachedSkills;
+}
+function refreshSkills() {
+  cachedSkills = null;
+  cachedCwd = null;
+}
+
 // src/context/system-prompt.ts
 function estimateTokens(text3) {
   return Math.ceil(text3.length / 4);
@@ -34475,6 +34633,13 @@ Use reflect when:
 
 Messages in your history have automatic prefixes like \`[2026-01-26 15:30 id:msg_xxx]\` showing timestamp and ID. These are added by the system for internal tracking - you don't need to reference or echo them. Just read the message content normally.
 `;
+  const skills = getSkills();
+  const skillsCatalog = formatSkillsCatalog(skills);
+  if (skillsCatalog) {
+    prompt += `
+${skillsCatalog}
+`;
+  }
   const systemPromptOverlay = await storage.session.getSystemPromptOverlay();
   if (systemPromptOverlay) {
     prompt += `
@@ -41236,7 +41401,7 @@ class Protocol {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1000;
-        await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
+        await new Promise((resolve5) => setTimeout(resolve5, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error2) {
@@ -41248,7 +41413,7 @@ class Protocol {
   }
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve5, reject) => {
       const earlyReject = (error2) => {
         reject(error2);
       };
@@ -41326,7 +41491,7 @@ class Protocol {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve4(parseResult.data);
+            resolve5(parseResult.data);
           }
         } catch (error2) {
           reject(error2);
@@ -41517,12 +41682,12 @@ class Protocol {
         interval = task.pollInterval;
       }
     } catch {}
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve5, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve4, interval);
+      const timeoutId = setTimeout(resolve5, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -42301,7 +42466,7 @@ class StdioClientTransport {
     if (this._process) {
       throw new Error("StdioClientTransport already started! If using Client class, note that connect() calls start() automatically.");
     }
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve5, reject) => {
       this._process = import_cross_spawn.default(this._serverParams.command, this._serverParams.args ?? [], {
         env: {
           ...getDefaultEnvironment(),
@@ -42317,7 +42482,7 @@ class StdioClientTransport {
         this.onerror?.(error2);
       });
       this._process.on("spawn", () => {
-        resolve4();
+        resolve5();
       });
       this._process.on("close", (_code) => {
         this._process = undefined;
@@ -42364,20 +42529,20 @@ class StdioClientTransport {
     if (this._process) {
       const processToClose = this._process;
       this._process = undefined;
-      const closePromise = new Promise((resolve4) => {
+      const closePromise = new Promise((resolve5) => {
         processToClose.once("close", () => {
-          resolve4();
+          resolve5();
         });
       });
       try {
         processToClose.stdin?.end();
       } catch {}
-      await Promise.race([closePromise, new Promise((resolve4) => setTimeout(resolve4, 2000).unref())]);
+      await Promise.race([closePromise, new Promise((resolve5) => setTimeout(resolve5, 2000).unref())]);
       if (processToClose.exitCode === null) {
         try {
           processToClose.kill("SIGTERM");
         } catch {}
-        await Promise.race([closePromise, new Promise((resolve4) => setTimeout(resolve4, 2000).unref())]);
+        await Promise.race([closePromise, new Promise((resolve5) => setTimeout(resolve5, 2000).unref())]);
       }
       if (processToClose.exitCode === null) {
         try {
@@ -42388,15 +42553,15 @@ class StdioClientTransport {
     this._readBuffer.clear();
   }
   send(message) {
-    return new Promise((resolve4) => {
+    return new Promise((resolve5) => {
       if (!this._process?.stdin) {
         throw new Error("Not connected");
       }
       const json = serializeMessage(message);
       if (this._process.stdin.write(json)) {
-        resolve4();
+        resolve5();
       } else {
-        this._process.stdin.once("drain", resolve4);
+        this._process.stdin.once("drain", resolve5);
       }
     });
   }
@@ -43970,7 +44135,7 @@ class SSEClientTransport {
   }
   _startOrAuth() {
     const fetchImpl = this?._eventSourceInit?.fetch ?? this._fetch ?? fetch;
-    return new Promise((resolve4, reject) => {
+    return new Promise((resolve5, reject) => {
       this._eventSource = new EventSource(this._url.href, {
         ...this._eventSourceInit,
         fetch: async (url2, init) => {
@@ -43991,7 +44156,7 @@ class SSEClientTransport {
       this._abortController = new AbortController;
       this._eventSource.onerror = (event) => {
         if (event.code === 401 && this._authProvider) {
-          this._authThenStart().then(resolve4, reject);
+          this._authThenStart().then(resolve5, reject);
           return;
         }
         const error2 = new SseError(event.code, event.message, event);
@@ -44012,7 +44177,7 @@ class SSEClientTransport {
           this.close();
           return;
         }
-        resolve4();
+        resolve5();
       });
       this._eventSource.onmessage = (event) => {
         const messageEvent = event;
@@ -45916,6 +46081,7 @@ async function runAgent(prompt, options) {
       });
     },
     onBeforeTurn: async () => {
+      refreshSkills();
       const content = await onBeforeTurn?.();
       if (content) {
         const injectedMsgId = Identifier.ascending("message");
@@ -47191,8 +47357,8 @@ async function runRepl(options) {
 }
 
 // src/version.ts
-var VERSION = "0.1.13";
-var GIT_HASH = "1d9eea4";
+var VERSION = "0.2.0";
+var GIT_HASH = "a0d9ba4";
 var VERSION_STRING = `miriad-code v${VERSION} (${GIT_HASH})`;
 
 // src/cli/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miriad-systems/nuum",
-  "version": "0.1.13",
+  "version": "0.2.0",
   "description": "AI coding agent with continuous memory - infinite context across sessions",
   "type": "module",
   "bin": {