backeer-codex 0.7.0 → 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 +18 -1
- package/dist/opencode.mjs +214 -40
- package/package.json +5 -3
- package/plugin.json +1 -1
- package/skills/backeer/SKILL.md +18 -0
- package/src/companion.mjs +10 -0
- package/src/installer.mjs +10 -3
- package/src/opencode.mjs +9 -1
package/README.md
CHANGED
|
@@ -170,6 +170,13 @@ or deny the pending operation. The launcher forces local hook mode only for its
|
|
|
170
170
|
child processes, leaving your saved standalone mode unchanged. See the
|
|
171
171
|
[official hook contract](https://learn.chatgpt.com/docs/hooks#permissionrequest).
|
|
172
172
|
|
|
173
|
+
## 0.7.1 maintenance release
|
|
174
|
+
|
|
175
|
+
- Include the corrected OpenCode client diagnostics and indexed SSE history from Backeer OpenCode 0.10.1.
|
|
176
|
+
- Close incomplete HTTP connections when the companion shuts down.
|
|
177
|
+
- Validate the personal marketplace before replacing installed plugin files.
|
|
178
|
+
- Update the WebSocket runtime dependency to 8.22.1.
|
|
179
|
+
|
|
173
180
|
## Configure
|
|
174
181
|
|
|
175
182
|
Install the published package and register it in the default Codex personal marketplace:
|
|
@@ -205,6 +212,16 @@ The MCP tools `list_questions` and `answer_question` read pending ordinary quest
|
|
|
205
212
|
|
|
206
213
|
### Usage quotas
|
|
207
214
|
|
|
208
|
-
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.
|
|
209
216
|
|
|
210
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
|
@@ -13004,7 +13004,7 @@ async function checkWindowsTokenAcl(file2, run = execute) {
|
|
|
13004
13004
|
var details = Object.freeze({
|
|
13005
13005
|
local_endpoint_unavailable: ["The local connection is not accepting connections.", "Open the existing SSH tunnel, then retry the same connection.", true],
|
|
13006
13006
|
connection_timeout: ["The connection did not respond in time.", "Check the existing tunnel and remote bridge. Keep the current session running.", true],
|
|
13007
|
-
connection_interrupted: ["The connection was interrupted.", "
|
|
13007
|
+
connection_interrupted: ["The connection was interrupted.", "Check the existing tunnel and remote bridge, then retry the read. This operation does not retry automatically.", true],
|
|
13008
13008
|
credentials_rejected: ["The bridge rejected the existing credential.", "Check that the protected local credential belongs to the intended bridge. Do not paste its value.", false],
|
|
13009
13009
|
project_mismatch: ["The connection points to a different project.", "Check the tunnel target and saved project. Do not switch sessions automatically.", false],
|
|
13010
13010
|
session_unavailable: ["The selected session is no longer available.", "List current sessions and ask the user to select one. Never create or substitute a session automatically.", false],
|
|
@@ -13014,10 +13014,11 @@ 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
|
});
|
|
13020
|
-
function connectionDiagnostic(error62, { session = false, write = false, timeout = false, cancelled = false, tokenFile = false } = {}) {
|
|
13021
|
+
function connectionDiagnostic(error62, { session = false, write = false, timeout = false, cancelled = false, tokenFile = false, stream = false } = {}) {
|
|
13021
13022
|
const code = error62?.cause?.code ?? error62?.code;
|
|
13022
13023
|
let kind = "connection_unavailable";
|
|
13023
13024
|
if (cancelled) kind = "cancelled";
|
|
@@ -13033,7 +13034,7 @@ function connectionDiagnostic(error62, { session = false, write = false, timeout
|
|
|
13033
13034
|
else if (["ECONNRESET", "EPIPE", "UND_ERR_SOCKET"].includes(code)) kind = "connection_interrupted";
|
|
13034
13035
|
else if (error62 instanceof SyntaxError) kind = "invalid_bridge_response";
|
|
13035
13036
|
const [message, nextStep, retryable] = details[kind];
|
|
13036
|
-
return { code: kind, message, nextStep, retryable };
|
|
13037
|
+
return { code: kind, message, nextStep: kind === "connection_interrupted" && stream ? "The stream retries automatically; keep the same binding and cursor. Never automatically repeat an instruction." : nextStep, retryable };
|
|
13037
13038
|
}
|
|
13038
13039
|
function safeConnectionMessage(error62) {
|
|
13039
13040
|
if (!Object.hasOwn(details, error62?.connectionCode)) return void 0;
|
|
@@ -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,10 +13154,14 @@ 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 = [];
|
|
13163
|
+
this.eventPositions = /* @__PURE__ */ new Map();
|
|
13164
|
+
this.eventOffset = 0;
|
|
13141
13165
|
this.bufferBytes = 0;
|
|
13142
13166
|
this.listeners = /* @__PURE__ */ new Set();
|
|
13143
13167
|
this.controller = new AbortController();
|
|
@@ -13183,9 +13207,9 @@ var LiveControlClient = class {
|
|
|
13183
13207
|
let code, connectionCode;
|
|
13184
13208
|
try {
|
|
13185
13209
|
if (response.headers.get("content-type")?.includes("application/json")) {
|
|
13186
|
-
const
|
|
13187
|
-
if (Object.hasOwn(liveErrorMessages,
|
|
13188
|
-
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";
|
|
13189
13213
|
}
|
|
13190
13214
|
} catch {
|
|
13191
13215
|
} finally {
|
|
@@ -13199,7 +13223,9 @@ var LiveControlClient = class {
|
|
|
13199
13223
|
);
|
|
13200
13224
|
}
|
|
13201
13225
|
const text = await responseText(response);
|
|
13202
|
-
|
|
13226
|
+
const value = JSON.parse(text);
|
|
13227
|
+
if (path3 === "/v1/sessions") this.bridgeInfo = { bridgeVersion: value?.bridgeVersion };
|
|
13228
|
+
return value;
|
|
13203
13229
|
} catch (error62) {
|
|
13204
13230
|
const diagnostic = connectionDiagnostic(error62, {
|
|
13205
13231
|
session: /^\/v1\/sessions\//.test(path3),
|
|
@@ -13296,7 +13322,7 @@ var LiveControlClient = class {
|
|
|
13296
13322
|
const connection2 = new AbortController();
|
|
13297
13323
|
const abort = () => connection2.abort();
|
|
13298
13324
|
this.controller.signal.addEventListener("abort", abort, { once: true });
|
|
13299
|
-
const armWatchdog = (ms =
|
|
13325
|
+
const armWatchdog = (ms = this.staleMs) => {
|
|
13300
13326
|
clearTimeout(watchdog);
|
|
13301
13327
|
watchdog = setTimeout(() => {
|
|
13302
13328
|
timedOut = true;
|
|
@@ -13361,6 +13387,7 @@ var LiveControlClient = class {
|
|
|
13361
13387
|
buffer = buffer.replace(/\r\n|\r(?!$)/g, "\n");
|
|
13362
13388
|
let at;
|
|
13363
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" });
|
|
13364
13391
|
const frame = parseFrame(buffer.slice(0, at));
|
|
13365
13392
|
buffer = buffer.slice(at + 2);
|
|
13366
13393
|
if (!frame) continue;
|
|
@@ -13371,8 +13398,7 @@ var LiveControlClient = class {
|
|
|
13371
13398
|
resync = true;
|
|
13372
13399
|
this.cursor = this.gap.cursor;
|
|
13373
13400
|
this.floor = this.cursor;
|
|
13374
|
-
this.
|
|
13375
|
-
this.bufferBytes = 0;
|
|
13401
|
+
this.clearEvents();
|
|
13376
13402
|
this.status = "resync_required";
|
|
13377
13403
|
this.notify();
|
|
13378
13404
|
break;
|
|
@@ -13381,24 +13407,20 @@ var LiveControlClient = class {
|
|
|
13381
13407
|
if (checkedCursor(frame.id) !== event.id || !frame.id || typeof event.type !== "string") {
|
|
13382
13408
|
throw new Error("Invalid SSE event envelope");
|
|
13383
13409
|
}
|
|
13384
|
-
if (this.
|
|
13385
|
-
const bytes = Buffer.byteLength(JSON.stringify(event));
|
|
13386
|
-
if (bytes > this.maxBufferBytes) throw new Error("SSE event exceeds buffer limit");
|
|
13387
|
-
this.events.push({ event, bytes });
|
|
13388
|
-
this.bufferBytes += bytes;
|
|
13389
|
-
this.cursor = event.id;
|
|
13390
|
-
while (this.events.length > this.maxEvents || this.bufferBytes > this.maxBufferBytes) {
|
|
13391
|
-
const discarded = this.events.shift();
|
|
13392
|
-
this.bufferBytes -= discarded.bytes;
|
|
13393
|
-
this.floor = discarded.event.id;
|
|
13394
|
-
}
|
|
13410
|
+
if (!this.retainEvent(event)) continue;
|
|
13395
13411
|
this.notify();
|
|
13396
13412
|
}
|
|
13413
|
+
if (Buffer.byteLength(buffer) > this.maxBufferBytes + 4096) throw Object.assign(new Error("SSE frame exceeds buffer limit"), { connectionCode: "stream_payload_limit" });
|
|
13397
13414
|
}
|
|
13398
13415
|
} catch (error62) {
|
|
13399
13416
|
if (!this.controller.signal.aborted) {
|
|
13400
13417
|
if (this.status !== "unauthorized") this.status = "disconnected";
|
|
13401
13418
|
this.recordFailure(error62, { timeout: timedOut });
|
|
13419
|
+
if (error62.connectionCode === "stream_payload_limit") {
|
|
13420
|
+
this.status = "blocked";
|
|
13421
|
+
this.notify();
|
|
13422
|
+
return;
|
|
13423
|
+
}
|
|
13402
13424
|
}
|
|
13403
13425
|
} finally {
|
|
13404
13426
|
clearTimeout(watchdog);
|
|
@@ -13426,7 +13448,41 @@ var LiveControlClient = class {
|
|
|
13426
13448
|
}
|
|
13427
13449
|
recordFailure(error62, context) {
|
|
13428
13450
|
this.lastDisconnectedAt = Date.now();
|
|
13429
|
-
this.lastDiagnostic = connectionDiagnostic(error62, context);
|
|
13451
|
+
this.lastDiagnostic = connectionDiagnostic(error62, { ...context, stream: !this.controller.signal.aborted && Boolean(this.task || this.starting) });
|
|
13452
|
+
}
|
|
13453
|
+
retainEvent(event) {
|
|
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;
|
|
13458
|
+
const encoded = JSON.stringify(event);
|
|
13459
|
+
const bytes = Buffer.byteLength(encoded);
|
|
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
|
+
}
|
|
13467
|
+
this.eventPositions.set(event.id, this.eventOffset + this.events.length);
|
|
13468
|
+
this.events.push({ event, bytes, chars: encoded.length });
|
|
13469
|
+
this.bufferBytes += bytes;
|
|
13470
|
+
this.cursor = event.id;
|
|
13471
|
+
while (this.events.length > this.maxEvents || this.bufferBytes > this.maxBufferBytes) {
|
|
13472
|
+
const discarded = this.events.shift();
|
|
13473
|
+
this.eventPositions.delete(discarded.event.id);
|
|
13474
|
+
this.eventOffset++;
|
|
13475
|
+
this.evictedEvents++;
|
|
13476
|
+
this.bufferBytes -= discarded.bytes;
|
|
13477
|
+
this.floor = discarded.event.id;
|
|
13478
|
+
}
|
|
13479
|
+
return true;
|
|
13480
|
+
}
|
|
13481
|
+
clearEvents() {
|
|
13482
|
+
this.events = [];
|
|
13483
|
+
this.eventPositions.clear();
|
|
13484
|
+
this.eventOffset = 0;
|
|
13485
|
+
this.bufferBytes = 0;
|
|
13430
13486
|
}
|
|
13431
13487
|
connectionState() {
|
|
13432
13488
|
return {
|
|
@@ -13439,6 +13495,10 @@ var LiveControlClient = class {
|
|
|
13439
13495
|
nextRetryAt: this.nextRetryAt,
|
|
13440
13496
|
diagnostic: this.lastDiagnostic,
|
|
13441
13497
|
bufferedEvents: this.events.length,
|
|
13498
|
+
bufferedBytes: this.bufferBytes,
|
|
13499
|
+
maxEvents: this.maxEvents,
|
|
13500
|
+
maxBufferBytes: this.maxBufferBytes,
|
|
13501
|
+
evictedEvents: this.evictedEvents,
|
|
13442
13502
|
cursor: this.cursor,
|
|
13443
13503
|
...this.gap ? { gap: this.gap } : {}
|
|
13444
13504
|
};
|
|
@@ -13450,8 +13510,8 @@ var LiveControlClient = class {
|
|
|
13450
13510
|
let gap = this.gap;
|
|
13451
13511
|
let start = 0;
|
|
13452
13512
|
if (!gap && afterCursor !== this.floor) {
|
|
13453
|
-
const at = this.
|
|
13454
|
-
if (at
|
|
13513
|
+
const at = this.eventPositions.get(afterCursor);
|
|
13514
|
+
if (at !== void 0) start = at - this.eventOffset + 1;
|
|
13455
13515
|
else if (afterCursor && afterCursor !== this.cursor) gap = { reason: "client_buffer_expired", cursor: this.floor };
|
|
13456
13516
|
}
|
|
13457
13517
|
if (gap) return { events: [], cursor: afterCursor, gap, connection: this.status, hasMore: false };
|
|
@@ -13465,7 +13525,7 @@ var LiveControlClient = class {
|
|
|
13465
13525
|
cursor = event.id;
|
|
13466
13526
|
continue;
|
|
13467
13527
|
}
|
|
13468
|
-
const size =
|
|
13528
|
+
const size = this.events[index].chars;
|
|
13469
13529
|
if (result.length >= limit || result.length && chars + size > maxChars) break;
|
|
13470
13530
|
if (size > maxChars) {
|
|
13471
13531
|
return { events: result, cursor, connection: this.status, hasMore: true, requiredMaxChars: size };
|
|
@@ -13483,11 +13543,36 @@ var LiveControlClient = class {
|
|
|
13483
13543
|
transport: this.connectionState()
|
|
13484
13544
|
};
|
|
13485
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
|
+
}
|
|
13486
13571
|
async readEvents(options = {}, { waitMs = 0, signal } = {}) {
|
|
13487
13572
|
if (waitMs !== Infinity && (!Number.isSafeInteger(waitMs) || waitMs < 0)) throw new Error("Wait must be a nonnegative safe integer or unlimited");
|
|
13488
13573
|
await this.start(options.afterCursor);
|
|
13489
13574
|
let result = this.snapshot(options);
|
|
13490
|
-
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;
|
|
13491
13576
|
const deadline = Date.now() + waitMs;
|
|
13492
13577
|
while (Date.now() < deadline && !signal?.aborted && !this.controller.signal.aborted) {
|
|
13493
13578
|
await new Promise((resolve) => {
|
|
@@ -13505,7 +13590,7 @@ var LiveControlClient = class {
|
|
|
13505
13590
|
if (signal?.aborted || this.controller.signal.aborted) done();
|
|
13506
13591
|
});
|
|
13507
13592
|
result = this.snapshot(options);
|
|
13508
|
-
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;
|
|
13509
13594
|
}
|
|
13510
13595
|
return result;
|
|
13511
13596
|
}
|
|
@@ -13516,8 +13601,7 @@ var LiveControlClient = class {
|
|
|
13516
13601
|
this.notify();
|
|
13517
13602
|
await this.starting;
|
|
13518
13603
|
await this.task;
|
|
13519
|
-
this.
|
|
13520
|
-
this.bufferBytes = 0;
|
|
13604
|
+
this.clearEvents();
|
|
13521
13605
|
this.listeners.clear();
|
|
13522
13606
|
}
|
|
13523
13607
|
};
|
|
@@ -13657,6 +13741,23 @@ async function discoverLiveConnections({ profiles = [], defaults = discoveryDefa
|
|
|
13657
13741
|
return { candidates, diagnostics: [...diagnostics], diagnosticDetails: [...diagnosticDetails.values()] };
|
|
13658
13742
|
}
|
|
13659
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
|
+
|
|
13660
13761
|
// ../opencode-plugin/src/live-session-manager.js
|
|
13661
13762
|
var LiveSessionManager = class {
|
|
13662
13763
|
constructor({
|
|
@@ -13798,6 +13899,58 @@ var LiveSessionManager = class {
|
|
|
13798
13899
|
this.binding(bindingId);
|
|
13799
13900
|
return { ...value, session };
|
|
13800
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
|
+
}
|
|
13801
13954
|
async status(bindingId) {
|
|
13802
13955
|
const value = await this.verified(bindingId);
|
|
13803
13956
|
return {
|
|
@@ -13806,7 +13959,8 @@ var LiveSessionManager = class {
|
|
|
13806
13959
|
session: value.session,
|
|
13807
13960
|
verified: true,
|
|
13808
13961
|
connectionStatus: value.client.status,
|
|
13809
|
-
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" })
|
|
13810
13964
|
};
|
|
13811
13965
|
}
|
|
13812
13966
|
async send(bindingId, { requestId, prompt }, signal) {
|
|
@@ -13834,7 +13988,7 @@ var LiveSessionManager = class {
|
|
|
13834
13988
|
return {
|
|
13835
13989
|
...result2,
|
|
13836
13990
|
verified: false,
|
|
13837
|
-
diagnostic: connectionDiagnostic(error62),
|
|
13991
|
+
diagnostic: connectionDiagnostic(error62, { stream: true }),
|
|
13838
13992
|
nextStep: "Keep this binding and cursor. The stream retries every 3 seconds; verify the same session after reconnection before sending or acknowledging a gap."
|
|
13839
13993
|
};
|
|
13840
13994
|
}
|
|
@@ -13860,6 +14014,7 @@ var LiveSessionManager = class {
|
|
|
13860
14014
|
directory: profile.directory,
|
|
13861
14015
|
healthy: true,
|
|
13862
14016
|
verified: true,
|
|
14017
|
+
checks: healthLayers({ bridge: result, reachable: true }),
|
|
13863
14018
|
nextStep: "Choose an existing session by title. No remote work was changed."
|
|
13864
14019
|
};
|
|
13865
14020
|
} catch (error62) {
|
|
@@ -13869,7 +14024,8 @@ var LiveSessionManager = class {
|
|
|
13869
14024
|
...bindingId ? { bindingId } : {},
|
|
13870
14025
|
healthy: false,
|
|
13871
14026
|
verified: false,
|
|
13872
|
-
|
|
14027
|
+
checks: healthLayers(),
|
|
14028
|
+
diagnostic: connectionDiagnostic(error62, { stream: Boolean(bound) }),
|
|
13873
14029
|
...bound ? { transport: bound.client.connectionState() } : {}
|
|
13874
14030
|
};
|
|
13875
14031
|
} finally {
|
|
@@ -43407,11 +43563,11 @@ var connection = external_exports.string().regex(/^[A-Za-z0-9][A-Za-z0-9_-]*$/);
|
|
|
43407
43563
|
var read = {
|
|
43408
43564
|
...binding,
|
|
43409
43565
|
afterCursor: external_exports.string().regex(/^[A-Za-z0-9_-]+:\d+$/).optional(),
|
|
43410
|
-
limit: external_exports.number().int().min(1).
|
|
43411
|
-
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.")
|
|
43412
43568
|
};
|
|
43413
43569
|
function createManagedLiveMcp(manager) {
|
|
43414
|
-
const server = new McpServer({ name: "backeer-opencode-connections", version:
|
|
43570
|
+
const server = new McpServer({ name: "backeer-opencode-connections", version: PLUGIN_VERSION }, {
|
|
43415
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."
|
|
43416
43572
|
});
|
|
43417
43573
|
const tool = (name, description, inputSchema, annotations, run) => server.registerTool(name, {
|
|
@@ -43447,6 +43603,13 @@ function createManagedLiveMcp(manager) {
|
|
|
43447
43603
|
readOnly,
|
|
43448
43604
|
(args) => manager.diagnose(args)
|
|
43449
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
|
+
);
|
|
43450
43613
|
tool(
|
|
43451
43614
|
"discover_connections",
|
|
43452
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.",
|
|
@@ -43656,6 +43819,17 @@ async function runOpenCodeCLI(args, { env = process.env, output: output2 = proce
|
|
|
43656
43819
|
await manager.close();
|
|
43657
43820
|
}
|
|
43658
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
|
+
}
|
|
43659
43833
|
if (command === "diagnose" && values.length === 1) {
|
|
43660
43834
|
const manager = new LiveSessionManager({ profilesFile: file2 });
|
|
43661
43835
|
try {
|
|
@@ -43700,7 +43874,7 @@ async function runOpenCodeCLI(args, { env = process.env, output: output2 = proce
|
|
|
43700
43874
|
}
|
|
43701
43875
|
return;
|
|
43702
43876
|
}
|
|
43703
|
-
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]");
|
|
43704
43878
|
}
|
|
43705
43879
|
export {
|
|
43706
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,10 +36,12 @@
|
|
|
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
|
-
"ws": "^8.22.
|
|
44
|
+
"ws": "^8.22.1"
|
|
43
45
|
},
|
|
44
46
|
"devDependencies": {
|
|
45
47
|
"@modelcontextprotocol/sdk": "^1.32.2",
|
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/companion.mjs
CHANGED
|
@@ -30,6 +30,12 @@ export async function createCompanion({
|
|
|
30
30
|
const sockets = new WebSocketServer({ noServer: true, maxPayload: 0, perMessageDeflate: false });
|
|
31
31
|
const abort = new AbortController();
|
|
32
32
|
let backend, socket, bridge, lines, remoteTask, closeTask, closing = false, used = false;
|
|
33
|
+
const connections = new Set();
|
|
34
|
+
server.on("connection", (connection) => {
|
|
35
|
+
if (closing) { connection.destroy(); return; }
|
|
36
|
+
connections.add(connection);
|
|
37
|
+
connection.once("close", () => connections.delete(connection));
|
|
38
|
+
});
|
|
33
39
|
|
|
34
40
|
const sendBackend = (message) => {
|
|
35
41
|
if (!backend || backend.stdin.destroyed || backend.stdin.writableEnded) throw new Error("App-server disconnected");
|
|
@@ -113,6 +119,10 @@ export async function createCompanion({
|
|
|
113
119
|
bridge?.dispose();
|
|
114
120
|
lines?.close();
|
|
115
121
|
socket?.terminate();
|
|
122
|
+
// A peer can connect without finishing HTTP/upgrade headers. Those
|
|
123
|
+
// sockets never reach the WebSocket handler but must close with us too.
|
|
124
|
+
for (const connection of connections) connection.destroy();
|
|
125
|
+
connections.clear();
|
|
116
126
|
backend?.stdin.end();
|
|
117
127
|
let backendClosed;
|
|
118
128
|
if (backend?.pid && backend.exitCode === null && backend.signalCode === null) {
|
package/src/installer.mjs
CHANGED
|
@@ -43,14 +43,17 @@ function backeerEntry() {
|
|
|
43
43
|
};
|
|
44
44
|
}
|
|
45
45
|
|
|
46
|
-
|
|
47
|
-
if (!/^[A-Za-z0-9_-]+$/.test(marketplace.name || "")) {
|
|
46
|
+
function validateMarketplace(file, marketplace) {
|
|
47
|
+
if (!marketplace || !/^[A-Za-z0-9_-]+$/.test(marketplace.name || "")) {
|
|
48
48
|
throw new Error(`Invalid personal marketplace name in ${file}`);
|
|
49
49
|
}
|
|
50
50
|
if (!Array.isArray(marketplace.plugins)) {
|
|
51
51
|
throw new Error(`Invalid plugins list in ${file}`);
|
|
52
52
|
}
|
|
53
|
+
}
|
|
53
54
|
|
|
55
|
+
async function writeMarketplace(file, marketplace) {
|
|
56
|
+
validateMarketplace(file, marketplace);
|
|
54
57
|
const entry = backeerEntry();
|
|
55
58
|
const index = marketplace.plugins.findIndex((plugin) => plugin?.name === PLUGIN_NAME);
|
|
56
59
|
if (index === -1) marketplace.plugins.push(entry);
|
|
@@ -99,6 +102,10 @@ function runCodexInstall(marketplaceName) {
|
|
|
99
102
|
|
|
100
103
|
export async function installPlugin(options = {}) {
|
|
101
104
|
const paths = personalPaths(options.homeDirectory);
|
|
105
|
+
// Validate before touching an installed plugin: a corrupt registry must not
|
|
106
|
+
// leave new files behind while reporting that the installation failed.
|
|
107
|
+
const marketplace = await readMarketplace(paths.marketplaceFile);
|
|
108
|
+
validateMarketplace(paths.marketplaceFile, marketplace);
|
|
102
109
|
await copyPlugin(options.packageRoot || PACKAGE_ROOT, paths.pluginDirectory);
|
|
103
110
|
// Codex loads a copied plugin outside npm's global package directory. Its
|
|
104
111
|
// companion therefore needs its own runtime dependency, not just source files.
|
|
@@ -107,7 +114,7 @@ export async function installPlugin(options = {}) {
|
|
|
107
114
|
if (path.resolve(wsRoot) !== path.resolve(wsDestination)) {
|
|
108
115
|
await fs.cp(wsRoot, wsDestination, { recursive: true, force: true });
|
|
109
116
|
}
|
|
110
|
-
const marketplaceName = await writeMarketplace(paths.marketplaceFile,
|
|
117
|
+
const marketplaceName = await writeMarketplace(paths.marketplaceFile, marketplace);
|
|
111
118
|
if (options.installWithCodex !== false) await runCodexInstall(marketplaceName);
|
|
112
119
|
return { ...paths, marketplaceName };
|
|
113
120
|
}
|
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
|
}
|