@getpaseo/client 0.2.5 → 0.3.0-beta.1

package/dist/compat/normalize-provider-models.js

@@ -1,4 +1,5 @@
 import { normalizeAgentModelDefinition } from "@getpaseo/protocol/agent-types";
+import { expandProviderSnapshot } from "@getpaseo/protocol/provider-snapshot-codec";
 // COMPAT(model-normalize): daemon normalizes at source (provider-registry) — shim covers older daemons; drop when floor >= v0.1.104
 function normalizeAgentModels(models) {
     if (!models) {
@@ -30,7 +31,9 @@ export function normalizeListProviderModelsPayload(payload) {
     return models === payload.models ? payload : { ...payload, models };
 }
 export function normalizeProvidersSnapshotPayload(payload) {
-    const entries = normalizeProviderSnapshotEntries(payload.entries);
+    const entries = payload.compactSnapshot
+        ? expandProviderSnapshot(payload.compactSnapshot)
+        : normalizeProviderSnapshotEntries(payload.entries);
     return entries === payload.entries ? payload : { ...payload, entries };
 }
 export function normalizeProviderSnapshotUpdateMessage(msg) {

package/dist/daemon-client.d.ts

@@ -2,7 +2,7 @@ import type { z } from "zod";
 import { type ClientCapability } from "@getpaseo/protocol/client-capabilities";
 import type { AgentAttentionNotificationPayload } from "@getpaseo/protocol/agent-attention-notification";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ServerInfoStatusPayload } from "@getpaseo/protocol/messages";
-import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, FileUploadResponse, FileExplorerResponse, FileVersion, FileWriteResult, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommit, ParsedDiffFile, CheckoutCommitResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutForgeSetAutoMergeResponse, CheckoutGithubSetAutoMergeResponse, CheckoutForgeGetCheckDetailsResponse, CheckoutGithubGetCheckDetailsResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, ForgeSearchResponse, ForgeSearchRequest, GitHubSearchResponse, GitHubSearchRequest, DirectorySuggestionsResponse, PaseoWorktreeListResponse, PaseoWorktreeArchiveResponse, ProjectIconResponse, ProjectAddResponse, ProjectCreateDirectoryResponse, OpenProjectResponseMessage, WorkspaceGithubSearchRepositoriesResponse, ProjectGithubCloneProtocol, ProjectGithubCloneResponse, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest, WorkspaceRecoveryState } from "@getpaseo/protocol/messages";
+import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, FileUploadResponse, FileExplorerResponse, FileVersion, FileWriteResult, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommit, ParsedDiffFile, CheckoutCommitResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutForgeSetAutoMergeResponse, CheckoutGithubSetAutoMergeResponse, CheckoutForgeGetCheckDetailsResponse, CheckoutGithubGetCheckDetailsResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, ForgeSearchResponse, ForgeSearchRequest, GitHubSearchResponse, GitHubSearchRequest, DirectorySuggestionsResponse, PaseoWorktreeListResponse, PaseoWorktreeArchiveResponse, ProjectIconSource, ProjectIconResponse, ProjectIconGetResponse, ProjectAddResponse, ProjectCreateDirectoryResponse, OpenProjectResponseMessage, WorkspaceGithubSearchRepositoriesResponse, ProjectGithubCloneProtocol, ProjectGithubCloneResponse, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, ProviderUsageListResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest, WorkspaceRecoveryState } from "@getpaseo/protocol/messages";
 import type { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentProviderNotice, AgentProvider, AgentSessionConfig } from "@getpaseo/protocol/agent-types";
 import type { MutableDaemonConfig, MutableDaemonConfigPatch } from "@getpaseo/protocol/messages";
 import { type DaemonTransportFactory, type WebSocketFactory } from "./daemon-client-transport.js";
@@ -124,8 +124,14 @@ export interface DaemonClientConfig {
     };
     runtimeMetricsIntervalMs?: number;
     runtimeMetricsWindowMs?: number;
+    trace?: DaemonClientTrace;
     capabilities?: Partial<Record<ClientCapability, unknown>>;
 }
+export interface DaemonClientTrace {
+    isEnabled(): boolean;
+    beginSection(name: string, args?: Record<string, string>): void;
+    endSection(): void;
+}
 export interface SendMessageOptions {
     messageId?: string;
     images?: Array<{
@@ -343,9 +349,13 @@ export interface FetchAgentTimelineOptions {
     cursor?: FetchAgentTimelineCursor;
     limit?: number;
     projection?: FetchAgentTimelineProjection;
+    mergeWindow?: boolean;
     requestId?: string;
     timeout?: number;
 }
+export type AgentTimelinePromptIndexPayload = Extract<SessionOutboundMessage, {
+    type: "agent.timeline.list_prompts.response";
+}>["payload"];
 export type ProviderSubagentListPayload = Extract<SessionOutboundMessage, {
     type: "agent.provider_subagents.list.response";
 }>["payload"];
@@ -644,6 +654,11 @@ export declare class DaemonClient {
     }>) => void): () => void;
     on(handler: DaemonEventHandler): () => void;
     onAgentAttentionRequired(handler: (notification: AgentAttentionRequiredNotification) => void): () => void;
+    private beginTraceSection;
+    private endTraceSection;
+    private traceInstant;
+    private sendJsonMessage;
+    private sendTransportFrame;
     /**
      * Send a session message. For fire-and-forget messages (heartbeats, etc.),
      * failures are suppressed if `suppressSendErrors` is configured.
@@ -753,6 +768,7 @@ export declare class DaemonClient {
     renameProject(projectId: string, customName: string | null, requestId?: string): Promise<{
         customName: string | null;
     }>;
+    setProjectIcon(projectId: string, source: ProjectIconSource, requestId?: string): Promise<void>;
     removeProject(projectId: string, requestId?: string): Promise<{
         removedWorkspaceIds: string[];
     }>;
@@ -768,6 +784,10 @@ export declare class DaemonClient {
     importAgent(input: ImportAgentInput): Promise<AgentSnapshotPayload>;
     refreshAgent(agentId: string, requestId?: string): Promise<AgentRefreshedStatusPayload>;
     fetchAgentTimeline(agentId: string, options?: FetchAgentTimelineOptions): Promise<FetchAgentTimelinePayload>;
+    listAgentTimelinePrompts(agentId: string, options?: {
+        requestId?: string;
+        timeout?: number;
+    }): Promise<AgentTimelinePromptIndexPayload>;
     listProviderSubagents(parentAgentId: string, options?: {
         requestId?: string;
         timeout?: number;
@@ -955,6 +975,7 @@ export declare class DaemonClient {
     uploadFile(input: FileUploadInput): Promise<FileUploadResult>;
     requestDownloadToken(cwd: string, path: string, requestId?: string): Promise<FileDownloadTokenPayload>;
     requestProjectIcon(cwd: string, requestId?: string): Promise<ProjectIconResponse["payload"]>;
+    getProjectIcon(projectId: string, requestId?: string): Promise<ProjectIconGetResponse["payload"]>;
     listProviderModels(provider: AgentProvider, options?: {
         cwd?: string;
         requestId?: string;
@@ -971,6 +992,7 @@ export declare class DaemonClient {
     }): Promise<ListAvailableProvidersPayload>;
     getProvidersSnapshot(options?: {
         cwd?: string;
+        ifNoneMatch?: string;
         requestId?: string;
     }): Promise<GetProvidersSnapshotPayload>;
     getDaemonConfig(requestId?: string): Promise<{

package/dist/daemon-client.js

@@ -179,6 +179,21 @@ function concatByteChunks(chunks, size) {
     }
     return bytes;
 }
+function getTransportFrameSize(frame) {
+    if (typeof frame === "string") {
+        return frame.length;
+    }
+    return frame.byteLength;
+}
+function describeInboundTransportFrame(frame, rawBytes) {
+    if (typeof frame === "string") {
+        return { kind: "text", size: String(frame.length) };
+    }
+    if (rawBytes) {
+        return { kind: "binary", size: String(rawBytes.byteLength) };
+    }
+    return { kind: "unknown", size: "0" };
+}
 function hashForLog(value) {
     let hash = 0;
     for (let index = 0; index < value.length; index += 1) {
@@ -584,6 +599,45 @@ export class DaemonClient {
     // ============================================================================
     // Core Send Helpers
     // ============================================================================
+    beginTraceSection(name, args) {
+        const trace = this.config.trace;
+        if (!trace?.isEnabled()) {
+            return false;
+        }
+        trace.beginSection(name, args);
+        return true;
+    }
+    endTraceSection(isOpen) {
+        if (isOpen) {
+            this.config.trace?.endSection();
+        }
+    }
+    traceInstant(name, args) {
+        const isOpen = this.beginTraceSection(name, args);
+        this.endTraceSection(isOpen);
+    }
+    sendJsonMessage(envelopeType, messageType, message) {
+        this.traceInstant("paseo.ws.message.outbound", {
+            envelopeType,
+            messageType,
+        });
+        this.sendTransportFrame(JSON.stringify(message));
+    }
+    sendTransportFrame(frame) {
+        if (!this.transport) {
+            throw new Error("Transport not connected");
+        }
+        const isOpen = this.beginTraceSection("paseo.ws.frame.outbound", {
+            kind: typeof frame === "string" ? "text" : "binary",
+            size: String(getTransportFrameSize(frame)),
+        });
+        try {
+            this.transport.send(frame);
+        }
+        finally {
+            this.endTraceSection(isOpen);
+        }
+    }
     /**
      * Send a session message. For fire-and-forget messages (heartbeats, etc.),
      * failures are suppressed if `suppressSendErrors` is configured.
@@ -598,7 +652,7 @@ export class DaemonClient {
         }
         const payload = SessionInboundMessageSchema.parse(message);
         try {
-            this.transport.send(JSON.stringify({ type: "session", message: payload }));
+            this.sendJsonMessage("session", payload.type, { type: "session", message: payload });
         }
         catch (error) {
             if (this.config.suppressSendErrors) {
@@ -615,7 +669,11 @@ export class DaemonClient {
             throw new Error(`Transport not connected (status: ${this.connectionState.status})`);
         }
         try {
-            this.transport.send(frame);
+            this.traceInstant("paseo.ws.message.outbound", {
+                envelopeType: "binary",
+                messageType: "binary",
+            });
+            this.sendTransportFrame(frame);
         }
         catch (error) {
             if (this.config.suppressSendErrors) {
@@ -635,7 +693,7 @@ export class DaemonClient {
         // If connected, send immediately
         if (this.transport && status === "connected") {
             const payload = SessionInboundMessageSchema.parse(message);
-            this.transport.send(JSON.stringify({ type: "session", message: payload }));
+            this.sendJsonMessage("session", payload.type, { type: "session", message: payload });
             return Promise.resolve();
         }
         // If connecting, queue the message to be sent once connected
@@ -666,7 +724,7 @@ export class DaemonClient {
             try {
                 if (this.transport && this.connectionState.status === "connected") {
                     const payload = SessionInboundMessageSchema.parse(pending.message);
-                    this.transport.send(JSON.stringify({ type: "session", message: payload }));
+                    this.sendJsonMessage("session", payload.type, { type: "session", message: payload });
                     pending.resolve();
                 }
                 else {
@@ -774,7 +832,7 @@ export class DaemonClient {
         }
         const payload = SessionInboundMessageSchema.parse(message);
         try {
-            this.transport.send(JSON.stringify({ type: "session", message: payload }));
+            this.sendJsonMessage("session", payload.type, { type: "session", message: payload });
         }
         catch (error) {
             throw error instanceof Error ? error : new Error(String(error));
@@ -923,7 +981,7 @@ export class DaemonClient {
         };
         this.pingProbe = probe;
         try {
-            this.transport.send(JSON.stringify({ type: "ping" }));
+            this.sendJsonMessage("ping", "ping", { type: "ping" });
         }
         catch (error) {
             this.clearPingProbe();
@@ -1415,6 +1473,14 @@ export class DaemonClient {
         }
         return { customName: payload.customName };
     }
+    async setProjectIcon(projectId, source, requestId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: { type: "project.icon.set.request", projectId, source },
+        });
+        if (!payload.accepted)
+            throw new Error(payload.error ?? "setProjectIcon rejected");
+    }
     async removeProject(projectId, requestId) {
         const payload = await this.sendNamespacedCorrelatedSessionRequest({
             requestId,
@@ -1575,6 +1641,7 @@ export class DaemonClient {
             ...(options.cursor ? { cursor: options.cursor } : {}),
             ...(typeof options.limit === "number" ? { limit: options.limit } : {}),
             ...(options.projection ? { projection: options.projection } : {}),
+            ...(options.mergeWindow === true ? { mergeWindow: true } : {}),
         });
         const payload = await this.sendRequest({
             requestId: resolvedRequestId,
@@ -1596,6 +1663,28 @@ export class DaemonClient {
         }
         return payload;
     }
+    async listAgentTimelinePrompts(agentId, options = {}) {
+        const requestId = this.createRequestId(options.requestId);
+        const message = SessionInboundMessageSchema.parse({
+            type: "agent.timeline.list_prompts.request",
+            agentId,
+            requestId,
+        });
+        const payload = await this.sendRequest({
+            requestId,
+            message,
+            timeout: options.timeout,
+            options: { skipQueue: true },
+            select: (response) => response.type === "agent.timeline.list_prompts.response" &&
+                response.payload.requestId === requestId
+                ? response.payload
+                : null,
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload;
+    }
     async listProviderSubagents(parentAgentId, options = {}) {
         const requestId = this.createRequestId(options.requestId);
         const message = SessionInboundMessageSchema.parse({
@@ -2827,6 +2916,12 @@ export class DaemonClient {
             responseType: "project_icon_response",
         });
     }
+    async getProjectIcon(projectId, requestId) {
+        return this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: { type: "project.icon.get.request", projectId },
+        });
+    }
     // ============================================================================
     // Provider Models / Commands
     // ============================================================================
@@ -2882,6 +2977,7 @@ export class DaemonClient {
             message: {
                 type: "get_providers_snapshot_request",
                 cwd: options?.cwd,
+                ifNoneMatch: options?.ifNoneMatch,
             },
             responseType: "get_providers_snapshot_response",
         });
@@ -3637,7 +3733,7 @@ export class DaemonClient {
             return;
         }
         try {
-            this.transport.send(JSON.stringify({
+            this.sendJsonMessage("hello", "hello", {
                 type: "hello",
                 clientId: this.config.clientId,
                 clientType: this.config.clientType ?? "cli",
@@ -3648,10 +3744,11 @@ export class DaemonClient {
                     [CLIENT_CAPS.terminalReflowableSnapshot]: true,
                     [CLIENT_CAPS.providerSubagents]: true,
                     [CLIENT_CAPS.projectUpdates]: true,
+                    [CLIENT_CAPS.compactProviderSnapshots]: true,
                     ...this.config.capabilities,
                 },
                 ...(this.config.appVersion ? { appVersion: this.config.appVersion } : {}),
-            }));
+            });
         }
         catch (error) {
             const message = error instanceof Error ? error.message : "Failed to send hello message";
@@ -3716,25 +3813,37 @@ export class DaemonClient {
             return;
         }
         const rawBytes = asUint8Array(rawData);
-        if (rawBytes && this.tryHandleBinaryFrame(rawBytes)) {
-            return;
+        const isOpen = this.beginTraceSection("paseo.ws.frame.inbound", describeInboundTransportFrame(rawData, rawBytes));
+        try {
+            if (rawBytes && this.tryHandleBinaryFrame(rawBytes)) {
+                return;
+            }
+            const payload = decodeMessageData(rawData);
+            if (!payload) {
+                return;
+            }
+            this.handleJsonPayload(payload, rawBytes?.byteLength);
         }
-        const payload = decodeMessageData(rawData);
-        if (!payload) {
-            return;
+        finally {
+            this.endTraceSection(isOpen);
         }
-        this.handleJsonPayload(payload, rawBytes?.byteLength);
     }
     handleJsonPayload(payload, rawBytesLength) {
         const bytes = rawBytesLength ?? payload.length;
         const startMs = perfNow();
         let parsedJson;
+        const parseTraceOpen = this.beginTraceSection("paseo.ws.json.parse", {
+            size: String(bytes),
+        });
         try {
             parsedJson = JSON.parse(payload);
         }
         catch {
             return;
         }
+        finally {
+            this.endTraceSection(parseTraceOpen);
+        }
         const parsed = validateWSOutboundMessage(parsedJson);
         if (!parsed.success) {
             const responseIdentity = extractCorrelatedResponseIdentity(parsedJson);
@@ -3753,10 +3862,18 @@ export class DaemonClient {
         }
         this.consecutiveLivenessFailures = 0;
         if (parsed.data.type === "pong") {
+            this.traceInstant("paseo.ws.message.inbound", {
+                envelopeType: "pong",
+                messageType: "pong",
+            });
             this.resolvePingProbe();
             this.runtimeMetrics?.recordMessage("pong", bytes, perfNow() - startMs);
             return;
         }
+        this.traceInstant("paseo.ws.message.inbound", {
+            envelopeType: "session",
+            messageType: parsed.data.message.type,
+        });
         this.handleSessionMessage(parsed.data.message);
         const msgType = parsed.data.message.type;
         this.runtimeMetrics?.recordMessage(msgType, bytes, perfNow() - startMs);
@@ -3767,6 +3884,11 @@ export class DaemonClient {
     tryHandleBinaryFrame(rawBytes) {
         const fileFrame = decodeFileTransferFrame(rawBytes);
         if (fileFrame) {
+            this.traceInstant("paseo.ws.message.inbound", {
+                envelopeType: "binary",
+                messageType: "file",
+                opcode: String(fileFrame.opcode),
+            });
             this.consecutiveLivenessFailures = 0;
             this.handleFileTransferFrame(fileFrame);
             this.runtimeMetrics?.recordBinaryFrame("other", rawBytes.byteLength, 0);
@@ -3776,6 +3898,11 @@ export class DaemonClient {
         if (!frame) {
             return false;
         }
+        this.traceInstant("paseo.ws.message.inbound", {
+            envelopeType: "binary",
+            messageType: "terminal",
+            opcode: String(frame.opcode),
+        });
         this.consecutiveLivenessFailures = 0;
         const binaryStartMs = perfNow();
         this.terminalStreams.handleFrame(frame);

package/dist/index.js

@@ -121,7 +121,9 @@ function createAgentHandleFactory(daemonClient) {
                 latest = result?.agent ?? null;
                 return result;
             },
-            send: (text, options) => daemonClient.sendAgentMessage(id, text, options),
+            send: async (text, options) => {
+                await daemonClient.sendAgentMessage(id, text, options);
+            },
             archive: async () => {
                 const result = await daemonClient.archiveAgent(id);
                 if (latest) {

package/dist/terminal-stream-router.js

@@ -56,6 +56,7 @@ export class TerminalStreamRouter {
                 payload: encodeTerminalResizePayload({
                     rows: message.rows,
                     cols: message.cols,
+                    ...(message.intent ? { intent: message.intent } : {}),
                 }),
             });
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getpaseo/client",
-  "version": "0.2.5",
+  "version": "0.3.0-beta.1",
   "description": "Paseo client SDK package",
   "files": [
     "dist",
@@ -35,8 +35,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@getpaseo/protocol": "0.2.5",
-    "@getpaseo/relay": "0.2.5",
+    "@getpaseo/protocol": "0.3.0-beta.1",
+    "@getpaseo/relay": "0.3.0-beta.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {