@agentsky/sky 2.5.0 → 2.6.0

package/dist/index.js

@@ -64,7 +64,7 @@ function currentUniverse() {
 }
 
 // src/version.ts
-var CLI_VERSION = "2.5.0";
+var CLI_VERSION = "2.6.0";
 var USER_AGENT = `sky-cli/${CLI_VERSION} (${process.platform}; node/${process.versions.node})`;
 
 // src/api.ts
@@ -402,6 +402,62 @@ You are ${name}, a helpful long-lived agent.
   );
 }
 
+// src/catalog.ts
+var bare = (handle) => handle.replace(/^@/, "");
+var optionalAuth = () => ({ auth: Boolean(apiToken()) });
+function catalogQuery(filter) {
+  const params = new URLSearchParams();
+  if (filter.text?.trim()) params.set("q", filter.text.trim());
+  if (filter.category) params.set("category", filter.category);
+  const query = params.toString();
+  return query ? `?${query}` : "";
+}
+function listingBody(agentId, options) {
+  return {
+    agent_id: agentId,
+    handle: bare(options.handle),
+    tagline: options.tagline,
+    ...options.description ? { description: options.description } : {},
+    ...options.category?.length ? { categories: options.category } : {},
+    ...options.does?.length ? { does: options.does } : {},
+    ...options.doesNot?.length ? { does_not: options.doesNot } : {},
+    ...options.example?.length ? { examples: options.example } : {}
+  };
+}
+async function listCatalog(filter = {}) {
+  return (await api("GET", `/catalog/agents${catalogQuery(filter)}`, void 0, optionalAuth())).agents;
+}
+async function showCatalogAgent(handle) {
+  return (await api("GET", `/catalog/agents/${encodeURIComponent(bare(handle))}`, void 0, optionalAuth())).agent;
+}
+async function listCategories() {
+  return (await api("GET", "/catalog/categories", void 0, { auth: false })).categories;
+}
+async function publishListing(agentId, options) {
+  return (await api("POST", "/catalog/listings", listingBody(agentId, options))).agent;
+}
+async function removeListing(handle) {
+  await api("DELETE", `/catalog/listings/${encodeURIComponent(bare(handle))}`);
+}
+var uses = (agent2) => `${agent2.stats.uses} ${agent2.stats.uses === 1 ? "use" : "uses"}`;
+var mine = (agent2) => agent2.visibility === "workspace" ? "  (yours)" : "";
+function renderCatalogAgent(agent2) {
+  const section = (title, lines) => lines.length ? [`${title}:`, ...lines.map((line) => `  - ${line}`)] : [];
+  return [
+    `@${agent2.handle}  ${agent2.name}${mine(agent2)}`,
+    agent2.tagline,
+    ...agent2.description && agent2.description !== agent2.tagline ? ["", agent2.description] : [],
+    "",
+    `Categories: ${agent2.categories.join(", ") || "none"}`,
+    `Used: ${uses(agent2)}`,
+    ...section("Does", agent2.does),
+    ...section("Does not", agent2.does_not),
+    ...section("Examples", agent2.examples),
+    "",
+    `Hire it: sky session create @${agent2.handle} --message "\u2026"`
+  ].join("\n");
+}
+
 // src/clone.ts
 import { spawn } from "child_process";
 import { existsSync as existsSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
@@ -1647,10 +1703,10 @@ session.command("create <agent>").description("create a session (starts provisio
         console.log(JSON.stringify(created));
         return;
       }
-      console.log(`Created ${created.id} (${created.agent} \xB7 ${created.status})${created.default ? " [default]" : ""}`);
+      console.log(`Created ${created.id} (${created.agentId ?? "-"} \xB7 ${created.status})${created.default ? " [default]" : ""}`);
       printModelBilling(created);
       for (const r of created.resources ?? []) console.log(`  ${renderResource(r)}`);
-      console.log(`  sky agent message ${created.agent} "hello"`);
+      console.log(`  sky session message ${created.id} "hello"`);
     }
   )
 );
@@ -1664,7 +1720,7 @@ session.command("list [agent]").action(
     }
     for (const s of sessions) {
       console.log(
-        `${s.id.padEnd(24)} ${(s.agent ?? "-").padEnd(20)} ${(s.title ?? "").padEnd(16)} ${s.status}${s.default ? " *" : ""}`
+        `${s.id.padEnd(24)} ${(s.agentId ?? "-").padEnd(20)} ${(s.title ?? "").padEnd(16)} ${s.status}${s.default ? " *" : ""}`
       );
     }
   })
@@ -1676,7 +1732,7 @@ session.command("show <id>").action(
       `/sessions/${encodeURIComponent(id)}`
     );
     console.log(`${s.id}${s.default ? " [default]" : ""}`);
-    console.log(`  agent   ${s.agent ?? "-"}`);
+    console.log(`  agent   ${s.agentId ?? "-"}`);
     console.log(`  title   ${s.title ?? "-"}`);
     console.log(`  status  ${s.status}`);
     console.log(`  model   ${s.agentType} \xB7 ${s.llm}`);
@@ -1892,12 +1948,10 @@ async function chatLoop(sessionId, opts = {}) {
   await new Promise(() => {
   });
 }
-program.command("catalog").description("the agents that can be started by handle").command("search [words...]").description("find an agent for a piece of work; no words lists every agent").option("--category <category>", "only this category").option("--json", "print the full listings as JSON").action(
+var catalog = program.command("catalog").description("the agents that can be started by handle");
+catalog.command("search [words...]").description("find an agent for a piece of work; no words lists every agent; works without logging in").option("--category <category>", "only this category (see `sky catalog categories`)").option("--json", "print the full listings as JSON").action(
   run(async (words, opts) => {
-    const query = new URLSearchParams();
-    if (words.length) query.set("q", words.join(" "));
-    if (opts.category) query.set("category", opts.category);
-    const { agents } = await api("GET", `/catalog/agents${query.size ? `?${query}` : ""}`);
+    const agents = await listCatalog({ text: words.join(" "), category: opts.category });
     if (opts.json) {
       console.log(JSON.stringify(agents));
       return;
@@ -2302,6 +2356,30 @@ for (const [verb, method, suffix, blurb] of [
     })
   );
 }
+catalog.command("show <handle>").description("what one agent does, and how to hire it").option("--json", "print the raw listing").action(
+  run(async (handle, opts) => {
+    const agent2 = await showCatalogAgent(handle);
+    console.log(opts.json ? JSON.stringify(agent2, null, 2) : renderCatalogAgent(agent2));
+  })
+);
+catalog.command("categories").description("the categories a listing can carry").action(
+  run(async () => {
+    for (const category of await listCategories()) console.log(`${category.id.padEnd(10)} ${category.label}`);
+  })
+);
+catalog.command("publish <agent>").description("list one of your agents under a handle, visible to your workspace; publishing again replaces the listing").requiredOption("--handle <handle>", "the @handle people hire it by: 2 to 40 lower-case letters, digits or underscores").requiredOption("--tagline <text>", "one line on what it is for").option("--description <text>", "a longer description").option("--category <id>", "a category; repeat for several", collect).option("--does <text>", "something it does; repeat for several", collect).option("--does-not <text>", "something it does not do; repeat for several", collect).option("--example <text>", "an example request; repeat for several", collect).action(
+  run(async (agentId, opts) => {
+    const agent2 = await publishListing(agentId, opts);
+    console.log(`Listed @${agent2.handle} (${agent2.name})`);
+    console.log(`  sky session create @${agent2.handle} --message "\u2026"`);
+  })
+);
+catalog.command("unpublish <handle>").description("take down one of your workspace's listings; the agent itself is untouched").action(
+  run(async (handle) => {
+    await removeListing(handle);
+    console.log(`Removed @${handle.replace(/^@/, "")} from the catalog`);
+  })
+);
 program.command("config").description("show the CLI config location and current values").action(() => {
   const config = loadConfig();
   console.log(`config: ${configPath()}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentsky/sky",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "sky — the AgentSky developer CLI: launch and talk to long-lived agents from your terminal.",
   "license": "MIT",
   "type": "module",