borgmcp 1.0.6 → 1.0.7

package/dist/codex-app-server.js

@@ -1,228 +1,4 @@
-import net from 'node:net';
-import crypto from 'node:crypto';
-export class CodexAppServerClient {
-    socketPath;
-    socket = null;
-    buffer = Buffer.alloc(0);
-    handshaken = false;
-    nextId = 1;
-    pending = new Map();
-    constructor(socketPath) {
-        this.socketPath = socketPath;
-    }
-    async connect() {
-        if (this.socket)
-            return;
-        this.socket = net.createConnection(this.socketPath);
-        this.socket.on('data', (data) => {
-            this.buffer = Buffer.concat([this.buffer, data]);
-            this.parseIncoming();
-        });
-        this.socket.on('error', (error) => {
-            for (const pending of this.pending.values())
-                pending.reject(error);
-            this.pending.clear();
-        });
-        await new Promise((resolve, reject) => {
-            const onError = (error) => reject(error);
-            this.socket.once('error', onError);
-            this.socket.once('connect', () => {
-                this.socket.off('error', onError);
-                const key = crypto.randomBytes(16).toString('base64');
-                this.socket.write([
-                    'GET / HTTP/1.1',
-                    'Host: localhost',
-                    'Upgrade: websocket',
-                    'Connection: Upgrade',
-                    `Sec-WebSocket-Key: ${key}`,
-                    'Sec-WebSocket-Version: 13',
-                    '',
-                    '',
-                ].join('\r\n'));
-                resolve();
-            });
-        });
-        await this.waitForHandshake();
-        await this.request('initialize', {
-            clientInfo: { name: 'borgmcp', version: '0' },
-            capabilities: { experimentalApi: true, requestAttestation: false },
-        });
-        this.notify('initialized', {});
-    }
-    close() {
-        this.socket?.end();
-        this.socket = null;
-    }
-    async loadedThreadIds() {
-        const result = await this.request('thread/loaded/list', {});
-        return Array.isArray(result?.data) ? result.data.filter((id) => typeof id === 'string') : [];
-    }
-    async readThread(threadId) {
-        const result = await this.request('thread/read', { threadId, includeTurns: false });
-        const thread = result?.thread;
-        if (!thread || typeof thread.id !== 'string')
-            return null;
-        return {
-            id: thread.id,
-            cwd: thread.cwd,
-            preview: thread.preview,
-            status: thread.status,
-            updatedAt: thread.updatedAt,
-        };
-    }
-    async startTurn(threadId, text) {
-        await this.request('turn/start', {
-            threadId,
-            input: [{ type: 'text', text, text_elements: [] }],
-        });
-    }
-    waitForHandshake() {
-        return new Promise((resolve, reject) => {
-            const started = Date.now();
-            const tick = () => {
-                if (this.handshaken)
-                    return resolve();
-                if (Date.now() - started > 5_000)
-                    return reject(new Error('Timed out waiting for Codex app-server websocket handshake'));
-                setTimeout(tick, 25);
-            };
-            tick();
-        });
-    }
-    request(method, params) {
-        const id = this.nextId++;
-        this.writeJson({ id, method, params });
-        return new Promise((resolve, reject) => {
-            this.pending.set(id, { resolve, reject });
-            setTimeout(() => {
-                if (!this.pending.delete(id))
-                    return;
-                reject(new Error(`Timed out waiting for Codex app-server response to ${method}`));
-            }, 5_000);
-        });
-    }
-    notify(method, params) {
-        this.writeJson({ method, params });
-    }
-    writeJson(value) {
-        if (!this.socket)
-            throw new Error('Codex app-server socket is not connected');
-        this.socket.write(encodeWebSocketTextFrame(JSON.stringify(value)));
-    }
-    parseIncoming() {
-        if (!this.handshaken) {
-            const end = this.buffer.indexOf('\r\n\r\n');
-            if (end < 0)
-                return;
-            this.buffer = this.buffer.slice(end + 4);
-            this.handshaken = true;
-        }
-        while (this.buffer.length >= 2) {
-            const parsed = decodeWebSocketTextFrame(this.buffer);
-            if (!parsed)
-                return;
-            this.buffer = this.buffer.slice(parsed.consumed);
-            let message;
-            try {
-                message = JSON.parse(parsed.text);
-            }
-            catch {
-                continue;
-            }
-            if (typeof message.id === 'number' && this.pending.has(message.id)) {
-                const pending = this.pending.get(message.id);
-                this.pending.delete(message.id);
-                if (message.error) {
-                    pending.reject(new Error(message.error.message ?? 'Codex app-server request failed'));
-                }
-                else {
-                    pending.resolve(message.result);
-                }
-            }
-        }
-    }
-}
-export async function findLoadedCodexThread(options) {
-    const client = new CodexAppServerClient(options.socketPath);
-    await client.connect();
-    try {
-        const ids = await client.loadedThreadIds();
-        let best = null;
-        for (const id of ids) {
-            const thread = await client.readThread(id);
-            if (!thread)
-                continue;
-            if (thread.cwd !== options.cwd)
-                continue;
-            if (!thread.preview.includes(options.previewIncludes))
-                continue;
-            if (thread.updatedAt < options.updatedAfter)
-                continue;
-            if (!best || thread.updatedAt > best.updatedAt)
-                best = thread;
-        }
-        return best?.id ?? null;
-    }
-    finally {
-        client.close();
-    }
-}
-function encodeWebSocketTextFrame(text) {
-    const payload = Buffer.from(text);
-    let header;
-    if (payload.length < 126) {
-        header = Buffer.alloc(2);
-        header[1] = 0x80 | payload.length;
-    }
-    else if (payload.length <= 0xffff) {
-        header = Buffer.alloc(4);
-        header[1] = 0x80 | 126;
-        header.writeUInt16BE(payload.length, 2);
-    }
-    else {
-        header = Buffer.alloc(10);
-        header[1] = 0x80 | 127;
-        header.writeBigUInt64BE(BigInt(payload.length), 2);
-    }
-    header[0] = 0x81;
-    const mask = crypto.randomBytes(4);
-    const framed = Buffer.alloc(header.length + mask.length + payload.length);
-    header.copy(framed, 0);
-    mask.copy(framed, header.length);
-    for (let i = 0; i < payload.length; i += 1) {
-        framed[header.length + mask.length + i] = payload[i] ^ mask[i % mask.length];
-    }
-    return framed;
-}
-function decodeWebSocketTextFrame(buffer) {
-    let payloadLength = buffer[1] & 0x7f;
-    let offset = 2;
-    if (payloadLength === 126) {
-        if (buffer.length < 4)
-            return null;
-        payloadLength = buffer.readUInt16BE(2);
-        offset = 4;
-    }
-    else if (payloadLength === 127) {
-        if (buffer.length < 10)
-            return null;
-        payloadLength = Number(buffer.readBigUInt64BE(2));
-        offset = 10;
-    }
-    const masked = (buffer[1] & 0x80) !== 0;
-    let mask = null;
-    if (masked) {
-        if (buffer.length < offset + 4)
-            return null;
-        mask = buffer.slice(offset, offset + 4);
-        offset += 4;
-    }
-    if (buffer.length < offset + payloadLength)
-        return null;
-    let payload = buffer.slice(offset, offset + payloadLength);
-    if (mask) {
-        payload = Buffer.from(payload.map((byte, index) => byte ^ mask[index % 4]));
-    }
-    return { text: payload.toString('utf8'), consumed: offset + payloadLength };
-}
-//# sourceMappingURL=codex-app-server.js.map
+import d from"node:net";import o from"node:crypto";class l{socketPath;socket=null;buffer=Buffer.alloc(0);handshaken=!1;nextId=1;pending=new Map;constructor(e){this.socketPath=e}async connect(){this.socket||(this.socket=d.createConnection(this.socketPath),this.socket.on("data",e=>{this.buffer=Buffer.concat([this.buffer,e]),this.parseIncoming()}),this.socket.on("error",e=>{for(const t of this.pending.values())t.reject(e);this.pending.clear()}),await new Promise((e,t)=>{const n=r=>t(r);this.socket.once("error",n),this.socket.once("connect",()=>{this.socket.off("error",n);const r=o.randomBytes(16).toString("base64");this.socket.write(["GET / HTTP/1.1","Host: localhost","Upgrade: websocket","Connection: Upgrade",`Sec-WebSocket-Key: ${r}`,"Sec-WebSocket-Version: 13","",""].join(`\r
+`)),e()})}),await this.waitForHandshake(),await this.request("initialize",{clientInfo:{name:"borgmcp",version:"0"},capabilities:{experimentalApi:!0,requestAttestation:!1}}),this.notify("initialized",{}))}close(){this.socket?.end(),this.socket=null}async loadedThreadIds(){const e=await this.request("thread/loaded/list",{});return Array.isArray(e?.data)?e.data.filter(t=>typeof t=="string"):[]}async readThread(e){const n=(await this.request("thread/read",{threadId:e,includeTurns:!1}))?.thread;return!n||typeof n.id!="string"?null:{id:n.id,cwd:n.cwd,preview:n.preview,status:n.status,updatedAt:n.updatedAt}}async startTurn(e,t){await this.request("turn/start",{threadId:e,input:[{type:"text",text:t,text_elements:[]}]})}waitForHandshake(){return new Promise((e,t)=>{const n=Date.now(),r=()=>{if(this.handshaken)return e();if(Date.now()-n>5e3)return t(new Error("Timed out waiting for Codex app-server websocket handshake"));setTimeout(r,25)};r()})}request(e,t){const n=this.nextId++;return this.writeJson({id:n,method:e,params:t}),new Promise((r,i)=>{this.pending.set(n,{resolve:r,reject:i}),setTimeout(()=>{this.pending.delete(n)&&i(new Error(`Timed out waiting for Codex app-server response to ${e}`))},5e3)})}notify(e,t){this.writeJson({method:e,params:t})}writeJson(e){if(!this.socket)throw new Error("Codex app-server socket is not connected");this.socket.write(h(JSON.stringify(e)))}parseIncoming(){if(!this.handshaken){const e=this.buffer.indexOf(`\r
+\r
+`);if(e<0)return;this.buffer=this.buffer.slice(e+4),this.handshaken=!0}for(;this.buffer.length>=2;){const e=f(this.buffer);if(!e)return;this.buffer=this.buffer.slice(e.consumed);let t;try{t=JSON.parse(e.text)}catch{continue}if(typeof t.id=="number"&&this.pending.has(t.id)){const n=this.pending.get(t.id);this.pending.delete(t.id),t.error?n.reject(new Error(t.error.message??"Codex app-server request failed")):n.resolve(t.result)}}}}async function g(s){const e=new l(s.socketPath);await e.connect();try{const t=await e.loadedThreadIds();let n=null;for(const r of t){const i=await e.readThread(r);i&&i.cwd===s.cwd&&i.preview.includes(s.previewIncludes)&&(i.updatedAt<s.updatedAfter||(!n||i.updatedAt>n.updatedAt)&&(n=i))}return n?.id??null}finally{e.close()}}function h(s){const e=Buffer.from(s);let t;e.length<126?(t=Buffer.alloc(2),t[1]=128|e.length):e.length<=65535?(t=Buffer.alloc(4),t[1]=254,t.writeUInt16BE(e.length,2)):(t=Buffer.alloc(10),t[1]=255,t.writeBigUInt64BE(BigInt(e.length),2)),t[0]=129;const n=o.randomBytes(4),r=Buffer.alloc(t.length+n.length+e.length);t.copy(r,0),n.copy(r,t.length);for(let i=0;i<e.length;i+=1)r[t.length+n.length+i]=e[i]^n[i%n.length];return r}function f(s){let e=s[1]&127,t=2;if(e===126){if(s.length<4)return null;e=s.readUInt16BE(2),t=4}else if(e===127){if(s.length<10)return null;e=Number(s.readBigUInt64BE(2)),t=10}const n=(s[1]&128)!==0;let r=null;if(n){if(s.length<t+4)return null;r=s.slice(t,t+4),t+=4}if(s.length<t+e)return null;let i=s.slice(t,t+e);return r&&(i=Buffer.from(i.map((a,c)=>a^r[c%4]))),{text:i.toString("utf8"),consumed:t+e}}export{l as CodexAppServerClient,g as findLoadedCodexThread};

package/dist/codex-app-wake.js

@@ -1,122 +1,2 @@
-import { getActiveCube, getCodexWakeTarget } from './cubes.js';
-import { CodexAppServerClient } from './codex-app-server.js';
-import { checkCodexBridgeHealthy } from './codex-remote.js';
-import { recordEventReceipt } from './health-beat.js';
-export const CODEX_WAKE_PROMPT = 'New Borg cube-log activity arrived.';
-export function formatCodexWakePrompt(inboxLine) {
-    return `New Borg cube-log activity arrived:\n${inboxLine}`;
-}
-export function isCodexRemoteWakeEnabled(env = process.env) {
-    return env.BORG_CODEX_REMOTE_WAKE === '1';
-}
-export function resolveSessionAgentKind(env = process.env) {
-    return isCodexRemoteWakeEnabled(env) ? 'codex' : 'claude';
-}
-export function resolveCodexWakeTarget(env = process.env) {
-    if (!isCodexRemoteWakeEnabled(env)) {
-        return { enabled: false };
-    }
-    return { enabled: true };
-}
-/**
- * gh#633: resolve a codex drone's transport-agnostic "wake-path-armed" signal
- * from its OWN runtime wake mechanism — the app-server bridge's process
- * liveness, the codex analogue of the claude tail-F Monitor health. Fed into
- * the health beat so the HOP-2 wake-path-deaf classifier reads a
- * transport-agnostic armed signal instead of the claude-shaped monitor_armed
- * (which is false-by-design for codex and falsely flagged them, gh#633).
- *
- * Tri-state (boolean|null; caller maps null→armed for false-deaf-avoidance):
- *   - false ONLY on a positively-dead bridge: no wake target registered (the
- *     bridge cannot deliver wakes), OR the app-server pid is dead.
- *   - true when the wake target resolves AND the app-server pid is alive.
- *   - null when the bridge health is indeterminate (target read or pid check
- *     could not resolve) → armed (don't false-flag on uncertainty).
- */
-export async function probeCodexBridgeArmed(active, deps = {}) {
-    try {
-        const resolve = deps.getCodexWakeTarget ?? getCodexWakeTarget;
-        const target = await resolve(active.cubeId, active.droneId);
-        // No registered wake target → the bridge cannot deliver a wake → not armed.
-        if (!target)
-            return false;
-        const check = deps.checkBridge ?? checkCodexBridgeHealthy;
-        return check(target.socketPath);
-    }
-    catch {
-        return null;
-    }
-}
-let wakeInFlight = false;
-const pendingWakeRequests = [];
-const deliveredWakeKeys = new Set();
-const deliveredWakeKeyOrder = [];
-const DELIVERED_WAKE_KEY_CAP = 100;
-export function wakeCodexViaAppServer(reason = CODEX_WAKE_PROMPT, env = process.env, deps = {}) {
-    const target = resolveCodexWakeTarget(env);
-    if (!target.enabled)
-        return;
-    pendingWakeRequests.push({ reason, deps });
-    if (wakeInFlight)
-        return;
-    wakeInFlight = true;
-    void drainCodexWakeQueue().finally(() => {
-        wakeInFlight = false;
-    });
-}
-async function drainCodexWakeQueue() {
-    while (pendingWakeRequests.length > 0) {
-        const request = pendingWakeRequests.shift();
-        await wakeCodexTargeted(request.reason, request.deps);
-    }
-}
-async function wakeCodexTargeted(reason, deps) {
-    try {
-        const active = await (deps.getActiveCube ?? getActiveCube)();
-        if (!active)
-            return;
-        const target = await (deps.getCodexWakeTarget ?? getCodexWakeTarget)(active.cubeId, active.droneId);
-        if (!target)
-            return;
-        const wakeKey = `${target.threadId}\0${reason}`;
-        if (deliveredWakeKeys.has(wakeKey))
-            return;
-        const client = deps.createClient
-            ? deps.createClient(target.socketPath)
-            : new CodexAppServerClient(target.socketPath);
-        await client.connect();
-        try {
-            const thread = await client.readThread(target.threadId);
-            if (thread?.status?.type === 'active') {
-                return;
-            }
-            await client.startTurn(target.threadId, reason);
-            recordEventReceipt();
-            rememberDeliveredWake(wakeKey);
-        }
-        finally {
-            client.close();
-        }
-    }
-    catch {
-        // Best-effort wake path: never break the Borg SSE stream.
-    }
-}
-export function resetCodexWakeForTests() {
-    wakeInFlight = false;
-    pendingWakeRequests.length = 0;
-    deliveredWakeKeys.clear();
-    deliveredWakeKeyOrder.length = 0;
-}
-function rememberDeliveredWake(key) {
-    if (deliveredWakeKeys.has(key))
-        return;
-    deliveredWakeKeys.add(key);
-    deliveredWakeKeyOrder.push(key);
-    while (deliveredWakeKeyOrder.length > DELIVERED_WAKE_KEY_CAP) {
-        const oldKey = deliveredWakeKeyOrder.shift();
-        if (oldKey)
-            deliveredWakeKeys.delete(oldKey);
-    }
-}
-//# sourceMappingURL=codex-app-wake.js.map
+import{getActiveCube as f,getCodexWakeTarget as u}from"./cubes.js";import{CodexAppServerClient as h}from"./codex-app-server.js";import{checkCodexBridgeHealthy as g}from"./codex-remote.js";import{recordEventReceipt as p}from"./health-beat.js";const v="New Borg cube-log activity arrived.";function T(e){return`New Borg cube-log activity arrived:
+${e}`}function l(e=process.env){return e.BORG_CODEX_REMOTE_WAKE==="1"}function I(e=process.env){return l(e)?"codex":"claude"}function x(e=process.env){return l(e)?{enabled:!0}:{enabled:!1}}async function K(e,t={}){try{const r=await(t.getCodexWakeTarget??u)(e.cubeId,e.droneId);return r?(t.checkBridge??g)(r.socketPath):!1}catch{return null}}let c=!1;const i=[],o=new Set,s=[],k=100;function _(e=v,t=process.env,n={}){x(t).enabled&&(i.push({reason:e,deps:n}),!c&&(c=!0,C().finally(()=>{c=!1})))}async function C(){for(;i.length>0;){const e=i.shift();await w(e.reason,e.deps)}}async function w(e,t){try{const n=await(t.getActiveCube??f)();if(!n)return;const r=await(t.getCodexWakeTarget??u)(n.cubeId,n.droneId);if(!r)return;const d=`${r.threadId}\0${e}`;if(o.has(d))return;const a=t.createClient?t.createClient(r.socketPath):new h(r.socketPath);await a.connect();try{if((await a.readThread(r.threadId))?.status?.type==="active")return;await a.startTurn(r.threadId,e),p(),W(d)}finally{a.close()}}catch{}}function P(){c=!1,i.length=0,o.clear(),s.length=0}function W(e){if(!o.has(e))for(o.add(e),s.push(e);s.length>k;){const t=s.shift();t&&o.delete(t)}}export{v as CODEX_WAKE_PROMPT,T as formatCodexWakePrompt,l as isCodexRemoteWakeEnabled,K as probeCodexBridgeArmed,P as resetCodexWakeForTests,x as resolveCodexWakeTarget,I as resolveSessionAgentKind,_ as wakeCodexViaAppServer};

package/dist/codex-launch.js

@@ -1,81 +1 @@
-export function buildAgentKickoffPrompt(options) {
-    const codexNonceClause = options.codexWakeNonce
-        ? `Wake target nonce: ${options.codexWakeNonce}. `
-        : '';
-    const loopFreshnessClause = `On every Monitor wake and every ScheduleWakeup heartbeat, triage with borg:read-log unread_only=true first — it returns only entries since your last read, advancing your server-side read cursor (oldest-unread first), so you never skip a burst; and it keeps last_seen fresh. DRAIN: if it returns a full set (count == limit) or borg:roster shows behind_by>0, call read-log unread_only=true again until the return is < limit. Do NOT triage with a manual since cursor or a bare limit window — since is strict-after (skips the boundary entry) and a limit-bounded read skips older-unread during bursts (and codex has no per-entry inbox-Monitor backstop to catch them); reserve limit for explicit bounded reads. Call borg:regen only when you are about to act and need full cube/role/roster context, on session start, after context compaction, or periodically every 4-5 wakes / 15-30 minutes. Never reflexively call borg:regen for routine text-only wakes. `;
-    const codexWakePathClause = options.codexWakePathClause ??
-        `Codex Borg wakeups use remote-control when available; if no wake arrives, run borg:regen manually when returning to the session.`;
-    return (`${options.cli === 'claude' ? '/loop ' : ''}Call borg:regen and follow the playbook in its response. ` +
-        codexNonceClause +
-        `Note: at session start the borg MCP server is still spinning up in ` +
-        `parallel — if a system reminder claims "MCP server disconnected" or ` +
-        `the borg: tools are not yet registered, do NOT bail. Recover via ` +
-        `\`ToolSearch({query: "select:mcp__borg__borg_regen,mcp__borg__borg_log,Monitor", max_results: 3})\` ` +
-        `to load the bootstrap tools in one call, then call borg:regen. ` +
-        `The server typically becomes available within a few seconds. ` +
-        options.monitorClause +
-        `Coordinator/Queen seats: before posting bare \`Standing.\`, run the ` +
-        `anti-passive-Standing stale-check per your role text — for every ` +
-        `in-flight dispatch / REVIEW-READY / synthesis-pending, compare ` +
-        `elapsed-since-last-transition against the cadence-table PING ` +
-        `thresholds; escalate per the 4-step ladder (PING / probe-liveness / ` +
-        `reassign / suspect-systemic) when any row is overdue. Append the ` +
-        `awaited signal when you do post Standing (\`Standing for X\`, never ` +
-        `bare). ` +
-        loopFreshnessClause +
-        (options.cli === 'claude'
-            ? `Wake-path capability check: if borg:regen shows a wake-path warning, arm the Monitor before starting work. Use a 30-minute (1800s) fallback heartbeat for ScheduleWakeup.`
-            : codexWakePathClause));
-}
-export function socketPathFromRemoteArgs(args) {
-    const index = args.indexOf('--remote');
-    if (index < 0)
-        return null;
-    const value = args[index + 1];
-    if (!value?.startsWith('unix://'))
-        return null;
-    return value.slice('unix://'.length);
-}
-export function threadIdFromPassthroughArgs(args) {
-    if (args[0] === 'resume' && args[1] && !args[1].startsWith('-'))
-        return args[1];
-    const resumeIndex = args.indexOf('--resume');
-    if (resumeIndex >= 0 && args[resumeIndex + 1])
-        return args[resumeIndex + 1];
-    return null;
-}
-export async function recordCodexWakeTarget(options) {
-    try {
-        const explicitThreadId = options.passthroughArgs
-            ? threadIdFromPassthroughArgs(options.passthroughArgs)
-            : null;
-        if (explicitThreadId) {
-            await options.deps.setCodexWakeTarget(options.cubeId, options.droneId, {
-                threadId: explicitThreadId,
-                socketPath: options.socketPath,
-            });
-            return;
-        }
-        const deadline = Date.now() + 15_000;
-        while (Date.now() < deadline) {
-            const threadId = await options.deps.findLoadedCodexThread({
-                socketPath: options.socketPath,
-                cwd: options.cwd,
-                previewIncludes: options.previewNeedle,
-                updatedAfter: options.launchedAtSeconds - 5,
-            });
-            if (threadId) {
-                await options.deps.setCodexWakeTarget(options.cubeId, options.droneId, {
-                    threadId,
-                    socketPath: options.socketPath,
-                });
-                return;
-            }
-            await new Promise((resolve) => setTimeout(resolve, 500));
-        }
-    }
-    catch {
-        // Best-effort mapping: launch still succeeds and manual regen remains available.
-    }
-}
-//# sourceMappingURL=codex-launch.js.map
+function s(e){const r=e.codexWakeNonce?`Wake target nonce: ${e.codexWakeNonce}. `:"",t="On every Monitor wake and every ScheduleWakeup heartbeat, triage with borg:read-log unread_only=true first \u2014 it returns only entries since your last read, advancing your server-side read cursor (oldest-unread first), so you never skip a burst; and it keeps last_seen fresh. DRAIN: if it returns a full set (count == limit) or borg:roster shows behind_by>0, call read-log unread_only=true again until the return is < limit. Do NOT triage with a manual since cursor or a bare limit window \u2014 since is strict-after (skips the boundary entry) and a limit-bounded read skips older-unread during bursts (and codex has no per-entry inbox-Monitor backstop to catch them); reserve limit for explicit bounded reads. Call borg:regen only when you are about to act and need full cube/role/roster context, on session start, after context compaction, or periodically every 4-5 wakes / 15-30 minutes. Never reflexively call borg:regen for routine text-only wakes. ",a=e.codexWakePathClause??"Codex Borg wakeups use remote-control when available; if no wake arrives, run borg:regen manually when returning to the session.";return`${e.cli==="claude"?"/loop ":""}Call borg:regen and follow the playbook in its response. `+r+'Note: at session start the borg MCP server is still spinning up in parallel \u2014 if a system reminder claims "MCP server disconnected" or the borg: tools are not yet registered, do NOT bail. Recover via `ToolSearch({query: "select:mcp__borg__borg_regen,mcp__borg__borg_log,Monitor", max_results: 3})` to load the bootstrap tools in one call, then call borg:regen. The server typically becomes available within a few seconds. '+e.monitorClause+"Coordinator/Queen seats: before posting bare `Standing.`, run the anti-passive-Standing stale-check per your role text \u2014 for every in-flight dispatch / REVIEW-READY / synthesis-pending, compare elapsed-since-last-transition against the cadence-table PING thresholds; escalate per the 4-step ladder (PING / probe-liveness / reassign / suspect-systemic) when any row is overdue. Append the awaited signal when you do post Standing (`Standing for X`, never bare). "+t+(e.cli==="claude"?"Wake-path capability check: if borg:regen shows a wake-path warning, arm the Monitor before starting work. Use a 30-minute (1800s) fallback heartbeat for ScheduleWakeup.":a)}function i(e){const r=e.indexOf("--remote");if(r<0)return null;const t=e[r+1];return t?.startsWith("unix://")?t.slice(7):null}function o(e){if(e[0]==="resume"&&e[1]&&!e[1].startsWith("-"))return e[1];const r=e.indexOf("--resume");return r>=0&&e[r+1]?e[r+1]:null}async function l(e){try{const r=e.passthroughArgs?o(e.passthroughArgs):null;if(r){await e.deps.setCodexWakeTarget(e.cubeId,e.droneId,{threadId:r,socketPath:e.socketPath});return}const t=Date.now()+15e3;for(;Date.now()<t;){const a=await e.deps.findLoadedCodexThread({socketPath:e.socketPath,cwd:e.cwd,previewIncludes:e.previewNeedle,updatedAfter:e.launchedAtSeconds-5});if(a){await e.deps.setCodexWakeTarget(e.cubeId,e.droneId,{threadId:a,socketPath:e.socketPath});return}await new Promise(n=>setTimeout(n,500))}}catch{}}export{s as buildAgentKickoffPrompt,l as recordCodexWakeTarget,i as socketPathFromRemoteArgs,o as threadIdFromPassthroughArgs};