@onesi/genesis-cli 0.2.8 → 0.2.9

package/README.md

@@ -3,7 +3,7 @@
 `genesis`, the OneOS command line. It works against the Genesis API at `https://os.one.ml/api`.
 
 ```sh
-npx -y @onesi/genesis-cli@0.2.8 --help
+npx -y @onesi/genesis-cli@0.2.9 --help
 ```
 
 ## First run

package/dist/fleets.js

@@ -121,9 +121,10 @@ export function registerFleets(program, client, emit, keyInput = readFoundryKey,
             throw new Error('Provide --name or --borrow-ceiling.');
         emit(await (await client()).fleets.seats.update(id, body));
     });
-    seats.command('top-up <seat_id> <credits>').description('Add credits to the seat purse (overdraft is repaid first; pooled seats: top up the pool)')
+    seats.command('top-up <seat_id> <credits>').description('Add credits (0 with --computer-minutes) and optionally computer minutes to the seat (overdraft is repaid first; helpers take no minutes; pooled seats: top up the pool)')
+        .option('--computer-minutes <minutes>', 'add computer minutes to the seat entitlement')
         .requiredOption('--idempotency-key <key>', 'stable key to reuse on retry')
-        .action(async (id, credits, options) => emit(await (await client()).fleets.seats.topUp(id, count(credits), options.idempotencyKey)));
+        .action(async (id, credits, options) => emit(await (await client()).fleets.seats.topUp(id, count(credits), options.idempotencyKey, options.computerMinutes !== undefined ? count(options.computerMinutes) : undefined)));
     seats.command('upgrade <seat_id> <type>').description('Move to a larger plan (no downgrade)')
         .action(async (id, type) => emit(await (await client()).fleets.seats.upgrade(id, seatType(type))));
     seats.command('hold <seat_id>').description('No new work; a running task is cancelled with a signed receipt').action(async (id) => emit(await (await client()).fleets.seats.hold(id)));

package/dist/index.js

@@ -47,7 +47,7 @@ export function buildProgram(deps = {}) {
     const auth = { ...authConfig(env, f), sleep: deps.sleep };
     const program = new Command('genesis')
         .description('One CLI for every Genesis service.')
-        .version('0.2.8')
+        .version('0.2.9')
         .option('--json', 'machine-readable JSON output')
         .option('--api-key <key>', 'use this API key (default: GENESIS_API_KEY, then your `genesis login`)')
         .option('--base-url <url>', 'gateway URL (default: GENESIS_BASE_URL or https://os.one.ml/api)')
@@ -63,7 +63,7 @@ export function buildProgram(deps = {}) {
         const opts = {
             apiKey: o.apiKey ?? env.GENESIS_API_KEY, token: env.GENESIS_TOKEN,
             baseUrl: o.baseUrl ?? env.GENESIS_BASE_URL, routing: o.direct || env.GENESIS_ROUTING === 'direct' ? 'direct' : 'gateway',
-            fetch: f, userAgent: 'genesis-cli/0.2.8',
+            fetch: f, userAgent: 'genesis-cli/0.2.9',
             credentials: store ? savedLoginProvider(auth, store) : undefined,
         };
         return new Genesis(hivesTransport ? { ...opts, fetch: createHivesNodeTransport(opts, deps.signal) } : opts);
@@ -284,7 +284,7 @@ export function buildProgram(deps = {}) {
         if (!key)
             throw new Error('Give the enrollment key with --key-file, --key-stdin or GENESIS_ENROLLMENT_KEY; it is never accepted as an argument.');
         const body = await readFunctionJson(o.bodyFile, 16 * 1024);
-        const result = await new Genesis({ baseUrl: g().baseUrl ?? env.GENESIS_BASE_URL, fetch: f, userAgent: 'genesis-cli/0.2.8' }).iam.agents.enroll(key, body);
+        const result = await new Genesis({ baseUrl: g().baseUrl ?? env.GENESIS_BASE_URL, fetch: f, userAgent: 'genesis-cli/0.2.9' }).iam.agents.enroll(key, body);
         emit(result, () => JSON.stringify(result, null, 2));
     });
     // ---- auth ------------------------------------------------------------
@@ -413,7 +413,7 @@ export function buildProgram(deps = {}) {
     // ---- foundry ---------------------------------------------------------
     // registerProducts (above) already added the generated `foundry` commands; the hand-written ones join them.
     const foundry = program.commands.find(c => c.name() === 'foundry') ?? program.command('foundry').description('Foundry: models and inference');
-    const foundryBilling = foundry.command('billing').description('Current organization’s native TEST billing; original One account human login required');
+    const foundryBilling = foundry.command('billing').description('Current organization’s native TEST billing: profile and balance with a login or an org API key holding genesis.billing.read; ensure and checkout need the original One account human login');
     foundryBilling.command('profile').action(async () => out.log(JSON.stringify(await (await client()).foundry.billing.profile({ signal: deps.signal }), null, 2)));
     foundryBilling.command('ensure').requiredOption('--operation-key <key>', 'Persisted operation key; reconcile unknown outcomes before retrying').action(async (o) => out.log(JSON.stringify(await (await client()).foundry.billing.ensureProfile(o.operationKey, { signal: deps.signal }), null, 2)));
     foundryBilling.command('checkout').requiredOption('--purchase-key <key>', 'Persisted purchase key; server controls the TEST amount').action(async (o) => out.log(JSON.stringify(await (await client()).foundry.billing.checkoutCredits(o.purchaseKey, { signal: deps.signal }), null, 2)));
@@ -836,7 +836,7 @@ export function buildProgram(deps = {}) {
         const url = `${base.href.replace(/\/+$/, '')}/v1/status`;
         let response;
         try {
-            response = await f(url, { method: 'GET', headers: { accept: 'application/json', 'user-agent': 'genesis-cli/0.2.8' }, signal: AbortSignal.timeout(15_000) });
+            response = await f(url, { method: 'GET', headers: { accept: 'application/json', 'user-agent': 'genesis-cli/0.2.9' }, signal: AbortSignal.timeout(15_000) });
         }
         catch (e) {
             throw new Error(`Gateway unreachable at ${safe(url)}: ${safe(e.message)}`);

package/dist/minds.js

@@ -4,7 +4,7 @@ import { Option } from 'commander';
 import { mindsServices } from '@onesi/genesis';
 export function registerMinds(program, client, emit, agentClient = client, signal, ownerClient = client) {
     // `minds engine ...` (generated, products.ts) may already have created the root.
-    const minds = (program.commands.find(c => c.name() === 'minds') ?? program.command('minds')).description('Owned Minds and persisted memory; a human Console Sandbox session, or an org API key with minds:read/minds:write/minds:manage');
+    const minds = (program.commands.find(c => c.name() === 'minds') ?? program.command('minds')).description('Owned Minds and persisted memory; a human Console session (Sandbox, or Live), or an org API key with minds:read/minds:write/minds:manage; the key or login binding selects the environment');
     registerMindsOwner(minds, ownerClient, emit, signal);
     minds.command('list').option('--after <uuid>').option('--limit <number>').description('List real Minds and the current creation context fingerprint').action(async (options) => {
         emit(await (await client()).minds.list({ ...(options.after ? { after: options.after } : {}), ...(options.limit ? { limit: Number(options.limit) } : {}) }));
@@ -14,7 +14,7 @@ export function registerMinds(program, client, emit, agentClient = client, signa
         .requiredOption('--from <timestamp>', 'RFC3339 window start')
         .requiredOption('--to <timestamp>', 'RFC3339 window end')
         .action(async (options) => emit(await (await client()).minds.usage({ from: options.from, to: options.to })));
-    minds.command('create <name>').description('Create a Sandbox Mind; Free/F1 by default or an admitted Pro profile; 202 means provisioning')
+    minds.command('create <name>').description('Create a Mind in the selected environment (a Sandbox Mind is named "Sandbox ..."; Live needs Minds Live and your organization admitted); Free/F1 by default or an admitted Pro profile; 202 means provisioning')
         .requiredOption('--idempotency-key <uuid>', 'persist this UUID4 and retain it after an uncertain response')
         .requiredOption('--context-sha256 <hash>', 'context_sha256 from the current minds list response')
         .addOption(new Option('--plan <plan>', 'explicit plan; entitlement remains server-authorized').choices(['free', 'pro']))
@@ -39,7 +39,7 @@ export function registerMinds(program, client, emit, agentClient = client, signa
         .requiredOption('--expected-generation <number>', 'desired_generation from a fresh owned Mind read')
         .requiredOption('--idempotency-key <uuid>', 'persist this UUID4 and original generation; no automatic retry')
         .action(async (id, options) => emit(await (await client()).minds.delete(id, Number(options.expectedGeneration), { idempotencyKey: options.idempotencyKey })));
-    minds.command('resize <mind_id>').description('Resize to an existing Pro profile (org API keys need minds:manage); 202 means accepted')
+    minds.command('resize <mind_id>').description('Resize to an existing Pro profile; org API keys with minds:manage only (Console sessions are refused with MINDS_MANAGE_KEY_REQUIRED); 202 means accepted')
         .requiredOption('--expected-generation <number>', 'desired_generation from a fresh owned Mind read')
         .addOption(new Option('--profile-id <profile>', 'existing Pro profile').choices(['F1', 'D1', 'D2']).makeOptionMandatory())
         .requiredOption('--idempotency-key <uuid>', 'persist this UUID4 and original generation; no automatic retry')

package/dist/products.js

@@ -39,6 +39,10 @@ export const PRODUCT_COMMANDS = {
             'quotas get': 'gateway_getOrgQuotas', 'quotas requests list': 'gateway_listQuotaRequests', 'quotas requests create': 'gateway_createQuotaRequest',
             'minds-account': 'gateway_getMindsAccount', invoices: 'gateway_listOrgInvoices', 'usage-report': 'gateway_getOrgUsageReport', catalog: 'gateway_listBillingServices',
         } },
+    credits: { description: 'Your One credits: balance, ledger, usage, settings, checkout and subscription (login session, or an org API key with genesis.billing.read / .manage). Stripe test mode: checkout opens checkout.stripe.com and nothing is charged until you pay there.', commands: {
+            balance: 'gateway_getCredits', entries: 'gateway_listCreditEntries', usage: 'gateway_listCreditUsage', settings: 'gateway_updateCreditSettings',
+            checkout: 'gateway_createCreditCheckout', subscription: 'gateway_changeCreditSubscription', cancel: 'gateway_cancelCreditSubscription',
+        } },
     gears: { description: 'Gears: durable workflows, runs, signals and run lifecycle', commands: {
             'workflows list': 'gears_listWorkflows', 'workflows get': 'gears_getWorkflow', 'workflows register': 'gears_registerWorkflow',
             'runs list': 'gears_listRuns', 'runs get': 'gears_getRun', 'runs history': 'gears_getRunHistory',
@@ -235,7 +239,7 @@ export const PRODUCT_COMMANDS = {
             'lineage requests list': 'taps_listAgentLineageRequests', 'lineage requests get': 'taps_getAgentLineageRequest',
         } },
     // `genesis minds engine <family> <verb> <mind_id> [params]`: every Minds engine route, generated from the grant table.
-    minds: { description: 'Minds: your Sandbox Minds (One account login)', commands: mindsEngineCommands },
+    minds: { description: 'Minds: your Minds in the selected environment (One account login)', commands: mindsEngineCommands },
     boxes: { description: 'Boxes: mail, docs, files, sheets, slides, calendar and identity (org API key; GET boxes:read, writes boxes:write, mail domains boxes:admin)', commands: {
             // boxes:begin
             'mail addresses create': 'boxes_mail_addresses_create',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onesi/genesis-cli",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/l1felabs/genesis-api.git",
@@ -33,7 +33,7 @@
   "dependencies": {
     "commander": "^14.0.0",
     "undici": "6.29.0",
-    "@onesi/genesis": "0.2.8"
+    "@onesi/genesis": "0.2.9"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "^1.2.0"