@xdarkicex/openclaw-memory-libravdb 1.4.6 → 1.4.7

package/dist/proto/intelligence_kernel/v1/kernel.proto

@@ -0,0 +1,378 @@
+syntax = "proto3";
+
+package intelligence_kernel.v1;
+
+option go_package = "github.com/xDarkicex/openclaw-memory-libravdb/sidecar/api/proto/intelligence_kernel/v1;kernelpb";
+
+import "google/protobuf/struct.proto";
+
+// =============================================================================
+// Enums
+// =============================================================================
+
+enum ConnectionState {
+  CONNECTION_STATE_UNSPECIFIED = 0;
+  CONNECTION_STATE_PREAUTH = 1;
+  CONNECTION_STATE_AUTHENTICATED = 2;
+  CONNECTION_STATE_READY = 3;
+}
+
+enum RetrievalTrigger {
+  RETRIEVAL_TRIGGER_UNSPECIFIED = 0;
+  RETRIEVAL_TRIGGER_NONE = 1;
+  RETRIEVAL_TRIGGER_CASCADE_EXHAUSTION = 2;
+  RETRIEVAL_TRIGGER_LOW_TOP_SCORE = 3;
+  RETRIEVAL_TRIGGER_LOW_SUMMARY_CONFIDENCE = 4;
+  RETRIEVAL_TRIGGER_CROSS_SESSION_RAW = 5;
+}
+
+enum TemporalPattern {
+  TEMPORAL_PATTERN_UNSPECIFIED = 0;
+  TEMPORAL_PATTERN_HOW_MANY_DAYS = 1;
+  TEMPORAL_PATTERN_HOW_LONG = 2;
+  TEMPORAL_PATTERN_BEFORE_OR_AFTER = 3;
+  TEMPORAL_PATTERN_SINCE_OR_BETWEEN = 4;
+  TEMPORAL_PATTERN_FIRST_OR_EARLIER = 5;
+  TEMPORAL_PATTERN_WHEN_DID = 6;
+}
+
+enum ComparisonSide {
+  COMPARISON_SIDE_UNSPECIFIED = 0;
+  COMPARISON_SIDE_SIDE_A = 1;
+  COMPARISON_SIDE_SIDE_B = 2;
+  COMPARISON_SIDE_NEUTRAL = 3;
+}
+
+// =============================================================================
+// Versioning
+// =============================================================================
+
+message KernelVersion {
+  int32 major = 1;
+  int32 minor = 2;
+  int32 patch = 3;
+  string prerelease = 4;
+}
+
+// =============================================================================
+// Session Init & Capabilities
+// =============================================================================
+
+message InitializeRequest {
+  string client_id = 1;
+  repeated ClientCapability client_capabilities = 2;
+  map<string, string> client_metadata = 3;
+}
+
+message ClientCapability {
+  string name = 1;
+  string version = 2;
+}
+
+message InitializeResponse {
+  string session_id = 1;
+  ConnectionState connection_state = 2;
+  repeated ServerCapability server_capabilities = 3;
+  KernelVersion kernel_version = 4;
+  map<string, string> server_metadata = 5;
+}
+
+message ServerCapability {
+  string name = 1;
+  string version = 2;
+  bool required = 3;
+}
+
+// =============================================================================
+// Auth (via gRPC metadata — nonce in response metadata on first call)
+// =============================================================================
+
+message AuthChallenge {
+  bytes nonce = 1;
+  string session_id = 2;
+}
+
+message AuthResponse {
+  bytes hmac_signature = 1;
+  string client_id = 2;
+}
+
+// =============================================================================
+// Core Data Structures
+// =============================================================================
+
+message Message {
+  string role = 1;
+  string content = 2;
+  string id = 3;
+}
+
+message SearchHit {
+  string id = 1;
+  float score = 2;
+  string text = 3;
+  google.protobuf.Struct metadata = 4;
+  float final_score = 5;
+}
+
+message AssembledItem {
+  SearchHit hit = 1;
+  string role = 2;
+  string source = 3;
+  bool authored_invariant = 4;
+  bool continuity_tail = 5;
+  bool elevated_guidance = 6;
+}
+
+message ScoredCandidate {
+  SearchHit hit = 1;
+  float final_score = 2;
+  TemporalCandidateMetrics temporal = 3;
+  RecoveryCandidateMetrics recovery = 4;
+}
+
+message TemporalCandidateMetrics {
+  float semantic_score = 1;
+  float recency_score = 2;
+  float temporal_anchor_density = 3;
+  float slot_coverage = 4;
+  repeated string slot_matches = 5;
+  ComparisonSide comparison_side = 6;
+  float comparison_side_witness_score = 7;
+  float comparison_slot_recall = 8;
+  float comparison_slot_precision = 9;
+  float comparison_slot_specificity = 10;
+}
+
+message RecoveryCandidateMetrics {
+  float lexical_coverage = 1;
+  float intent_alignment_bonus = 2;
+  RetrievalTrigger trigger = 3;
+  string recovery_scope = 4;
+}
+
+message ComparisonWitnessPair {
+  SearchHit side_a = 1;
+  SearchHit side_b = 2;
+  int32 total_tokens = 3;
+  float pair_score = 4;
+}
+
+// =============================================================================
+// Gating Signals
+// =============================================================================
+
+message GatingSignals {
+  float g = 1;
+  float t = 2;
+  float h = 3;
+  float r = 4;
+  float d = 5;
+  float p = 6;
+  float a = 7;
+  float dtech = 8;
+  float gconv = 9;
+  float gtech = 10;
+  float input_freq = 11;
+  float mem_saturation = 12;
+}
+
+// =============================================================================
+// Temporal Context
+// =============================================================================
+
+message TemporalQueryContext {
+  bool active = 1;
+  float indicator = 2;
+  repeated TemporalPattern matched_patterns = 3;
+  repeated string slots = 4;
+  bool is_comparison_query = 5;
+  bool is_duration_interval_query = 6;
+  TemporalGuardDecision guard = 7;
+}
+
+message TemporalGuardDecision {
+  bool should_apply = 1;
+  repeated string slots = 2;
+  string reason = 3;
+}
+
+message DreamQueryContext {
+  bool active = 1;
+  string collection = 2;
+}
+
+// =============================================================================
+// Assembly Config
+// =============================================================================
+
+message AssemblyConfig {
+  float token_budget_fraction = 1;
+  float authored_hard_budget_fraction = 2;
+  float authored_soft_budget_fraction = 3;
+  float elevated_guidance_budget_fraction = 4;
+  int32 continuity_min_turns = 5;
+  int32 continuity_tail_budget_tokens = 6;
+  int32 top_k = 7;
+  int32 coarse_top_k = 8;
+  int32 second_pass_top_k = 9;
+  float recovery_floor_score = 10;
+  int32 recovery_min_top_k = 11;
+  float recovery_min_confidence_mean = 12;
+  float section7_theta1 = 13;
+  float section7_kappa = 14;
+  float section7_hop_eta = 15;
+  float section7_hop_threshold = 16;
+  float section7_authority_recency_lambda = 17;
+  float section7_authority_recency_weight = 18;
+  float section7_authority_frequency_weight = 19;
+  float section7_authority_authored_weight = 20;
+  bool disable_reserve_bump = 26;
+  bool profiling_enabled = 28;
+}
+
+// =============================================================================
+// Assemble Context
+// =============================================================================
+
+message AssembleContextRequest {
+  string session_id = 1;
+  string session_key = 2;
+  string user_id = 3;
+  string query_text = 4;
+  repeated Message visible_messages = 5;
+  int32 token_budget = 6;
+  AssemblyConfig config = 7;
+  bool emit_debug = 8;
+}
+
+message AssembleContextResponse {
+  repeated Message messages = 1;
+  int32 estimated_tokens = 2;
+  string system_prompt_addition = 3;
+  AssemblyDebug debug = 4;
+}
+
+message RecoveryOrderEntry {
+  string id = 1;
+  string recovery_scope = 2;
+  float final_score = 3;
+  int32 token_estimate = 4;
+}
+
+message AssemblyDebug {
+  bool recovery_trigger_fired = 1;
+  bool cross_session_raw_recovery = 2;
+  int32 recovery_reserve_tokens = 3;
+  repeated RecoveryOrderEntry recovery_deduped_order = 4;
+  repeated RecoveryOrderEntry recovery_fitted_order = 5;
+  repeated string profile_lines = 10;
+}
+
+// =============================================================================
+// Ranking
+// =============================================================================
+
+message RankCandidatesRequest {
+  string session_id = 1;
+  string user_id = 2;
+  string query_text = 3;
+  repeated SearchHit candidates = 4;
+  int32 k1 = 5;
+  int32 k2 = 6;
+}
+
+message RankCandidatesResponse {
+  repeated ScoredCandidate ranked = 1;
+}
+
+// =============================================================================
+// Ingest & Session
+// =============================================================================
+
+message IngestMessageRequest {
+  string session_id = 1;
+  string session_key = 2;
+  string user_id = 3;
+  Message message = 4;
+  bool is_heartbeat = 5;
+}
+
+message IngestMessageResponse {
+  bool ingested = 1;
+  GatingSignals gating = 2;
+}
+
+message AfterTurnRequest {
+  string session_id = 1;
+  string session_key = 2;
+  string user_id = 3;
+  repeated Message messages = 4;
+  int32 pre_prompt_message_count = 5;
+  bool is_heartbeat = 6;
+}
+
+message AfterTurnResponse {
+  bool ok = 1;
+}
+
+message BootstrapSessionRequest {
+  string session_id = 1;
+  string session_key = 2;
+  string user_id = 3;
+}
+
+message BootstrapSessionResponse {
+  bool ok = 1;
+}
+
+message CompactSessionRequest {
+  string session_id = 1;
+  bool force = 2;
+  int32 target_size = 3;
+}
+
+message CompactSessionResponse {
+  bool ok = 1;
+  bool compacted = 2;
+}
+
+// =============================================================================
+// Status
+// =============================================================================
+
+message GetStatusRequest {}
+
+message GetStatusResponse {
+  bool ok = 1;
+  string message = 2;
+  int32 turn_count = 3;
+  int32 memory_count = 4;
+  string embedding_profile = 5;
+  bool abstractive_ready = 6;
+  KernelVersion kernel_version = 7;
+}
+
+// =============================================================================
+// Service Definition
+// =============================================================================
+
+service IntelligenceKernel {
+  // Session initialization — first call, returns auth challenge in metadata.
+  rpc InitializeSession(InitializeRequest) returns (InitializeResponse);
+
+  // Full context assembly — replaces 6-8 JSON-RPC calls from TS.
+  rpc AssembleContext(AssembleContextRequest) returns (AssembleContextResponse);
+
+  // Candidate ranking — exposes scoring math for external frameworks.
+  rpc RankCandidates(RankCandidatesRequest) returns (RankCandidatesResponse);
+
+  // Session lifecycle.
+  rpc IngestMessage(IngestMessageRequest) returns (IngestMessageResponse);
+  rpc AfterTurn(AfterTurnRequest) returns (AfterTurnResponse);
+  rpc BootstrapSession(BootstrapSessionRequest) returns (BootstrapSessionResponse);
+  rpc CompactSession(CompactSessionRequest) returns (CompactSessionResponse);
+
+  // Server capabilities.
+  rpc GetStatus(GetStatusRequest) returns (GetStatusResponse);
+}

package/dist/recall-cache.d.ts

@@ -0,0 +1,2 @@
+import type { RecallCache } from "./types.js";
+export declare function createRecallCache<T = unknown>(): RecallCache<T>;

package/dist/recall-cache.js

@@ -0,0 +1,30 @@
+export function createRecallCache() {
+    const entries = new Map();
+    return {
+        put(entry) {
+            entries.set(cacheKey(entry.userId, entry.queryText), entry);
+        },
+        get(key) {
+            return entries.get(cacheKey(key.userId, key.queryText));
+        },
+        take(key) {
+            const id = cacheKey(key.userId, key.queryText);
+            const hit = entries.get(id);
+            if (hit) {
+                entries.delete(id);
+            }
+            return hit;
+        },
+        clearUser(userId) {
+            const prefix = `${userId}\n`;
+            for (const key of entries.keys()) {
+                if (key.startsWith(prefix)) {
+                    entries.delete(key);
+                }
+            }
+        },
+    };
+}
+function cacheKey(userId, queryText) {
+    return `${userId}\n${queryText}`;
+}

package/dist/rpc-protobuf-codecs.d.ts

@@ -0,0 +1,70 @@
+import { AfterTurnKernelRequest, AfterTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryResponse, FlushNamespaceResponse, FlushResponse, HealthResponse, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, MemoryStatusResponse, RankCandidatesRequest, RankCandidatesResponse, SearchTextResponse, SessionLifecycleHintResponse } from "@xdarkicex/libravdb-contracts";
+import type { LifecycleHint } from "./plugin-runtime.js";
+export type RpcMethodCodec<Params = unknown, Result = unknown> = {
+    encodeParams(params: Params): Uint8Array;
+    decodeResult(bytes: Uint8Array): Result;
+};
+export type RpcMethodName = keyof typeof rpcProtobufCodecs;
+export declare const rpcProtobufCodecs: {
+    health: RpcMethodCodec<Record<string, never>, HealthResponse>;
+    status: RpcMethodCodec<Record<string, never>, MemoryStatusResponse>;
+    flush: RpcMethodCodec<Record<string, never>, FlushResponse>;
+    session_lifecycle_hint: RpcMethodCodec<LifecycleHint, SessionLifecycleHintResponse>;
+    search_text: RpcMethodCodec<{
+        collection: string;
+        text: string;
+        k?: number;
+        excludeIds?: string[];
+    }, SearchTextResponse>;
+    search_text_collections: RpcMethodCodec<{
+        collections: string[];
+        text: string;
+        k?: number;
+        excludeByCollection?: Record<string, unknown>;
+    }, SearchTextResponse>;
+    list_collection: RpcMethodCodec<{
+        collection: string;
+    }, SearchTextResponse>;
+    list_lifecycle_journal: RpcMethodCodec<{
+        sessionId?: string;
+        limit?: number;
+    }, SearchTextResponse>;
+    export_memory: RpcMethodCodec<{
+        userId?: string;
+        namespace?: string;
+    }, ExportMemoryResponse>;
+    flush_namespace: RpcMethodCodec<{
+        userId?: string;
+        namespace?: string;
+    }, FlushNamespaceResponse>;
+    promote_dream_entries: RpcMethodCodec<{
+        userId: string;
+        sourceDoc: string;
+        sourceRoot?: string;
+        sourcePath?: string;
+        sourceKind?: string;
+        fileHash?: string;
+        sourceSize?: number;
+        sourceMtimeMs?: number;
+        ingestVersion?: number;
+        hashBackend?: string;
+        entries?: Array<Record<string, unknown>>;
+    }, DreamPromotionResponse>;
+    ingest_markdown_document: RpcMethodCodec<{
+        sourceDoc: string;
+        text: string;
+        tokenizerId?: string;
+        coreDoc?: boolean;
+        sourceMeta?: Record<string, unknown>;
+    }, IngestMarkdownDocumentResponse>;
+    delete_authored_document: RpcMethodCodec<{
+        sourceDoc: string;
+    }, DeleteAuthoredDocumentResponse>;
+    bootstrap_session_kernel: RpcMethodCodec<BootstrapSessionKernelRequest, BootstrapSessionKernelResponse>;
+    ingest_message_kernel: RpcMethodCodec<IngestMessageKernelRequest, IngestMessageKernelResponse>;
+    after_turn_kernel: RpcMethodCodec<AfterTurnKernelRequest, AfterTurnKernelResponse>;
+    assemble_context_internal: RpcMethodCodec<AssembleContextInternalRequest, AssembleContextInternalResponse>;
+    compact_session: RpcMethodCodec<CompactSessionRequest, CompactSessionResponse>;
+    rank_candidates: RpcMethodCodec<RankCandidatesRequest, RankCandidatesResponse>;
+};
+export declare function getRpcMethodCodec(method: string): RpcMethodCodec<any, any> | undefined;

package/dist/rpc-protobuf-codecs.js

@@ -0,0 +1,77 @@
+import { AfterTurnKernelRequest, AfterTurnKernelResponse, AssembleContextInternalRequest, AssembleContextInternalResponse, BootstrapSessionKernelRequest, BootstrapSessionKernelResponse, CompactSessionRequest, CompactSessionResponse, DeleteAuthoredDocumentRequest, DeleteAuthoredDocumentResponse, DreamPromotionResponse, ExportMemoryRequest, ExportMemoryResponse, FlushNamespaceRequest, FlushNamespaceResponse, FlushResponse, HealthResponse, IngestMarkdownDocumentRequest, IngestMarkdownDocumentResponse, IngestMessageKernelRequest, IngestMessageKernelResponse, ListCollectionRequest, ListLifecycleJournalRequest, MemoryStatusResponse, PromoteDreamEntriesRequest, RankCandidatesRequest, RankCandidatesResponse, SearchTextCollectionsRequest, SearchTextRequest, SearchTextResponse, SessionLifecycleHintRequest, SessionLifecycleHintResponse, StringList, } from "@xdarkicex/libravdb-contracts";
+function encodeMessage(schema, init) {
+    return new schema(init).toBinary();
+}
+function decodeProtobufResult(schema, bytes) {
+    return new schema().fromBinary(bytes).toJson();
+}
+function emptyBytes() {
+    return new Uint8Array(0);
+}
+function normalizeSearchTextResponse(bytes) {
+    const response = decodeProtobufResult(SearchTextResponse, bytes);
+    if (!Array.isArray(response.results)) {
+        response.results = [];
+    }
+    for (const item of response.results) {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            continue;
+        }
+        if (!item.metadata || typeof item.metadata !== "object" || Array.isArray(item.metadata)) {
+            item.metadata = {};
+        }
+    }
+    return response;
+}
+function normalizeExcludeByCollection(value) {
+    const normalized = {};
+    if (!value) {
+        return normalized;
+    }
+    for (const [collection, raw] of Object.entries(value)) {
+        if (raw instanceof StringList) {
+            normalized[collection] = raw;
+            continue;
+        }
+        const values = Array.isArray(raw)
+            ? raw
+            : raw && typeof raw === "object" && Array.isArray(raw.values)
+                ? (raw.values)
+                : [];
+        normalized[collection] = new StringList({ values });
+    }
+    return normalized;
+}
+function codec(encodeParams, decodeResult) {
+    return { encodeParams, decodeResult };
+}
+const encodeEmpty = () => emptyBytes();
+export const rpcProtobufCodecs = {
+    health: codec(encodeEmpty, (bytes) => decodeProtobufResult(HealthResponse, bytes)),
+    status: codec(encodeEmpty, (bytes) => decodeProtobufResult(MemoryStatusResponse, bytes)),
+    flush: codec(encodeEmpty, (bytes) => decodeProtobufResult(FlushResponse, bytes)),
+    session_lifecycle_hint: codec((params) => encodeMessage(SessionLifecycleHintRequest, params), (bytes) => decodeProtobufResult(SessionLifecycleHintResponse, bytes)),
+    search_text: codec((params) => encodeMessage(SearchTextRequest, params), normalizeSearchTextResponse),
+    search_text_collections: codec((params) => encodeMessage(SearchTextCollectionsRequest, {
+        collections: params.collections,
+        text: params.text,
+        k: params.k ?? 0,
+        excludeByCollection: normalizeExcludeByCollection(params.excludeByCollection),
+    }), normalizeSearchTextResponse),
+    list_collection: codec((params) => encodeMessage(ListCollectionRequest, params), normalizeSearchTextResponse),
+    list_lifecycle_journal: codec((params) => encodeMessage(ListLifecycleJournalRequest, params), normalizeSearchTextResponse),
+    export_memory: codec((params) => encodeMessage(ExportMemoryRequest, params), (bytes) => decodeProtobufResult(ExportMemoryResponse, bytes)),
+    flush_namespace: codec((params) => encodeMessage(FlushNamespaceRequest, params), (bytes) => decodeProtobufResult(FlushNamespaceResponse, bytes)),
+    promote_dream_entries: codec((params) => encodeMessage(PromoteDreamEntriesRequest, params), (bytes) => decodeProtobufResult(DreamPromotionResponse, bytes)),
+    ingest_markdown_document: codec((params) => encodeMessage(IngestMarkdownDocumentRequest, params), (bytes) => decodeProtobufResult(IngestMarkdownDocumentResponse, bytes)),
+    delete_authored_document: codec((params) => encodeMessage(DeleteAuthoredDocumentRequest, params), (bytes) => decodeProtobufResult(DeleteAuthoredDocumentResponse, bytes)),
+    bootstrap_session_kernel: codec((params) => encodeMessage(BootstrapSessionKernelRequest, params), (bytes) => decodeProtobufResult(BootstrapSessionKernelResponse, bytes)),
+    ingest_message_kernel: codec((params) => encodeMessage(IngestMessageKernelRequest, params), (bytes) => decodeProtobufResult(IngestMessageKernelResponse, bytes)),
+    after_turn_kernel: codec((params) => encodeMessage(AfterTurnKernelRequest, params), (bytes) => decodeProtobufResult(AfterTurnKernelResponse, bytes)),
+    assemble_context_internal: codec((params) => encodeMessage(AssembleContextInternalRequest, params), (bytes) => decodeProtobufResult(AssembleContextInternalResponse, bytes)),
+    compact_session: codec((params) => encodeMessage(CompactSessionRequest, params), (bytes) => decodeProtobufResult(CompactSessionResponse, bytes)),
+    rank_candidates: codec((params) => encodeMessage(RankCandidatesRequest, params), (bytes) => decodeProtobufResult(RankCandidatesResponse, bytes)),
+};
+export function getRpcMethodCodec(method) {
+    return rpcProtobufCodecs[method];
+}

package/dist/rpc.d.ts

@@ -0,0 +1,14 @@
+import type { RpcCallOptions, SidecarSocket } from "./types.js";
+export declare class RpcClient {
+    private readonly socket;
+    private readonly options;
+    private seq;
+    private readonly pending;
+    private rxBuf;
+    private sentMagic;
+    constructor(socket: SidecarSocket, options: RpcCallOptions);
+    call<T>(method: string, params: unknown, callOptions?: Partial<RpcCallOptions>): Promise<T>;
+    private handleData;
+    private dispatchMessage;
+    private rejectAll;
+}

package/dist/rpc.js

@@ -0,0 +1,121 @@
+import { RpcRequest, RpcResponse } from "@xdarkicex/libravdb-contracts";
+import { getRpcMethodCodec } from "./rpc-protobuf-codecs.js";
+export class RpcClient {
+    socket;
+    options;
+    seq = 0n;
+    pending = new Map();
+    rxBuf = Buffer.alloc(0);
+    sentMagic = false;
+    constructor(socket, options) {
+        this.socket = socket;
+        this.options = options;
+        // Remove socket.setEncoding("utf8"); completely. The socket must stay binary.
+        socket.on("data", (chunk) => this.handleData(chunk));
+        socket.on("close", () => {
+            this.sentMagic = false; // Force magic byte on next reconnect
+            this.rejectAll(new Error("Socket closed"));
+        });
+        socket.on("error", (error) => this.rejectAll(error));
+    }
+    async call(method, params, callOptions = {}) {
+        const codec = getRpcMethodCodec(method);
+        if (!codec) {
+            throw new Error(`Unsupported LibraVDB RPC method for protobuf transport: ${method}`);
+        }
+        return await new Promise((resolve, reject) => {
+            const id = ++this.seq;
+            const timeoutMs = callOptions.timeoutMs ?? this.options.timeoutMs;
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`RPC timeout: ${method} (${timeoutMs}ms)`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer, decodeResult: codec.decodeResult });
+            try {
+                const envelope = new RpcRequest({
+                    id,
+                    method,
+                    params: codec.encodeParams(params),
+                });
+                const payload = Buffer.from(envelope.toBinary());
+                const header = Buffer.alloc(4);
+                header.writeUInt32BE(payload.byteLength, 0);
+                const chunks = [];
+                if (!this.sentMagic) {
+                    chunks.push(Buffer.from([0x02]));
+                    this.sentMagic = true;
+                }
+                chunks.push(header, payload);
+                this.socket.write(Buffer.concat(chunks));
+            }
+            catch (error) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    }
+    handleData(chunk) {
+        if (chunk.byteLength > 64 << 20) {
+            this.socket.destroy();
+            return;
+        }
+        this.rxBuf = Buffer.concat([this.rxBuf, chunk]);
+        while (this.rxBuf.byteLength >= 4) {
+            const payloadLength = this.rxBuf.readUInt32BE(0);
+            if (payloadLength > 64 << 20) {
+                this.socket.destroy();
+                return;
+            }
+            const frameSize = 4 + payloadLength;
+            // Wait for the full frame to arrive
+            if (this.rxBuf.byteLength < frameSize) {
+                break;
+            }
+            const payload = this.rxBuf.subarray(4, frameSize);
+            this.rxBuf = this.rxBuf.subarray(frameSize);
+            this.dispatchMessage(payload);
+        }
+        // Compaction guard: release large backing allocations if the remainder is tiny
+        if (this.rxBuf.buffer.byteLength > 65536 &&
+            this.rxBuf.byteLength < this.rxBuf.buffer.byteLength >>> 2) {
+            this.rxBuf = Buffer.from(this.rxBuf);
+        }
+    }
+    dispatchMessage(payload) {
+        try {
+            const msg = RpcResponse.fromBinary(payload);
+            if (typeof msg.id !== "bigint") {
+                this.socket.destroy(new Error("Protocol violation: expected bigint message id"));
+                return;
+            }
+            const pending = this.pending.get(msg.id);
+            if (!pending) {
+                return;
+            }
+            clearTimeout(pending.timer);
+            this.pending.delete(msg.id);
+            if (msg.error) {
+                const message = msg.error.message?.trim() || `RPC error ${msg.error.code}`;
+                pending.reject(new Error(msg.error.code ? `${message} (${msg.error.code})` : message));
+                return;
+            }
+            try {
+                pending.resolve(pending.decodeResult(msg.result));
+            }
+            catch (error) {
+                pending.reject(error instanceof Error ? error : new Error(String(error)));
+            }
+        }
+        catch {
+            // Ignore malformed frames
+        }
+    }
+    rejectAll(error) {
+        for (const [id, pending] of this.pending.entries()) {
+            clearTimeout(pending.timer);
+            this.pending.delete(id);
+            pending.reject(error);
+        }
+    }
+}