@jobshimo/browser-link 0.5.2 → 0.5.4

package/dist/tools/browser-dispatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-dispatch.js","sourceRoot":"","sources":["../../src/tools/browser-dispatch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browser-dispatch.js","sourceRoot":"","sources":["../../src/tools/browser-dispatch.ts"],"names":[],"mappings":"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"}

package/dist/tools/server-instructions.d.ts

@@ -1,3 +1,3 @@
 /** Usage protocol pushed to the MCP client on `initialize`. Plain string,
  * intentionally kept short. Edit here when the protocol changes. */
-export declare const SERVER_INSTRUCTIONS = "browser-link bridges Claude Code to the Chrome tabs the user has\nexplicitly connected through the companion extension, and ships a\npersistent UI map backed by a local SQLite DB. The data dir resolves\nper-OS via env-paths ($XDG_DATA_HOME/browser-link on Linux,\n~/Library/Application Support/browser-link on macOS, %APPDATA%/browser-link\non Windows). Override with $BROWSER_LINK_DATA_DIR. The map is private\nand per-machine; never persisted in any repo.\n\n## When operating on a tab\n\n1. Before doing anything on a tab whose URL you don't already know,\n   call `browser.map.recall` with { origin } (and optionally url) to load\n   selectors, flows and gotchas previously learned for that app.\n2. If recall returns entries with `failed_at` more recent than\n   `verified_at`, treat them as suspect: re-verify (snapshot / evaluate)\n   before reusing, or replace them.\n3. After every interaction that used a map entry, call\n   `browser.map.record_use` with { entry_id, ok }. ok=true updates\n   verified_at; ok=false updates failed_at. Keep the map honest.\n4. After a non-trivial flow that worked end-to-end, persist it with\n   `browser.map.save`. Three `kind` values:\n   - selector: { selector, evidence? } \u2014 a CSS selector tied to a purpose.\n   - flow: { steps: [...] } \u2014 an ordered list of actions to reach an outcome.\n   - gotcha: { body } \u2014 free-form note about something non-obvious.\n   Use `url_pattern` = pathname (exact). Promote to glob only if you have\n   evidence of a parametric route. Provide `purpose` as a stable, reusable\n   label (\"open task detail dialog\", not \"open IB0311 detail\").\n5. Never save selectors or flows you have not just successfully executed.\n6. Never store domain data (IDs, user names, dates, etc.). The map captures\n   UI structure only.\n\n## Identifying the app\n\n- `origin` = scheme://host:port of the tab.\n- `app_key` distinguishes apps that share an origin over time. On first\n  save you may omit it; it will be derived from the page title (slugified).\n  Use `browser.map.rename_app` if that initial guess is poor.\n\n## When something is wrong\n\n- A selector from recall fails \u2192 record_use({ok:false}), learn the new\n  one, save it (upsert on purpose).\n- A whole app got refactored \u2192 `browser.map.forget` the app_id and let\n  the map repopulate as you learn the new structure.\n- A tool call fails with \"Tab not connected: tab_X\" \u2192 call\n  `browser.events` to see whether the bridge changed primary (the\n  Chrome tab probably got a new tab_id after a reconnect). Look for a\n  `tab-renamed` event with previous=tab_X and resume on the current id.\n\nThe map is a cache of navigation, not a substitute for `browser.snapshot`.\nThe live snapshot is always the source of truth.";
+export declare const SERVER_INSTRUCTIONS = "browser-link bridges Claude Code to the Chrome tabs the user has\nexplicitly connected through the companion extension, and ships a\npersistent UI map backed by a local SQLite DB. The data dir resolves\nper-OS via env-paths ($XDG_DATA_HOME/browser-link on Linux,\n~/Library/Application Support/browser-link on macOS, %APPDATA%/browser-link\non Windows). Override with $BROWSER_LINK_DATA_DIR. The map is private\nand per-machine; never persisted in any repo.\n\n## When operating on a tab\n\n1. Before doing anything on a tab whose URL you don't already know,\n   call `browser.map.recall` with { origin } (and optionally url) to load\n   selectors, flows and gotchas previously learned for that app.\n2. If recall returns entries with `failed_at` more recent than\n   `verified_at`, treat them as suspect: re-verify (snapshot / evaluate)\n   before reusing, or replace them.\n3. After every interaction that used a map entry, call\n   `browser.map.record_use` with { entry_id, ok }. ok=true updates\n   verified_at; ok=false updates failed_at. Keep the map honest.\n4. After a non-trivial flow that worked end-to-end, persist it with\n   `browser.map.save`. Three `kind` values:\n   - selector: { selector, evidence? } \u2014 a CSS selector tied to a purpose.\n   - flow: { steps: [...] } \u2014 an ordered list of actions to reach an outcome.\n   - gotcha: { body } \u2014 free-form note about something non-obvious.\n   Use `url_pattern` = pathname (exact). Promote to glob only if you have\n   evidence of a parametric route. Provide `purpose` as a stable, reusable\n   label (\"open task detail dialog\", not \"open IB0311 detail\").\n5. Never save selectors or flows you have not just successfully executed.\n6. Never store domain data (IDs, user names, dates, etc.). The map captures\n   UI structure only.\n\n## Identifying the app\n\n- `origin` = scheme://host:port of the tab.\n- `app_key` distinguishes apps that share an origin over time. On first\n  save you may omit it; it will be derived from the page title (slugified).\n  Use `browser.map.rename_app` if that initial guess is poor.\n\n## Sharing tabs with other agents\n\nThis primary may be serving several MCP clients at once (multi-agent mode).\nTo stop two agents fighting over the same Chrome tab there is a cooperative\nclaim layer:\n\n- `browser.list_tabs` includes `claimed_by` (null if free, otherwise the\n  agent that holds the claim) and `claimed_by_me` (boolean). Use it before\n  starting work on a tab whose state you don't already own.\n- `browser.my_tabs` returns YOUR active claims with timestamps. If the\n  user asks which tab you are using, this is the answer.\n- Action tools (`browser.click`, `browser.type`, `browser.navigate`,\n  `browser.evaluate`) auto-claim a free tab on first use and refresh\n  activity on subsequent calls. If another agent holds the tab, they\n  return an error naming the owner \u2014 do NOT retry blindly; ask the user\n  whose tab it should be, or use a different tab.\n- Read tools (`browser.snapshot`, `browser.console`, `browser.network`,\n  `browser.network_body`, `browser.events`, `browser.ping`) ignore claims.\n- `browser.claim_tab({ tab_id, ttl_minutes?, label? })` reserves a tab\n  explicitly. Provide a stable `label` (eg \"claude-code\", \"opencode\") so\n  other agents and the user see WHO holds the tab. The label is display\n  only \u2014 security relies on the IPC session id (kernel-vetted), not on\n  what an agent calls itself.\n- `browser.release_tab({ tab_id })` hands a tab back. Claims also auto-\n  release when an agent disconnects or after the inactivity TTL elapses\n  (default 10 minutes), so explicit release is only needed for early\n  hand-off.\n\nWhen you get a claim-conflict error: do NOT spin-retry. Either work on a\ndifferent tab from `list_tabs`, or surface the conflict to the user and\nlet them decide.\n\n## When something is wrong\n\n- A selector from recall fails \u2192 record_use({ok:false}), learn the new\n  one, save it (upsert on purpose).\n- A whole app got refactored \u2192 `browser.map.forget` the app_id and let\n  the map repopulate as you learn the new structure.\n- A tool call fails with \"Tab not connected: tab_X\" \u2192 call\n  `browser.events` to see whether the bridge changed primary (the\n  Chrome tab probably got a new tab_id after a reconnect). Look for a\n  `tab-renamed` event with previous=tab_X and resume on the current id.\n\nThe map is a cache of navigation, not a substitute for `browser.snapshot`.\nThe live snapshot is always the source of truth.";

package/dist/tools/server-instructions.js

@@ -38,6 +38,38 @@ and per-machine; never persisted in any repo.
   save you may omit it; it will be derived from the page title (slugified).
   Use \`browser.map.rename_app\` if that initial guess is poor.
 
+## Sharing tabs with other agents
+
+This primary may be serving several MCP clients at once (multi-agent mode).
+To stop two agents fighting over the same Chrome tab there is a cooperative
+claim layer:
+
+- \`browser.list_tabs\` includes \`claimed_by\` (null if free, otherwise the
+  agent that holds the claim) and \`claimed_by_me\` (boolean). Use it before
+  starting work on a tab whose state you don't already own.
+- \`browser.my_tabs\` returns YOUR active claims with timestamps. If the
+  user asks which tab you are using, this is the answer.
+- Action tools (\`browser.click\`, \`browser.type\`, \`browser.navigate\`,
+  \`browser.evaluate\`) auto-claim a free tab on first use and refresh
+  activity on subsequent calls. If another agent holds the tab, they
+  return an error naming the owner — do NOT retry blindly; ask the user
+  whose tab it should be, or use a different tab.
+- Read tools (\`browser.snapshot\`, \`browser.console\`, \`browser.network\`,
+  \`browser.network_body\`, \`browser.events\`, \`browser.ping\`) ignore claims.
+- \`browser.claim_tab({ tab_id, ttl_minutes?, label? })\` reserves a tab
+  explicitly. Provide a stable \`label\` (eg "claude-code", "opencode") so
+  other agents and the user see WHO holds the tab. The label is display
+  only — security relies on the IPC session id (kernel-vetted), not on
+  what an agent calls itself.
+- \`browser.release_tab({ tab_id })\` hands a tab back. Claims also auto-
+  release when an agent disconnects or after the inactivity TTL elapses
+  (default 10 minutes), so explicit release is only needed for early
+  hand-off.
+
+When you get a claim-conflict error: do NOT spin-retry. Either work on a
+different tab from \`list_tabs\`, or surface the conflict to the user and
+let them decide.
+
 ## When something is wrong
 
 - A selector from recall fails → record_use({ok:false}), learn the new

package/dist/tools/server-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/tools/server-instructions.ts"],"names":[],"mappings":"AAAA;oEACoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAkDc,CAAC"}
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/tools/server-instructions.ts"],"names":[],"mappings":"AAAA;oEACoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iDAkFc,CAAC"}

package/dist/tools/tab-claims.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Cooperative tab-ownership registry for multi-agent mode.
+ *
+ * Several MCP clients can share a single browser-link primary. Without
+ * coordination they end up racing on the same Chrome tab — clicking,
+ * navigating, evaluating in interleaved order. This module tracks who
+ * "owns" each tab and lets the dispatcher refuse cross-agent action.
+ *
+ * Identity model:
+ *   - `agent_id` is the IPC session id for proxies (UUID minted after the
+ *     hello/token handshake) and the literal string `"primary"` for the
+ *     primary's own MCP client.
+ *   - The auth that the agent passed (peerLookup + Node binary allowlist +
+ *     rotated token) is the trust anchor. This registry never re-validates
+ *     identity — it consumes the `AgentCaller` the bridge layer supplies.
+ *   - Self-declared `label` (eg `"claude-code"`) is display-only and is
+ *     never used for ownership comparisons.
+ *
+ * TTL model:
+ *   - Claims expire after `ttl_minutes` of inactivity. Every action on the
+ *     tab refreshes `last_activity_at`. Stale claims are dropped by
+ *     `pruneStale()` (called periodically by the primary).
+ *   - Sessions ending (proxy disconnect) drop the agent's claims
+ *     immediately via `onAgentDisconnect()`.
+ */
+export interface AgentCaller {
+    agent_id: string;
+    pid: number;
+    binary: string;
+    label?: string;
+}
+export interface TabClaim {
+    tab_id: string;
+    agent_id: string;
+    pid: number;
+    binary: string;
+    label?: string;
+    claimed_at: number;
+    last_activity_at: number;
+    ttl_ms: number;
+}
+export type ClaimEvent = {
+    kind: 'tab-claimed';
+    tab_id: string;
+    agent_id: string;
+    pid: number;
+    binary: string;
+    label?: string;
+    ttl_ms: number;
+    auto: boolean;
+} | {
+    kind: 'tab-released';
+    tab_id: string;
+    agent_id: string;
+    reason: 'explicit' | 'agent-disconnect' | 'ttl';
+} | {
+    kind: 'tab-claim-rejected';
+    tab_id: string;
+    requester_agent_id: string;
+    existing_agent_id: string;
+};
+export type ClaimOutcome = {
+    ok: true;
+    claim: TabClaim;
+    created: boolean;
+} | {
+    ok: false;
+    reason: 'conflict';
+    existing: TabClaim;
+};
+export interface TabClaimRegistryOptions {
+    /** Default TTL when a claim does not specify one. Defaults to 10 minutes. */
+    defaultTtlMinutes?: number;
+    /** Upper bound on TTL a caller may request. Defaults to 60 minutes. */
+    maxTtlMinutes?: number;
+    /** Time source. Tests inject a fake clock to make TTL assertions deterministic. */
+    nowMs?: () => number;
+    /** Event callback. The primary wires this to its `BridgeEventLog`. */
+    onEvent?: (event: ClaimEvent) => void;
+}
+export declare class TabClaimRegistry {
+    private claims;
+    private readonly defaultTtlMs;
+    private readonly maxTtlMs;
+    private readonly now;
+    private readonly onEvent;
+    constructor(opts?: TabClaimRegistryOptions);
+    /** Snapshot of the current claim for a tab, or null when free or expired. */
+    getClaim(tab_id: string): TabClaim | null;
+    /** Explicit claim. Returns conflict if another agent owns the tab. Same-agent re-claims refresh activity and update the label/TTL. */
+    claim(tab_id: string, caller: AgentCaller, opts?: {
+        ttlMinutes?: number;
+        label?: string;
+    }): ClaimOutcome;
+    /** For action tools. Auto-claims a free tab for the caller, refreshes when the caller already owns it, conflicts otherwise. */
+    ensureActionAllowed(tab_id: string, caller: AgentCaller): ClaimOutcome;
+    /** Explicit release. Only the owner may release. */
+    release(tab_id: string, caller: AgentCaller): {
+        ok: true;
+    } | {
+        ok: false;
+        reason: 'not-claimed' | 'not-owner';
+        existing?: TabClaim;
+    };
+    /** Claims owned by this caller, sorted by `claimed_at`. */
+    myTabs(caller: AgentCaller): TabClaim[];
+    /** Drop every claim held by `agent_id` (called when a proxy disconnects). */
+    onAgentDisconnect(agent_id: string): TabClaim[];
+    /** Sweep claims past their TTL. Returns the dropped claims. */
+    pruneStale(): TabClaim[];
+    /** Test helper. Production callers should not need this. */
+    size(): number;
+    private isExpired;
+    private claimInternal;
+}
+/** User-facing error string for action tools when another agent holds the tab. Kept here so the wording is consistent across handlers. */
+export declare function formatClaimConflict(caller: AgentCaller, existing: TabClaim, nowMs?: number): string;

package/dist/tools/tab-claims.js

@@ -0,0 +1,186 @@
+/**
+ * Cooperative tab-ownership registry for multi-agent mode.
+ *
+ * Several MCP clients can share a single browser-link primary. Without
+ * coordination they end up racing on the same Chrome tab — clicking,
+ * navigating, evaluating in interleaved order. This module tracks who
+ * "owns" each tab and lets the dispatcher refuse cross-agent action.
+ *
+ * Identity model:
+ *   - `agent_id` is the IPC session id for proxies (UUID minted after the
+ *     hello/token handshake) and the literal string `"primary"` for the
+ *     primary's own MCP client.
+ *   - The auth that the agent passed (peerLookup + Node binary allowlist +
+ *     rotated token) is the trust anchor. This registry never re-validates
+ *     identity — it consumes the `AgentCaller` the bridge layer supplies.
+ *   - Self-declared `label` (eg `"claude-code"`) is display-only and is
+ *     never used for ownership comparisons.
+ *
+ * TTL model:
+ *   - Claims expire after `ttl_minutes` of inactivity. Every action on the
+ *     tab refreshes `last_activity_at`. Stale claims are dropped by
+ *     `pruneStale()` (called periodically by the primary).
+ *   - Sessions ending (proxy disconnect) drop the agent's claims
+ *     immediately via `onAgentDisconnect()`.
+ */
+const MS_PER_MINUTE = 60_000;
+export class TabClaimRegistry {
+    claims = new Map();
+    defaultTtlMs;
+    maxTtlMs;
+    now;
+    onEvent;
+    constructor(opts = {}) {
+        this.defaultTtlMs = (opts.defaultTtlMinutes ?? 10) * MS_PER_MINUTE;
+        this.maxTtlMs = (opts.maxTtlMinutes ?? 60) * MS_PER_MINUTE;
+        this.now = opts.nowMs ?? (() => Date.now());
+        this.onEvent = opts.onEvent ?? (() => { });
+    }
+    /** Snapshot of the current claim for a tab, or null when free or expired. */
+    getClaim(tab_id) {
+        const claim = this.claims.get(tab_id);
+        if (!claim)
+            return null;
+        if (this.isExpired(claim)) {
+            this.claims.delete(tab_id);
+            this.onEvent({
+                kind: 'tab-released',
+                tab_id,
+                agent_id: claim.agent_id,
+                reason: 'ttl',
+            });
+            return null;
+        }
+        return claim;
+    }
+    /** Explicit claim. Returns conflict if another agent owns the tab. Same-agent re-claims refresh activity and update the label/TTL. */
+    claim(tab_id, caller, opts = {}) {
+        return this.claimInternal(tab_id, caller, opts, { auto: false });
+    }
+    /** For action tools. Auto-claims a free tab for the caller, refreshes when the caller already owns it, conflicts otherwise. */
+    ensureActionAllowed(tab_id, caller) {
+        return this.claimInternal(tab_id, caller, {}, { auto: true });
+    }
+    /** Explicit release. Only the owner may release. */
+    release(tab_id, caller) {
+        const claim = this.getClaim(tab_id);
+        if (!claim)
+            return { ok: false, reason: 'not-claimed' };
+        if (claim.agent_id !== caller.agent_id) {
+            return { ok: false, reason: 'not-owner', existing: claim };
+        }
+        this.claims.delete(tab_id);
+        this.onEvent({
+            kind: 'tab-released',
+            tab_id,
+            agent_id: claim.agent_id,
+            reason: 'explicit',
+        });
+        return { ok: true };
+    }
+    /** Claims owned by this caller, sorted by `claimed_at`. */
+    myTabs(caller) {
+        const owned = [];
+        for (const tabId of this.claims.keys()) {
+            const claim = this.getClaim(tabId);
+            if (claim && claim.agent_id === caller.agent_id)
+                owned.push(claim);
+        }
+        return owned.sort((a, b) => a.claimed_at - b.claimed_at);
+    }
+    /** Drop every claim held by `agent_id` (called when a proxy disconnects). */
+    onAgentDisconnect(agent_id) {
+        const released = [];
+        for (const [tabId, claim] of this.claims) {
+            if (claim.agent_id === agent_id) {
+                released.push(claim);
+                this.claims.delete(tabId);
+                this.onEvent({
+                    kind: 'tab-released',
+                    tab_id: tabId,
+                    agent_id,
+                    reason: 'agent-disconnect',
+                });
+            }
+        }
+        return released;
+    }
+    /** Sweep claims past their TTL. Returns the dropped claims. */
+    pruneStale() {
+        const expired = [];
+        for (const [tabId, claim] of this.claims) {
+            if (this.isExpired(claim)) {
+                expired.push(claim);
+                this.claims.delete(tabId);
+                this.onEvent({
+                    kind: 'tab-released',
+                    tab_id: tabId,
+                    agent_id: claim.agent_id,
+                    reason: 'ttl',
+                });
+            }
+        }
+        return expired;
+    }
+    /** Test helper. Production callers should not need this. */
+    size() {
+        return this.claims.size;
+    }
+    isExpired(claim) {
+        return this.now() - claim.last_activity_at >= claim.ttl_ms;
+    }
+    claimInternal(tab_id, caller, opts, flags) {
+        const existing = this.getClaim(tab_id);
+        if (existing && existing.agent_id !== caller.agent_id) {
+            this.onEvent({
+                kind: 'tab-claim-rejected',
+                tab_id,
+                requester_agent_id: caller.agent_id,
+                existing_agent_id: existing.agent_id,
+            });
+            return { ok: false, reason: 'conflict', existing };
+        }
+        const now = this.now();
+        const requestedTtlMs = opts.ttlMinutes != null ? opts.ttlMinutes * MS_PER_MINUTE : undefined;
+        const ttlMs = clamp(requestedTtlMs ?? existing?.ttl_ms ?? this.defaultTtlMs, 1, this.maxTtlMs);
+        const label = opts.label ?? existing?.label ?? caller.label;
+        const claim = {
+            tab_id,
+            agent_id: caller.agent_id,
+            pid: caller.pid,
+            binary: caller.binary,
+            label,
+            claimed_at: existing?.claimed_at ?? now,
+            last_activity_at: now,
+            ttl_ms: ttlMs,
+        };
+        const created = !existing;
+        this.claims.set(tab_id, claim);
+        if (created) {
+            this.onEvent({
+                kind: 'tab-claimed',
+                tab_id,
+                agent_id: caller.agent_id,
+                pid: caller.pid,
+                binary: caller.binary,
+                label,
+                ttl_ms: ttlMs,
+                auto: flags.auto,
+            });
+        }
+        return { ok: true, claim, created };
+    }
+}
+function clamp(value, lo, hi) {
+    return Math.min(Math.max(value, lo), hi);
+}
+/** User-facing error string for action tools when another agent holds the tab. Kept here so the wording is consistent across handlers. */
+export function formatClaimConflict(caller, existing, nowMs = Date.now()) {
+    const labelOrPid = existing.label ?? `pid ${existing.pid}`;
+    const ageMin = Math.max(1, Math.round((nowMs - existing.claimed_at) / MS_PER_MINUTE));
+    return (`Tab ${existing.tab_id} is in use by another agent (${labelOrPid}, agent_id=${existing.agent_id}) ` +
+        `for ${ageMin} min. Your agent_id is ${caller.agent_id}. ` +
+        `Call browser.list_tabs to see what's free, browser.my_tabs to see what you already own, ` +
+        `or ask the user whose tab this should be.`);
+}
+//# sourceMappingURL=tab-claims.js.map

package/dist/tools/tab-claims.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tab-claims.js","sourceRoot":"","sources":["../../src/tools/tab-claims.ts"],"names":[],"mappings":"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"}

package/dist/ui/screens.js

@@ -8,6 +8,7 @@ import { INSTALLERS } from '../installers/index.js';
 import { runDoctor, formatDoctor } from '../commands/doctor.js';
 import { getExtensionInfo } from '../commands/extension.js';
 import { checkUpdates } from '../commands/updates.js';
+import { runSelfUpdate, } from '../commands/self-update.js';
 import { runFreePort } from '../commands/free-port.js';
 import { PACKAGE_NAME } from '../version.js';
 import { loadConfig, saveConfig } from '../config.js';
@@ -402,9 +403,15 @@ const UPDATES_I18N = {
         latest: 'Latest on npm  ',
         upToDate: '✓ You are on the latest published version.',
         available: '⚠ A newer version is available.',
-        upgradeCmd: 'To upgrade, run:',
+        upgradeCmd: 'Or, to upgrade manually, run:',
+        updateKeyHint: 'Press u to update now (stops any running primary, then installs).',
+        updateRunning: 'Updating…',
         error: 'Could not check the registry',
-        footer: 'r retry · ↵ / Esc back to menu',
+        footerIdle: 'r retry · ↵ / Esc back to menu',
+        footerWithUpdate: 'u update · r retry · ↵ / Esc back to menu',
+        footerUpdating: 'updating — please wait…',
+        footerDone: '↵ / Esc back to menu — restart your MCP client to pick up the new version',
+        footerFailed: 'r retry check · ↵ / Esc back to menu',
     },
     es: {
         title: 'Buscar actualizaciones',
@@ -413,18 +420,26 @@ const UPDATES_I18N = {
         latest: 'Última en npm    ',
         upToDate: '✓ Estás en la última versión publicada.',
         available: '⚠ Hay una versión más nueva disponible.',
-        upgradeCmd: 'Para actualizar, corré:',
+        upgradeCmd: 'O, para actualizar a mano, corré:',
+        updateKeyHint: 'Tocá u para actualizar ahora (corta el primary en uso e instala).',
+        updateRunning: 'Actualizando…',
         error: 'No se pudo consultar el registry',
-        footer: 'r reintentar · ↵ / Esc volver al menú',
+        footerIdle: 'r reintentar · ↵ / Esc volver al menú',
+        footerWithUpdate: 'u actualizar · r reintentar · ↵ / Esc volver al menú',
+        footerUpdating: 'actualizando — esperá…',
+        footerDone: '↵ / Esc volver al menú — reiniciá tu cliente MCP para que tome la nueva versión',
+        footerFailed: 'r reintentar el chequeo · ↵ / Esc volver al menú',
     },
 };
 export function UpdatesView({ language, onBack }) {
     const t = UPDATES_I18N[language];
     const [info, setInfo] = useState(null);
     const [refreshKey, setRefreshKey] = useState(0);
+    const [update, setUpdate] = useState({ kind: 'idle' });
     useEffect(() => {
         let cancelled = false;
         setInfo(null);
+        setUpdate({ kind: 'idle' });
         checkUpdates().then((r) => {
             if (!cancelled)
                 setInfo(r);
@@ -433,13 +448,49 @@ export function UpdatesView({ language, onBack }) {
             cancelled = true;
         };
     }, [refreshKey]);
+    const isUpdating = update.kind === 'running';
+    const canUpdate = info !== null && info.newer === true && info.latest !== null && !isUpdating;
+    const startUpdate = () => {
+        if (!canUpdate || info === null || info.latest === null)
+            return;
+        const target = info.latest;
+        setUpdate({ kind: 'running', stage: 'preflight', message: t.updateRunning });
+        runSelfUpdate(target, language, (event) => {
+            setUpdate({ kind: 'running', stage: event.stage, message: event.message });
+        })
+            .then((result) => {
+            setUpdate({
+                kind: result.ok ? 'done' : 'failed',
+                message: result.message,
+            });
+        })
+            .catch((err) => {
+            setUpdate({
+                kind: 'failed',
+                message: err instanceof Error ? err.message : String(err),
+            });
+        });
+    };
     useInput((input, key) => {
+        if (isUpdating)
+            return; // ignore keys while the install is in flight
         if (key.return || key.escape)
             onBack();
-        else if (input === 'r')
+        else if (input === 'r' && update.kind !== 'done')
             setRefreshKey((k) => k + 1);
+        else if (input === 'u')
+            startUpdate();
     });
-    return (_jsx(Frame, { title: t.title, footer: t.footer, children: info === null ? (_jsx(Text, { color: "gray", children: t.checking })) : info.error || info.latest === null ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { color: "white", children: [t.current, ": "] }), _jsx(Text, { bold: true, children: info.current })] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", children: [t.error, ": ", info.error ?? 'unknown error'] }) })] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { color: "white", children: [t.current, ": "] }), _jsx(Text, { bold: true, children: info.current })] }), _jsxs(Text, { children: [_jsxs(Text, { color: "white", children: [t.latest, ": "] }), _jsx(Text, { bold: true, color: info.newer ? 'yellow' : 'green', children: info.latest })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: info.newer ? 'yellow' : 'green', children: info.newer ? t.available : t.upToDate }) }), info.newer && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "gray", children: t.upgradeCmd }), _jsx(Text, { color: "cyan", children: `npm install -g ${PACKAGE_NAME}@latest` })] }))] })) }));
+    const footer = update.kind === 'running'
+        ? t.footerUpdating
+        : update.kind === 'done'
+            ? t.footerDone
+            : update.kind === 'failed'
+                ? t.footerFailed
+                : canUpdate
+                    ? t.footerWithUpdate
+                    : t.footerIdle;
+    return (_jsx(Frame, { title: t.title, footer: footer, children: info === null ? (_jsx(Text, { color: "gray", children: t.checking })) : info.error || info.latest === null ? (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { color: "white", children: [t.current, ": "] }), _jsx(Text, { bold: true, children: info.current })] }), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "red", children: [t.error, ": ", info.error ?? 'unknown error'] }) })] })) : (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsxs(Text, { color: "white", children: [t.current, ": "] }), _jsx(Text, { bold: true, children: info.current })] }), _jsxs(Text, { children: [_jsxs(Text, { color: "white", children: [t.latest, ": "] }), _jsx(Text, { bold: true, color: info.newer ? 'yellow' : 'green', children: info.latest })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: info.newer ? 'yellow' : 'green', children: info.newer ? t.available : t.upToDate }) }), info.newer && update.kind === 'idle' && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "cyan", children: t.updateKeyHint }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: "gray", children: t.upgradeCmd }), _jsx(Text, { color: "cyan", children: `npm install -g ${PACKAGE_NAME}@latest` })] })] })), update.kind === 'running' && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "cyan", children: t.updateRunning }), _jsx(Text, { color: "gray", children: update.message })] })), update.kind === 'done' && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "green", children: update.message }) })), update.kind === 'failed' && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "red", children: update.message }) }))] })) }));
 }
 /* ── Language ──────────────────────────────────────────────────────────── */
 const LANG_I18N = {