@otto-code/client 0.8.13 → 0.8.15

package/dist/daemon-client-runtime-metrics.d.ts

@@ -32,6 +32,28 @@ export interface DaemonClientTrafficHotspot {
     maxMs: number;
     bytes: number;
 }
+/**
+ * One inbound session-message dispatch, retained only long enough to align it
+ * with a browser Long Animation Frame in the app's performance capture.
+ *
+ * `at` is an epoch timestamp so callers can compare it directly to the LoAF
+ * API. The phase timings are synchronous main-thread work and sum to
+ * approximately `totalMs`; small gaps are metric bookkeeping.
+ */
+export interface DaemonClientInboundDispatchTiming {
+    at: number;
+    type: string;
+    /** Set for agent-scoped messages, so a capture can tell one hot agent from a spread. */
+    agentId?: string;
+    bytes: number;
+    decodeAndValidateMs: number;
+    internalDispatchMs: number;
+    rawListenersMs: number;
+    typedHandlersMs: number;
+    totalMs: number;
+}
+/** Bounded independently from rolling log buckets: this is capture evidence, not telemetry. */
+export declare const INBOUND_DISPATCH_TIMING_CAPACITY = 500;
 export declare class DaemonClientRuntimeMetrics {
     private readonly logger;
     private readonly context;
@@ -49,11 +71,18 @@ export declare class DaemonClientRuntimeMetrics {
     private totalHandlerMs;
     private totalBinaryFrames;
     private readonly cumulativeByType;
+    private readonly inboundDispatchTimings;
     constructor(logger: RuntimeMetricsLogger, context: RuntimeMetricsContext, options?: RuntimeMetricsOptions);
     recordMessage(type: string, bytes: number, handlerMs: number): void;
     getTrafficTotals(): DaemonClientTrafficTotals;
     /** Inbound message types ranked by the main-thread time they have cost. */
     getTrafficHotspots(limit?: number): DaemonClientTrafficHotspot[];
+    recordInboundDispatch(timing: DaemonClientInboundDispatchTiming): void;
+    /**
+     * Recent inbound dispatches for a performance capture. Copies keep capture
+     * consumers from mutating a live client's bounded ring.
+     */
+    getInboundDispatchTimings(sinceMs?: number): DaemonClientInboundDispatchTiming[];
     private recordCumulative;
     recordAgentStream(payload: Extract<SessionOutboundMessage, {
         type: "agent_stream";

package/dist/daemon-client-runtime-metrics.js

@@ -1,4 +1,6 @@
 const DEFAULT_ROLLING_WINDOW_MS = 60000;
+/** Bounded independently from rolling log buckets: this is capture evidence, not telemetry. */
+export const INBOUND_DISPATCH_TIMING_CAPACITY = 500;
 export class DaemonClientRuntimeMetrics {
     constructor(logger, context, options) {
         this.logger = logger;
@@ -17,6 +19,7 @@ export class DaemonClientRuntimeMetrics {
         this.totalHandlerMs = 0;
         this.totalBinaryFrames = 0;
         this.cumulativeByType = new Map();
+        this.inboundDispatchTimings = [];
         this.windowMs =
             typeof options?.windowMs === "number" && options.windowMs > 0
                 ? options.windowMs
@@ -54,6 +57,21 @@ export class DaemonClientRuntimeMetrics {
         rows.sort((left, right) => right.totalMs - left.totalMs);
         return rows.slice(0, limit);
     }
+    recordInboundDispatch(timing) {
+        this.inboundDispatchTimings.push(cloneInboundDispatchTiming(timing));
+        if (this.inboundDispatchTimings.length > INBOUND_DISPATCH_TIMING_CAPACITY) {
+            this.inboundDispatchTimings.splice(0, this.inboundDispatchTimings.length - INBOUND_DISPATCH_TIMING_CAPACITY);
+        }
+    }
+    /**
+     * Recent inbound dispatches for a performance capture. Copies keep capture
+     * consumers from mutating a live client's bounded ring.
+     */
+    getInboundDispatchTimings(sinceMs) {
+        return this.inboundDispatchTimings
+            .filter((timing) => sinceMs === undefined || timing.at >= sinceMs)
+            .map(cloneInboundDispatchTiming);
+    }
     // Shared by JSON messages and binary frames; the per-sink totals
     // (`totalMessages` / `totalBinaryFrames`) are bumped by the callers so a
     // binary frame is never counted as both.
@@ -192,6 +210,19 @@ function cloneHandlerTimingMap(map) {
         { count: value.count, totalMs: value.totalMs, maxMs: value.maxMs },
     ]));
 }
+function cloneInboundDispatchTiming(timing) {
+    return {
+        at: timing.at,
+        type: timing.type,
+        agentId: timing.agentId,
+        bytes: timing.bytes,
+        decodeAndValidateMs: timing.decodeAndValidateMs,
+        internalDispatchMs: timing.internalDispatchMs,
+        rawListenersMs: timing.rawListenersMs,
+        typedHandlersMs: timing.typedHandlersMs,
+        totalMs: timing.totalMs,
+    };
+}
 function mergeCountMap(target, source) {
     for (const [key, value] of source) {
         incrementCount(target, key, value);

package/dist/daemon-client.d.ts

@@ -9,9 +9,10 @@ import type { OrchestrationGraph, PromptTemplate, Run } from "@otto-code/protoco
 import type { BrainCatalogModel, BrainDiskUsage, BrainEvals, BrainHfSearchResult, BrainHostStatus, BrainInstalledModel, BrainInventoryModel, BrainJob, BrainLogsTailResponse, BrainLogsWatchResponse, BrainModelBudgetGetResponse, BrainModelDeleteResponse, BrainModelLoadResponse, BrainModelProfileGetResponse, BrainModelProfileSetResponse, BrainModelRenameResetResponse, BrainModelRenameResponse, BrainNetworkInfo, BrainRemoteConfig, BrainRepoQuant, BrainRuntime, ConnectorsListToolsResponse, ConnectorsOauthAuthorizeResponse, ConnectorsOauthDisconnectResponse, CommunicationsGetOverviewResponse, CommunicationsInboxGetHomeResponse, CommunicationsInboxNotificationsAcknowledgeResponse, CommunicationsInboxSearchResponse, CommunicationsInboxSetFavoriteResponse, CommunicationsInboxGetPresenceResponse, CommunicationsInboxGetMessagesResponse, CommunicationsInboxSetPresenceResponse, CommunicationsInboxSetEnabledResponse, CommunicationsInboxSendMessageResponse, CommunicationsRoomGetResponse, CommunicationsRoomThreadGetResponse, CommunicationsRoomMessageSendResponse, CommunicationsRoomReactionSetResponse, IntegrationsAuthorizationGetOverviewResponse, IntegrationsAuthorizationGetMethodsResponse, IntegrationsAuthorizationStartBrowserResponse, IntegrationsZoomStartAuthorizationResponse, CueMoment, MutableDaemonConfig, MutableDaemonConfigPatch, ProjectLink, SpeechSettingsOptions, SpeechTtsPreviewResult, SpeechTtsSpeakResult, SpeechTtsSpeakCancelResult, VisualizerVoiceCuesResult, AgentPersonalitiesGenerateProfileResult } from "@otto-code/protocol/messages";
 import type { AgentConfigApply } from "@otto-code/protocol/messages";
 import { type DaemonTransportFactory, type WebSocketFactory } from "./daemon-client-transport.js";
-import { type DaemonClientTrafficHotspot, type DaemonClientTrafficTotals } from "./daemon-client-runtime-metrics.js";
+import { type DaemonClientInboundDispatchTiming, type DaemonClientTrafficHotspot, type DaemonClientTrafficTotals } from "./daemon-client-runtime-metrics.js";
 import { type TerminalStreamEvent } from "./terminal-stream-router.js";
 import type { BrowserAutomationExecuteRequest, BrowserAutomationExecuteResponse } from "@otto-code/protocol/browser-automation/rpc-schemas";
+export type { DaemonClientInboundDispatchTiming } from "./daemon-client-runtime-metrics.js";
 export interface Logger {
     debug(obj: object, msg?: string): void;
     info(obj: object, msg?: string): void;
@@ -2157,6 +2158,12 @@ export declare class DaemonClient {
      */
     getTrafficTotals(): DaemonClientTrafficTotals | null;
     getTrafficHotspots(limit?: number): DaemonClientTrafficHotspot[];
+    /**
+     * Bounded, timestamped dispatch phases for matching an inbound daemon
+     * message to a browser Long Animation Frame. This is diagnostic evidence,
+     * not a protocol surface.
+     */
+    getInboundDispatchTimings(sinceMs?: number): DaemonClientInboundDispatchTiming[];
     private resolveTransportUrlForAttempt;
     private sendHelloMessage;
     private disposeTransport;

package/dist/daemon-client.js

@@ -186,6 +186,15 @@ function concatByteChunks(chunks, size) {
     }
     return bytes;
 }
+function extractDispatchAgentId(message) {
+    if (message.type === "agent_stream") {
+        return message.payload.agentId;
+    }
+    if (message.type === "agent_update") {
+        return message.payload.kind === "upsert" ? message.payload.agent.id : message.payload.agentId;
+    }
+    return undefined;
+}
 function getTransportFrameSize(frame) {
     if (typeof frame === "string") {
         return frame.length;
@@ -6055,6 +6064,14 @@ export class DaemonClient {
     getTrafficHotspots(limit) {
         return this.runtimeMetrics?.getTrafficHotspots(limit) ?? [];
     }
+    /**
+     * Bounded, timestamped dispatch phases for matching an inbound daemon
+     * message to a browser Long Animation Frame. This is diagnostic evidence,
+     * not a protocol surface.
+     */
+    getInboundDispatchTimings(sinceMs) {
+        return this.runtimeMetrics?.getInboundDispatchTimings(sinceMs) ?? [];
+    }
     resolveTransportUrlForAttempt() {
         return this.config.url;
     }
@@ -6168,6 +6185,7 @@ export class DaemonClient {
     }
     handleJsonPayload(payload, rawBytesLength) {
         const bytes = rawBytesLength ?? payload.length;
+        const dispatchAt = Date.now();
         const startMs = perfNow();
         let parsedJson;
         const parseTraceOpen = this.beginTraceSection("otto.ws.json.parse", {
@@ -6212,9 +6230,21 @@ export class DaemonClient {
             envelopeType: "session",
             messageType: parsed.data.message.type,
         });
-        this.handleSessionMessage(parsed.data.message);
+        const phases = this.handleSessionMessage(parsed.data.message);
         const msgType = parsed.data.message.type;
-        this.runtimeMetrics?.recordMessage(msgType, bytes, perfNow() - startMs);
+        const totalMs = perfNow() - startMs;
+        this.runtimeMetrics?.recordMessage(msgType, bytes, totalMs);
+        this.runtimeMetrics?.recordInboundDispatch({
+            at: dispatchAt,
+            type: msgType,
+            agentId: extractDispatchAgentId(parsed.data.message),
+            bytes,
+            decodeAndValidateMs: phases.startedAtMs - startMs,
+            internalDispatchMs: phases.internalDispatchMs,
+            rawListenersMs: phases.rawListenersMs,
+            typedHandlersMs: phases.typedHandlersMs,
+            totalMs,
+        });
         if (parsed.data.message.type === "agent_stream") {
             this.runtimeMetrics?.recordAgentStream(parsed.data.message.payload);
         }
@@ -6426,6 +6456,7 @@ export class DaemonClient {
         });
     }
     handleSessionMessage(msg) {
+        const startedAtMs = perfNow();
         const consumerMessage = normalizeProviderSnapshotUpdateMessage(msg);
         if (consumerMessage.type === "status") {
             const serverInfo = parseServerInfoStatusPayload(consumerMessage.payload);
@@ -6453,6 +6484,7 @@ export class DaemonClient {
         if (consumerMessage.type === "project.scaffold.progress") {
             this.scaffoldProgressListeners.get(consumerMessage.payload.requestId)?.(consumerMessage.payload);
         }
+        const rawListenersStartedAtMs = perfNow();
         if (this.rawMessageListeners.size > 0) {
             for (const handler of this.rawMessageListeners) {
                 try {
@@ -6463,6 +6495,7 @@ export class DaemonClient {
                 }
             }
         }
+        const typedHandlersStartedAtMs = perfNow();
         const handlers = this.messageHandlers.get(consumerMessage.type);
         if (handlers) {
             for (const handler of handlers) {
@@ -6481,6 +6514,13 @@ export class DaemonClient {
             }
         }
         this.resolveWaiters(consumerMessage);
+        const finishedAtMs = perfNow();
+        return {
+            startedAtMs,
+            internalDispatchMs: rawListenersStartedAtMs - startedAtMs,
+            rawListenersMs: typedHandlersStartedAtMs - rawListenersStartedAtMs,
+            typedHandlersMs: finishedAtMs - typedHandlersStartedAtMs,
+        };
     }
     resolveWaiters(msg) {
         for (const waiter of Array.from(this.waiters)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otto-code/client",
-  "version": "0.8.13",
+  "version": "0.8.15",
   "description": "Otto client SDK package",
   "license": "AGPL-3.0-or-later",
   "files": [
@@ -40,8 +40,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@otto-code/protocol": "0.8.13",
-    "@otto-code/relay": "0.8.13",
+    "@otto-code/protocol": "0.8.15",
+    "@otto-code/relay": "0.8.15",
     "zod": "^4.4.3"
   },
   "devDependencies": {