theclawbay 0.3.8 → 0.3.10

package/README.md

@@ -1,15 +1,6 @@
-# The Claw Bay (`theclawbay`)
+# theclawbay
 
-`theclawbay` is a customer CLI for The Claw Bay.
-
-This package no longer runs local account login automation or local account switching flows.
-
-> Not affiliated with OpenAI or Codex. Not an official tool.
-
-## Requirements
-
-- Node.js 18+
-- Codex CLI (`@openai/codex`) and/or OpenClaw CLI
+CLI for connecting Codex, OpenClaw, and OpenCode to The Claw Bay.
 
 ## Install
 
@@ -17,75 +8,20 @@ This package no longer runs local account login automation or local account swit
 npm i -g theclawbay
 ```
 
-If you use `nvm`, keep a single global prefix to avoid duplicate binaries:
-
-```sh
-npm config delete prefix
-```
-
-## One-Time Setup (Recommended)
+## Setup
 
-Use your purchased API key from your dashboard:
+Get your API key from `https://theclawbay.com/dashboard`.
 
 ```sh
 theclawbay setup --api-key <apiKey>
 ```
 
-This auto-detects installed clients and writes direct WAN API-key config so users can run directly.
-It configures Codex with `model_provider = "theclawbay"` and a managed bearer token, auto-selects the highest backend-advertised model, and preserves conversation visibility by neutralizing legacy local session provider tags so chats remain visible across provider modes.
-
-It also configures OpenClaw/OpenCode automatically when those CLIs are installed.
-OpenClaw/OpenCode provider configs are written with a literal API key (no env var dependency).
-If OpenClaw has a stale `${CODEX_LB_API_KEY}` placeholder from an older setup, `theclawbay setup` now auto-heals `~/.openclaw/openclaw.json`.
-
-`CODEX_LB_API_KEY` is persisted for restarts in:
-
-- `~/.config/theclawbay/env`
-- `~/.bashrc`
-- `~/.zshrc`
-- `~/.profile`
-- `~/.vscode-server/server-env-setup` (and `~/.vscode-server-insiders/server-env-setup` when present)
-
-If you operate a custom backend, pass it explicitly:
-
-```sh
-theclawbay setup --api-key <apiKey> --backend https://your-domain.com
-```
-
-After setup, restart terminal/VS Code once only if your own shell workflows depend on `CODEX_LB_API_KEY`.
+## Optional
 
-## Codex Extension Behavior
+`theclawbay link --api-key <apiKey>`
 
-- In API-key provider mode, Codex may label the model source as `Custom`.
-- Full ChatGPT account model-picker behavior is tied to ChatGPT auth mode.
-- `theclawbay setup` keeps your existing Codex login state unchanged on purpose (so local history context is preserved and setup stays non-destructive).
-
-## Link Only (Optional)
-
-If you only want to save backend/API-key state without applying local client config yet:
-
-```sh
-theclawbay link --api-key <apiKey>
-```
-
-## Logout
-
-To remove local The Claw Bay API-key auth state from this machine:
-
-```sh
-theclawbay logout
-```
-
-## Release Notes (Maintainers)
-
-If a previous publish failed after version bump, publish the current local version without bumping again:
-
-```sh
-npm run release:publish
-```
+Saves the API key without writing local client config.
 
-## Notes
+`theclawbay logout`
 
-- End users only need API keys. They do not need upstream account credentials.
-- Keep your backend on HTTPS for WAN usage.
-- Linked config is stored at `~/.codex/theclawbay.managed.json`.
+Removes The Claw Bay-managed local config from this machine.

package/dist/commands/setup.js

@@ -530,6 +530,9 @@ class SetupCommand extends base_command_1.BaseCommand {
             else if (modelCacheMigration.action === "created") {
                 this.log("- Codex model cache: created a local picker cache with GPT-5.4.");
             }
+            else if (modelCacheMigration.action === "refreshed") {
+                this.log("- Codex model cache: refreshed the local picker cache for GPT-5.4.");
+            }
             else if (modelCacheMigration.action === "already_seeded") {
                 this.log("- Codex model cache: GPT-5.4 was already seeded locally.");
             }

package/dist/index.js

@@ -29,7 +29,7 @@ async function maybePrintBareInvocationHint() {
         currentVersion,
         log: (message) => console.log(message),
     }).catch(() => { });
-    console.log("Get your API key at: https://theclawbay.com/keys");
+    console.log("Get your API key at: https://theclawbay.com/dashboard");
     console.log("Then run: theclawbay setup --api-key <apiKey>");
     console.log("");
 }

package/dist/lib/codex-model-cache-migration.d.ts

@@ -1,5 +1,5 @@
 export type EnsureCodexModelCacheResult = {
-    action: "seeded" | "created" | "already_present" | "already_seeded" | "skipped";
+    action: "seeded" | "created" | "refreshed" | "already_present" | "already_seeded" | "skipped";
     warning?: string;
 };
 export type CleanupCodexModelCacheResult = {

package/dist/lib/codex-model-cache-migration.js

@@ -196,6 +196,19 @@ function buildSeedModel(models) {
     }
     return normalizeSeedModel(null);
 }
+function setCacheFreshnessMetadata(doc, clientVersion) {
+    let changed = false;
+    const now = new Date().toISOString();
+    if (doc.fetched_at !== now) {
+        doc.fetched_at = now;
+        changed = true;
+    }
+    if (clientVersion && doc.client_version !== clientVersion) {
+        doc.client_version = clientVersion;
+        changed = true;
+    }
+    return changed;
+}
 function parseCodexVersion(stdout) {
     const match = stdout.match(/\b(\d+\.\d+\.\d+)\b/);
     return match ? match[1] : null;
@@ -356,31 +369,46 @@ async function ensureCodexModelCacheHasGpt54(params) {
                 warning: "Codex models cache exists but is not valid JSON in the expected format; skipped GPT-5.4 seed.",
             };
         }
+        const clientVersion = (await inferCodexClientVersion(params.codexHome)) ??
+            (typeof doc.client_version === "string" && doc.client_version ? doc.client_version : null);
         const existingModel = findModel(doc.models, TARGET_MODEL_ID);
         if (existingModel) {
             const currentFingerprint = fingerprintModel(existingModel);
             if (existingState && existingState.fingerprint === currentFingerprint && !hasSeedMarker(existingModel)) {
                 const seededModel = applySeedMarker(existingModel);
                 doc.models = doc.models.map((entry) => (entry.slug === TARGET_MODEL_ID ? seededModel : entry));
+                setCacheFreshnessMetadata(doc, clientVersion);
                 await promises_1.default.writeFile(cachePath, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
                 await writePatchState(statePath, fingerprintModel(seededModel));
                 return { action: "seeded" };
             }
             if (hasSeedMarker(existingModel)) {
+                const docChanged = setCacheFreshnessMetadata(doc, clientVersion);
                 if (!existingState || existingState.fingerprint !== currentFingerprint) {
                     await writePatchState(statePath, currentFingerprint);
+                    await promises_1.default.writeFile(cachePath, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
+                    return { action: "refreshed" };
+                }
+                if (docChanged) {
+                    await promises_1.default.writeFile(cachePath, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
+                    return { action: "refreshed" };
                 }
                 return { action: "already_seeded" };
             }
             if (existingState && existingState.fingerprint !== currentFingerprint) {
                 await removeFileIfExists(statePath);
             }
+            if (setCacheFreshnessMetadata(doc, clientVersion)) {
+                await promises_1.default.writeFile(cachePath, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
+                return { action: "refreshed" };
+            }
             return {
                 action: existingState && existingState.fingerprint === currentFingerprint ? "already_seeded" : "already_present",
             };
         }
         const seed = buildSeedModel(doc.models);
         doc.models = [seed, ...doc.models];
+        setCacheFreshnessMetadata(doc, clientVersion);
         await promises_1.default.writeFile(cachePath, `${JSON.stringify(doc, null, 2)}\n`, "utf8");
         await writePatchState(statePath, fingerprintModel(seed));
         return { action: "seeded" };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "theclawbay",
-  "version": "0.3.8",
-  "description": "The Claw Bay CLI: one-time API-key setup for direct Codex access.",
+  "version": "0.3.10",
+  "description": "CLI for connecting Codex, OpenClaw, and OpenCode to The Claw Bay.",
   "license": "MIT",
   "bin": {
     "theclawbay": "dist/index.js"
@@ -30,8 +30,9 @@
     "claw-bay",
     "cli",
     "setup",
-    "wan",
-    "api-key"
+    "api-key",
+    "openclaw",
+    "opencode"
   ],
   "preferGlobal": true,
   "dependencies": {