@agentvault/muse-bridge 0.1.28 → 0.1.30

package/README.md

@@ -67,3 +67,21 @@ the bridge attempts one generic failure notice on that turn's captured reply
 channel. The notice waits at most ten seconds before the next queued turn advances.
 Echo exec/provider behavior remains unchanged; eligible terminal failure notices
 apply to both providers.
+
+## Copied-from ledger — REVIEW PERIODICALLY
+
+These files were copied once from the Claude bridge and are now owned here. A fix
+there does NOT reach us.
+
+| File | Copied from `packages/claude-room-bridge` at | Last reviewed |
+|---|---|---|
+| `src/room-context.ts` | PR #1458 (created there, 2026-10-26) | PR #1458 |
+
+To review one:
+
+```bash
+git log <last-reviewed>..HEAD -- packages/claude-room-bridge/src/<file>
+```
+
+Port anything that applies, then move "Last reviewed" forward whether or not you
+ported anything. An unmoved entry then honestly means nobody looked.

package/dist/bridge.d.ts

@@ -1,7 +1,9 @@
 /** Muse-owned room/DM wiring. Owner power is two raw booleans from
  *  `arming_snapshot` (`=== true` only). Do not copy grok grant-trim.
  *  Do not call decideArming, host-trust, or osIsolated. */
+import { type ToolSpanSink } from "@agentvault/agentvault";
 import type { RoomSession } from "./muse-session.js";
+import { type RoomContextLimits } from "./room-context.js";
 export declare function workAllowed(): boolean;
 export declare function gatesRemoved(): boolean;
 export declare function resetOwnerPower(): void;
@@ -13,6 +15,9 @@ export interface RoomMessage {
      *  `plaintext`. The @ gate reads this; absent on emitters < 0.23.42. */
     caption?: string;
     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;
 }
 export interface MessageMeta {
     roomId?: string;
@@ -38,6 +43,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: "arming_snapshot", cb: (e: ArmingSnapshot) => void): unknown;
@@ -63,6 +77,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?: {
@@ -92,6 +109,20 @@ export declare function attachLifecycle(channel: LifecycleChannel, opts?: {
     }) => void;
 }): void;
 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)
  *
@@ -103,8 +134,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;
@@ -118,5 +150,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