@agentsky/sky 2.20.0 → 2.20.1

package/dist/{chunk-BHW2NAXP.js → chunk-ICTCB4VT.js}

@@ -38,7 +38,7 @@ function currentUniverse() {
 }
 
 // src/version.ts
-var CLI_VERSION = "2.20.0";
+var CLI_VERSION = "2.20.1";
 var USER_AGENT = `sky-cli/${CLI_VERSION} (${process.platform}; node/${process.versions.node})`;
 
 export {

package/dist/{chunk-ICSGMEG5.js → chunk-S6A5V7XR.js}

@@ -3,7 +3,7 @@ import {
   apiBase,
   apiToken,
   currentUniverse
-} from "./chunk-BHW2NAXP.js";
+} from "./chunk-ICTCB4VT.js";
 
 // src/api.ts
 import { createWriteStream, writeFileSync } from "fs";
@@ -144,7 +144,7 @@ async function resolveSessionRef(ref) {
   return agent.defaultSessionId;
 }
 async function* streamEvents(sessionId, signal) {
-  const { parseSseStream } = await import("./src-3HXHE2S6.js");
+  const { parseSseStream } = await import("./src-KP6YIFNP.js");
   const res = await fetch(
     `${apiBase()}/sessions/${encodeURIComponent(sessionId)}/stream`,
     {

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   resolveSessionRef,
   streamEvents,
   uploadFile
-} from "./chunk-ICSGMEG5.js";
+} from "./chunk-S6A5V7XR.js";
 import {
   CLI_VERSION,
   USER_AGENT,
@@ -20,7 +20,7 @@ import {
   currentUniverse,
   loadConfig,
   saveConfig
-} from "./chunk-BHW2NAXP.js";
+} from "./chunk-ICTCB4VT.js";
 import {
   AGENT_TYPES,
   MODEL_SUBSCRIPTION_PLAN_PHRASE,
@@ -42,7 +42,7 @@ import {
   skillRefSchema,
   splitMcpServers,
   supersededBy
-} from "./chunk-DC3R6BV2.js";
+} from "./chunk-NAD26CDY.js";
 import "./chunk-MLKGABMK.js";
 
 // src/index.ts
@@ -2831,6 +2831,25 @@ Details: \`${REFERENCES_DIR}/workspaces.md\` in this skill's folder.
 - 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.
 
+## Local first, cloud when it is not here, never a stand-in
+
+- When the person names an engine that is installed and signed in on this
+  computer, run it here: it costs them nothing on AgentSky.
+- When it is not installed here, start that same engine in the cloud: its handle
+  (\`@codex\`, \`@claude_code\`, \u2026) with \`start_session\` and a \`budget_cents\`, and say so
+  in one line ("Codex is not installed on this Mac, so it ran in the cloud").
+  Do not pick another engine instead.
+- Every refused tool call carries a stable error \`code\` (in the error text and in
+  \`structuredContent.error\`) and, when there is one, a \`next_step\`. Read the code:
+  \`insufficient_credits\`, \`workspace_wallet_empty\` and \`payment_setup_required\` mean
+  the account cannot pay; \`budget_reached\` means that session's cap is spent.
+  Stop that piece of work and tell the person what was refused and what unblocks
+  it (credit or a card under Settings \u203A Billing, a larger \`budget_cents\`), then
+  offer the engines that are installed here as the free alternative. Never hire a
+  cheaper or different agent to get around a refusal.
+- \`get_usage\` shows the balance; check it before starting several cloud sessions
+  at once so the person is told once, up front, instead of after the first fails.
+
 ## How to pick
 
 Read \`${CATALOG_FILE}\` in this skill's folder. It lists every agent you can hire,
@@ -6988,7 +7007,7 @@ harness.command("connect").description("run an ACP agent (the command after --)
 }));
 var traceCmd = program.command("trace").description("correlate this machine's agent work with the cloud sessions it starts (metadata only unless you choose content)");
 traceCmd.command("start").description("start a trace: a grant for this machine, a root span, and the spool the hooks write to").option("--name <name>", "a name for the task").option("--source <source>", "how this machine reports itself", "claude-code").option("--hooks [settings]", "also install the Claude Code hooks (default: ./.claude/settings.local.json)").option("--capture <scopes>", "also send content, redacted on this machine first: any of prompts,tool_output,files").option("--file <path>", "a file the files scope may send (repeatable)", collect).option("--dir <path>", "a folder whose files the files scope may send when a file tool touches them (repeatable)", collect).action(run(async (opts) => {
-  const { readState, writeState, record, installClaudeHooks, parseContentScopes, chosenPaths, fileEvent } = await import("./trace-DI2SQI7M.js");
+  const { readState, writeState, record, installClaudeHooks, parseContentScopes, chosenPaths, fileEvent } = await import("./trace-SJHQ66JA.js");
   if (readState()) throw new Error("a trace is already running here \u2014 `sky trace stop` it first");
   const scopes = parseContentScopes(opts.capture);
   const chosen = chosenPaths(opts.file ?? [], opts.dir ?? []);
@@ -7023,7 +7042,7 @@ traceCmd.command("start").description("start a trace: a grant for this machine,
 }));
 traceCmd.command("hook").description("record one Claude Code hook event read from stdin (run by the installed hooks; never fails, prints nothing)").action(async () => {
   try {
-    const { readState, record, flush, grantSender, eventsForClaudeHook, contentForClaudeHook, clearState } = await import("./trace-DI2SQI7M.js");
+    const { readState, record, flush, grantSender, eventsForClaudeHook, contentForClaudeHook, clearState } = await import("./trace-SJHQ66JA.js");
     const chunks = [];
     for await (const chunk of process.stdin) chunks.push(chunk);
     const input = JSON.parse(Buffer.concat(chunks).toString("utf8") || "{}");
@@ -7036,14 +7055,14 @@ traceCmd.command("hook").description("record one Claude Code hook event read fro
   }
 });
 traceCmd.command("flush").description("send what the spool holds, retrying with backoff").action(run(async () => {
-  const { readState, flush, grantSender } = await import("./trace-DI2SQI7M.js");
+  const { readState, flush, grantSender } = await import("./trace-SJHQ66JA.js");
   const state = readState();
   if (!state) throw new Error("no trace is running here");
   const outcome = await flush(grantSender(state), { attempts: 4 });
   console.log(`sent ${outcome.sent}, refused ${outcome.refused}, given up ${outcome.expired}, still pending ${outcome.pending}${outcome.stopped ? ` (stopped: ${outcome.stopped})` : ""}`);
 }));
 traceCmd.command("status").description("the running trace and its spool").action(run(async () => {
-  const { readState, spoolStatus } = await import("./trace-DI2SQI7M.js");
+  const { readState, spoolStatus } = await import("./trace-SJHQ66JA.js");
   const state = readState();
   if (!state) {
     console.log("No trace is running here.");
@@ -7053,7 +7072,7 @@ traceCmd.command("status").description("the running trace and its spool").action
   console.log(`${state.trace_id} as ${state.source}: ${spool.pending} pending, ${spool.dropped_full} dropped (spool full), ${spool.dropped_expired} given up, ${spool.refused} refused`);
 }));
 traceCmd.command("show [id]").description("the trace bundle: spans, the sessions they reach, cost counted once per session").option("--json", "print the bundle as JSON").action(run(async (id, opts) => {
-  const { readState } = await import("./trace-DI2SQI7M.js");
+  const { readState } = await import("./trace-SJHQ66JA.js");
   const ref = id ?? readState()?.trace_id;
   if (!ref) throw new Error("name a trace, or start one here");
   const bundle = await api("GET", `/traces/${ref}`);
@@ -7080,7 +7099,7 @@ traceCmd.command("show [id]").description("the trace bundle: spans, the sessions
   for (const gap of bundle.gaps) console.log(`  gap: ${gap.span_id} ${gap.reason}`);
 }));
 traceCmd.command("stop").description("end the root span, send what is left, and revoke this machine's grant").action(run(async () => {
-  const { readState, record, flush, grantSender, clearState } = await import("./trace-DI2SQI7M.js");
+  const { readState, record, flush, grantSender, clearState } = await import("./trace-SJHQ66JA.js");
   const state = readState();
   if (!state) throw new Error("no trace is running here");
   if (state.root_span) record(() => [{ span_id: state.root_span, kind: "end", outcome: "completed" }]);
@@ -7090,7 +7109,7 @@ traceCmd.command("stop").description("end the root span, send what is left, and
   console.log(`Stopped ${state.trace_id}${outcome.pending ? ` (${outcome.pending} events could not be sent)` : ""}`);
 }));
 traceCmd.command("sync [payload]").description("upload this machine's Claude Code and Codex sessions to the matching workspace's trace library, redacted here first").option("--enable", "turn sync on for this machine").option("--disable", "turn sync off; nothing more is uploaded").option("--route <match=workspace>", "send sessions whose folder path contains <match> to <workspace> (repeatable; replaces the saved rules)", collect).option("--default <workspace>", "where a session no rule matches goes").option("--keep-local", "keep sessions no rule matches on this machine (the default)").option("--session <ref>", "only this session: its id or transcript path (repeatable)", collect).option("--full", "re-read every session, not only files that changed").option("--limit <n>", "at most this many changed sessions this run", (v) => Number.parseInt(v, 10)).option("--dry-run", "show what would be uploaded without uploading").option("--hook", "run from a Claude Code SessionEnd hook or Codex notify: upload that session in the background and return at once").option("--install-schedule", "also sweep every 15 minutes (macOS launchd)").option("--status", "what sync has done on this machine").option("--quiet", "print only failures").action(async (payload, opts) => {
-  const lib = await import("./trace-library-4WWKCSVU.js");
+  const lib = await import("./trace-library-IWF7BVNB.js");
   if (opts.hook) {
     try {
       let raw = payload ?? "";
@@ -7188,7 +7207,7 @@ traceCmd.command("sync [payload]").description("upload this machine's Claude Cod
   })();
 });
 traceCmd.command("search <query...>").description("search every session in a workspace's trace library (literal substring)").option("--workspace <slug>", "the workspace to search (default: the current one)").option("--limit <n>", "hits per page", (v) => Number.parseInt(v, 10), 20).option("--cursor <cursor>", "the next page of an earlier search").option("--json", "print the page as JSON").action(run(async (words, opts) => {
-  const { libraryRequest } = await import("./trace-library-4WWKCSVU.js");
+  const { libraryRequest } = await import("./trace-library-IWF7BVNB.js");
   const workspace2 = opts.workspace ?? currentUniverse();
   if (!workspace2) throw new Error("name a workspace with --workspace");
   const params = new URLSearchParams({ q: words.join(" "), scope: "traces", limit: String(opts.limit), ...opts.cursor ? { cursor: opts.cursor } : {} });
@@ -7205,7 +7224,7 @@ traceCmd.command("search <query...>").description("search every session in a wor
   if (page.nextCursor) console.log(`More: sky trace search ${JSON.stringify(words.join(" "))} --workspace ${workspace2} --cursor ${page.nextCursor}`);
 }));
 traceCmd.command("library").description("list the sessions in a workspace's trace library, most recently updated first").option("--workspace <slug>", "the workspace (default: the current one)").option("--limit <n>", "how many", (v) => Number.parseInt(v, 10), 20).option("--json", "print the page as JSON").action(run(async (opts) => {
-  const { libraryRequest } = await import("./trace-library-4WWKCSVU.js");
+  const { libraryRequest } = await import("./trace-library-IWF7BVNB.js");
   const workspace2 = opts.workspace ?? currentUniverse();
   if (!workspace2) throw new Error("name a workspace with --workspace");
   const page = await libraryRequest("GET", `/trace-library?limit=${opts.limit}`, workspace2);

package/dist/products.js

@@ -8,7 +8,7 @@ import {
   skillsArraySchema,
   systemMessageEventSchema,
   userMessageEventSchema
-} from "./chunk-DC3R6BV2.js";
+} from "./chunk-NAD26CDY.js";
 import "./chunk-MLKGABMK.js";
 
 // ../../packages/spec/src/compatibility.ts

package/dist/{src-3HXHE2S6.js → src-KP6YIFNP.js}

@@ -1,7 +1,7 @@
 import {
   external_exports,
   messagePartSchema
-} from "./chunk-DC3R6BV2.js";
+} from "./chunk-NAD26CDY.js";
 import "./chunk-MLKGABMK.js";
 
 // ../../packages/chat/src/stream.ts

package/dist/{trace-DI2SQI7M.js → trace-SJHQ66JA.js}

@@ -1,11 +1,11 @@
 import {
   USER_AGENT,
   configPath
-} from "./chunk-BHW2NAXP.js";
+} from "./chunk-ICTCB4VT.js";
 import {
   TRACE_CONTENT_SCOPES,
   redactTraceText
-} from "./chunk-DC3R6BV2.js";
+} from "./chunk-NAD26CDY.js";
 import "./chunk-MLKGABMK.js";
 
 // src/trace.ts

package/dist/{trace-library-4WWKCSVU.js → trace-library-IWF7BVNB.js}

@@ -1,16 +1,16 @@
 import {
   ApiError
-} from "./chunk-ICSGMEG5.js";
+} from "./chunk-S6A5V7XR.js";
 import {
   USER_AGENT,
   apiBase,
   apiToken
-} from "./chunk-BHW2NAXP.js";
+} from "./chunk-ICTCB4VT.js";
 import {
   SessionSourceCollector,
   publicRemote,
   redactTraceText
-} from "./chunk-DC3R6BV2.js";
+} from "./chunk-NAD26CDY.js";
 import "./chunk-MLKGABMK.js";
 
 // src/trace-library.ts

package/package.json

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