@workbench-ai/workbench 0.0.73 → 0.0.75

package/dist/fanout.d.ts

@@ -0,0 +1,13 @@
+export interface FanOutResult {
+    status: "completed" | "skipped" | "failed";
+    command: string;
+    linkedAgents: string[];
+    additionalAgents?: number;
+    reason?: string;
+    exitCode?: number | null;
+}
+export declare function fanOutSkill(name: string, options: {
+    skillDir: string;
+}): Promise<FanOutResult>;
+export declare function manualFanOutCommand(skillDir: string, name: string): string;
+//# sourceMappingURL=fanout.d.ts.map

package/dist/fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../src/fanout.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAoEpG;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO1E"}

package/dist/fanout.js

@@ -0,0 +1,223 @@
+import { spawn } from "node:child_process";
+import { promises as fs } from "node:fs";
+import { createRequire } from "node:module";
+import os from "node:os";
+import path from "node:path";
+const require = createRequire(import.meta.url);
+const FANOUT_TIMEOUT_MS = 30_000;
+export async function fanOutSkill(name, options) {
+    const resolved = await resolveSkillsBin().catch((error) => ({
+        binPath: null,
+        reason: error instanceof Error ? error.message : "Unable to resolve skills package.",
+    }));
+    const command = manualFanOutCommand(options.skillDir, name);
+    if (!resolved.binPath) {
+        return {
+            status: "skipped",
+            command,
+            linkedAgents: [],
+            reason: resolved.reason,
+        };
+    }
+    const stagingRoot = await fs.mkdtemp(path.join(os.tmpdir(), "workbench-skills-fanout-"));
+    const stagedSkillDir = path.join(stagingRoot, name);
+    try {
+        await fs.cp(options.skillDir, stagedSkillDir, {
+            recursive: true,
+            force: true,
+            dereference: true,
+        });
+        const args = [
+            resolved.binPath,
+            "add",
+            stagedSkillDir,
+            "--global",
+            "--yes",
+        ];
+        const child = await runNode(args, minimalChildEnv(process.env), FANOUT_TIMEOUT_MS);
+        const { linkedAgents, additionalAgents } = parseFanOutAgents(`${child.stdout}\n${child.stderr}`);
+        if (child.timedOut) {
+            return {
+                status: "failed",
+                command,
+                linkedAgents,
+                ...(additionalAgents > 0 ? { additionalAgents } : {}),
+                reason: `skills fan-out timed out after ${FANOUT_TIMEOUT_MS}ms.`,
+                exitCode: child.exitCode,
+            };
+        }
+        if (child.exitCode !== 0) {
+            return {
+                status: "failed",
+                command,
+                linkedAgents,
+                ...(additionalAgents > 0 ? { additionalAgents } : {}),
+                reason: conciseFailureReason(`${child.stdout}\n${child.stderr}`) ?? `skills fan-out exited ${child.exitCode}.`,
+                exitCode: child.exitCode,
+            };
+        }
+        return {
+            status: "completed",
+            command,
+            linkedAgents,
+            ...(additionalAgents > 0 ? { additionalAgents } : {}),
+            exitCode: child.exitCode,
+        };
+    }
+    catch (error) {
+        return {
+            status: "failed",
+            command,
+            linkedAgents: [],
+            reason: error instanceof Error ? error.message : "skills fan-out failed.",
+        };
+    }
+    finally {
+        await fs.rm(stagingRoot, { recursive: true, force: true });
+    }
+}
+export function manualFanOutCommand(skillDir, name) {
+    const quotedName = quoteShellArg(name);
+    return [
+        "tmpdir=$(mktemp -d)",
+        `cp -R ${quoteShellArg(skillDir)} "$tmpdir"/${quotedName}`,
+        `skills add "$tmpdir"/${quotedName} --global --yes`,
+    ].join(" && ");
+}
+function quoteShellArg(value) {
+    return /^[A-Za-z0-9_./:=@+-]+$/u.test(value)
+        ? value
+        : `'${value.replace(/'/gu, "'\\''")}'`;
+}
+async function resolveSkillsBin() {
+    const packageJsonPath = require.resolve("skills/package.json");
+    const packageRoot = path.dirname(packageJsonPath);
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+    const bin = typeof packageJson.bin === "string" ? packageJson.bin : packageJson.bin?.skills;
+    if (!bin) {
+        throw new Error("The skills package does not declare a skills bin.");
+    }
+    return {
+        binPath: path.resolve(packageRoot, bin),
+    };
+}
+function runNode(args, env, timeoutMs) {
+    return new Promise((resolve) => {
+        const child = spawn(process.execPath, args, {
+            env,
+            stdio: ["ignore", "pipe", "pipe"],
+            windowsHide: true,
+        });
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill("SIGTERM");
+        }, timeoutMs);
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            resolve({
+                exitCode: 1,
+                stdout,
+                stderr: stderr || error.message,
+                timedOut,
+            });
+        });
+        child.on("close", (exitCode) => {
+            clearTimeout(timer);
+            resolve({
+                exitCode,
+                stdout,
+                stderr,
+                timedOut,
+            });
+        });
+    });
+}
+// The skills CLI changes behavior when it detects it is running inside an
+// agent (via @vercel/detect-agent reading agent-specific environment
+// variables). Fan-out must always run in machine mode, so the child gets a
+// minimal allowlisted environment instead of a hand-maintained blacklist of
+// every agent's marker variables.
+function minimalChildEnv(env) {
+    const allowed = [
+        "PATH",
+        "HOME",
+        "USER",
+        "SHELL",
+        "TMPDIR",
+        "TMP",
+        "TEMP",
+        "LANG",
+        "NODE_EXTRA_CA_CERTS",
+        "HTTP_PROXY",
+        "HTTPS_PROXY",
+        "NO_PROXY",
+        "http_proxy",
+        "https_proxy",
+        "no_proxy",
+        "SYSTEMROOT",
+        "SystemRoot",
+        "COMSPEC",
+        "APPDATA",
+        "LOCALAPPDATA",
+        "USERPROFILE",
+    ];
+    const next = {};
+    for (const key of Object.keys(env)) {
+        if (allowed.includes(key) || key.startsWith("XDG_") || key.startsWith("LC_")) {
+            next[key] = env[key];
+        }
+    }
+    return next;
+}
+function parseFanOutAgents(output) {
+    const cleaned = stripAnsi(output);
+    const linked = new Set();
+    let additionalAgents = 0;
+    for (const line of cleaned.split(/\r?\n/u)) {
+        const normalized = line.replace(/[\u2502\u25c7\u25cf\u25a0\u2713\u2717]/gu, " ").trim();
+        const match = /^(?:universal|symlinked|copied|copy\s*\u2192|symlink\s*\u2192):\s*(.+)$/u.exec(normalized);
+        if (!match) {
+            continue;
+        }
+        for (const rawAgent of match[1].split(",").map((entry) => entry.trim())) {
+            const moreMatch = /\+(\d+) more$/u.exec(rawAgent);
+            if (moreMatch) {
+                additionalAgents += Number(moreMatch[1]);
+            }
+            const agent = rawAgent.replace(/\s*\+\d+ more$/u, "").trim();
+            if (agent) {
+                linked.add(agent);
+            }
+        }
+    }
+    return {
+        linkedAgents: [...linked].sort((left, right) => left.localeCompare(right)),
+        additionalAgents,
+    };
+}
+function conciseFailureReason(output) {
+    const lines = stripAnsi(output)
+        .split(/\r?\n/u)
+        .map((line) => line.replace(/[\u2500-\u257f\u25a0\u25cf\u25c7\u2713\u2717]/gu, " ").trim())
+        .filter((line) => line.length > 0 &&
+        !/^skills\s*$/iu.test(line) &&
+        !/^Tip:/u.test(line) &&
+        !/^(Source|Local path|Found \d+ skill|Available skills|Installed \d+ skill|Done!|Review skills)/u.test(line) &&
+        !/^- /u.test(line));
+    const reason = lines.at(-1);
+    return reason ? (reason.length > 200 ? `${reason.slice(0, 197)}...` : reason) : null;
+}
+function stripAnsi(value) {
+    return value.replace(/\x1B\[[0-?]*[ -/]*[@-~]/gu, "");
+}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2DA,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B;AAsUD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,KAGzD,GAAG,OAAO,CAAC,MAAM,CAAC,CAiMlB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgEA,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B;AAuTD,wBAAsB,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAE,KAGzD,GAAG,OAAO,CAAC,MAAM,CAAC,CAoMlB"}