@love-moon/conductor-sdk 0.7.4 → 0.7.6

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @love-moon/conductor-sdk
 
+## 0.7.6
+
+### Patch Changes
+
+- 7bbb412: Add `CONDUCTOR_HOME` support for relocating user-level configuration, logs,
+  Fire locks, sessions, update metadata, and AI manager caches while leaving
+  project-scoped `.conductor` directories and Fire task markers in place.
+
+  Migrate device authorization to `conductor.conductor-ai.top` while preserving
+  compatibility with the legacy official endpoint and self-hosted backends.
+
+## 0.7.5
+
 ## 0.7.4
 
 ## 0.7.3

package/dist/client.js

@@ -54,7 +54,7 @@ export class ConductorClient {
         const projectPath = options.projectPath ?? process.cwd();
         const backendApi = options.backendApi ?? new BackendApiClient(config);
         const sessions = options.sessionManager ?? new SessionManager();
-        const sessionStore = options.sessionStore ?? SessionDiskStore.forBackendUrl(config.backendUrl);
+        const sessionStore = options.sessionStore ?? SessionDiskStore.forBackendUrl(config.backendUrl, env);
         const messageRouter = options.messageRouter ?? new MessageRouter(sessions);
         const agentHost = resolveAgentHost(env, options.agentHost);
         const deliveryScopeId = normalizeDeliveryScopeId(options.deliveryScopeId ?? `agent:${agentHost}`);

package/dist/config/index.js

@@ -1,13 +1,11 @@
 import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
 import yaml from 'yaml';
+import { resolveConductorConfigPath } from '../paths.js';
 export const CONFIG_ENV_VAR = 'CONDUCTOR_CONFIG';
 export const AGENT_TOKEN_ENV_VAR = 'CONDUCTOR_AGENT_TOKEN';
 export const BACKEND_URL_ENV_VAR = 'CONDUCTOR_BACKEND_URL';
 export const WS_URL_ENV_VAR = 'CONDUCTOR_WS_URL';
 export const LOG_LEVEL_ENV_VAR = 'CONDUCTOR_LOG_LEVEL';
-const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.conductor', 'config.yaml');
 const ALLOWED_LOG_LEVELS = new Set(['debug', 'info', 'warning', 'error', 'critical']);
 export class ConfigError extends Error {
 }
@@ -97,21 +95,12 @@ export function loadConfig(targetPath, options = {}) {
     });
 }
 function resolveConfigPath(explicitPath, env) {
-    const candidate = explicitPath ||
-        env[CONFIG_ENV_VAR] ||
-        DEFAULT_CONFIG_PATH;
-    const normalized = normalizePath(candidate);
+    const normalized = resolveConductorConfigPath(explicitPath, env);
     if (!fs.existsSync(normalized)) {
         throw new ConfigFileNotFound(normalized);
     }
     return normalized;
 }
-function normalizePath(value) {
-    const expanded = value.startsWith('~')
-        ? path.join(os.homedir(), value.slice(1))
-        : value;
-    return path.resolve(expanded);
-}
 function readYaml(filePath) {
     const content = fs.readFileSync(filePath, 'utf-8');
     let parsed;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './paths.js';
 export * from './config/index.js';
 export * from './backend/index.js';
 export * from './ws/index.js';

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from './paths.js';
 export * from './config/index.js';
 export * from './backend/index.js';
 export * from './ws/index.js';

package/dist/paths.d.ts

@@ -0,0 +1,7 @@
+export declare const CONDUCTOR_HOME_ENV_VAR = "CONDUCTOR_HOME";
+export declare const CONDUCTOR_CONFIG_ENV_VAR = "CONDUCTOR_CONFIG";
+export type ConductorPathEnv = Record<string, string | undefined>;
+export declare function resolveUserHome(env?: ConductorPathEnv, fallbackHome?: string): string;
+export declare function resolveHomeRelativePath(value: string, env?: ConductorPathEnv, fallbackHome?: string): string;
+export declare function resolveConductorHome(env?: ConductorPathEnv): string;
+export declare function resolveConductorConfigPath(explicitPath?: string, env?: ConductorPathEnv): string;

package/dist/paths.js

@@ -0,0 +1,39 @@
+import os from 'node:os';
+import path from 'node:path';
+export const CONDUCTOR_HOME_ENV_VAR = 'CONDUCTOR_HOME';
+export const CONDUCTOR_CONFIG_ENV_VAR = 'CONDUCTOR_CONFIG';
+function normalizeOptionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : '';
+}
+export function resolveUserHome(env = process.env, fallbackHome = os.homedir()) {
+    return normalizeOptionalString(env.HOME)
+        || normalizeOptionalString(env.USERPROFILE)
+        || normalizeOptionalString(fallbackHome)
+        || '/tmp';
+}
+export function resolveHomeRelativePath(value, env = process.env, fallbackHome = os.homedir()) {
+    const normalized = normalizeOptionalString(value);
+    const userHome = resolveUserHome(env, fallbackHome);
+    if (normalized === '~') {
+        return path.resolve(userHome);
+    }
+    if (normalized.startsWith('~/') || normalized.startsWith('~\\')) {
+        return path.resolve(userHome, normalized.slice(2));
+    }
+    return path.resolve(normalized);
+}
+export function resolveConductorHome(env = process.env) {
+    const configuredHome = normalizeOptionalString(env[CONDUCTOR_HOME_ENV_VAR]);
+    if (configuredHome) {
+        return resolveHomeRelativePath(configuredHome, env);
+    }
+    return path.join(path.resolve(resolveUserHome(env)), '.conductor');
+}
+export function resolveConductorConfigPath(explicitPath, env = process.env) {
+    const configuredPath = normalizeOptionalString(explicitPath)
+        || normalizeOptionalString(env[CONDUCTOR_CONFIG_ENV_VAR]);
+    if (configuredPath) {
+        return resolveHomeRelativePath(configuredPath, env);
+    }
+    return path.join(resolveConductorHome(env), 'config.yaml');
+}

package/dist/session/store.d.ts

@@ -1,3 +1,4 @@
+import { type ConductorPathEnv } from '../paths.js';
 export declare const DEFAULT_SESSION_DIR: string;
 export declare const DEFAULT_SESSION_PATH: string;
 export declare const DEFAULT_SESSION_ENV = "CODEX_SESSION_ID";
@@ -29,9 +30,10 @@ export declare class SessionDiskStore {
     constructor(filePath?: string);
     /**
      * Create a SessionDiskStore for a specific backend URL.
-     * Sessions are stored in ~/.conductor/sessions/<host>.yaml
+     * Sessions are stored in $CONDUCTOR_HOME/sessions/<host>.yaml.
+     * When CONDUCTOR_HOME is unset, it defaults to ~/.conductor.
      */
-    static forBackendUrl(backendUrl: string): SessionDiskStore;
+    static forBackendUrl(backendUrl: string, env?: ConductorPathEnv): SessionDiskStore;
     load(): SessionRecord[];
     private loadUnlocked;
     save(records: SessionRecord[]): void;

package/dist/session/store.js

@@ -2,8 +2,9 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import yaml from 'yaml';
-export const DEFAULT_SESSION_DIR = path.join(os.homedir(), '.conductor', 'sessions');
-export const DEFAULT_SESSION_PATH = path.join(os.homedir(), '.conductor', 'session.yaml');
+import { resolveConductorHome } from '../paths.js';
+export const DEFAULT_SESSION_DIR = path.join(resolveConductorHome(), 'sessions');
+export const DEFAULT_SESSION_PATH = path.join(resolveConductorHome(), 'session.yaml');
 export const DEFAULT_SESSION_ENV = 'CODEX_SESSION_ID';
 export const DEFAULT_SESSION_FALLBACK_ENV = 'SESSION_ID';
 const SESSION_LOCK_TIMEOUT_MS = 10_000;
@@ -81,17 +82,18 @@ export class SessionRecord {
 export class SessionDiskStore {
     filePath;
     lockPath;
-    constructor(filePath = DEFAULT_SESSION_PATH) {
+    constructor(filePath = path.join(resolveConductorHome(), 'session.yaml')) {
         this.filePath = path.resolve(filePath);
         this.lockPath = `${this.filePath}.lock`;
     }
     /**
      * Create a SessionDiskStore for a specific backend URL.
-     * Sessions are stored in ~/.conductor/sessions/<host>.yaml
+     * Sessions are stored in $CONDUCTOR_HOME/sessions/<host>.yaml.
+     * When CONDUCTOR_HOME is unset, it defaults to ~/.conductor.
      */
-    static forBackendUrl(backendUrl) {
+    static forBackendUrl(backendUrl, env = process.env) {
         const host = extractHostKey(backendUrl);
-        const filePath = path.join(DEFAULT_SESSION_DIR, `${host}.yaml`);
+        const filePath = path.join(resolveConductorHome(env), 'sessions', `${host}.yaml`);
         return new SessionDiskStore(filePath);
     }
     load() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@love-moon/conductor-sdk",
-  "version": "0.7.4",
+  "version": "0.7.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lovemoon-ai/conductor.git"
@@ -33,5 +33,5 @@
     "typescript": "^5.6.3",
     "vitest": "^2.1.4"
   },
-  "gitCommitId": "b9a27b4"
+  "gitCommitId": "c939df2"
 }