@camerontaylor/paseo-client 0.8.0-fork.1 → 0.8.0-fork.3

package/dist/daemon-client.d.ts

@@ -1,7 +1,8 @@
-import { type TimelineSubscription } from "./connection/index.js";
-import type { CreationSnapshot } from "@camerontaylor/paseo-protocol/messages";
+import { type TimelineMessage } from "./timeline-subscription/index.js";
+import { type OwnedSubscription, type TimelineSubscription } from "./connection/index.js";
 import type { z } from "zod";
-import { type ClientCapability } from "@camerontaylor/paseo-protocol/client-capabilities";
+import type { SessionEventSubscription } from "@camerontaylor/paseo-protocol/messages";
+import type { ClientCapability } from "@camerontaylor/paseo-protocol/client-capabilities";
 import type { AgentAttentionNotificationPayload } from "@camerontaylor/paseo-protocol/agent-attention-notification";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ActiveTurnBehavior, type ServerInfoStatusPayload } from "@camerontaylor/paseo-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, DaemonConfigReloadResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest, WorkspaceRecoveryState, PluginListItem, PluginLogEntry, PluginSourceStatusItem, PluginSourceUpdateItem, AgentSkillSelection, AgentSkillsStatus, AgentSkillsSaveResult } from "@camerontaylor/paseo-protocol/messages";
@@ -155,8 +156,6 @@ export interface AgentAttentionRequiredNotification {
 }
 type AgentConfigOverrides = Partial<Omit<AgentSessionConfig, "provider" | "cwd">>;
 export interface CreateAgentRequestOptions extends AgentConfigOverrides {
-    agentId?: string;
-    onEvent?: (snapshot: CreationSnapshot) => void;
     config?: AgentSessionConfig;
     provider?: AgentProvider;
     cwd?: string;
@@ -176,16 +175,6 @@ export interface CreateAgentRequestOptions extends AgentConfigOverrides {
     requestId?: string;
     labels?: Record<string, string>;
 }
-export interface CreateWorkspaceRequestOptions {
-    source: WorkspaceCreateRequest["source"];
-    title?: string;
-    idempotencyKey?: string;
-    workspaceId?: string;
-    agent?: Omit<CreateAgentRequestOptions, "workspaceId" | "onEvent" | "worktree" | "git" | "worktreeName" | "idempotencyKey" | "requestId">;
-    onEvent?: (snapshot: CreationSnapshot) => void;
-    firstAgentContext?: WorkspaceCreateRequest["firstAgentContext"];
-    requestId?: string;
-}
 export interface CreatePaseoWorktreeInput extends Pick<CreatePaseoWorktreeRequest, "cwd" | "projectId" | "worktreeSlug" | "firstAgentContext" | "refName" | "action" | "checkoutSource" | "githubPrNumber"> {
 }
 type CheckoutStatusPayload = CheckoutStatusResponse["payload"];
@@ -389,6 +378,7 @@ type FetchAgentsRequest = Extract<SessionInboundMessage, {
     type: "fetch_agents_request";
 }>;
 export type FetchAgentsOptions = Omit<FetchAgentsRequest, "type" | "requestId"> & {
+    signal?: AbortSignal;
     requestId?: string;
     timeout?: number;
 };
@@ -422,6 +412,7 @@ type FetchWorkspacesRequest = Extract<SessionInboundMessage, {
     type: "fetch_workspaces_request";
 }>;
 export type FetchWorkspacesOptions = Omit<FetchWorkspacesRequest, "type" | "requestId"> & {
+    signal?: AbortSignal;
     requestId?: string;
 };
 export type FetchWorkspacesEntry = FetchWorkspacesPayload["entries"][number];
@@ -549,15 +540,22 @@ type CorrelatedResponseMessage = Extract<SessionOutboundMessage, {
     payload: {
         requestId: string;
     };
+}> | Extract<SessionOutboundMessage, {
+    type: "terminals_changed";
 }> | GetDaemonConfigResponse | SetDaemonConfigResponse;
 type CorrelatedResponseType = CorrelatedResponseMessage["type"];
-type CorrelatedResponsePayload<TType extends CorrelatedResponseType> = Extract<CorrelatedResponseMessage, {
-    type: TType;
-}>["payload"];
+type CorrelatedResponsePayloads = {
+    [Message in CorrelatedResponseMessage as Message["type"]]: Message["payload"];
+};
+type CorrelatedResponsePayload<TType extends CorrelatedResponseType> = CorrelatedResponsePayloads[TType];
+export declare class DaemonConnectionError extends Error {
+    readonly code: "DAEMON_CONNECTION_LOST" | "DAEMON_REQUEST_TIMEOUT";
+    constructor(message: string, code?: "DAEMON_CONNECTION_LOST" | "DAEMON_REQUEST_TIMEOUT");
+}
 export declare class DaemonClient {
     private config;
     private readonly providerSnapshotUpdates;
-    private readonly subscriptions;
+    private readonly owned;
     private transport;
     private transportCleanup;
     private rawMessageListeners;
@@ -576,9 +574,6 @@ export declare class DaemonClient {
     private connectReject;
     private lastErrorValue;
     private connectionState;
-    private checkoutDiffSubscriptions;
-    private terminalDirectorySubscriptions;
-    private fileSubscriptions;
     private readonly terminalStreams;
     private pendingBinaryFileReads;
     private activeBinaryFileTransfers;
@@ -679,18 +674,42 @@ export declare class DaemonClient {
     private startLivenessHeartbeat;
     private stopLivenessHeartbeat;
     private scheduleNextLivenessHeartbeat;
+    private observe;
+    registerBrowserHost(registration: Omit<Extract<SessionInboundMessage, {
+        type: "browser.host.register.request";
+    }>, "type" | "requestId">, options?: {
+        signal?: AbortSignal;
+    }): OwnedSubscription<CorrelatedResponsePayload<"browser.host.register.response">>;
+    observeEvents(events: SessionEventSubscription[], options?: {
+        signal?: AbortSignal;
+        notifications?: boolean;
+    }): OwnedSubscription<CorrelatedResponsePayload<"session.events.set_subscription.response">>;
+    observeAgents(options?: Omit<FetchAgentsOptions, "subscribe">): OwnedSubscription<FetchAgentsPayload>;
+    observeWorkspaces(options?: Omit<FetchWorkspacesOptions, "subscribe">): OwnedSubscription<FetchWorkspacesPayload>;
+    fetchAgents(options: FetchAgentsOptions & {
+        subscribe: {};
+    }): Promise<FetchAgentsPayload & {
+        subscription: OwnedSubscription<FetchAgentsPayload>;
+    }>;
     fetchAgents(options?: FetchAgentsOptions): Promise<FetchAgentsPayload>;
     fetchAgentHistory(options?: FetchAgentHistoryOptions): Promise<FetchAgentHistoryPayload>;
     fetchRecentProviderSessions(options?: FetchRecentProviderSessionsOptions): Promise<FetchRecentProviderSessionsPayload>;
+    fetchWorkspaces(options: FetchWorkspacesOptions & {
+        subscribe: {};
+    }): Promise<FetchWorkspacesPayload & {
+        subscription: OwnedSubscription<FetchWorkspacesPayload>;
+    }>;
     fetchWorkspaces(options?: FetchWorkspacesOptions): Promise<FetchWorkspacesPayload>;
-    listWorkspaceLabels(options: {
-        subscriptionId: string;
+    listWorkspaceLabels(options?: {
         sync?: {
             generation: string;
             afterSeq: number;
         };
         requestId?: string;
     }): Promise<WorkspaceLabelListPayload>;
+    observeWorkspaceLabels(options?: {
+        signal?: AbortSignal;
+    }): OwnedSubscription<WorkspaceLabelListPayload>;
     setWorkspaceLabel(options: {
         workspaceId: string;
         label: Extract<SessionInboundMessage, {
@@ -751,12 +770,7 @@ export declare class DaemonClient {
     fetchAgent(options: FetchAgentOptions): Promise<FetchAgentResult | null>;
     fetchAgent(agentId: string, requestId?: string): Promise<FetchAgentResult | null>;
     fetchAgent(agentId: string, options?: LegacyFetchAgentOptions): Promise<FetchAgentResult | null>;
-    private resubscribeCheckoutDiffSubscriptions;
-    private resubscribeTerminalDirectorySubscriptions;
-    private resubscribeFileSubscriptions;
-    private readonly creations;
     createAgent(options: CreateAgentRequestOptions): Promise<AgentSnapshotPayload>;
-    private createLegacyAgent;
     private requireAgentRequestReceipts;
     deleteAgent(agentId: string): Promise<void>;
     archiveAgent(agentId: string): Promise<{
@@ -799,6 +813,9 @@ export declare class DaemonClient {
         timeout?: number;
     }): Promise<ProviderSubagentListPayload>;
     fetchProviderSubagentTimeline(parentAgentId: string, subagentId: string, options?: FetchProviderSubagentTimelineOptions): Promise<ProviderSubagentTimelinePayload>;
+    observeTimeline(agentIds: string[], options?: {
+        signal?: AbortSignal;
+    }): OwnedSubscription<CorrelatedResponsePayload<"agent.timeline.set_subscription.response">>;
     askSideConversation(parentAgentId: string, threadId: string, question: string, options?: {
         requestId?: string;
         timeout?: number;
@@ -811,13 +828,7 @@ export declare class DaemonClient {
         requestId?: string;
         timeout?: number;
     }): Promise<SideConversationListPayload>;
-    setAgentTimelineSubscription(agentIds: string[]): Promise<void>;
-    subscribeAgentTimeline(agentId: string, handler: (message: Extract<SessionOutboundMessage, {
-        type: "agent_stream" | "agent.timeline.replacement";
-    }>) => void): TimelineSubscription;
-    private updateEventSubscriptions;
-    private sendEventSubscription;
-    private sendTimelineSubscription;
+    subscribeAgentTimeline(agentId: string, handler: (message: TimelineMessage) => void): TimelineSubscription;
     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>;
@@ -835,7 +846,9 @@ export declare class DaemonClient {
      * Gated on `server_info.features.agentConfigApply`.
      */
     applyAgentConfig(agentId: string, config: AgentConfigApply): Promise<AgentProviderNotice | null>;
-    restartServer(reason?: string, requestId?: string): Promise<RestartRequestedStatusPayload>;
+    restartServer(reason?: string, requestId?: string, options?: {
+        timeout?: number;
+    }): Promise<RestartRequestedStatusPayload>;
     shutdownServer(options?: ShutdownServerOptions): Promise<ShutdownRequestedStatusPayload>;
     updateDaemon(requestId?: string): Promise<DaemonUpdateResponse["payload"]>;
     setVoiceMode(enabled: boolean, agentId?: string): Promise<SetVoiceModePayload>;
@@ -858,15 +871,14 @@ export declare class DaemonClient {
         baseRef?: string;
         ignoreWhitespace?: boolean;
     }, requestId?: string): Promise<CheckoutDiffPayload>;
-    subscribeCheckoutDiff(cwd: string, compare: {
+    observeCheckoutDiff(cwd: string, compare: {
         mode: "uncommitted" | "base";
         baseRef?: string;
         ignoreWhitespace?: boolean;
     }, options?: {
-        subscriptionId?: string;
         requestId?: string;
-    }): Promise<SubscribeCheckoutDiffPayload>;
-    unsubscribeCheckoutDiff(subscriptionId: string): void;
+        signal?: AbortSignal;
+    }): OwnedSubscription<SubscribeCheckoutDiffPayload>;
     checkoutCommit(cwd: string, input: {
         message?: string;
         addAll?: boolean;
@@ -953,8 +965,11 @@ export declare class DaemonClient {
         scope?: "workspace" | "worktree";
     }, requestId?: string): Promise<PaseoWorktreeArchivePayload>;
     createPaseoWorktree(input: CreatePaseoWorktreeInput, requestId?: string): Promise<CreatePaseoWorktreePayload>;
-    createWorkspace(input: CreateWorkspaceRequestOptions, requestId?: string): Promise<WorkspaceCreatePayload>;
-    private createLegacyWorkspace;
+    createWorkspace(input: {
+        source: WorkspaceCreateRequest["source"];
+        title?: string;
+        firstAgentContext?: WorkspaceCreateRequest["firstAgentContext"];
+    }, requestId?: string): Promise<WorkspaceCreatePayload>;
     validateBranch(options: {
         cwd: string;
         branchName: string;
@@ -987,12 +1002,19 @@ export declare class DaemonClient {
     private requestFileExplorer;
     listDirectory(cwd: string, path: string, requestId?: string): Promise<FileExplorerDirectoryPayload>;
     readFile(cwd: string, path: string, requestId?: string, maxBytes?: number): Promise<FileReadResult>;
+    observeFile(input: {
+        cwd: string;
+        path: string;
+        signal?: AbortSignal;
+    }): OwnedSubscription<CorrelatedResponsePayload<"fs.file.subscribe.response">>;
     subscribeFile(input: {
         cwd: string;
         path: string;
+        signal?: AbortSignal;
     }, onUpdate: (version: FileVersion) => void): Promise<{
         initial: FileVersion;
-        unsubscribe: () => void;
+        subscription: OwnedSubscription<CorrelatedResponsePayload<"fs.file.subscribe.response">>;
+        unsubscribe: () => Promise<void>;
     }>;
     writeFile(input: {
         cwd: string;
@@ -1056,7 +1078,7 @@ export declare class DaemonClient {
     connectHub(hubUrl: string, token: string, permissions?: readonly string[], requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "not_connected" | "connecting" | "connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
@@ -1070,7 +1092,7 @@ export declare class DaemonClient {
     }, requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "not_connected" | "connecting" | "connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
@@ -1081,7 +1103,7 @@ export declare class DaemonClient {
     getHubStatus(requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "not_connected" | "connecting" | "connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
@@ -1092,7 +1114,7 @@ export declare class DaemonClient {
     disconnectHub(force?: boolean, requestId?: string): Promise<{
         requestId: string;
         status: {
-            state: "connecting" | "connected" | "not_connected" | "reconnecting" | "disconnecting" | "revoked";
+            state: "not_connected" | "connecting" | "connected" | "reconnecting" | "disconnecting" | "revoked";
             daemonId: string | null;
             hubOrigin: string | null;
             permissions: ("daemon.read" | "daemon.manage" | "tunnel.manage" | "access.manage" | "workspace.read" | "workspace.write" | "workspace.manage" | "automation.manage" | "hub.execute")[];
@@ -1162,14 +1184,11 @@ export declare class DaemonClient {
     respondToPermissionAndWait(agentId: string, requestId: string, response: AgentPermissionResponse, timeout?: number): Promise<AgentPermissionResolvedPayload>;
     waitForAgentUpsert(agentId: string, predicate: (snapshot: AgentSnapshotPayload) => boolean, timeout?: number): Promise<AgentSnapshotPayload>;
     waitForFinish(agentId: string, timeout?: number): Promise<WaitForFinishResult>;
-    subscribeTerminals(input: {
-        cwd: string;
-        workspaceId?: string;
-    }): void;
-    unsubscribeTerminals(input: {
+    observeTerminals(input: {
         cwd: string;
         workspaceId?: string;
-    }): void;
+        signal?: AbortSignal;
+    }): OwnedSubscription<CorrelatedResponsePayload<"terminals_changed">>;
     listTerminals(cwd?: string, requestId?: string, options?: {
         workspaceId?: string;
     }): Promise<ListTerminalsPayload>;
@@ -1184,11 +1203,23 @@ export declare class DaemonClient {
         };
     }): Promise<CreateTerminalPayload>;
     renameTerminal(input: RenameTerminalInput): Promise<RenameTerminalResult>;
-    subscribeTerminal(terminalId: string, optionsOrRequestId?: {
+    /**
+     * Snapshot/restore and output arrive in receive. Subscribe to the returned handle
+     * for terminal_stream_exit: payload.error means observation failure, not PTY exit.
+     * Either outcome detaches this slot and releases the handle automatically.
+     */
+    observeTerminal(terminalId: string, receive: (event: TerminalStreamEvent) => void, options?: {
         restore?: SubscribeTerminalRequest["restore"];
+        signal?: AbortSignal;
         requestId?: string;
-    } | string): Promise<SubscribeTerminalPayload>;
-    unsubscribeTerminal(terminalId: string): void;
+    }): OwnedSubscription<SubscribeTerminalPayload>;
+    subscribeTerminal(terminalId: string, options?: {
+        restore?: SubscribeTerminalRequest["restore"];
+        signal?: AbortSignal;
+        requestId?: string;
+    }): Promise<SubscribeTerminalPayload & {
+        subscription: OwnedSubscription<SubscribeTerminalPayload>;
+    }>;
     sendTerminalInput(terminalId: string, message: TerminalInput["message"]): void;
     killTerminal(terminalId: string, requestId?: string): Promise<KillTerminalPayload>;
     closeItems(input: {