@agentsky/sky 2.19.0 → 2.20.1

package/dist/{chunk-4MVWXHZY.js → chunk-S6A5V7XR.js}

@@ -3,7 +3,7 @@ import {
   apiBase,
   apiToken,
   currentUniverse
-} from "./chunk-MOYCAI4S.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-5HKXRXLU.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-4MVWXHZY.js";
+} from "./chunk-S6A5V7XR.js";
 import {
   CLI_VERSION,
   USER_AGENT,
@@ -20,7 +20,7 @@ import {
   currentUniverse,
   loadConfig,
   saveConfig
-} from "./chunk-MOYCAI4S.js";
+} from "./chunk-ICTCB4VT.js";
 import {
   AGENT_TYPES,
   MODEL_SUBSCRIPTION_PLAN_PHRASE,
@@ -42,7 +42,7 @@ import {
   skillRefSchema,
   splitMcpServers,
   supersededBy
-} from "./chunk-UJ3D24IG.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,
@@ -4130,7 +4149,7 @@ function textOf2(event) {
   return "";
 }
 function firstAsk(record) {
-  const root = record.threads.find((thread) => thread.relation === "primary") ?? record.threads[0];
+  const root = record.threads.find((thread2) => thread2.relation === "primary") ?? record.threads[0];
   if (!root) return null;
   for (const event of record.events[root.id] ?? []) {
     if (event.type === "user.message") {
@@ -4142,9 +4161,9 @@ function firstAsk(record) {
 }
 function decisionsOf(record) {
   const out = [];
-  for (const thread of record.threads) {
-    for (const event of record.events[thread.id] ?? []) {
-      if (event.type === "human.decision" || event.type === "outcome.observed") out.push({ ...event, thread_id: thread.id });
+  for (const thread2 of record.threads) {
+    for (const event of record.events[thread2.id] ?? []) {
+      if (event.type === "human.decision" || event.type === "outcome.observed") out.push({ ...event, thread_id: thread2.id });
     }
   }
   return out.sort((a, b) => (a.at ?? "").localeCompare(b.at ?? ""));
@@ -4158,7 +4177,7 @@ function adoptedSession(record) {
   return null;
 }
 function stepsOf(record, names2) {
-  const root = record.threads.find((thread) => thread.relation === "primary") ?? record.threads[0];
+  const root = record.threads.find((thread2) => thread2.relation === "primary") ?? record.threads[0];
   if (!root) return [];
   const events = record.events[root.id] ?? [];
   const steps = [];
@@ -4277,8 +4296,8 @@ function buildHarborTask(record, opts) {
   const out = /* @__PURE__ */ new Map();
   const ask2 = record.goal?.objective ?? firstAsk(record) ?? record.title ?? "Complete the task described by the workspace.";
   const instruction = scrub(ask2, names2);
-  const root = record.threads.find((thread) => thread.relation === "primary") ?? record.threads[0];
-  const harnesses = [...new Set(record.threads.map((thread) => thread.agent.harness))];
+  const root = record.threads.find((thread2) => thread2.relation === "primary") ?? record.threads[0];
+  const harnesses = [...new Set(record.threads.map((thread2) => thread2.agent.harness))];
   const decisions = decisionsOf(record);
   const adopted = adoptedSession(record);
   const steps = stepsOf(record, names2);
@@ -4370,7 +4389,7 @@ async function fetchTaskRecord(taskRef) {
   const { task: task2 } = await api("GET", `/tasks/${encodeURIComponent(taskRef)}`);
   const { threads } = await api("GET", `/sessions/${encodeURIComponent(task2.id)}/threads`);
   const events = {};
-  for (const thread of threads) events[thread.id] = await pagedEvents(thread.id);
+  for (const thread2 of threads) events[thread2.id] = await pagedEvents(thread2.id);
   let goal2 = null;
   try {
     goal2 = (await api("GET", `/sessions/${encodeURIComponent(task2.id)}/goal`)).goal;
@@ -4383,7 +4402,7 @@ async function fetchTaskRecord(taskRef) {
   } catch (error) {
     if (!(error instanceof ApiError && (error.status === 404 || error.status === 503))) throw error;
   }
-  const root = threads.find((thread) => thread.relation === "primary") ?? threads[0];
+  const root = threads.find((thread2) => thread2.relation === "primary") ?? threads[0];
   return { task_id: task2.id, exported_at: (/* @__PURE__ */ new Date()).toISOString(), title: task2.title ?? null, threads, events, goal: goal2, files: files2, completion_answer: task2.completion_answer ?? null, environment: root?.environment ?? null };
 }
 var FILE_BYTES_MAX = 50 * 1024 * 1024;
@@ -4421,10 +4440,10 @@ var DECISION_KINDS = ["adopt", "rerun", "revise", "discard", "vote", "did_the_jo
 async function listThreads(taskRef) {
   return (await api("GET", `/sessions/${encodeURIComponent(taskRef)}/threads`)).threads;
 }
-function renderThread(thread) {
-  const spend = (Number(thread.usage.spent_usd_micros) / 1e6).toFixed(4);
-  const env = thread.environment?.repo ? `  ${thread.environment.repo}${thread.environment.commit ? `@${thread.environment.commit.slice(0, 7)}` : ""}` : "";
-  return `${thread.id}  ${thread.relation.padEnd(7)}  ${thread.source.padEnd(12)}  ${thread.agent.harness}/${thread.agent.model}  ${thread.status}  $${spend}${env}`;
+function renderThread(thread2) {
+  const spend = (Number(thread2.usage.spent_usd_micros) / 1e6).toFixed(4);
+  const env = thread2.environment?.repo ? `  ${thread2.environment.repo}${thread2.environment.commit ? `@${thread2.environment.commit.slice(0, 7)}` : ""}` : "";
+  return `${thread2.id}  ${thread2.relation.padEnd(7)}  ${thread2.source.padEnd(12)}  ${thread2.agent.harness}/${thread2.agent.model}  ${thread2.status}  $${spend}${env}`;
 }
 async function recordDecision(sessionRef, kind, opts = {}) {
   if (!DECISION_KINDS.includes(kind)) throw new Error(`kind must be one of ${DECISION_KINDS.join(", ")}`);
@@ -4704,6 +4723,38 @@ function renderBrowserProfile(profile) {
   return lines.join("\n");
 }
 
+// src/compare.ts
+async function listComparisons(opts = {}) {
+  const qs = opts.archived ? "?archived=true" : "";
+  const { comparisons } = await api("GET", `/comparisons${qs}`);
+  return comparisons;
+}
+async function createComparison(body) {
+  return api("POST", "/comparisons", body);
+}
+async function getComparison(id) {
+  return api("GET", `/comparisons/${encodeURIComponent(id)}`);
+}
+async function pickWinner(id, opts) {
+  return api("POST", `/comparisons/${encodeURIComponent(id)}/pick`, opts);
+}
+async function listThreads2(opts = {}) {
+  const qs = opts.filter ? `?filter=${opts.filter}` : "";
+  const { threads } = await api("GET", `/threads${qs}`);
+  return threads;
+}
+function renderComparisonSummary(c) {
+  const agents = c.agents.map((a) => `${a.agentType}/${a.llm}`).join(" vs ");
+  const status = c.statusLine ?? c.attention ?? (c.archived ? "archived" : "active");
+  return `${c.id.slice(0, 12)}  ${c.title.slice(0, 40).padEnd(42)} [${agents}]  ${status}`;
+}
+function renderThreadSummary(t) {
+  const agents = t.agents.map((a) => `${a.agentType}/${a.llm}`).join(", ");
+  const flag = t.pinned ? "\u{1F4CC} " : "";
+  const status = t.working ? "working" : t.attention ?? (t.archived ? "archived" : "idle");
+  return `${t.id.slice(0, 12)}  ${flag}${t.title.slice(0, 40).padEnd(44)} [${agents}]  ${status}`;
+}
+
 // src/harness.ts
 import { existsSync as existsSync9, mkdirSync as mkdirSync5, readFileSync as readFileSync14, writeFileSync as writeFileSync7 } from "fs";
 import { dirname as dirname8, join as join16, resolve as resolve8 } from "path";
@@ -6029,7 +6080,7 @@ task.command("threads <task>").description("the task's threads from the session
       console.log(JSON.stringify({ threads }));
       return;
     }
-    for (const thread of threads) console.log(renderThread(thread));
+    for (const thread2 of threads) console.log(renderThread(thread2));
   })
 );
 task.command("decide <session> <kind>").description("record what you did with a session's result: adopt | rerun | revise | discard | vote | did_the_job | approve").option("--target <session>", "the session the decision names (a vote's winner, the option you adopted)").option("--yes", "the value for did_the_job and approve").option("--no", "the value for did_the_job and approve").option("--reason <text>", "your own words, kept with the decision").option("--key <key>", "an idempotency key, so a repeat records nothing new").action(
@@ -6733,7 +6784,7 @@ vendor.command("usage <id>").description("the agents and tasks that used this ve
   })
 );
 var browserProfile = program.command("browser-profile").description("saved-login profiles: the sites your agents stay signed in to");
-browserProfile.command("list").description("your workspace's browser profiles (requires BROWSER_PROFILES to be enabled)").option("--json", "print as JSON").action(
+browserProfile.command("list").description("your workspace's browser profiles: the sites your agents stay signed in to").option("--json", "print as JSON").action(
   run(async (opts) => {
     const profiles = await listBrowserProfiles();
     if (opts.json) {
@@ -6956,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-VZX6UIOF.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 ?? []);
@@ -6991,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-VZX6UIOF.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") || "{}");
@@ -7004,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-VZX6UIOF.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-VZX6UIOF.js");
+  const { readState, spoolStatus } = await import("./trace-SJHQ66JA.js");
   const state = readState();
   if (!state) {
     console.log("No trace is running here.");
@@ -7021,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-VZX6UIOF.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}`);
@@ -7048,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-VZX6UIOF.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" }]);
@@ -7058,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-EBH2GYDA.js");
+  const lib = await import("./trace-library-IWF7BVNB.js");
   if (opts.hook) {
     try {
       let raw = payload ?? "";
@@ -7156,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-EBH2GYDA.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 } : {} });
@@ -7173,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-EBH2GYDA.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);
@@ -7203,5 +7254,162 @@ workerCmd.command("start <pool>").description("start a worker connected to the g
   process.on("SIGTERM", () => ac.abort());
   await startWorker({ poolId, token, label: options.label, apiBase: base, signal: ac.signal });
 });
+var compare = program.command("compare").description("side-by-side agent comparisons: create, list, read, pick a winner");
+compare.command("create").description("run one task on two or more agents simultaneously and start a comparison").requiredOption("--task <text>", "the task to send to every agent").requiredOption("--agent <type>", "the main agent's harness type (e.g. claude_code, hermes)").requiredOption("--llm <model>", "the main agent's model").option("--vs <type:model...>", "one or more competing agents in type:model form (e.g. codex:gpt-6)", (val, acc) => [...acc, val], []).option("--effort <level>", "reasoning effort for every agent (low|medium|high)").option("--json", "print the created comparison as JSON").action(
+  run(async (opts) => {
+    const competitors = (opts.vs ?? []).map((v) => {
+      const [agentType, llm] = v.split(":");
+      if (!agentType || !llm) throw new ApiError(400, "invalid_request", `--vs must be type:model, got "${v}"`);
+      return { agentType, llm, ...opts.effort ? { reasoningEffort: opts.effort } : {} };
+    });
+    if (!competitors.length) throw new ApiError(400, "invalid_request", "Provide at least one --vs type:model competitor.");
+    const requestId = `sky-compare-${Date.now()}`;
+    const result = await createComparison({
+      requestId,
+      agentType: opts.agent,
+      llm: opts.llm,
+      task: opts.task,
+      compare: competitors,
+      ...opts.effort ? { reasoningEffort: opts.effort } : {}
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(`created ${result.comparisonId}`);
+    for (const col of result.columns) console.log(`  column ${col.columnId}  session ${col.sessionId}`);
+  })
+);
+compare.command("list").description("your workspace comparisons, most recently updated first").option("--archived", "list archived comparisons instead").option("--json", "print as JSON").action(
+  run(async (opts) => {
+    const comparisons = await listComparisons({ archived: opts.archived });
+    if (opts.json) {
+      console.log(JSON.stringify(comparisons, null, 2));
+      return;
+    }
+    if (!comparisons.length) console.log("no comparisons");
+    for (const c of comparisons) console.log(renderComparisonSummary(c));
+  })
+);
+compare.command("show <id>").description("one comparison: task, agents, status, and the vote verdict").option("--json", "print as JSON").action(
+  run(async (id, opts) => {
+    const detail = await getComparison(id);
+    if (opts.json) {
+      console.log(JSON.stringify(detail, null, 2));
+      return;
+    }
+    console.log(`comparison ${detail.id}`);
+    if (detail.title) console.log(`  title:  ${detail.title}`);
+    if (detail.openerText) console.log(`  task:   ${detail.openerText}`);
+    console.log(`  created ${detail.createdAt}`);
+    for (const col of detail.columns) {
+      const masked = !col.agentType;
+      const identity = masked ? "(hidden \u2014 Arena match pending)" : `${col.agentType ?? "?"}/${col.llm ?? "?"}`;
+      console.log(`  column  ${col.columnId}  session ${col.sessionId ?? "-"}  ${identity}  ${col.podStatus ?? ""}`);
+    }
+    if (detail.arena) console.log(`  arena   kind=${detail.arena.kind}  status=${detail.arena.status}  hidden=${detail.arena.hidden}`);
+    if (detail.vote) console.log(`  vote    outcome=${detail.vote.outcome}  winner=${detail.vote.winnerSessionId ?? "none"}  sealed=${detail.vote.sealed}`);
+  })
+);
+compare.command("pick <id>").description('record the winning column \u2014 or a tie or "both_bad" \u2014 for this comparison').option("--winner <columnId>", "the columnId of the winning column").option("--tie", "record a tie instead of a winner").option("--both-bad", "record that neither agent did the job").option("--json", "print the verdict as JSON").action(
+  run(async (id, opts) => {
+    const choices = [opts.winner, opts.tie, opts.bothBad].filter(Boolean).length;
+    if (choices !== 1) throw new ApiError(400, "invalid_request", "Provide exactly one of --winner, --tie or --both-bad.");
+    const outcome = opts.tie ? "tie" : opts.bothBad ? "both_bad" : void 0;
+    const result = await pickWinner(id, { winnerColumnId: opts.winner, outcome });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.winnerSessionId) console.log(`winner: session ${result.winnerSessionId}`);
+    else console.log("recorded: " + (outcome ?? "pick"));
+    if (result.revealed) console.log("identities revealed:");
+    for (const s of result.seats) console.log(`  ${s.sessionId}  ${s.agentType}/${s.llm}`);
+  })
+);
+var thread = program.command("thread").description("workspace threads: the conversation history across all agents");
+thread.command("list").description("your workspace threads, most recently updated first (includes comparisons)").option("--archived", "list archived threads only").option("--all", "include both active and archived").option("--json", "print as JSON").action(
+  run(async (opts) => {
+    const filter = opts.all ? "all" : opts.archived ? "archived" : "active";
+    const threads = await listThreads2({ filter });
+    if (opts.json) {
+      console.log(JSON.stringify(threads, null, 2));
+      return;
+    }
+    if (!threads.length) console.log("no threads");
+    for (const t of threads) console.log(renderThreadSummary(t));
+  })
+);
+session.command("feedback <id>").description("read the thumbs-up/down feedback on this session's messages").option("--json", "print as JSON").action(
+  run(async (id, opts) => {
+    const result = await api(
+      "GET",
+      `/sessions/${encodeURIComponent(id)}/feedback`
+    );
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    const entries = Object.entries(result.reports);
+    if (!entries.length) {
+      console.log("no feedback recorded");
+      return;
+    }
+    for (const [msgId, r] of entries) console.log(`${msgId.slice(0, 12)}  ${r.vote}  ${(r.reasons ?? []).join(", ")}`);
+  })
+);
+session.command("side-chat <id>").description("ask a question about this session's transcript (answered beside it, never sent to the agent)").requiredOption("--question <text>", "the question to ask").requiredOption("--transcript <text>", "the session transcript or relevant excerpt").option("--quote <text>", "a specific passage the question targets").option("--json", "print as JSON").action(
+  run(async (id, opts) => {
+    const result = await api("POST", `/sessions/${encodeURIComponent(id)}/side-chat`, {
+      transcript: opts.transcript,
+      history: [],
+      question: opts.question,
+      ...opts.quote ? { quote: opts.quote } : {}
+    });
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(result.answer);
+    if (result.looked?.length) console.log(`
+(sources: ${result.looked.join(", ")})`);
+  })
+);
+session.command("code-review <id>").description("run the code-review assistant on this session's diff or file").requiredOption("--diff <text>", "the diff or file content to review").option("--filename <name>", "the filename for language-aware review").option("--json", "print as JSON").action(
+  run(async (id, opts) => {
+    const result = await api(
+      "POST",
+      `/sessions/${encodeURIComponent(id)}/code-review`,
+      { diff: opts.diff, ...opts.filename ? { filename: opts.filename } : {} }
+    );
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(result.review);
+    if (result.issues?.length) {
+      console.log("\nIssues:");
+      for (const issue of result.issues) {
+        const loc = issue.line ? ` line ${issue.line}` : "";
+        console.log(`  [${issue.severity}]${loc} ${issue.message}`);
+      }
+    }
+  })
+);
+session.command("snapshot <id>").description("read or revoke the public share link for a session").requiredOption("--thread <threadId>", "the thread/comparison that owns this session").option("--revoke", "revoke the snapshot link instead of reading it").option("--json", "print as JSON").action(
+  run(async (id, opts) => {
+    const path = `/sessions/${encodeURIComponent(id)}/snapshot?thread=${encodeURIComponent(opts.thread)}`;
+    const result = await api(opts.revoke ? "DELETE" : "GET", path);
+    if (opts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (opts.revoke) {
+      console.log(result.url === null ? "snapshot link revoked" : `still set: ${result.url}`);
+      return;
+    }
+    console.log(result.url ?? "no snapshot link set");
+  })
+);
 var ARGUMENTS_FOLLOW_THE_SCRIPT_PATH_ON_EVERY_RUNTIME = { from: "node" };
 program.parseAsync(process.argv, ARGUMENTS_FOLLOW_THE_SCRIPT_PATH_ON_EVERY_RUNTIME).catch(fail);

package/dist/products.js

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

package/dist/{src-5HKXRXLU.js → src-KP6YIFNP.js}

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

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

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

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

@@ -1,16 +1,16 @@
 import {
   ApiError
-} from "./chunk-4MVWXHZY.js";
+} from "./chunk-S6A5V7XR.js";
 import {
   USER_AGENT,
   apiBase,
   apiToken
-} from "./chunk-MOYCAI4S.js";
+} from "./chunk-ICTCB4VT.js";
 import {
   SessionSourceCollector,
   publicRemote,
   redactTraceText
-} from "./chunk-UJ3D24IG.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.19.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",