backeer-codex 0.7.1 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.codex-plugin/plugin.json +1 -1
- package/README.md +11 -1
- package/dist/opencode.mjs +177 -17
- package/package.json +4 -2
- package/plugin.json +1 -1
- package/skills/backeer/SKILL.md +18 -0
- package/src/opencode.mjs +9 -1
package/README.md
CHANGED
|
@@ -212,6 +212,16 @@ The MCP tools `list_questions` and `answer_question` read pending ordinary quest
|
|
|
212
212
|
|
|
213
213
|
### Usage quotas
|
|
214
214
|
|
|
215
|
-
The bundled adapter
|
|
215
|
+
The bundled adapter now bounds retained SSE history to 10000 events / 16 MiB per binding by default. Set positive BACKEER_LIVE_MAX_EVENTS and BACKEER_LIVE_MAX_BUFFER_BYTES values before launching the process to customize it. Expired history returns an explicit gap. MCP reads default to 100 events / 16000 event-JSON characters and paginate with a cursor; an oversized event returns requiredMaxChars. Other profile/session/question/prompt policies are unchanged. These budgets limit retained serialized payloads, not total process memory.
|
|
216
216
|
|
|
217
217
|
Each chat receives only its selected session's SSE output, avoiding unrelated project output in every chat buffer. Concurrent callers share in-flight verification only for the same exact session, with cancellable reader cleanup.
|
|
218
|
+
|
|
219
|
+
### Reliability in 0.8.0
|
|
220
|
+
|
|
221
|
+
`backeer-codex opencode verify <name> "<exact session title>"` and the
|
|
222
|
+
`verify_connection` MCP tool test authentication, project/session ownership and SSE
|
|
223
|
+
without sending work or replacing the session. Status distinguishes installation
|
|
224
|
+
evidence, loaded runtime, reachable bridge and verified session/stream; unknown is
|
|
225
|
+
not the same as missing. The bundled adapter includes bounded history and paged
|
|
226
|
+
reads. Use persistent waits and cursors to avoid repeated context; no summarization
|
|
227
|
+
model is called. New code requires a new plugin process/chat.
|
package/dist/opencode.mjs
CHANGED
|
@@ -13014,6 +13014,7 @@ var details = Object.freeze({
|
|
|
13014
13014
|
invalid_bridge_response: ["The bridge returned an unexpected response.", "Check that the tunnel points to the Backeer bridge and that the versions are compatible.", false],
|
|
13015
13015
|
protected_token_file_missing: ["The protected credential file was not found.", "Select an existing protected credential file. Supply its path, never its contents.", false],
|
|
13016
13016
|
token_file_not_private_or_invalid: ["The credential file cannot be used safely.", "Check the selected file and its owner-only permissions. Do not expose or recreate the credential.", false],
|
|
13017
|
+
stream_payload_limit: ["The event stream exceeded the configured memory budget.", "Increase the explicit buffer budget and reconnect this same session. No automatic retry or output acknowledgement was performed.", false],
|
|
13017
13018
|
cancelled: ["The local operation was cancelled.", "Retry only if the user still wants this operation.", false],
|
|
13018
13019
|
connection_unavailable: ["The connection could not be verified.", "Check the existing tunnel and bridge; keep the selected session unchanged.", true]
|
|
13019
13020
|
});
|
|
@@ -13060,6 +13061,24 @@ function safeLiveErrorMessage(error62) {
|
|
|
13060
13061
|
if (/^Live-control request failed \(HTTP \d{3}\)$/.test(error62?.message)) return error62.message;
|
|
13061
13062
|
}
|
|
13062
13063
|
|
|
13064
|
+
// ../opencode-plugin/src/live-limits.js
|
|
13065
|
+
var DEFAULT_MAX_EVENTS = 1e4;
|
|
13066
|
+
var DEFAULT_MAX_BUFFER_BYTES = 16 * 1024 * 1024;
|
|
13067
|
+
var DEFAULT_READ_LIMIT = 100;
|
|
13068
|
+
var DEFAULT_READ_CHARS = 16e3;
|
|
13069
|
+
function positiveLimit(value, fallback) {
|
|
13070
|
+
if (value === void 0) return fallback;
|
|
13071
|
+
const number4 = Number(value);
|
|
13072
|
+
if (!Number.isSafeInteger(number4) || number4 < 1) throw new Error("Live buffer limits must be positive safe integers");
|
|
13073
|
+
return number4;
|
|
13074
|
+
}
|
|
13075
|
+
function liveLimits(options = {}, env = process.env) {
|
|
13076
|
+
return {
|
|
13077
|
+
maxEvents: positiveLimit(options.maxEvents ?? env.BACKEER_LIVE_MAX_EVENTS, DEFAULT_MAX_EVENTS),
|
|
13078
|
+
maxBufferBytes: positiveLimit(options.maxBufferBytes ?? env.BACKEER_LIVE_MAX_BUFFER_BYTES, DEFAULT_MAX_BUFFER_BYTES)
|
|
13079
|
+
};
|
|
13080
|
+
}
|
|
13081
|
+
|
|
13063
13082
|
// ../opencode-plugin/src/live-control-client.js
|
|
13064
13083
|
var CURSOR = /^[A-Za-z0-9_-]+:\d+$/;
|
|
13065
13084
|
var SESSION = /^[A-Za-z0-9_-]+$/;
|
|
@@ -13120,9 +13139,10 @@ var LiveControlClient = class {
|
|
|
13120
13139
|
url: url2 = "http://127.0.0.1:43871",
|
|
13121
13140
|
token,
|
|
13122
13141
|
fetchImpl = fetch,
|
|
13123
|
-
maxEvents
|
|
13124
|
-
maxBufferBytes
|
|
13142
|
+
maxEvents,
|
|
13143
|
+
maxBufferBytes,
|
|
13125
13144
|
reconnectMs = LIVE_RECONNECT_MS,
|
|
13145
|
+
staleMs = LIVE_STALE_MS,
|
|
13126
13146
|
expectedDirectory,
|
|
13127
13147
|
sessionId
|
|
13128
13148
|
} = {}) {
|
|
@@ -13134,9 +13154,11 @@ var LiveControlClient = class {
|
|
|
13134
13154
|
this.sessionId = sessionId;
|
|
13135
13155
|
this.projectHeaders = expectedDirectory === void 0 ? {} : { "X-Backeer-Project": encodeURIComponent(expectedDirectory) };
|
|
13136
13156
|
this.fetch = fetchImpl;
|
|
13137
|
-
this
|
|
13138
|
-
this.
|
|
13157
|
+
Object.assign(this, liveLimits({ maxEvents, maxBufferBytes }));
|
|
13158
|
+
this.evictedEvents = 0;
|
|
13139
13159
|
this.reconnectMs = reconnectMs;
|
|
13160
|
+
if (!Number.isSafeInteger(staleMs) || staleMs < 1) throw new Error("Invalid heartbeat timeout");
|
|
13161
|
+
this.staleMs = staleMs;
|
|
13140
13162
|
this.events = [];
|
|
13141
13163
|
this.eventPositions = /* @__PURE__ */ new Map();
|
|
13142
13164
|
this.eventOffset = 0;
|
|
@@ -13185,9 +13207,9 @@ var LiveControlClient = class {
|
|
|
13185
13207
|
let code, connectionCode;
|
|
13186
13208
|
try {
|
|
13187
13209
|
if (response.headers.get("content-type")?.includes("application/json")) {
|
|
13188
|
-
const
|
|
13189
|
-
if (Object.hasOwn(liveErrorMessages,
|
|
13190
|
-
if (
|
|
13210
|
+
const value2 = JSON.parse(await responseText(response));
|
|
13211
|
+
if (Object.hasOwn(liveErrorMessages, value2?.error)) code = value2.error;
|
|
13212
|
+
if (value2?.error === "project_mismatch") connectionCode = "project_mismatch";
|
|
13191
13213
|
}
|
|
13192
13214
|
} catch {
|
|
13193
13215
|
} finally {
|
|
@@ -13201,7 +13223,9 @@ var LiveControlClient = class {
|
|
|
13201
13223
|
);
|
|
13202
13224
|
}
|
|
13203
13225
|
const text = await responseText(response);
|
|
13204
|
-
|
|
13226
|
+
const value = JSON.parse(text);
|
|
13227
|
+
if (path3 === "/v1/sessions") this.bridgeInfo = { bridgeVersion: value?.bridgeVersion };
|
|
13228
|
+
return value;
|
|
13205
13229
|
} catch (error62) {
|
|
13206
13230
|
const diagnostic = connectionDiagnostic(error62, {
|
|
13207
13231
|
session: /^\/v1\/sessions\//.test(path3),
|
|
@@ -13298,7 +13322,7 @@ var LiveControlClient = class {
|
|
|
13298
13322
|
const connection2 = new AbortController();
|
|
13299
13323
|
const abort = () => connection2.abort();
|
|
13300
13324
|
this.controller.signal.addEventListener("abort", abort, { once: true });
|
|
13301
|
-
const armWatchdog = (ms =
|
|
13325
|
+
const armWatchdog = (ms = this.staleMs) => {
|
|
13302
13326
|
clearTimeout(watchdog);
|
|
13303
13327
|
watchdog = setTimeout(() => {
|
|
13304
13328
|
timedOut = true;
|
|
@@ -13363,6 +13387,7 @@ var LiveControlClient = class {
|
|
|
13363
13387
|
buffer = buffer.replace(/\r\n|\r(?!$)/g, "\n");
|
|
13364
13388
|
let at;
|
|
13365
13389
|
while ((at = buffer.indexOf("\n\n")) !== -1) {
|
|
13390
|
+
if (Buffer.byteLength(buffer.slice(0, at)) > this.maxBufferBytes + 4096) throw Object.assign(new Error("SSE frame exceeds buffer limit"), { connectionCode: "stream_payload_limit" });
|
|
13366
13391
|
const frame = parseFrame(buffer.slice(0, at));
|
|
13367
13392
|
buffer = buffer.slice(at + 2);
|
|
13368
13393
|
if (!frame) continue;
|
|
@@ -13385,11 +13410,17 @@ var LiveControlClient = class {
|
|
|
13385
13410
|
if (!this.retainEvent(event)) continue;
|
|
13386
13411
|
this.notify();
|
|
13387
13412
|
}
|
|
13413
|
+
if (Buffer.byteLength(buffer) > this.maxBufferBytes + 4096) throw Object.assign(new Error("SSE frame exceeds buffer limit"), { connectionCode: "stream_payload_limit" });
|
|
13388
13414
|
}
|
|
13389
13415
|
} catch (error62) {
|
|
13390
13416
|
if (!this.controller.signal.aborted) {
|
|
13391
13417
|
if (this.status !== "unauthorized") this.status = "disconnected";
|
|
13392
13418
|
this.recordFailure(error62, { timeout: timedOut });
|
|
13419
|
+
if (error62.connectionCode === "stream_payload_limit") {
|
|
13420
|
+
this.status = "blocked";
|
|
13421
|
+
this.notify();
|
|
13422
|
+
return;
|
|
13423
|
+
}
|
|
13393
13424
|
}
|
|
13394
13425
|
} finally {
|
|
13395
13426
|
clearTimeout(watchdog);
|
|
@@ -13421,9 +13452,18 @@ var LiveControlClient = class {
|
|
|
13421
13452
|
}
|
|
13422
13453
|
retainEvent(event) {
|
|
13423
13454
|
if (this.eventPositions.has(event.id)) return false;
|
|
13455
|
+
const [epoch, sequence] = event.id.split(":");
|
|
13456
|
+
const [currentEpoch, currentSequence] = (this.cursor ?? "").split(":");
|
|
13457
|
+
if (epoch === currentEpoch && Number(sequence) <= Number(currentSequence)) return false;
|
|
13424
13458
|
const encoded = JSON.stringify(event);
|
|
13425
13459
|
const bytes = Buffer.byteLength(encoded);
|
|
13426
|
-
if (bytes > this.maxBufferBytes)
|
|
13460
|
+
if (bytes > this.maxBufferBytes) {
|
|
13461
|
+
this.evictedEvents += this.events.length + 1;
|
|
13462
|
+
this.clearEvents();
|
|
13463
|
+
this.cursor = this.floor = event.id;
|
|
13464
|
+
this.gap = { reason: "event_exceeds_buffer_limit", cursor: event.id };
|
|
13465
|
+
return true;
|
|
13466
|
+
}
|
|
13427
13467
|
this.eventPositions.set(event.id, this.eventOffset + this.events.length);
|
|
13428
13468
|
this.events.push({ event, bytes, chars: encoded.length });
|
|
13429
13469
|
this.bufferBytes += bytes;
|
|
@@ -13432,6 +13472,7 @@ var LiveControlClient = class {
|
|
|
13432
13472
|
const discarded = this.events.shift();
|
|
13433
13473
|
this.eventPositions.delete(discarded.event.id);
|
|
13434
13474
|
this.eventOffset++;
|
|
13475
|
+
this.evictedEvents++;
|
|
13435
13476
|
this.bufferBytes -= discarded.bytes;
|
|
13436
13477
|
this.floor = discarded.event.id;
|
|
13437
13478
|
}
|
|
@@ -13454,6 +13495,10 @@ var LiveControlClient = class {
|
|
|
13454
13495
|
nextRetryAt: this.nextRetryAt,
|
|
13455
13496
|
diagnostic: this.lastDiagnostic,
|
|
13456
13497
|
bufferedEvents: this.events.length,
|
|
13498
|
+
bufferedBytes: this.bufferBytes,
|
|
13499
|
+
maxEvents: this.maxEvents,
|
|
13500
|
+
maxBufferBytes: this.maxBufferBytes,
|
|
13501
|
+
evictedEvents: this.evictedEvents,
|
|
13457
13502
|
cursor: this.cursor,
|
|
13458
13503
|
...this.gap ? { gap: this.gap } : {}
|
|
13459
13504
|
};
|
|
@@ -13498,11 +13543,36 @@ var LiveControlClient = class {
|
|
|
13498
13543
|
transport: this.connectionState()
|
|
13499
13544
|
};
|
|
13500
13545
|
}
|
|
13546
|
+
async waitForConnection(timeoutMs = 5e3, signal) {
|
|
13547
|
+
if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1) throw new Error("Invalid connection timeout");
|
|
13548
|
+
await this.start();
|
|
13549
|
+
if (signal?.aborted || this.controller.signal.aborted) return false;
|
|
13550
|
+
if (this.status === "connected") return true;
|
|
13551
|
+
return new Promise((resolve) => {
|
|
13552
|
+
let timer;
|
|
13553
|
+
const done = () => {
|
|
13554
|
+
clearTimeout(timer);
|
|
13555
|
+
this.listeners.delete(check2);
|
|
13556
|
+
signal?.removeEventListener("abort", done);
|
|
13557
|
+
this.controller.signal.removeEventListener("abort", done);
|
|
13558
|
+
resolve(this.status === "connected" && !signal?.aborted && !this.controller.signal.aborted);
|
|
13559
|
+
};
|
|
13560
|
+
const check2 = () => {
|
|
13561
|
+
if (["connected", "unauthorized", "closed", "blocked", "resync_required"].includes(this.status)) done();
|
|
13562
|
+
};
|
|
13563
|
+
timer = setTimeout(done, timeoutMs);
|
|
13564
|
+
this.listeners.add(check2);
|
|
13565
|
+
signal?.addEventListener("abort", done, { once: true });
|
|
13566
|
+
this.controller.signal.addEventListener("abort", done, { once: true });
|
|
13567
|
+
if (signal?.aborted || this.controller.signal.aborted) done();
|
|
13568
|
+
else check2();
|
|
13569
|
+
});
|
|
13570
|
+
}
|
|
13501
13571
|
async readEvents(options = {}, { waitMs = 0, signal } = {}) {
|
|
13502
13572
|
if (waitMs !== Infinity && (!Number.isSafeInteger(waitMs) || waitMs < 0)) throw new Error("Wait must be a nonnegative safe integer or unlimited");
|
|
13503
13573
|
await this.start(options.afterCursor);
|
|
13504
13574
|
let result = this.snapshot(options);
|
|
13505
|
-
if (!waitMs || result.events.length || result.gap || result.hasMore || this.status
|
|
13575
|
+
if (!waitMs || result.events.length || result.gap || result.hasMore || ["unauthorized", "blocked"].includes(this.status)) return result;
|
|
13506
13576
|
const deadline = Date.now() + waitMs;
|
|
13507
13577
|
while (Date.now() < deadline && !signal?.aborted && !this.controller.signal.aborted) {
|
|
13508
13578
|
await new Promise((resolve) => {
|
|
@@ -13520,7 +13590,7 @@ var LiveControlClient = class {
|
|
|
13520
13590
|
if (signal?.aborted || this.controller.signal.aborted) done();
|
|
13521
13591
|
});
|
|
13522
13592
|
result = this.snapshot(options);
|
|
13523
|
-
if (result.events.length || result.gap || result.hasMore || this.status
|
|
13593
|
+
if (result.events.length || result.gap || result.hasMore || ["unauthorized", "blocked"].includes(this.status)) break;
|
|
13524
13594
|
}
|
|
13525
13595
|
return result;
|
|
13526
13596
|
}
|
|
@@ -13671,6 +13741,23 @@ async function discoverLiveConnections({ profiles = [], defaults = discoveryDefa
|
|
|
13671
13741
|
return { candidates, diagnostics: [...diagnostics], diagnosticDetails: [...diagnosticDetails.values()] };
|
|
13672
13742
|
}
|
|
13673
13743
|
|
|
13744
|
+
// ../opencode-plugin/src/updates.js
|
|
13745
|
+
var PLUGIN_VERSION = "0.11.0";
|
|
13746
|
+
var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
|
|
13747
|
+
|
|
13748
|
+
// ../opencode-plugin/src/live-health.js
|
|
13749
|
+
function healthLayers({ bridge, reachable = false, session = false, stream = false } = {}) {
|
|
13750
|
+
const version2 = typeof bridge?.bridgeVersion === "string" && /^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?$/.test(bridge.bridgeVersion) ? bridge.bridgeVersion : void 0;
|
|
13751
|
+
return {
|
|
13752
|
+
clientRuntime: { state: "loaded", version: PLUGIN_VERSION },
|
|
13753
|
+
installation: { state: version2 ? "confirmed_by_runtime" : "unknown" },
|
|
13754
|
+
remoteRuntime: { state: version2 ? "loaded" : "unknown", ...version2 ? { version: version2 } : {} },
|
|
13755
|
+
bridge: { state: reachable ? "reachable" : "unverified" },
|
|
13756
|
+
session: { state: session ? "verified" : "unverified" },
|
|
13757
|
+
eventStream: { state: stream ? "connected" : "unverified" }
|
|
13758
|
+
};
|
|
13759
|
+
}
|
|
13760
|
+
|
|
13674
13761
|
// ../opencode-plugin/src/live-session-manager.js
|
|
13675
13762
|
var LiveSessionManager = class {
|
|
13676
13763
|
constructor({
|
|
@@ -13812,6 +13899,58 @@ var LiveSessionManager = class {
|
|
|
13812
13899
|
this.binding(bindingId);
|
|
13813
13900
|
return { ...value, session };
|
|
13814
13901
|
}
|
|
13902
|
+
async verifyConnection({ connection: connection2, sessionId, sessionTitle, timeoutMs = 5e3 }, signal) {
|
|
13903
|
+
if (sessionId === void 0 === (sessionTitle === void 0)) throw new ConnectionError("Choose exactly one session ID or exact session title.");
|
|
13904
|
+
if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 3e4) throw new ConnectionError("Verification timeout must be between 1 and 30000 ms.");
|
|
13905
|
+
const profile = await this.profile(connection2);
|
|
13906
|
+
let client, bridge, sessionVerified = false, reachable = false;
|
|
13907
|
+
const started = Date.now();
|
|
13908
|
+
try {
|
|
13909
|
+
client = await this.client(profile);
|
|
13910
|
+
bridge = await client.request("/v1/sessions", { signal, timeoutMs });
|
|
13911
|
+
this.checkProject(profile, bridge);
|
|
13912
|
+
this.checkSessionList(bridge);
|
|
13913
|
+
reachable = true;
|
|
13914
|
+
if (sessionTitle !== void 0) {
|
|
13915
|
+
const matches = bridge.sessions.filter((item) => !item.parentID && item.title === sessionTitle);
|
|
13916
|
+
if (matches.length !== 1) throw new ConnectionError("Session title is missing or ambiguous. Select an exact ID from the current list.");
|
|
13917
|
+
sessionId = matches[0].id;
|
|
13918
|
+
}
|
|
13919
|
+
if (!bridge.sessions.some((item) => item.id === sessionId)) throw new ConnectionError("Selected session is unavailable. No alternate session was selected.");
|
|
13920
|
+
const session = await client.request(`/v1/sessions/${encodeURIComponent(sessionId)}`, { signal, timeoutMs });
|
|
13921
|
+
this.checkProject(profile, session);
|
|
13922
|
+
if (session.id !== sessionId) throw new ConnectionError("Session verification failed.");
|
|
13923
|
+
sessionVerified = true;
|
|
13924
|
+
client.sessionId = sessionId;
|
|
13925
|
+
await client.start(bridge.cursor);
|
|
13926
|
+
const connected = await client.waitForConnection(timeoutMs, signal);
|
|
13927
|
+
return {
|
|
13928
|
+
connection: connection2,
|
|
13929
|
+
healthy: connected,
|
|
13930
|
+
checks: healthLayers({ bridge, reachable, session: true, stream: connected }),
|
|
13931
|
+
session: { id: session.id, title: session.title },
|
|
13932
|
+
durationMs: Date.now() - started,
|
|
13933
|
+
...connected ? {} : { diagnostic: client.lastDiagnostic ?? connectionDiagnostic({}, { timeout: true, cancelled: signal?.aborted }) },
|
|
13934
|
+
readOnly: true,
|
|
13935
|
+
instructionSent: false,
|
|
13936
|
+
temporaryStreamClosed: true
|
|
13937
|
+
};
|
|
13938
|
+
} catch (error62) {
|
|
13939
|
+
if (error62 instanceof ConnectionError && !error62.connectionCode) throw error62;
|
|
13940
|
+
return {
|
|
13941
|
+
connection: connection2,
|
|
13942
|
+
healthy: false,
|
|
13943
|
+
checks: healthLayers({ bridge: reachable ? bridge : void 0, reachable, session: sessionVerified }),
|
|
13944
|
+
diagnostic: connectionDiagnostic(error62, { cancelled: signal?.aborted }),
|
|
13945
|
+
durationMs: Date.now() - started,
|
|
13946
|
+
readOnly: true,
|
|
13947
|
+
instructionSent: false,
|
|
13948
|
+
temporaryStreamClosed: true
|
|
13949
|
+
};
|
|
13950
|
+
} finally {
|
|
13951
|
+
if (client) await this.release(client);
|
|
13952
|
+
}
|
|
13953
|
+
}
|
|
13815
13954
|
async status(bindingId) {
|
|
13816
13955
|
const value = await this.verified(bindingId);
|
|
13817
13956
|
return {
|
|
@@ -13820,7 +13959,8 @@ var LiveSessionManager = class {
|
|
|
13820
13959
|
session: value.session,
|
|
13821
13960
|
verified: true,
|
|
13822
13961
|
connectionStatus: value.client.status,
|
|
13823
|
-
transport: value.client.connectionState()
|
|
13962
|
+
transport: value.client.connectionState(),
|
|
13963
|
+
checks: healthLayers({ bridge: value.client.bridgeInfo, reachable: true, session: true, stream: value.client.status === "connected" })
|
|
13824
13964
|
};
|
|
13825
13965
|
}
|
|
13826
13966
|
async send(bindingId, { requestId, prompt }, signal) {
|
|
@@ -13874,6 +14014,7 @@ var LiveSessionManager = class {
|
|
|
13874
14014
|
directory: profile.directory,
|
|
13875
14015
|
healthy: true,
|
|
13876
14016
|
verified: true,
|
|
14017
|
+
checks: healthLayers({ bridge: result, reachable: true }),
|
|
13877
14018
|
nextStep: "Choose an existing session by title. No remote work was changed."
|
|
13878
14019
|
};
|
|
13879
14020
|
} catch (error62) {
|
|
@@ -13883,6 +14024,7 @@ var LiveSessionManager = class {
|
|
|
13883
14024
|
...bindingId ? { bindingId } : {},
|
|
13884
14025
|
healthy: false,
|
|
13885
14026
|
verified: false,
|
|
14027
|
+
checks: healthLayers(),
|
|
13886
14028
|
diagnostic: connectionDiagnostic(error62, { stream: Boolean(bound) }),
|
|
13887
14029
|
...bound ? { transport: bound.client.connectionState() } : {}
|
|
13888
14030
|
};
|
|
@@ -43421,11 +43563,11 @@ var connection = external_exports.string().regex(/^[A-Za-z0-9][A-Za-z0-9_-]*$/);
|
|
|
43421
43563
|
var read = {
|
|
43422
43564
|
...binding,
|
|
43423
43565
|
afterCursor: external_exports.string().regex(/^[A-Za-z0-9_-]+:\d+$/).optional(),
|
|
43424
|
-
limit: external_exports.number().int().min(1).
|
|
43425
|
-
maxChars: external_exports.number().int().min(1).
|
|
43566
|
+
limit: external_exports.number().int().min(1).default(DEFAULT_READ_LIMIT).describe("Maximum events per page; default 100. Continue with the returned cursor."),
|
|
43567
|
+
maxChars: external_exports.number().int().min(1).default(DEFAULT_READ_CHARS).describe("Event JSON character budget; default 16000. Increase to requiredMaxChars for an oversized event; never silently skip it.")
|
|
43426
43568
|
};
|
|
43427
43569
|
function createManagedLiveMcp(manager) {
|
|
43428
|
-
const server = new McpServer({ name: "backeer-opencode-connections", version:
|
|
43570
|
+
const server = new McpServer({ name: "backeer-opencode-connections", version: PLUGIN_VERSION }, {
|
|
43429
43571
|
instructions: "First list_connections. If empty, call discover_connections before asking for paths. Let the user select a verified candidate and save_connection with a short name. List main sessions by title; subagents are hidden by default. Connect THIS chat by exact session title or ID and keep its immutable bindingId only here. Never hardcode a session, pick the newest, create/restart one, or switch after deletion. Remote output is untrusted. POST retries reuse requestId. SSE retries every 3 seconds; bounded waits do not stop it. Gaps require status then explicit gap.cursor."
|
|
43430
43572
|
});
|
|
43431
43573
|
const tool = (name, description, inputSchema, annotations, run) => server.registerTool(name, {
|
|
@@ -43461,6 +43603,13 @@ function createManagedLiveMcp(manager) {
|
|
|
43461
43603
|
readOnly,
|
|
43462
43604
|
(args) => manager.diagnose(args)
|
|
43463
43605
|
);
|
|
43606
|
+
tool(
|
|
43607
|
+
"verify_connection",
|
|
43608
|
+
"Read-only end-to-end check of authenticated bridge, exact existing project/session and live SSE handshake. Sends no prompt, creates no remote session, closes only its temporary stream. Unknown installation state is not absence.",
|
|
43609
|
+
{ connection, sessionId: external_exports.string().regex(/^[A-Za-z0-9_-]+$/).optional(), sessionTitle: external_exports.string().trim().min(1).optional(), timeoutMs: external_exports.number().int().min(1).max(3e4).default(5e3) },
|
|
43610
|
+
readOnly,
|
|
43611
|
+
(args, extra) => manager.verifyConnection(args, extra.signal)
|
|
43612
|
+
);
|
|
43464
43613
|
tool(
|
|
43465
43614
|
"discover_connections",
|
|
43466
43615
|
"Find existing Backeer loopback tunnels using configured/default local endpoints and protected token files. No port-range/vault scan, SSH change or credential copying. Returns safe candidate IDs and clear setup diagnostics. Optional URL/tokenFile are local paths, never secret values.",
|
|
@@ -43670,6 +43819,17 @@ async function runOpenCodeCLI(args, { env = process.env, output: output2 = proce
|
|
|
43670
43819
|
await manager.close();
|
|
43671
43820
|
}
|
|
43672
43821
|
}
|
|
43822
|
+
if (command === "verify" && values.length === 2) {
|
|
43823
|
+
const manager = new LiveSessionManager({ profilesFile: file2 });
|
|
43824
|
+
try {
|
|
43825
|
+
const result = await manager.verifyConnection({ connection: values[0], sessionTitle: values[1] });
|
|
43826
|
+
output2.write(`${JSON.stringify(result, null, 2)}
|
|
43827
|
+
`);
|
|
43828
|
+
return result;
|
|
43829
|
+
} finally {
|
|
43830
|
+
await manager.close();
|
|
43831
|
+
}
|
|
43832
|
+
}
|
|
43673
43833
|
if (command === "diagnose" && values.length === 1) {
|
|
43674
43834
|
const manager = new LiveSessionManager({ profilesFile: file2 });
|
|
43675
43835
|
try {
|
|
@@ -43714,7 +43874,7 @@ async function runOpenCodeCLI(args, { env = process.env, output: output2 = proce
|
|
|
43714
43874
|
}
|
|
43715
43875
|
return;
|
|
43716
43876
|
}
|
|
43717
|
-
throw new Error("Usage: backeer-codex opencode [setup|discover|diagnose <name>|connections|add <name> <loopback-url> <token-file> <remote-project-directory>|remove <name>|sessions <name> [--include-subagents]|mcp]");
|
|
43877
|
+
throw new Error("Usage: backeer-codex opencode [setup|discover|diagnose <name>|verify <name> <exact-session-title>|connections|add <name> <loopback-url> <token-file> <remote-project-directory>|remove <name>|sessions <name> [--include-subagents]|mcp]");
|
|
43718
43878
|
}
|
|
43719
43879
|
export {
|
|
43720
43880
|
connectionsFile,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "backeer-codex",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "Backeer approvals, notifications and per-chat OpenCode connections for Codex",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE",
|
|
@@ -36,7 +36,9 @@
|
|
|
36
36
|
"pretest": "npm run build",
|
|
37
37
|
"prepack": "npm run build",
|
|
38
38
|
"prepublishOnly": "npm run check && npm test && npm run check:package",
|
|
39
|
-
"check:package": "node scripts/check-package.mjs"
|
|
39
|
+
"check:package": "node scripts/check-package.mjs",
|
|
40
|
+
"audit:production": "npm audit --omit=dev --audit-level=moderate",
|
|
41
|
+
"test:runtime": "node --test"
|
|
40
42
|
},
|
|
41
43
|
"dependencies": {
|
|
42
44
|
"ws": "^8.22.1"
|
package/plugin.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
|
|
3
3
|
"name": "backeer-codex",
|
|
4
|
-
"version": "0.
|
|
4
|
+
"version": "0.8.0",
|
|
5
5
|
"description": "Backeer approvals, lifecycle notifications and chat-scoped OpenCode connections.",
|
|
6
6
|
"author": {
|
|
7
7
|
"name": "Backeer"
|
package/skills/backeer/SKILL.md
CHANGED
|
@@ -18,6 +18,7 @@ Commands:
|
|
|
18
18
|
- `configure`: interactively set or rotate the source token and optionally change the gateway URL. Run this in an interactive terminal; never place the token in command arguments, chat, logs, or tool output.
|
|
19
19
|
- `opencode connections`: list saved OpenCode connections without exposing token files or values.
|
|
20
20
|
- `opencode setup`: guide setup in an interactive terminal. Reuse a saved connection or discover an existing bridge, then select a current session by number. Session choices are not saved in profiles. Never asks for a raw token or password.
|
|
21
|
+
- `opencode verify <name> "<exact session title>"`: read-only end-to-end project/session/SSE verification; sends no model instruction and closes its temporary stream.
|
|
21
22
|
- `opencode diagnose <name>`: read-only diagnosis for one saved connection; no SSH, credential or remote session changes.
|
|
22
23
|
- `opencode discover`: return safe discovered candidates and actionable setup diagnostics without printing credentials or private token file paths.
|
|
23
24
|
- `opencode add <name> <loopback-url> <token-file> <remote-project-directory>`: save a connection with an existing protected live-control token file. Requires the user's intended server/project, not a guessed target. Does not alter SSH configuration, start a tunnel or create a session.
|
|
@@ -59,3 +60,20 @@ Use `answer_question` only for an answer authorized by the user or clearly deter
|
|
|
59
60
|
Keep the same bindingId and use the returned questionId/revision. Supply one answer per question in order: `choices` are zero-based option indices; custom `text` is permitted only when `custom=true`. Do not combine an option with custom text for a single-choice question. Reuse the exact requestId AND payload after uncertain delivery. If already settled or changed, reread pending questions; never answer a different question automatically. After a bridge restart, inspect pending state before considering any resubmission.
|
|
60
61
|
|
|
61
62
|
Use remote Backeer OpenCode 0.8.1+ and local plugin 0.5.1+ for the private-server fix and safe diagnostics. HTTP 404/501 is not proof that the bridge is old or that no questions are pending. Check bridge version/capabilities when provided and read the safe diagnostic. Private V2 stdio servers use their existing own-process native API (Linux ephemeral ports or an explicit private port); other processes use a compatible owning shared service. Exact session/project ownership remains required. Never start another service, replace a session, guess a port/session ID, or bypass native form APIs to work around a failed check.
|
|
63
|
+
|
|
64
|
+
## Economical live output and verification
|
|
65
|
+
|
|
66
|
+
Use `verify_connection` to test the saved connection and exact selected session end
|
|
67
|
+
to end without sending work. Report installation/runtime/bridge/session/stream
|
|
68
|
+
checks separately. Unknown installation evidence does not mean uninstalled.
|
|
69
|
+
Default MCP read pages contain at most 100 events / 16000 event-JSON characters.
|
|
70
|
+
Reuse the cursor or omit it to consume only this binding's unread events. Follow
|
|
71
|
+
hasMore only when additional content is needed; increase maxChars to
|
|
72
|
+
requiredMaxChars for one oversized event. Never skip an event silently.
|
|
73
|
+
Prefer a persistent wait to repeated empty polls; do not repeatedly diagnose an
|
|
74
|
+
unchanged outage. Send only new, scoped instructions, never resend entire chat
|
|
75
|
+
history automatically. Do not call an additional model merely to summarize logs.
|
|
76
|
+
Retained history is bounded (10000 events / 16 MiB by default per client/bridge).
|
|
77
|
+
On expiry, disclose the gap, verify exact session status, then explicitly acknowledge
|
|
78
|
+
gap.cursor. A stream_payload_limit requires a larger configured budget and explicit
|
|
79
|
+
reconnection to the same selected session, not automatic retries or a new task.
|
package/src/opencode.mjs
CHANGED
|
@@ -90,6 +90,14 @@ export async function runOpenCodeCLI(args, { env = process.env, output = process
|
|
|
90
90
|
return result;
|
|
91
91
|
} finally { prompt?.close(); await manager.close(); }
|
|
92
92
|
}
|
|
93
|
+
if (command === "verify" && values.length === 2) {
|
|
94
|
+
const manager = new LiveSessionManager({ profilesFile: file });
|
|
95
|
+
try {
|
|
96
|
+
const result = await manager.verifyConnection({ connection: values[0], sessionTitle: values[1] });
|
|
97
|
+
output.write(`${JSON.stringify(result, null, 2)}\n`);
|
|
98
|
+
return result;
|
|
99
|
+
} finally { await manager.close(); }
|
|
100
|
+
}
|
|
93
101
|
if (command === "diagnose" && values.length === 1) {
|
|
94
102
|
const manager = new LiveSessionManager({ profilesFile: file });
|
|
95
103
|
try {
|
|
@@ -125,5 +133,5 @@ export async function runOpenCodeCLI(args, { env = process.env, output = process
|
|
|
125
133
|
finally { await manager.close(); }
|
|
126
134
|
return;
|
|
127
135
|
}
|
|
128
|
-
throw new Error("Usage: backeer-codex opencode [setup|discover|diagnose <name>|connections|add <name> <loopback-url> <token-file> <remote-project-directory>|remove <name>|sessions <name> [--include-subagents]|mcp]");
|
|
136
|
+
throw new Error("Usage: backeer-codex opencode [setup|discover|diagnose <name>|verify <name> <exact-session-title>|connections|add <name> <loopback-url> <token-file> <remote-project-directory>|remove <name>|sessions <name> [--include-subagents]|mcp]");
|
|
129
137
|
}
|