fraim-hub 2.0.297 → 2.0.299

package/dist/src/ai-hub/configured-agent-command.js

@@ -42,12 +42,12 @@ function parseConfiguredCommand(runner, commandText) {
 // the only way to catch this class of error is to check, at readiness time,
 // that what the user typed there actually was that same base binary — not
 // to attempt to execute or otherwise interpret it.
-function describeConfiguredCommandInvocationProblem(parsed, baseHostId) {
+function describeConfiguredCommandInvocationProblem(parsed, baseHostId, agentLabel = 'Configured agent') {
     if (!parsed.invocationHead) {
-        return 'Command has no invocation to run after the environment prefix.';
+        return `${agentLabel} command has no invocation after the environment prefix. Run the create-hub-configured-agent job to repair this profile with an environment prefix followed by "${baseHostId}".`;
     }
     if (parsed.invocationHead !== baseHostId) {
-        return `Command must invoke "${baseHostId}" (found "${parsed.invocationHead}"). A setup script should be registered as a setup script, not composed into this field — see hub-configured-agent-setup.md.`;
+        return `Configured agent "${agentLabel}" invokes "${parsed.invocationHead}", but Hub launches the "${baseHostId}" base CLI and cannot apply that wrapper's environment. Run the create-hub-configured-agent job to repair this profile with an environment prefix followed by "${baseHostId}".`;
     }
     return null;
 }

package/dist/src/ai-hub/configured-agents.js

@@ -178,6 +178,17 @@ function checkConfiguredAgentAvailability(agent, employees, env = process.env) {
         if (!agent.command.command.trim()) {
             reasons.push('Command is empty.');
         }
+        else {
+            try {
+                const parsed = (0, configured_agent_command_1.parseConfiguredCommand)(agent.command.runner, agent.command.command);
+                const problem = (0, configured_agent_command_1.describeConfiguredCommandInvocationProblem)(parsed, agent.baseHostId, agent.label);
+                if (problem)
+                    reasons.push(problem);
+            }
+            catch (error) {
+                reasons.push(error instanceof Error ? error.message : 'Configured agent command could not be parsed.');
+            }
+        }
     }
     else if (agent.setupScript) {
         const command = agent.setupScript.command;
@@ -195,26 +206,8 @@ function checkConfiguredAgentReadiness(agent, employees, env = process.env) {
     const check = checkConfiguredAgentAvailability(agent, employees, env);
     if (!check.available)
         return check;
-    if (agent.command) {
-        try {
-            const parsed = (0, configured_agent_command_1.parseConfiguredCommand)(agent.command.runner, agent.command.command);
-            const problem = (0, configured_agent_command_1.describeConfiguredCommandInvocationProblem)(parsed, agent.baseHostId);
-            if (problem) {
-                return { ...check, available: false, reasons: [...check.reasons, problem] };
-            }
-            return check;
-        }
-        catch (error) {
-            return {
-                ...check,
-                available: false,
-                reasons: [
-                    ...check.reasons,
-                    error instanceof Error ? error.message : 'Configured agent command could not be parsed.',
-                ],
-            };
-        }
-    }
+    if (agent.command)
+        return check;
     if (!agent.setupScript)
         return check;
     try {

package/dist/src/ai-hub/desktop-main.js

@@ -630,12 +630,24 @@ async function bootstrap() {
     });
     await launchDesktopShell(options);
 }
-// Issue #1415: self-execution is now gated on `require.main === module` in addition to the
+function isDirectElectronEntry() {
+    if (require.main === module)
+        return true;
+    const currentFile = path_1.default.resolve(__filename).toLowerCase();
+    return process.argv.some((arg) => {
+        try {
+            return path_1.default.resolve(arg).toLowerCase() === currentFile;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+// Issue #1415: self-execution is gated on a direct Electron entry check in addition to the
 // existing Electron-main-process check, so `desktop-launcher.ts` requiring this file (bundled or
-// materialized) does not double-run bootstrap — the launcher calls the exported `bootstrap`
-// explicitly instead. Direct invocation (`npm run hub:desktop`, Electron-launching test suites)
-// is unaffected: this file is still `require.main` in that case.
-if (require.main === module && process.versions.electron && process.type !== 'renderer') {
+// materialized) does not double-run bootstrap. Electron's loader can own `require.main`, so
+// direct test launches also match the resolved script path in argv.
+if (isDirectElectronEntry() && process.versions.electron && process.type !== 'renderer') {
     bootstrap().catch(async (error) => {
         console.error(error instanceof Error ? error.message : error);
         await stopServerOnce();

package/dist/src/ai-hub/hosts.js

@@ -43,6 +43,7 @@ const command_resolution_1 = require("../cli/mcp/command-resolution");
 const agent_token_prices_1 = require("../local-mcp-server/agent-token-prices");
 const configured_agents_1 = require("./configured-agents");
 const pack_home_1 = require("../cli/utils/pack-home");
+const run_working_directory_1 = require("./run-working-directory");
 // Parse a single line of host stdout looking for a seekMentoring tool-use
 // signal. Returns null if the line does not contain one. Supports both
 // hosts FRAIM ships against today:
@@ -1916,7 +1917,7 @@ function detectCodexCompactTaskFailure(line) {
     }
     return null;
 }
-function wireHostProcess(hostId, child, handlers) {
+function wireHostProcess(hostId, child, handlers, spawnCwd) {
     const wire = (buffer, channel) => {
         let pending = '';
         let suppressCodexModelRefreshStderr = false;
@@ -1971,12 +1972,23 @@ function wireHostProcess(hostId, child, handlers) {
     // message names the cause. 'close' still fires after 'error' for spawn
     // failures, so handlers.onExit is called by the close listener above.
     child.on('error', (err) => {
-        handlers.onEvent({ hostError: describeSpawnError(err) }, 'system');
+        const spawnError = err;
+        console.warn('[ai-hub] hub.host_spawn_error', {
+            hostId,
+            cwd: spawnCwd,
+            cwdExists: spawnCwd ? (0, run_working_directory_1.workingDirectoryExists)(spawnCwd) : undefined,
+            errorCode: spawnError.code,
+            path: spawnError.path,
+        });
+        handlers.onEvent({ hostError: describeSpawnError(spawnError, spawnCwd) }, 'system');
     });
     return child;
 }
-function describeSpawnError(err) {
+function describeSpawnError(err, cwd) {
     if (err.code === 'ENOENT') {
+        if (cwd && !(0, run_working_directory_1.workingDirectoryExists)(cwd)) {
+            return `Agent working directory not found (${cwd}). The conversation scope may have been used as a path.`;
+        }
         return `Agent binary not found${err.path ? ` (${err.path})` : ''}. Ensure the agent CLI is installed and on PATH.`;
     }
     if (err.code === 'EACCES') {
@@ -2003,9 +2015,10 @@ function buildHostSpawnEnv(plan) {
 }
 function spawnHostProcess(hostId, plan, projectPath, handlers) {
     const invocation = resolveHostInvocation(plan);
+    const spawnCwd = (0, run_working_directory_1.resolveHostWorkingDirectory)(projectPath);
     const startedAtMs = Date.now();
     const child = (0, child_process_1.spawn)(invocation.command, invocation.args, {
-        cwd: projectPath,
+        cwd: spawnCwd,
         stdio: ['pipe', 'pipe', 'pipe'],
         env: buildHostSpawnEnv(plan),
     });
@@ -2015,13 +2028,13 @@ function spawnHostProcess(hostId, plan, projectPath, handlers) {
     child.stdin.end();
     if (typeof plan.stdin === 'string' && !plan.args.includes('--resume')) {
         child.once('close', () => {
-            const sessionId = discoverSessionIdAfterStart(hostId, projectPath, plan.stdin || '', startedAtMs);
+            const sessionId = discoverSessionIdAfterStart(hostId, spawnCwd, plan.stdin || '', startedAtMs);
             if (sessionId) {
                 handlers.onEvent({ sessionId, raw: `${hostId}-session:${sessionId}` }, 'system');
             }
         });
     }
-    return wireHostProcess(hostId, child, handlers);
+    return wireHostProcess(hostId, child, handlers, spawnCwd);
 }
 function discoverSessionIdAfterStart(hostId, projectPath, prompt, startedAtMs) {
     if (hostId !== 'gemini')
@@ -2257,13 +2270,15 @@ class FakeHostRuntime {
     detectEmployees() {
         return this.employees;
     }
-    startRun(hostId, _projectPath, message, handlers, _sessionId) {
+    startRun(hostId, _projectPath, message, handlers, _sessionId, launchContext) {
         this.lastStartMessage = message;
+        this.lastLaunchContext = launchContext;
         const reply = this.startReply ?? this.fakeEmployeeReply('start', message);
         return this.fakeProcess(hostId, reply, handlers);
     }
-    continueRun(hostId, _projectPath, sessionId, message, handlers) {
+    continueRun(hostId, _projectPath, sessionId, message, handlers, launchContext) {
         this.lastContinueMessage = message;
+        this.lastLaunchContext = launchContext;
         return this.fakeProcess(hostId, this.fakeEmployeeReply('continue', message), handlers);
     }
     startDirectRun(hostId, _message, _projectPath, handlers, _sessionId) {

package/dist/src/ai-hub/hub-latest-version.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.BADGE_POLL_INTERVAL_MS = void 0;
 exports.getLatestPublishedVersion = getLatestPublishedVersion;
 exports.getCachedLatestPublishedVersion = getCachedLatestPublishedVersion;
 exports.refreshLatestPublishedVersionInBackground = refreshLatestPublishedVersionInBackground;
@@ -21,6 +22,16 @@ const https_1 = __importDefault(require("https"));
 const TTL_MS = 5 * 60 * 1000;
 const FAILED_RETRY_MS = 5 * 60 * 1000;
 const REGISTRY_URL = 'https://registry.npmjs.org/fraim/latest';
+// A resident Hub (hidden in the tray, login-item autostart) can go days without any of
+// this module's other callers ever firing: they're all reactive (a page load, a
+// persona-identity retry, a tray-click relaunch decision), and none of them are timer-driven.
+// If nothing calls in, this cache never refreshes and the badge never learns about a new
+// release, no matter how far behind it drifts. AiHubServer.start() below runs this on its
+// own interval, independent of any request or window, so the cache — and therefore the
+// badge, on its next client-side poll — stays within 15 minutes of the truth even when the
+// Hub is otherwise fully idle. Lives here (not in the Electron shell) so it ships to
+// existing installs via a normal npm publish, not a new signed installer.
+exports.BADGE_POLL_INTERVAL_MS = 15 * 60 * 1000;
 let cache = { value: null, at: 0 };
 let lastAttemptAt = 0;
 let inFlight = null;

package/dist/src/ai-hub/manager-turns.js

@@ -50,7 +50,7 @@ function buildCommunicationStyleNote() {
 function buildBackgroundTaskPolicyNote() {
     return [
         '',
-        '[Background task policy] You are running in Hub headless mode. Never end your turn while background tasks (bash commands started with run_in_background=true, or sub-agents) are still active. Instead: monitor them, poll for results, and provide periodic progress commentary to the manager. Only end your turn when all background tasks have finished, or when you genuinely need a user decision or input to continue. If you exit while a background task is active, the Hub loses the link to that task permanently.',
+        '[Background task policy] You are running in Hub headless mode. Never end your turn while background tasks (bash commands started with run_in_background=true, or sub-agents) are still active. Instead: monitor them, poll for results, and provide periodic progress commentary to the manager. Only end your turn when all background tasks have finished, or when you genuinely need a user decision or input to continue. If you exit while a background task is active, the Hub loses the link to that task permanently. Background tasks and Monitor watchers cannot survive this turn ending: the next turn is a new process with no link to the old one (Windows: hard-killed; Unix: orphaned). The two things that reliably work: run the command synchronously in the foreground within this turn, or supervise it with `npx tsx ~/.fraim/scripts/exec-with-timeout.ts --supervise <name> --timeout <n> -- <command>` and poll `--status`/`--wait` (or `--stop` to cancel) without ending your turn.',
     ].join('\n');
 }
 // Issue #732: a plain continue of the SAME active job must not re-load the job.

package/dist/src/ai-hub/run-working-directory.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRunWorkingDirectory = resolveRunWorkingDirectory;
+exports.executionScopeFromConversation = executionScopeFromConversation;
+exports.resolveHostWorkingDirectory = resolveHostWorkingDirectory;
+exports.workingDirectoryExists = workingDirectoryExists;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const pack_home_1 = require("../cli/utils/pack-home");
+const conversation_store_1 = require("./conversation-store");
+function ensureExistingDirectory(directoryPath, label) {
+    const trimmed = (directoryPath || '').trim();
+    if (!trimmed) {
+        throw new Error(label === 'Project' ? 'Project path is required.' : `${label} working directory is required.`);
+    }
+    const resolved = path_1.default.resolve(trimmed);
+    const stat = fs_1.default.existsSync(resolved) ? fs_1.default.statSync(resolved) : null;
+    if (!stat || !stat.isDirectory()) {
+        throw new Error(label === 'Project'
+            ? 'Project path must point to an existing directory.'
+            : `${label} working directory is not available: ${resolved}`);
+    }
+    return resolved;
+}
+function scopeHome(scope) {
+    return scope === 'manager'
+        ? (0, pack_home_1.resolvePackHome)('manager').contentRoot
+        : (0, pack_home_1.resolvePackHome)('org').contentRoot;
+}
+function resolveRunWorkingDirectory(scope, candidateProjectPath, defaultProjectPath) {
+    if (scope === 'manager') {
+        return ensureExistingDirectory(scopeHome('manager'), 'Manager');
+    }
+    if (scope === 'company') {
+        return ensureExistingDirectory(scopeHome('company'), 'Company');
+    }
+    return ensureExistingDirectory(candidateProjectPath || defaultProjectPath || '', 'Project');
+}
+function executionScopeFromConversation(scope, projectPath) {
+    if (scope === 'manager' || projectPath === conversation_store_1.MANAGER_SCOPE_KEY)
+        return 'manager';
+    if (scope === 'company' || projectPath === conversation_store_1.COMPANY_SCOPE_KEY)
+        return 'company';
+    return 'project';
+}
+function resolveHostWorkingDirectory(candidateProjectPath) {
+    const trimmed = (candidateProjectPath || '').trim();
+    if (trimmed === conversation_store_1.MANAGER_SCOPE_KEY) {
+        return ensureExistingDirectory(scopeHome('manager'), 'Manager');
+    }
+    if (trimmed === conversation_store_1.COMPANY_SCOPE_KEY) {
+        return ensureExistingDirectory(scopeHome('company'), 'Company');
+    }
+    return ensureExistingDirectory(trimmed, 'Agent');
+}
+function workingDirectoryExists(directoryPath) {
+    if (!directoryPath)
+        return false;
+    try {
+        return fs_1.default.statSync(path_1.default.resolve(directoryPath)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}