@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 +17 -20
- package/dist/gateway-commands.js +13 -4
- package/package.json +2 -2
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.
|
|
19
|
+
**Coordinated package version:** `0.5.0`
|
|
20
20
|
|
|
21
21
|
### SDK
|
|
22
22
|
|
|
23
|
-
- Added
|
|
24
|
-
- Added
|
|
25
|
-
- Added
|
|
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
|
|
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
|
|
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
|
-
-
|
|
46
|
-
-
|
|
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>] [--
|
|
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]
|
package/dist/gateway-commands.js
CHANGED
|
@@ -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 =
|
|
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.
|
|
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.
|
|
42
|
+
"@airctrl/sdk": "0.5.0"
|
|
43
43
|
}
|
|
44
44
|
}
|