@alvera-ai/platform-sdk 0.9.0 → 0.10.0-rc.2

package/package.json

@@ -1,23 +1,20 @@
 {
   "name": "@alvera-ai/platform-sdk",
-  "version": "0.9.0",
+  "version": "0.10.0-rc.2",
   "description": "Typed SDK for the Alvera platform API — manage data sources, tools, generic tables, AI agents, and action status updaters.",
   "type": "module",
   "sideEffects": false,
-  "main": "./src/index.ts",
-  "module": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "import": "./src/index.ts"
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
     }
   },
-  "bin": {
-    "alvera": "./src/cli.ts"
-  },
   "files": [
-    "src",
+    "dist",
     "README.md",
     "LICENSE"
   ],
@@ -29,17 +26,18 @@
     "codegen": "openapi-ts && tsx scripts/patch-generated.ts",
     "check-coverage": "tsx scripts/check-sdk-coverage.ts",
     "regen": "bun run gen-environments && bun run codegen && bun run check-coverage",
+    "build": "tsdown",
     "typecheck": "tsc --noEmit && tsc --noEmit -p scripts/tsconfig.json",
-    "clean": "rm -rf src/generated src/environments.generated.ts",
-    "prepare": "bun run gen-environments && bun run codegen && bun run check-coverage"
+    "clean": "rm -rf dist src/generated src/environments.generated.ts",
+    "prepare": "bun run gen-environments && bun run codegen && bun run check-coverage && bun run build"
   },
   "dependencies": {
-    "commander": "14.0.3",
     "valibot": "1.2.0"
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "0.96.0",
     "@types/node": "^25.3.3",
+    "tsdown": "^0.16.0",
     "tsx": "^4.19.2",
     "typescript": "5.9.3",
     "yaml": "2.6.1"
@@ -58,9 +56,10 @@
   "author": "Alvera",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvera-ai/platform-sdk.git"
+    "url": "git+https://github.com/alvera-ai/platform-sdk.git",
+    "directory": "packages/sdk"
   },
-  "homepage": "https://github.com/alvera-ai/platform-sdk#readme",
+  "homepage": "https://github.com/alvera-ai/platform-sdk/tree/main/packages/sdk#readme",
   "bugs": {
     "url": "https://github.com/alvera-ai/platform-sdk/issues"
   }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Alvera
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,320 +0,0 @@
-# @alvera-ai/platform-sdk
-
-Typed TypeScript SDK for the Alvera platform API.
-
-Manage the resources that live under a tenant — data sources, tools, generic
-tables, action status updaters, AI agents — with full type safety.
-
-## Install
-
-```bash
-npm install @alvera-ai/platform-sdk
-# or
-bun add @alvera-ai/platform-sdk
-# or
-pnpm add @alvera-ai/platform-sdk
-```
-
-## TypeScript configuration
-
-The SDK uses [`@hey-api/client-fetch`](https://heyapi.dev/openapi-ts/clients/fetch),
-whose generated code references WHATWG fetch types — `BodyInit`,
-`RequestInit`, `Headers`, `FormData`, etc. Those names live in
-`lib.dom.d.ts`, not `@types/node`, so a Node-only consumer with
-`"lib": ["ES2022"]` in its `tsconfig.json` will see errors like
-`Cannot find name 'BodyInit'` when typechecking.
-
-The fix is to add `DOM` and `DOM.Iterable` to your `lib`:
-
-```jsonc
-// tsconfig.json
-{
-  "compilerOptions": {
-    "lib": ["ES2022", "DOM", "DOM.Iterable"]
-    //               ^^^^^^^^^^^^^^^^^^^^^^^
-    // Required by @hey-api/client-fetch — see
-    //   https://github.com/hey-api/openapi-ts/issues/2539
-    // Provides type-only declarations for fetch globals.
-    // Adds NOTHING to the runtime — Node 18+ provides real fetch
-    // independently of these types.
-  }
-}
-```
-
-This is the workaround documented in hey-api's open issue
-[#2539](https://github.com/hey-api/openapi-ts/issues/2539); when
-the upstream fix lands and emits self-contained types, you can
-drop the `DOM` lib entries again.
-
-Browser consumers (React, Vue, Next, Nuxt, Remix) already have
-`DOM` and `DOM.Iterable` enabled by default — no change needed.
-
-## Quick start
-
-```ts
-import { createPlatformApi, createSession, ENVIRONMENTS } from '@alvera-ai/platform-sdk';
-
-const baseUrl = ENVIRONMENTS.prod.base_url; // or ENVIRONMENTS.local / ENVIRONMENTS.demo
-
-// 1. Exchange credentials for a session token
-const session = await createSession({
-  baseUrl,
-  email: process.env.ALVERA_EMAIL!,
-  password: process.env.ALVERA_PASSWORD!,
-  tenantSlug: 'acme',
-});
-
-// 2. Build the API client with that token
-const api = createPlatformApi({ baseUrl, sessionToken: session.sessionToken });
-
-// 3. Use it
-await api.ping();
-
-const { data: datalakes } = await api.datalakes.list('acme');
-
-const { data: ds } = await api.dataSources.create('acme', 'acme-health', {
-  name: 'Acme EMR',
-  uri: 'our-emr:acme',
-  description: 'Acme EMR system',
-  status: 'active',
-  is_default: true,
-});
-
-const { data: tool } = await api.tools.create('acme', {
-  name: 'Acme Manual Upload',
-  intent: 'data_exchange',
-  status: 'active',
-  datalake_id: datalakes[0].id,
-  data_source_id: ds.id,
-  body: { __type__: 'manual_upload' },
-});
-```
-
-## Authentication
-
-The SDK uses **session-based** auth.
-
-1. Call `createSession({ baseUrl, email, password, tenantSlug })` with your
-   Alvera login credentials and the tenant you want to operate on.
-2. The returned `sessionToken` is a Bearer token, valid for 24 hours by
-   default (override with `expiresIn`, max 30 days).
-3. Pass the token into `createPlatformApi({ baseUrl, sessionToken })`.
-4. When done, optionally call `revokeSession()` to invalidate the token.
-
-```ts
-import { createSession, createPlatformApi, revokeSession } from '@alvera-ai/platform-sdk';
-
-const session = await createSession({
-  baseUrl, email, password, tenantSlug: 'acme', expiresIn: 3600,
-});
-const api = createPlatformApi({ baseUrl, sessionToken: session.sessionToken });
-// ... use api ...
-await revokeSession();
-```
-
-`session.expiresAt` is an ISO-8601 timestamp — check it before long-running
-work and re-authenticate if needed.
-
-## Environments
-
-The base URLs ship with the package, derived at build time from the
-`servers[]` block of the committed OpenAPI spec (`spec/openapi.yaml`). The
-generated map is exported as `ENVIRONMENTS`:
-
-```ts
-import { ENVIRONMENTS, DEFAULT_ENVIRONMENT } from '@alvera-ai/platform-sdk';
-
-ENVIRONMENTS.local.base_url; // http://localhost:4000
-ENVIRONMENTS.demo.base_url;  // https://platform-hh.alvera.ai
-ENVIRONMENTS.prod.base_url;  // https://app.alvera.ai
-
-DEFAULT_ENVIRONMENT; // 'prod'
-```
-
-The CLI resolves a base URL with this precedence (highest first):
-
-1. `ALVERA_BASE_URL` env var (explicit URL override — useful for tunnels /
-   ephemeral servers)
-2. `base_url` pinned in the profile (written when the user passes a custom URL
-   to `alvera configure` or `alvera login --base-url …`)
-3. `ENVIRONMENTS[env].base_url` where `env` is the first of: `--env <name>`
-   flag, `ALVERA_ENV` env var, the profile's `environment` entry, or
-   `DEFAULT_ENVIRONMENT`
-
-Adding, renaming, or removing environments happens in the platform repo (the
-`servers/0` function in `lib/platform_api/api_spec.ex`); rerun
-`bun run regen` in the SDK to pick up the change.
-
-## Resources
-
-| Resource                     | Operations                                                                                                                                  |
-|------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------|
-| `ping`                       | health check                                                                                                                                |
-| `sessions`                   | `verify`                                                                                                                                    |
-| `auth`                       | `signUp`                                                                                                                                    |
-| `admin`                      | `confirmUser`                                                                                                                               |
-| `tenants`                    | `list`, `create`                                                                                                                            |
-| `invitations`                | `list`, `create`, `accept`                                                                                                                  |
-| `datasets`                   | `search`, `metadata`, `createUserSearch`                                                                                                    |
-| `datalakes`                  | `list`, `get`, `create`, `metadata`, `migrate`, `createUploadLink`, `createDownloadLink`                                                    |
-| `dataSources`                | `list`, `create`, `update`                                                                                                                  |
-| `tools`                      | `list`, `get`, `create`, `update`, `delete`, `testInvocation`                                                                               |
-| `genericTables`              | `list`, `create`                                                                                                                            |
-| `actionStatusUpdaters`       | `list`, `create`, `update`                                                                                                                  |
-| `aiAgents`                   | `list`, `get`, `create`, `update`, `delete`                                                                                                 |
-| `connectedApps`              | `list`, `get`, `create`, `update`, `syncRoutes`, `resolvePage`, `updateMessageTracking`                                                     |
-| `dataActivationClients`      | `list`, `get`, `create`, `update`, `delete`, `metadata`, `runManually`, `ingest`, `ingestFile`, `logs.list`, `logs.get`                     |
-| `interoperabilityContracts`  | `list`, `get`, `create`, `update`, `delete`, `metadata`, `run`                                                                              |
-| `mdm`                        | `verify`                                                                                                                                    |
-| `workflows`                  | `list`, `get`, `create`, `update`, `delete`, `metadata`, `execute`, `run`, `workflowLogs.list/get/download`, `batchLogs.list/get/start/stop/refresh` |
-
-Tenant and datalake provisioning are performed by Alvera admins — contact your
-representative to onboard a new tenant.
-
-## Error handling
-
-All methods throw on non-2xx responses (`throwOnError: true`). Wrap calls in
-`try/catch` and inspect the thrown error for status and response body.
-
-```ts
-try {
-  await api.tools.create('acme', payload);
-} catch (err) {
-  console.error('Tool creation failed:', err);
-}
-```
-
-## CLI
-
-The package ships a companion CLI (`alvera`) for ad-hoc calls against the
-platform API. Install the package (globally, or via `npx`) and authenticate
-once — subsequent commands reuse the stored session.
-
-```bash
-# Run without installing
-npx @alvera-ai/platform-sdk --help
-
-# Or install globally
-npm install -g @alvera-ai/platform-sdk
-alvera --help
-```
-
-### Configuration
-
-`alvera` stores state under `~/.alvera-ai/`, AWS CLI–style:
-
-| File                        | Purpose                                           |
-|-----------------------------|---------------------------------------------------|
-| `~/.alvera-ai/config`       | Per-profile defaults (base URL, tenant, email)    |
-| `~/.alvera-ai/credentials`  | Per-profile session token and expiration (0600)   |
-
-Both files are INI. The default profile is `[default]`; additional profiles
-live under `[profile <name>]` in `config` and `[<name>]` in `credentials`.
-
-Every command accepts `--profile <name>` and `--env <name>`. Environment
-variables (`ALVERA_PROFILE`, `ALVERA_ENV`, `ALVERA_BASE_URL`, `ALVERA_TENANT`,
-`ALVERA_EMAIL`, `ALVERA_PASSWORD`, `ALVERA_SESSION_TOKEN`) take precedence
-over file values.
-
-### Getting started
-
-```bash
-alvera env list                           # show local / demo / prod
-alvera configure                          # pick environment + default tenant
-alvera login --email me@acme.com --tenant acme
-alvera ping
-alvera datalakes list
-alvera tools create --body-file tool.json
-alvera logout
-```
-
-Per-command env switch (no profile edit):
-
-```bash
-alvera --env local ping
-ALVERA_ENV=demo alvera datalakes list
-```
-
-Pin an env into a profile:
-
-```bash
-alvera --profile staging env use demo
-alvera --profile staging datalakes list
-```
-
-Override the base URL for an ad-hoc host (tunnels, local branches):
-
-```bash
-ALVERA_BASE_URL=https://pr-123.preview.alvera.ai alvera ping
-```
-
-### Command surface
-
-```
-alvera configure
-alvera login   [--email] [--password] [--tenant] [--base-url] [--expires-in]
-alvera logout
-alvera whoami
-alvera ping
-alvera env                    list | use <name>
-
-alvera datalakes              list | get <id> | create
-alvera data-sources           list <datalake> | create <datalake> | update <datalake> <id>
-alvera tools                  list | get <id> | create | update <id> | delete <id>
-alvera generic-tables         list <datalake> | create <datalake>
-alvera action-status-updaters list | create | update <id>
-alvera ai-agents              list <datalake> | get <datalake> <id> | create <datalake>
-                              | update <datalake> <id> | delete <datalake> <id>
-alvera sessions-verify
-alvera datasets               search <dataset> [--datalake-id] [--page] [--page-size]
-alvera connected-apps         list <datalake> | get <datalake> <id> | create <datalake>
-                              | update <datalake> <id> | sync-routes <datalake> <id>
-                              | resolve-page <slug> | update-message-tracking <slug>
-alvera data-activation-clients  ingest <slug> | ingest-file <slug> <key>
-                                | upload-link <slug> <filename> [--content-type]
-alvera mdm                    verify <datalake>
-alvera workflows              execute <workflow-slug>
-```
-
-All `create` / `update` commands require `--body '<json>'` or `--body-file <path>`
-(use `-` for stdin). A tenant positional argument is optional when the profile
-has a default tenant configured. Output is pretty-printed JSON on stdout;
-status messages and prompts go to stderr so responses stay pipeable.
-
-## Regenerating the typed client
-
-The typed client is generated from `spec/openapi.yaml` using
-[`@hey-api/openapi-ts`](https://heyapi.dev/). The spec is produced by the
-platform repo and committed here, so this repo is fully self-contained at CI
-time.
-
-To pull a newer spec from the sibling platform repo:
-
-```bash
-# in the platform repo
-mix openapi.spec.yaml --spec PlatformApi.ApiSpec openapi.yaml
-git commit -am "feat(api): …"
-
-# in this repo
-cp ../platform/openapi.yaml spec/openapi.yaml
-bun run regen     # gen-environments + codegen + check-coverage
-git commit -am "chore: sync openapi spec"
-```
-
-`bun run regen` runs `gen-environments` (rebuilds
-`src/environments.generated.ts` from `servers[]`), then `codegen`, then
-`check-coverage`.
-
-## Releases
-
-This package uses
-[release-please](https://github.com/googleapis/release-please) plus
-[Conventional Commits](https://www.conventionalcommits.org/). Commits on
-`main` of the form `feat: …`, `fix: …`, `chore: …` feed into an automated
-"chore(main): release X.Y.Z" PR that bumps `package.json` and updates
-`CHANGELOG.md`. Merging that PR tags `vX.Y.Z`, which in turn triggers the
-existing npm publish workflow.
-
-## License
-
-MIT

package/src/cli/auth.ts

@@ -1,174 +0,0 @@
-import { Command } from 'commander';
-import { createSession, createUnvalidatedPlatformApi, revokeSession } from '../client.js';
-import {
-  CONFIG_PATHS,
-  ENVIRONMENTS,
-  clearProfileCreds,
-  getProfileName,
-  readProfileConfig,
-  resolveProfile,
-  writeProfileConfig,
-  writeProfileCreds,
-} from '../config.js';
-import { type GlobalOpts, authedApi, die, out, prompt, run } from './helpers.js';
-
-const ENVIRONMENT_NAMES = Object.keys(ENVIRONMENTS);
-
-export function register(program: Command): void {
-  program
-    .command('configure')
-    .description('Interactively set defaults (environment, tenant, email) for a profile')
-    .action(async () => {
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      const current = resolveProfile(profile);
-      const currentCfg = readProfileConfig(profile);
-
-      const options = ENVIRONMENT_NAMES.map(
-        (name) => `${name} (${ENVIRONMENTS[name as keyof typeof ENVIRONMENTS].base_url})`,
-      ).join(', ');
-      const defaultChoice = currentCfg.environment ?? current.environment;
-      const envInput =
-        (await prompt(`Environment [${defaultChoice}] — one of: ${options}, or a custom URL: `)) ||
-        defaultChoice;
-
-      const patch: { environment?: string; base_url?: string; tenant_slug?: string; email?: string } = {};
-      const unset: Array<'environment' | 'base_url'> = [];
-      if (ENVIRONMENT_NAMES.includes(envInput)) {
-        patch.environment = envInput;
-        unset.push('base_url');
-      } else if (/^https?:\/\//.test(envInput)) {
-        patch.base_url = envInput;
-        unset.push('environment');
-      } else {
-        die(
-          `"${envInput}" is not a known environment or a URL. ` +
-            `Valid: ${ENVIRONMENT_NAMES.join(', ')} or http(s)://…`,
-        );
-      }
-
-      patch.tenant_slug =
-        (await prompt(`Default tenant slug [${current.tenantSlug ?? ''}]: `)) || current.tenantSlug || '';
-      patch.email = (await prompt(`Email [${current.email ?? ''}]: `)) || current.email || '';
-      writeProfileConfig(profile, patch, unset);
-      process.stderr.write(`Saved profile "${profile}" → ${CONFIG_PATHS.config}\n`);
-    });
-
-  program
-    .command('login')
-    .description('Exchange credentials for a session token and store it')
-    .option('--email <email>')
-    .option('--password <password>')
-    .option('--tenant <slug>')
-    .option('--base-url <url>')
-    .option('--expires-in <seconds>', 'session duration (default 86400, max 2592000)')
-    .action(async (opts: Record<string, string>) => {
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      const current = resolveProfile(profile);
-      const baseUrl = opts.baseUrl ?? current.baseUrl;
-      const email = opts.email ?? current.email ?? (await prompt('Email: '));
-      const password = opts.password ?? process.env.ALVERA_PASSWORD ?? (await prompt('Password: ', { hidden: true }));
-      const tenant = opts.tenant ?? current.tenantSlug ?? (await prompt('Tenant slug: '));
-      if (!email || !password || !tenant) die('email, password, and tenant are required');
-
-      await run(async () => {
-        const session = await createSession({
-          baseUrl,
-          email,
-          password,
-          tenantSlug: tenant,
-          expiresIn: opts.expiresIn ? Number(opts.expiresIn) : undefined,
-        });
-        writeProfileConfig(profile, {
-          ...(opts.baseUrl ? { base_url: baseUrl } : {}),
-          tenant_slug: tenant,
-          email,
-        });
-        clearProfileCreds(profile);
-        writeProfileCreds(profile, {
-          session_token: session.sessionToken,
-          expires_at: session.expiresAt ?? '',
-        });
-        const tenantLabel = session.tenant ? `tenant "${session.tenant.slug}"` : 'no tenant';
-        process.stderr.write(
-          `Logged in as ${email} → ${tenantLabel} (profile "${profile}").\n` +
-            `Token stored in ${CONFIG_PATHS.credentials}\n` +
-            (session.expiresAt ? `Expires at ${session.expiresAt}\n` : ''),
-        );
-        return undefined;
-      });
-    });
-
-  program
-    .command('logout')
-    .description('Revoke the current session and clear stored credentials')
-    .action(async () => {
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      const resolved = resolveProfile(profile);
-      if (resolved.sessionToken) {
-        createUnvalidatedPlatformApi({ baseUrl: resolved.baseUrl, sessionToken: resolved.sessionToken });
-        try {
-          await revokeSession();
-        } catch {
-          // Token may already be invalid/expired — clear local state anyway.
-        }
-      }
-      clearProfileCreds(profile);
-      process.stderr.write(`Cleared credentials for profile "${profile}".\n`);
-    });
-
-  program
-    .command('whoami')
-    .description('Print the current profile configuration')
-    .action(() => {
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      const resolved = resolveProfile(profile);
-      out({
-        profile: resolved.profile,
-        environment: resolved.environment,
-        baseUrl: resolved.baseUrl,
-        tenantSlug: resolved.tenantSlug,
-        email: resolved.email,
-        hasSessionToken: Boolean(resolved.sessionToken),
-        expiresAt: resolved.expiresAt,
-        hasApiKey: Boolean(resolved.apiKey),
-      });
-    });
-
-  program
-    .command('set-api-key')
-    .description('Store an API key for the current profile (used instead of session token)')
-    .argument('[key]', 'API key (omit to read from prompt or ALVERA_API_KEY)')
-    .action(async (key?: string) => {
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      const apiKey = key ?? process.env.ALVERA_API_KEY ?? (await prompt('API key: ', { hidden: true }));
-      if (!apiKey) die('API key is required');
-      clearProfileCreds(profile);
-      writeProfileCreds(profile, { api_key: apiKey });
-      process.stderr.write(
-        `API key stored for profile "${profile}" → ${CONFIG_PATHS.credentials}\n` +
-          `(session token cleared)\n`,
-      );
-    });
-
-  program
-    .command('ping')
-    .description('Health check')
-    .action(async () => {
-      await run(async () => {
-        const { api } = authedApi(program.opts<GlobalOpts>());
-        const { data } = await api.ping();
-        return data;
-      });
-    });
-
-  program
-    .command('sessions-verify')
-    .description('Verify the current session token via the API')
-    .action(async () => {
-      await run(async () => {
-        const { api } = authedApi(program.opts<GlobalOpts>());
-        const { data } = await api.sessions.verify();
-        return data;
-      });
-    });
-}

package/src/cli/env.ts

@@ -1,49 +0,0 @@
-import { Command } from 'commander';
-import {
-  DEFAULT_ENVIRONMENT,
-  ENVIRONMENTS,
-  getProfileName,
-  resolveProfile,
-  writeProfileConfig,
-} from '../config.js';
-import { type GlobalOpts, die, out } from './helpers.js';
-
-const ENVIRONMENT_NAMES = Object.keys(ENVIRONMENTS);
-
-export function register(program: Command): void {
-  const envCmd = program
-    .command('env')
-    .description('List and switch Alvera API environments');
-
-  envCmd
-    .command('list')
-    .description('List available environments (from spec/openapi.yaml)')
-    .action(() => {
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      const resolved = resolveProfile(profile);
-      out(
-        ENVIRONMENT_NAMES.map((name) => ({
-          name,
-          baseUrl: ENVIRONMENTS[name as keyof typeof ENVIRONMENTS].base_url,
-          description: ENVIRONMENTS[name as keyof typeof ENVIRONMENTS].description,
-          default: name === DEFAULT_ENVIRONMENT,
-          active: name === resolved.environment,
-        })),
-      );
-    });
-
-  envCmd
-    .command('use <name>')
-    .description('Persist the selected environment to the profile (clears any custom base_url)')
-    .action((name: string) => {
-      if (!ENVIRONMENT_NAMES.includes(name)) {
-        die(`unknown environment "${name}". Valid: ${ENVIRONMENT_NAMES.join(', ')}`);
-      }
-      const profile = getProfileName(program.opts<GlobalOpts>().profile);
-      writeProfileConfig(profile, { environment: name }, ['base_url']);
-      process.stderr.write(
-        `Profile "${profile}" now uses environment "${name}" ` +
-          `(${ENVIRONMENTS[name as keyof typeof ENVIRONMENTS].base_url}).\n`,
-      );
-    });
-}