@agentskit/cli 0.12.0 → 0.13.1

package/dist/bin.cjs

@@ -4031,12 +4031,12 @@ function scaffoldAgent(schema) {
   return files;
 }
 async function writeScaffold(files, outDir, opts = {}) {
-  const { writeFile: writeFile3, mkdir: mkdir3, access } = await import('fs/promises');
-  const { dirname: dirname2, join: join6 } = await import('path');
+  const { writeFile: writeFile5, mkdir: mkdir5, access } = await import('fs/promises');
+  const { dirname: dirname4, join: join8 } = await import('path');
   const written = [];
   for (const f of files) {
-    const full = join6(outDir, f.path);
-    await mkdir3(dirname2(full), { recursive: true });
+    const full = join8(outDir, f.path);
+    await mkdir5(dirname4(full), { recursive: true });
     if (!opts.overwrite) {
       try {
         await access(full);
@@ -4044,7 +4044,7 @@ async function writeScaffold(files, outDir, opts = {}) {
       } catch {
       }
     }
-    await writeFile3(full, f.content, "utf8");
+    await writeFile5(full, f.content, "utf8");
     written.push(f.path);
   }
   return written;
@@ -4660,6 +4660,261 @@ rules failed: ${message}
     }
   });
 }
+var RAW_BASE = "https://raw.githubusercontent.com/AgentsKit-io/agentskit-registry/main";
+var HOSTED_BASE = `${RAW_BASE}/public/r`;
+async function getJson(url, fetchImpl) {
+  const res = await fetchImpl(url);
+  if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
+  return res.json();
+}
+async function getText(url, fetchImpl) {
+  const res = await fetchImpl(url);
+  if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
+  return res.text();
+}
+async function fetchAgent(id, options = {}) {
+  const fetchImpl = options.fetchImpl ?? globalThis.fetch;
+  try {
+    const hosted = await getJson(`${HOSTED_BASE}/${id}.json`, fetchImpl);
+    if (hosted?.sources?.length) return hosted;
+    throw new Error("hosted entry missing sources");
+  } catch {
+    const meta = await getJson(`${RAW_BASE}/registry/${id}/meta.json`, fetchImpl);
+    const sources = await Promise.all(
+      meta.files.map(async (rel) => ({
+        path: rel,
+        content: await getText(`${RAW_BASE}/registry/${id}/${rel}`, fetchImpl)
+      }))
+    );
+    return { ...meta, sources };
+  }
+}
+function resolveSystemPrompt(agent) {
+  if (agent.skill?.systemPrompt) return agent.skill.systemPrompt;
+  const src = agent.sources.find((f) => f.path === "agent.ts")?.content;
+  if (!src) return null;
+  const m = src.match(/systemPrompt:\s*`((?:\\.|[^`\\])*)`/);
+  return m ? m[1].replace(/\\`/g, "`").replace(/\\\$\{/g, "${") : null;
+}
+async function defaultExists(path5) {
+  const { access } = await import('fs/promises');
+  try {
+    await access(path5);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function addAgent(id, options = {}) {
+  const agent = await fetchAgent(id, options);
+  const baseDir = options.outDir ?? "agents";
+  const targetDir = path.join(baseDir, id);
+  const exists = options.existsImpl ?? defaultExists;
+  const write = options.writeFileImpl ?? (async (path5, content) => {
+    await promises.mkdir(path.dirname(path5), { recursive: true });
+    await promises.writeFile(path5, content, "utf8");
+  });
+  const written = [];
+  for (const file of agent.sources) {
+    const dest = path.join(targetDir, file.path);
+    if (!options.force && await exists(dest)) {
+      throw new Error(`${dest} already exists (re-run with --force to overwrite)`);
+    }
+    await write(dest, file.content);
+    written.push(dest);
+  }
+  return { agent, written, targetDir };
+}
+function lineDiff(a, b) {
+  const x = a.split("\n");
+  const y = b.split("\n");
+  const m = x.length;
+  const n = y.length;
+  const lcs = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i2 = m - 1; i2 >= 0; i2--) {
+    for (let j2 = n - 1; j2 >= 0; j2--) {
+      lcs[i2][j2] = x[i2] === y[j2] ? lcs[i2 + 1][j2 + 1] + 1 : Math.max(lcs[i2 + 1][j2], lcs[i2][j2 + 1]);
+    }
+  }
+  const out = [];
+  let i = 0;
+  let j = 0;
+  while (i < m && j < n) {
+    if (x[i] === y[j]) {
+      out.push({ type: " ", text: x[i] });
+      i++;
+      j++;
+    } else if (lcs[i + 1][j] >= lcs[i][j + 1]) {
+      out.push({ type: "-", text: x[i++] });
+    } else {
+      out.push({ type: "+", text: y[j++] });
+    }
+  }
+  while (i < m) out.push({ type: "-", text: x[i++] });
+  while (j < n) out.push({ type: "+", text: y[j++] });
+  return out;
+}
+async function diffAgent(id, options = {}) {
+  const agent = await fetchAgent(id, options);
+  const targetDir = path.join(options.outDir ?? "agents", id);
+  const readLocal = options.readFileImpl ?? (async (p) => {
+    const { readFile: readFile6 } = await import('fs/promises');
+    try {
+      return await readFile6(p, "utf8");
+    } catch {
+      return null;
+    }
+  });
+  const files = [];
+  for (const f of agent.sources) {
+    const local = await readLocal(path.join(targetDir, f.path));
+    if (local == null) {
+      files.push({ path: f.path, status: "missing-local", upstream: f.content });
+    } else if (local === f.content) {
+      files.push({ path: f.path, status: "unchanged", upstream: f.content });
+    } else {
+      files.push({ path: f.path, status: "modified", diff: lineDiff(local, f.content), upstream: f.content });
+    }
+  }
+  return { agent, targetDir, files };
+}
+
+// src/commands/add.ts
+function registerAddCommand(program) {
+  program.command("add <agent>").description(
+    'Add a ready-made agent from the AgentsKit registry (registry.agentskit.io). Copies the agent source into your project \u2014 you own the code. With --run, also executes it. e.g. `agentskit add research` or `agentskit add legal-contract-reviewer --run "review this NDA\u2026" --provider ollama`.'
+  ).option("--out <dir>", "Directory to write the agent into (default: ./agents)").option("-f, --force", "Overwrite existing files").option("--run <task>", "Run the agent on this task right after adding it").option("--provider <provider>", "Provider for --run (openai, anthropic, gemini, ollama, demo)", "demo").option("--model <model>", "Model for --run").option("--api-key <key>", "API key for --run (else read from the provider env var)").action(
+    async (agent, options) => {
+      try {
+        const result = await addAgent(agent, { outDir: options.out, force: options.force === true });
+        process.stdout.write(`
+Added "${result.agent.title}" \u2192 ${result.targetDir}/
+`);
+        for (const f of result.written) process.stdout.write(`  wrote  ${f}
+`);
+        if (result.agent.packages.length > 0) {
+          process.stdout.write(`
+Install the packages it uses:
+`);
+          process.stdout.write(`  npm install ${result.agent.packages.join(" ")} @agentskit/adapters
+`);
+        }
+        const required = (result.agent.env ?? []).filter((e) => e.required);
+        if (required.length > 0) {
+          process.stdout.write(`
+Required environment:
+`);
+          for (const e of required) process.stdout.write(`  ${e.name} \u2014 ${e.description}
+`);
+        }
+        const readme2 = result.written.find((f) => f.toLowerCase().endsWith("readme.md"));
+        process.stdout.write(readme2 ? `
+See ${readme2} for usage.
+` : "\n");
+        if (options.run) {
+          const systemPrompt = resolveSystemPrompt(result.agent);
+          if (!systemPrompt) {
+            process.stderr.write(
+              `
+--run is not supported for "${agent}" (it composes tools/keys). Use it as a library \u2014 see the README.
+`
+            );
+            process.exit(1);
+          }
+          process.stdout.write(`
+Running "${result.agent.title}" via ${options.provider}\u2026
+
+`);
+          await runAgent(options.run, {
+            provider: options.provider,
+            model: options.model,
+            apiKey: options.apiKey,
+            systemPrompt,
+            maxSteps: "8"
+          });
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`
+add failed: ${message}
+`);
+        process.stderr.write(`(browse agents at https://registry.agentskit.io)
+`);
+        process.exit(1);
+      }
+    }
+  );
+}
+function registerDiffCommand(program) {
+  program.command("diff <agent>").description("Show how your local copy of a registry agent differs from the current registry source.").option("--out <dir>", "Directory the agent was added into (default: ./agents)").action(async (agent, options) => {
+    try {
+      const { targetDir, files } = await diffAgent(agent, { outDir: options.out });
+      let changed = 0;
+      for (const f of files) {
+        if (f.status === "unchanged") continue;
+        changed++;
+        process.stdout.write(`
+${f.status === "missing-local" ? "missing" : "modified"}: ${path.join(targetDir, f.path)}
+`);
+        if (f.diff) {
+          for (const line of f.diff) {
+            if (line.type === " ") continue;
+            process.stdout.write(`  ${line.type} ${line.text}
+`);
+          }
+        }
+      }
+      process.stdout.write(
+        changed === 0 ? `
+${agent}: up to date with the registry.
+` : `
+${changed} file(s) differ. Run \`agentskit update ${agent}\` to apply the registry version.
+`
+      );
+    } catch (err) {
+      process.stderr.write(`
+diff failed: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
+function registerUpdateCommand(program) {
+  program.command("update <agent>").description("Update your local copy of a registry agent to the current registry source.").option("--out <dir>", "Directory the agent was added into (default: ./agents)").option("-f, --force", "Apply without listing the changes first").action(async (agent, options) => {
+    try {
+      const { targetDir, files } = await diffAgent(agent, { outDir: options.out });
+      const changed = files.filter((f) => f.status !== "unchanged");
+      if (changed.length === 0) {
+        process.stdout.write(`
+${agent}: already up to date.
+`);
+        return;
+      }
+      if (!options.force) {
+        process.stdout.write(`
+Will overwrite ${changed.length} file(s) with the registry version:
+`);
+        for (const f of changed) process.stdout.write(`  ${f.path} (${f.status})
+`);
+      }
+      for (const f of changed) {
+        const dest = path.join(targetDir, f.path);
+        await promises.mkdir(path.dirname(dest), { recursive: true });
+        await promises.writeFile(dest, f.upstream, "utf8");
+        process.stdout.write(`  updated ${dest}
+`);
+      }
+      process.stdout.write(`
+Updated ${agent}. Review the changes with your VCS before committing.
+`);
+    } catch (err) {
+      process.stderr.write(`
+update failed: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
 
 // src/commands/index.ts
 function createCli() {
@@ -4677,6 +4932,9 @@ function createCli() {
   registerFlowCommand(program);
   registerPiiCommand(program);
   registerRulesCommand(program);
+  registerAddCommand(program);
+  registerDiffCommand(program);
+  registerUpdateCommand(program);
   return program;
 }