wtt-connect 0.2.0 → 0.2.2

package/README.md

@@ -138,6 +138,12 @@ On macOS the same profile and state paths are used, while the service file is:
 
 A profile contains exactly one WTT identity: `WTT_AGENT_ID`, `WTT_TOKEN`, adapter, workdir, permission mode, and state directory. Multiple profiles may point at the same local `codex` or `claude` CLI binary; they must not share `WTT_AGENT_ID`, `WTT_TOKEN`, or `WTT_CONNECT_STATE_DIR`.
 
+Workdir rules:
+
+- If `--workdir` or `WTT_CONNECT_WORKDIR` is provided, that exact directory is used for agent execution, shell, terminal, runtime info, and adapter cwd.
+- If no workdir is provided, `wtt-connect` uses `./workspaces/<agent_id>` under the current default directory. This prevents multiple claimed agents on the same host from sharing the `wtt-connect` package directory.
+- For an existing profile, run `wtt-connect workdir <profile> /path/to/workspace --restart`. This updates `~/.config/wtt-connect/profiles/<profile>.env`, creates the directory, and restarts the service.
+
 Useful flags:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wtt-connect",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "description": "WTT-native connector daemon for Codex, Claude Code, Cursor, Gemini, ACP, and other coding agent surfaces.",
   "type": "module",

package/src/config.js

@@ -26,7 +26,8 @@ export function loadConfig(argv = {}) {
   const token = process.env.WTT_TOKEN || process.env.WTT_AGENT_TOKEN || fileConfig.token || '';
   const adapter = process.env.WTT_CONNECT_ADAPTER || fileConfig.adapter || 'codex';
   const adapters = String(process.env.WTT_CONNECT_ADAPTERS || fileConfig.adapters || adapter).split(',').map((x) => x.trim()).filter(Boolean);
-  const workDir = process.env.WTT_CONNECT_WORKDIR || fileConfig.workDir || process.cwd();
+  const explicitWorkDir = process.env.WTT_CONNECT_WORKDIR || fileConfig.workDir || '';
+  const workDir = resolveAgentWorkDir(explicitWorkDir, agentId);
   const stateDir = process.env.WTT_CONNECT_STATE_DIR || fileConfig.stateDir || path.join(workDir, '.wtt-connect');
   return {
     configFile: argv.config || process.env.WTT_CONNECT_CONFIG || '',
@@ -99,6 +100,20 @@ export function loadConfig(argv = {}) {
   };
 }
 
+export function resolveAgentWorkDir(explicitWorkDir, agentId, baseDir = process.cwd()) {
+  if (explicitWorkDir) return path.resolve(String(explicitWorkDir));
+  return path.resolve(baseDir, 'workspaces', safeAgentPathSegment(agentId));
+}
+
+export function safeAgentPathSegment(agentId) {
+  const value = String(agentId || 'unbound-agent')
+    .trim()
+    .replace(/[^a-zA-Z0-9._-]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 96);
+  return value || 'unbound-agent';
+}
+
 function resolveOpenDesignSkillsDir() {
   const candidates = [
     path.resolve(process.cwd(), 'opendesign-skills'),

package/src/main.js

@@ -10,7 +10,7 @@ import { DurableStore } from './store.js';
 import { log, redact } from './logger.js';
 import { adapterBin, normalizeProfileName } from './adapters/generic-cli.js';
 import { normalizeAdapterName } from './adapters/index.js';
-import { down, listProfiles, logs, resolveProfileEnvFile, restart, status, up } from './service-manager.js';
+import { down, listProfiles, logs, resolveProfileEnvFile, restart, status, up, workdir } from './service-manager.js';
 
 export async function main(args) {
   const cmd = args[0] || 'help';
@@ -23,6 +23,7 @@ export async function main(args) {
   if (cmd === 'status') return status(argv);
   if (cmd === 'restart') return restart(argv);
   if (cmd === 'logs') return logs(argv);
+  if (cmd === 'workdir') return workdir(argv);
   if (cmd === 'down' || cmd === 'unlink') return down(argv);
   if (cmd === 'doctor') return doctor(loadConfig(argv));
   if (cmd === 'setup') return setup(loadConfig(argv), argv);
@@ -61,6 +62,7 @@ function parseArgs(args) {
     else if (a === '--allow-yolo' || a === '--allow-dangerous-permissions') out.allowYolo = true;
     else if (a === '--yes' || a === '-y') out.yes = true;
     else if (a === '--publish-progress') out.publishProgress = true;
+    else if (a === '--restart') out.restart = true;
     else if (a === '--enable-linger') out.enableLinger = true;
     else if (a === '--no-start') out.noStart = true;
     else if (a === '--node-bin') out.nodeBin = args[++i];
@@ -97,6 +99,8 @@ Commands:
   status [profile|all]            Show systemd service status for profiles
   restart [profile|all]           Restart one or all configured services
   logs <profile> [--lines 100]    Show service logs
+  workdir <profile> [path] [--restart]
+                                  Show or update the agent execution directory
   down <profile>                  Stop/disable service; keep profile/state files
   unlink <profile>                Alias for down
   setup [--claim-code]           Register/write local .env and optionally print claim code

package/src/runner.js

@@ -1,4 +1,5 @@
 import { WTTClient } from './wtt-client.js';
+import fs from 'node:fs';
 import { WTTApi } from './wtt-api.js';
 import { SessionManager } from './session-manager.js';
 import { TTSManager } from './tts.js';
@@ -40,6 +41,7 @@ export class Runner {
   }
 
   async start() {
+    fs.mkdirSync(this.config.workDir, { recursive: true });
     log('info', 'wtt-connect starting', {
       agentId: this.config.agentId,
       adapters: this.registry.list().join(','),

package/src/service-manager.js

@@ -4,6 +4,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { spawnSync } from 'node:child_process';
 import { normalizeAdapterName } from './adapters/index.js';
+import { resolveAgentWorkDir } from './config.js';
 
 const DEFAULT_BASE_URL = 'https://www.waxbyte.com';
 const DEFAULT_MODE = 'full-auto';
@@ -32,7 +33,7 @@ export async function up(argv) {
   const stateDir = path.resolve(argv.stateDir || defaultStateDir(profile));
   const envFile = path.resolve(argv.envFile || profileEnvFile(profile));
   const root = packageRoot();
-  const workDir = path.resolve(argv.workdir || argv.workDir || process.cwd());
+  const workDir = resolveAgentWorkDir(argv.workdir || argv.workDir || '', agentId, process.cwd());
   const baseUrl = argv.baseUrl || process.env.WTT_BASE_URL || DEFAULT_BASE_URL;
   const nodeBin = argv.nodeBin || process.execPath;
   const codexBin = argv.codexBin || findBinary('codex');
@@ -42,6 +43,7 @@ export async function up(argv) {
   ensureDir(configDir);
   ensureDir(path.dirname(envFile));
   ensureDir(stateDir);
+  ensureDir(workDir);
 
   const profileValues = {
     WTT_BASE_URL: baseUrl,
@@ -140,6 +142,30 @@ export function logs(argv) {
   throw new Error(`unsupported platform: ${process.platform}`);
 }
 
+export function workdir(argv) {
+  const [profile = '', nextDir = ''] = argv._ || [];
+  if (!profile) throw new Error('usage: wtt-connect workdir <profile> [path] [--restart]');
+  const safe = sanitizeProfile(profile);
+  const envFile = profileEnvFile(safe);
+  if (!fs.existsSync(envFile)) throw new Error(`profile not found: ${safe}`);
+  const env = readEnv(envFile);
+  if (!nextDir) {
+    console.log(env.WTT_CONNECT_WORKDIR || '');
+    return;
+  }
+  const resolved = path.resolve(nextDir);
+  ensureDir(resolved);
+  env.WTT_CONNECT_WORKDIR = resolved;
+  writeProfileEnv(envFile, env);
+  console.log(`updated ${safe} workdir: ${resolved}`);
+  if (argv.restart) {
+    restartService(safe);
+    console.log(`${safe}: ${serviceStatus(safe)}`);
+  } else {
+    console.log(`restart required: wtt-connect restart ${safe}`);
+  }
+}
+
 export function down(argv) {
   const [profile = ''] = argv._ || [];
   if (!profile) throw new Error('usage: wtt-connect down <profile>');