promigence 0.1.0-beta.3 → 0.1.0-beta.4

package/dist/generated.d.ts

@@ -32,3 +32,4 @@ export declare const PRICING: {
     readonly granularity_seconds: 1;
     readonly interim_interval_seconds: 60;
 };
+export declare const SANDBOX_STATES: readonly ["queued", "awaiting_capacity", "ready", "running", "paused", "ended"];

package/dist/generated.js

@@ -285,3 +285,4 @@ export const PRICING = {
     granularity_seconds: 1,
     interim_interval_seconds: 60,
 };
+export const SANDBOX_STATES = ["queued", "awaiting_capacity", "ready", "running", "paused", "ended"];

package/dist/login.js

@@ -239,7 +239,20 @@ function loopbackUris(cfg) {
         skipped: all.filter((u) => !isUsableLoopbackUri(u)).map((u) => JSON.stringify(u)),
     };
 }
-async function listenLoopback(uris, expectState, squatted) {
+const LOOP_CSS = "html{background:#09090b;color:#ededf0;font:16px/1.6 ui-sans-serif,system-ui,-apple-system,Segoe UI,sans-serif}"
+    + "body{min-height:100vh;margin:0;display:flex;align-items:center;justify-content:center;padding:24px}"
+    + "main{max-width:460px;border:1px solid #2a2a30;background:#111113;padding:32px 34px}"
+    + "b{display:block;color:#39ff14;font-size:12px;letter-spacing:.14em;text-transform:uppercase;margin-bottom:14px}"
+    + "h1{font-size:24px;margin:0 0 10px;letter-spacing:-.01em}p{margin:0;color:#a1a1aa}";
+const LOOP_CSP = `default-src 'none'; style-src 'sha256-${createHash("sha256").update(LOOP_CSS).digest("base64")}'`;
+export function loopbackPage(title, body) {
+    return `<!doctype html><html lang=en><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1">`
+        + `<title>${title}</title><style>${LOOP_CSS}</style><main><b>Promigence</b><h1>${title}</h1><p>${body}</p></main></html>`;
+}
+export function finishUrl(consoleOrigin, outcome) {
+    return consoleOrigin ? `${consoleOrigin}/cli/${outcome}` : undefined;
+}
+async function listenLoopback(uris, expectState, squatted, consoleOrigin) {
     for (const uri of uris) {
         const u = new URL(uri);
         const hosts = new Set([`localhost:${u.port}`, `127.0.0.1:${u.port}`, `[::1]:${u.port}`]);
@@ -250,7 +263,7 @@ async function listenLoopback(uris, expectState, squatted) {
             res.setHeader("content-type", "text/html; charset=utf-8");
             res.setHeader("cache-control", "no-store");
             res.setHeader("x-content-type-options", "nosniff");
-            res.setHeader("content-security-policy", "default-src 'none'");
+            res.setHeader("content-security-policy", LOOP_CSP);
             res.setHeader("referrer-policy", "no-referrer");
             if (!hosts.has((req.headers.host ?? "").toLowerCase())) {
                 res.writeHead(400).end();
@@ -275,17 +288,24 @@ async function listenLoopback(uris, expectState, squatted) {
             const code = got.searchParams.get("code");
             const state = got.searchParams.get("state") ?? "";
             const error = got.searchParams.get("error");
-            const page = (title, body) => `<!doctype html><meta charset=utf-8><title>${title}</title><h1>${title}</h1><p>${body}</p>`;
+            const page = loopbackPage;
+            const finish = (outcome, status, title, body) => {
+                const to = finishUrl(consoleOrigin, outcome);
+                if (to)
+                    res.writeHead(303, { location: to }).end();
+                else
+                    res.writeHead(status).end(page(title, body));
+            };
             if (state !== expectState) {
                 res.writeHead(400).end(page("Promigence login", "This login link is not the one the CLI started. Return to the terminal."));
                 return;
             }
             if (error || !code) {
-                res.writeHead(400).end(page("Promigence login failed", "Return to the terminal for details."));
+                finish(error === "access_denied" ? "cancelled" : "sign-in-failed", 400, "Sign-in did not finish", "Return to your terminal for the details.");
                 fail(new AuthError(`login was not completed: ${error ?? "no code"} ${got.searchParams.get("error_description") ?? ""}`.trim(), FAILED_SIGN_IN_FIX));
                 return;
             }
-            res.writeHead(200).end(page("Logged in to Promigence", "You can close this tab and return to the terminal."));
+            finish("signed-in", 200, "You're signed in", "The Promigence CLI is signed in. You can close this tab and return to your terminal.");
             settle({ code, state });
         });
         const v4err = await bindOn(server, Number(u.port), "127.0.0.1");
@@ -383,7 +403,15 @@ async function loopbackOrPaste(ctx, cfg, state) {
         return undefined;
     const { usable, skipped } = loopbackUris(cfg);
     const squatted = [];
-    const loop = await listenLoopback(usable, state, squatted);
+    const via = consoleAuthorizeUrl(cfg);
+    let origin;
+    try {
+        origin = via ? new URL(via).origin : undefined;
+    }
+    catch {
+        origin = undefined;
+    }
+    const loop = await listenLoopback(usable, state, squatted, origin);
     if (loop)
         return loop;
     if (squatted.length) {

package/dist/sdk/core.d.ts

@@ -1,5 +1,5 @@
 /** Promigence SDK — constants, error hierarchy and shared types. */
-export declare const VERSION = "0.1.0-beta.3";
+export declare const VERSION = "0.1.0-beta.4";
 export declare const DOCS_URL = "https://promigence.ai";
 /** The error reference; each code is an anchor on it (the API's `docs` link has the same form). */
 export declare const ERRORS_DOCS_URL = "https://www.promigence.ai/docs/errors";

package/dist/sdk/core.js

@@ -1,5 +1,5 @@
 import { hintArg } from "./hint.js";
-export const VERSION = "0.1.0-beta.3";
+export const VERSION = "0.1.0-beta.4";
 export const DOCS_URL = "https://promigence.ai";
 export const ERRORS_DOCS_URL = "https://www.promigence.ai/docs/errors";
 export const DEFAULT_API_URL = "https://api.promigence.ai/v1";

package/dist/sdk/models.gen.d.ts

@@ -4050,7 +4050,8 @@ export interface SandboxList {
     next_cursor?: string | null;
     sandboxes: Array<SandboxView>;
     /**
-     * The state filter this list was produced with; empty when none was given.
+     * The state filter this list was produced with; empty when none was given. `queued` keeps
+     * every waiting sandbox; `awaiting_capacity` only those waiting for capacity being added.
      */
     state: Array<string>;
 }
@@ -4357,7 +4358,7 @@ export interface SandboxView {
     cost_usd?: number | null;
     /**
      * Milliseconds from the start request, after any time queued, to the sandbox being handed
-     * over: it does not include `queued_ms`. `total_ms` is the whole wait.
+     * over: it does not include `queued_ms`. Add `queued_ms` for the whole wait.
      */
     e2e_ms?: number | null;
     /**

package/dist/surface.js

@@ -1,4 +1,5 @@
 import { VERSION, DOCS_URL } from "./sdk/index.js";
+import { SANDBOX_STATES } from "./generated.js";
 export { VERSION, DOCS_URL };
 export const SCHEMA = "promigence.cli/v1";
 export const GUIDE_POINTER = "AI agents: run 'promigence agent-guide' (~1.2k tokens) before using this tool.";
@@ -1070,7 +1071,7 @@ export const COMMANDS = [
         summary: "your sandboxes, newest first",
         flags: [
             { name: "--limit", arg: "N", summary: "how many (default 50)" },
-            { name: "--state", arg: "S", summary: "only these states, e.g. running,ready", repeatable: true },
+            { name: "--state", arg: "S", summary: `only these states, comma-separated: ${SANDBOX_STATES.join(", ")}`, repeatable: true },
             { name: "--label", arg: "K=V", summary: "only sandboxes whose run carries every label given", repeatable: true },
             { name: "--cursor", arg: "C", summary: "the next_cursor of an earlier page" },
             json,

package/llms.txt

@@ -1,4 +1,4 @@
-# Promigence — promigence@0.1.0-beta.3
+# Promigence — promigence@0.1.0-beta.4
 
 > Verified, reproducible, forkable execution environments for agents. The CLI is the
 > `promigence` command (package `promigence`, which is also the TypeScript SDK).
@@ -126,7 +126,7 @@
 
 ---
 
-# Promigence — agent guide (promigence@0.1.0-beta.3)
+# Promigence — agent guide (promigence@0.1.0-beta.4)
 
 Promigence is an **environment runtime**: verified, reproducible, forkable execution
 environments, billed per second (vCPU + memory). The model is one line:
@@ -196,4 +196,4 @@ Highest-precedence code wins: 2 > 5 > 6 > 7/8/9/10 > 11 > 3 > 12 > 4 > 1 > 0.
 · `promigence <command> --help` · https://promigence.ai
 Same surface as MCP tools: `promigence mcp` (stdio; `claude mcp add promigence -- promigence mcp`).
 
-Live in v0.1.0-beta.3: login · signup · logout · auth login · keys list/create/revoke · org list/create/switch/members/invite/invites/uninvite/resend/role/remove/leave/join/audit/rename/delete · project list/create/rename/delete/cap/move · me · billing card/usage/portal · doctor · ping · init · examples · templates +show · agent-guide · mcp · snapshot create/status/list/inspect/verify/export/delete/builds/alias · image resolve · github connect/status/disconnect/untrack · repos · gitlab connect/status/disconnect/untrack · run +quote/report/status/cancel/kill/replay/open/captures/list · fork · exec +output/ps/stdin/kill · files put/get/ls/search/mkdir/mv/cp/chmod/rm · agent start · sandbox kill/network/shell/ssh/list/pause/resume/snapshot/info/extend/autopause/probe · port expose/list/revoke · secrets set/list/delete · bench burst · runners github/gitlab · status · referrals +apply · pricing · credits +claim
+Live in v0.1.0-beta.4: login · signup · logout · auth login · keys list/create/revoke · org list/create/switch/members/invite/invites/uninvite/resend/role/remove/leave/join/audit/rename/delete · project list/create/rename/delete/cap/move · me · billing card/usage/portal · doctor · ping · init · examples · templates +show · agent-guide · mcp · snapshot create/status/list/inspect/verify/export/delete/builds/alias · image resolve · github connect/status/disconnect/untrack · repos · gitlab connect/status/disconnect/untrack · run +quote/report/status/cancel/kill/replay/open/captures/list · fork · exec +output/ps/stdin/kill · files put/get/ls/search/mkdir/mv/cp/chmod/rm · agent start · sandbox kill/network/shell/ssh/list/pause/resume/snapshot/info/extend/autopause/probe · port expose/list/revoke · secrets set/list/delete · bench burst · runners github/gitlab · status · referrals +apply · pricing · credits +claim

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promigence",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.4",
   "description": "The fastest sandboxes for AI agents and code. Snapshot an environment once, fork it as often as you need, run commands in every copy, and get a report that tells environment failures from task failures. Billed per second, with a quote before a run and a hard spend cap. One package: the promigence command and the TypeScript SDK.",
   "license": "Apache-2.0",
   "homepage": "https://www.promigence.ai",