fraim 2.0.185 → 2.0.186

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

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHubEvent = exports.createHubMessage = exports.ScriptedHostRuntime = exports.FakeHostRuntime = exports.CliHostRuntime = void 0;
 exports.parseSeekMentoringSignal = parseSeekMentoringSignal;
+exports.parseFraimJobLoadSignal = parseFraimJobLoadSignal;
 exports.parseUsageSignal = parseUsageSignal;
 exports.parseAgentIdentitySignal = parseAgentIdentitySignal;
 exports.detectEmployees = detectEmployees;
@@ -91,6 +92,58 @@ function parseSeekMentoringSignal(line) {
     }
     return null;
 }
+// Issue #710: extract the job name from a get_fraim_job tool call. This
+// is structured known-job evidence; the server still validates the job id
+// against the catalog before promoting any run.
+function parseFraimJobLoadSignal(line) {
+    if (!line.includes('get_fraim_job'))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== 'object' || parsed === null)
+        return null;
+    const obj = parsed;
+    // Codex shape: { type: 'item.started' | 'item.completed', item:
+    // { type: 'mcp_tool_call', tool: 'get_fraim_job', arguments: { job } } }.
+    if ((obj.type === 'item.started' || obj.type === 'item.completed') &&
+        typeof obj.item === 'object' && obj.item !== null) {
+        const item = obj.item;
+        const tool = typeof item.tool === 'string' ? item.tool : '';
+        if (item.type === 'mcp_tool_call' && isGetFraimJobTool(tool)) {
+            const sig = readFraimJobFromArgs(item.arguments);
+            if (sig)
+                return sig;
+        }
+    }
+    // Claude Code shape: tool_use blocks live inside message.content with
+    // an MCP-prefixed name such as mcp__fraim__get_fraim_job.
+    const candidates = [obj];
+    if (Array.isArray(obj.content))
+        candidates.push(...obj.content);
+    if (typeof obj.message === 'object' && obj.message !== null) {
+        const msg = obj.message;
+        if (Array.isArray(msg.content))
+            candidates.push(...msg.content);
+    }
+    for (const candidate of candidates) {
+        if (typeof candidate !== 'object' || candidate === null)
+            continue;
+        const c = candidate;
+        const isToolUse = c.type === 'tool_use' || c.type === 'function_call';
+        const nameField = typeof c.name === 'string' ? c.name : (typeof c.tool_name === 'string' ? c.tool_name : '');
+        if (!isToolUse || !isGetFraimJobTool(nameField))
+            continue;
+        const sig = readFraimJobFromArgs(c.input || c.arguments || c.parameters);
+        if (sig)
+            return sig;
+    }
+    return null;
+}
 // Issue #347 — extract per-turn usage from the host's JSON stream.
 // Codex: `{"type":"turn.completed","usage":{input_tokens, cached_input_tokens, output_tokens, reasoning_output_tokens}}`.
 // Claude Code: `{"type":"result", ..., "usage":{input_tokens, output_tokens, cache_creation_input_tokens, cache_read_input_tokens}, "total_cost_usd": ...}`.
@@ -256,6 +309,41 @@ function readAgentFromArgs(args) {
         return null;
     return { agentName, agentModel };
 }
+function isGetFraimJobTool(toolName) {
+    return toolName === 'get_fraim_job' ||
+        toolName === 'mcp__fraim__get_fraim_job' ||
+        toolName.endsWith('get_fraim_job');
+}
+function readFraimJobFromArgs(rawArgs) {
+    const args = normalizeToolArgs(rawArgs);
+    if (!args)
+        return null;
+    const rawJob = stringValue(args.job) ||
+        stringValue(args.jobName) ||
+        stringValue(args.job_id) ||
+        stringValue(args.name);
+    const jobId = rawJob.trim().toLowerCase();
+    if (!jobId)
+        return null;
+    return { jobId, source: 'get_fraim_job' };
+}
+function normalizeToolArgs(rawArgs) {
+    if (rawArgs && typeof rawArgs === 'object' && !Array.isArray(rawArgs)) {
+        return rawArgs;
+    }
+    if (typeof rawArgs !== 'string' || rawArgs.trim().length === 0)
+        return null;
+    try {
+        const parsed = JSON.parse(rawArgs);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
 function numberOrNull(v) {
     return typeof v === 'number' && Number.isFinite(v) ? v : null;
 }
@@ -987,17 +1075,24 @@ function parseHostLine(hostId, line) {
     const trimmed = line.trim();
     if (!trimmed)
         return {};
-    // Issue #347: scan every line for the three signals the Hub UI cares
-    // about — seekMentoring (drives the tracker), turn-level usage
-    // (drives the totals tokens/cost), and the agent identity from
-    // fraim_connect (used to look up cost when the host doesn't emit it).
+    // Scan every line for structured signals the Hub UI cares about:
+    // seekMentoring (tracker), get_fraim_job (job identity promotion),
+    // turn-level usage (totals), and fraim_connect agent identity
+    // (cost lookup when the host doesn't emit it).
     const seekMentoring = parseSeekMentoringSignal(trimmed);
+    const fraimJob = parseFraimJobLoadSignal(trimmed);
     const usage = parseUsageSignal(trimmed);
     const agentIdentity = parseAgentIdentitySignal(trimmed);
     const withSignal = (event) => {
-        if (!seekMentoring && !usage && !agentIdentity)
+        if (!seekMentoring && !fraimJob && !usage && !agentIdentity)
             return event;
-        return { ...event, ...(seekMentoring ? { seekMentoring } : {}), ...(usage ? { usage } : {}), ...(agentIdentity ? { agentIdentity } : {}) };
+        return {
+            ...event,
+            ...(seekMentoring ? { seekMentoring } : {}),
+            ...(fraimJob ? { fraimJob } : {}),
+            ...(usage ? { usage } : {}),
+            ...(agentIdentity ? { agentIdentity } : {}),
+        };
     };
     if (hostId === 'codex') {
         try {
@@ -1339,9 +1434,10 @@ class ScriptedHostRuntime {
             { id: 'gemini', label: 'Gemini CLI', available: true, detail: 'Scripted test double.', supportsRaw: true },
             { id: 'copilot', label: 'GitHub Copilot CLI', available: true, detail: 'Scripted test double.', supportsRaw: true },
         ];
-        // Track each active run so the test can emit signals at it. Key is the
-        // sessionId we hand back on startRun; mapping sessionId → handlers
-        // lets emitPhase() reach the right run's onEvent callback.
+        // Track each active run so the test can emit signals at it. The Hub
+        // passes the run id as the requested start session id in test/demo paths;
+        // real resume flows still use the host session id. Resolving by the
+        // supplied id first lets concurrent scripted runs receive targeted events.
         this.handlersBySession = new Map();
         // Tracks runDiscriminant per sessionId so consecutive emitPhase calls
         // can resolve onSuccess routing without each test having to repeat it.
@@ -1352,8 +1448,8 @@ class ScriptedHostRuntime {
     }
     startRun(_hostId, _projectPath, _message, handlers, requestedSessionId) {
         const sessionId = requestedSessionId || (0, crypto_1.randomUUID)();
-        handlers.onEvent({ sessionId, raw: 'scripted-session-start' }, 'system');
         this.handlersBySession.set(sessionId, handlers);
+        handlers.onEvent({ sessionId, raw: 'scripted-session-start' }, 'system');
         return this.spawnDouble();
     }
     continueRun(_hostId, _projectPath, sessionId, _message, handlers) {
@@ -1363,6 +1459,7 @@ class ScriptedHostRuntime {
     }
     startDirectRun(_hostId, _message, _projectPath, handlers, requestedSessionId) {
         const sessionId = requestedSessionId || (0, crypto_1.randomUUID)();
+        this.handlersBySession.set(sessionId, handlers);
         handlers.onEvent({ sessionId, raw: 'scripted-direct-session-start' }, 'system');
         return this.spawnDouble();
     }
@@ -1420,6 +1517,18 @@ class ScriptedHostRuntime {
             },
         }, 'stdout');
     }
+    // Test API — emit the structured job-load signal that get_fraim_job
+    // produces before the first seekMentoring phase call.
+    emitFraimJobLoad(runId, jobId) {
+        const target = this.resolveSession(runId);
+        if (!target)
+            return;
+        target.handlers.onEvent({
+            sessionId: target.sessionId,
+            raw: `scripted-get_fraim_job:${jobId}`,
+            fraimJob: { jobId, source: 'get_fraim_job' },
+        }, 'stdout');
+    }
     // Test API — emit a per-turn usage signal in the normalized shape
     // the server expects. Mirrors what parseUsageSignal would produce
     // from a real host's stream.
@@ -1464,13 +1573,16 @@ class ScriptedHostRuntime {
         this.handlersBySession.clear();
         this.discriminantBySession.clear();
     }
-    // The Hub server keeps its own sessionId map keyed off run.sessionId —
-    // but at the time the test calls emitPhase(runId), we may only have
-    // one handler registered (the latest start). Resolve by sessionId
-    // first, fall back to the most recent registered handler.
-    resolveSession(_runId) {
+    // The Hub passes run.id as the requested session id for scripted starts,
+    // so tests/demo controls can target a specific run even when multiple runs
+    // are active. Fall back to the latest handler for older callers that do not
+    // provide a known id.
+    resolveSession(runId) {
         if (this.handlersBySession.size === 0)
             return null;
+        const direct = this.handlersBySession.get(runId);
+        if (direct)
+            return { sessionId: runId, handlers: direct };
         const entries = [...this.handlersBySession.entries()];
         const [sessionId, handlers] = entries[entries.length - 1];
         return { sessionId, handlers };

package/dist/src/ai-hub/openclaw-bridge.js

@@ -134,6 +134,7 @@ class OpenClawAiHubBridge {
                         jobId: run.jobId,
                         projectPath,
                         lastSeenAt: new Date().toISOString(),
+                        managerTexts: [inbound.text],
                     };
                     this.threads.set(key, state);
                     this.persistThreadState();
@@ -147,6 +148,7 @@ class OpenClawAiHubBridge {
                     }
                     run = continued.data;
                     state.lastSeenAt = new Date().toISOString();
+                    state.managerTexts = [...(state.managerTexts ?? []), inbound.text];
                     this.persistThreadState();
                 }
                 const settled = await this.waitForSettlement(run.id);
@@ -193,6 +195,19 @@ class OpenClawAiHubBridge {
         return this.fetchRun(runId);
     }
     presentThread(state, run) {
+        // The Hub records the invocation it sent as each manager bubble (#696). For a channel
+        // transcript we substitute the user's own words (state.managerTexts, in turn order)
+        // for manager-role messages, so the thread reflects what the user actually typed.
+        const managerTexts = state.managerTexts ?? [];
+        let managerIdx = 0;
+        const transcript = run.messages.map((message) => ({
+            role: message.role,
+            text: message.role === 'manager' && managerIdx < managerTexts.length
+                ? managerTexts[managerIdx++]
+                : message.text,
+            createdAt: message.createdAt,
+        }));
+        const latestManagerMessage = [...transcript].reverse().find((m) => m.role === 'manager')?.text || null;
         return {
             channelId: state.channelId,
             threadId: state.threadId,
@@ -204,13 +219,9 @@ class OpenClawAiHubBridge {
             currentPhase: run.currentPhase || null,
             stages: run.stages || [],
             totals: run.totals || null,
-            latestManagerMessage: lastMessage(run.messages, 'manager')?.text || null,
+            latestManagerMessage,
             latestEmployeeMessage: lastMessage(run.messages, 'employee')?.text || null,
-            transcript: run.messages.map((message) => ({
-                role: message.role,
-                text: message.text,
-                createdAt: message.createdAt,
-            })),
+            transcript,
         };
     }
     threadKey(channelId, threadId) {

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

@@ -227,6 +227,9 @@ function safeHttpUrl(value) {
 }
 // ─── Issue #578: Deployment + Host stores ─────────────────────────────────────
 const VALID_EMPLOYEE_IDS = ['codex', 'claude', 'gemini', 'copilot'];
+function startSessionSeedForHost(hostId, runId) {
+    return hostId === 'gemini' ? undefined : runId;
+}
 class DeploymentStore {
     constructor(filePath) {
         this.filePath = filePath ?? path_1.default.join(getUserHubDir(), 'hub-deployments.json');
@@ -587,6 +590,42 @@ function emptyTotals() {
         },
     };
 }
+const PHASE_STATUSES = new Set(['starting', 'complete', 'incomplete', 'failure']);
+function normalizePersistedPhaseHistory(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value
+        .map((entry) => {
+        if (!entry || typeof entry !== 'object')
+            return null;
+        const raw = entry;
+        if (typeof raw.phaseId !== 'string' || !raw.phaseId)
+            return null;
+        const latestStatus = typeof raw.latestStatus === 'string' && PHASE_STATUSES.has(raw.latestStatus)
+            ? raw.latestStatus
+            : null;
+        return {
+            phaseId: raw.phaseId,
+            enteredAt: typeof raw.enteredAt === 'string' ? raw.enteredAt : new Date().toISOString(),
+            latestStatus,
+            latestText: typeof raw.latestText === 'string' ? raw.latestText : null,
+        };
+    })
+        .filter((entry) => Boolean(entry));
+}
+function readPersistedRunProjection(conversation) {
+    const rawRun = conversation?.run;
+    if (!rawRun || typeof rawRun !== 'object')
+        return null;
+    const value = rawRun;
+    return {
+        currentPhase: typeof value.currentPhase === 'string' ? value.currentPhase : null,
+        phaseHistory: normalizePersistedPhaseHistory(value.phaseHistory),
+        stages: Array.isArray(value.stages) ? value.stages : [],
+        totals: value.totals && typeof value.totals === 'object' ? value.totals : null,
+        runDiscriminant: typeof value.runDiscriminant === 'string' ? value.runDiscriminant : null,
+    };
+}
 // Issue #347 — apply per-turn usage from the host stream into the
 // run's tokenTotals. Idempotent on the same turn (we replace, not add)
 // because Codex's `turn.completed.usage` is cumulative, not delta.
@@ -766,20 +805,17 @@ function deriveStages(run, projectPath) {
     }
     return declaredPath.map((phase, index) => {
         let state;
-        if (currentIndex < 0) {
-            state = 'upcoming';
-        }
-        else if (index < currentIndex) {
-            state = 'done';
-        }
-        else if (index === currentIndex) {
+        const entry = historyMap.get(phase.id);
+        if (index === currentIndex) {
             // If the agent has already reported this phase as 'complete', advance
             // its visual state to 'done' so the tracker doesn't look frozen while
             // waiting for the agent to start the next phase (e.g. after
             // implement-submission completes but before address-feedback starts).
-            const entry = historyMap.get(phase.id);
             state = entry?.latestStatus === 'complete' ? 'done' : 'current';
         }
+        else if (entry?.latestStatus === 'complete' || (currentIndex >= 0 && index < currentIndex && entry)) {
+            state = 'done';
+        }
         else {
             state = 'upcoming';
         }
@@ -1399,6 +1435,7 @@ class AiHubServer {
     }
     conversationRecordFromRun(run) {
         const lastUpdatedAt = run.updatedAt || new Date().toISOString();
+        const stages = deriveStages(run, run.projectPath);
         return {
             id: run.conversationId || run.id,
             projectPath: path_1.default.resolve(run.projectPath),
@@ -1433,6 +1470,13 @@ class AiHubServer {
             compareRunId: run.compareRunId || null,
             // Issue #578: preserve trigger source so the UI can render the chip.
             sourceTrigger: run.sourceTrigger,
+            run: {
+                stages,
+                currentPhase: run.currentPhase || null,
+                phaseHistory: run.phaseHistory || [],
+                totals: run.totals || null,
+                runDiscriminant: run.runDiscriminant || null,
+            },
         };
     }
     persistRunConversation(run, activeId) {
@@ -1544,8 +1588,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -1567,7 +1613,7 @@ class AiHubServer {
                 }
                 this.runRegistry.dispose(childRun.id);
             },
-        }, childRun.sessionId);
+        }, startSessionSeedForHost(managerRun.hostId, childRun.id));
         this.runRegistry.attachChildIfRunning(childRun.id, child);
     }
     notifyManagerOfDelegatedChild(managerRunId, childRun) {
@@ -1691,8 +1737,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -1764,14 +1812,48 @@ class AiHubServer {
         };
     }
     resolveHubJob(projectPath, jobId) {
+        if (!jobId || jobId === '__freeform__')
+            return null;
         const employeeJob = (0, catalog_1.discoverEmployeeJobs)(projectPath).find((job) => job.id === jobId);
-        if (employeeJob)
-            return { id: employeeJob.id, stubPath: employeeJob.stubPath };
+        if (employeeJob) {
+            return {
+                id: employeeJob.id,
+                title: employeeJob.title,
+                stubPath: employeeJob.stubPath,
+                personaKey: employeeJob.requiredPersonaKey ?? getProtectedPersonaForHubJob(employeeJob.id),
+            };
+        }
         const managerTemplate = (0, catalog_1.discoverManagerTemplates)(projectPath).find((job) => job.id === jobId);
-        if (managerTemplate)
-            return { id: managerTemplate.id, stubPath: managerTemplate.stubPath };
+        if (managerTemplate) {
+            return {
+                id: managerTemplate.id,
+                title: managerTemplate.title,
+                stubPath: managerTemplate.stubPath,
+                personaKey: getProtectedPersonaForHubJob(managerTemplate.id),
+            };
+        }
         return null;
     }
+    applySeekMentoringSignalToRun(run, signal) {
+        this.maybePromoteFreeformRunToJob(run, signal.jobId || signal.jobName);
+        applySeekMentoringSignal(run, signal);
+    }
+    applyFraimJobSignalToRun(run, signal) {
+        this.maybePromoteFreeformRunToJob(run, signal.jobId);
+    }
+    maybePromoteFreeformRunToJob(run, signalJobId) {
+        const normalizedJobId = (signalJobId || '').trim().toLowerCase();
+        if (run.jobId !== '__freeform__' || !normalizedJobId)
+            return;
+        const metadata = this.resolveHubJob(run.projectPath, normalizedJobId);
+        if (!metadata)
+            return;
+        run.jobId = metadata.id;
+        run.jobTitle = metadata.title;
+        run.personaKey = metadata.personaKey;
+        run.updatedAt = new Date().toISOString();
+        run.events.push((0, hosts_1.createHubEvent)('system', `Recognized FRAIM job ${metadata.id} from structured telemetry.`));
+    }
     // Lightweight markdown → .docx. Shared by the GET (file path) and POST (inline
     // content) export routes so a conversational deliverable with no on-disk file
     // can still be downloaded for Word annotation.
@@ -2355,11 +2437,15 @@ class AiHubServer {
                     throw new Error('Choose a FRAIM job before starting a run.');
                 }
                 const startTimestamp = new Date().toISOString();
+                const jobMetadata = this.resolveHubJob(projectPath, jobId);
+                const fallbackJobTitle = typeof req.body.jobTitle === 'string' && req.body.jobTitle.trim()
+                    ? req.body.jobTitle.trim()
+                    : jobId;
                 const run = {
                     id: (0, crypto_1.randomUUID)(),
                     conversationId: typeof req.body.conversationId === 'string' && req.body.conversationId.trim() ? req.body.conversationId.trim() : undefined,
                     conversationTitle: typeof req.body.conversationTitle === 'string' && req.body.conversationTitle.trim() ? req.body.conversationTitle.trim() : undefined,
-                    jobTitle: typeof req.body.jobTitle === 'string' && req.body.jobTitle.trim() ? req.body.jobTitle.trim() : jobId,
+                    jobTitle: jobMetadata?.title || fallbackJobTitle,
                     jobId,
                     hostId,
                     projectPath,
@@ -2373,7 +2459,7 @@ class AiHubServer {
                     phaseHistory: [],
                     totals: emptyTotals(),
                     lastStatusChangeAt: startTimestamp,
-                    personaKey: getProtectedPersonaForHubJob(jobId),
+                    personaKey: jobMetadata?.personaKey ?? getProtectedPersonaForHubJob(jobId),
                     // Issue #442: mark this as the FRAIM side of an A/B pair when applicable.
                     ...(compareMode === 'ab' ? { runRole: 'fraim' } : {}),
                     // #0: trigger source — defaults to 'manager' when not provided by the caller.
@@ -2426,8 +2512,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -2460,7 +2548,7 @@ class AiHubServer {
                         if (latest)
                             this.drainPendingDelegatedReviews(latest);
                     },
-                }, run.sessionId);
+                }, startSessionSeedForHost(hostId, run.id));
                 this.runRegistry.attachChildIfRunning(run.id, child);
                 // Issue #442: spawn the Direct run via startDirectRun so CliHostRuntime
                 // uses buildDirectStartPlan (--strict-mcp-config, raw stdin) rather than
@@ -2489,7 +2577,7 @@ class AiHubServer {
                             });
                             this.runRegistry.dispose(directId);
                         },
-                    }, directRun.sessionId);
+                    }, startSessionSeedForHost(hostId, directRun.id));
                     this.runRegistry.attachChildIfRunning(directRun.id, directChild);
                 }
                 const existingPreferences = this.preferencesStore.load(projectPath);
@@ -2615,8 +2703,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -2677,16 +2767,27 @@ class AiHubServer {
                 if (!employee?.available) {
                     throw new Error(`${employee?.label || 'Selected employee'} is not available on this machine.`);
                 }
+                const conversationId = typeof body.conversationId === 'string' && body.conversationId.trim()
+                    ? body.conversationId.trim()
+                    : undefined;
+                const persistedConversation = conversationId
+                    ? this.conversationStore.loadProject(projectPath).conversations.find((entry) => entry.id === conversationId)
+                    : undefined;
+                const persistedRun = readPersistedRunProjection(persistedConversation);
                 const now = new Date().toISOString();
                 const run = {
                     id: (0, crypto_1.randomUUID)(),
-                    conversationId: typeof body.conversationId === 'string' && body.conversationId.trim() ? body.conversationId.trim() : undefined,
+                    conversationId,
                     conversationTitle: typeof body.conversationTitle === 'string' && body.conversationTitle.trim() ? body.conversationTitle.trim() : undefined,
                     jobTitle: typeof body.jobTitle === 'string' && body.jobTitle.trim() ? body.jobTitle.trim() : jobId,
                     jobId, hostId, projectPath, status: 'running', sessionId,
                     createdAt: now, updatedAt: now, messages: [],
                     events: [(0, hosts_1.createHubEvent)('system', `Resuming ${hostId} session ${sessionId} in ${projectPath}`)],
-                    currentPhase: null, phaseHistory: [], totals: emptyTotals(), lastStatusChangeAt: now,
+                    currentPhase: persistedRun?.currentPhase || null,
+                    phaseHistory: persistedRun?.phaseHistory || [],
+                    totals: persistedRun?.totals || emptyTotals(),
+                    lastStatusChangeAt: now,
+                    runDiscriminant: persistedRun?.runDiscriminant || undefined,
                     personaKey: getProtectedPersonaForHubJob(jobId),
                 };
                 // Continue-turn message (FRAIM invocation for the job + instructions) plus
@@ -2710,8 +2811,10 @@ class AiHubServer {
                             }
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -3139,8 +3242,10 @@ class AiHubServer {
                                 current.events.push((0, hosts_1.createHubEvent)(channel, event.raw));
                             if (event.agentIdentity)
                                 applyAgentIdentitySignal(current, event.agentIdentity);
+                            if (event.fraimJob)
+                                this.applyFraimJobSignalToRun(current, event.fraimJob);
                             if (event.seekMentoring)
-                                applySeekMentoringSignal(current, event.seekMentoring);
+                                this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                             if (event.usage)
                                 applyUsageSignal(current, event.usage);
                         });
@@ -3153,7 +3258,7 @@ class AiHubServer {
                         });
                         this.runRegistry.dispose(run.id);
                     },
-                }, run.sessionId);
+                }, startSessionSeedForHost(hostId, run.id));
                 // Update the registry entry with the real child process handle.
                 this.runRegistry.attachChildIfRunning(run.id, child);
                 return res.json({ runId: run.id, status: 'started', employee: employeeId, job: jobName });
@@ -3259,8 +3364,10 @@ class AiHubServer {
                     }
                     if (event.agentIdentity)
                         applyAgentIdentitySignal(current, event.agentIdentity);
+                    if (event.fraimJob)
+                        this.applyFraimJobSignalToRun(current, event.fraimJob);
                     if (event.seekMentoring)
-                        applySeekMentoringSignal(current, event.seekMentoring);
+                        this.applySeekMentoringSignalToRun(current, event.seekMentoring);
                     if (event.usage)
                         applyUsageSignal(current, event.usage);
                 });
@@ -3280,7 +3387,7 @@ class AiHubServer {
                 this.deploymentStore.update(deployment.id, (d) => { d.activeRunId = undefined; });
                 this.runRegistry.dispose(run.id);
             },
-        });
+        }, startSessionSeedForHost(deployment.hostId, run.id));
         this.runRegistry.create(run, child);
         this.deploymentStore.update(deployment.id, (d) => { d.activeRunId = run.id; });
         return run;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fraim",
-  "version": "2.0.185",
+  "version": "2.0.186",
   "description": "FRAIM CLI - Framework for Rigor-based AI Management (alias for fraim-framework)",
   "main": "index.js",
   "bin": {

package/public/ai-hub/script.js

@@ -16,6 +16,9 @@ const TREE_WIDTH_MAX = 380;
 const TREE_WIDTH_DEFAULT = 216;
 const PAGE_SCOPED_JOBS = new Set(['organization-onboarding', 'manager-agreements', 'project-onboarding', 'organizational-learning-synthesis']);
 // Jobs scoped to the Company/Manager area — never shown in the Projects workspace rail.
+// These are the truly area-only jobs. Issue #702: persona jobs (e.g. Ashley's) are NOT
+// listed here — a persona can run a job from a project OR from the Manager tab, and a
+// run's placement is decided per-invocation by conv.invokedArea, not by job id.
 const AREA_SCOPED_JOBS = new Set(['organization-onboarding', 'organizational-learning-synthesis', 'manager-agreements']);
 
 const state = {
@@ -509,9 +512,10 @@ async function bgRefreshConversations() {
         existing.push(conv);
         changed = true;
       } else {
-        // Update status/messages on known conversations (e.g. running → completed)
+        // Update known conversations when the server projection changes. This
+        // includes job/persona recognition for running ad-hoc jobs.
         const idx = existing.findIndex((c) => c.id === conv.id);
-        if (idx !== -1 && existing[idx].status !== conv.status) {
+        if (idx !== -1 && conversationProjectionChanged(existing[idx], conv)) {
           existing[idx] = conv;
           changed = true;
         }
@@ -533,7 +537,7 @@ function stopBgConvPoll() {
   if (_bgConvPollHandle) { window.clearInterval(_bgConvPollHandle); _bgConvPollHandle = null; }
 }
 
-function needsConversationRefresh() {
+function needsDelegatedConversationRefresh() {
   const active = activeConversation();
   if (!active) return false;
   if (isManagedDelegationChild(active) && active.status === 'running') return true;
@@ -548,12 +552,49 @@ function needsConversationRefresh() {
   });
 }
 
+function needsConversationRefresh() {
+  return runningProjectConversations().length > 0 || needsDelegatedConversationRefresh();
+}
+
+async function refreshRunningConversations() {
+  const running = runningProjectConversations();
+  if (!running.length) return false;
+  let changed = false;
+  for (const conv of running) {
+    try {
+      const run = await requestJson(`/api/ai-hub/runs/${encodeURIComponent(conv.runId)}`);
+      foldRunIntoConversation(conv, run);
+      upsertConversation(conv);
+      changed = true;
+    } catch (_) {
+      // The run may have just completed and left the in-memory registry before
+      // the conversation store hydrated. The next conversation refresh catches it.
+    }
+  }
+  if (changed) {
+    renderRail();
+    renderActive();
+    if (tf.area === 'company') tfRenderCompany();
+    else if (tf.area === 'manager') tfRenderManager();
+  }
+  return changed;
+}
+
+async function refreshConversationProjections() {
+  await refreshRunningConversations();
+  if (needsDelegatedConversationRefresh()) {
+    await hydrateConversationsFromServer();
+  } else {
+    syncConversationRefreshPolling();
+  }
+}
+
 function syncConversationRefreshPolling() {
   const shouldPoll = needsConversationRefresh();
   if (shouldPoll && !state.conversationRefreshHandle) {
     state.conversationRefreshHandle = window.setInterval(() => {
-      hydrateConversationsFromServer().catch((error) =>
-        console.warn('Could not refresh delegated conversations:', error));
+      refreshConversationProjections().catch((error) =>
+        console.warn('Could not refresh conversations:', error));
     }, 1500);
   } else if (!shouldPoll && state.conversationRefreshHandle) {
     window.clearInterval(state.conversationRefreshHandle);
@@ -578,6 +619,32 @@ function projectConversations() {
   return state.conversations[key] || [];
 }
 
+function conversationProjectionChanged(existing, incoming) {
+  if (!existing || !incoming) return true;
+  const fields = [
+    'jobId',
+    'jobTitle',
+    'personaKey',
+    'runId',
+    'sessionId',
+    'status',
+    'managedReviewStatus',
+    'compareRunId',
+    'sourceTrigger',
+  ];
+  if (fields.some((field) => (existing[field] ?? null) !== (incoming[field] ?? null))) return true;
+  const existingMessages = Array.isArray(existing.messages) ? existing.messages.length : 0;
+  const incomingMessages = Array.isArray(incoming.messages) ? incoming.messages.length : 0;
+  if (existingMessages !== incomingMessages) return true;
+  const existingEvents = Array.isArray(existing.events) ? existing.events.length : 0;
+  const incomingEvents = Array.isArray(incoming.events) ? incoming.events.length : 0;
+  return existingEvents !== incomingEvents;
+}
+
+function runningProjectConversations() {
+  return projectConversations().filter((conv) => conv && conv.status === 'running' && conv.runId);
+}
+
 function setProjectConversations(list) {
   const key = state.projectPath || '';
   state.conversations[key] = list;
@@ -854,7 +921,9 @@ function renderRail() {
   const list = allProjectConversations.filter((conv) =>
     (!state.selectedPersonaKey || conv.personaKey === state.selectedPersonaKey) &&
     !isManagedDelegationChild(conv) &&
-    !AREA_SCOPED_JOBS.has(conv.jobId)
+    !AREA_SCOPED_JOBS.has(conv.jobId) &&
+    // #702: runs invoked from the Manager/Company tab surface there, not in a project.
+    conv.invokedArea !== 'manager' && conv.invokedArea !== 'company'
   );
 
   // Issue #550: Two-path routing for ad-hoc (freeform) conversations.
@@ -2034,11 +2103,29 @@ function renderTracker(conv) {
 
   const stages = Array.isArray(conv.run.stages) ? conv.run.stages : [];
   if (stages.length === 0) {
-    tracker.hidden = true;
+    // Issue #711 — adhoc runs (jobId '__freeform__') declare no phases, so
+    // there is no pizza tracker. We still surface the run totals (tokens,
+    // cost, duration) that the server derives for every run. Keep the tracker
+    // container visible in "totals-only" mode so renderTotals has a place to
+    // render; otherwise hide the whole section.
+    if (conv.run.totals) {
+      tracker.hidden = false;
+      tracker.classList.add('tracker--totals-only');
+      tracker.classList.remove('tracker-compact');
+      const rowsHost = els['tracker-rows'];
+      if (rowsHost) rowsHost.innerHTML = '';
+      const activeLabel = tracker.querySelector('.tracker-active-label');
+      if (activeLabel) activeLabel.textContent = '';
+      const note = els['tracker-note'];
+      if (note) { note.hidden = true; note.textContent = ''; }
+    } else {
+      tracker.hidden = true;
+    }
     renderedTrackerKey = null;
     return;
   }
 
+  tracker.classList.remove('tracker--totals-only');
   tracker.hidden = false;
   tracker.dataset.stageCount = String(stages.length);
   const rowCapacity = trackerRowCapacity(tracker, stages);
@@ -4753,7 +4840,7 @@ function deriveTitle(jobTitle, instructions) {
 // The browser sends raw manager instructions. AI Hub normalizes assigned
 // FRAIM jobs into host-facing invocations so the Hub UI and channel callers
 // share one start/continue contract.
-async function startRun(job, instructions, employeeId, preassignedConvId) {
+async function startRun(job, instructions, employeeId, preassignedConvId, invokedArea) {
   const isFreeform = job.id === '__freeform__';
   // In task-pane/extension mode: get a fresh selection snapshot and prepend
   // document context to the instructions so the agent knows what the user is
@@ -4792,6 +4879,10 @@ async function startRun(job, instructions, employeeId, preassignedConvId) {
     compareRun: null,
     // Issue #489: capture selection state at job-start so write-back knows insert-after vs append.
     wordStartedWithSelection: document.body.dataset.surface === 'task-pane' && !!(state.wordContext && state.wordContext.hasSelection),
+    // Issue #702: remember which area this run was launched from so its run surfaces
+    // where it was invoked (project-invoked → that project; manager-invoked → Manager tab).
+    // Defaults to the current area.
+    invokedArea: invokedArea || (typeof tf !== 'undefined' && tf.area) || 'projects',
   };
   upsertConversation(conv);
   state.activeId = conv.id;
@@ -4958,6 +5049,18 @@ async function continueRun(text) {
 }
 
 function foldRunIntoConversation(conv, run) {
+  // Issue #710: server run identity is canonical. The browser may have
+  // created this conversation as provisional __freeform__ state, but every
+  // server snapshot can promote it to a real catalog job.
+  if (run.jobId) {
+    conv.jobId = run.jobId;
+  }
+  if (run.jobTitle !== undefined && run.jobTitle !== null) {
+    conv.jobTitle = run.jobTitle;
+  }
+  if (run.personaKey !== undefined) {
+    conv.personaKey = run.personaKey;
+  }
   // Issue #347: keep the latest server snapshot under conv.run so the
   // tracker / totals renderers can read it without re-doing work. Stages,
   // currentPhase, phaseHistory, and totals are all server-derived per
@@ -4967,6 +5070,7 @@ function foldRunIntoConversation(conv, run) {
     currentPhase: run.currentPhase || null,
     phaseHistory: run.phaseHistory || [],
     totals: run.totals || null,
+    runDiscriminant: run.runDiscriminant || null,
   };
   // Replace the conversation's events with the run's events (single source of truth on the server).
   // If this conversation was restarted on a different agent, prepend the prior run's events so
@@ -4984,10 +5088,6 @@ function foldRunIntoConversation(conv, run) {
   conv.messages = priorMessages.length > 0 ? [...priorMessages, ...newMessages] : newMessages;
   // Track session for resumption.
   if (run.sessionId) conv.sessionId = run.sessionId;
-  // R4: persist the persona key from the server-side run record.
-  if (run.personaKey !== undefined && conv.personaKey == null) {
-    conv.personaKey = run.personaKey;
-  }
   const runHandoff = normalizeReviewHandoff(run.reviewHandoff);
   if (runHandoff) {
     conv.reviewHandoff = runHandoff;
@@ -6233,11 +6333,18 @@ function tfConvForAssignment(assignment) {
 function tfConversationsForJob(jobId, opts) {
   const out = [];
   const projectPath = opts && opts.projectPath;
+  // #702: optional invokedArea filter so the Manager rail shows only manager-invoked
+  // runs of a persona job (project-invoked runs of the same job stay in the project).
+  const invokedArea = opts && opts.invokedArea;
   const lists = projectPath
     ? [state.conversations[projectPath] || []]
     : Object.values(state.conversations || {});
   for (const list of lists) {
-    for (const c of (list || [])) if (c && c.jobId === jobId) out.push(c);
+    for (const c of (list || [])) {
+      if (!c || c.jobId !== jobId) continue;
+      if (invokedArea && (c.invokedArea || 'projects') !== invokedArea) continue;
+      out.push(c);
+    }
   }
   out.sort((a, b) => (b.updatedAt || b.createdAt || 0) - (a.updatedAt || a.createdAt || 0));
   return out;
@@ -8009,10 +8116,12 @@ function tfActiveOrgConv() {
   );
 }
 
-// #594 R2: return the org-scoped manager-agreements conversation to show in Manager area.
+// #594 R2: return the manager-scoped conversation to show in Manager area.
+// #702: manager-tab runs are those invoked from the manager area (any persona job),
+// plus the area-only manager-agreements job (older runs predate invokedArea). An active
+// manager-invoked run surfaces in the Manager conversation host (Coach panel included).
 function tfActiveMgrConv() {
-  const mgrJobs = new Set(['manager-agreements']);
-  const convs = Object.values(state.conversations || {}).flat().filter((c) => mgrJobs.has(c.jobId));
+  const convs = Object.values(state.conversations || {}).flat().filter((c) => c && (c.invokedArea === 'manager' || c.jobId === 'manager-agreements'));
   return (
     convs.find((c) => c.status === 'running') ||
     convs.find((c) => c.status === 'waiting') ||
@@ -8021,6 +8130,93 @@ function tfActiveMgrConv() {
   );
 }
 
+// #702: is a persona hired (has a company seat) so its manager-tab jobs should show?
+// (MANAGER_ASHLEY_JOBS is defined once at the top of this file as the single source of truth.)
+function tfIsPersonaHired(personaKey) {
+  const personas = (state.bootstrap && state.bootstrap.personas) || [];
+  const p = personas.find((x) => x && x.key === personaKey);
+  return !!(p && (p.status === 'hired' || (p.seatCount || 0) > 0));
+}
+
+// #702: launch a persona job from the Manager tab. Reuses the area pre-flight modal +
+// run routing (targetArea 'manager'), so the run opens in #manager-conv-host with the
+// Coach panel and is tagged invokedArea='manager' — exactly like manager-agreements.
+function tfStartManagerPersonaJob(jobId) {
+  tfOpenAreaOnboardModal(jobId, 'Run ' + jobId + ' across the projects I manage and my calendar.', 'manager');
+}
+
+// #702: run-item button matching the Projects rail (conv-item), for the manager
+// employee group. Mirrors the core of renderRail's buildRunButton so runs look
+// identical on both tabs.
+function tfBuildManagerRunItem(conv) {
+  const btn = document.createElement('button');
+  btn.className = 'conv-item';
+  btn.type = 'button';
+  btn.dataset.conv = conv.id;
+  const body = document.createElement('span'); body.className = 'conv-body';
+  const title = document.createElement('span'); title.className = 'conv-title';
+  title.textContent = conv.title || conv.jobTitle || conv.jobId || 'Run';
+  body.appendChild(title); btn.appendChild(body);
+  const dotClass = conversationStateDotClass(conv);
+  const dot = document.createElement('span'); dot.className = 'state-dot conv-state-dot dot-' + dotClass;
+  if (typeof tfDotTitle === 'function') dot.title = tfDotTitle(dotClass);
+  btn.appendChild(dot);
+  const status = document.createElement('span'); status.className = 'conv-status';
+  status.textContent = conversationStateLabel(conv);
+  status.classList.add(conversationUiState(conv));
+  btn.appendChild(status);
+  tfAttachRunDelete(btn, conv, { tree: false });
+  btn.addEventListener('click', () => switchToConversation(conv.id));
+  return btn;
+}
+
+// #702: render a hired persona as an employee group on the Manager rail — the SAME
+// visual as the Projects rail employee groups (avatar + name + role + count + "+" that
+// opens the job palette), with the persona's MANAGER-invoked runs listed under it.
+// Keeps a persona looking like an employee, consistent across tabs.
+function tfRenderManagerPersonaGroup(rail, persona) {
+  const sample = { personaKey: persona.key };
+  const runs = Object.values(state.conversations || {}).flat()
+    .filter((c) => c && c.personaKey === persona.key && c.invokedArea === 'manager')
+    .sort((a, b) => (b.lastUpdatedAt || 0) - (a.lastUpdatedAt || 0));
+  const details = document.createElement('details');
+  details.className = 'conv-employee-group';
+  details.open = true;
+  const summary = document.createElement('summary');
+  summary.className = 'conv-employee-tab';
+  const avatar = buildConversationEmployeeAvatar(sample, 'conv-employee-avatar');
+  const copy = document.createElement('span'); copy.className = 'conv-employee-tab-copy';
+  const label = document.createElement('strong'); label.className = 'conv-employee-tab-label';
+  label.textContent = persona.displayName || persona.key;
+  const detail = document.createElement('small'); detail.className = 'conv-employee-tab-detail';
+  detail.textContent = persona.role || 'AI Employee';
+  copy.appendChild(label); copy.appendChild(detail);
+  const addBtn = document.createElement('button'); addBtn.type = 'button'; addBtn.className = 'conv-employee-add';
+  addBtn.textContent = '+';
+  addBtn.title = 'Launch a job for ' + (persona.displayName || persona.key);
+  addBtn.setAttribute('aria-label', 'Launch a job for ' + (persona.displayName || persona.key));
+  addBtn.addEventListener('click', (e) => {
+    e.preventDefault(); e.stopPropagation();
+    // Launch from the Manager tab: palette prefiltered to this persona. Runs started
+    // while the manager tab is active default to invokedArea='manager'.
+    openPalette({ employeeId: (state.bootstrap && state.bootstrap.preferences && state.bootstrap.preferences.employeeId) || 'claude', prefixSearch: '/' + persona.key });
+  });
+  const count = document.createElement('span'); count.className = 'conv-employee-tab-count';
+  count.textContent = String(runs.length);
+  summary.appendChild(avatar); summary.appendChild(copy); summary.appendChild(addBtn); summary.appendChild(count);
+  details.appendChild(summary);
+  const listDiv = document.createElement('div'); listDiv.className = 'conv-employee-list';
+  if (!runs.length) {
+    const hint = document.createElement('div'); hint.className = 'eh-empty';
+    hint.textContent = 'No runs yet — + to launch a job.';
+    listDiv.appendChild(hint);
+  } else {
+    for (const c of runs) listDiv.appendChild(tfBuildManagerRunItem(c));
+  }
+  details.appendChild(listDiv);
+  rail.appendChild(details);
+}
+
 // Move the shared .page conversation panel into the specified area's workspace-conv host.
 // All .workspace-conv CSS rules (header/rail hidden, conv fills space) apply automatically
 // because the area-conv-host elements carry the workspace-conv class.
@@ -8216,6 +8412,30 @@ function tfRenderManager() {
     rail.appendChild(infoBtn);
     // #693 R1 (PR round 2): the "Manager jobs" launcher list is retired.
     // Manager agreements now runs from the "Context & rules" section it populates.
+    // Issue #702: for each hired persona with catalog jobs, render an EMPLOYEE GROUP on
+    // the Manager rail — the same avatar + name + runs + "+" presentation as the Projects
+    // rail (tfRenderManagerPersonaGroup reuses conv-employee-group), so a persona looks
+    // identical on both tabs. Data-driven from bootstrap job metadata (job.requiredPersonaKey),
+    // not a hardcoded list. Runs launched here are tagged invokedArea='manager'; the same
+    // employee's job launched inside a project stays in that project.
+    const mgrPersonas = (state.bootstrap && state.bootstrap.personas) || [];
+    const catalogJobs = (state.bootstrap && state.bootstrap.jobs) || [];
+    let anyMgrEmployee = false;
+    for (const persona of mgrPersonas) {
+      if (!tfIsPersonaHired(persona.key)) continue;
+      if (!catalogJobs.some((j) => j && j.requiredPersonaKey === persona.key)) continue;
+      if (!anyMgrEmployee) {
+        const head = document.createElement('div'); head.className = 'area-rail-head'; head.textContent = 'Your employees';
+        rail.appendChild(head);
+        anyMgrEmployee = true;
+      }
+      tfRenderManagerPersonaGroup(rail, persona);
+    }
+    if (anyMgrEmployee) {
+      const pNote = document.createElement('div'); pNote.className = 'area-rail-note';
+      pNote.textContent = "These employees work across every project you manage. Launch a job here (＋) for cross-project work — its run stays on this tab; the same employee's job launched inside a project stays there. Coach and verify like any employee.";
+      rail.appendChild(pNote);
+    }
   }
   const profile = document.getElementById('manager-profile');
   const learn = document.getElementById('manager-learnings');
@@ -8847,6 +9067,15 @@ const AREA_ONBOARD_CONFIG = {
     title: 'Manager agreements',
     desc: 'FRAIM will learn how you work and write manager_context.md and manager_rules.md. Add any specific direction below.',
   },
+  // Issue #702: Ashley's manager-tab jobs.
+  'executive-assistant': {
+    title: 'Ashley — what needs you today',
+    desc: "Ashley reviews the projects you manage plus your calendar and briefs you on what needs your attention. Add any specific focus below.",
+  },
+  'weekly-operating-review': {
+    title: 'Ashley — weekly operating review',
+    desc: 'Ashley produces your weekly portfolio operating brief. Add any specific focus areas below.',
+  },
 };
 
 function tfOpenAreaOnboardModal(jobId, baseMessage, area) {
@@ -8892,7 +9121,7 @@ async function tfStartOnboardingJob(jobId, message, targetArea, userContext) {
   const finalMessage = (userContext && userContext.trim()) ? userContext.trim() : jobMessage;
   if (job && typeof startRun === 'function') {
     if (targetArea) tfShowArea(targetArea);
-    await startRun(job, finalMessage, employeeId);
+    await startRun(job, finalMessage, employeeId, undefined, targetArea);
     // After run creation refresh the area panel so the conversation becomes visible.
     if (targetArea === 'company') tfRenderCompany();
     else if (targetArea === 'manager') tfRenderManager();

package/public/ai-hub/styles.css

@@ -2157,6 +2157,17 @@ button.small { padding: 4px 10px; font-size: 12px; }
 .totals .sep { color: var(--line); }
 .totals strong { color: var(--text); font-weight: 600; }
 
+/* Issue #711 — adhoc runs have no pizza tracker; render the run totals line on
+   its own without the empty stage rows or a redundant top divider. */
+.tracker--totals-only {
+  padding: 10px 4px;
+}
+.tracker--totals-only .totals {
+  border-top: none;
+  padding-top: 0;
+  margin-top: 0;
+}
+
 
 /* ── Issue #385: Team roster, Employee selector, Lock badges, Hire notice ── */