@hyperdrive.bot/paseo-client 0.3.53 → 0.3.55

package/dist/daemon-client.d.ts

@@ -1,7 +1,7 @@
 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, BackgroundTaskPayload, WatchNotificationActionMessage, WatchSessionSearchMessage, WatchComposerDictateMessage, WorkflowAgentPreset, 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, ReferenceEnrichment, SessionDigest, SessionDigestLink, WatchNotificationActionMessage, WatchSessionSearchMessage, WatchComposerDictateMessage, WorkflowAgentPreset, WorkflowSnapshot, WorkflowStatus, WorkflowTaskGraph, WorkspaceCreateRequest, PendingDecision } 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, ProvidersReloadConfigPayload } from "@hyperdrive.bot/paseo-protocol/messages";
 import type { FileUploadErrorCode } from "@hyperdrive.bot/paseo-protocol/messages";
@@ -837,6 +837,42 @@ export declare class DaemonClient {
      * so the client can show what is running and for how long.
      */
     listBackgroundTasks(agentId?: string): Promise<BackgroundTaskPayload[]>;
+    /**
+     * Record session context (links + non-live credentials) onto an agent's
+     * digest. Used by the context hook, which runs beside an agent rather than
+     * inside it and so cannot reach the agent-scoped `set_session_digest` MCP
+     * tool.
+     *
+     * Returns how many secrets the daemon had to mask, so a caller can report
+     * that it handed over something it should not have.
+     */
+    setAgentContext(input: {
+        agentId: string;
+        links?: {
+            kind: SessionDigestLink["kind"];
+            url: string;
+            label?: string;
+        }[];
+        secrets?: {
+            label: string;
+            value: string;
+            source?: string;
+        }[];
+    }): Promise<{
+        digest: SessionDigest | null;
+        maskedCount: number;
+        error?: string;
+    }>;
+    /**
+     * Ask the daemon what it can see about external reference URLs -- a GitLab
+     * pipeline's status, a merge request's state, a Jira issue's column.
+     *
+     * The provider credentials live on the daemon, so the app never holds one.
+     * An entry the daemon could not look up still comes back, carrying
+     * `unavailableReason`, so a card can say what it could not see instead of
+     * spinning. See docs/session-context-rail.md.
+     */
+    enrichReferences(urls: string[]): Promise<ReferenceEnrichment[]>;
     /**
      * 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
@@ -945,6 +981,13 @@ export declare class DaemonClient {
     setWorkspaceTitle(workspaceId: string, title: string | null, requestId?: string): Promise<{
         title: string | null;
     }>;
+    /**
+     * Answer a decision the agent parked on its digest. `optionId: null` with a
+     * note is a free-text answer — an option the agent did not list.
+     */
+    answerAgentDecision(agentId: string, decisionId: string, optionId: string | null, note: string | null, requestId?: string): Promise<{
+        decision: PendingDecision | null;
+    }>;
     resumeAgent(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>): Promise<AgentSnapshotPayload>;
     importAgent(input: ImportAgentInput): Promise<AgentSnapshotPayload>;
     refreshAgent(agentId: string, requestId?: string): Promise<AgentRefreshedStatusPayload>;

package/dist/daemon-client.js

@@ -1340,6 +1340,60 @@ export class DaemonClient {
         });
         return result.tasks;
     }
+    /**
+     * Record session context (links + non-live credentials) onto an agent's
+     * digest. Used by the context hook, which runs beside an agent rather than
+     * inside it and so cannot reach the agent-scoped `set_session_digest` MCP
+     * tool.
+     *
+     * Returns how many secrets the daemon had to mask, so a caller can report
+     * that it handed over something it should not have.
+     */
+    async setAgentContext(input) {
+        const requestId = this.createRequestId();
+        const message = SessionInboundMessageSchema.parse({
+            type: "set_agent_context_request",
+            agentId: input.agentId,
+            ...(input.links === undefined ? {} : { links: input.links }),
+            ...(input.secrets === undefined ? {} : { secrets: input.secrets }),
+            requestId,
+        });
+        const result = await this.sendCorrelatedRequest({
+            requestId,
+            message,
+            responseType: "set_agent_context_response",
+            options: { skipQueue: true },
+        });
+        return {
+            digest: result.digest,
+            maskedCount: result.maskedCount,
+            ...(result.error === undefined ? {} : { error: result.error }),
+        };
+    }
+    /**
+     * Ask the daemon what it can see about external reference URLs -- a GitLab
+     * pipeline's status, a merge request's state, a Jira issue's column.
+     *
+     * The provider credentials live on the daemon, so the app never holds one.
+     * An entry the daemon could not look up still comes back, carrying
+     * `unavailableReason`, so a card can say what it could not see instead of
+     * spinning. See docs/session-context-rail.md.
+     */
+    async enrichReferences(urls) {
+        const requestId = this.createRequestId();
+        const message = SessionInboundMessageSchema.parse({
+            type: "enrich_references_request",
+            urls,
+            requestId,
+        });
+        const result = await this.sendCorrelatedRequest({
+            requestId,
+            message,
+            responseType: "enrich_references_response",
+            options: { skipQueue: true },
+        });
+        return result.enrichments;
+    }
     /**
      * 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
@@ -1984,6 +2038,27 @@ export class DaemonClient {
         }
         return { title: payload.title };
     }
+    /**
+     * Answer a decision the agent parked on its digest. `optionId: null` with a
+     * note is a free-text answer — an option the agent did not list.
+     */
+    async answerAgentDecision(agentId, decisionId, optionId, note, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "agent.decision.answer.request",
+                agentId,
+                decisionId,
+                optionId,
+                note,
+            },
+            responseType: "agent.decision.answer.response",
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "answerAgentDecision rejected");
+        }
+        return { decision: payload.decision };
+    }
     async resumeAgent(handle, overrides) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({

package/package.json

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