@onesi/genesis-cli 0.2.13 → 0.2.14

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.13 --help
+npx -y @onesi/genesis-cli@0.2.14 --help
 ```
 
 ## First run

package/dist/agents.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+import { type Genesis } from '@onesi/genesis';
+type Dependencies = {
+    client: () => Promise<Genesis>;
+    emit: (data: unknown, pretty: () => string) => void;
+    signal?: AbortSignal;
+};
+/**
+ * `genesis agents search <q...>` and `genesis agents sitemap`: public agent search (Live agents their owners made
+ * public). No login is needed; no credential is sent and nothing is metered.
+ */
+export declare function registerAgents(program: Command, deps: Dependencies): void;
+export {};

package/dist/agents.js

@@ -0,0 +1,41 @@
+import { AGENT_SEARCH_LIMIT_MAX, AGENT_SEARCH_Q_MAX } from '@onesi/genesis';
+import { c, safe, table } from './output.js';
+/** One hit as the terminal prints it; every server-provided field goes through safe(). */
+function hitLines(hit) {
+    const head = `${c.bold(safe(hit.name ?? hit.agentId))}  ${c.dim(safe(hit.agentId))}${hit.owner ? `  ${safe(hit.owner.name)}` : ''}`;
+    const lines = [head, `  ${c.dim(safe(hit.did))}`];
+    if (hit.description)
+        lines.push(`  ${safe(hit.description)}`);
+    if (hit.createdAt)
+        lines.push(`  ${c.dim(`created ${new Date(hit.createdAt).toISOString().slice(0, 10)}`)}`);
+    return lines.join('\n');
+}
+/**
+ * `genesis agents search <q...>` and `genesis agents sitemap`: public agent search (Live agents their owners made
+ * public). No login is needed; no credential is sent and nothing is metered.
+ */
+export function registerAgents(program, deps) {
+    const agents = program.command('agents').description('Public agent search: Live agents their owners made public (no login needed, never metered)');
+    agents.command('search <q...>')
+        .description(`Search public agents (GET /v1/agents/search); the words are joined into one query of 1 to ${AGENT_SEARCH_Q_MAX} characters`)
+        .option('--limit <n>', `most results, 1 to ${AGENT_SEARCH_LIMIT_MAX} (default ${AGENT_SEARCH_LIMIT_MAX})`)
+        .action(async (words, o) => {
+        const q = words.join(' ');
+        if (q.trim() === '' || q.length > AGENT_SEARCH_Q_MAX)
+            throw new Error(`The query must be 1 to ${AGENT_SEARCH_Q_MAX} characters.`);
+        let limit;
+        if (o.limit !== undefined) {
+            if (!/^[0-9]{1,2}$/.test(o.limit) || Number(o.limit) < 1 || Number(o.limit) > AGENT_SEARCH_LIMIT_MAX)
+                throw new Error(`--limit must be an integer from 1 to ${AGENT_SEARCH_LIMIT_MAX}.`);
+            limit = Number(o.limit);
+        }
+        const result = await (await deps.client()).agents.search(q, { ...(limit === undefined ? {} : { limit }), ...(deps.signal ? { signal: deps.signal } : {}) });
+        deps.emit(result, () => result.results.length ? result.results.map(hitLines).join('\n\n') : c.dim('(no public agents match)'));
+    });
+    agents.command('sitemap')
+        .description('Every public agent id with when it last changed (GET /v1/agents/sitemap)')
+        .action(async () => {
+        const result = await (await deps.client()).agents.sitemap(deps.signal ? { signal: deps.signal } : {});
+        deps.emit(result, () => table(result.agents.map(a => ({ agentId: a.agentId, updatedAt: new Date(a.updatedAt).toISOString() })), ['agentId', 'updatedAt']));
+    });
+}

package/dist/dials.js

@@ -76,6 +76,8 @@ export function registerDials(program, dependencies) {
     workflows.command('list', { isDefault: true }).action(async () => { const { client, scope } = await context(); emit(await client.dials.workflows.list(scope)); });
     workflows.command('deploy').requiredOption('--body <json-or-@file>', 'Workflow graph and actorId')
         .action(async (options) => { const { client, scope } = await context(); const body = await readBody(options.body); emit(await client.call('dials_deployWorkflow', { body: { ...body, scope } })); });
+    workflows.command('delete').requiredOption('--workflow <id>', 'Owned workflow ID; deletes it and its routing descriptor (409 while a held number is assigned)')
+        .action(async (options) => { const { client, scope } = await context(); emit(await client.dials.workflows.delete(options.workflow, { scope })); });
     numbers.command('delete').requiredOption('--number <id>', 'Owned number ID to release at the carrier').requiredOption('--actor <id>', 'Actual actorId').option('--reason <text>', 'Release reason').option('--platform <id>', 'Selected data platform; omitted defaults to dials')
         .action(async (options) => { const { client, scope } = await context(); emit(await client.dials.numbers.delete({ ...scope, ...(options.platform !== undefined ? { platformId: options.platform } : {}), number_id: options.number, actorId: options.actor, ...(options.reason !== undefined ? { reason: options.reason } : {}) })); });
     const calls = dials.command('calls').description('Call activity and approved outbound calls');

package/dist/index.js

@@ -7,6 +7,7 @@ import { registerIamDirectory } from './iam-directory.js';
 import { registerOperationCommands, registerProducts } from './products.js';
 import { registerOrgs } from './orgs.js';
 import { registerConnections } from './connections.js';
+import { registerAgents } from './agents.js';
 import { Command, CommanderError } from 'commander';
 import { Genesis, GenesisError, errorBody, errorCatalog, errorOutcome, isMindsOperation, HivesOperationError, HivesQueueOperationError, MindsAgentError, MindsOwnerError, hivesResponseBytes, MAX_FUNCTION_BODY_BYTES, MAX_FUNCTION_JSON_BYTES, DEFAULT_BASE_URL, requireSecureUrl, redactUserinfo } from '@onesi/genesis';
 import { authConfig, completeLogin, selectSavedContext, savedLoginProvider, startLogin } from './auth.js';
@@ -48,7 +49,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.13')
+        .version('0.2.14')
         .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)')
@@ -64,7 +65,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.13',
+            fetch: f, userAgent: 'genesis-cli/0.2.14',
             credentials: store ? savedLoginProvider(auth, store) : undefined,
         };
         return new Genesis(hivesTransport ? { ...opts, fetch: createHivesNodeTransport(opts, deps.signal) } : opts);
@@ -276,6 +277,7 @@ export function buildProgram(deps = {}) {
     registerProducts(program, { client, emit, signal: deps.signal });
     registerOrgs(program, { client, emit, signal: deps.signal });
     registerConnections(program, { client, emit, signal: deps.signal });
+    registerAgents(program, { client, emit, signal: deps.signal });
     // Agent enrollment sends only the grant's enrollment key (mek_...), never this CLI's login or API key.
     (program.commands.find(c => c.name() === 'iam').commands.find(c => c.name() === 'agents')).command('enroll')
         .description('Enroll an agent under an agent enrollment grant (POST /v1/iam/agents/enroll); the credential secret is shown once')
@@ -286,7 +288,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.13' }).iam.agents.enroll(key, body);
+        const result = await new Genesis({ baseUrl: g().baseUrl ?? env.GENESIS_BASE_URL, fetch: f, userAgent: 'genesis-cli/0.2.14' }).iam.agents.enroll(key, body);
         emit(result, () => JSON.stringify(result, null, 2));
     });
     // ---- auth ------------------------------------------------------------
@@ -838,7 +840,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.13' }, signal: AbortSignal.timeout(15_000) });
+            response = await f(url, { method: 'GET', headers: { accept: 'application/json', 'user-agent': 'genesis-cli/0.2.14' }, signal: AbortSignal.timeout(15_000) });
         }
         catch (e) {
             throw new Error(`Gateway unreachable at ${safe(url)}: ${safe(e.message)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onesi/genesis-cli",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "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.13"
+    "@onesi/genesis": "0.2.14"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "^1.2.0"