@hyperdrive.bot/fleet-client 0.3.161 → 0.3.163

package/dist/daemon-client.d.ts

@@ -131,6 +131,21 @@ export interface DaemonClientConfig {
      */
     defaultSendQueueTimeoutMs?: number;
     capabilities?: Partial<Record<ClientCapability, unknown>>;
+    /**
+     * Called once per request/response round trip that goes through the shared
+     * correlation path, with its wall time and outcome. Must not throw and must not
+     * forward the payloads anywhere: they carry prompts and paths. The app uses it
+     * to sample RPC latency into telemetry, reading only allowlisted fields.
+     */
+    onRequestComplete?: (event: DaemonRequestCompletion) => void;
+}
+export interface DaemonRequestCompletion {
+    requestType: SessionInboundMessage["type"];
+    durationMs: number;
+    outcome: "ok" | "error" | "timeout";
+    request: SessionInboundMessage;
+    /** The selected response value on `ok`, otherwise undefined. */
+    response?: unknown;
 }
 export interface SendMessageOptions {
     messageId?: string;
@@ -516,6 +531,9 @@ export type FetchAgentsOptions = Omit<FetchAgentsRequest, "type" | "requestId">
     timeout?: number;
 };
 export type FetchAgentsEntry = FetchAgentsPayload["entries"][number];
+export type GetAgentsByIdsPayload = Extract<SessionOutboundMessage, {
+    type: "get_agents_by_ids_response";
+}>["payload"];
 export type FetchAgentsPageInfo = FetchAgentsPayload["pageInfo"];
 type FetchAgentHistoryPayload = Extract<SessionOutboundMessage, {
     type: "fetch_agent_history_response";
@@ -851,6 +869,7 @@ export declare class DaemonClient {
             skipQueue?: boolean;
         };
     }): Promise<T>;
+    private reportRequestCompletion;
     private sendCorrelatedRequest;
     private sendCorrelatedSessionRequest;
     private sendNamespacedCorrelatedSessionRequest;
@@ -893,6 +912,16 @@ export declare class DaemonClient {
     private stopLivenessHeartbeat;
     private scheduleNextLivenessHeartbeat;
     fetchAgents(options?: FetchAgentsOptions): Promise<FetchAgentsPayload>;
+    /**
+     * Resolve up to 200 agents by id without a list load. Requires
+     * server_info.features.agentDirectoryDelta.
+     */
+    getAgentsByIds(ids: string[], options?: {
+        requestId?: string;
+        timeout?: number;
+        fields?: FetchAgentsOptions["fields"];
+        scope?: "active";
+    }): Promise<GetAgentsByIdsPayload>;
     fetchAgentHistory(options?: FetchAgentHistoryOptions): Promise<FetchAgentHistoryPayload>;
     fetchRecentProviderSessions(options?: FetchRecentProviderSessionsOptions): Promise<FetchRecentProviderSessionsPayload>;
     fetchWorkspaces(options?: FetchWorkspacesOptions): Promise<FetchWorkspacesPayload>;

package/dist/daemon-client.js

@@ -719,6 +719,7 @@ export class DaemonClient {
             }
             return { kind: "ok", value };
         }, timeout, params.options);
+        const startedAt = Date.now();
         try {
             await this.sendSessionMessageOrThrow(params.message);
         }
@@ -726,14 +727,43 @@ export class DaemonClient {
             const err = error instanceof Error ? error : new Error(String(error));
             cancel(err);
             void promise.catch(() => undefined);
+            this.reportRequestCompletion(params.message, startedAt, "error");
             throw err;
         }
-        const result = await promise;
+        let result;
+        try {
+            result = await promise;
+        }
+        catch (error) {
+            const outcome = isWaiterTimeoutError(error) ? "timeout" : "error";
+            this.reportRequestCompletion(params.message, startedAt, outcome);
+            throw error;
+        }
         if (result.kind === "error") {
+            this.reportRequestCompletion(params.message, startedAt, "error");
             throw result.error;
         }
+        this.reportRequestCompletion(params.message, startedAt, "ok", result.value);
         return result.value;
     }
+    reportRequestCompletion(request, startedAt, outcome, response) {
+        const hook = this.config.onRequestComplete;
+        if (!hook)
+            return;
+        try {
+            hook({
+                requestType: request.type,
+                durationMs: Date.now() - startedAt,
+                outcome,
+                request,
+                ...(outcome === "ok" ? { response } : {}),
+            });
+        }
+        catch (error) {
+            // Telemetry must never fail a request, but a silent give-up is invisible.
+            this.logger.warn({ err: error }, "onRequestComplete hook threw");
+        }
+    }
     async sendCorrelatedRequest(params) {
         return this.sendRequest({
             requestId: params.requestId,
@@ -998,6 +1028,9 @@ export class DaemonClient {
             ...(options?.sort ? { sort: options.sort } : {}),
             ...(options?.page ? { page: options.page } : {}),
             ...(options?.subscribe ? { subscribe: options.subscribe } : {}),
+            ...(options?.sinceCursor ? { sinceCursor: options.sinceCursor } : {}),
+            ...(options?.fields ? { fields: options.fields } : {}),
+            ...(options?.query ? { query: options.query } : {}),
         });
         return this.sendRequest({
             requestId: resolvedRequestId,
@@ -1015,6 +1048,35 @@ export class DaemonClient {
             },
         });
     }
+    /**
+     * Resolve up to 200 agents by id without a list load. Requires
+     * server_info.features.agentDirectoryDelta.
+     */
+    async getAgentsByIds(ids, options) {
+        const resolvedRequestId = this.createRequestId(options?.requestId);
+        const message = SessionInboundMessageSchema.parse({
+            type: "get_agents_by_ids_request",
+            requestId: resolvedRequestId,
+            ids,
+            ...(options?.fields ? { fields: options.fields } : {}),
+            ...(options?.scope ? { scope: options.scope } : {}),
+        });
+        return this.sendRequest({
+            requestId: resolvedRequestId,
+            message,
+            timeout: options?.timeout,
+            options: { skipQueue: true },
+            select: (msg) => {
+                if (msg.type !== "get_agents_by_ids_response") {
+                    return null;
+                }
+                if (msg.payload.requestId !== resolvedRequestId) {
+                    return null;
+                }
+                return msg.payload;
+            },
+        });
+    }
     async fetchAgentHistory(options) {
         const resolvedRequestId = this.createRequestId(options?.requestId);
         const message = SessionInboundMessageSchema.parse({
@@ -4705,6 +4767,7 @@ export class DaemonClient {
                     [CLIENT_CAPS.customModeIcons]: true,
                     [CLIENT_CAPS.reasoningMergeEnum]: true,
                     [CLIENT_CAPS.terminalReflowableSnapshot]: true,
+                    [CLIENT_CAPS.agentDirectoryDelta]: true,
                     ...this.config.capabilities,
                 },
                 ...(this.config.appVersion ? { appVersion: this.config.appVersion } : {}),

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import { DaemonClient } from "./daemon-client.js";
 import type { FetchAgentTimelineCursor, FetchAgentTimelineDirection, FetchAgentTimelinePayload, FetchAgentTimelineProjection } from "./daemon-client.js";
 export { DaemonClient };
 export { UploadCancelledError, UploadCapExceededError, UploadFailedError, } from "./daemon-client.js";
-export type { DaemonClientConfig, DaemonEvent, BrowserAutomationExecuteRequestMessage, BrowserAutomationExecuteResponseMessage, WebSocketFactory, WebSocketLike, } from "./daemon-client.js";
+export type { DaemonClientConfig, DaemonEvent, DaemonRequestCompletion, BrowserAutomationExecuteRequestMessage, BrowserAutomationExecuteResponseMessage, WebSocketFactory, WebSocketLike, } from "./daemon-client.js";
 export type ConnectionState = {
     status: "idle";
 } | {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/fleet-client",
-  "version": "0.3.161",
+  "version": "0.3.163",
   "description": "Paseo client SDK package",
   "license": "Apache-2.0",
   "files": [
@@ -36,8 +36,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@hyperdrive.bot/fleet-protocol": "0.3.161",
-    "@hyperdrive.bot/fleet-relay": "0.3.161",
+    "@hyperdrive.bot/fleet-protocol": "0.3.163",
+    "@hyperdrive.bot/fleet-relay": "0.3.163",
     "zod": "^4.4.3"
   },
   "devDependencies": {