@agentsky/sky 0.1.0 → 0.2.0

package/dist/index.js

@@ -70,10 +70,28 @@ async function api(method, path, body, opts = {}) {
   if (!res.ok) await parseError(res);
   return await res.json();
 }
-async function* streamEvents(agentSlug, signal) {
-  const { parseSseStream } = await import("./src-KNBIGOZP.js");
+async function resolveSessionRef(ref) {
+  if (ref.startsWith("sess-")) return ref;
+  const { agent: agent2 } = await api(
+    "GET",
+    `/api/v1/agents/${encodeURIComponent(ref)}`
+  ).catch(async () => {
+    await api("GET", `/api/v1/sessions/${encodeURIComponent(ref)}`);
+    return { agent: { slug: ref, defaultSessionId: ref } };
+  });
+  if (!agent2.defaultSessionId) {
+    throw new ApiError(
+      404,
+      "no_sessions",
+      `agent ${agent2.slug} has no sessions \u2014 create one: sky session create ${agent2.slug}`
+    );
+  }
+  return agent2.defaultSessionId;
+}
+async function* streamEvents(sessionId, signal) {
+  const { parseSseStream } = await import("./src-CNT7GXZH.js");
   const res = await fetch(
-    `${apiBase()}/api/v1/agents/${encodeURIComponent(agentSlug)}/stream`,
+    `${apiBase()}/api/v1/sessions/${encodeURIComponent(sessionId)}/stream`,
     {
       headers: { ...authHeaders(), accept: "text/event-stream" },
       signal
@@ -362,6 +380,7 @@ async function createClone(local, opts) {
       throw error;
     }
   }
+  await api("POST", "/api/v1/sessions", { agent: created.slug });
   const now = (/* @__PURE__ */ new Date()).toISOString();
   writeLink(local.configRoot, {
     baseUrl: apiBase(),
@@ -593,7 +612,7 @@ function renderEvent(event, data) {
 
 // src/index.ts
 var program = new Command();
-program.name("sky").description("Launch and talk to long-lived agents \u2014 agentsky.dev").version("0.1.0");
+program.name("sky").description("Launch and talk to long-lived agents \u2014 agentsky.dev").version("0.2.0");
 function fail(error) {
   if (error instanceof ApiError) console.error(`sky: ${error.message} (${error.code})`);
   else console.error(`sky: ${error instanceof Error ? error.message : String(error)}`);
@@ -653,8 +672,8 @@ universe.command("show").action(
     }
   })
 );
-var agent = program.command("agent").description("create, inspect, talk to agents");
-agent.command("create").description("create an agent (flags-only; bare create = instant default)").option("--type <type>", "hermes | claude_code | codex | openclaw").option("--llm <llm>", "model id (defaults per type)").option("--name <name>", "agent name").option("--vcpus <n>", "machine vCPUs: 1, 2, 4 or 8 (default 2)").option("--memory <mb>", "machine memory in MB, 256MB steps (default 4096)").option("-f, --file <path>", "create from an agent.toml").action(
+var agent = program.command("agent").description("agent specs: create, inspect, talk (via the default session)");
+agent.command("create").description("create an agent spec \u2014 no runtime; `sky session create` starts one").option("--type <type>", "hermes | claude_code | codex | openclaw").option("--llm <llm>", "model id (defaults per type)").option("--name <name>", "agent name").option("-f, --file <path>", "create from an agent.toml").action(
   run(async (opts) => {
     const spec = opts.file ? readAgentFile(opts.file).spec : {
       name: opts.name ?? "My agent",
@@ -662,11 +681,9 @@ agent.command("create").description("create an agent (flags-only; bare create =
       llm: opts.llm,
       displayName: opts.name
     };
-    if (opts.vcpus !== void 0) spec.vcpus = Number(opts.vcpus);
-    if (opts.memory !== void 0) spec.memoryMb = Number(opts.memory);
     const { agent: created } = await api("POST", "/api/v1/agents", spec);
-    console.log(`Created ${created.slug} (${created.agentType} \xB7 ${created.llm})`);
-    console.log(`Talk to it:  sky agent message ${created.slug} "hello"`);
+    console.log(`Created ${created.slug} (${created.agentType} \xB7 ${created.llm}) \u2014 spec only.`);
+    console.log(`Start it:  sky session create ${created.slug}`);
   })
 );
 agent.command("list").action(
@@ -677,8 +694,9 @@ agent.command("list").action(
       return;
     }
     for (const a of agents) {
+      const state = a.archived ? "archived" : `${a.sessionCount} session${a.sessionCount === 1 ? "" : "s"}`;
       console.log(
-        `${a.slug.padEnd(24)} ${a.displayName.padEnd(20)} ${a.agentType}/${a.llm} ${a.status.toLowerCase()}`
+        `${a.slug.padEnd(24)} ${a.displayName.padEnd(20)} ${a.agentType}/${a.llm} ${state}`
       );
     }
   })
@@ -686,35 +704,113 @@ agent.command("list").action(
 agent.command("show <slug>").action(
   run(async (slug) => {
     const { agent: a } = await api("GET", `/api/v1/agents/${encodeURIComponent(slug)}`);
-    console.log(`${a.slug} \u2014 ${a.displayName}`);
+    console.log(`${a.slug} \u2014 ${a.displayName}${a.archived ? " (archived)" : ""}`);
     console.log(`  type      ${a.agentType} \xB7 ${a.llm}`);
-    console.log(`  status    ${a.status.toLowerCase()}`);
+    console.log(`  version   ${a.version}`);
+    console.log(`  sessions  ${a.sessionCount}`);
     console.log(`  universe  ${a.universe}`);
     if (a.capabilities.length) console.log(`  caps      ${a.capabilities.join(", ")}`);
     if (a.prompt) console.log(`  prompt    ${a.prompt.split("\n")[0]?.slice(0, 80)}\u2026`);
   })
 );
-agent.command("destroy <slug>").description("tear down the pod and delete the agent (admin scope)").action(
+agent.command("archive <slug>").description("retire the spec \u2014 read-only, running sessions unaffected (admin scope)").action(
+  run(async (slug) => {
+    await api("POST", `/api/v1/agents/${encodeURIComponent(slug)}/archive`);
+    console.log(`Archived ${slug} \u2014 sessions keep running; new sessions are rejected.`);
+  })
+);
+agent.command("destroy <slug>").description("delete the spec; requires all sessions destroyed first (admin scope)").action(
   run(async (slug) => {
     await api("DELETE", `/api/v1/agents/${encodeURIComponent(slug)}`);
     console.log(`Destroyed ${slug}`);
   })
 );
-agent.command("logs <slug>").option("-f, --follow", "follow (SSE)").option("--since <duration>", "how far back, e.g. 1h, 30m", "1h").action(
-  run(async (slug, opts) => {
+agent.command("message <slug> <text>").description("send one message to the default session and stream the turn until idle").option("--detach", "don't follow the stream; exit after the 202").action(
+  run(
+    async (slug, text, opts) => sendAndFollow(await resolveSessionRef(slug), text, Boolean(opts.detach))
+  )
+);
+agent.command("chat <slug>").description("interactive REPL with the default session").action(run(async (slug) => chatLoop(await resolveSessionRef(slug))));
+var session = program.command("session").description("sessions: the running instances of an agent");
+session.command("create <agent>").description("create a session (cheap \u2014 the pod starts on the first message)").option("--title <title>", "session title").option("--message <text>", "seed the session and start 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)").action(
+  run(async (agentRef, opts) => {
+    const { session: created } = await api("POST", "/api/v1/sessions", {
+      agent: agentRef,
+      ...opts.title ? { title: opts.title } : {},
+      ...opts.vcpus !== void 0 ? { vcpus: Number(opts.vcpus) } : {},
+      ...opts.memory !== void 0 ? { memoryMb: Number(opts.memory) } : {},
+      ...opts.message ? { initial_events: [{ type: "user.message", parts: [{ type: "text", index: 0, text: opts.message }] }] } : {}
+    });
+    console.log(`Created ${created.id} (${created.agent} \xB7 ${created.status})${created.default ? " [default]" : ""}`);
+    console.log(`  sky agent message ${created.agent} "hello"`);
+  })
+);
+session.command("list [agent]").action(
+  run(async (agentRef) => {
+    const qs = agentRef ? `?agent=${encodeURIComponent(agentRef)}` : "";
+    const { sessions } = await api("GET", `/api/v1/sessions${qs}`);
+    if (!sessions.length) {
+      console.log("No sessions. `sky session create <agent>` to start one.");
+      return;
+    }
+    for (const s of sessions) {
+      console.log(
+        `${s.id.padEnd(24)} ${(s.agent ?? "-").padEnd(20)} ${(s.title ?? "").padEnd(16)} ${s.status}${s.default ? " *" : ""}`
+      );
+    }
+  })
+);
+session.command("show <id>").action(
+  run(async (id) => {
+    const { session: s } = await api(
+      "GET",
+      `/api/v1/sessions/${encodeURIComponent(id)}`
+    );
+    console.log(`${s.id}${s.default ? " [default]" : ""}`);
+    console.log(`  agent   ${s.agent ?? "-"}`);
+    console.log(`  title   ${s.title ?? "-"}`);
+    console.log(`  status  ${s.status}`);
+    console.log(`  model   ${s.agentType} \xB7 ${s.llm}`);
+  })
+);
+session.command("destroy <id>").description("end the session and tear down its pod (admin scope)").action(
+  run(async (id) => {
+    await api("DELETE", `/api/v1/sessions/${encodeURIComponent(id)}`);
+    console.log(`Destroyed ${id}`);
+  })
+);
+session.command("message <ref> <text>").description("send one message (session id, or agent slug = its default session)").option("--detach", "don't follow the stream; exit after the 202").action(
+  run(
+    async (ref, text, opts) => sendAndFollow(await resolveSessionRef(ref), text, Boolean(opts.detach))
+  )
+);
+session.command("chat <ref>").description("interactive REPL over the standing stream").action(run(async (ref) => chatLoop(await resolveSessionRef(ref))));
+session.command("interrupt <ref>").description("abort the in-flight turn").action(
+  run(async (ref) => {
+    const id = await resolveSessionRef(ref);
+    const res = await api(
+      "POST",
+      `/api/v1/sessions/${encodeURIComponent(id)}/interrupt`
+    );
+    console.log(res.status === "no_turn" ? "nothing in flight" : "interrupting");
+  })
+);
+session.command("logs <ref>").option("-f, --follow", "follow (SSE)").option("--since <duration>", "how far back, e.g. 1h, 30m", "1h").action(
+  run(async (ref, opts) => {
+    const id = await resolveSessionRef(ref);
     const qs = `?since=${encodeURIComponent(opts.since)}${opts.follow ? "&follow=true" : ""}`;
     if (!opts.follow) {
       const { lines } = await api(
         "GET",
-        `/api/v1/agents/${encodeURIComponent(slug)}/logs${qs}`
+        `/api/v1/sessions/${encodeURIComponent(id)}/logs${qs}`
       );
       for (const entry of lines) console.log(`${entry.at} ${entry.line}`);
       return;
     }
-    const { parseSseStream } = await import("./src-KNBIGOZP.js");
+    const { parseSseStream } = await import("./src-CNT7GXZH.js");
     const { apiBase: apiBase2 } = await import("./config-HRDRNTUU.js");
     const token = apiToken();
-    const res = await fetch(`${apiBase2()}/api/v1/agents/${encodeURIComponent(slug)}/logs${qs}`, {
+    const res = await fetch(`${apiBase2()}/api/v1/sessions/${encodeURIComponent(id)}/logs${qs}`, {
       headers: { authorization: `Bearer ${token}`, accept: "text/event-stream" }
     });
     if (!res.ok || !res.body) throw new ApiError(res.status, "logs_failed", await res.text());
@@ -727,12 +823,12 @@ agent.command("logs <slug>").option("-f, --follow", "follow (SSE)").option("--si
     }
   })
 );
-async function sendAndFollow(slug, text, detach) {
+async function sendAndFollow(sessionId, text, detach) {
   const controller = new AbortController();
   let opened = null;
   if (!detach) {
     opened = (async () => {
-      for await (const frame of streamEvents(slug, controller.signal)) {
+      for await (const frame of streamEvents(sessionId, controller.signal)) {
         renderEvent(frame.event, frame.data);
         if (frame.event === "turn.status_idle" || frame.event === "turn.interrupted") {
           controller.abort();
@@ -742,68 +838,50 @@ async function sendAndFollow(slug, text, detach) {
     })();
     await new Promise((r) => setTimeout(r, 300));
   }
-  const { turnId } = await api(
-    "POST",
-    `/api/v1/agents/${encodeURIComponent(slug)}/messages`,
-    { parts: [{ type: "text", index: 0, text }] }
-  );
+  await api("POST", `/api/v1/sessions/${encodeURIComponent(sessionId)}/messages`, {
+    parts: [{ type: "text", index: 0, text }]
+  });
   if (detach) {
-    console.log(`accepted ${turnId}`);
+    console.log("accepted");
     return;
   }
   await opened;
 }
-agent.command("message <slug> <text>").description("send one message and stream the turn until idle").option("--detach", "don't follow the stream; print the turnId and exit").action(
-  run(
-    async (slug, text, opts) => sendAndFollow(slug, text, Boolean(opts.detach))
-  )
-);
-agent.command("chat <slug>").description("interactive REPL over the standing stream").action(
-  run(async (slug) => {
-    console.log(`Chatting with ${slug} \u2014 Ctrl-C to leave.`);
-    const controller = new AbortController();
-    const rl = createInterface2({ input: process.stdin, output: process.stdout, prompt: "> " });
-    void (async () => {
-      try {
-        for await (const frame of streamEvents(slug, controller.signal)) {
-          renderEvent(frame.event, frame.data);
-          if (frame.event === "turn.status_idle") rl.prompt();
-        }
-      } catch (error) {
-        fail(error);
-      }
-    })();
-    rl.prompt();
-    rl.on("line", (line) => {
-      const text = line.trim();
-      if (!text) {
-        rl.prompt();
-        return;
+async function chatLoop(sessionId) {
+  console.log(`Chatting with ${sessionId} \u2014 Ctrl-C to leave.`);
+  const controller = new AbortController();
+  const rl = createInterface2({ input: process.stdin, output: process.stdout, prompt: "> " });
+  void (async () => {
+    try {
+      for await (const frame of streamEvents(sessionId, controller.signal)) {
+        renderEvent(frame.event, frame.data);
+        if (frame.event === "turn.status_idle") rl.prompt();
       }
-      void api("POST", `/api/v1/agents/${encodeURIComponent(slug)}/messages`, {
-        parts: [{ type: "text", index: 0, text }]
-      }).catch((error) => {
-        console.error(`sky: ${error instanceof Error ? error.message : String(error)}`);
-        rl.prompt();
-      });
-    });
-    rl.on("close", () => {
-      controller.abort();
-      process.exit(0);
-    });
-    await new Promise(() => {
+    } catch (error) {
+      fail(error);
+    }
+  })();
+  rl.prompt();
+  rl.on("line", (line) => {
+    const text = line.trim();
+    if (!text) {
+      rl.prompt();
+      return;
+    }
+    void api("POST", `/api/v1/sessions/${encodeURIComponent(sessionId)}/messages`, {
+      parts: [{ type: "text", index: 0, text }]
+    }).catch((error) => {
+      console.error(`sky: ${error instanceof Error ? error.message : String(error)}`);
+      rl.prompt();
     });
-  })
-);
-agent.command("interrupt <slug>").description("abort the in-flight turn").action(
-  run(async (slug) => {
-    const res = await api(
-      "POST",
-      `/api/v1/agents/${encodeURIComponent(slug)}/interrupt`
-    );
-    console.log(res.status === "no_turn" ? "nothing in flight" : `interrupting ${res.turnId}`);
-  })
-);
+  });
+  rl.on("close", () => {
+    controller.abort();
+    process.exit(0);
+  });
+  await new Promise(() => {
+  });
+}
 var secrets = program.command("secrets").description("agent secrets (values write-only)");
 secrets.command("set <slug> <pairs...>").description("set KEY=VALUE pairs on the agent").action(
   run(async (slug, pairs) => {
@@ -849,7 +927,13 @@ program.command("launch").description("scaffold ./agent.toml if absent, create t
       console.log(`${file.slug} already launched \u2014 use \`sky deploy\` to re-apply.`);
       return;
     }
-    const { agent: created } = await api("POST", "/api/v1/agents", spec);
+    const { vcpus, memoryMb, ...specBody } = spec;
+    const { agent: created } = await api("POST", "/api/v1/agents", specBody);
+    await api("POST", "/api/v1/sessions", {
+      agent: created.slug,
+      ...vcpus !== void 0 ? { vcpus } : {},
+      ...memoryMb !== void 0 ? { memoryMb } : {}
+    });
     stampSlug(path, created.slug);
     console.log(`Launched ${created.slug} (${created.agentType} \xB7 ${created.llm})`);
     console.log(`  sky agent message ${created.slug} "hello"`);
@@ -862,7 +946,13 @@ program.command("deploy").description("re-apply ./agent.toml to the existing age
     const { file, spec } = readAgentFile(path);
     if (!file.slug) {
       console.log("No slug in the file yet \u2014 running launch instead.");
-      const { agent: created } = await api("POST", "/api/v1/agents", spec);
+      const { vcpus, memoryMb, ...specBody } = spec;
+      const { agent: created } = await api("POST", "/api/v1/agents", specBody);
+      await api("POST", "/api/v1/sessions", {
+        agent: created.slug,
+        ...vcpus !== void 0 ? { vcpus } : {},
+        ...memoryMb !== void 0 ? { memoryMb } : {}
+      });
       stampSlug(path, created.slug);
       console.log(`Launched ${created.slug}`);
       return;

package/dist/{src-KNBIGOZP.js → src-CNT7GXZH.js}

@@ -135,7 +135,7 @@ function replyParts(reply) {
 }
 async function postChatProxy(args) {
   const url = new URL(
-    `/api/v1/agents/${encodeURIComponent(args.agentRouteId)}/messages`,
+    `/api/v1/sessions/${encodeURIComponent(args.agentRouteId)}/messages`,
     normalizeBaseUrl(args.baseUrl)
   );
   const headers = {

package/package.json

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