@agentvault/grok-bridge 0.4.24 → 0.4.26

package/README.md

@@ -71,6 +71,7 @@ there does NOT reach us.
 | `src/log.ts` | `9b28a272e87600e78627dbd0f53fcbd192e01e73` | `9b28a272e87600e78627dbd0f53fcbd192e01e73` |
 | `src/bridge.ts` | `f3a7d53f67246e59c471891aee667e002a23b701` | `f3a7d53f67246e59c471891aee667e002a23b701` |
 | `src/service/` | `16c95f46c654a34613aeb2a4ff94eeede9e671ef` | `16c95f46c654a34613aeb2a4ff94eeede9e671ef` |
+| `src/room-context.ts` | PR #1458 (created there, 2026-10-26) | PR #1458 |
 
 To review one:
 

package/dist/bridge.d.ts

@@ -9,7 +9,13 @@
  * Those are Claude-shaped; Grok's gate is the pre_tool_use hook and arrives with
  * the tools-on posture.
  */
+/** `RoomSession` is declared ONCE in this package, by grok-session.ts. The Claude
+ *  bridge declares its own in its bridge.ts; that declaration was NOT copied.
+ *  Type-only, so this cannot create a runtime import cycle. */
+import { type ToolSpanSink } from "@agentvault/agentvault";
 import type { RoomSession } from "./grok-session.js";
+import { type RoomContextLimits } from "./room-context.js";
+import { type TerminalVerdict } from "./service/self-uninstall.js";
 export interface RoomMessage {
     roomId: string;
     senderName: string;
@@ -24,6 +30,9 @@ export interface RoomMessage {
      *  payloads / tests → treated as "not an agent" is NOT assumed: replyExpected is
      *  set only when we affirmatively know the sender is a human (=== false). */
     senderIsAgent?: boolean;
+    /** ISO send time from the emit (`data.created_at`). Used to stamp a message
+     *  held as room context; receipt time stands in when absent. */
+    timestamp?: string;
 }
 /** Metadata SecureChannel attaches to a 1:1 `message` event. `roomId` is set only
  *  when the `message` actually originated in a room (handled by room_message), so
@@ -52,6 +61,15 @@ export interface RoomChannel {
         roomId: string;
         name?: string;
     }) => void): unknown;
+    /** This agent left the room itself (SecureChannel.leaveRoom). Drops its held context. */
+    on(ev: "room_left", cb: (e: {
+        roomId: string;
+    }) => void): unknown;
+    /** Rooms the server no longer lists for this agent (removed or disbanded),
+     *  pruned on reconnect. Drops their held context. */
+    on(ev: "rooms_reconciled", cb: (e: {
+        pruned?: string[];
+    }) => void): unknown;
     on(ev: "message", cb: (text: string, metadata: MessageMeta) => void): unknown;
     on(ev: "room_hushed", cb: (e: RoomHushed) => void): unknown;
     on(ev: "error", cb: (err: unknown) => void): unknown;
@@ -88,6 +106,9 @@ export type BridgeTarget = {
 export interface ReplyChannel {
     sendToRoom(roomId: string, text: string): Promise<void>;
     send(text: string): Promise<void>;
+    /** SecureChannel's TelemetryReporter (device JWT, buffered). Optional so
+     *  fixtures and a channel without telemetry keep working. */
+    readonly telemetry?: ToolSpanSink | null;
     /** #1418 — SecureChannel: run `fn` as `conversationId`'s turn, so an
      *  untargeted send inside it reaches that conversation's person only. */
     runForConversation?<T>(conversationId: string | undefined, fn: () => Promise<T>, opts?: {
@@ -125,6 +146,7 @@ export declare class ActiveTarget {
 export interface LifecycleChannel {
     on(ev: "auth_failed", cb: (e: {
         reason: string;
+        deviceGone?: boolean;
     }) => void): unknown;
     on(ev: "session_replaced", cb: (e: {
         code?: number;
@@ -157,7 +179,7 @@ export declare function attachLifecycle(channel: LifecycleChannel, opts?: {
      *  well would put the same rule in two files, and the two would eventually
      *  disagree — which is how `session_replaced` (device still alive) would end
      *  up removing a healthy install. */
-    selfUninstall?: (reason: string, env: NodeJS.ProcessEnv) => boolean;
+    selfUninstall?: (verdict: TerminalVerdict, env: NodeJS.ProcessEnv) => boolean;
 }): void;
 /**
  * How a ROOM turn is announced to the model (#366 / #499 Facet A).
@@ -179,6 +201,20 @@ export declare function attachLifecycle(channel: LifecycleChannel, opts?: {
  * unmarked turn already reads as a DM, which is what the model assumes.
  */
 export declare function roomTurnPrefix(roomId: string, senderName: string, roomName?: string): string;
+/**
+ * What a held (unaddressed) room message contributes as context: the CAPTION
+ * the sender typed, never the folded file. SecureChannel folds an attachment's
+ * contents in FRONT of the caption, so holding `plaintext` and cutting it to
+ * the per-message limit kept the file and dropped what was actually said — and
+ * carried a file nobody asked this agent about into its next turn (PR #1458).
+ * Emitters older than #1223 send no caption; their plaintext is all there is.
+ */
+export declare function heldText(e: {
+    plaintext: string;
+    caption?: string;
+}): string;
+/** The room as the model sees it: its name when known, else a short id. */
+export declare function roomLabel(roomId: string, roomName?: string): string;
 /**
  * Does this agent owe a reply to this room message? (#1107)
  *
@@ -190,8 +226,9 @@ export declare function roomTurnPrefix(roomId: string, senderName: string, roomN
  * in the half most likely to be read as "the protocol doesn't work".
  *
  * Now it defers to the ONE shared implementation exported by
- * `@agentvault/agentvault`. The message is still pushed into the session either
- * way — the agent reads the whole room and only the reply obligation changes.
+ * `@agentvault/agentvault`. A message this returns false for is NOT pushed into
+ * the session (2026-10-26): it is held as room context and delivered with the
+ * next message in that room that this agent does owe — see room-context.ts.
  */
 export declare function _makeOwesReply(agentName: string | undefined, channel: {
     ownDisplayName?: string;
@@ -205,5 +242,7 @@ export declare function wireBridge(channel: RoomChannel, session: RoomSession, t
     agentName?: string;
     roomFilter?: string;
     log?: (msg: string) => void;
+    /** Test-only: override the room-context bounds (see room-context.ts). */
+    roomContextLimits?: Partial<RoomContextLimits>;
 }): void;
 //# sourceMappingURL=bridge.d.ts.map

package/dist/identity-prompt.d.ts

@@ -0,0 +1,11 @@
+/** The bridge-controlled agent identity prompt (no workspace file may supply it). */
+/**
+ * How a room works, as this bridge now delivers it (PR #1458). The old line —
+ * "In a room you see every message" — stopped being true when unaddressed room
+ * messages stopped running turns: the agent is shown only what @-mentions it,
+ * with what it missed arriving as a quoted context block. Telling the model it
+ * sees everything would have it treat that block as live conversation.
+ */
+export declare function roomRules(sayTool: string): string;
+export declare function identityPrompt(agentName: string, sayTool: string): string;
+//# sourceMappingURL=identity-prompt.d.ts.map