fraim-hub 2.0.229 → 2.0.232

package/dist/src/ai-hub/custom-employees.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readCustomEmployees = readCustomEmployees;
+exports.writeCustomEmployee = writeCustomEmployee;
+exports.deleteCustomEmployee = deleteCustomEmployee;
+exports.slugifyDisplayName = slugifyDisplayName;
+exports.resolveEmployee = resolveEmployee;
+exports.buildCustomEmployeePersona = buildCustomEmployeePersona;
+// Issue #945: read/write store for user-authored employees, slug utilities,
+// and the display/attribution resolver union.
+//
+// INVARIANT: resolveEmployee is only for display and run attribution.
+// Entitlement reads (isPersonaHireKey, getProtectedPersonaForJob,
+// evaluatePersonaAccess) must never call resolveEmployee.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const persona_hiring_1 = require("../config/persona-hiring");
+const EMPLOYEES_DIR_REL = path_1.default.join('fraim', 'personalized-employee', 'employees');
+function employeesDir(projectDir) {
+    return path_1.default.join(projectDir, EMPLOYEES_DIR_REL);
+}
+function slugFor(key) {
+    // key is 'custom:<slug>' — file is named '<slug>.json'
+    return key.replace(/^custom:/, '');
+}
+function safeSlug(key) {
+    // Reject keys whose slug component contains path separators or traversal sequences.
+    const slug = slugFor(key);
+    if (!slug || /[/\\]|\.\./.test(slug))
+        return null;
+    return slug;
+}
+function filePath(projectDir, key) {
+    const slug = safeSlug(key);
+    if (!slug)
+        return null;
+    return path_1.default.join(employeesDir(projectDir), `${slug}.json`);
+}
+function readCustomEmployees(projectDir) {
+    const dir = employeesDir(projectDir);
+    if (!fs_1.default.existsSync(dir))
+        return [];
+    const results = [];
+    for (const file of fs_1.default.readdirSync(dir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        try {
+            const raw = fs_1.default.readFileSync(path_1.default.join(dir, file), 'utf8');
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed.key === 'string' && parsed.key.startsWith('custom:')) {
+                results.push(parsed);
+            }
+        }
+        catch {
+            // silently skip malformed files
+        }
+    }
+    return results;
+}
+function writeCustomEmployee(projectDir, employee) {
+    const fp = filePath(projectDir, employee.key);
+    if (!fp)
+        throw new Error(`Invalid employee key: ${employee.key}`);
+    const dir = employeesDir(projectDir);
+    fs_1.default.mkdirSync(dir, { recursive: true });
+    fs_1.default.writeFileSync(fp, JSON.stringify(employee, null, 2), 'utf8');
+}
+function deleteCustomEmployee(projectDir, key) {
+    const fp = filePath(projectDir, key);
+    if (!fp || !fs_1.default.existsSync(fp))
+        return false;
+    fs_1.default.unlinkSync(fp);
+    return true;
+}
+function slugifyDisplayName(displayName, existingKeys = []) {
+    const base = displayName
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        || 'employee';
+    let candidate = `custom:${base}`;
+    if (!existingKeys.includes(candidate))
+        return candidate;
+    let i = 2;
+    while (existingKeys.includes(`${candidate}-${i}`))
+        i++;
+    return `${candidate}-${i}`;
+}
+function resolveEmployee(key, customEmployees) {
+    // Custom: key starts with 'custom:'
+    if (key.startsWith('custom:')) {
+        const emp = customEmployees.find((e) => e.key === key);
+        if (!emp)
+            return null;
+        return {
+            key: emp.key,
+            displayName: emp.displayName,
+            role: emp.role,
+            avatarUrl: buildCustomAvatarUrl(emp),
+            origin: 'custom',
+        };
+    }
+    // Catalog
+    if ((0, persona_hiring_1.isPersonaHireKey)(key)) {
+        const entry = persona_hiring_1.PERSONA_HIRE_CATALOG[key];
+        return {
+            key,
+            displayName: entry.displayName,
+            role: entry.role,
+            avatarUrl: (0, persona_hiring_1.buildPersonaAvatarUrl)(key),
+            origin: 'catalog',
+        };
+    }
+    return null;
+}
+// Converts a CustomEmployee to an AiHubPersona for bootstrap / rail rendering.
+// status is always 'hired' (no lock on custom employees); no hireUrl; no seat accounting.
+// jobIds is included so the UI can scope the delegate picker without a second fetch.
+function buildCustomEmployeePersona(emp) {
+    return {
+        key: emp.key,
+        displayName: emp.displayName,
+        role: emp.role,
+        avatarUrl: buildCustomAvatarUrl(emp),
+        pricingLabel: '',
+        status: 'hired',
+        hireUrl: '',
+        seatCount: 0,
+        seatsInUse: 0,
+        origin: 'custom',
+        jobIds: emp.jobIds,
+    };
+}
+// Builds an avatar URL for a custom employee.
+// - 'emoji': renders a simple letter-based DiceBear avatar seeded on the display name
+// - 'generated': uses the value as the DiceBear seed directly
+// - 'image': returns an empty string (image upload is deferred; caller falls back to icon)
+function buildCustomAvatarUrl(emp) {
+    const { icon, displayName } = emp;
+    if (icon.kind === 'image')
+        return '';
+    const seed = icon.kind === 'generated' ? icon.value : displayName;
+    const params = new URLSearchParams({ seed, backgroundColor: 'e0e7ff', radius: '50' });
+    return `https://api.dicebear.com/9.x/notionists/svg?${params.toString()}`;
+}

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

@@ -58,10 +58,8 @@ function parseSeekMentoringSignal(line) {
         typeof obj.item === 'object' && obj.item !== null) {
         const item = obj.item;
         const itemType = item.type;
-        const tool = typeof item.tool === 'string' ? item.tool : null;
-        if (itemType === 'mcp_tool_call' &&
-            (tool === 'seekMentoring' || tool === 'mcp__fraim__seekMentoring')) {
-            const args = item.arguments;
+        if (itemType === 'mcp_tool_call' && isFraimTool(item.tool, 'seekMentoring')) {
+            const args = normalizeToolArgs(item.arguments) || undefined;
             const sig = extractSignalFromArgs(args);
             if (sig)
                 return sig;
@@ -82,13 +80,9 @@ function parseSeekMentoringSignal(line) {
             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 : '');
-        const isSeekMentoring = nameField === 'seekMentoring' ||
-            nameField === 'mcp__fraim__seekMentoring' ||
-            nameField.endsWith('seekMentoring');
-        if (!isToolUse || !isSeekMentoring)
+        if (!isToolUse || !isFraimTool(readToolName(c), 'seekMentoring'))
             continue;
-        const input = (c.input || c.arguments || c.parameters);
+        const input = normalizeToolArgs(c.input || c.arguments || c.parameters) || undefined;
         const sig = extractSignalFromArgs(input);
         if (sig)
             return sig;
@@ -116,8 +110,7 @@ function parseFraimJobLoadSignal(line) {
     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)) {
+        if (item.type === 'mcp_tool_call' && isFraimTool(item.tool, 'get_fraim_job')) {
             const sig = readFraimJobFromArgs(item.arguments);
             if (sig)
                 return sig;
@@ -138,8 +131,7 @@ function parseFraimJobLoadSignal(line) {
             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))
+        if (!isToolUse || !isFraimTool(readToolName(c), 'get_fraim_job'))
             continue;
         const sig = readFraimJobFromArgs(c.input || c.arguments || c.parameters);
         if (sig)
@@ -276,8 +268,8 @@ function parseAgentIdentitySignal(line) {
     // Codex shape.
     if ((obj.type === 'item.started' || obj.type === 'item.completed') && typeof obj.item === 'object' && obj.item !== null) {
         const item = obj.item;
-        if (item.type === 'mcp_tool_call' && item.tool === 'fraim_connect') {
-            return readAgentFromArgs(item.arguments);
+        if (item.type === 'mcp_tool_call' && isFraimTool(item.tool, 'fraim_connect')) {
+            return readAgentFromArgs(normalizeToolArgs(item.arguments) || undefined);
         }
     }
     // Claude Code shape.
@@ -293,10 +285,9 @@ function parseAgentIdentitySignal(line) {
         const c = candidate;
         if (c.type !== 'tool_use' && c.type !== 'function_call')
             continue;
-        const name = typeof c.name === 'string' ? c.name : '';
-        if (!name.endsWith('fraim_connect'))
+        if (!isFraimTool(readToolName(c), 'fraim_connect'))
             continue;
-        const sig = readAgentFromArgs((c.input || c.arguments));
+        const sig = readAgentFromArgs(normalizeToolArgs(c.input || c.arguments || c.parameters) || undefined);
         if (sig)
             return sig;
     }
@@ -312,10 +303,31 @@ 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 readToolName(candidate) {
+    if (typeof candidate.name === 'string')
+        return candidate.name;
+    if (typeof candidate.tool_name === 'string')
+        return candidate.tool_name;
+    if (typeof candidate.tool === 'string')
+        return candidate.tool;
+    if (typeof candidate.function === 'object' && candidate.function !== null) {
+        const fn = candidate.function;
+        if (typeof fn.name === 'string')
+            return fn.name;
+    }
+    return null;
+}
+function canonicalToolName(rawName) {
+    if (typeof rawName !== 'string')
+        return null;
+    const trimmed = rawName.trim();
+    if (!trimmed)
+        return null;
+    const byDoubleUnderscore = trimmed.split('__').filter(Boolean).pop() || trimmed;
+    return byDoubleUnderscore.split(/[./:]/).filter(Boolean).pop() || null;
+}
+function isFraimTool(rawName, canonicalName) {
+    return canonicalToolName(rawName) === canonicalName;
 }
 function readFraimJobFromArgs(rawArgs) {
     const args = normalizeToolArgs(rawArgs);
@@ -683,12 +695,15 @@ const EMPLOYEE_LABELS = {
     claude: 'Claude Code',
     gemini: 'Gemini CLI',
     copilot: 'GitHub Copilot CLI',
+    antigravity: 'Antigravity CLI',
 };
 // GitHub Copilot CLI binary name after `npm install -g @github/copilot`.
 // The @github/copilot package installs a binary named `copilot` on PATH.
 // Note: the package name is @github/copilot (NOT @github/copilot-cli which
 // does not exist on npm). The binary is `copilot` (NOT `github-copilot-cli`).
 const COPILOT_BINARY = 'copilot';
+// Issue #928: agy has no npm package; installed via https://antigravity.google/cli/
+const AGY_BINARY = 'agy';
 const executableName = (command) => command;
 function quoteWindowsArg(value) {
     if (value.length === 0) {
@@ -721,6 +736,8 @@ const availableByVersionProbe = (command) => {
 function agentBinaryName(id) {
     if (id === 'copilot')
         return COPILOT_BINARY;
+    if (id === 'antigravity')
+        return AGY_BINARY;
     return executableName(id);
 }
 function detectEmployees() {
@@ -989,6 +1006,18 @@ function buildStartPlan(hostId, message, sessionId) {
             env: browser.env,
         };
     }
+    // Issue #928: agy (Antigravity CLI) is TUI-only — no subprocess/headless mode.
+    // supportsSubprocessStream:false is a capability flag for future Branch A
+    // (subprocess mode). Currently unused by spawnHostProcess; TUI output is
+    // handled gracefully by the antigravity branch in parseHostLine.
+    if (hostId === 'antigravity') {
+        return {
+            command: AGY_BINARY,
+            args: ['--dangerously-skip-permissions'],
+            stdin: transformHeadlessFraimMessage(message, 'start'),
+            supportsSubprocessStream: false,
+        };
+    }
     const browser = sharedBrowserHostConfig('claude');
     return {
         command: executableName('claude'),
@@ -1038,6 +1067,15 @@ function buildContinuePlan(hostId, sessionId, message) {
             env: browser.env,
         };
     }
+    // Issue #928: agy resume uses --conversation <sessionId>.
+    if (hostId === 'antigravity') {
+        return {
+            command: AGY_BINARY,
+            args: ['--dangerously-skip-permissions', '--conversation', sessionId],
+            stdin: transformHeadlessFraimMessage(message, 'continue'),
+            supportsSubprocessStream: false,
+        };
+    }
     const browser = sharedBrowserHostConfig('claude');
     return {
         command: executableName('claude'),
@@ -1097,6 +1135,14 @@ function buildDirectStartPlan(hostId, message, sessionId) {
             stdin: DIRECT_PREAMBLE + message,
         };
     }
+    if (hostId === 'antigravity') {
+        return {
+            command: AGY_BINARY,
+            args: ['--dangerously-skip-permissions'],
+            stdin: DIRECT_PREAMBLE + message,
+            supportsSubprocessStream: false,
+        };
+    }
     return {
         command: executableName('claude'),
         args: [
@@ -1204,6 +1250,11 @@ function parseHostLine(hostId, line) {
             return withSignal({ raw: trimmed });
         }
         catch {
+            // Issue #928: detect IneligibleTierError before other notice checks so
+            // the Hub can surface the Antigravity migration prompt.
+            if (trimmed.startsWith('IneligibleTierError')) {
+                return withSignal({ raw: trimmed, geminiDeprecated: true });
+            }
             if (isGeminiCliNotice(trimmed)) {
                 return withSignal({ raw: trimmed });
             }
@@ -1211,6 +1262,11 @@ function parseHostLine(hostId, line) {
             return withSignal(message ? { message, raw: trimmed } : { raw: trimmed });
         }
     }
+    // Issue #928: antigravity (agy) is TUI-only. Return raw for any line received;
+    // TUI output is not a structured event stream.
+    if (hostId === 'antigravity') {
+        return withSignal({ raw: trimmed });
+    }
     // GitHub Copilot CLI output: JSON stream where each event carries a `type`
     // field. Known event shapes (from the agentic CLI stream):
     //   { "type": "session.started", "session_id": "..." }  — session id
@@ -1441,6 +1497,7 @@ class FakeHostRuntime {
             { id: 'claude', label: 'Claude Code', available: true, detail: 'Test double employee.', supportsRaw: true },
             { id: 'gemini', label: 'Gemini CLI', available: true, detail: 'Test double employee.', supportsRaw: true },
             { id: 'copilot', label: 'GitHub Copilot CLI', available: true, detail: 'Test double agent tool.', supportsRaw: true },
+            { id: 'antigravity', label: 'Antigravity CLI', available: true, detail: 'Test double agent tool.', supportsRaw: false },
         ];
         // Remembered across turns like a resumed agent session: the job label from the
         // start turn. Issue #732 — a same-job continue no longer carries a /fraim <job>
@@ -1531,6 +1588,7 @@ class ScriptedHostRuntime {
             { id: 'claude', label: 'Claude Code', available: true, detail: 'Scripted test double.', supportsRaw: true },
             { 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 },
+            { id: 'antigravity', label: 'Antigravity CLI', available: true, detail: 'Scripted test double.', supportsRaw: false },
         ];
         // 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;

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

@@ -147,7 +147,7 @@ class AiHubPreferencesStore {
             const removedProjectPaths = normalizeRemovedProjectPaths(raw.removedProjectPaths);
             return {
                 projectPath: raw.projectPath || projectPath,
-                employeeId: (raw.employeeId === 'claude' || raw.employeeId === 'codex' || raw.employeeId === 'gemini' || raw.employeeId === 'copilot') ? raw.employeeId : DEFAULT_EMPLOYEE,
+                employeeId: (raw.employeeId === 'claude' || raw.employeeId === 'codex' || raw.employeeId === 'gemini' || raw.employeeId === 'copilot' || raw.employeeId === 'antigravity') ? raw.employeeId : DEFAULT_EMPLOYEE,
                 categoryId: typeof raw.categoryId === 'string' && raw.categoryId.length > 0 ? raw.categoryId : DEFAULT_CATEGORY,
                 recentJobIds: Array.isArray(raw.recentJobIds) ? raw.recentJobIds.filter((value) => typeof value === 'string') : [],
                 recentJobInstructions: (typeof raw.recentJobInstructions === 'object' && raw.recentJobInstructions !== null && !Array.isArray(raw.recentJobInstructions))