@agentsky/sky 2.4.0 → 2.5.0

package/dist/{chunk-FSAF6HIL.js → chunk-MHL5Z6IQ.js}

@@ -18984,7 +18984,8 @@ var MODEL_REASONING_EFFORTS = {
   "gemini-3.5-flash": ["low", "medium", "high"],
   "glm-5.3": ["low", "high", "max"],
   "glm-5.3-flash": ["low", "high", "max"],
-  "grok-4.6": ["low", "medium", "high"]
+  "grok-4.6": ["low", "medium", "high"],
+  "grok-4.7": ["low", "medium", "high", "xhigh"]
 };
 var REASONING_EFFORTS = {
   agoragentic_acp: null,
@@ -21200,6 +21201,10 @@ var questionSchema = external_exports.object({
   blocksGoal: external_exports.boolean().optional(),
   /** Informational deadline. Passing it never approves or answers the question. */
   dueAt: external_exports.string().datetime({ offset: true }).optional(),
+  /** Hard permission deadline; unlike dueAt, later answers are refused. */
+  expiresAt: external_exports.string().datetime({ offset: true }).optional(),
+  /** The owner withdrew this question. Never a human answer or consent. */
+  cancelledAt: external_exports.string().datetime({ offset: true }).optional(),
   /** What the platform is asking for when the question is one of its own
    *  requests rather than an agent's free question. Absent on an ordinary question. */
   kind: external_exports.enum(QUESTION_REQUEST_KINDS).optional(),
@@ -22151,11 +22156,38 @@ function isCompatible(agentType, llm) {
 function defaultLlm(agentType) {
   return allowedLlms[agentType][0];
 }
+var CHATGPT_PLAN_MODELS = /* @__PURE__ */ new Set([
+  "gpt-6-astra",
+  "gpt-5.6-sol",
+  "gpt-5.6-terra",
+  "gpt-5.6-luna",
+  "gpt-5.5"
+]);
+var CLAUDE_PLAN_MODELS = /* @__PURE__ */ new Set([
+  "claude-opus-5",
+  "claude-fable-5-1",
+  "claude-sonnet-5",
+  "claude-haiku-4-5",
+  "claude-sonnet-4-6",
+  "claude-opus-4-8",
+  "claude-fable-5"
+]);
 function modelSubscriptionProviderFor(agentType, llm) {
-  if (agentType === "claude_code" && llm.startsWith("claude-")) return "anthropic";
-  if (agentType === "codex" && llm.startsWith("gpt-")) return "openai";
+  if (agentType === "claude_code" && CLAUDE_PLAN_MODELS.has(llm)) return "anthropic";
+  if (agentType === "codex" && CHATGPT_PLAN_MODELS.has(llm)) return "openai";
+  if (agentType === "cursor" && llm === "harness-default") return "cursor";
   return null;
 }
+var MODEL_SUBSCRIPTION_PROVIDER_NAME = {
+  anthropic: "Claude",
+  openai: "ChatGPT",
+  cursor: "Cursor"
+};
+var MODEL_SUBSCRIPTION_PLAN_PHRASE = {
+  anthropic: "Claude subscription",
+  openai: "ChatGPT plan",
+  cursor: "Cursor plan"
+};
 var AGENT_TYPE_META = {
   ...Object.fromEntries(ACP_AGENT_TYPES.map((agentType) => [agentType, {
     label: ACP_AGENTS[agentType].label,
@@ -22250,8 +22282,7 @@ var skillRefSchema = external_exports.discriminatedUnion("type", [
   storeSkillRefSchema,
   githubSkillRefSchema
 ]);
-var MAX_SKILLS_PER_AGENT = 20;
-var skillsArraySchema = external_exports.array(skillRefSchema).max(MAX_SKILLS_PER_AGENT, `At most ${MAX_SKILLS_PER_AGENT} skills per agent.`).superRefine((arr, ctx) => {
+var skillsArraySchema = external_exports.array(skillRefSchema).superRefine((arr, ctx) => {
   const targets = arr.map((s) => s.type === "skill" ? `skill:${s.skillId}` : `github:${s.url}`);
   if (new Set(targets).size !== targets.length) {
     ctx.addIssue({ code: "custom", message: "Duplicate skill entries." });
@@ -22312,6 +22343,50 @@ var hookSchema = external_exports.object({
   path: ["matcher"]
 });
 var hooksSchema = external_exports.array(hookSchema).max(20);
+var POLICY_ACTIONS = ["allow", "ask", "deny"];
+var toolCallPolicyConfigSchema = external_exports.object({
+  action: external_exports.enum(POLICY_ACTIONS),
+  matcher: external_exports.string().min(1).max(255).refine((v) => /^(?:[A-Za-z0-9_:.-]|\.\*)+(?:\|(?:[A-Za-z0-9_:.-]|\.\*)+)*$/.test(v), {
+    message: "matcher must be tool names or patterns separated by |"
+  }).optional(),
+  commandPatterns: external_exports.array(external_exports.string().min(1).max(500)).max(20).optional()
+}).strict();
+var spendCapPolicyConfigSchema = external_exports.object({
+  warnUsdMicros: external_exports.number().int().min(0).nullish(),
+  hardCapUsdMicros: external_exports.number().int().min(1)
+}).strict().refine((c) => !c.warnUsdMicros || c.warnUsdMicros < c.hardCapUsdMicros, {
+  message: "warnUsdMicros must be less than hardCapUsdMicros"
+});
+var callCountPolicyConfigSchema = external_exports.object({ limitPerSession: external_exports.number().int().min(1).max(1e5) }).strict();
+var capabilityPolicyConfigSchema = external_exports.record(external_exports.string(), external_exports.enum(POLICY_ACTIONS)).superRefine((obj, ctx) => {
+  for (const k of Object.keys(obj)) {
+    if (!CAPABILITY_IDS.includes(k)) {
+      ctx.addIssue({ code: "custom", message: `unknown capability id: ${k}`, path: [k] });
+    }
+  }
+});
+var policyRuleBaseSchema = external_exports.object({
+  name: external_exports.string().min(1).max(128),
+  enabled: external_exports.boolean().default(true),
+  position: external_exports.number().int().min(0).max(9999).default(0)
+});
+var policyRuleSchema = external_exports.discriminatedUnion("kind", [
+  policyRuleBaseSchema.extend({ kind: external_exports.literal("TOOL_CALL"), config: toolCallPolicyConfigSchema }),
+  policyRuleBaseSchema.extend({ kind: external_exports.literal("SPEND_CAP"), config: spendCapPolicyConfigSchema }),
+  policyRuleBaseSchema.extend({ kind: external_exports.literal("CALL_COUNT"), config: callCountPolicyConfigSchema }),
+  policyRuleBaseSchema.extend({ kind: external_exports.literal("CAPABILITY"), config: capabilityPolicyConfigSchema })
+]);
+var policyRulePatchSchema = external_exports.object({
+  name: external_exports.string().min(1).max(128).optional(),
+  enabled: external_exports.boolean().optional(),
+  position: external_exports.number().int().min(0).max(9999).optional(),
+  config: external_exports.union([
+    toolCallPolicyConfigSchema,
+    spendCapPolicyConfigSchema,
+    callCountPolicyConfigSchema,
+    capabilityPolicyConfigSchema
+  ]).optional()
+});
 var packagesSchema = external_exports.object({
   apt: external_exports.array(packageNameSchema).max(32).default([]),
   pip: external_exports.array(packageNameSchema).max(32).default([]),
@@ -22351,6 +22426,7 @@ var capabilityPoliciesSchema = external_exports.record(
   capabilityIdInputSchema,
   capabilityPermissionPolicySchema
 );
+var nativeToolPolicySchema = external_exports.enum(["always_allow", "always_ask"]);
 var publishSchema = external_exports.object({
   name: external_exports.string().trim().min(1, "Give your agent a name."),
   description: external_exports.string().default(""),
@@ -22398,6 +22474,8 @@ export {
   supersededBy,
   defaultLlm,
   modelSubscriptionProviderFor,
+  MODEL_SUBSCRIPTION_PROVIDER_NAME,
+  MODEL_SUBSCRIPTION_PLAN_PHRASE,
   capabilitiesSchema,
   instructionFileSchema,
   skillRefSchema,

package/dist/index.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 import {
   AGENT_TYPES,
+  MODEL_SUBSCRIPTION_PLAN_PHRASE,
+  MODEL_SUBSCRIPTION_PROVIDER_NAME,
   REASONING_EFFORT_VALUES,
   capabilitiesSchema,
   customDataSchema,
@@ -14,10 +16,10 @@ import {
   skillRefSchema,
   splitMcpServers,
   supersededBy
-} from "./chunk-FSAF6HIL.js";
+} from "./chunk-MHL5Z6IQ.js";
 
 // src/index.ts
-import { existsSync as existsSync5, writeFileSync as writeFileSync4 } from "fs";
+import { existsSync as existsSync6, writeFileSync as writeFileSync5 } from "fs";
 import { basename as basename3, resolve as resolve3 } from "path";
 import { createInterface as createInterface3 } from "readline";
 import { Command } from "commander";
@@ -62,7 +64,7 @@ function currentUniverse() {
 }
 
 // src/version.ts
-var CLI_VERSION = "2.4.0";
+var CLI_VERSION = "2.5.0";
 var USER_AGENT = `sky-cli/${CLI_VERSION} (${process.platform}; node/${process.versions.node})`;
 
 // src/api.ts
@@ -165,7 +167,7 @@ async function resolveSessionRef(ref) {
   return agent2.defaultSessionId;
 }
 async function* streamEvents(sessionId, signal) {
-  const { parseSseStream } = await import("./src-67OBSB2Q.js");
+  const { parseSseStream } = await import("./src-GLBJHVIJ.js");
   const res = await fetch(
     `${apiBase()}/sessions/${encodeURIComponent(sessionId)}/stream`,
     {
@@ -1073,6 +1075,33 @@ async function headlessLogin(verifier, challenge) {
   throw new Error("login timed out after 10 minutes");
 }
 
+// src/local-agents.ts
+import { existsSync as existsSync4 } from "fs";
+import { homedir as homedir4 } from "os";
+import { join as join4 } from "path";
+function localAgents(env = process.env, home = homedir4()) {
+  const claude = env.CLAUDE_CONFIG_DIR || join4(home, ".claude");
+  const codex = env.CODEX_HOME || join4(home, ".codex");
+  const cursor = join4(home, ".cursor");
+  return [
+    { id: "claude_code", name: "Claude Code", root: claude, skillsDir: join4(claude, "skills") },
+    { id: "codex", name: "Codex", root: codex, skillsDir: join4(codex, "skills") },
+    { id: "cursor", name: "Cursor", root: cursor, skillsDir: join4(cursor, "skills") }
+  ];
+}
+function detectLocalAgents(env = process.env, home = homedir4()) {
+  return localAgents(env, home).filter((agent2) => existsSync4(agent2.root));
+}
+function selectLocalAgents(ids, env = process.env, home = homedir4()) {
+  if (!ids?.length) return detectLocalAgents(env, home);
+  const known = localAgents(env, home);
+  return ids.map((id) => {
+    const agent2 = known.find((candidate) => candidate.id === id);
+    if (!agent2) throw new Error(`unknown agent ${id} \u2014 expected ${known.map((candidate) => candidate.id).join(" | ")}`);
+    return agent2;
+  });
+}
+
 // src/render.ts
 var dim = (s) => `\x1B[2m${s}\x1B[0m`;
 var red = (s) => `\x1B[31m${s}\x1B[0m`;
@@ -1116,11 +1145,159 @@ function renderEvent(event, data) {
   }
 }
 
+// src/session-read.ts
+var TURN_TYPES = ["user.message", "agent.message", "session.status_idle", "session.status_terminated", "session.error"];
+function latestTurn(events) {
+  let start = 0;
+  for (let index = events.length - 1; index >= 0; index -= 1) {
+    if (events[index].type === "user.message") {
+      start = index + 1;
+      break;
+    }
+  }
+  const reading = { finished: false, messages: [], errors: [] };
+  for (const event of events.slice(start)) {
+    if (event.type === "agent.message" && event.text?.trim()) reading.messages.push(event.text);
+    else if (event.type === "session.error" && event.error?.retry_status !== "retrying") {
+      reading.errors.push(event.error?.message ?? event.error?.type ?? "unknown error");
+    } else if (event.type === "session.status_terminated") reading.finished = true;
+    else if (event.type === "session.status_idle" && event.stop_reason?.type !== "requires_action") reading.finished = true;
+  }
+  return reading;
+}
+async function history(sessionId) {
+  const events = [];
+  let cursor = null;
+  for (; ; ) {
+    const query = new URLSearchParams({ limit: "500" });
+    for (const type of TURN_TYPES) query.append("types[]", type);
+    if (cursor) query.set("cursor", cursor);
+    const page = await api(
+      "GET",
+      `/sessions/${encodeURIComponent(sessionId)}/events?${query}`
+    );
+    events.push(...page.events);
+    if (!page.hasMore || !page.cursor) return events;
+    cursor = page.cursor;
+  }
+}
+async function readTurn(sessionId, opts = {}) {
+  const deadline = Date.now() + (opts.timeoutSeconds ?? 600) * 1e3;
+  for (; ; ) {
+    const reading = latestTurn(await history(sessionId));
+    if (reading.finished || !opts.wait || Date.now() >= deadline) return reading;
+    await new Promise((resolve4) => setTimeout(resolve4, opts.intervalMs ?? 3e3));
+  }
+}
+
+// src/skill.ts
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
+import { join as join5 } from "path";
+var SKILL_NAME = "agentsky";
+var SKILL_MARKER = ".agentsky.json";
+function skillDocument() {
+  return `---
+name: ${SKILL_NAME}
+description: Hand part of a job to another agent running in the cloud through AgentSky, and bring its result back. Use when the person asks for another agent or a named engine (Claude Code, Codex, Hermes, OpenClaw and others) to do, test or review something, or when independent work could run in parallel.
+---
+
+# Working with other agents through AgentSky
+
+AgentSky runs long-lived agents in the cloud. With the \`sky\` command you can
+find one, give it a job, and read what it produced. You stay responsible for
+the result.
+
+If the \`agentsky\` MCP tools are available in this session (\`search_catalog\`,
+\`start_session\`, \`read_session\`, \`send_message\`), use them instead of the
+commands below; they do the same things.
+
+## Before you start
+
+Run \`sky auth whoami\`. If it says you are not logged in, ask the person to run
+\`sky auth login\` and stop there. Never ask them for a token.
+
+## When to hand work over
+
+- When the person asks another agent to do, test or review something, do that.
+  Honor an agent or engine they name.
+- Otherwise, hand over work another agent is better suited to, or independent
+  parts that can run at the same time as your own.
+- Do the work yourself when it is small, when it depends on what you already
+  have in front of you, or when explaining it would take as long as doing it.
+
+## How to pick
+
+\`sky catalog search <words for the work> --json\`
+
+Each result has a \`handle\`, what the agent does, its \`engine_type\`, its
+categories, how it is paid, and what it needs. If the person names an engine,
+match its \`engine_type\` and do not substitute another one silently. Run the
+command with no words to see every agent. If nothing fits, do the work
+yourself and say so.
+
+## How to brief
+
+\`sky session create @<handle> --title "<short name>" --message "<brief>" --json\`
+
+It prints the new session's \`id\`. The agent starts working at once, on its own
+computer in the cloud. It cannot see this conversation or this machine, so a
+brief is one self-contained message that states:
+
+1. what to produce,
+2. what "done" means,
+3. anything it must not do.
+
+To give it a file, add \`--file <path>\`. Never put a password, key or token in a
+brief.
+
+## How to collect
+
+\`sky session read <session id> --wait --json\`
+
+It waits until the agent finishes its turn and prints its messages, with
+\`finished\` true or false. If \`finished\` is false the wait timed out: run it
+again. A first turn can take a minute to begin while the agent's computer
+starts.
+
+To correct it, answer it or ask for more:
+
+\`sky session message <session id> "<text>" --detach\`
+
+then read again. An agent saying it is done is not evidence: check what it
+produced before you rely on it.
+
+## How to finish
+
+Tell the person what was done and which agent did which part. Every agent you
+start is paid for by the person, so start only what the job needs.
+`;
+}
+function installedVersion(dir) {
+  try {
+    const marker = JSON.parse(readFileSync6(join5(dir, SKILL_MARKER), "utf8"));
+    return typeof marker.version === "string" ? marker.version : null;
+  } catch {
+    return null;
+  }
+}
+function installSkill(agent2, opts = {}) {
+  const dir = join5(agent2.skillsDir, SKILL_NAME);
+  const previous = installedVersion(dir);
+  const outcome = previous === CLI_VERSION ? "current" : previous ? "updated" : "installed";
+  if (outcome !== "current" && !opts.dryRun) {
+    mkdirSync2(dir, { recursive: true });
+    writeFileSync4(join5(dir, "SKILL.md"), skillDocument());
+    writeFileSync4(join5(dir, SKILL_MARKER), `${JSON.stringify({ version: CLI_VERSION }, null, 2)}
+`);
+  }
+  return { agent: agent2.id, path: dir, outcome };
+}
+
 // src/subscriptions.ts
 import { spawn as spawn3 } from "child_process";
-import { existsSync as existsSync4, readFileSync as readFileSync6 } from "fs";
-import { homedir as homedir4 } from "os";
-import { join as join4 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync7 } from "fs";
+import { homedir as homedir5 } from "os";
+import { join as join6 } from "path";
 import { createInterface as createInterface2 } from "readline";
 var ALIASES = {
   claude: "anthropic",
@@ -1136,6 +1313,14 @@ function providerFor(name) {
   }
   return provider;
 }
+function managedProviderFor(name) {
+  if (name.toLowerCase() === "cursor") return "cursor";
+  const provider = ALIASES[name.toLowerCase()];
+  if (!provider) {
+    throw new ApiError(400, "unknown_provider", `unknown provider "${name}" \u2014 use claude, chatgpt or cursor`);
+  }
+  return provider;
+}
 function ask(question) {
   return new Promise((done) => {
     const rl = createInterface2({ input: process.stdin, output: process.stdout });
@@ -1198,12 +1383,12 @@ async function connectClaude() {
   console.log(`Connected Claude subscription${expiry}. Powers new eligible agents.`);
 }
 async function connectChatgpt(opts) {
-  const codexHome = process.env.CODEX_HOME || join4(homedir4(), ".codex");
-  const path = join4(codexHome, "auth.json");
-  if (!existsSync4(path)) {
+  const codexHome = process.env.CODEX_HOME || join6(homedir5(), ".codex");
+  const path = join6(codexHome, "auth.json");
+  if (!existsSync5(path)) {
     throw new ApiError(404, "no_codex_auth", `no ${path} \u2014 run \`codex login\` first`);
   }
-  const raw = readFileSync6(path, "utf8");
+  const raw = readFileSync7(path, "utf8");
   let accountId;
   try {
     const parsed = JSON.parse(raw);
@@ -1233,7 +1418,7 @@ async function listSubscriptions() {
   }
   for (const s of modelSubscriptions) {
     const bits = [
-      s.provider === "anthropic" ? "claude" : "chatgpt",
+      MODEL_SUBSCRIPTION_PROVIDER_NAME[s.provider].toLowerCase(),
       s.status,
       s.expiresAt ? `expires ~${s.expiresAt.slice(0, 10)}` : null,
       s.lastUsedAt ? `last used ${s.lastUsedAt.slice(0, 10)}` : null,
@@ -1245,8 +1430,8 @@ async function listSubscriptions() {
   }
 }
 async function disconnect(name, opts) {
-  const provider = providerFor(name);
-  const label = provider === "anthropic" ? "Claude" : "ChatGPT";
+  const provider = managedProviderFor(name);
+  const label = MODEL_SUBSCRIPTION_PROVIDER_NAME[provider];
   if (!opts.yes) {
     const ok = await confirm2(`Disconnect ${label}? Agents running on it will fail until reconnected or switched to Platform.`);
     if (!ok) {
@@ -1272,7 +1457,7 @@ function printModelBilling(session2) {
   if (session2.modelBilling !== "account") return;
   const provider = modelSubscriptionProviderFor(session2.agentType, session2.llm);
   if (!provider) return;
-  const label = provider === "anthropic" ? "your Claude subscription" : "your ChatGPT plan";
+  const label = `your ${MODEL_SUBSCRIPTION_PLAN_PHRASE[provider]}`;
   console.log(`Model billing: ${label} \u2014 $0 model usage`);
 }
 var program = new Command();
@@ -1445,7 +1630,7 @@ function renderResource(r) {
   const ref = r.checkout ? `@${r.checkout.type === "branch" ? r.checkout.name : r.checkout.sha}` : "";
   return `${r.id}  repo  ${r.mount_path}  ${r.url}${ref}`;
 }
-session.command("create <agent>").description("create a session (starts provisioning by default)").option("--title <title>", "session title").option("--message <text>", "start the first turn immediately, provisioning even with --deferred").option("--deferred", "leave the session idle without a pod until its first turn").option("--vcpus <n>", "machine vCPUs: 1, 2, 4 or 8 (default 2)").option("--memory <mb>", "machine memory in MB, 256MB steps (default 4096)").option("--file <path...>", "mount local files read-only in the working directory: path[:/mount] (uploaded first)").option("--repo <url...>", "clone GitHub repositories into the working directory: https://github.com/{owner}/{repo}[@branch|@sha]").option("--repo-token <token>", "token for the --repo clones; compiled into the sandbox's egress policy, never sent to it").action(
+session.command("create <agent>").description("create a session (starts provisioning by default)").option("--title <title>", "session title").option("--message <text>", "start the first turn immediately, provisioning even with --deferred").option("--deferred", "leave the session idle without a pod until its first turn").option("--vcpus <n>", "machine vCPUs: 1, 2, 4 or 8 (default 2)").option("--memory <mb>", "machine memory in MB, 256MB steps (default 4096)").option("--file <path...>", "mount local files read-only in the working directory: path[:/mount] (uploaded first)").option("--repo <url...>", "clone GitHub repositories into the working directory: https://github.com/{owner}/{repo}[@branch|@sha]").option("--repo-token <token>", "token for the --repo clones; compiled into the sandbox's egress policy, never sent to it").option("--json", "print the created session as JSON").action(
   run(
     async (agentRef, opts) => {
       const resources = await resourceParams(opts);
@@ -1458,6 +1643,10 @@ session.command("create <agent>").description("create a session (starts provisio
         ...resources.length ? { resources } : {},
         ...opts.message ? { initial_events: [{ type: "user.message", content: [{ type: "text", text: opts.message }] }] } : {}
       });
+      if (opts.json) {
+        console.log(JSON.stringify(created));
+        return;
+      }
       console.log(`Created ${created.id} (${created.agent} \xB7 ${created.status})${created.default ? " [default]" : ""}`);
       printModelBilling(created);
       for (const r of created.resources ?? []) console.log(`  ${renderResource(r)}`);
@@ -1534,6 +1723,21 @@ session.command("interrupt <ref>").description("abort the in-flight turn").actio
     console.log(res.status === "no_turn" ? "nothing in flight" : "interrupting");
   })
 );
+session.command("read <ref>").description("what the agent has said since the last message it was sent").option("--wait", "wait until the agent finishes its turn").option("--timeout <seconds>", "how long --wait waits (default 600)").option("--json", "print { finished, messages, errors } as JSON").action(
+  run(async (ref, opts) => {
+    const reading = await readTurn(await resolveSessionRef(ref), {
+      wait: opts.wait,
+      ...opts.timeout !== void 0 ? { timeoutSeconds: Number(opts.timeout) } : {}
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(reading));
+      return;
+    }
+    for (const message of reading.messages) console.log(message);
+    for (const error of reading.errors) console.error(`error: ${error}`);
+    if (!reading.finished) console.error("The agent is still working. Run this again to read more.");
+  })
+);
 var sessionResources = session.command("resources").description("files and GitHub repositories mounted into a session's working directory");
 var resourcesPath = (id) => `/sessions/${encodeURIComponent(id)}/resources`;
 sessionResources.command("list <ref>").description("the session's resources, oldest first").action(
@@ -1688,6 +1892,40 @@ 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(
+  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}` : ""}`);
+    if (opts.json) {
+      console.log(JSON.stringify(agents));
+      return;
+    }
+    if (!agents.length) {
+      console.log("No agent matches. `sky catalog search` with no words lists every agent.");
+      return;
+    }
+    for (const a of agents) console.log(`@${a.handle.padEnd(24)} ${a.name.padEnd(20)} ${a.tagline}`);
+    console.log(`
+Start one:  sky session create @<handle> --message "<the job>"`);
+  })
+);
+program.command("skill").description("the AgentSky skill for the agents on this machine").command("install").description("add the AgentSky skill to each installed agent (Claude Code, Codex, Cursor)").option("--agent <id...>", "only these agents: claude_code | codex | cursor").option("--dry-run", "say what would be written; write nothing").option("--json", "print the outcome per agent as JSON").action(
+  run(async (opts) => {
+    const installs = selectLocalAgents(opts.agent).map((a) => installSkill(a, { dryRun: opts.dryRun }));
+    if (opts.json) {
+      console.log(JSON.stringify(installs));
+      return;
+    }
+    if (!installs.length) {
+      console.log("No agent found on this machine (looked for Claude Code, Codex and Cursor).");
+      return;
+    }
+    const verb = { installed: opts.dryRun ? "would install" : "installed", updated: opts.dryRun ? "would update" : "updated", current: "up to date" };
+    for (const i of installs) console.log(`${i.agent.padEnd(12)} ${verb[i.outcome].padEnd(14)} ${i.path}`);
+  })
+);
 var secrets = program.command("secrets").description("agent secrets (values write-only)");
 secrets.command("set <id> <pairs...>").description("set KEY=VALUE pairs on the agent").action(
   run(async (id, pairs) => {
@@ -1723,7 +1961,7 @@ secrets.command("unset <id> <key>").action(
 program.command("launch").description("scaffold ./agent.toml if absent, create the agent, print its address").option("-f, --file <path>", "agent file", "agent.toml").option("--type <type>", "override the file's harness: hermes | claude_code | codex | openclaw | pi | dsh | kimi_code | opencode").option("--llm <llm>", "override the file's model (must suit the harness)").action(
   run(async (opts) => {
     const path = resolve3(opts.file);
-    if (!existsSync5(path)) {
+    if (!existsSync6(path)) {
       const name = basename3(process.cwd()).replace(/[^a-zA-Z0-9 _-]/g, "") || "my-agent";
       scaffoldAgentFile(path, name);
       console.log(`Scaffolded ${opts.file} \u2014 edit it anytime; re-apply with \`sky deploy\`.`);
@@ -1921,7 +2159,7 @@ files.command("rm <id>").description("delete a file (a session that already rece
 files.command("download <id>").description("download a session file's bytes").requiredOption("-o, --out <path>", "where to write the bytes").action(
   run(async (id, opts) => {
     const { bytes } = await downloadFile(id);
-    writeFileSync4(opts.out, bytes);
+    writeFileSync5(opts.out, bytes);
     console.log(`Wrote ${bytes.length} bytes to ${opts.out}`);
   })
 );

package/dist/products.js

@@ -8,7 +8,7 @@ import {
   skillsArraySchema,
   systemMessageEventSchema,
   userMessageEventSchema
-} from "./chunk-FSAF6HIL.js";
+} from "./chunk-MHL5Z6IQ.js";
 
 // ../../packages/spec/src/compatibility.ts
 var capabilityInputsSchema = capabilitiesSchema;

package/dist/{src-67OBSB2Q.js → src-GLBJHVIJ.js}

@@ -1,7 +1,7 @@
 import {
   external_exports,
   messagePartSchema
-} from "./chunk-FSAF6HIL.js";
+} from "./chunk-MHL5Z6IQ.js";
 
 // ../../packages/chat/src/stream.ts
 async function* parseSseStream(body) {

package/package.json

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