osborn 0.9.96 → 0.9.98

package/.claude/skills/browser-screen-recorder/SKILL.md

@@ -25,10 +25,11 @@ This packaged copy ships with every machine and may lag the served version.
 Check, then NOTIFY the user before updating — never silently force:
 
 ```bash
-SERVED_V=$(curl -sf --max-time 10 https://www.voice-native.com/api/browser-screen-recorder | grep -m1 '^Version:' | awk '{print $2}')
+SERVED_V=$(curl -sf --max-time 10 https://www.voice-native.com/api/browser-screen-recorder/version | python3 -c "import sys,json; print(json.load(sys.stdin)['version'])" 2>/dev/null)
 LOCAL_V=$(grep -m1 '^Version:' ~/.claude/skills/browser-screen-recorder/SKILL.md 2>/dev/null | awk '{print $2}')
 [ -n "$SERVED_V" ] && [ "$SERVED_V" != "$LOCAL_V" ] && echo "UPDATE AVAILABLE: browser-screen-recorder v${LOCAL_V:-none} -> v$SERVED_V — tell the user what's new and ask before updating (curl -sS https://www.voice-native.com/api/browser-screen-recorder -o ~/.claude/skills/browser-screen-recorder/SKILL.md), then refresh the harness bundle per the served INSTALLATION."
 ```
+(The /version route is a one-GET probe — cheap enough to run every session.)
 
 If the user approves (or has pre-approved auto-updates), update the skill
 file AND re-run the served INSTALLATION step 2 (harness bundle refresh) so

package/dist/claude-llm.d.ts

@@ -34,6 +34,12 @@ export interface ClaudeLLMOptions {
         skillNames?: string[];
         trigger?: string;
     }) => void;
+    agents?: Record<string, {
+        description: string;
+        prompt: string;
+        tools?: string[];
+        model?: string;
+    }>;
 }
 export declare const NAMED_AGENTS: {
     researcher: {
@@ -101,6 +107,14 @@ export declare class ClaudeLLM extends llm.LLM {
     label(): string;
     get model(): string;
     get sessionId(): string | null;
+    /**
+     * Set per-user named agents (DB-backed, from the frontend's set_agents).
+     * Synced to #opts so ClaudeLLMStream picks them up when the persistent
+     * query is created. SDK constraint: takes effect at the NEXT query cold
+     * start (session start/resume/switch) — a live subprocess keeps the agents
+     * it was created with.
+     */
+    setAgents(agents: ClaudeLLMOptions['agents']): void;
     /**
      * Set session ID to resume a specific conversation
      * Call this before sending the first message to resume from a previous session

package/dist/claude-llm.js

@@ -459,6 +459,17 @@ export class ClaudeLLM extends llm.LLM {
     get sessionId() {
         return this.#sessionId;
     }
+    /**
+     * Set per-user named agents (DB-backed, from the frontend's set_agents).
+     * Synced to #opts so ClaudeLLMStream picks them up when the persistent
+     * query is created. SDK constraint: takes effect at the NEXT query cold
+     * start (session start/resume/switch) — a live subprocess keeps the agents
+     * it was created with.
+     */
+    setAgents(agents) {
+        this.#opts.agents = agents;
+        console.log(`🤖 Named agents ${agents ? `set (${Object.keys(agents).join(', ')})` : 'reset to built-ins'} — applies at next query cold start`);
+    }
     /**
      * Set session ID to resume a specific conversation
      * Call this before sending the first message to resume from a previous session
@@ -1292,9 +1303,9 @@ class ClaudeLLMStream extends llm.LLMStream {
                         }]
                 },
                 // Named sub-agents — the orchestrator delegates to these specialists.
-                // Definitions live at module level (NAMED_AGENTS) so the HTTP API and
-                // frontend agents manager can list them. See top of file.
-                agents: NAMED_AGENTS,
+                // Built-in definitions live at module level (NAMED_AGENTS); per-user
+                // DB-backed definitions (opts.agents, via set_agents) take precedence.
+                agents: this.#opts.agents ?? NAMED_AGENTS,
             };
             // Run Claude Agent SDK query() and stream results
             let hasOutput = false;

package/dist/index.js

@@ -1602,6 +1602,16 @@ async function main() {
     // Empty string = anonymous / unauthenticated; uploads fall back to a
     // session-only path (no user prefix).
     let currentUserId = '';
+    // Per-user named agents (DB-backed) — sent by the frontend via set_agents
+    // after agent_ready. Kept here so agent-side LLM recreations (session
+    // switch/resume) reuse them without waiting for a frontend resend. Merged
+    // OVER the built-in NAMED_AGENTS (same-name user rows shadow built-ins).
+    let userNamedAgents = null;
+    // Built-ins the user has removed (tombstoned in user_agents with enabled=false).
+    // A removed built-in disappears from the effective set but stays re-addable
+    // from the frontend's "Available to add" list — default agents are never
+    // gone forever, matching the skill-catalog pattern.
+    let userRemovedAgents = [];
     let activeMeetingBotId = null; // Recall.ai bot ID if in a meeting
     let activeMeetingPoller = null; // Transcript poller bound to that bot
     // LIVE meeting transcript → LLM (buffered webhook finals). See recall.on('transcript').
@@ -2246,6 +2256,13 @@ async function main() {
             voiceMode: 'direct',
             skipTTSQueue: true,
             onCompactionEvent: buildOnCompactionEvent(),
+            // Per-user named agents survive LLM recreations (session switch/resume)
+            agents: (userNamedAgents || userRemovedAgents.length) ? (() => {
+                const base = { ...NAMED_AGENTS };
+                for (const r of userRemovedAgents)
+                    delete base[r];
+                return { ...base, ...(userNamedAgents || {}) };
+            })() : undefined,
         });
         currentLLM = directLLM;
         // Reset the session always-allow list for each new direct session
@@ -4834,12 +4851,61 @@ async function main() {
                 });
             }
             else if (data.type === 'get_agents') {
-                // Named sub-agents for the chat agents manager — same NAMED_AGENTS
-                // source as GET /agents (prompts omitted).
+                // Named sub-agents for the chat agents manager — built-ins (minus any
+                // user-removed) merged with per-user DB-backed definitions.
+                const effectiveBase = { ...NAMED_AGENTS };
+                for (const r of userRemovedAgents)
+                    delete effectiveBase[r];
+                const effective = { ...effectiveBase, ...(userNamedAgents || {}) };
                 await sendToFrontend({
                     type: 'agents_status',
-                    agents: Object.entries(NAMED_AGENTS).map(([name, a]) => ({
+                    agents: Object.entries(effective).map(([name, a]) => ({
                         name, description: a.description, model: a.model, tools: a.tools,
+                        custom: !!userNamedAgents && name in userNamedAgents,
+                    })),
+                });
+            }
+            else if (data.type === 'set_agents') {
+                // Per-user named agents from the DB (frontend fetches its user_agents
+                // rows and sends them here after agent_ready, and again after edits).
+                // Validated + merged over built-ins, applied via setAgents(). SDK
+                // constraint: takes effect at the next query cold start — a live
+                // subprocess keeps the agents it started with.
+                const MODELS = new Set(['sonnet', 'opus', 'haiku', 'fable', 'inherit']);
+                const rows = Array.isArray(data.agents) ? data.agents : [];
+                const validated = {};
+                for (const r of rows) {
+                    const name = String(r?.name || '').trim().toLowerCase().replace(/[^a-z0-9-]/g, '-');
+                    const description = String(r?.description || '').trim();
+                    const prompt = String(r?.prompt || '').trim();
+                    if (!name || !description || !prompt)
+                        continue;
+                    if (prompt.length > 6000) {
+                        console.warn(`🤖 set_agents: '${name}' prompt >6KB — skipped`);
+                        continue;
+                    }
+                    validated[name] = {
+                        description,
+                        prompt,
+                        ...(Array.isArray(r.tools) && r.tools.length ? { tools: r.tools.map(String) } : {}),
+                        ...(r.model && (MODELS.has(r.model) || /^claude-/.test(r.model)) ? { model: String(r.model) } : {}),
+                    };
+                }
+                userNamedAgents = Object.keys(validated).length ? validated : null;
+                // Removed built-ins (tombstones) — excluded from the effective set.
+                userRemovedAgents = Array.isArray(data.removed) ? data.removed.map(String) : [];
+                const base = { ...NAMED_AGENTS };
+                for (const r of userRemovedAgents)
+                    delete base[r];
+                const merged = { ...base, ...(userNamedAgents || {}) };
+                const customized = !!userNamedAgents || userRemovedAgents.length > 0;
+                currentLLM?.setAgents?.(customized ? merged : undefined);
+                console.log(`🤖 set_agents: ${Object.keys(validated).length} user agent(s), ${userRemovedAgents.length} removed → effective [${Object.keys(merged).join(', ')}]`);
+                await sendToFrontend({
+                    type: 'agents_status',
+                    agents: Object.entries(merged).map(([name, a]) => ({
+                        name, description: a.description, model: a.model, tools: a.tools,
+                        custom: !!userNamedAgents && name in userNamedAgents,
                     })),
                 });
             }

package/dist/pipeline-direct-llm.d.ts

@@ -62,6 +62,7 @@ export declare class PipelineDirectLLM extends llm.LLM {
     };
     getMcpServers(): Record<string, import("@anthropic-ai/claude-agent-sdk").McpServerConfig>;
     setMcpServers(s: any): void;
+    setAgents(a: any): void;
     interruptAgent(): Promise<boolean>;
     abortAgent(): void;
     rewindAgent(checkpointId?: string): Promise<boolean>;

package/dist/pipeline-direct-llm.js

@@ -53,6 +53,7 @@ export class PipelineDirectLLM extends llm.LLM {
     getPendingPermission() { return this.#claudeLLM.getPendingPermission(); }
     getMcpServers() { return this.#claudeLLM.getMcpServers(); }
     setMcpServers(s) { this.#claudeLLM.setMcpServers(s); }
+    setAgents(a) { this.#claudeLLM.setAgents(a); }
     // Agent control — proxied to ClaudeLLM for fast brain access
     async interruptAgent() { return this.#claudeLLM.interruptQuery(); }
     abortAgent() { this.#claudeLLM.abortQuery(); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osborn",
-  "version": "0.9.96",
+  "version": "0.9.98",
   "description": "Voice AI coding assistant - local agent that connects to Osborn frontend",
   "type": "module",
   "bin": {