coze_lab 0.1.37 → 0.1.38

package/README.md

@@ -8,7 +8,7 @@ Configure local AI agents (Claude Code, Codex, OpenClaw) to report traces to Coz
 # First-time setup — triggers browser OAuth authorization
 npx coze_lab --agent=<type>
 
-# Per-agent setup. Cloud/local is inferred from coze-bridge config.
+# Per-agent setup. Cloud/local is inferred from coze-bridge config or CLOUD_ENV=1.
 npx coze_lab --agent-id=<agentId>
 
 # Auth-only commands (no agent configuration)
@@ -23,8 +23,8 @@ npx coze_lab --logout     # Clear cached credentials
 | Parameter | Required | Values / Effect |
 |-----------|----------|-----------------|
 | `--agent` | ✓ (for setup) | `claude-code`, `codex`, `openclaw` |
-| `--agent-id` | — | Resolve `~/.coze/agents/<agentId>/config.json` and write per-agent config. `deployType=cloud` enables cloud mode automatically |
-| `--cloud` | — | Backward-compatible override for old callers. New callers should rely on `--agent-id` + config `deployType` |
+| `--agent-id` | — | Resolve `~/.coze/agents/<agentId>/config.json` and write per-agent config. Cloud mode is inferred from `deployType=cloud`, `CLOUD_ENV=1`, or bridge cloud-only fields |
+| `--cloud` | — | Backward-compatible override for old manual callers. New callers should rely on `--agent-id` auto-detection |
 | `--codex-home` | — | Override Codex config home for non-cloud/custom runs |
 | `--login` | — | Run the Device Code login flow only |
 | `--status` | — | Print local token status (valid / expiring / expired) |
@@ -56,7 +56,7 @@ npx coze_lab --logout     # Clear cached credentials
 | `codex` | `~/.codex/hooks/cozeloop_hook.py` | `~/.codex/hooks.json` | `~/.codex/hooks/cozeloop.env` |
 | `openclaw` | — (Node.js plugin) | `~/.openclaw/openclaw.json` | inline in config |
 
-For cloud Codex with `--agent-id=<agentId>` and config `deployType=cloud`, Codex hooks are written to
+For cloud Codex with `--agent-id=<agentId>`, Codex hooks are written to
 `~/.coze/agents/<agentId>/codex-home` by default. The directory is created if it
 does not already exist, so callers do not need to pass `--codex-home` for the
 standard coze-bridge layout.

package/index.js

@@ -53,6 +53,11 @@ function getCloudTokenInfo() {
   return { token: '', source: '', traceUsable: false };
 }
 
+function isCloudRuntimeEnv() {
+  const v = readEnv('CLOUD_ENV').toLowerCase();
+  return v === '1' || v === 'true' || v === 'yes' || v === 'cloud';
+}
+
 // ─── 1. Color helpers ────────────────────────────────────────────────────────
 const C = {
   reset:  '\x1b[0m',
@@ -156,6 +161,30 @@ function parseArgs() {
 
 const VALID_AGENTS = ['claude-code', 'codex', 'openclaw'];
 
+function hasCloudSessionToken(cfg) {
+  const sessions = cfg?.sessions;
+  if (!sessions || typeof sessions !== 'object' || Array.isArray(sessions)) return false;
+  return Object.values(sessions).some((record) => (
+    record
+    && typeof record === 'object'
+    && typeof record.modelToken === 'string'
+    && record.modelToken.trim()
+  ));
+}
+
+function hasCloudModelInfo(cfg) {
+  return !!(cfg?.modelInfo && typeof cfg.modelInfo === 'object' && !Array.isArray(cfg.modelInfo));
+}
+
+function inferDeployTypeFromAgentConfig(cfg) {
+  if (cfg?.deployType === 'cloud') return { deployType: 'cloud', reason: 'config.deployType=cloud' };
+  if (isCloudRuntimeEnv()) return { deployType: 'cloud', reason: 'env CLOUD_ENV=1' };
+  if (cfg?.deployType === 'local') return { deployType: 'local', reason: 'config.deployType=local' };
+  if (hasCloudSessionToken(cfg)) return { deployType: 'cloud', reason: 'config.sessions[*].modelToken' };
+  if (hasCloudModelInfo(cfg)) return { deployType: 'cloud', reason: 'config.modelInfo' };
+  return { deployType: 'local', reason: 'no cloud signal' };
+}
+
 // resolveAgent 读 ~/.coze/agents/<agentId>/config.json，返回 { framework, workspace, deployType, agentId, root }。
 // soft=true 时，config 不存在 / 解析失败 / framework 非法均返回 null（不退出），供云端回退到显式 --agent。
 function resolveAgent(agentId, soft) {
@@ -186,8 +215,8 @@ function resolveAgent(agentId, soft) {
       `支持的类型: ${VALID_AGENTS.join(', ')}`,
     ]);
   }
-  const deployType = cfg.deployType === 'cloud' ? 'cloud' : 'local';
-  return { framework, workspace: cfg.workspace || '', deployType, agentId, root };
+  const inferred = inferDeployTypeFromAgentConfig(cfg);
+  return { framework, workspace: cfg.workspace || '', deployType: inferred.deployType, deployReason: inferred.reason, agentId, root };
 }
 
 function validateArgs(args) {
@@ -197,11 +226,12 @@ function validateArgs(args) {
   if (args['refresh']) return { refresh: true };
   if (args['verify'])  return { verify:  true, pairCode: args['pair-code'] };
 
-  // --agent-id：优先读 coze-bridge 的 ~/.coze/agents/<id>/config.json 拿 framework/workspace/deployType。
-  // deployType=cloud 时自动进入云端注入路径；显式 --cloud 仍保留，供 config 缺失时兜底。
+  // --agent-id：优先读 coze-bridge 的 ~/.coze/agents/<id>/config.json 拿 framework/workspace。
+  // 云端判定优先看 deployType / CLOUD_ENV；兼容老 config 时再看 cloud-only 落盘字段。
   if (args['agent-id']) {
     const explicitCloud = !!args['cloud'];
-    const resolved = resolveAgent(args['agent-id'], explicitCloud /* soft */);
+    const runtimeCloud = isCloudRuntimeEnv();
+    const resolved = resolveAgent(args['agent-id'], explicitCloud || runtimeCloud /* soft */);
     if (resolved) {
       const cloud = explicitCloud || resolved.deployType === 'cloud';
       return {
@@ -210,20 +240,22 @@ function validateArgs(args) {
         workspace: resolved.workspace,
         agentRoot: resolved.root,
         deployType: resolved.deployType,
+        deployReason: explicitCloud ? '--cloud' : resolved.deployReason,
         'codex-home': args['codex-home'],
         pairCode: args['pair-code'],
         cloud,
         force: !!args['force'],
       };
     }
-    // 显式 --cloud 且 config.json 缺失：回退到显式 --agent（workspace 在 main 推断）。
-    if (!args['agent'] || !VALID_AGENTS.includes(args['agent'])) {
+    // 显式 --cloud 或 CLOUD_ENV=1 且 config.json 缺失：回退到显式 --agent
+    // （workspace 在 main 推断）。没有云端信号时仍按本地 config 缺失报错。
+    if ((!explicitCloud && !runtimeCloud) || !args['agent'] || !VALID_AGENTS.includes(args['agent'])) {
       errorBox([
         `ERROR: 未找到 agent "${args['agent-id']}" 的 config.json，且未显式指定 --agent`,
         '',
         '新调用方应确认 coze-bridge 已在目标环境写入该 agent config。',
-        '如需兼容旧手工命令，可显式拼上 framework 和 --cloud：',
-        `  npx coze_lab --cloud --agent-id=${args['agent-id']} --agent=claude-code|codex|openclaw`,
+        '如需兼容旧手工命令，可显式拼上 framework：',
+        `  npx coze_lab --agent-id=${args['agent-id']} --agent=claude-code|codex|openclaw`,
       ]);
     }
     return {
@@ -231,6 +263,7 @@ function validateArgs(args) {
       agentId: args['agent-id'],
       workspace: args['workspace'] || '',
       deployType: 'cloud',
+      deployReason: explicitCloud ? '--cloud' : 'env CLOUD_ENV=1',
       'codex-home': args['codex-home'],
       pairCode: args['pair-code'],
       cloud: true,
@@ -1784,14 +1817,13 @@ async function main() {
   // 云端模式：开启结构化输出 + errorBox 抛异常（而非 exit）。
   CLOUD_MODE = !!args.cloud;
   // per-agent 路由时 agent 的 workspace（claude-code 用它做配置根目录）。
-  // per-agent 路由时 agent 的 workspace（claude-code 用它做配置根目录）。
   // 云端 claude-code 未显式传 workspace 时，按约定路径 ~/.coze/agents/<id>/workspace 推断。
   let agentWorkspace = args.workspace || '';
   if (args.cloud && args.agentId && agent === 'claude-code' && !agentWorkspace) {
     agentWorkspace = path.join(os.homedir(), '.coze', 'agents', args.agentId, 'workspace');
   }
   if (args.agentId) {
-    info(`目标 agent: ${args.agentId} (framework=${agent}, workspace=${agentWorkspace || 'N/A'})`);
+    info(`目标 agent: ${args.agentId} (framework=${agent}, workspace=${agentWorkspace || 'N/A'}, deploy=${args.cloud ? 'cloud' : 'local'}, reason=${args.deployReason || 'n/a'})`);
     console.log('');
   }
 

package/package.json

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