borgmcp 1.1.15 → 2.0.2

package/dist/codex-app-server.js

@@ -1,4 +1,228 @@
-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};
+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

package/dist/codex-app-server.js.map

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

package/dist/codex-app-wake.d.ts

@@ -1,4 +1,4 @@
-import { getActiveCube, getCodexWakeTarget, setCodexWakeTarget } from './cubes.js';
+import { getActiveCube, getCodexWakeTarget, setCodexWakeTarget, type ActiveCube } from './cubes.js';
 import { CodexAppServerClient } from './codex-app-server.js';
 import { checkCodexBridgeHealthy } from './codex-remote.js';
 export declare const CODEX_WAKE_PROMPT = "New Borg cube-log activity arrived.";
@@ -45,6 +45,7 @@ export interface CodexWakeDeps {
     now?: () => number;
     jitter?: () => number;
     maxAttempts?: number;
+    hasPendingWork?: (active: ActiveCube) => Promise<boolean>;
     isStreamOwner?: () => boolean;
     onAppServerSocketDead?: () => void;
 }
@@ -57,16 +58,13 @@ export declare function wakeCodexViaAppServer(reason?: string, env?: NodeJS.Proc
  */
 export declare const CODEX_HEARTBEAT_CADENCE_MS: number;
 /**
- * gh#857 WI-2: one tick of the codex /loop-equivalent heartbeat — a periodic,
- * independent re-engagement that injects a borg_read-log (unread_only=true) DRAIN turn so an
- * idle codex drone re-syncs even if every per-entry wake was missed. SKIPS when a
- * delivery (per-entry wake, retry-drain, or a prior heartbeat) already landed
- * within the cadence window (shouldFireHeartbeat), so an active cube with flowing
- * wakes never gets a redundant injection. Unlike the per-entry path it does NOT
- * consult deliveredWakeKeys — the cadence gate is the throttle, and the static
- * drain prompt is intentionally re-delivered each idle window. Best-effort: a
- * mid-turn thread / transient error / unresolved target just skips this tick (the
- * next tick retries). Never throws.
+ * gh#857/client#76: one tick of the codex catch-up backstop. The cadence only
+ * initiates a token-free unread-state preflight; a DRAIN turn is injected when
+ * that authoritative scan finds real work that a per-entry wake missed. Recent
+ * delivery still suppresses redundant preflights. Unlike the per-entry path it
+ * does not consult deliveredWakeKeys because the unread cursor is authoritative.
+ * Best-effort: a failed preflight, mid-turn thread, transient error, or unresolved
+ * target skips this tick and lets the next cadence retry. Never throws.
  */
 export declare function fireCodexHeartbeatTick(deps?: CodexWakeDeps, cadenceMs?: number): Promise<void>;
 /**

package/dist/codex-app-wake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-app-wake.d.ts","sourceRoot":"","sources":["../src/codex-app-wake.ts"],"names":[],"mappings":"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"}