coze_lab 0.1.45 → 0.1.47

package/README.md

@@ -83,10 +83,16 @@ For Python SDK uploads, `OTEL_ENDPOINT` is not used as the SDK base URL; set
 
 ## Supported Versions
 
+The current hook scheme requires these local capabilities:
+
+- `claude-code`: `settings.json` command hooks for `Stop` and `PostToolUse`.
+- `codex`: `hooks.json` command hooks for `Stop` and `PostToolUse`.
+- `openclaw`: plugin lifecycle/tool hooks with conversation access enabled.
+
 | Agent | Supported versions |
 |-------|--------------------|
-| `claude-code` | 1.2.x, 1.3.x, 1.4.x, 2.0.x, 2.1.x |
-| `codex` | 0.134.x, 1.0.x, 1.1.x |
-| `openclaw` | 2026.3.x, 2026.4.x, 2026.5.x |
+| `claude-code` | >= 1.0.0 |
+| `codex` | >= 0.134.0 |
+| `openclaw` | >= 2026.3.0 |
 
 Versions outside this list show a warning but onboarding continues.

package/index.js

@@ -459,12 +459,16 @@ function checkCozeloopSdk(pythonCmd, options = {}) {
 }
 
 // ─── 6. Version whitelist check ──────────────────────────────────────────────
-// Match on major.minor prefix: '1.3' matches 1.3.0, 1.3.2, 1.3.9
-const VERSION_WHITELIST = {
-  'claude-code': ['1.2', '1.3', '1.4', '2.0', '2.1'],
-  'codex':       ['1.0', '1.1', '0.134'],
-  'openclaw':    ['2026.3', '2026.4', '2026.5'],
+// Forward-compatible lower bounds. Newer CLI releases are treated as
+// supported by default because the hook selfcheck is the authoritative guard.
+const VERSION_SUPPORT = {
+  'claude-code': { min: '1.0.0', display: ['>= 1.0.0'] },
+  'codex':       { min: '0.134.0', display: ['>= 0.134.0'] },
+  'openclaw':    { min: '2026.3.0', display: ['>= 2026.3.0'] },
 };
+const VERSION_WHITELIST = Object.fromEntries(
+  Object.entries(VERSION_SUPPORT).map(([agent, cfg]) => [agent, cfg.display]),
+);
 
 const UPGRADE_CMD = {
   'claude-code': 'npm install -g @anthropic-ai/claude-code@latest',
@@ -473,15 +477,15 @@ const UPGRADE_CMD = {
 };
 
 function checkVersionWhitelist(agent, version) {
-  const whitelist = VERSION_WHITELIST[agent] || [];
-  const supported = whitelist.some(prefix => version.startsWith(prefix + '.') || version === prefix);
+  const support = VERSION_SUPPORT[agent];
+  const supported = support && isVersionAtLeast(version, support.min);
 
   if (supported) {
     ok(`${agent} v${version} — OK`);
     return;
   }
 
-  const supportedList = whitelist.map(v => `  • ${v}.x`);
+  const supportedList = (support?.display || []).map(v => `  • ${v}`);
   warnBox([
     `⚠ WARNING: Unsupported ${agent} version: ${version}`,
     '',
@@ -491,10 +495,29 @@ function checkVersionWhitelist(agent, version) {
     'Trace reporting may not work correctly.',
     'Please upgrade and re-run:',
     `  ${UPGRADE_CMD[agent]}`,
-    `  npx coze_lab --agent=${agent} ...`,
+    '  npx coze_lab --agent-id=<id>',
   ]);
 }
 
+function parseVersionNumbers(version) {
+  const m = String(version || '').match(/(\d+(?:\.\d+){0,3})/);
+  return m ? m[1].split('.').map((part) => Number(part)) : [];
+}
+
+function isVersionAtLeast(version, minVersion) {
+  const got = parseVersionNumbers(version);
+  const min = parseVersionNumbers(minVersion);
+  if (!got.length || !min.length) return false;
+  const len = Math.max(got.length, min.length);
+  for (let i = 0; i < len; i += 1) {
+    const a = got[i] || 0;
+    const b = min[i] || 0;
+    if (a > b) return true;
+    if (a < b) return false;
+  }
+  return true;
+}
+
 // ─── 7. Hook writers ─────────────────────────────────────────────────────────
 const fs   = require('fs');
 const path = require('path');
@@ -1780,4 +1803,7 @@ module.exports = {
   getAgentPatToken,
   mergeJson,
   atomicWriteFileSync,
+  VERSION_WHITELIST,
+  VERSION_SUPPORT,
+  isVersionAtLeast,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coze_lab",
-  "version": "0.1.45",
+  "version": "0.1.47",
   "description": "Configure local AI agents (Claude Code, Codex, OpenClaw) to report traces to CozeLoop",
   "keywords": [
     "cozeloop",

package/scripts/claude-code/cozeloop_hook.py

@@ -107,6 +107,36 @@ _OTEL_SUFFIX = "/v1/loop/opentelemetry"
 _DEFAULT_WORKSPACE_ID = "7649231955045072915"  # hardcoded spaceID fallback
 
 
+def _normalize_api_base_url(raw: str) -> str:
+    """Normalize CozeLoop API/OTLP endpoint env vars to the SDK api_base_url."""
+    base = (raw or "").strip().rstrip("/")
+    if not base:
+        return ""
+    suffixes = [
+        "/api/v1/loop/traces/ingest",
+        "/v1/loop/traces/ingest",
+        "/api/v1/loop/opentelemetry/v1/traces",
+        "/v1/loop/opentelemetry/v1/traces",
+        "/api/v1/loop/opentelemetry",
+        "/v1/loop/opentelemetry",
+        "/api/v1",
+        "/v1",
+    ]
+    for suffix in suffixes:
+        if base.endswith(suffix):
+            return base[:-len(suffix)].rstrip("/")
+    return base
+
+
+def get_api_base_url() -> str:
+    """Return optional CozeLoop SDK api_base_url from onboard-injected env."""
+    return _normalize_api_base_url(
+        os.environ.get("COZELOOP_API_BASE_URL")
+        or os.environ.get("OTEL_ENDPOINT")
+        or ""
+    )
+
+
 # --- coze-context parsing -------------------------------------------------
 # User messages may embed a block like:
 #   <coze-context>

package/scripts/codex/cozeloop_hook.py

@@ -133,6 +133,36 @@ else:
 DEBUG = os.environ.get("CC_COZELOOP_DEBUG", "").lower() == "true"
 
 
+def _normalize_api_base_url(raw: str) -> str:
+    """Normalize CozeLoop API/OTLP endpoint env vars to the SDK api_base_url."""
+    base = (raw or "").strip().rstrip("/")
+    if not base:
+        return ""
+    suffixes = [
+        "/api/v1/loop/traces/ingest",
+        "/v1/loop/traces/ingest",
+        "/api/v1/loop/opentelemetry/v1/traces",
+        "/v1/loop/opentelemetry/v1/traces",
+        "/api/v1/loop/opentelemetry",
+        "/v1/loop/opentelemetry",
+        "/api/v1",
+        "/v1",
+    ]
+    for suffix in suffixes:
+        if base.endswith(suffix):
+            return base[:-len(suffix)].rstrip("/")
+    return base
+
+
+def get_api_base_url() -> str:
+    """Return optional CozeLoop SDK api_base_url from onboard-injected env."""
+    return _normalize_api_base_url(
+        os.environ.get("COZELOOP_API_BASE_URL")
+        or os.environ.get("OTEL_ENDPOINT")
+        or ""
+    )
+
+
 def _log_file_path() -> str:
     return os.environ.get("COZELOOP_HOOK_LOG", "").strip()