@usenaive-sdk/vetta-cli 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,8 @@
 # @usenaive-sdk/vetta-cli
 
 The `vetta` command line — drive the whole Vetta API from a terminal or a script: agents, sessions,
-computers, skills, files, identities, vaults, comms, deployments, webhooks and credits.
+computers, skills, files, identities, vaults, comms, deployments, webhooks, the monthly plan and
+credits.
 
 It is built on [`@usenaive-sdk/vetta`](https://www.npmjs.com/package/@usenaive-sdk/vetta), the same typed
 client the dashboard uses, so the CLI and the API never drift apart.
@@ -17,6 +18,7 @@ npm i -g @usenaive-sdk/vetta-cli
 ```bash
 vetta login --api-key sk_…      # or: vetta login --email … --password …
 vetta whoami
+vetta plan show                 # an org with no plan is refused everywhere else
 ```
 
 Credentials are stored on a named profile, so several organizations can be driven from one machine
@@ -29,8 +31,8 @@ vetta <group> <command> [flags]
 ```
 
 Groups: `agent` `audit` `auth` `computer` `connections` `credits` `deploy` `domain` `email` `file`
-`identity` `keys` `login` `logout` `models` `org` `phone` `run` `session` `skill` `vault` `webhook`
-`whoami`.
+`identity` `keys` `login` `logout` `models` `org` `phone` `plan` `run` `session` `skill` `vault`
+`webhook` `whoami`.
 
 `vetta <group> --help` lists a group's commands.
 

package/dist/index.js

@@ -23455,7 +23455,12 @@ var AcknowledgedSchema = external_exports.object({
 var auth = (config2) => ({
   /** Who this credential is. No scope, no org id needed — that is the whole point (§20.1). */
   me: () => request(config2, IdentitySchema22, { method: "GET", path: "/v1/me" }),
-  /** Sign in, or re-scope the session already held to another organization (§20.4). */
+  /**
+   * Sign in, finish an external sign-in, or re-scope the session already held to another
+   * organization (§20.4). `provider_token` is the access token an external provider sign-in came
+   * back with; the control plane re-verifies it against the provider and refuses an address the
+   * provider has not proved.
+   */
   session: (body) => request(config2, AuthSessionSchema, { method: "POST", path: "/v1/auth/session", body }),
   register: (body) => request(
     config2,
@@ -24711,6 +24716,17 @@ var credits2 = {
     })
   })
 };
+var plan = {
+  /** `status`, when the paid period ends, and whether it is already set to stop (§18b). */
+  show: async ({ client }) => ({ out: await client.credits.subscription() }),
+  /**
+   * Opens the hosted checkout and changes **nothing**, exactly like `credits topup`: the plan turns
+   * `active` only when the signed provider callback lands, whenever the customer gets round to
+   * paying. So this prints `action_url` whole and returns, rather than blocking on a purchase it
+   * cannot see, cannot complete and cannot cancel. `vetta plan show` is what reports the outcome.
+   */
+  subscribe: async ({ client }) => ({ out: await client.credits.subscribe() })
+};
 
 // src/commands/deploy.ts
 function fields(args) {
@@ -24969,8 +24985,16 @@ function exitForStopReason(reason) {
 function exitForError(cause) {
   return cause instanceof UsageError ? EXIT_USAGE : EXIT_ERROR;
 }
+var REMEDY = {
+  subscription_required: "vetta plan subscribe"
+};
 function describeError(cause) {
-  if (cause instanceof ApiError) return `error: ${cause.code}: ${cause.message} (${cause.requestId})`;
+  if (cause instanceof ApiError) {
+    const remedy = REMEDY[cause.code];
+    const fix = remedy === void 0 ? "" : `
+fix it with: ${remedy}`;
+    return `error: ${cause.code}: ${cause.message} (${cause.requestId})${fix}`;
+  }
   if (cause instanceof UsageError) return `usage: ${cause.message}`;
   return `error: ${cause instanceof Error ? cause.message : String(cause)}`;
 }
@@ -25309,7 +25333,8 @@ var GROUPS = {
   webhook,
   org,
   keys: keys2,
-  credits: credits2
+  credits: credits2,
+  plan
 };
 var FLAGS = {
   auth: {
@@ -25472,7 +25497,12 @@ var FLAGS = {
     remove: ""
   },
   keys: { create: "name scopes", list: "limit after", rotate: "", revoke: "" },
-  credits: { show: "", topup: "usd", ledger: "type session agent deployment from to limit after" }
+  credits: { show: "", topup: "usd", ledger: "type session agent deployment from to limit after" },
+  /**
+   * The monthly plan (§18b). Neither command takes a flag: the plan has one price, and `subscribe`
+   * has nothing to configure — it answers a checkout URL for a human to open.
+   */
+  plan: { show: "", subscribe: "" }
 };
 var GLOBAL_FLAGS = "json human profile api-key org api-base-url version help";
 var UNSUPPORTED = {
@@ -25495,7 +25525,7 @@ var ALIASES = {
 };
 
 // src/cli.ts
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
+var VERSION = true ? "0.2.0" : "0.0.0-dev";
 var GLOBAL_FLAGS_HELP = "global flags: --json (default) --human --profile <name> --api-key <key> --org <org_id> --api-base-url <url>";
 function usage() {
   const groups = [...Object.keys(GROUPS), ...Object.keys(ALIASES)].sort().join(", ");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@usenaive-sdk/vetta-cli",
-  "version": "0.1.0",
-  "description": "Vetta command line \u2014 create agents, run sessions, watch events, see cost.",
+  "version": "0.2.0",
+  "description": "Vetta command line — create agents, run sessions, watch events, see cost.",
   "license": "MIT",
   "type": "module",
   "bin": {