@wrongstack/tools 0.313.0 → 0.316.1

package/dist/skill.js

@@ -1,219 +1,6 @@
-// src/skill.ts
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
 import {
-  missingRequiredRuntimeTools,
-  missingRuntimeCapabilities,
-  runtimeToolReferencesFromText
-} from "@wrongstack/core/agent-catalog";
-import { SKILL_LIMITS, stripFrontmatter } from "@wrongstack/core/skills";
-import { ToolValidationError } from "@wrongstack/core/types";
-var MAX_BODY_CHARS = SKILL_LIMITS.MAX_SKILL_BODY_CHARS;
-var MAX_RESOURCE_CHARS = SKILL_LIMITS.MAX_RESOURCE_CHARS;
-var MAX_LISTED_RESOURCES = SKILL_LIMITS.MAX_LISTED_RESOURCES;
-var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build"]);
-function makeSkillTool(skillLoader) {
-  return {
-    name: "skill",
-    category: "Skills",
-    description: "Load a skill's instructions or a bundled resource on demand (agentskills.io progressive disclosure). With only `name`: returns the SKILL.md body + a list of bundled resource files. With `name` + `resource` (a relative path like `references/REF.md` or `scripts/extract.py`): returns that file content. Prefer this over the read tool for skill files \u2014 it reaches foreign skills outside the project root.",
-    usageHint: 'Load a skill body or one of its bundled resources (progressive disclosure).\n\nWHEN TO USE:\n- A task matches a skill trigger \u2192 load the body: skill({ name })\n- You need a reference/template/script bundled with the skill \u2192 skill({ name, resource: "references/REF.md" })\n\nThe body call lists every bundled resource; load the ones you need. Run scripts via bash using the returned abs path.',
-    permission: "auto",
-    mutating: false,
-    capabilities: ["fs.read"],
-    icon: "document",
-    timeoutMs: 5e3,
-    inputSchema: {
-      type: "object",
-      properties: {
-        name: {
-          type: "string",
-          description: "Exact skill name (as shown in the available-skills list)."
-        },
-        resource: {
-          type: "string",
-          description: "Optional relative path of a bundled resource to load (e.g. references/REF.md, scripts/extract.py, assets/template.html). Omit to list resources."
-        }
-      },
-      required: ["name"]
-    },
-    async execute(input, ctx) {
-      const name = input?.name?.trim();
-      if (!name) {
-        throw new ToolValidationError({ message: "skill: name is required", field: "name" });
-      }
-      const manifest = await skillLoader.find(name);
-      if (!manifest) {
-        throw new ToolValidationError({
-          message: `skill "${name}" not found \u2014 use /skill to list available skills`,
-          field: "name"
-        });
-      }
-      const availableToolNames = (ctx?.catalogTools ?? ctx?.tools ?? []).map((tool) => tool.name);
-      const missingCapabilities = missingRuntimeCapabilities(
-        manifest.requiredCapabilities,
-        availableToolNames
-      );
-      const missingTools = missingRequiredRuntimeTools(manifest.requiredTools, availableToolNames);
-      if (missingCapabilities.length > 0 || missingTools.length > 0) {
-        throw new ToolValidationError({
-          message: `skill "${name}" is unavailable in this runtime; ` + [
-            missingCapabilities.length > 0 ? `missing capabilities: ${missingCapabilities.join(", ")}` : "",
-            missingTools.length > 0 ? `missing tools: ${missingTools.join(", ")}` : ""
-          ].filter(Boolean).join("; "),
-          field: "name"
-        });
-      }
-      const dir = path.dirname(manifest.path);
-      let loadedResource;
-      if (input.resource?.trim()) {
-        loadedResource = await loadResource(dir, input.resource.trim());
-      }
-      const raw = await skillLoader.readBody(name);
-      const missingBodyTools = missingRequiredRuntimeTools(
-        runtimeToolReferencesFromText(raw),
-        availableToolNames
-      );
-      const warning = missingBodyTools.length > 0 ? `Warning: skill "${name}" references tools not registered in this runtime: ${missingBodyTools.join(", ")}. Steps that call them may be unavailable.` : void 0;
-      const body = stripFrontmatter(raw).trim().slice(0, MAX_BODY_CHARS);
-      const resources = loadedResource ? [] : await listResources(dir);
-      try {
-        await ctx?.session?.append({
-          type: "skill_activated",
-          ts: (/* @__PURE__ */ new Date()).toISOString(),
-          skillName: manifest.name
-        });
-      } catch {
-      }
-      return {
-        name: manifest.name,
-        description: manifest.description,
-        body,
-        resources,
-        dir,
-        loadedResource,
-        warning
-      };
-    },
-    serialize(output) {
-      const warningLine = output.warning ? `
-
-${output.warning}` : "";
-      if (output.loadedResource) {
-        const lr = output.loadedResource;
-        const note = lr.truncated ? ` (truncated to ${lr.content.length} chars of ${lr.bytes} B)` : "";
-        return `# Resource: ${output.name}/${lr.rel}
-(abs path: ${lr.absPath})${note}
-
-${lr.content}${warningLine}`;
-      }
-      const head = `# Skill: ${output.name}
-${output.description}
-
-${output.body}`;
-      if (output.resources.length === 0) return `${head}${warningLine}`;
-      const listing = output.resources.map((r) => `- ${r.path} (${r.bytes} B)`).join("\n");
-      return `${head}
-
-## Bundled resources (load on demand)
-Load any with: \`skill({ name: "${output.name}", resource: "<path>" })\`. Run scripts via bash using their abs path under ${output.dir}.
-${listing}${warningLine}`;
-    }
-  };
-}
-async function loadResource(skillDir, rel) {
-  const norm = rel.replace(/\\/g, "/");
-  if (path.isAbsolute(rel) || norm.split("/").some((seg) => seg === "..")) {
-    throw new ToolValidationError({
-      message: `skill: invalid resource path "${rel}"`,
-      field: "resource"
-    });
-  }
-  const absPath = path.resolve(skillDir, rel);
-  const root = path.resolve(skillDir);
-  if (absPath !== root && !absPath.startsWith(root + path.sep)) {
-    throw new ToolValidationError({
-      message: `skill: resource "${rel}" escapes the skill directory`,
-      field: "resource"
-    });
-  }
-  let realPath;
-  let realRoot;
-  try {
-    realRoot = await fs.realpath(root);
-    realPath = await fs.realpath(absPath);
-  } catch {
-    throw new ToolValidationError({
-      message: `skill: resource "${rel}" not readable`,
-      field: "resource"
-    });
-  }
-  if (realPath !== realRoot && !realPath.startsWith(realRoot + path.sep)) {
-    throw new ToolValidationError({
-      message: `skill: resource "${rel}" resolves outside the skill directory`,
-      field: "resource"
-    });
-  }
-  let buf;
-  try {
-    buf = await fs.readFile(realPath);
-  } catch {
-    throw new ToolValidationError({
-      message: `skill: resource "${rel}" not readable`,
-      field: "resource"
-    });
-  }
-  const raw = buf.toString("utf8");
-  const truncated = raw.length > MAX_RESOURCE_CHARS;
-  return {
-    rel: norm,
-    // The canonical path — the one actually opened, and the one a follow-up
-    // `bash` invocation should use.
-    absPath: realPath,
-    content: truncated ? raw.slice(0, MAX_RESOURCE_CHARS) : raw,
-    bytes: buf.length,
-    truncated
-  };
-}
-async function listResources(skillDir) {
-  const out = [];
-  await walk(skillDir, skillDir, out);
-  out.sort((a, b) => a.path.localeCompare(b.path));
-  return out.slice(0, MAX_LISTED_RESOURCES);
-}
-async function walk(root, dir, out) {
-  if (out.length >= MAX_LISTED_RESOURCES) return;
-  let entries;
-  try {
-    entries = await fs.readdir(dir, { withFileTypes: true });
-  } catch {
-    return;
-  }
-  for (const e of entries) {
-    if (out.length >= MAX_LISTED_RESOURCES) return;
-    const fullPath = path.join(dir, e.name);
-    let isDir = e.isDirectory();
-    if (e.isSymbolicLink()) {
-      try {
-        isDir = (await fs.stat(fullPath)).isDirectory();
-      } catch {
-        continue;
-      }
-    }
-    if (isDir) {
-      if (SKIP_DIRS.has(e.name) || e.name.startsWith(".")) continue;
-      await walk(root, fullPath, out);
-    } else if (e.isFile()) {
-      if (e.name === "SKILL.md" || e.name === "SKILL.save.md") continue;
-      try {
-        const stat2 = await fs.stat(fullPath);
-        const rel = path.relative(root, fullPath).split(path.sep).join("/");
-        out.push({ path: rel, bytes: stat2.size });
-      } catch {
-      }
-    }
-  }
-}
+  makeSkillTool
+} from "./chunk-GOIZNNOA.js";
 export {
   makeSkillTool
 };

package/dist/spawn-background.d.ts

@@ -24,7 +24,7 @@
  *          nothing is lost by dropping DETACHED_PROCESS.
  */
 import { spawn } from 'node:child_process';
-export interface SpawnBackgroundOptions {
+interface SpawnBackgroundOptions {
     /**
      * Shell command string to execute (e.g. `"node --version"`, `"npm run dev"`).
      *