coze_lab 0.1.34 → 0.1.36

package/package.json

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

package/scripts/claude-code/cozeloop_hook.py

@@ -105,11 +105,11 @@ else:
 
 # --- Configuration ---
 DEBUG = os.environ.get("CC_COZELOOP_DEBUG", "").lower() == "true"
-_COZELOOP_CLIENT_ID = "46371084383473718052118955183420.app.coze"
+_COZELOOP_CLIENT_ID = "08972682140163281554629748278108.app.coze"
 _COZE_API = "https://api.coze.cn"
 _OTEL_SUFFIX = "/v1/loop/opentelemetry"
 _REFRESH_THRESHOLD = 10 * 60  # refresh when < 10 minutes remain
-_DEFAULT_WORKSPACE_ID = "7644910356078837760"  # hardcoded spaceID fallback
+_DEFAULT_WORKSPACE_ID = "7649231955045072915"  # hardcoded spaceID fallback
 
 
 # --- coze-context parsing -------------------------------------------------
@@ -212,16 +212,41 @@ def _make_finish_event_processor(upload_events: Optional[List[str]] = None):
             logid = _extract_logid(detail)
             if logid:
                 print(f"[CozeLoop] 上报失败 logid={logid} (可用 bytedcli log get-logid-log {logid} 排查)", file=sys.stderr)
+                hook_log(f"upload FAILED logid={logid} detail={detail[:300]}")
             else:
                 print(f"[CozeLoop] 上报失败: {detail[:300]}", file=sys.stderr)
+                hook_log(f"upload FAILED detail={detail[:300]}")
         except Exception:
             pass
     return _processor
 
 
 
+def _log_file_path() -> str:
+    return os.environ.get("COZELOOP_HOOK_LOG", "").strip()
+
+
+def hook_log(message: str):
+    """Append one diagnostic line to the hook log, if configured.
+
+    onboard writes COZELOOP_HOOK_LOG into settings.local.json (env), so this
+    captures runtime upload diagnostics even when stderr is not visible.
+    """
+    log_path = _log_file_path()
+    if not log_path:
+        return
+    try:
+        p = Path(log_path).expanduser()
+        p.parent.mkdir(parents=True, exist_ok=True)
+        with p.open("a", encoding="utf-8") as f:
+            f.write(f"{datetime.now().isoformat()} {message}\n")
+    except Exception:
+        pass
+
+
 def debug_log(message: str):
-    """Print debug message if debug mode is enabled."""
+    """Print debug message if debug mode is enabled; always append to hook log."""
+    hook_log(f"DEBUG {message}")
     if DEBUG:
         print(f"[COZELOOP_HOOK_DEBUG] {datetime.now().isoformat()} - {message}", file=sys.stderr)
 
@@ -258,8 +283,6 @@ def _refresh_token(refresh_token: str) -> Optional[str]:
             data=payload,
             headers={
                 "Content-Type": "application/json",
-                "x-tt-env": "ppe_cozelab",
-                "x-use-ppe": "1",
             },
         )
         with urllib.request.urlopen(req, timeout=10) as resp:
@@ -281,16 +304,22 @@ def _refresh_token(refresh_token: str) -> Optional[str]:
 
 def _normalize_api_base_url(url: str) -> str:
     base = (url or "").strip().rstrip("/")
-    if base.endswith(_OTEL_SUFFIX + "/v1/traces"):
-        return base[:-len(_OTEL_SUFFIX + "/v1/traces")].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry/v1/traces"):
-        return base[:-len("/v1/loop/opentelemetry/v1/traces")].rstrip("/")
-    if base.endswith(_OTEL_SUFFIX):
-        return base[:-len(_OTEL_SUFFIX)].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry"):
-        return base[:-len("/v1/loop/opentelemetry")].rstrip("/")
-    if base.endswith("/api/v1"):
-        return base[:-len("/v1")].rstrip("/")
+    if not base:
+        return base
+    # 剥除已知 loop 路径后缀，还原纯 API base。
+    # 关键：含 /api 的变体必须连 /api 整体剥掉，否则残留 /api 会拼出 /api/v1/loop/... → 后端 400。
+    # 顺序：更长 / 带 /api 的在前，裸 /v1 最后，避免误匹配短后缀。
+    suffixes = (
+        "/api/v1/loop/opentelemetry/v1/traces",
+        _OTEL_SUFFIX + "/v1/traces",
+        "/api/v1/loop/opentelemetry",
+        _OTEL_SUFFIX,
+        "/api/v1",
+        "/v1",
+    )
+    for suffix in suffixes:
+        if base.endswith(suffix):
+            return base[:-len(suffix)].rstrip("/")
     return base
 
 def get_api_base_url() -> str:
@@ -970,6 +999,11 @@ def send_turns_to_cozeloop(turns: List[Dict[str, Any]], session_id: str, history
     api_base_url = get_api_base_url()
     if api_base_url:
         client_kwargs["api_base_url"] = api_base_url
+    hook_log(
+        f"init client session={session_id} workspace={workspace_id} "
+        f"token={(token[:12] + '...') if token else 'none'} "
+        f"api_base_url={api_base_url or '(default)'}"
+    )
     client = cozeloop.new_client(**client_kwargs)
 
     try:

package/scripts/codex/cozeloop_hook.py

@@ -42,10 +42,10 @@ from pathlib import Path
 from typing import Optional, List, Dict, Any
 
 # --- Token refresh --------------------------------------------------------
-_COZELOOP_CLIENT_ID = "46371084383473718052118955183420.app.coze"
+_COZELOOP_CLIENT_ID = "08972682140163281554629748278108.app.coze"
 _COZE_API = "https://api.coze.cn"
 _REFRESH_THRESHOLD = 10 * 60
-_DEFAULT_WORKSPACE_ID = "7644910356078837760"  # hardcoded spaceID fallback
+_DEFAULT_WORKSPACE_ID = "7649231955045072915"  # hardcoded spaceID fallback
 _OTEL_SUFFIX = "/v1/loop/opentelemetry"
 
 
@@ -195,8 +195,6 @@ def _refresh_token(refresh_tok: str):
             data=payload,
             headers={
                 "Content-Type": "application/json",
-                "x-tt-env": "ppe_cozelab",
-                "x-use-ppe": "1",
             },
         )
         with urllib.request.urlopen(req, timeout=10) as resp:
@@ -218,16 +216,22 @@ def _refresh_token(refresh_tok: str):
 
 def _normalize_api_base_url(url: str) -> str:
     base = (url or "").strip().rstrip("/")
-    if base.endswith(_OTEL_SUFFIX + "/v1/traces"):
-        return base[:-len(_OTEL_SUFFIX + "/v1/traces")].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry/v1/traces"):
-        return base[:-len("/v1/loop/opentelemetry/v1/traces")].rstrip("/")
-    if base.endswith(_OTEL_SUFFIX):
-        return base[:-len(_OTEL_SUFFIX)].rstrip("/")
-    if base.endswith("/api/v1/loop/opentelemetry"):
-        return base[:-len("/v1/loop/opentelemetry")].rstrip("/")
-    if base.endswith("/api/v1"):
-        return base[:-len("/v1")].rstrip("/")
+    if not base:
+        return base
+    # 剥除已知 loop 路径后缀，还原纯 API base。
+    # 关键：含 /api 的变体必须连 /api 整体剥掉，否则残留 /api 会拼出 /api/v1/loop/... → 后端 400。
+    # 顺序：更长 / 带 /api 的在前，裸 /v1 最后，避免误匹配短后缀。
+    suffixes = (
+        "/api/v1/loop/opentelemetry/v1/traces",
+        _OTEL_SUFFIX + "/v1/traces",
+        "/api/v1/loop/opentelemetry",
+        _OTEL_SUFFIX,
+        "/api/v1",
+        "/v1",
+    )
+    for suffix in suffixes:
+        if base.endswith(suffix):
+            return base[:-len(suffix)].rstrip("/")
     return base
 
 

package/scripts/openclaw/dist/cozeloop-exporter.js

@@ -5,16 +5,24 @@ import { ATTR_SERVICE_NAME, ATTR_SERVICE_INSTANCE_ID } from "@opentelemetry/sema
 import { hostname } from "os";
 import { basename, join } from "path";
 import { createRequire } from "node:module";
-import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { readFileSync, writeFileSync, mkdirSync, appendFileSync } from "fs";
 import { homedir } from "os";
 import http from "http";
 import https from "https";
 
 const require = createRequire(import.meta.url);
 const { version: PLUGIN_VERSION } = require("../package.json");
+const CLIENT_USER_AGENT = {
+    version: PLUGIN_VERSION,
+    lang: "nodejs",
+    lang_version: process.versions.node,
+    os_name: process.platform,
+    scene: "cozeloop",
+    source: "openapi",
+};
 
 // ── Token refresh helpers ─────────────────────────────────────────────────
-const _CLIENT_ID = "46371084383473718052118955183420.app.coze";
+const _CLIENT_ID = "08972682140163281554629748278108.app.coze";
 const _COZE_API  = "https://api.coze.cn";
 const _REFRESH_THRESHOLD_MS = 10 * 60 * 1000;
 const _CREDS_PATH = join(homedir(), ".cozeloop", "credentials.json");
@@ -36,7 +44,7 @@ async function _refreshToken(refreshTok) {
         const body = JSON.stringify({ grant_type: "refresh_token", client_id: _CLIENT_ID, refresh_token: refreshTok });
         const req = https.request(`${_COZE_API}/api/permission/oauth2/token`, {
             method: "POST",
-            headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body), "x-tt-env": "ppe_cozelab", "x-use-ppe": "1" },
+            headers: { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) },
         }, (res) => {
             let buf = "";
             res.on("data", c => buf += c);
@@ -82,24 +90,41 @@ const EXPORT_SUCCESS = 0;
 const EXPORT_FAILED = 1;
 const INGEST_TRACE_PATH = "/v1/loop/traces/ingest";
 
+// 把一行诊断写入 onboard 配置的 logFile（pluginConfig.logFile）。云端 gateway 日志常拿不到
+// （无 DBUS / 无 stdout 落盘），这个文件是排查上报失败的唯一依据。无 logFile 或写失败都静默。
+function fileLog(logFile, message) {
+    if (!logFile)
+        return;
+    try {
+        appendFileSync(logFile, `${new Date().toISOString()} ${message}\n`);
+    }
+    catch {
+        /* best-effort, never throw from logging */
+    }
+}
+
 function normalizeApiBaseUrl(endpoint) {
     const base = String(endpoint || "").replace(/\/+$/, "");
     if (!base)
         return _COZE_API;
+    // 剥除已知 loop 路径后缀，还原纯 API base。
+    // 关键：cozeloop ingest 正确端点 <host>/v1/loop/traces/ingest，【不带 /api 前缀】。
+    // 含 /api 的变体必须连 /api 整体剥掉 —— 否则残留 /api → /api/v1/loop/traces/ingest → 后端 400。
+    // 顺序：更长 / 带 /api 的在前，裸 /v1 最后，避免 endsWith 误匹配短后缀。
     const suffixes = [
-        "/v1/loop/traces/ingest",
         "/api/v1/loop/traces/ingest",
-        "/v1/loop/opentelemetry/v1/traces",
+        "/v1/loop/traces/ingest",
         "/api/v1/loop/opentelemetry/v1/traces",
-        "/v1/loop/opentelemetry",
+        "/v1/loop/opentelemetry/v1/traces",
         "/api/v1/loop/opentelemetry",
+        "/v1/loop/opentelemetry",
         "/v1/traces",
         "/api/v1",
+        "/v1",
     ];
     for (const suffix of suffixes) {
         if (base.endsWith(suffix)) {
-            const trimSuffix = suffix.startsWith("/api/") ? suffix.slice("/api".length) : suffix;
-            return base.slice(0, -trimSuffix.length).replace(/\/+$/, "");
+            return base.slice(0, -suffix.length).replace(/\/+$/, "");
         }
     }
     return base;
@@ -195,7 +220,7 @@ function spanToUploadSpan(span, config) {
     const attrs = span.attributes || {};
     const { tags, systemTags } = splitAttributes(attrs);
     const resourceAttrs = span.resource?.attributes || {};
-    const serviceName = resourceAttrs["service.name"] || config.serviceName || "openclaw-agent";
+    const serviceName = resourceAttrs["service.name"] || config.serviceName || "";
     const spanType = mapSpanType(attrs["cozeloop.span_type"]);
     const input = attrs["cozeloop.input"] !== undefined ? safeStringify(attrs["cozeloop.input"]) : "";
     const output = attrs["cozeloop.output"] !== undefined ? safeStringify(attrs["cozeloop.output"]) : "";
@@ -204,7 +229,6 @@ function spanToUploadSpan(span, config) {
     return {
         started_at_micros: hrTimeToUnixMicros(span.startTime),
         log_id: "",
-        traceId: spanContext.traceId,
         trace_id: spanContext.traceId,
         span_id: spanContext.spanId,
         parent_id: span.parentSpanId || "0",
@@ -260,9 +284,11 @@ class CozeloopIngestExporter {
         this.url = normalizeIngestUrl(config.endpoint || config.url);
         this.headers = config.headers || {};
         this.logger = config.logger;
+        this.logFile = config.logFile;
         this.workspaceId = config.workspaceId;
         this.serviceName = config.serviceName;
         this.shutdownRequested = false;
+        fileLog(this.logFile, `[ingest] exporter ready url=${this.url} workspaceId=${this.workspaceId}`);
     }
     export(spans, resultCallback) {
         if (!spans || spans.length === 0 || this.shutdownRequested) {
@@ -273,6 +299,7 @@ class CozeloopIngestExporter {
             .then(() => resultCallback({ code: EXPORT_SUCCESS }))
             .catch((err) => {
                 this.logger?.error?.(`[CozeloopTrace] CozeLoop ingest export failed: ${err?.message || err}`);
+                fileLog(this.logFile, `[ingest] export FAILED url=${this.url} spans=${spans.length} err=${err?.message || err}`);
                 resultCallback({ code: EXPORT_FAILED, error: err });
             });
     }
@@ -283,15 +310,18 @@ class CozeloopIngestExporter {
                 serviceName: this.serviceName,
             })),
         };
+        fileLog(this.logFile, `[ingest] POST url=${this.url} spans=${body.spans.length}`);
         const res = await postJson(this.url, body, this.headers);
         if (res.status < 200 || res.status >= 300) {
             const snippet = String(res.body || "").slice(0, 300);
+            fileLog(this.logFile, `[ingest] HTTP ${res.status} url=${this.url}${snippet ? ` body=${snippet}` : ""}`);
             throw new Error(`HTTP ${res.status}${snippet ? `: ${snippet}` : ""}`);
         }
         if (res.body) {
             try {
                 const parsed = JSON.parse(res.body);
                 if (parsed && parsed.code !== undefined && parsed.code !== 0) {
+                    fileLog(this.logFile, `[ingest] biz-error code=${parsed.code} msg=${parsed.msg || ""} url=${this.url}`);
                     throw new Error(`code ${parsed.code}: ${parsed.msg || res.body.slice(0, 300)}`);
                 }
             }
@@ -301,6 +331,7 @@ class CozeloopIngestExporter {
                 }
             }
         }
+        fileLog(this.logFile, `[ingest] OK HTTP ${res.status} spans=${body.spans.length}`);
     }
     async forceFlush() {
         return;
@@ -405,15 +436,17 @@ export class CozeloopExporter {
         const authorization = this.config.authorization;
         const workspaceId = this.config.workspaceId;
         this.api.logger.info(`[CozeloopTrace] Using authorization, workspaceId=${workspaceId}, tokenLength=${authorization?.length}`);
+        fileLog(this.config.logFile, `[init] ingestUrl=${normalizeIngestUrl(this.config.endpoint)} workspaceId=${workspaceId} tokenLength=${authorization?.length || 0} plugin=${PLUGIN_VERSION}`);
         const exporter = new CozeloopIngestExporter({
             endpoint: this.config.endpoint,
             logger: this.api.logger,
+            logFile: this.config.logFile,
             workspaceId,
             serviceName: this.config.serviceName,
             headers: {
                 "Authorization": authorization,
-                "x-tt-env": "ppe_cozelab",
-                "x-use-ppe": "1",
+                "User-Agent": `openclaw-cozeloop-trace/${PLUGIN_VERSION} node/${process.versions.node}`,
+                "X-Coze-Client-User-Agent": JSON.stringify(CLIENT_USER_AGENT),
             },
         });
         this.provider = new BasicTracerProvider({ resource });
@@ -473,10 +506,11 @@ export class CozeloopExporter {
         const runtimeTag = {
             language: "nodejs",
             library: "openclaw",
+            scene: process.env.COZELOOP_SCENE || "custom",
+            library_version: null,
+            loop_sdk_version: `v${PLUGIN_VERSION}`,
+            extra: null,
         };
-        if (process.env.COZELOOP_SCENE) {
-            runtimeTag.scene = process.env.COZELOOP_SCENE;
-        }
         const systemTagRuntime = JSON.stringify(runtimeTag);
         const span = this.tracer.startSpan(spanData.name, {
             kind: spanKind,
@@ -579,10 +613,11 @@ export class CozeloopExporter {
             const runtimeTag = {
                 language: "nodejs",
                 library: "openclaw",
+                scene: process.env.COZELOOP_SCENE || "custom",
+                library_version: null,
+                loop_sdk_version: `v${PLUGIN_VERSION}`,
+                extra: null,
             };
-            if (process.env.COZELOOP_SCENE) {
-                runtimeTag.scene = process.env.COZELOOP_SCENE;
-            }
             const systemTagRuntime = JSON.stringify(runtimeTag);
             const span = this.tracer.startSpan(spanData.name, {
                 kind: spanKind,

package/scripts/openclaw/dist/index.js

@@ -534,6 +534,7 @@ const cozeloopTracePlugin = {
             batchInterval: pluginConfig.batchInterval || 5000,
             enabledHooks: pluginConfig.enabledHooks,
             disableLocalCredentials: pluginConfig.disableLocalCredentials === true,
+            logFile: pluginConfig.logFile,
         };
         const exporter = new CozeloopExporter(api, config);
         // per-agent trace 放行：traceAgentIds 为 onboard 写入的 allowlist（小写归一）。

package/scripts/openclaw/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "openclaw-cozeloop-trace",
   "name": "OpenClaw CozeLoop Trace",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Report OpenClaw execution traces to CozeLoop via OpenTelemetry",
   "type": "plugin",
   "entry": "./dist/index.js",
@@ -54,6 +54,11 @@
         "type": "boolean",
         "default": false,
         "description": "Disable ~/.cozeloop credentials refresh and use configured authorization only"
+      },
+      "logFile": {
+        "type": "string",
+        "default": "",
+        "description": "Append trace ingest diagnostics (URL, span count, HTTP status, failure body) to this file"
       }
     }
   }

package/scripts/openclaw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cozeloop/openclaw-cozeloop-trace",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "OpenClaw Plugin for reporting traces to CozeLoop via OpenTelemetry",
   "type": "module",
   "main": "dist/index.js",

package/scripts/shared/cozeloop_refresh.py

@@ -7,7 +7,7 @@ Writes the fresh token back so subsequent Stop hooks pick it up.
 import json, os, sys, time, urllib.request
 from pathlib import Path
 
-CLIENT_ID = "46371084383473718052118955183420.app.coze"
+CLIENT_ID = "08972682140163281554629748278108.app.coze"
 COZE_API  = "https://api.coze.cn"
 THRESHOLD = 10 * 60  # 10 minutes
 CREDS     = Path.home() / ".cozeloop" / "credentials.json"
@@ -27,8 +27,6 @@ def refresh(rt):
         req = urllib.request.Request(f"{COZE_API}/api/permission/oauth2/token",
             data=body, headers={
                 "Content-Type":"application/json",
-                "x-tt-env":"ppe_cozelab",
-                "x-use-ppe":"1",
             })
         with urllib.request.urlopen(req, timeout=10) as r:
             d = json.loads(r.read())