@margay/ccl-core 1.3.5-rc.8 → 1.3.6-alpha.2

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.
Files changed (10) hide show
  1. package/README.md +14 -7
  2. package/dist/cli.js +4077 -2792
  3. package/dist/sdk/errorDiagnostics.d.ts +14 -0
  4. package/dist/sdk/errorDiagnostics.js +86 -0
  5. package/dist/sdk/interactionResponseSchema.d.ts +16 -0
  6. package/dist/sdk/interactionResponseSchema.js +13 -0
  7. package/dist/sdk/query.d.ts +2 -0
  8. package/dist/sdk/query.js +30 -8
  9. package/dist/sdk/types.d.ts +6 -0
  10. package/package.json +2 -2
package/README.md CHANGED
@@ -63,12 +63,18 @@ configuration.
63
63
  | Claude OAuth | Claude subscription sessions | Run `ccl` and follow the login prompt, or use `/login` |
64
64
  | Anthropic API key | Direct Anthropic API use | Set `ANTHROPIC_API_KEY=<key>` or pass `--api-key <key>` |
65
65
 
66
- Gateway configuration is saved to `~/.ccl/gateway.json` and synchronized into a
67
- managed shell rc block by `/gateway login` and `/gateway register`. If a parent
68
- terminal already exported `CCL_GATEWAY_URL` or `CCL_GATEWAY_KEY`, that terminal's
69
- environment still wins for newly launched child processes. Use `/gateway doctor`
70
- to detect mismatches, then open a new terminal, reload the shell rc file, or
71
- unset the old variables.
66
+ Gateway configuration is saved to `~/.ccl/gateway.json`. CCL records the
67
+ credential type and binds it to the normalized Gateway URL. `/gateway register`
68
+ accepts only the returned Gateway JWT and verifies it with the same Gateway's
69
+ `/auth/me`; `/gateway login` verifies a Gateway-owned credential before saving
70
+ it. Do not paste an upstream model-provider API key into either command or into
71
+ `CCL_GATEWAY_KEY`.
72
+
73
+ If a parent terminal explicitly exports a Gateway configuration, use all four
74
+ variables as one atomic set: `CCL_GATEWAY_URL`, `CCL_GATEWAY_KEY`,
75
+ `CCL_GATEWAY_CREDENTIAL_TYPE`, and `CCL_GATEWAY_ISSUER`. Prefer the slash
76
+ commands so CCL creates this metadata safely. `/gateway doctor` reports and
77
+ quarantines untyped opaque or issuer-mismatched credentials before any request.
72
78
 
73
79
  ## Gateway Commands
74
80
 
@@ -246,7 +252,8 @@ SDK references:
246
252
 
247
253
  | Variable | Purpose |
248
254
  |---|---|
249
- | `CCL_GATEWAY_URL`, `CCL_GATEWAY_KEY` | Margay gateway URL and token |
255
+ | `CCL_GATEWAY_URL`, `CCL_GATEWAY_KEY` | Margay gateway URL and credential; prefer `/gateway login` over manual export |
256
+ | `CCL_GATEWAY_CREDENTIAL_TYPE`, `CCL_GATEWAY_ISSUER` | Credential admission metadata; required as an atomic pair for opaque environment credentials |
250
257
  | `ANTHROPIC_API_KEY`, `ANTHROPIC_BASE_URL` | Direct Anthropic API-key channel |
251
258
  | `CCL_MODEL` | Default model |
252
259
  | `CCL_ROUTING_PRIORITY` | Default routing preference, usually `cost` or `quality` |