@getpaseo/client 0.1.110 → 0.2.0-beta.2

package/dist/daemon-client.d.ts

@@ -1,7 +1,8 @@
 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, FetchAgentTimelineResponseMessage, AgentForkContextResponseMessage, GitSetupOptions, CheckoutStatusResponse, CheckoutCommitResponse, CheckoutMergeResponse, CheckoutMergeFromBaseResponse, CheckoutPullResponse, CheckoutPushResponse, CheckoutRefreshResponse, CheckoutPrCreateResponse, CheckoutPrMergeResponse, CheckoutPrMergeMethod, CheckoutGithubSetAutoMergeResponse, CheckoutGithubGetCheckDetailsResponse, CheckoutPrStatusResponse, PullRequestTimelineResponse, CheckoutSwitchBranchResponse, StashSaveResponse, StashPopResponse, StashListResponse, ValidateBranchResponse, BranchSuggestionsResponse, 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 } 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 { 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";
@@ -15,6 +16,7 @@ export interface Logger {
 }
 interface ImportAgentInputBase {
     cwd?: string;
+    workspaceId?: string;
     labels?: Record<string, string>;
 }
 export type ImportAgentInput = (ImportAgentInputBase & {
@@ -51,6 +53,11 @@ export type DaemonEvent = {
     payload: Extract<SessionOutboundMessage, {
         type: "workspace_update";
     }>["payload"];
+} | {
+    type: "project.update";
+    payload: Extract<SessionOutboundMessage, {
+        type: "project.update";
+    }>["payload"];
 } | {
     type: "workspace_setup_progress";
     workspaceId: string;
@@ -127,6 +134,13 @@ export interface SendMessageOptions {
     }>;
     attachments?: SendAgentMessageRequest["attachments"];
 }
+export interface AgentAttentionRequiredNotification {
+    agentId: string;
+    reason: "finished" | "error" | "permission";
+    timestamp: string;
+    shouldNotify: boolean;
+    notification?: AgentAttentionNotificationPayload;
+}
 type AgentConfigOverrides = Partial<Omit<AgentSessionConfig, "provider" | "cwd">>;
 export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     config?: AgentSessionConfig;
@@ -134,6 +148,7 @@ export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     cwd?: string;
     env?: CreateAgentRequestMessage["env"];
     workspaceId?: string;
+    callerAgentId?: string;
     initialPrompt?: string;
     clientMessageId?: string;
     outputSchema?: Record<string, unknown>;
@@ -146,7 +161,7 @@ export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     requestId?: string;
     labels?: Record<string, string>;
 }
-export interface CreatePaseoWorktreeInput extends Pick<CreatePaseoWorktreeRequest, "cwd" | "projectId" | "worktreeSlug" | "firstAgentContext" | "refName" | "action" | "githubPrNumber"> {
+export interface CreatePaseoWorktreeInput extends Pick<CreatePaseoWorktreeRequest, "cwd" | "projectId" | "worktreeSlug" | "firstAgentContext" | "refName" | "action" | "checkoutSource" | "githubPrNumber"> {
 }
 type CheckoutStatusPayload = CheckoutStatusResponse["payload"];
 type SubscribeCheckoutDiffPayload = Extract<SessionOutboundMessage, {
@@ -161,7 +176,9 @@ type CheckoutPushPayload = CheckoutPushResponse["payload"];
 type CheckoutRefreshPayload = CheckoutRefreshResponse["payload"];
 type CheckoutPrCreatePayload = CheckoutPrCreateResponse["payload"];
 type CheckoutPrMergePayload = CheckoutPrMergeResponse["payload"];
+type CheckoutForgeSetAutoMergePayload = CheckoutForgeSetAutoMergeResponse["payload"];
 type CheckoutGithubSetAutoMergePayload = CheckoutGithubSetAutoMergeResponse["payload"];
+type CheckoutForgeGetCheckDetailsPayload = CheckoutForgeGetCheckDetailsResponse["payload"];
 type CheckoutGithubGetCheckDetailsPayload = CheckoutGithubGetCheckDetailsResponse["payload"];
 type CheckoutPrStatusPayload = CheckoutPrStatusResponse["payload"];
 type PullRequestTimelinePayload = PullRequestTimelineResponse["payload"];
@@ -172,6 +189,7 @@ type StashPopPayload = StashPopResponse["payload"];
 type StashListPayload = StashListResponse["payload"];
 type ValidateBranchPayload = ValidateBranchResponse["payload"];
 type BranchSuggestionsPayload = BranchSuggestionsResponse["payload"];
+type ForgeSearchPayload = ForgeSearchResponse["payload"];
 type GitHubSearchPayload = GitHubSearchResponse["payload"];
 type DirectorySuggestionsPayload = DirectorySuggestionsResponse["payload"];
 type PaseoWorktreeListPayload = PaseoWorktreeListResponse["payload"];
@@ -192,6 +210,7 @@ export interface FileReadResult {
     path: string;
     kind: LegacyFileExplorerFilePayload["kind"];
     modifiedAt: string;
+    revision?: string;
 }
 export interface FileUploadInput {
     fileName: string;
@@ -473,9 +492,6 @@ export interface CreateScheduleOptions {
     prompt: string;
     name?: string | null;
     cadence: {
-        type: "every";
-        everyMs: number;
-    } | {
         type: "cron";
         expression: string;
         timezone?: string;
@@ -529,9 +545,6 @@ export interface UpdateScheduleOptions {
     name?: string | null;
     prompt?: string;
     cadence?: {
-        type: "every";
-        everyMs: number;
-    } | {
         type: "cron";
         expression: string;
         timezone?: string;
@@ -590,6 +603,7 @@ export declare class DaemonClient {
     private connectionState;
     private checkoutDiffSubscriptions;
     private terminalDirectorySubscriptions;
+    private fileSubscriptions;
     private readonly terminalStreams;
     private pendingBinaryFileReads;
     private activeBinaryFileTransfers;
@@ -626,6 +640,7 @@ export declare class DaemonClient {
         type: TType;
     }>) => void): () => void;
     on(handler: DaemonEventHandler): () => void;
+    onAgentAttentionRequired(handler: (notification: AgentAttentionRequiredNotification) => void): () => void;
     /**
      * Send a session message. For fire-and-forget messages (heartbeats, etc.),
      * failures are suppressed if `suppressSendErrors` is configured.
@@ -711,6 +726,7 @@ export declare class DaemonClient {
     fetchAgent(agentId: string, options?: LegacyFetchAgentOptions): Promise<FetchAgentResult | null>;
     private resubscribeCheckoutDiffSubscriptions;
     private resubscribeTerminalDirectorySubscriptions;
+    private resubscribeFileSubscriptions;
     createAgent(options: CreateAgentRequestOptions): Promise<AgentSnapshotPayload>;
     deleteAgent(agentId: string): Promise<void>;
     archiveAgent(agentId: string): Promise<{
@@ -733,6 +749,8 @@ export declare class DaemonClient {
     setWorkspacePinned(workspaceId: string, pinned: boolean, requestId?: string): Promise<{
         pinnedAt: string | null;
     }>;
+    inspectWorkspaceRecovery(workspaceId: string, requestId?: string): Promise<WorkspaceRecoveryState>;
+    restoreWorkspace(workspaceId: string, requestId?: string): Promise<void>;
     resumeAgent(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>): Promise<AgentSnapshotPayload>;
     importAgent(input: ImportAgentInput): Promise<AgentSnapshotPayload>;
     refreshAgent(agentId: string, requestId?: string): Promise<AgentRefreshedStatusPayload>;
@@ -742,6 +760,7 @@ export declare class DaemonClient {
         timeout?: number;
     }): Promise<ProviderSubagentListPayload>;
     fetchProviderSubagentTimeline(parentAgentId: string, subagentId: string, options?: FetchProviderSubagentTimelineOptions): Promise<ProviderSubagentTimelinePayload>;
+    setAgentTimelineSubscription(agentIds: string[]): Promise<void>;
     buildAgentForkContext(agentId: string, options?: AgentForkContextOptions): Promise<AgentForkContextPayload>;
     sendAgentMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
     sendMessage(agentId: string, text: string, options?: SendMessageOptions): Promise<void>;
@@ -799,6 +818,13 @@ export declare class DaemonClient {
     checkoutPull(cwd: string, requestId?: string): Promise<CheckoutPullPayload>;
     checkoutPush(cwd: string, requestId?: string): Promise<CheckoutPushPayload>;
     checkoutRefresh(cwd: string, requestId?: string): Promise<CheckoutRefreshPayload>;
+    listCheckoutCommits(cwd: string, requestId?: string): Promise<{
+        baseRef: string | null;
+        commits: CheckoutCommit[];
+    }>;
+    getCommitFileDiff(cwd: string, sha: string, path: string, requestId?: string): Promise<{
+        file: ParsedDiffFile | null;
+    }>;
     checkoutPrCreate(cwd: string, input: {
         title?: string;
         body?: string;
@@ -807,17 +833,31 @@ export declare class DaemonClient {
     checkoutPrMerge(cwd: string, input: {
         method: CheckoutPrMergeMethod;
     }, requestId?: string): Promise<CheckoutPrMergePayload>;
+    checkoutForgeSetAutoMerge(cwd: string, input: {
+        enabled: true;
+        method: CheckoutPrMergeMethod;
+    } | {
+        enabled: false;
+    }, requestId?: string): Promise<CheckoutForgeSetAutoMergePayload>;
     checkoutGithubSetAutoMerge(cwd: string, input: {
         enabled: true;
         method: CheckoutPrMergeMethod;
     } | {
         enabled: false;
     }, requestId?: string): Promise<CheckoutGithubSetAutoMergePayload>;
+    checkoutForgeGetCheckDetails(input: {
+        cwd: string;
+        repoOwner?: string;
+        repoName?: string;
+        checkRunId?: number;
+        workflowRunId?: number;
+        changeRequestNumber?: number;
+    }, requestId?: string): Promise<CheckoutForgeGetCheckDetailsPayload>;
     checkoutGithubGetCheckDetails(input: {
         cwd: string;
-        repoOwner: string;
-        repoName: string;
-        checkRunId: number;
+        repoOwner?: string;
+        repoName?: string;
+        checkRunId?: number;
         workflowRunId?: number;
     }, requestId?: string): Promise<CheckoutGithubGetCheckDetailsPayload>;
     checkoutPrStatus(cwd: string, requestId?: string): Promise<CheckoutPrStatusPayload>;
@@ -862,6 +902,12 @@ export declare class DaemonClient {
         query?: string;
         limit?: number;
     }, requestId?: string): Promise<BranchSuggestionsPayload>;
+    searchForge(options: {
+        cwd: string;
+        query: string;
+        limit?: number;
+        kinds?: ForgeSearchRequest["kinds"];
+    }, requestId?: string): Promise<ForgeSearchPayload>;
     searchGitHub(options: {
         cwd: string;
         query: string;
@@ -879,6 +925,20 @@ export declare class DaemonClient {
     private requestFileExplorer;
     listDirectory(cwd: string, path: string, requestId?: string): Promise<FileExplorerDirectoryPayload>;
     readFile(cwd: string, path: string, requestId?: string): Promise<FileReadResult>;
+    subscribeFile(input: {
+        cwd: string;
+        path: string;
+    }, onUpdate: (version: FileVersion) => void): Promise<{
+        initial: FileVersion;
+        unsubscribe: () => void;
+    }>;
+    writeFile(input: {
+        cwd: string;
+        path: string;
+        content: string;
+        expectedModifiedAt: string;
+        expectedRevision?: string;
+    }): Promise<FileWriteResult>;
     uploadFile(input: FileUploadInput): Promise<FileUploadResult>;
     requestDownloadToken(cwd: string, path: string, requestId?: string): Promise<FileDownloadTokenPayload>;
     requestProjectIcon(cwd: string, requestId?: string): Promise<ProjectIconResponse["payload"]>;
@@ -905,6 +965,40 @@ export declare class DaemonClient {
         config: MutableDaemonConfig;
     }>;
     getDaemonStatus(options?: DaemonStatusOptions): Promise<DaemonStatusPayload>;
+    connectHub(hubUrl: string, token: string, requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            scopes: string[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+    }>;
+    getHubStatus(requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            scopes: string[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+    }>;
+    disconnectHub(force?: boolean, requestId?: string): Promise<{
+        requestId: string;
+        status: {
+            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            daemonId: string | null;
+            hubOrigin: string | null;
+            scopes: string[];
+            connectedAt: string | null;
+            lastError: string | null;
+        };
+        warning?: string | undefined;
+    }>;
     getDaemonPairingOffer(options?: DaemonPairingOfferOptions): Promise<DaemonPairingOfferPayload>;
     collectDiagnostics(requestId?: string): Promise<DiagnosticsPayload>;
     patchDaemonConfig(config: MutableDaemonConfigPatch, requestId?: string): Promise<{
@@ -995,6 +1089,7 @@ export declare class DaemonClient {
     waitForTerminalStreamEvent(predicate: (event: TerminalStreamEvent) => boolean, timeout?: number): Promise<TerminalStreamEvent>;
     private createRequestId;
     getLastServerInfoMessage(): ServerInfoStatusPayload | null;
+    private requireHubRelationshipSupport;
     private resolveTransportUrlForAttempt;
     private sendHelloMessage;
     private disposeTransport;
@@ -1015,6 +1110,7 @@ export declare class DaemonClient {
     private recordLivenessFailure;
     private handleSessionMessage;
     private resolveWaiters;
+    private rejectWaitersForRequestId;
     private clearWaiters;
     private toEvent;
     private waitForWithCancel;

package/dist/daemon-client.js

@@ -24,6 +24,34 @@ function normalizePassword(value) {
     }
     return value.length > 0 ? value : null;
 }
+function extractCorrelatedResponseIdentity(input) {
+    if (!input || typeof input !== "object") {
+        return null;
+    }
+    const envelope = input;
+    if (envelope.type !== "session" || !envelope.message || typeof envelope.message !== "object") {
+        return null;
+    }
+    const message = envelope.message;
+    if (typeof message.type !== "string" ||
+        !(message.type === "rpc_error" ||
+            message.type.endsWith("_response") ||
+            message.type.endsWith(".response") ||
+            message.type.endsWith("/response"))) {
+        return null;
+    }
+    if (!message.payload || typeof message.payload !== "object") {
+        return null;
+    }
+    const payload = message.payload;
+    if (typeof payload.requestId !== "string") {
+        return null;
+    }
+    return {
+        requestId: payload.requestId,
+        responseType: message.type,
+    };
+}
 // COMPAT(daemon-client-object-options): added in v0.1.102; remove after
 // 2026-12-29 once SDK callers have migrated to object parameters.
 function normalizeFetchAgentOptions(input, legacyOptions) {
@@ -58,6 +86,16 @@ class DaemonRpcError extends Error {
         this.code = params.code;
     }
 }
+class DaemonProtocolError extends Error {
+    constructor(identity) {
+        const responseLabel = identity.responseType ?? "unknown response";
+        super(`Response validation failed for ${responseLabel}`);
+        this.code = "invalid_response";
+        this.name = "DaemonProtocolError";
+        this.requestId = identity.requestId;
+        this.responseType = identity.responseType;
+    }
+}
 class PingTimeoutError extends Error {
     constructor(timeoutMs) {
         super(`Ping timed out (${timeoutMs}ms)`);
@@ -120,6 +158,7 @@ function legacyExplorerFileToBytes(file) {
         path: file.path,
         kind: file.kind,
         modifiedAt: file.modifiedAt,
+        revision: file.revision,
     };
 }
 function binaryFileKind(mime, encoding) {
@@ -192,6 +231,7 @@ export class DaemonClient {
         this.connectionState = { status: "idle" };
         this.checkoutDiffSubscriptions = new Map();
         this.terminalDirectorySubscriptions = new Map();
+        this.fileSubscriptions = new Map();
         this.terminalStreams = new TerminalStreamRouter();
         this.pendingBinaryFileReads = new Map();
         this.activeBinaryFileTransfers = new Map();
@@ -440,6 +480,7 @@ export class DaemonClient {
         this.rejectPendingSendQueue(new Error("Daemon client closed"));
         this.rejectPingProbe(new Error("Daemon client closed"));
         this.terminalStreams.clearSlots();
+        this.fileSubscriptions.clear();
         this.lastServerInfoMessage = null;
         if (this.runtimeMetricsInterval) {
             clearInterval(this.runtimeMetricsInterval);
@@ -518,6 +559,28 @@ export class DaemonClient {
             }
         };
     }
+    onAgentAttentionRequired(handler) {
+        const unsubscribeLegacy = this.on("agent_stream", (message) => {
+            if (message.payload.event.type !== "attention_required") {
+                return;
+            }
+            const event = message.payload.event;
+            handler({
+                agentId: message.payload.agentId,
+                reason: event.reason,
+                timestamp: event.timestamp,
+                shouldNotify: event.shouldNotify,
+                ...(event.notification ? { notification: event.notification } : {}),
+            });
+        });
+        const unsubscribeDedicated = this.on("agent_attention_required", (message) => {
+            handler(message.payload);
+        });
+        return () => {
+            unsubscribeLegacy();
+            unsubscribeDedicated();
+        };
+    }
     // ============================================================================
     // Core Send Helpers
     // ============================================================================
@@ -645,7 +708,7 @@ export class DaemonClient {
                 return null;
             }
             return { kind: "ok", value };
-        }, timeout, params.options);
+        }, timeout, { ...params.options, requestId: params.requestId });
         try {
             await this.sendSessionMessageOrThrow(params.message);
         }
@@ -1145,6 +1208,21 @@ export class DaemonClient {
             });
         }
     }
+    resubscribeFileSubscriptions() {
+        for (const [subscriptionId, subscription] of this.fileSubscriptions) {
+            void this.sendCorrelatedSessionRequest({
+                message: {
+                    type: "fs.file.subscribe.request",
+                    cwd: subscription.cwd,
+                    path: subscription.path,
+                    subscriptionId,
+                },
+                responseType: "fs.file.subscribe.response",
+            })
+                .then((payload) => subscription.onUpdate(payload.initial))
+                .catch(() => undefined);
+        }
+    }
     // ============================================================================
     // Agent Lifecycle
     // ============================================================================
@@ -1157,6 +1235,7 @@ export class DaemonClient {
             config,
             ...(options.env ? { env: options.env } : {}),
             ...(options.workspaceId !== undefined ? { workspaceId: options.workspaceId } : {}),
+            ...(options.callerAgentId !== undefined ? { callerAgentId: options.callerAgentId } : {}),
             ...(options.initialPrompt ? { initialPrompt: options.initialPrompt } : {}),
             ...(options.clientMessageId ? { clientMessageId: options.clientMessageId } : {}),
             ...(options.outputSchema ? { outputSchema: options.outputSchema } : {}),
@@ -1339,6 +1418,29 @@ export class DaemonClient {
         }
         return { pinnedAt: payload.pinnedAt };
     }
+    async inspectWorkspaceRecovery(workspaceId, requestId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "workspace.recovery.inspect.request",
+                workspaceId,
+            },
+        });
+        return payload.state;
+    }
+    async restoreWorkspace(workspaceId, requestId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "workspace.recovery.restore.request",
+                workspaceId,
+            },
+            timeout: 150000,
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "Workspace recovery was rejected by the host");
+        }
+    }
     async resumeAgent(handle, overrides) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
@@ -1373,6 +1475,7 @@ export class DaemonClient {
                 ? { providerId: input.providerId, providerHandleId: input.providerHandleId }
                 : { provider: input.provider, sessionId: input.sessionId }),
             ...(input.cwd ? { cwd: input.cwd } : {}),
+            ...(input.workspaceId ? { workspaceId: input.workspaceId } : {}),
             ...(input.labels && Object.keys(input.labels).length > 0 ? { labels: input.labels } : {}),
         });
         const status = await this.sendRequest({
@@ -1501,6 +1604,32 @@ export class DaemonClient {
         }
         return payload;
     }
+    async setAgentTimelineSubscription(agentIds) {
+        // COMPAT(selectiveAgentTimeline): added in v0.1.106. Old daemons keep their
+        // legacy global stream and do not understand this RPC. Remove after
+        // 2027-01-12 once the supported daemon floor is >= v0.1.106.
+        if (!this.lastServerInfoMessage?.features?.selectiveAgentTimeline) {
+            return;
+        }
+        const requestId = this.createRequestId();
+        const normalizedAgentIds = [...new Set(agentIds)].sort();
+        const message = SessionInboundMessageSchema.parse({
+            type: "agent.timeline.set_subscription.request",
+            agentIds: normalizedAgentIds,
+            requestId,
+        });
+        await this.sendRequest({
+            requestId,
+            message,
+            options: { skipQueue: true },
+            select: (response) => {
+                if (response.type !== "agent.timeline.set_subscription.response") {
+                    return null;
+                }
+                return response.payload.requestId === requestId ? response.payload : null;
+            },
+        });
+    }
     async buildAgentForkContext(agentId, options = {}) {
         const resolvedRequestId = this.createRequestId(options.requestId);
         const message = SessionInboundMessageSchema.parse({
@@ -2197,6 +2326,36 @@ export class DaemonClient {
             responseType: "checkout.refresh.response",
         });
     }
+    async listCheckoutCommits(cwd, requestId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "checkout.commits.list.request",
+                cwd,
+            },
+            timeout: 60000,
+        });
+        if (payload.error) {
+            throw new Error(payload.error.message);
+        }
+        return { baseRef: payload.baseRef, commits: payload.commits };
+    }
+    async getCommitFileDiff(cwd, sha, path, requestId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "checkout.commits.file_diff.request",
+                cwd,
+                sha,
+                path,
+            },
+            timeout: 60000,
+        });
+        if (payload.error) {
+            throw new Error(payload.error.message);
+        }
+        return { file: payload.file };
+    }
     async checkoutPrCreate(cwd, input, requestId) {
         return this.sendCorrelatedSessionRequest({
             requestId,
@@ -2221,6 +2380,18 @@ export class DaemonClient {
             responseType: "checkout_pr_merge_response",
         });
     }
+    async checkoutForgeSetAutoMerge(cwd, input, requestId) {
+        return this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "checkout.forge.set_auto_merge.request",
+                cwd,
+                enabled: input.enabled,
+                ...(input.enabled ? { mergeMethod: input.method } : {}),
+            },
+            timeout: 60000,
+        });
+    }
     async checkoutGithubSetAutoMerge(cwd, input, requestId) {
         return this.sendNamespacedCorrelatedSessionRequest({
             requestId,
@@ -2232,6 +2403,21 @@ export class DaemonClient {
             },
         });
     }
+    async checkoutForgeGetCheckDetails(input, requestId) {
+        return this.sendNamespacedCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "checkout.forge.get_check_details.request",
+                cwd: input.cwd,
+                repoOwner: input.repoOwner,
+                repoName: input.repoName,
+                checkRunId: input.checkRunId,
+                workflowRunId: input.workflowRunId,
+                changeRequestNumber: input.changeRequestNumber,
+            },
+            timeout: 60000,
+        });
+    }
     async checkoutGithubGetCheckDetails(input, requestId) {
         return this.sendNamespacedCorrelatedSessionRequest({
             requestId,
@@ -2361,6 +2547,7 @@ export class DaemonClient {
                     : {}),
                 ...(input.refName !== undefined ? { refName: input.refName } : {}),
                 ...(input.action !== undefined ? { action: input.action } : {}),
+                ...(input.checkoutSource !== undefined ? { checkoutSource: input.checkoutSource } : {}),
                 ...(input.githubPrNumber !== undefined ? { githubPrNumber: input.githubPrNumber } : {}),
             },
             responseType: "create_paseo_worktree_response",
@@ -2403,6 +2590,20 @@ export class DaemonClient {
             responseType: "branch_suggestions_response",
         });
     }
+    async searchForge(options, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "forge.search.request",
+                cwd: options.cwd,
+                query: options.query,
+                limit: options.limit,
+                kinds: options.kinds,
+            },
+            responseType: "forge.search.response",
+            timeout: 15000,
+        });
+    }
     async searchGitHub(options, requestId) {
         return this.sendCorrelatedSessionRequest({
             requestId,
@@ -2482,6 +2683,43 @@ export class DaemonClient {
             this.activeBinaryFileTransfers.delete(resolvedRequestId);
         }
     }
+    async subscribeFile(input, onUpdate) {
+        const subscriptionId = this.createRequestId();
+        this.fileSubscriptions.set(subscriptionId, { ...input, onUpdate });
+        try {
+            const payload = await this.sendCorrelatedSessionRequest({
+                message: {
+                    type: "fs.file.subscribe.request",
+                    cwd: input.cwd,
+                    path: input.path,
+                    subscriptionId,
+                },
+                responseType: "fs.file.subscribe.response",
+            });
+            return {
+                initial: payload.initial,
+                unsubscribe: () => {
+                    if (!this.fileSubscriptions.delete(subscriptionId))
+                        return;
+                    void this.sendCorrelatedSessionRequest({
+                        message: { type: "fs.file.unsubscribe.request", subscriptionId },
+                        responseType: "fs.file.unsubscribe.response",
+                    }).catch(() => undefined);
+                },
+            };
+        }
+        catch (error) {
+            this.fileSubscriptions.delete(subscriptionId);
+            throw error;
+        }
+    }
+    async writeFile(input) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            message: { type: "fs.file.write.request", ...input },
+            responseType: "fs.file.write.response",
+        });
+        return payload.result;
+    }
     async uploadFile(input) {
         const bytes = asUint8Array(input.bytes);
         if (!bytes) {
@@ -2627,6 +2865,30 @@ export class DaemonClient {
             timeout: options?.timeout,
         });
     }
+    async connectHub(hubUrl, token, requestId) {
+        this.requireHubRelationshipSupport();
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "hub.management.daemon.connect.request", hubUrl, token },
+            responseType: "hub.management.daemon.connect.response",
+        });
+    }
+    async getHubStatus(requestId) {
+        this.requireHubRelationshipSupport();
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "hub.management.daemon.get_status.request" },
+            responseType: "hub.management.daemon.get_status.response",
+        });
+    }
+    async disconnectHub(force = false, requestId) {
+        this.requireHubRelationshipSupport();
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "hub.management.daemon.disconnect.request", force },
+            responseType: "hub.management.daemon.disconnect.response",
+        });
+    }
     async getDaemonPairingOffer(options) {
         return this.sendCorrelatedSessionRequest({
             requestId: options?.requestId,
@@ -3315,6 +3577,12 @@ export class DaemonClient {
     getLastServerInfoMessage() {
         return this.lastServerInfoMessage;
     }
+    requireHubRelationshipSupport() {
+        // COMPAT(hubRelationship): added in v0.1.X, drop the gate when floor >= v0.1.X.
+        if (this.lastServerInfoMessage?.features?.hubRelationship !== true) {
+            throw new Error("Update the host to use Hub relationship management.");
+        }
+    }
     resolveTransportUrlForAttempt() {
         return this.config.url;
     }
@@ -3338,6 +3606,7 @@ export class DaemonClient {
                     [CLIENT_CAPS.reasoningMergeEnum]: true,
                     [CLIENT_CAPS.terminalReflowableSnapshot]: true,
                     [CLIENT_CAPS.providerSubagents]: true,
+                    [CLIENT_CAPS.projectUpdates]: true,
                     ...this.config.capabilities,
                 },
                 ...(this.config.appVersion ? { appVersion: this.config.appVersion } : {}),
@@ -3427,13 +3696,18 @@ export class DaemonClient {
         }
         const parsed = validateWSOutboundMessage(parsedJson);
         if (!parsed.success) {
-            const msgType = parsedJson != null &&
+            const responseIdentity = extractCorrelatedResponseIdentity(parsedJson);
+            const envelopeType = parsedJson != null &&
                 typeof parsedJson === "object" &&
                 "type" in parsedJson &&
                 typeof parsedJson.type === "string"
                 ? parsedJson.type
                 : "unknown";
+            const msgType = responseIdentity?.responseType ?? envelopeType;
             this.logger.warn({ msgType, error: parsed.error.message }, "Message validation failed");
+            if (responseIdentity) {
+                this.rejectWaitersForRequestId(responseIdentity.requestId, new DaemonProtocolError(responseIdentity));
+            }
             return;
         }
         this.consecutiveLivenessFailures = 0;
@@ -3489,6 +3763,7 @@ export class DaemonClient {
                 size: frame.metadata.size,
                 encoding: frame.metadata.encoding,
                 modifiedAt: frame.metadata.modifiedAt,
+                revision: frame.metadata.revision,
                 chunks: [],
             });
             return;
@@ -3510,6 +3785,7 @@ export class DaemonClient {
             path: transfer.path,
             kind: binaryFileKind(transfer.mime, transfer.encoding),
             modifiedAt: transfer.modifiedAt,
+            revision: transfer.revision,
         });
         this.handleSessionMessage({
             type: "file_explorer_response",
@@ -3658,6 +3934,7 @@ export class DaemonClient {
                     this.startLivenessHeartbeat();
                     this.resubscribeCheckoutDiffSubscriptions();
                     this.resubscribeTerminalDirectorySubscriptions();
+                    this.resubscribeFileSubscriptions();
                     this.flushPendingSendQueue();
                     this.resolveConnect();
                 }
@@ -3666,6 +3943,11 @@ export class DaemonClient {
         if (consumerMessage.type === "terminal_stream_exit") {
             this.terminalStreams.removeTerminal(consumerMessage.payload.terminalId);
         }
+        if (consumerMessage.type === "fs.file.update") {
+            this.fileSubscriptions
+                .get(consumerMessage.payload.subscriptionId)
+                ?.onUpdate(consumerMessage.payload.version);
+        }
         if (this.rawMessageListeners.size > 0) {
             for (const handler of this.rawMessageListeners) {
                 try {
@@ -3707,6 +3989,18 @@ export class DaemonClient {
             }
         }
     }
+    rejectWaitersForRequestId(requestId, error) {
+        for (const waiter of Array.from(this.waiters)) {
+            if (waiter.requestId !== requestId) {
+                continue;
+            }
+            this.waiters.delete(waiter);
+            if (waiter.timeoutHandle) {
+                clearTimeout(waiter.timeoutHandle);
+            }
+            waiter.reject(error);
+        }
+    }
     clearWaiters(error) {
         for (const waiter of Array.from(this.waiters)) {
             if (waiter.timeoutHandle) {
@@ -3730,6 +4024,8 @@ export class DaemonClient {
                     workspaceId: msg.payload.kind === "upsert" ? msg.payload.workspace.id : msg.payload.id,
                     payload: msg.payload,
                 };
+            case "project.update":
+                return { type: "project.update", payload: msg.payload };
             case "workspace_setup_progress":
                 return {
                     type: "workspace_setup_progress",
@@ -3771,7 +4067,7 @@ export class DaemonClient {
                 return null;
         }
     }
-    waitForWithCancel(predicate, timeout = 30000, _options) {
+    waitForWithCancel(predicate, timeout = 30000, options) {
         // Capture stack trace at call site, not inside setTimeout
         const timeoutError = new Error(`Timeout waiting for message (${timeout}ms)`);
         let waiter = null;
@@ -3804,6 +4100,7 @@ export class DaemonClient {
                 resolve: wrappedResolve,
                 reject: wrappedReject,
                 timeoutHandle,
+                requestId: options?.requestId,
             };
             this.waiters.add(waiter);
         });

package/dist/index.d.ts

@@ -118,13 +118,13 @@ export interface PaseoAgentCreateOptions extends PaseoAgentConfigOverrides {
     provider?: CreateAgentRequestMessage["config"]["provider"];
     cwd?: string;
     workspaceId?: string;
+    callerAgentId?: string;
     initialPrompt?: string;
     clientMessageId?: string;
     outputSchema?: Record<string, unknown>;
     images?: CreateAgentRequestMessage["images"];
     attachments?: CreateAgentRequestMessage["attachments"];
     git?: CreateAgentRequestMessage["git"];
-    worktreeName?: string;
     requestId?: string;
     labels?: Record<string, string>;
 }

package/package.json

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