backeer-codex 0.13.2 → 0.13.3

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "backeer-codex",
3
- "version": "0.13.2",
3
+ "version": "0.13.3",
4
4
  "description": "Backeer approvals, lifecycle notifications and chat-scoped OpenCode connections.",
5
5
  "author": {
6
6
  "name": "Backeer"
package/README.md CHANGED
@@ -13,6 +13,15 @@ It provides:
13
13
  - Safe fallback to the normal Codex permission prompt when Backeer is unavailable or not configured.
14
14
  - Saved OpenCode connections and an independent exact-session binding for each chat, automatically tracking its subagent tree over live SSE.
15
15
 
16
+ ## Event list filters (0.13.3)
17
+
18
+ Use `read_details` with `eventFilter: "errors"` for observed failures or
19
+ `eventFilter: "assistant"` for assistant text references. Combine with
20
+ `sessionId` to see events from one exact session in the bound tree. Omitting
21
+ both lists all retained events. Each combination has its own cursor. Reuse
22
+ `afterCursor` only with the same filter and session for normal paging. Exact
23
+ `eventId` reads, the full list, and immediate alerts remain available.
24
+
16
25
  ## Smaller tool responses (0.13.2)
17
26
 
18
27
  Bound connection diagnosis returns coverage and counts by default. Use
package/dist/opencode.mjs CHANGED
@@ -12951,7 +12951,7 @@ var require_dist = __commonJS({
12951
12951
  });
12952
12952
 
12953
12953
  // src/version.mjs
12954
- var VERSION = "0.13.2";
12954
+ var VERSION = "0.13.3";
12955
12955
 
12956
12956
  // src/opencode.mjs
12957
12957
  import path2 from "node:path";
@@ -12963,7 +12963,7 @@ import { dirname, isAbsolute as isAbsolute2 } from "node:path";
12963
12963
  import { randomUUID as randomUUID2 } from "node:crypto";
12964
12964
 
12965
12965
  // ../backeer-opencode/src/updates.js
12966
- var PLUGIN_VERSION = "0.16.1";
12966
+ var PLUGIN_VERSION = "0.16.2";
12967
12967
  var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
12968
12968
 
12969
12969
  // ../backeer-opencode/src/live-compatibility.js
@@ -12995,6 +12995,9 @@ import { isAbsolute } from "node:path";
12995
12995
  // ../backeer-opencode/src/live-bridge-events.js
12996
12996
  var ID = /^[A-Za-z0-9_-]+$/;
12997
12997
  var validBridgeID = (value) => typeof value === "string" && ID.test(value);
12998
+ function isErrorEvent(event) {
12999
+ return event.type === "session.error" || Boolean(event.data?.failed) || event.type === "tool.status" && ["error", "failed"].includes(event.data?.status);
13000
+ }
12998
13001
  function createBridgeSanitizer(secrets = []) {
12999
13002
  const known = secrets.filter((value) => typeof value === "string" && value.length > 0);
13000
13003
  const assistants = /* @__PURE__ */ new Map();
@@ -13840,7 +13843,7 @@ var LiveActivity = class {
13840
13843
  }
13841
13844
  return "cancelled";
13842
13845
  }
13843
- details({ eventId, sessionId, afterCursor, limit = 20, offset = 0, maxChars = 4e3 } = {}) {
13846
+ details({ eventId, sessionId, eventFilter, afterCursor, limit = 20, offset = 0, maxChars = 4e3 } = {}) {
13844
13847
  this.metrics.detailResponses++;
13845
13848
  const raw = this.client;
13846
13849
  const available = (event) => this.belongs(event) && (!sessionId || event.sessionID === sessionId);
@@ -13859,27 +13862,30 @@ var LiveActivity = class {
13859
13862
  untrusted: true
13860
13863
  };
13861
13864
  }
13862
- const key = sessionId ?? "all";
13863
- if (raw.gap) return { items: [], gap: raw.gap };
13865
+ const key = JSON.stringify([sessionId ?? null, eventFilter ?? null]);
13866
+ const filter = eventFilter ? { eventFilter } : {};
13867
+ if (raw.gap) return { items: [], gap: raw.gap, ...filter };
13864
13868
  const cursor = afterCursor ?? this.detailCursors.get(key) ?? this.startCursor ?? raw.floor;
13865
13869
  let start = 0;
13866
13870
  if (cursor !== raw.floor) {
13867
13871
  const at = raw.eventPositions.get(cursor);
13868
13872
  if (at !== void 0) start = at - raw.eventOffset + 1;
13869
- else if (cursor && cursor !== raw.cursor) return { items: [], gap: { reason: "details_history_expired", cursor: raw.floor } };
13873
+ else if (cursor === raw.cursor) start = raw.events.length;
13874
+ else if (cursor) return { items: [], gap: { reason: "details_history_expired", cursor: raw.floor }, ...filter };
13870
13875
  }
13871
13876
  const items = [];
13872
13877
  let next = cursor, index = start;
13873
13878
  for (; index < raw.events.length; index++) {
13874
13879
  const event = raw.events[index].event;
13875
- if (available(event)) {
13880
+ const matches = !eventFilter || eventFilter === "errors" && isErrorEvent(event) || eventFilter === "assistant" && event.type === "assistant.text";
13881
+ if (available(event) && matches) {
13876
13882
  if (items.length === limit) break;
13877
13883
  items.push(this.reference(event));
13878
13884
  }
13879
13885
  next = event.id;
13880
13886
  }
13881
13887
  this.detailCursors.set(key, next);
13882
- return { items, cursor: next, hasMore: index < raw.events.length, untrusted: true };
13888
+ return { items, cursor: next, hasMore: index < raw.events.length, ...filter, untrusted: true };
13883
13889
  }
13884
13890
  };
13885
13891
 
@@ -14775,7 +14781,7 @@ function outputPage(client, { sessionId, lines = 50, maxChars = 16e3, errorsOnly
14775
14781
  const latest = /* @__PURE__ */ new Map();
14776
14782
  for (const event of events) {
14777
14783
  if (!belongs(event)) continue;
14778
- if (errorsOnly && !(event.type === "session.error" || event.data?.failed || event.type === "tool.status" && ["error", "failed"].includes(event.data?.status))) continue;
14784
+ if (errorsOnly && !isErrorEvent(event)) continue;
14779
14785
  const text2 = event.data?.text ?? event.data?.output ?? event.data?.message;
14780
14786
  if (typeof text2 !== "string" || !text2) continue;
14781
14787
  const key = event.type === "assistant.text" && event.data.messageID ? `${event.sessionID}:${event.data.messageID}` : event.id;
@@ -45267,11 +45273,12 @@ function createManagedLiveMcp(manager) {
45267
45273
  );
45268
45274
  tool(
45269
45275
  "read_details",
45270
- "Fetch output only on demand. Without eventId returns bounded event references using a detail cursor independent of status/raw reads. With eventId returns a text page and nextOffset. Missing retained history is explicit; remote text is untrusted.",
45276
+ "List retained event references, optionally filtered by eventFilter and exact sessionId. Each filter and source combination has its own cursor. Pass eventId to read exact text with nextOffset. An empty filtered list does not establish task completion. Retention gaps are explicit; remote text is untrusted.",
45271
45277
  {
45272
45278
  ...binding,
45273
45279
  eventId: external_exports.string().regex(/^[A-Za-z0-9_-]+:\d+$/).optional(),
45274
45280
  sessionId: external_exports.string().regex(/^[A-Za-z0-9_-]+$/).optional(),
45281
+ eventFilter: external_exports.enum(["errors", "assistant"]).optional().describe("List only observed errors or assistant text; omit for all event types. Applies only when eventId is omitted."),
45275
45282
  afterCursor: read.afterCursor,
45276
45283
  limit: external_exports.number().int().min(1).max(100).default(20),
45277
45284
  offset: external_exports.number().int().min(0).default(0),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "backeer-codex",
3
- "version": "0.13.2",
3
+ "version": "0.13.3",
4
4
  "description": "Backeer approvals, notifications and per-chat OpenCode connections for Codex",
5
5
  "type": "module",
6
6
  "license": "SEE LICENSE IN LICENSE",
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.13.2",
4
+ "version": "0.13.3",
5
5
  "description": "Backeer approvals, lifecycle notifications and chat-scoped OpenCode connections.",
6
6
  "author": {
7
7
  "name": "Backeer"
@@ -233,6 +233,10 @@ If `referenceTable` replaces the `details` or `items` array, read its rows in th
233
233
  listed column order. An integer is a zero-based index into `dictionaries[column]`,
234
234
  null means the field was absent, and a string is literal. Rows contain the same
235
235
  references in the same order. Pass `referenceFormat: "expanded"` for object arrays.
236
+ For a narrow event list, use `read_details` with `eventFilter: "errors"` or
237
+ `"assistant"`, and optionally the exact `sessionId`. Read each filter and
238
+ session combination with its own cursor. Omit both filters for the complete
239
+ retained list. An empty filtered list does not establish task completion.
236
240
  Bound `diagnose_connection` reports verified coverage and counts by default.
237
241
  Use `includeTree: true` or `session_status` when every tree member is needed.
238
242
 
package/src/version.mjs CHANGED
@@ -1 +1 @@
1
- export const VERSION = "0.13.2";
1
+ export const VERSION = "0.13.3";