@airctrl/cli 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -16,36 +16,26 @@ Requires Node.js 22.x.
16
16
 
17
17
  ## Current release
18
18
 
19
- **Coordinated package version:** `0.4.0`
19
+ **Coordinated package version:** `0.5.0`
20
20
 
21
21
  ### SDK
22
22
 
23
- - Added `OAuthPartnerClient`, PKCE generation, authorization-code exchange, rotating refresh tokens, and token revocation for confidential partner backends.
24
- - Added provider resolution, provider-key validation, live model discovery, entitlement preflight, atomic protection provisioning, and installation-bound protection reads and updates.
25
- - Added provider-key rotation, runtime-token rotation, revoke, and reactivate lifecycle operations with typed idempotency and error handling.
26
- - Added public multi-organization OAuth Apps: one publisher-owned Client ID can create isolated installations inside customer-selected AIRCTRL organizations.
27
- - Added `listProtectionLogs()` and `getProtectionSpend()` with dedicated least-privilege scopes and strict installation/protection binding.
28
- - Added stable cursor pagination and canonical account, project, gateway, token, principal, trace, and span correlation across request-log, usage, and audit feeds.
29
- - Added OpenTelemetry body-export controls and shared gateway connection types aligned with the public API contract.
23
+ - Added privileged full-text gateway log search, HTTP status-family filtering, and gateway-scoped usage metrics and spend inputs.
24
+ - Added native connection URLs for Groq, Novita AI, Atlas Cloud, and xAI to the shared gateway connection builder.
25
+ - Added pricing display text and structured rate-card tiers so provider-published zero and context-tiered rates remain explicit.
30
26
 
31
27
  ### CLI
32
28
 
33
- - Added opaque cursor support to gateway logs, provider-key access, usage logs, record alerts, and record access commands.
34
- - Added the `audit-events` command with cursor, action, actor, and date filters.
35
- - Added OpenTelemetry request/response body-export configuration while preserving the existing header-custody contract.
29
+ - Added gateway log `--search` and `--status-class` filters plus gateway-scoped usage metrics and spend flags.
36
30
 
37
31
  ### MCP
38
32
 
39
- - Added opaque cursor inputs to gateway, usage, record-alert, and record-access tools.
40
- - Added `list_record_audit` with stable filters and pagination.
41
- - Added OpenTelemetry body-export configuration and aligned pagination limits with the API contract.
33
+ - Added the same gateway log search and scoped metrics inputs to `read_usage`, `read_usage_metrics`, and `read_usage_spend`.
42
34
 
43
35
  ### Release engineering
44
36
 
45
- - Kept SDK, CLI, and MCP manifests, internal dependencies, exported version constants, generated READMEs, and tarball names aligned at `0.4.0`.
46
- - Build `@airctrl/client-contracts` before OpenAPI generation and full-stack certification so clean release runners never depend on cached workspace output.
47
- - Expanded package verification across the public API, generated examples, installed-package behavior, exact tarballs, and Linux, Windows, and macOS certification.
48
- - Kept `@airctrl/crypto` and `@airctrl/secrets` private and bundled the required runtime into the public SDK.
37
+ - Coordinated SDK, CLI, MCP, Web, and Authenticator package references at `0.5.0` so clean builds consume the exact release candidate instead of the previously published SDK.
38
+ - Retained sealed-candidate certification and manual npm publication with final approval and 2FA.
49
39
 
50
40
  ## CLI overview
51
41
 
@@ -292,11 +282,16 @@ airctrl gateway provider-credential-update <credentialId> --account <id> --label
292
282
  airctrl gateway provider-credential-revoke <credentialId> --account <id>
293
283
  ```
294
284
 
285
+ `gateway provider-models` includes current official pricing for each discovered model. Numeric token
286
+ rates use USD per one million tokens; `displayText` and `rateCard` preserve provider-published zero
287
+ and context-tiered policies.
288
+
295
289
  Observability:
296
290
 
297
291
  ```text
298
292
  airctrl gateway logs <gatewayId> [--since <iso>] [--provider <id>] [--model <name>]
299
- [--status <code>] [--cursor <opaque>] [--limit <n>] [--offset <legacy-n>]
293
+ [--status <code>] [--status-class 2xx|4xx|5xx|other] [--search <keywords>]
294
+ [--cursor <opaque>] [--limit <n>] [--offset <legacy-n>]
300
295
  airctrl gateway log <gatewayId> <logId>
301
296
  airctrl gateway key-access <gatewayId> [--outcome granted|denied|error]
302
297
  [--since <iso>] [--cursor <opaque>] [--limit <n>] [--offset <legacy-n>]
@@ -304,8 +299,10 @@ airctrl gateway usage-logs --project <id> [--since <iso>] [--provider <id>]
304
299
  [--model <name>] [--status <code>] [--gateway <id>] [--cursor <opaque>]
305
300
  [--limit <n>] [--offset <legacy-n>]
306
301
  airctrl gateway usage-log <logId> --project <id>
307
- airctrl gateway usage-spend --project <id>
302
+ airctrl gateway usage-spend --project <id> [--gateway <id>]
308
303
  airctrl gateway usage-metrics --project <id> [--since <iso>] [--bucket hour|day]
304
+ [--gateway <id>] [--provider <slug>] [--model <name>]
305
+ [--status-class 2xx|4xx|5xx|other] [--search <keywords>]
309
306
  airctrl gateway otel <gatewayId> --account <id>
310
307
  airctrl gateway otel-update <gatewayId> --account <id>
311
308
  [--enabled true|false] [--endpoint <url|null>] [--metrics true|false]
@@ -81,7 +81,7 @@ export const GATEWAY_SPECS = {
81
81
  },
82
82
  logs: {
83
83
  positionals: ['gatewayId'],
84
- flags: ['since', 'provider', 'model', 'status', 'cursor', 'limit', 'offset', ...profile],
84
+ flags: ['since', 'provider', 'model', 'status', 'status-class', 'search', 'cursor', 'limit', 'offset', ...profile],
85
85
  },
86
86
  log: { positionals: ['gatewayId', 'logId'], flags: profile },
87
87
  'key-access': {
@@ -100,12 +100,12 @@ export const GATEWAY_SPECS = {
100
100
  },
101
101
  'usage-spend': {
102
102
  positionals: [],
103
- flags: ['project', ...profile],
103
+ flags: ['project', 'gateway', ...profile],
104
104
  requiredFlags: ['project'],
105
105
  },
106
106
  'usage-metrics': {
107
107
  positionals: [],
108
- flags: ['project', 'since', 'bucket', ...profile],
108
+ flags: ['project', 'since', 'bucket', 'gateway', 'provider', 'model', 'status-class', 'search', ...profile],
109
109
  requiredFlags: ['project'],
110
110
  },
111
111
  otel: {
@@ -389,6 +389,8 @@ export async function runGatewayCommand(argv, deps) {
389
389
  provider: parsed.flags.provider,
390
390
  model: parsed.flags.model,
391
391
  status: numberFlag(parsed.flags.status, true, 100, 599),
392
+ statusClass: enumFlag(parsed.flags['status-class'], ['2xx', '4xx', '5xx', 'other']),
393
+ search: parsed.flags.search,
392
394
  cursor: parsed.flags.cursor,
393
395
  limit: numberFlag(parsed.flags.limit, true, 1, 200),
394
396
  offset: numberFlag(parsed.flags.offset, true),
@@ -423,12 +425,19 @@ export async function runGatewayCommand(argv, deps) {
423
425
  result = await client.getUsageLogDetail(parsed.flags.project, id);
424
426
  break;
425
427
  case 'usage-spend':
426
- result = await client.getUsageSpend(parsed.flags.project);
428
+ result = parsed.flags.gateway
429
+ ? await client.getUsageSpend(parsed.flags.project, parsed.flags.gateway)
430
+ : await client.getUsageSpend(parsed.flags.project);
427
431
  break;
428
432
  case 'usage-metrics':
429
433
  result = await client.getUsageMetrics(parsed.flags.project, {
430
434
  since: parsed.flags.since,
431
435
  bucket: enumFlag(parsed.flags.bucket, ['hour', 'day']),
436
+ gatewayId: parsed.flags.gateway,
437
+ provider: parsed.flags.provider,
438
+ model: parsed.flags.model,
439
+ statusClass: enumFlag(parsed.flags['status-class'], ['2xx', '4xx', '5xx', 'other']),
440
+ search: parsed.flags.search,
432
441
  });
433
442
  break;
434
443
  case 'otel':
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@airctrl/cli",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "type": "module",
5
5
  "description": "AIRCTRL CLI for encrypted records, process injection, projects, gateways and Service Accounts.",
6
6
  "license": "UNLICENSED",
@@ -39,6 +39,6 @@
39
39
  "dev": "tsx src/index.ts"
40
40
  },
41
41
  "dependencies": {
42
- "@airctrl/sdk": "0.4.0"
42
+ "@airctrl/sdk": "0.5.0"
43
43
  }
44
44
  }