@securecoms/agent-bridge 0.28.2 → 0.30.0

package/dist/memory/unified/worker-protocol.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Unified memory (spec section 8.5, H-7, T-33): the messages between the bridge and its ranking worker. Only ids, scores and
+ * the opened texts of the items selected for a turn cross back. No message type FROM the worker carries a vector or a
+ * raw sealed buffer (worker-protocol.arch.test.ts, Task 14). The query vector goes TO the worker.
+ */
+import type { ItemKind, ItemSource, ItemTrust, ScopeKind } from "@agentvault/connect-mls-store/memory-items";
+export interface WorkerInit {
+    dbPath: string;
+    identityId: string;
+    storeKey: Uint8Array;
+    modelId: string;
+    threshold: number;
+    warm: boolean;
+    /** Plan Task 35, the recall eval only: replaces OWNER_SCOPE_PRIOR / RECENCY_SLOPE (0.05 since U1-G). Production never sets them (worker-protocol.arch.test.ts). */
+    priorOverride?: number;
+    recencySlopeOverride?: number;
+}
+export interface RankQuery {
+    scopes: string[];
+    ownerScope: string | null;
+    vec: Float32Array | null;
+    macs: Uint8Array[];
+    historyConversation: string;
+    currentMessageId: string;
+    maxItems: number;
+    maxChars: number;
+    nowMs: number;
+    excludeOriginIds: string[];
+}
+export interface OpenedItem {
+    itemId: number;
+    scopeKind: ScopeKind;
+    scopeId: string;
+    channelId: string;
+    kind: ItemKind;
+    originId: string;
+    originAt: number;
+    source: ItemSource;
+    trust: ItemTrust;
+    text: string;
+    /** Owner grants plan 4 Task 16 (voice fence, OQ-9): text only, from the sealed record and the row's clear source_ref. */
+    role?: "peer" | "agent";
+    origin?: "fast_path" | "reply" | "untrusted";
+    sourceRef?: string;
+}
+export type ToWorker = {
+    type: "query";
+    id: number;
+    q: RankQuery;
+} | {
+    type: "pins";
+    id: number;
+    scopeId: string;
+    maxChars: number;
+} | {
+    type: "pending";
+    id: number;
+    limit: number;
+} | {
+    type: "added";
+    itemIds: number[];
+} | {
+    type: "removed";
+    itemIds: number[];
+} | {
+    type: "reset";
+};
+export type FromWorker = {
+    type: "ready";
+    hot: number;
+    hotBytes: number;
+} | {
+    type: "result";
+    id: number;
+    items: OpenedItem[];
+    openFailed: number;
+} | {
+    type: "pins";
+    id: number;
+    pins: OpenedItem[];
+    more: number;
+    openFailed: number;
+} | {
+    type: "pending";
+    id: number;
+    rows: Array<{
+        itemId: number;
+        channelId: string;
+        scopeKind: ScopeKind;
+        scopeId: string;
+        originId: string;
+        chunkIndex: number;
+        text: string;
+    }>;
+} | {
+    type: "stats";
+    hot: number;
+    hotBytes: number;
+}
+/** Final review bridge M-4: a request whose handler threw; the client answers it `failed` (a miss), the worker lives on. */
+ | {
+    type: "failed";
+    id: number;
+} | {
+    type: "fatal";
+};

package/dist/memory-taps.d.ts

@@ -15,5 +15,5 @@ interface MemorySink {
 export declare function recordInboundMemory(sink: MemorySink, channelId: string, senderId: string, text: string, messageId: string, modality?: "text" | "voice", expectPurgeEpoch?: number): Promise<void>;
 /** Record the agent's own outbound reply. Best-effort. `modality` is "voice"
  *  for a line the voice fast path spoke (H1), else "text". */
-export declare function recordOutboundMemory(sink: MemorySink, channelId: string, text: string, messageId: string, modality?: "text" | "voice", expectPurgeEpoch?: number): Promise<void>;
+export declare function recordOutboundMemory(sink: MemorySink, channelId: string, text: string, messageId: string, modality?: "text" | "voice", expectPurgeEpoch?: number, origin?: "fast_path" | "reply" | "untrusted"): Promise<void>;
 export {};