@foxden-app/foxclaw 0.13.2 → 0.13.3

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.13.3 - 2026-10-06
+
+### 中文
+
+- 修复从 Telegram 添加 DSH 时，安装成功却因读取 FoxClaw `.env` 中的代理变量而启动失败。DSH 在独立运行目录启动，继续继承服务环境；会话工作目录由 ACP 单独指定。
+- 源码模式显式加载 DSH 的 tsx 和 TypeScript 配置，保持源码模块解析正常。补充后端安装、启动校验、启用及失败阶段日志，方便定位面板接入问题。
+
+### English
+
+- Fixed DSH setup failing after installation when its launch directory caused it to read proxy settings from FoxClaw's `.env`. Launch in an isolated runtime directory, inherit the service environment, and pass session workspaces separately through ACP.
+- Resolve the DSH source checkout's tsx loader and TypeScript configuration explicitly. Added provisioning stage, duration and failure logs for backend setup diagnostics.
+
 ## 0.13.2 - 2026-10-06
 
 ### 中文

package/dist/dsh/client.js

@@ -5,6 +5,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createHash } from 'node:crypto';
+import { createRequire } from 'node:module';
 import { ClientApp, ndJsonStream, PROTOCOL_VERSION } from '@agentclientprotocol/sdk';
 /** An owned ACP process; protocol stdout stays separate from diagnostics. */
 export class DshClient extends EventEmitter {
@@ -65,19 +66,27 @@ export class DshClient extends EventEmitter {
         }
         await fs.writeFile(patchPath, `- insert:\n    - id: foxclaw-permissions\n      name: ${JSON.stringify(pathToFileURL(pluginPath).href)}\n      config:\n        policyPath: ${JSON.stringify(this.policyPath)}\n`, { mode: 0o600 });
         const args = ['--profile', this.options.profile, ...this.options.patches.flatMap(p => ['--patch', path.resolve(p)]), '--patch', patchPath];
+        const env = { ...process.env, ...(this.options.home ? { DSH_HOME: this.options.home } : {}) };
         let command = this.options.cliBin;
-        let cwd = process.cwd();
+        // DSH reads .env in its launch directory. The service directory belongs to
+        // FoxClaw; session/new supplies the actual workspace independently.
+        const cwd = path.dirname(this.policyPath);
         if (this.options.sourceDir) {
-            cwd = path.resolve(this.options.sourceDir);
+            const sourceDir = path.resolve(this.options.sourceDir);
+            const tsx = createRequire(path.join(sourceDir, 'package.json')).resolve('tsx/esm');
+            env.TSX_TSCONFIG_PATH = path.join(sourceDir, 'tsconfig.json');
             command = process.execPath;
-            args.unshift('--import', 'tsx/esm', path.join(cwd, 'apps/cli/src/bin.ts'));
+            args.unshift('--import', pathToFileURL(tsx).href, path.join(sourceDir, 'apps/cli/src/bin.ts'));
         }
         else if (/\.[cm]?js$/.test(command)) {
             args.unshift(path.resolve(command));
             command = process.execPath;
         }
+        else if (command.includes('/') || command.includes('\\')) {
+            command = path.resolve(command);
+        }
         signal?.throwIfAborted();
-        const child = spawn(command, args, { cwd, env: { ...process.env, ...(this.options.home ? { DSH_HOME: this.options.home } : {}) }, stdio: 'pipe', windowsHide: true });
+        const child = spawn(command, args, { cwd, env, stdio: 'pipe', windowsHide: true });
         this.process = child;
         this.stderr = '';
         this.optionsBySession.clear();

package/dist/main.js

@@ -720,7 +720,7 @@ async function runServeCli() {
             codexCliBin: config.codexCliBin,
             agyCliBin: config.antigravityCliBin,
         });
-        const backendSetup = new BackendSetupManager([createDshSetupDefinition(logger)], config.envPath ?? DEFAULT_ENV_PATH, async () => (await selfUpdater.readStatus())?.state !== 'pending');
+        const backendSetup = new BackendSetupManager([createDshSetupDefinition(logger)], config.envPath ?? DEFAULT_ENV_PATH, async () => (await selfUpdater.readStatus())?.state !== 'pending', logger);
         supervisor.register('backend-setup', { stop: () => backendSetup.stop() });
         sharedAntigravityAuth = new AntigravityAuthManager(config.antigravityAuthDir, logger);
         sharedAntigravityApp = new AntigravityAppClient(config.antigravityCliBin, logger);

package/dist/service/backend_setup.d.ts

@@ -30,11 +30,12 @@ export interface BackendSetupDefinition {
 export declare class BackendSetupManager {
     private readonly envPath;
     private readonly canConfigure;
+    private readonly logger?;
     readonly definitions: ReadonlyMap<string, BackendSetupDefinition>;
     private readonly targets;
     private active;
     private stopped;
-    constructor(definitions: BackendSetupDefinition[], envPath: string, canConfigure?: () => Promise<boolean>);
+    constructor(definitions: BackendSetupDefinition[], envPath: string, canConfigure?: () => Promise<boolean>, logger?: Logger | undefined);
     get busy(): boolean;
     attach(target: (factory: BackendFactory) => void): () => void;
     enable(id: string, candidate?: BackendCandidate): Promise<void>;

package/dist/service/backend_setup.js

@@ -6,13 +6,15 @@ import { spawn } from 'node:child_process';
 export class BackendSetupManager {
     envPath;
     canConfigure;
+    logger;
     definitions;
     targets = new Set();
     active = null;
     stopped = false;
-    constructor(definitions, envPath, canConfigure = async () => true) {
+    constructor(definitions, envPath, canConfigure = async () => true, logger) {
         this.envPath = envPath;
         this.canConfigure = canConfigure;
+        this.logger = logger;
         this.definitions = new Map(definitions.map(definition => [definition.id, definition]));
     }
     get busy() { return this.active !== null; }
@@ -35,19 +37,31 @@ export class BackendSetupManager {
         let finish;
         const done = new Promise(resolve => { finish = resolve; });
         this.active = { controller, done };
+        const started = Date.now();
+        let stage = 'preflight';
         try {
             if (!await this.canConfigure())
                 throw new Error('A service update is running; try again when it finishes');
             controller.signal.throwIfAborted();
+            stage = candidate ? 'validate' : 'install';
+            this.logger?.info('backend.setup.started', { backendId: id, stage });
             const selected = candidate ?? await definition.install?.(controller.signal);
             if (!selected)
                 throw new Error('This backend requires a local installation');
+            stage = 'validate';
+            this.logger?.info('backend.setup.validate', { backendId: id });
             await definition.validate(selected, controller.signal);
             controller.signal.throwIfAborted();
             const factory = definition.factory(selected);
+            stage = 'activate';
             writeBackendEnv(this.envPath, selected.updates);
             for (const target of this.targets)
                 target(factory);
+            this.logger?.info('backend.setup.succeeded', { backendId: id, durationMs: Date.now() - started });
+        }
+        catch (error) {
+            this.logger?.error('backend.setup.failed', { backendId: id, stage, durationMs: Date.now() - started, error: safeSetupError(error) });
+            throw error;
         }
         finally {
             this.active = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "Foxden local execution claw for controlling Codex, OpenCode, Antigravity, and DeepSeek Harness from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",