obsbot-mcp 0.6.3 → 0.8.0

package/dist/ipc/protocol.d.ts

@@ -1,3 +1,4 @@
+import { type BuildId } from "./build-id.js";
 /** Upper bound on a single frame. Snapshots (base64 JPEG) are the large case. */
 export declare const MAX_FRAME: number;
 export interface RpcMessage {
@@ -19,3 +20,32 @@ export declare class FrameDecoder {
     private buf;
     push(chunk: Buffer): RpcMessage[];
 }
+/** Frame id of an owner→client notice. Request ids start at 1, so it never matches a reply. */
+export declare const NOTICE_ID = 0;
+export interface HelloBody {
+    ipc: "hello";
+    build: BuildId;
+    pid: number;
+}
+export interface TakeoverBody {
+    ipc: "takeover";
+    build: BuildId;
+    pid: number;
+}
+export interface SteppingDownBody {
+    ipc: "stepping-down";
+    successorPid: number;
+}
+export type TakeoverResult = {
+    ipc: "takeover";
+    granted: true;
+} | {
+    ipc: "takeover";
+    granted: false;
+    reason: "not-newer";
+};
+/** The body as a hello, or undefined if it is not a well-formed one. */
+export declare function asHello(body: unknown): HelloBody | undefined;
+/** The body as a takeover request, or undefined if it is not a well-formed one. */
+export declare function asTakeover(body: unknown): TakeoverBody | undefined;
+export declare function isSteppingDown(body: unknown): body is SteppingDownBody;

package/dist/ipc/protocol.js

@@ -1,3 +1,4 @@
+import { isBuildId } from "./build-id.js";
 // ---------------------------------------------------------------------------
 // Length-prefixed JSON framing for the client↔owner control channel.
 //
@@ -53,4 +54,43 @@ export class FrameDecoder {
         return out;
     }
 }
+// ---------------------------------------------------------------------------
+// Control messages — how instances agree on who owns the endpoint.
+//
+// A tool request's body is {tool, args}. A control message is a body with a
+// reserved `ipc` key, carried in the same frames. See
+// docs/superpowers/specs/2026-09-27-newest-build-wins-design.md §6.
+//
+// An instance that predates these treats any body as a tool call, so a hello
+// sent to it comes back as {ok:false, error:"unknown tool: undefined"} — which
+// is how a legacy owner is recognised. A legacy CLIENT ignores a frame whose id
+// it is not waiting for, so a notice sent with NOTICE_ID is harmless to it.
+// ---------------------------------------------------------------------------
+/** Frame id of an owner→client notice. Request ids start at 1, so it never matches a reply. */
+export const NOTICE_ID = 0;
+const isPid = (x) => typeof x === "number" && Number.isInteger(x) && x > 0;
+function identityOf(body, kind) {
+    if (typeof body !== "object" || body === null)
+        return undefined;
+    const b = body;
+    if (b.ipc !== kind || !isBuildId(b.build) || !isPid(b.pid))
+        return undefined;
+    return { build: b.build, pid: b.pid };
+}
+/** The body as a hello, or undefined if it is not a well-formed one. */
+export function asHello(body) {
+    const id = identityOf(body, "hello");
+    return id && { ipc: "hello", ...id };
+}
+/** The body as a takeover request, or undefined if it is not a well-formed one. */
+export function asTakeover(body) {
+    const id = identityOf(body, "takeover");
+    return id && { ipc: "takeover", ...id };
+}
+export function isSteppingDown(body) {
+    if (typeof body !== "object" || body === null)
+        return false;
+    const b = body;
+    return b.ipc === "stepping-down" && isPid(b.successorPid);
+}
 //# sourceMappingURL=protocol.js.map

package/dist/ipc/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/ipc/protocol.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qEAAqE;AACrE,EAAE;AACF,gFAAgF;AAChF,0EAA0E;AAC1E,8EAA8E;AAC9E,yEAAyE;AACzE,EAAE;AACF,0EAA0E;AAC1E,4EAA4E;AAC5E,gDAAgD;AAChD,8EAA8E;AAE9E,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,+BAA+B;AACjD,iFAAiF;AACjF,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,SAAS;AAOpD,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,CAAC,MAAM,QAAQ,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IACf,GAAG,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtC,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAiB,EAAE,CAAC;QAC7B,SAAS,CAAC;YACR,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM;gBAAE,MAAM,CAAC,oCAAoC;YACzE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,QAAQ,CAAC,CAAC;YAClE,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,GAAG;gBAAE,MAAM,CAAC,yBAAyB;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe,CAAC,CAAC;YAC1D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/ipc/protocol.ts"],"names":[],"mappings":"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"}

package/dist/ipc/rendezvous.d.ts

@@ -1,5 +1,19 @@
 import net from "node:net";
-/** Well-known rendezvous name → platform endpoint. */
+/**
+ * The rendezvous name: OBSBOT_IPC_NAME, or the well-known default.
+ *
+ * Every instance that should share one camera owner must use the same name, so
+ * the default is right for normal use. The variable exists for test harnesses
+ * — which would otherwise take the endpoint away from a developer's live
+ * session — and for deliberately isolating one session on its own build.
+ *
+ * The name becomes part of a filesystem path or pipe name, so anything outside
+ * a conservative character set is refused rather than sanitised. Unset and
+ * empty both mean the default: an MCP client config that declares the variable
+ * with no value should not be a startup error.
+ */
+export declare function rendezvousName(env?: NodeJS.ProcessEnv): string;
+/** Rendezvous name → platform endpoint. */
 export declare function rendezvousPath(name?: string): string;
 export type Role = {
     role: "owner";
@@ -11,16 +25,28 @@ export type Role = {
 /**
  * Become the owner, or attach as a client.
  *
- * 1. Try to listen on `path` → win the bind → OWNER.
- * 2. EADDRINUSE → someone's there → connect → CLIENT.
- * 3. Connect refused on POSIX → the endpoint file is STALE (owner crashed
- *    without cleaning up); unlink it and retry the listen → OWNER. Windows
- *    named pipes are kernel-refcounted and never go stale, so this branch is
- *    POSIX-only.
+ * The bind is the lock: exactly one process can hold the name. What needs care
+ * is the name that is held by NOBODY — the socket file an owner leaves behind
+ * when it is killed outright (POSIX only; a Windows pipe is kernel-refcounted
+ * and vanishes with its owner).
+ *
+ * Clearing a stale file means unlinking it, and unlink cannot tell a stale
+ * file from a live one. If two callers both find the name taken and the
+ * connection refused, and each unlinks and binds, the second unlinks the
+ * FIRST one's live socket: two owners, and the first never finds out. That is
+ * no longer a corner case — every client of a killed owner re-elects at once.
+ *
+ * So on POSIX the unlink, and every bind, happens under a lock file taken with
+ * an exclusive create:
+ *
+ * 1. Connect. Someone answers → CLIENT.
+ * 2. Nobody answers → take the lock, and look again: another caller may have
+ *    bound while we waited. Someone answers → CLIENT.
+ * 3. Still nobody → unlink whatever is there, bind → OWNER.
  *
- * The stale-then-retry can itself lose a race to a concurrent starter that
- * binds first; that just yields EADDRINUSE again, so we bounce back to the
- * client path. A small bounded retry keeps a burst of simultaneous starts
- * from spuriously failing.
+ * On Windows nothing is ever stale and nothing is unlinked, so there is no
+ * lock: bind → OWNER, else connect → CLIENT. A name that is taken and then
+ * refuses the connection means the owner went away in between, which is a
+ * reason to go round again, not to fail.
  */
 export declare function elect(path?: string, attempts?: number): Promise<Role>;

package/dist/ipc/rendezvous.js

@@ -1,5 +1,5 @@
 import net from "node:net";
-import { unlinkSync } from "node:fs";
+import { closeSync, openSync, statSync, unlinkSync } from "node:fs";
 // ---------------------------------------------------------------------------
 // Peer election over a well-known local endpoint.
 //
@@ -7,14 +7,39 @@ import { unlinkSync } from "node:fs";
 // bind and becomes the OWNER (it will run the single DeviceManager + native
 // helper and serve everyone else); the rest get EADDRINUSE and attach as
 // CLIENTS that forward their helper ops to the owner. The bind is the lock —
-// there is no check-then-create step to race (see IPC-DESIGN.md).
+// there is no check-then-create step to race (see IPC-DESIGN.md). Clearing a
+// name that nobody holds is the one step that is not atomic; see elect().
 //
 // Transport is a named pipe (Windows) / Unix-domain socket (macOS, Linux),
 // NOT shared memory: it gives atomic election, framing, wakeup, and clean
 // crash-detection for free.
 // ---------------------------------------------------------------------------
-/** Well-known rendezvous name → platform endpoint. */
-export function rendezvousPath(name = "obsbot-mcp") {
+const DEFAULT_NAME = "obsbot-mcp";
+const NAME_RE = /^[A-Za-z0-9._-]{1,64}$/;
+/**
+ * The rendezvous name: OBSBOT_IPC_NAME, or the well-known default.
+ *
+ * Every instance that should share one camera owner must use the same name, so
+ * the default is right for normal use. The variable exists for test harnesses
+ * — which would otherwise take the endpoint away from a developer's live
+ * session — and for deliberately isolating one session on its own build.
+ *
+ * The name becomes part of a filesystem path or pipe name, so anything outside
+ * a conservative character set is refused rather than sanitised. Unset and
+ * empty both mean the default: an MCP client config that declares the variable
+ * with no value should not be a startup error.
+ */
+export function rendezvousName(env = process.env) {
+    const raw = env.OBSBOT_IPC_NAME;
+    if (raw === undefined || raw === "")
+        return DEFAULT_NAME;
+    if (!NAME_RE.test(raw)) {
+        throw new Error(`OBSBOT_IPC_NAME must be 1-64 characters from A-Z a-z 0-9 . _ - (got ${JSON.stringify(raw)})`);
+    }
+    return raw;
+}
+/** Rendezvous name → platform endpoint. */
+export function rendezvousPath(name = rendezvousName()) {
     return process.platform === "win32"
         ? `\\\\.\\pipe\\${name}`
         : `/tmp/${name}.sock`; // portable across macOS + Linux; abstract sockets are Linux-only
@@ -22,48 +47,136 @@ export function rendezvousPath(name = "obsbot-mcp") {
 /**
  * Become the owner, or attach as a client.
  *
- * 1. Try to listen on `path` → win the bind → OWNER.
- * 2. EADDRINUSE → someone's there → connect → CLIENT.
- * 3. Connect refused on POSIX → the endpoint file is STALE (owner crashed
- *    without cleaning up); unlink it and retry the listen → OWNER. Windows
- *    named pipes are kernel-refcounted and never go stale, so this branch is
- *    POSIX-only.
+ * The bind is the lock: exactly one process can hold the name. What needs care
+ * is the name that is held by NOBODY — the socket file an owner leaves behind
+ * when it is killed outright (POSIX only; a Windows pipe is kernel-refcounted
+ * and vanishes with its owner).
+ *
+ * Clearing a stale file means unlinking it, and unlink cannot tell a stale
+ * file from a live one. If two callers both find the name taken and the
+ * connection refused, and each unlinks and binds, the second unlinks the
+ * FIRST one's live socket: two owners, and the first never finds out. That is
+ * no longer a corner case — every client of a killed owner re-elects at once.
+ *
+ * So on POSIX the unlink, and every bind, happens under a lock file taken with
+ * an exclusive create:
  *
- * The stale-then-retry can itself lose a race to a concurrent starter that
- * binds first; that just yields EADDRINUSE again, so we bounce back to the
- * client path. A small bounded retry keeps a burst of simultaneous starts
- * from spuriously failing.
+ * 1. Connect. Someone answers → CLIENT.
+ * 2. Nobody answers → take the lock, and look again: another caller may have
+ *    bound while we waited. Someone answers → CLIENT.
+ * 3. Still nobody → unlink whatever is there, bind → OWNER.
+ *
+ * On Windows nothing is ever stale and nothing is unlinked, so there is no
+ * lock: bind → OWNER, else connect → CLIENT. A name that is taken and then
+ * refuses the connection means the owner went away in between, which is a
+ * reason to go round again, not to fail.
  */
-export async function elect(path = rendezvousPath(), attempts = 3) {
+export async function elect(path = rendezvousPath(), attempts = 5) {
     let lastErr;
     for (let i = 0; i < attempts; i++) {
+        const r = process.platform === "win32" ? await electPipe(path) : await electSocket(path);
+        if (r.role !== "retry")
+            return r;
+        lastErr = r.because;
+        await sleep(RETRY_MS);
+    }
+    throw new Error(`elect: could not become owner or client after ${attempts} attempts: ${errno(lastErr) ?? lastErr}`);
+}
+const RETRY_MS = 10;
+/** A lock older than this was left by a holder that died. The lock is held for milliseconds. */
+const LOCK_STALE_MS = 5000;
+/** Longest one caller waits for the lock. */
+const LOCK_WAIT_MS = 3000;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const nobodyThere = (e) => {
+    const code = errno(e);
+    return code === "ECONNREFUSED" || code === "ENOENT";
+};
+async function electPipe(path) {
+    try {
+        return { role: "owner", server: await listen(path) };
+    }
+    catch (e) {
+        if (errno(e) !== "EADDRINUSE")
+            throw e;
+    }
+    try {
+        return { role: "client", socket: await connect(path) };
+    }
+    catch (e) {
+        if (!nobodyThere(e))
+            throw e;
+        return { role: "retry", because: e };
+    }
+}
+async function electSocket(path) {
+    try {
+        return { role: "client", socket: await connect(path) };
+    }
+    catch (e) {
+        if (!nobodyThere(e))
+            throw e;
+    }
+    return withLock(`${path}.lock`, async () => {
+        try {
+            return { role: "client", socket: await connect(path) }; // someone bound while we waited
+        }
+        catch (e) {
+            if (!nobodyThere(e))
+                throw e;
+        }
+        try {
+            unlinkSync(path);
+        }
+        catch {
+            // nothing there to clear
+        }
         try {
             return { role: "owner", server: await listen(path) };
         }
         catch (e) {
+            // An instance that predates the lock can still bind between our unlink
+            // and our bind. It is there now; go round and connect to it.
             if (errno(e) !== "EADDRINUSE")
                 throw e;
+            return { role: "retry", because: e };
         }
+    });
+}
+/** Run `fn` holding `lock`, a file taken with an exclusive create and removed afterwards. */
+async function withLock(lock, fn) {
+    const deadline = Date.now() + LOCK_WAIT_MS;
+    for (;;) {
         try {
-            return { role: "client", socket: await connect(path) };
+            closeSync(openSync(lock, "wx")); // fails if it exists: that is the lock
+            break;
         }
         catch (e) {
-            lastErr = e;
-            const code = errno(e);
-            const stale = code === "ECONNREFUSED" || code === "ENOENT";
-            if (stale && process.platform !== "win32") {
-                try {
-                    unlinkSync(path);
-                }
-                catch {
-                    // already gone, or someone else cleaned it — fine; loop and retry.
-                }
-                continue; // retry listen
-            }
-            throw e; // a real connect failure that isn't a stale endpoint
+            if (errno(e) !== "EEXIST")
+                throw e;
+        }
+        try {
+            if (Date.now() - statSync(lock).mtimeMs > LOCK_STALE_MS)
+                unlinkSync(lock);
+        }
+        catch {
+            // released, or cleared by someone else, since we looked
+        }
+        if (Date.now() > deadline)
+            throw new Error(`elect: could not take ${lock} in ${LOCK_WAIT_MS} ms`);
+        await sleep(5 + Math.random() * 10);
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        try {
+            unlinkSync(lock);
+        }
+        catch {
+            // already gone
         }
     }
-    throw new Error(`elect: could not become owner or client after ${attempts} attempts: ${errno(lastErr) ?? lastErr}`);
 }
 function listen(path) {
     return new Promise((resolve, reject) => {

package/dist/ipc/rendezvous.js.map

@@ -1 +1 @@
-{"version":3,"file":"rendezvous.js","sourceRoot":"","sources":["../../src/ipc/rendezvous.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rendezvous.js","sourceRoot":"","sources":["../../src/ipc/rendezvous.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,8EAA8E;AAC9E,kDAAkD;AAClD,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,0EAA0E;AAC1E,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,YAAY,GAAG,YAAY,CAAC;AAClC,MAAM,OAAO,GAAG,wBAAwB,CAAC;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,YAAY,CAAC;IACzD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,uEAAuE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAC9F,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,cAAc,CAAC,OAAe,cAAc,EAAE;IAC5D,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO;QACjC,CAAC,CAAC,gBAAgB,IAAI,EAAE;QACxB,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,iEAAiE;AAC5F,CAAC;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAI,GAAG,cAAc,EAAE,EAAE,QAAQ,GAAG,CAAC;IAC/D,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACzF,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QACpB,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,iDAAiD,QAAQ,cAAc,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,EAAE,CACnG,CAAC;AACJ,CAAC;AAID,MAAM,QAAQ,GAAG,EAAE,CAAC;AACpB,gGAAgG;AAChG,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,6CAA6C;AAC7C,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AACnF,MAAM,WAAW,GAAG,CAAC,CAAU,EAAW,EAAE;IAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,QAAQ,CAAC;AACtD,CAAC,CAAC;AAEF,KAAK,UAAU,SAAS,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IACvD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY;YAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;YAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,IAAI,OAAO,EAAE,KAAK,IAAI,EAAE;QACzC,IAAI,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,gCAAgC;QAC1F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;gBAAE,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,uEAAuE;YACvE,6DAA6D;YAC7D,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY;gBAAE,MAAM,CAAC,CAAC;YACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACvC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,KAAK,UAAU,QAAQ,CAAI,IAAY,EAAE,EAAoB;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC;IAC3C,SAAS,CAAC;QACR,IAAI,CAAC;YACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,uCAAuC;YACxE,MAAM;QACR,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ;gBAAE,MAAM,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,aAAa;gBAAE,UAAU,CAAC,IAAI,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,OAAO,YAAY,KAAK,CAAC,CAAC;QAClG,MAAM,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,CAAU,EAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;YACvB,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,CAAC,CAAU,EAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YAC1B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,CAAU;IACvB,OAAQ,CAAuC,EAAE,IAAI,CAAC;AACxD,CAAC"}

package/dist/mcp/server.js

@@ -6,11 +6,19 @@ import { DeviceManager } from "../device/manager.js";
 import { helperFactory } from "../device/helper-factory.js";
 import { makeLogSink } from "./log-sink.js";
 import { createTools } from "./tools.js";
+import { Tail2Registry } from "../tail2/registry.js";
+import { createTail2Tools } from "../tail2/tools.js";
 import { renderToolResult } from "./render.js";
 import { CaptureManager } from "../capture/manager.js";
-import { Coordinator, serialize } from "../ipc/coordinator.js";
+import { Coordinator } from "../ipc/coordinator.js";
+import { buildLabel, loadBuildId } from "../ipc/build-id.js";
 import { VERSION } from "../version.js";
 export async function startServer(opts = {}) {
+    // Which build this process loaded. Read first and never again: a rebuild
+    // under a running process changes the stamp file but not the process, and
+    // the identity has to describe the process. See src/ipc/build-id.ts.
+    const build = loadBuildId();
+    console.error(`obsbot-mcp: build ${buildLabel(build)}`);
     // helperFactory subscribes every helper it spawns to the OS bus events, so
     // the manager hears about a camera arriving or leaving instead of finding
     // out by failing a call. See src/device/helper-factory.ts.
@@ -27,27 +35,47 @@ export async function startServer(opts = {}) {
     // `camera` selector — so nothing per-camera is wired up out here anymore.
     const capture = new CaptureManager();
     // --debug exposes the RE/diagnostics surface (obsbot_debug_probe tool + status raw block).
-    const tools = createTools(mgr, capture, opts.debug ?? false);
+    // Tail 2 tools are pure TypeScript (HTTP/WS — no native helper), so they ride
+    // along on every platform identically; see TAIL2-PROTOCOL.md. The registry
+    // seeds itself from OBSBOT_TAIL2_HOSTS and holds no persistent resources in
+    // this first increment (status reads are one-shot WebSockets), so there is
+    // nothing of its own to close in `shutdown`.
+    const tail2 = Tail2Registry.fromEnv(process.env);
+    const tools = [
+        ...createTools(mgr, capture, opts.debug ?? false),
+        ...createTail2Tools(tail2),
+    ];
     // Single-owner camera coordination across concurrent MCP clients (see
     // IPC-DESIGN.md). Every instance elects: the owner runs tool calls locally
     // against the one DeviceManager; clients forward theirs to the owner and
-    // re-elect if it dies. runLocal is the tool dispatch, serialize()-wrapped so
-    // it is the single-camera lock — covering both this instance's own calls and
-    // any forwarded from clients (the local path bypasses OwnerServer's queue). A
-    // lone instance is simply the owner with no peers: it behaves exactly as
+    // re-elect if it goes away. The owner is the newest build alive — an older
+    // owner steps down for a newer one (see
+    // docs/superpowers/specs/2026-09-27-newest-build-wins-design.md). runLocal is
+    // the bare tool dispatch; the coordinator runs it behind the single-camera
+    // lock, which covers this instance's own calls and the ones forwarded to it.
+    // A lone instance is simply the owner with no peers: it behaves exactly as
     // before, plus an idle listener.
-    const runLocal = serialize(async (name, args) => {
+    const runLocal = async (name, args) => {
         const tool = tools.find((t) => t.name === name);
         if (!tool)
             throw new Error(`unknown tool: ${name}`);
         return tool.handler(args);
+    };
+    const coordinator = new Coordinator(runLocal, {
+        build,
+        // The coordinator reports its role on every change, on STDERR (never
+        // stdout — that's the JSON-RPC channel). "Which build will run my next
+        // call" is answered by the last `ipc role=` line; the harnesses match on it.
+        log: (line) => console.error(line),
+        // What stepping down for a newer build has to let go of: the same things a
+        // clean exit does, without the exit. On macOS the control open is
+        // exclusive, so the successor cannot open the camera until this is done.
+        release: async () => {
+            capture.stopAll();
+            await mgr.shutdown();
+        },
     });
-    const coordinator = new Coordinator(runLocal);
     await coordinator.start();
-    // Report the coordination role on STDERR (never stdout — that's the JSON-RPC
-    // channel). Useful for ops ("am I the owner or a client?") and observed by the
-    // ipc-hw-smoke harness to confirm a client really forwards to the owner.
-    console.error(`obsbot-mcp: ipc role=${coordinator.roleName}`);
     // Kill any recording/preview child processes when the server exits, so nothing
     // orphans, and drop the IPC endpoint / owner connection.
     const shutdown = () => {

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -55,6 +55,12 @@ export interface PresetReadOpts {
     attempts?: number;
     backoffMs?: number[];
 }
+export interface PoseSettleOpts {
+    pollMs?: number;
+    timeoutMs?: number;
+    /** Beat between the two pose reads that decide whether the gimbal is moving. */
+    motionPollMs?: number;
+}
 export interface ZoomSettleOpts {
     pollMs?: number;
     timeoutMs?: number;