@hyperdrive.bot/paseo-client 0.3.34 → 0.3.36

package/dist/daemon-client.d.ts

@@ -1,9 +1,9 @@
 import type { z } from "zod";
 import { type ClientCapability } from "@hyperdrive.bot/paseo-protocol/client-capabilities";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ServerInfoStatusPayload } from "@hyperdrive.bot/paseo-protocol/messages";
-import type { AgentStreamEventPayload, InstalledExtension, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, 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, OpenProjectResponseMessage, 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, ProjectRenameResponse, WatchNotificationActionMessage, WatchSessionSearchMessage, WatchComposerDictateMessage, WorkflowSnapshot, WorkflowStatus, WorkflowTaskGraph, WorkspaceCreateRequest } from "@hyperdrive.bot/paseo-protocol/messages";
+import type { AgentStreamEventPayload, InstalledExtension, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, 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, OpenProjectResponseMessage, 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, ProjectRenameResponse, BackgroundTaskPayload, WatchNotificationActionMessage, WatchSessionSearchMessage, WatchComposerDictateMessage, WorkflowSnapshot, WorkflowStatus, WorkflowTaskGraph, WorkspaceCreateRequest } from "@hyperdrive.bot/paseo-protocol/messages";
 import type { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentProviderNotice, AgentProvider, AgentSessionConfig } from "@hyperdrive.bot/paseo-protocol/agent-types";
-import type { MutableDaemonConfig, MutableDaemonConfigPatch } from "@hyperdrive.bot/paseo-protocol/messages";
+import type { MutableDaemonConfig, MutableDaemonConfigPatch, ProvidersReloadConfigPayload } from "@hyperdrive.bot/paseo-protocol/messages";
 import type { FileUploadErrorCode } from "@hyperdrive.bot/paseo-protocol/messages";
 import { type DaemonTransportFactory, type WebSocketFactory } from "./daemon-client-transport.js";
 import { type TerminalStreamEvent } from "./terminal-stream-router.js";
@@ -283,6 +283,97 @@ type LoopLogsPayload = Extract<SessionOutboundMessage, {
 type LoopStopPayload = Extract<SessionOutboundMessage, {
     type: "loop/stop/response";
 }>["payload"];
+type FleetListPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/list/response";
+}>["payload"];
+type FleetInspectPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/inspect/response";
+}>["payload"];
+type FleetRunNowPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/run-now/response";
+}>["payload"];
+type FleetPausePayload = Extract<SessionOutboundMessage, {
+    type: "fleet/pause/response";
+}>["payload"];
+type FleetResumePayload = Extract<SessionOutboundMessage, {
+    type: "fleet/resume/response";
+}>["payload"];
+type FleetAskPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/ask/response";
+}>["payload"];
+type FleetDecisionsPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/decisions/response";
+}>["payload"];
+type FleetResolveDecisionPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/resolve-decision/response";
+}>["payload"];
+type FleetSetParamsPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/set-params/response";
+}>["payload"];
+type FleetSetModePayload = Extract<SessionOutboundMessage, {
+    type: "fleet/set-mode/response";
+}>["payload"];
+type FleetCreatePayload = Extract<SessionOutboundMessage, {
+    type: "fleet/create/response";
+}>["payload"];
+type FleetExecutionsPayload = Extract<SessionOutboundMessage, {
+    type: "fleet/executions/response";
+}>["payload"];
+export interface InspectFleetLoopOptions {
+    requestId?: string;
+    name: string;
+}
+export interface SetFleetLoopModeOptions {
+    requestId?: string;
+    name: string;
+    mode: "live" | "dry-run";
+}
+export interface AskFleetDecisionOptions {
+    requestId?: string;
+    name: string;
+    kind: "gate-approval" | "action-approval" | "outcome-review";
+    question: string;
+    posture: "blocking" | "deferring" | "advisory";
+    options: Array<{
+        id: string;
+        label: string;
+        effect: {
+            kind: "act" | "rehearse" | "defer" | "suppress";
+            reversibility: "reversible" | "compensable" | "irreversible";
+            compensatingAction?: string;
+        };
+    }>;
+    runId?: string;
+    itemKey?: string;
+    evidence?: string;
+    onExpiry?: string;
+    expiresInMs?: number;
+}
+export interface ListFleetDecisionsOptions {
+    requestId?: string;
+    name?: string;
+    includeResolved?: boolean;
+}
+export interface ResolveFleetDecisionOptions {
+    requestId?: string;
+    decisionId: string;
+    optionId: string;
+}
+export interface SetFleetLoopParamsOptions {
+    requestId?: string;
+    name: string;
+    values: Record<string, string | number | boolean | string[]>;
+}
+export interface CreateFleetLoopOptions {
+    requestId?: string;
+    name: string;
+    description: string;
+    cron: string;
+    action: string;
+    mode?: "live" | "dry-run";
+    rails?: string;
+    allowed?: string;
+}
 type ScheduleCreatePayload = Extract<SessionOutboundMessage, {
     type: "schedule/create/response";
 }>["payload"];
@@ -739,6 +830,25 @@ export declare class DaemonClient {
      * CLI's own `ctrl+x ctrl+k` kill chord over the PTY (kills it inside Claude
      * Code). Resolves to whether the dismiss was delivered.
      */
+    /**
+     * List background shells -- one agent's, or every agent's when `agentId` is
+     * omitted. These are commands the provider launched with `run_in_background`
+     * so they outlive the turn; the rows carry the command, status and start time
+     * so the client can show what is running and for how long.
+     */
+    listBackgroundTasks(agentId?: string): Promise<BackgroundTaskPayload[]>;
+    /**
+     * Read a background shell's captured output. Resolves with `text: null` when
+     * the daemon does not know the shell or it captured nothing. The daemon tails
+     * and redacts before sending.
+     */
+    readBackgroundTaskOutput(agentId: string, taskId: string, options?: {
+        maxBytes?: number;
+    }): Promise<{
+        text: string | null;
+        truncated: boolean;
+        byteSize: number;
+    }>;
     dismissBackgroundTask(agentId: string, taskId: string): Promise<{
         dismissed: boolean;
     }>;
@@ -1004,6 +1114,13 @@ export declare class DaemonClient {
         cwd?: string;
         requestId?: string;
     }): Promise<GetProvidersSnapshotPayload>;
+    /**
+     * Re-read `agents.providers` from the daemon's config.json into its live
+     * provider registry. No restart. Returns the add/update/remove diff.
+     */
+    reloadProviderConfig(options?: {
+        requestId?: string;
+    }): Promise<ProvidersReloadConfigPayload>;
     getDaemonConfig(requestId?: string): Promise<{
         requestId: string;
         config: MutableDaemonConfig;
@@ -1079,6 +1196,23 @@ export declare class DaemonClient {
     waitForChatMessages(options: WaitForChatMessagesOptions): Promise<ChatWaitPayload>;
     scheduleCreate(options: CreateScheduleOptions): Promise<ScheduleCreatePayload>;
     scheduleList(requestId?: string): Promise<ScheduleListPayload>;
+    fleetList(requestId?: string): Promise<FleetListPayload>;
+    fleetInspect(options: InspectFleetLoopOptions): Promise<FleetInspectPayload>;
+    fleetRunNow(options: InspectFleetLoopOptions): Promise<FleetRunNowPayload>;
+    fleetPause(options: InspectFleetLoopOptions): Promise<FleetPausePayload>;
+    /** Raise a typed question from a loop. */
+    fleetAsk(options: AskFleetDecisionOptions): Promise<FleetAskPayload>;
+    /** Decisions loops are waiting on a person for, most urgent first. */
+    fleetDecisions(options?: ListFleetDecisionsOptions): Promise<FleetDecisionsPayload>;
+    /** Answer one decision as the human. */
+    fleetResolveDecision(options: ResolveFleetDecisionOptions): Promise<FleetResolveDecisionPayload>;
+    /** Persist a loop's declared parameters. */
+    fleetSetParams(options: SetFleetLoopParamsOptions): Promise<FleetSetParamsPayload>;
+    /** Promote a loop to live, or demote it to dry-run. */
+    fleetSetMode(options: SetFleetLoopModeOptions): Promise<FleetSetModePayload>;
+    fleetResume(options: InspectFleetLoopOptions): Promise<FleetResumePayload>;
+    fleetCreate(options: CreateFleetLoopOptions): Promise<FleetCreatePayload>;
+    fleetExecutions(options: InspectFleetLoopOptions): Promise<FleetExecutionsPayload>;
     scheduleInspect(options: InspectScheduleOptions): Promise<ScheduleInspectPayload>;
     scheduleLogs(options: InspectScheduleOptions): Promise<ScheduleLogsPayload>;
     schedulePause(options: InspectScheduleOptions): Promise<SchedulePausePayload>;

package/dist/daemon-client.js

@@ -1319,6 +1319,49 @@ export class DaemonClient {
      * CLI's own `ctrl+x ctrl+k` kill chord over the PTY (kills it inside Claude
      * Code). Resolves to whether the dismiss was delivered.
      */
+    /**
+     * List background shells -- one agent's, or every agent's when `agentId` is
+     * omitted. These are commands the provider launched with `run_in_background`
+     * so they outlive the turn; the rows carry the command, status and start time
+     * so the client can show what is running and for how long.
+     */
+    async listBackgroundTasks(agentId) {
+        const requestId = this.createRequestId();
+        const message = SessionInboundMessageSchema.parse({
+            type: "list_background_tasks_request",
+            ...(agentId === undefined ? {} : { agentId }),
+            requestId,
+        });
+        const result = await this.sendCorrelatedRequest({
+            requestId,
+            message,
+            responseType: "list_background_tasks_response",
+            options: { skipQueue: true },
+        });
+        return result.tasks;
+    }
+    /**
+     * Read a background shell's captured output. Resolves with `text: null` when
+     * the daemon does not know the shell or it captured nothing. The daemon tails
+     * and redacts before sending.
+     */
+    async readBackgroundTaskOutput(agentId, taskId, options) {
+        const requestId = this.createRequestId();
+        const message = SessionInboundMessageSchema.parse({
+            type: "background_task_output_request",
+            agentId,
+            taskId,
+            ...(options?.maxBytes === undefined ? {} : { maxBytes: options.maxBytes }),
+            requestId,
+        });
+        const result = await this.sendCorrelatedRequest({
+            requestId,
+            message,
+            responseType: "background_task_output_response",
+            options: { skipQueue: true },
+        });
+        return { text: result.text, truncated: result.truncated, byteSize: result.byteSize };
+    }
     async dismissBackgroundTask(agentId, taskId) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
@@ -3141,6 +3184,20 @@ export class DaemonClient {
         });
         return normalizeProvidersSnapshotPayload(payload);
     }
+    /**
+     * Re-read `agents.providers` from the daemon's config.json into its live
+     * provider registry. No restart. Returns the add/update/remove diff.
+     */
+    async reloadProviderConfig(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options?.requestId,
+            message: {
+                type: "providers.reload_config.request",
+            },
+            responseType: "providers.reload_config.response",
+            timeout: 15000,
+        });
+    }
     async getDaemonConfig(requestId) {
         return this.sendCorrelatedSessionRequest({
             requestId,
@@ -3673,6 +3730,134 @@ export class DaemonClient {
             responseType: "schedule/list/response",
         });
     }
+    async fleetList(requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "fleet/list",
+            },
+            responseType: "fleet/list/response",
+        });
+    }
+    async fleetInspect(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/inspect",
+                name: options.name,
+            },
+            responseType: "fleet/inspect/response",
+        });
+    }
+    async fleetRunNow(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/run-now",
+                name: options.name,
+            },
+            responseType: "fleet/run-now/response",
+        });
+    }
+    async fleetPause(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/pause",
+                name: options.name,
+            },
+            responseType: "fleet/pause/response",
+        });
+    }
+    /** Raise a typed question from a loop. */
+    async fleetAsk(options) {
+        const { requestId, ...rest } = options;
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: { type: "fleet/ask", ...rest },
+            responseType: "fleet/ask/response",
+        });
+    }
+    /** Decisions loops are waiting on a person for, most urgent first. */
+    async fleetDecisions(options = {}) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/decisions",
+                name: options.name,
+                includeResolved: options.includeResolved,
+            },
+            responseType: "fleet/decisions/response",
+        });
+    }
+    /** Answer one decision as the human. */
+    async fleetResolveDecision(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/resolve-decision",
+                decisionId: options.decisionId,
+                optionId: options.optionId,
+            },
+            responseType: "fleet/resolve-decision/response",
+        });
+    }
+    /** Persist a loop's declared parameters. */
+    async fleetSetParams(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: { type: "fleet/set-params", name: options.name, values: options.values },
+            responseType: "fleet/set-params/response",
+        });
+    }
+    /** Promote a loop to live, or demote it to dry-run. */
+    async fleetSetMode(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/set-mode",
+                name: options.name,
+                mode: options.mode,
+            },
+            responseType: "fleet/set-mode/response",
+        });
+    }
+    async fleetResume(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/resume",
+                name: options.name,
+            },
+            responseType: "fleet/resume/response",
+        });
+    }
+    async fleetCreate(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/create",
+                name: options.name,
+                description: options.description,
+                cron: options.cron,
+                action: options.action,
+                ...(options.mode !== undefined ? { mode: options.mode } : {}),
+                ...(options.rails !== undefined ? { rails: options.rails } : {}),
+                ...(options.allowed !== undefined ? { allowed: options.allowed } : {}),
+            },
+            responseType: "fleet/create/response",
+        });
+    }
+    async fleetExecutions(options) {
+        return this.sendCorrelatedSessionRequest({
+            requestId: options.requestId,
+            message: {
+                type: "fleet/executions",
+                name: options.name,
+            },
+            responseType: "fleet/executions/response",
+        });
+    }
     async scheduleInspect(options) {
         return this.sendCorrelatedSessionRequest({
             requestId: options.requestId,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSnapshotPayload, CreateAgentRequestMessage, FetchWorkspacesRequestMessage, FetchWorkspacesResponseMessage, GetProvidersSnapshotResponseMessage, ListAvailableProvidersResponse, ListProviderFeaturesRequestMessage, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, MutableDaemonConfig, MutableDaemonConfigPatch, ProviderDiagnosticResponseMessage, ProjectPlacementPayload, RefreshProvidersSnapshotResponseMessage, SendAgentMessageRequest, SessionOutboundMessage, WorkspaceDescriptorPayload } from "@hyperdrive.bot/paseo-protocol/messages";
+import type { AgentSnapshotPayload, CreateAgentRequestMessage, FetchWorkspacesRequestMessage, FetchWorkspacesResponseMessage, GetProvidersSnapshotResponseMessage, ListAvailableProvidersResponse, ListProviderFeaturesRequestMessage, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, MutableDaemonConfig, MutableDaemonConfigPatch, ProviderDiagnosticResponseMessage, ProjectPlacementPayload, RefreshProvidersSnapshotResponseMessage, SendAgentMessageRequest, ProvidersReloadConfigPayload, SessionOutboundMessage, WorkspaceDescriptorPayload } from "@hyperdrive.bot/paseo-protocol/messages";
 import { DaemonClient } from "./daemon-client.js";
 import type { FetchAgentTimelineCursor, FetchAgentTimelineDirection, FetchAgentTimelinePayload, FetchAgentTimelineProjection } from "./daemon-client.js";
 export { DaemonClient };
@@ -241,6 +241,15 @@ export interface PaseoProviderActions {
     }): Promise<PaseoProviderAvailabilityResult>;
     snapshot(options?: PaseoProviderListOptions): Promise<PaseoProviderSnapshotResult>;
     refresh(options?: PaseoProviderRefreshOptions): Promise<PaseoProviderRefreshResult>;
+    /**
+     * Re-read `agents.providers` from the daemon's config.json into its live
+     * registry — add, update, AND remove — without restarting the daemon.
+     * Distinct from {@link refresh}, which only re-probes availability of the
+     * providers the daemon already knows about.
+     */
+    reloadConfig(options?: {
+        requestId?: string;
+    }): Promise<ProvidersReloadConfigPayload>;
     diagnostic(provider: PaseoAgentProvider, options?: {
         requestId?: string;
     }): Promise<PaseoProviderDiagnosticResult>;

package/dist/index.js

@@ -42,6 +42,10 @@ export function createPaseoClient(config) {
             listAvailable: (options) => daemonClient.listAvailableProviders(options),
             snapshot: (options) => daemonClient.getProvidersSnapshot(options),
             refresh: (options) => daemonClient.refreshProvidersSnapshot(options),
+            // Re-read agents.providers from the daemon's config.json (add/update/remove).
+            // Distinct from `refresh`, which only re-probes availability of the
+            // providers the daemon already knows about.
+            reloadConfig: (options) => daemonClient.reloadProviderConfig(options),
             diagnostic: (provider, options) => daemonClient.getProviderDiagnostic(provider, options),
             subscribe: (handler) => daemonClient.on("providers_snapshot_update", (message) => {
                 handler(message.payload);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperdrive.bot/paseo-client",
-  "version": "0.3.34",
+  "version": "0.3.36",
   "description": "Paseo client SDK package",
   "files": [
     "dist",
@@ -35,8 +35,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@hyperdrive.bot/paseo-protocol": "0.3.34",
-    "@hyperdrive.bot/paseo-relay": "0.3.34",
+    "@hyperdrive.bot/paseo-protocol": "0.3.36",
+    "@hyperdrive.bot/paseo-relay": "0.3.36",
     "zod": "^4.4.3"
   },
   "devDependencies": {