@margay/ccl-core 1.5.1-alpha.3 → 1.5.1-alpha.5

package/QUICKSTART.md

@@ -53,7 +53,7 @@ Inside the interactive CLI, `/gateway login` or `/gateway register` without
 arguments opens the same website flow. `/gateway status` shows the saved
 account's verified membership and balance. `/gateway logout` signs out locally.
 The first-launch account step supports Enter to sign in and S/Esc to set up
-later; Esc cancels an in-progress TUI login. `/login` remains Claude OAuth.
+later; Esc cancels an in-progress TUI login. `/login` opens the same Margay website flow.
 
 Website credentials use the system credential store; `gateway.json` contains
 an account reference and metadata. Store access failure stops login without
@@ -84,20 +84,22 @@ explicit environment override. See the
 [account and gateway guide](./docs/gateway-quickstart.md) for defaults,
 status meanings, storage prerequisites, and troubleshooting.
 
-### Claude OAuth
+### Interactive account login
 
 ```text
 margay
 /login
 ```
 
-The first interactive launch can also guide you through OAuth login.
+This signs in to your Margay website account. First-launch account setup uses
+the same flow. `/login` does not obtain external-service credentials; existing credentials
+may still be used by compatible channels, but are not created by this command.
 
-### Anthropic API Key
+### Messages API Key
 
 ```bash
 export ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY>
-margay --model sonnet
+margay --model "<available-model-id>"
 ```
 
 Do not paste real keys into docs, shell history examples, bug reports, or shared
@@ -154,7 +156,7 @@ Run slash commands inside the interactive TUI.
 
 ```bash
 margay --help
-margay -p "task" --model sonnet --effort high
+margay -p "task" --model "<available-model-id>" --effort high
 margay -p "task" --allowedTools "Bash(git:*) Edit"
 margay -p "task" --disallowedTools "Bash(rm:*)"
 margay --bare -p "minimal startup task"
@@ -221,7 +223,7 @@ headless mode, `needs_user` means user intervention is needed before continuing.
 | Symptom | Fix |
 |---|---|
 | Gateway login worked but a new shell uses the old gateway | Check and clear or update all four exported Gateway fields |
-| No credentials found | Margay: `/gateway login`; Claude: `/login` or `ANTHROPIC_API_KEY` |
+| No credentials found | Margay: `/login` or `/gateway login`; direct Messages API: `ANTHROPIC_API_KEY` |
 | Persistent network, authentication, or account-credit failure | Follow the reported `blocked_external` reason; restore access or credit, then continue after checking prior tool results |
 | Output budget lower than configured | The observed gateway/model ceiling clamps output tokens; this is separate from account credit |
 | Model unavailable | Use `/model` to inspect configured options or check the gateway model list |

package/README.md

@@ -2,7 +2,7 @@
 
 CCL is the `@margay/ccl-core` command-line agent runtime. It starts an
 interactive coding assistant by default, supports non-interactive scripting with
-`--print`, and can run either direct Claude channels or Margay gateway routed
+`--print`, and can run either direct API channels or Margay gateway routed
 models from the same CLI surface.
 
 The package version is recorded in `package.json`. Check the installed runtime
@@ -21,8 +21,8 @@ The analytics commands support opt-in event upload, funnel/retention/path/experi
 - Node.js 20 or newer.
 - At least one authentication path:
   - Margay website account or gateway token for gateway-routed models.
-  - Claude OAuth for subscription-backed Claude use.
-  - Anthropic API key for direct API-key Claude use.
+  - Existing external-service OAuth credentials for compatible subscription-backed channels; `/login` signs in to Margay.
+  - API key for a compatible Messages API service.
 
 ## Install
 
@@ -69,10 +69,10 @@ configuration.
 
 | Channel | Use For | Setup |
 |---|---|---|
-| Margay website account (current checkout) | Shared Margay identity and gateway-routed models | Build this checkout, then `node dist/cli.js login`, or use `/gateway login` in the TUI |
+| Margay website account | Shared Margay identity and gateway-routed models | `margay login`, or `/login` / `/gateway login` in the TUI |
 | Manual Margay gateway | Existing gateway tokens or invite codes | `/gateway login <url> <token>` or `/gateway register <url> <invite>` |
-| Claude OAuth | Claude subscription sessions | Run `margay` and follow the login prompt, or use `/login` |
-| Anthropic API key | Direct Anthropic API use | Set `ANTHROPIC_API_KEY=<key>` or pass `--api-key <key>` |
+| Existing external-service OAuth credentials | Compatible external-service channels | Legacy credential compatibility; `/login` and first-launch onboarding use Margay website authorization |
+| Messages API key | Direct API use | Set `ANTHROPIC_API_KEY=<key>` or pass `--api-key <key>` |
 
 The website-account implementation is available in this source checkout; real
 website authorization and commercial readiness remain unverified. No published
@@ -108,8 +108,8 @@ Run these inside an interactive CCL session:
 ```
 
 With no arguments, `login` and `register` open website authorization. With a
-URL/token or URL/invite, they use the existing manual flow. `/login` remains
-Claude OAuth. Website sign-out removes the local account; it does not revoke
+URL/token or URL/invite, they use the existing manual flow. `/login` opens
+the same Margay website authorization flow. Website sign-out removes the local account; it does not revoke
 the website session or cancel a subscription. Explicit environment overrides
 remain effective until removed from the launching shell.
 
@@ -226,9 +226,9 @@ Copies isolate normal test output, not hostile same-user shell commands. See
 
 ## Models And Routing
 
-CCL accepts model aliases such as `sonnet` or `opus` and gateway model names such
-as `deepseek-v4-pro` or `kimi-for-coding`. The actual available gateway models
-are determined by the connected gateway.
+Use `/model` to inspect the models available in your current configuration.
+Choose a model ID from that list for an explicit `--model` invocation. The
+connected gateway determines its available model catalog.
 
 Useful controls:
 
@@ -242,8 +242,8 @@ Useful controls:
 For one-off runs:
 
 ```bash
-margay -p "summarize this diff" --model sonnet
-margay -p "generate a migration plan" --model deepseek-v4-pro --effort high
+margay -p "summarize this diff" --model "<available-model-id>"
+margay -p "generate a migration plan" --model "<available-model-id>" --effort high
 ```
 
 Capability pools use explicit `cost-first ranking` and `quality-first ranking`
@@ -253,7 +253,7 @@ Qwen 3.8 Flash → Grok 4.5 → K3 / Moonshot Platform. DeepSeek Vision remains
 experimental. The hidden K3 visual route is reported as canonical model
 `kimi-platform/kimi-k3`.
 
-Anthropic Messages remains the transport for the main Agent, planning, editing,
+The Messages API remains the transport for the main Agent, planning, editing,
 tool calling, Advisor, Critic, and general subagent loops. Native OpenAI Chat
 Completions support is deliberately bounded to zero-tool, one-shot visual
 analysis and context compaction. These consumers select and pin one configured
@@ -335,7 +335,7 @@ and the SDK distinction between recovery outcomes and pending tool approvals.
 |---|---|
 | `CCL_GATEWAY_URL`, `CCL_GATEWAY_KEY` | Margay gateway URL and credential; prefer `/gateway login` over manual export |
 | `CCL_GATEWAY_CREDENTIAL_TYPE`, `CCL_GATEWAY_ISSUER` | Credential admission metadata; required as an atomic pair for opaque environment credentials |
-| `ANTHROPIC_API_KEY`, `ANTHROPIC_BASE_URL` | Direct Anthropic API-key channel |
+| `ANTHROPIC_API_KEY`, `ANTHROPIC_BASE_URL` | Direct Messages API channel |
 | `CCL_MAX_OUTPUT_TOKENS` | Output budget; takes precedence over `CLAUDE_CODE_MAX_OUTPUT_TOKENS` and remains subject to model/gateway limits |
 | `CCL_MODEL` | Default model |
 | `CCL_ROUTING_PRIORITY` | Default routing preference, usually `cost` or `quality` |