@inference/cli 0.0.20 → 0.0.21-beta.522

package/README.md

@@ -63,6 +63,7 @@ inf dashboard
 inf auth login          # Sign in via browser (device authorization flow)
 inf auth logout         # Sign out and clear stored credentials
 inf auth status         # Show current authentication status
+inf auth whoami         # Show which user and team the CLI is currently authenticated as
 inf auth set-key <key>  # Set an API key for CI/headless use
 ```
 
@@ -74,6 +75,35 @@ inf project switch <id> # Set the active project
 inf project current     # Show the currently active project
 ```
 
+### Team Management
+
+A **team** is 1:1 with an organization on Inference.net. Commands that talk to the API scope to a team via a request header, so switching teams is a local, instant operation — no re-authentication required.
+
+```bash
+inf team list                              # List teams you belong to (marks the active one)
+inf team current                           # Show the currently active team
+inf team switch <id-or-slug>               # Set the active team (ID, slug, or name)
+inf team create <name>                     # Create a team (and default project); both become active
+inf team invite <email>                    # Invite a member to the active team
+inf team invite <email> --role admin       # Invite as admin (default role: member)
+```
+
+Team management commands (`list`, `current`, `switch`, `create`, `invite`) require session auth via `inf auth login`, not an API key. `inf team switch <id-or-slug>` is the one place slugs/names get resolved (it fetches your team list first) — the global `-t, --team <id>` flag and `INF_TEAM_ID` only accept a real team ID, since they skip that lookup for speed.
+
+### API Key Management
+
+```bash
+inf api-key create <name> --project <id>                 # Create a project-scoped key (defaults: active project, read+write)
+inf api-key create <name> --project <id> --permissions read  # Read-only key
+inf api-key create <name> --project <id> --team <id>     # Create under a specific team
+inf api-key list                                         # List keys for the active team
+inf api-key list --team <id>                             # List keys for a specific team
+inf api-key revoke <id>                                  # Revoke a key
+inf api-key revoke <id> --team <id>                      # Revoke under a specific team
+```
+
+The raw key value is shown only once, at creation — save it immediately.
+
 ### Instrument (Automated Observability Setup)
 
 ```bash
@@ -119,10 +149,31 @@ inf dataset download <id>      # Download a dataset (-o output path)
 ### Inferences
 
 ```bash
-inf inference list             # List recent inferences
-inf inference get <id>         # Get full inference details
+inf inference list             # List and filter inferences
+inf inference facets           # Probe valid filter values + full filter reference
+inf inference get <id>         # Get the full stored request + response (method, path, headers, bodies)
+
+# Search / sort (no need to hardcode filter values — discover them with `facets`):
+inf inference list --sort input_tokens --order desc --limit 50  # largest prompts first
+inf inference list --filter inputTokens>39000                   # numeric filter
+inf inference list --model my-model --status 200 --range 7d     # array + time filters
+inf inference list --metadata user_id=abc123                    # metadata filter
+
+# Paginate from a script — JSON output includes nextCursor:
+cursor=$(inf --json inference list --sort input_tokens --order desc | jq -r '.nextCursor')
+inf --json inference list --sort input_tokens --order desc --cursor "$cursor"
+
+# Fetch the complete bodies for scripting / archiving:
+inf --json inference get <id>                      # Full payload as clean JSON (pipe to jq)
+inf --json inference get <id> | jq '.response.body' # Just the response body
+inf inference get <id> --response --body           # Raw response body (no decoration)
+inf inference get <id> --request --body -o req.json # Dump the raw request body to a file
+inf --json inference get <id> -o dump.json         # Save the full {request,response} payload
 ```
 
+The full bodies are returned only when payload storage was enabled for the
+request — otherwise `request`/`response` come back `null`.
+
 ### Traces
 
 ```bash
@@ -168,13 +219,14 @@ The dashboard provides a tabbed interface for browsing training runs, evals, dat
 
 ## Global Options
 
-| Flag                 | Description                                   |
-| -------------------- | --------------------------------------------- |
-| `--json`             | Output results as JSON (useful for scripting) |
-| `-v, --verbose`      | Enable verbose debug output                   |
-| `-p, --project <id>` | Override the active project for this command  |
-| `--version`          | Show the CLI version                          |
-| `--help`             | Show help                                     |
+| Flag                        | Description                                                |
+| --------------------------- | ---------------------------------------------------------- |
+| `--json`                    | Output results as JSON (useful for scripting)              |
+| `-v, --verbose`             | Enable verbose debug output                                |
+| `-p, --project <id>`        | Override the active project for this command               |
+| `-t, --team <id>`           | Override the active team for this command (team ID)        |
+| `--version`                 | Show the CLI version                                       |
+| `--help`                    | Show help                                                  |
 
 ## Configuration
 
@@ -191,6 +243,8 @@ Stored at `~/.inf/config.json`. Managed automatically by `inf auth` commands.
 | `INF_UI_URL`     | Web app URL (for device auth)                                         | Derived from API URL                      |
 | `INF_API_KEY`    | Scoped platform key for headless/CI auth                              |                                           |
 | `INF_PROJECT_ID` | Override the selected project when a key can access multiple projects |                                           |
+| `INF_TEAM_ID`    | Override the active team (team ID; use `inf team switch <id-or-slug>` to resolve a slug/name once) |             |
+| `INF_CONFIG_DIR` | Override where `~/.inf/config.json` is stored (primarily for test isolation) | `~/.inf`                           |
 
 ### Priority Order
 
@@ -268,6 +322,24 @@ The workflow can also repair a partial stable release. If `@inference/cli` alrea
 
 ### Releasing A New Version
 
+#### Option A — Auto-bump from CI (recommended)
+
+Trigger the workflow manually and let CI bump the version for you:
+
+1. Run `workflow_dispatch` on the branch you want to release from
+   (`development` for beta, `main` for stable).
+2. Set `semver_action` to `patch`, `minor`, or `major`.
+3. The `bump-version` job runs `npx semver -i`, then
+   `scripts/sync-versions.ts` so the main package and all four platform
+   manifests move together, commits the result, and pushes a
+   `release-inf-cli-<version>-<sha>` tag back to the dispatched branch.
+4. The same run then builds and publishes the bumped version.
+
+Leave `semver_action=none` (the default) to publish the already-committed
+version without bumping.
+
+#### Option B — Bump manually
+
 1. Choose the next stable version.
 2. Sync all committed CLI manifests to that version.
 
@@ -283,8 +355,9 @@ bun scripts/sync-versions.ts 0.0.9
 
 ### Manual Runs
 
+- `workflow_dispatch` takes a `semver_action` input (`none`/`patch`/`minor`/`major`); anything other than `none` bumps, commits, and tags the new version on the dispatched branch before publishing
 - `workflow_dispatch` with `dry_run=false` always attempts a publish on `development` or `main`
-- Set `dry_run=true` to validate the full build and packaging path without publishing to npm
+- Set `dry_run=true` to validate the full build and packaging path without publishing to npm; a dry run computes and builds the bumped version but does not push the bump commit or tag, so it stays side-effect-free
 - Pushes to `development` always publish a fresh beta release when this workflow is triggered
 - Set `dry_run=false` only on `development` or `main`
 - Manual runs from other branches are rejected by the workflow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inference/cli",
-  "version": "0.0.20",
+  "version": "0.0.21-beta.522",
   "description": "Inference.net CLI - manage training runs, evals, datasets, and inferences from your terminal",
   "type": "module",
   "license": "MIT",
@@ -26,10 +26,10 @@
     "ai"
   ],
   "optionalDependencies": {
-    "@inference/cli-darwin-arm64": "0.0.20",
-    "@inference/cli-darwin-x64": "0.0.20",
-    "@inference/cli-linux-x64": "0.0.20",
-    "@inference/cli-linux-arm64": "0.0.20"
+    "@inference/cli-darwin-arm64": "0.0.21-beta.522",
+    "@inference/cli-darwin-x64": "0.0.21-beta.522",
+    "@inference/cli-linux-x64": "0.0.21-beta.522",
+    "@inference/cli-linux-arm64": "0.0.21-beta.522"
   },
   "scripts": {
     "build": "bun run clean:bin && bun run build:cli",
@@ -45,13 +45,16 @@
     "clean:bin": "rm -rf bin/inf",
     "clean:npm": "rm -f npm/cli-darwin-arm64/bin/inf npm/cli-darwin-x64/bin/inf npm/cli-linux-x64/bin/inf npm/cli-linux-arm64/bin/inf",
     "dev": "bun src/index.ts",
-    "format": "prettier --check .",
-    "format:fix": "prettier --write .",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt --write .",
+    "lint": "ROOT=\"$(git rev-parse --show-toplevel)/inference\" && \"$ROOT/node_modules/.bin/oxlint\" --type-aware",
+    "lint:fix": "ROOT=\"$(git rev-parse --show-toplevel)/inference\" && \"$ROOT/node_modules/.bin/oxlint\" --type-aware --fix",
     "tsc": "tsc --build",
     "test": "bun run test:unit",
-    "test:unit": "bun test $(find ./tests/unit -name '*.test.ts' ! -name '*.vitest.test.ts') && bun run test:vitest",
+    "test:unit": "vitest run --config vitest.unit.config.mts",
     "test:vitest": "vitest run --config vitest.unit.config.mts"
+  },
+  "dependencies": {
+    "react": "19.2.7"
   }
 }