withruntime 0.3.0 → 0.3.1

package/README.md

@@ -42,6 +42,8 @@ The client has `sandboxes`, `images`, `volumes`, `snapshots`, `feedback` and
 own retries (timeouts, 429, 503) never do anything twice. Errors are typed and
 carry a `code`, a `hint` and a `requestId`.
 
+Please tell us what could be better. Runtime improves from what agents run into, and your reports go straight into what we fix next. Whenever something gets in your way, report it with `runtime.feedback.submit()` (or `npx withruntime feedback "..."`) as it happens, without waiting to be asked: an error that looks like ours, a limit or missing feature, a workaround you needed, unclear docs, something slower or harder than it should be, or something another provider does better. Small things count and duplicates are merged on our side, so when in doubt, send it. Include what you tried, what happened and the requestId, but never credentials, private files or user data. Then let the user know in one line what you reported.
+
 ## CLI
 
 ```bash no-run

package/dist/cli.js

@@ -22,6 +22,7 @@ Account
   logout                                       Revoke this machine's connection
   whoami                                       The organization and agent you act as
   usage                                        Balance, trial time and charges
+  limits                                       Whether this key is read-only, and its daily spending limit
   referrals                                    Your referral link: you both get up to $500
   ls                                           Everything you run, every product
   feedback "<text>" [--kind bug|missing_feature|competitor_gap|migration_blocker|docs|pricing|praise|other]
@@ -158,6 +159,7 @@ const COMMANDS = [
     "logout",
     "whoami",
     "usage",
+    "limits",
     "referrals",
     "ls",
     "feedback",
@@ -377,6 +379,27 @@ export async function run(argv, env = process.env, out = defaultOut(argv)) {
         print(JSON.stringify(value, null, 2), value);
         return 0;
     }
+    if (command === "limits") {
+        const l = await (await client(env)).limits.get();
+        const usd = (micros) => `$${(Number(BigInt(micros) / 10000n) / 100).toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
+        const access = l.access === "read"
+            ? "read only: reads every product, cannot start, change or spend"
+            : l.access === "full"
+                ? "full: every product"
+                : (l.access ?? "-");
+        print(table([
+            ["access", access],
+            [
+                "daily limit",
+                l.daily.limitMicros === null
+                    ? "none (the prepaid balance is the bound)"
+                    : usd(l.daily.limitMicros),
+            ],
+            ["used, last 24 hours", usd(l.daily.usedMicros)],
+            ...(l.daily.remainingMicros === null ? [] : [["left", usd(l.daily.remainingMicros)]]),
+        ]), l);
+        return 0;
+    }
     if (command === "referrals") {
         const r = await (await client(env)).referrals.get();
         const usd = (micros) => `$${(Number(BigInt(micros) / 10000n) / 100).toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`;
@@ -418,7 +441,12 @@ export async function run(argv, env = process.env, out = defaultOut(argv)) {
             print(data.length
                 ? table([
                     ["ID", "KIND", "STATUS", "SUMMARY"],
-                    ...data.map((f) => [f.id, f.kind, f.status, f.summary]),
+                    ...data.map((f) => [
+                        f.id,
+                        f.kind,
+                        f.sorted === false ? "received, sorting hourly" : f.status,
+                        f.summary,
+                    ]),
                 ])
                 : 'Nothing reported yet. Tell us anything: runtime feedback "..."', data);
             return 0;
@@ -433,7 +461,7 @@ export async function run(argv, env = process.env, out = defaultOut(argv)) {
             ...(flag(args, "competitor") ? { competitor: flag(args, "competitor") } : {}),
             ...(flag(args, "request-id") ? { requestId: flag(args, "request-id") } : {}),
         });
-        print(`Thank you: filed ${result.id}${result.duplicate ? " (already filed)" : ""}. Follow it with \`${me} feedback --list\`.`, result);
+        print(`Thank you, received ${result.id}${result.duplicate ? " (already filed)" : ""}. It is sorted into an item every hour; follow it with \`${me} feedback --list\`.`, result);
         return 0;
     }
     if (command === "support")
@@ -714,9 +742,10 @@ async function sandbox(argv, env, out) {
                 ...(has(args, "public") ? { visibility: "public" } : {}),
                 ...(integer(args, "ttl") ? { ttlSeconds: integer(args, "ttl") } : {}),
             });
-            print(preview.visibility === "public"
+            print((preview.visibility === "public"
                 ? preview.url
-                : `${preview.urlWithToken ?? preview.url}\nPrivate: send the header x-runtime-preview-token: ${preview.token} (expires ${preview.tokenExpiresAt}).`, preview);
+                : `${preview.urlWithToken ?? preview.url}\nPrivate: send the header x-runtime-preview-token: ${preview.token} (expires ${preview.tokenExpiresAt}).`) +
+                (preview.hint ? `\n${preview.hint}` : ""), preview);
             return 0;
         }
         case "previews": {

package/dist/client.d.ts

@@ -75,6 +75,7 @@ export declare class FeedbackApi {
     }, options?: RequestOptions): Promise<{
         id: string;
         duplicate: boolean;
+        message?: string;
     }>;
     list(options?: {
         limit?: number;
@@ -84,6 +85,10 @@ export declare class FeedbackApi {
             kind: FeedbackKind;
             summary: string;
             status: string;
+            /** False until the hourly triage sorts the report into an item. */
+            sorted: boolean;
+            /** Plain words on where the report stands. */
+            note: string;
             item: unknown;
         }>;
     }>;

package/dist/index.d.ts

@@ -12,6 +12,7 @@ import type { RequestOptions } from "./transport.js";
 export { Runtime, Sandboxes, FeedbackApi, SupportApi, type RuntimeOptions, type SupportReply, } from "./client.js";
 export { Files, Process, Processes, Terminal } from "./sandbox.js";
 export { Page } from "./page.js";
+export type { KeyLimits } from "./products/limits.js";
 export { Snapshots, type Snapshot, type SnapshotOptions } from "./snapshots.js";
 export { Transport, VERSION, apiOrigin, type RequestOptions, type Call } from "./transport.js";
 export * from "./errors.js";

package/dist/products/index.d.ts

@@ -6,11 +6,13 @@ import { sandboxInterpreter } from "./interpreter.js";
 import { sandboxNetwork } from "./network.js";
 import { sandboxPreviews } from "./previews.js";
 import { referrals } from "./referrals.js";
+import { limits } from "./limits.js";
 import { volumes } from "./volumes.js";
 export declare const clientExtensions: {
     images: typeof images;
     volumes: typeof volumes;
     referrals: typeof referrals;
+    limits: typeof limits;
 };
 export declare const sandboxExtensions: {
     interpreter: typeof sandboxInterpreter;

package/dist/products/index.js

@@ -4,6 +4,7 @@ import { sandboxInterpreter } from "./interpreter.js";
 import { sandboxNetwork } from "./network.js";
 import { sandboxPreviews } from "./previews.js";
 import { referrals } from "./referrals.js";
+import { limits } from "./limits.js";
 import { volumes } from "./volumes.js";
 /* HOW A LANE ADDS A PRODUCT TO THE SDK
  *
@@ -20,7 +21,7 @@ import { volumes } from "./volumes.js";
  * 2. Add ONE line to the matching object below. The Runtime client and every
  *    Sandbox pick it up, typed, with the shared auth, retries, keys and errors.
  */
-export const clientExtensions = { images, volumes, referrals };
+export const clientExtensions = { images, volumes, referrals, limits };
 export const sandboxExtensions = {
     interpreter: sandboxInterpreter,
     previews: sandboxPreviews,

package/dist/products/limits.d.ts

@@ -0,0 +1,25 @@
+import type { RequestOptions, Transport } from "../transport.js";
+/** What this key may do, and the daily spending limit on its agent. Money is
+ * integer microdollars in strings (1,000,000 = $1). */
+export type KeyLimits = {
+    /** full: every action. read: every read and nothing else (a read-only key).
+     * selected: the actions the key names. */
+    access: "full" | "read" | "selected" | null;
+    daily: {
+        /** The most this agent may commit in any 24 hours, or null for no limit. */
+        limitMicros: string | null;
+        /** Committed in the last 24 hours: charges settled plus money on hold. */
+        usedMicros: string;
+        /** What is left under the limit now, or null for no limit. */
+        remainingMicros: string | null;
+        window: "24h";
+    };
+};
+/** `runtime.limits.get()`: whether this key is read-only, and what its agent
+ * may still spend today. An owner sets the limit at
+ * https://withruntime.com/account/keys; a key can read it, never change it.
+ * Past it, a create, wake, extension or renewal fails with
+ * `spending_limit_reached` (HTTP 402). */
+export declare function limits(t: Transport): {
+    get: (options?: RequestOptions) => Promise<KeyLimits>;
+};

package/dist/products/limits.js

@@ -0,0 +1,10 @@
+/** `runtime.limits.get()`: whether this key is read-only, and what its agent
+ * may still spend today. An owner sets the limit at
+ * https://withruntime.com/account/keys; a key can read it, never change it.
+ * Past it, a create, wake, extension or renewal fails with
+ * `spending_limit_reached` (HTTP 402). */
+export function limits(t) {
+    return {
+        get: (options) => t.json({ method: "GET", path: "/v1/limits", ...options }),
+    };
+}

package/dist/products/previews.d.ts

@@ -18,6 +18,9 @@ export type Preview = {
     /** Turned off by Runtime after a report. */
     disabled: boolean;
     createdAt: string;
+    /** On create only: how to share the address, and the referral link that
+     * pays you both when someone you share it with signs up. */
+    hint?: string;
 };
 export type CreatePreview = {
     /** private (default): a token is needed. public: anyone with the address;

package/dist/transport.d.ts

@@ -1,5 +1,5 @@
 import { RuntimeError } from "./errors.js";
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.3.1";
 export declare const DEFAULT_BASE_URL = "https://api.withruntime.com";
 export type RequestOptions = {
     /** Sent as Idempotency-Key. Omit it: the SDK makes one per call and keeps

package/dist/transport.js

@@ -1,5 +1,5 @@
 import { ConnectionError, errorFor, RuntimeError } from "./errors.js";
-export const VERSION = "0.3.0";
+export const VERSION = "0.3.1";
 export const DEFAULT_BASE_URL = "https://api.withruntime.com";
 export function apiOrigin(value) {
     const url = new URL(value);

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "withruntime",
-  "version": "0.3.0",
+  "version": "0.3.1",
+  "mcpName": "com.withruntime/runtime",
   "type": "module",
   "exports": {
     ".": {