@camerontaylor/paseo-client 0.11.1-fork.1 → 0.11.2-fork.1

package/dist/connection/index.d.ts

@@ -39,7 +39,10 @@ export declare const DEFAULT_CLIENT_CAPABILITIES: {
     timeline_notifications: true;
     plugin_timeline_items: true;
     workspace_setup_blocked: true;
+    durable_agent_queue: true;
+    durable_voice_input_v1: true;
     explicit_event_subscriptions: true;
+    companion_stream_port_v1: true;
 };
 /** Calling releases demand; ready waits for membership, or local attachment on broadcast hosts. */
 export type TimelineSubscription = (() => void) & {

package/dist/connection/index.js

@@ -112,6 +112,10 @@ export const DEFAULT_CLIENT_CAPABILITIES = {
     [CLIENT_CAPS.timelineNotifications]: true,
     [CLIENT_CAPS.pluginTimelineItems]: true,
     [CLIENT_CAPS.workspaceSetupBlocked]: true,
+    [CLIENT_CAPS.durableAgentQueue]: true,
+    [CLIENT_CAPS.durableVoiceInputV1]: true,
     [CLIENT_CAPS.explicitEventSubscriptions]: true,
+    // COMPAT(companionStreamPortV1): added in v0.11.0-beta.3-fork, remove after 2027-04-01.
+    [CLIENT_CAPS.companionStreamPortV1]: true,
 };
 //# sourceMappingURL=index.js.map

package/dist/daemon-client.d.ts

@@ -1,11 +1,11 @@
 import { type TimelineMessage } from "./timeline-subscription/index.js";
 import { type OwnedSubscription, type TimelineSubscription } from "./connection/index.js";
-import type { CreationSnapshot } from "@camerontaylor/paseo-protocol/messages";
+import type { AgentQueueSnapshot, CreationSnapshot } from "@camerontaylor/paseo-protocol/messages";
 import type { z } from "zod";
 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, CheckoutBaseRefSetResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ActiveTurnBehavior, type ServerInfoStatusPayload } from "@camerontaylor/paseo-protocol/messages";
+import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, CheckoutBaseRefSetResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, DaemonUpdateResponseSchema, type ActiveTurnBehavior, type AgentAttachmentWire, type QueuedAgentDeliveryIntent, type QueuedComposerAttachment, 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, UsageReportEntry, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, DaemonConfigReloadResponse, DiagnosticsResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest, WorkspaceRecoveryState, PluginListItem, PluginLogEntry, PluginSourceStatusItem, PluginSourceUpdateItem, PluginUpdateSelection, PluginUpdateProposal, PluginUpdatePreview, PluginUpdateResult, AgentSkillSelection, AgentSkillsStatus, AgentSkillsSaveResult } from "@camerontaylor/paseo-protocol/messages";
 import type { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, AgentProviderNotice, AgentProvider, AgentSessionConfig } from "@camerontaylor/paseo-protocol/agent-types";
 import type { AgentConfigApply, MutableDaemonConfig, MutableDaemonConfigPatch } from "@camerontaylor/paseo-protocol/messages";
@@ -592,6 +592,11 @@ export declare class DaemonConnectionError extends Error {
     constructor(message: string, code?: "DAEMON_CONNECTION_LOST" | "DAEMON_REQUEST_TIMEOUT");
 }
 export declare function supportsUsageReports(features: ServerInfoStatusPayload["features"]): boolean;
+/** Identifies the voice attachment a voice message belongs to. */
+export interface VoiceTransport {
+    attachmentId: string;
+    generation: string;
+}
 export declare class DaemonClient {
     private config;
     private readonly providerSnapshotUpdates;
@@ -833,6 +838,26 @@ export declare class DaemonClient {
         name?: string;
         labels?: Record<string, string>;
     }): Promise<void>;
+    updateCompanionEntry(input: {
+        agentId: string;
+        entryId?: string;
+        action: "update_status" | "add_pin" | "remove_pin" | "add_q_and_a";
+        status?: "open" | "reviewed" | "done";
+        text?: string;
+        answerText?: string;
+        sourceId?: string;
+    }): Promise<void>;
+    /**
+     * Backfills an agent's artifact feed from files already on disk. Needed for
+     * agents whose work predates the artifact feed, whose feeds are otherwise
+     * permanently empty.
+     */
+    scanAgentArtifacts(agentId: string, options?: {
+        limit?: number;
+    }): Promise<{
+        addedOrUpdated: number;
+        total: number;
+    }>;
     renameProject(projectId: string, customName: string | null, requestId?: string): Promise<{
         customName: string | null;
     }>;
@@ -885,6 +910,53 @@ export declare class DaemonClient {
     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>;
+    /**
+     * Admits a prompt into the durable queue with an explicit delivery intent.
+     * `itemId` comes from the caller so an optimistic local row and the stored
+     * item share an id, which makes a reconnect retry of the same enqueue a
+     * daemon-side no-op instead of a duplicate.
+     */
+    enqueueAgentMessage(input: {
+        agentId: string;
+        itemId: string;
+        text: string;
+        intent: QueuedAgentDeliveryIntent;
+        images?: Array<{
+            data: string;
+            mimeType: string;
+        }>;
+        attachments?: AgentAttachmentWire[];
+        composerAttachments?: QueuedComposerAttachment[];
+    }): Promise<AgentQueueSnapshot>;
+    updateQueuedAgentMessage(input: {
+        agentId: string;
+        itemId: string;
+        text: string;
+        expectedRevision: number;
+        images?: Array<{
+            data: string;
+            mimeType: string;
+        }>;
+        attachments?: AgentAttachmentWire[];
+        composerAttachments?: QueuedComposerAttachment[];
+    }): Promise<AgentQueueSnapshot>;
+    reorderQueuedAgentMessages(agentId: string, itemIds: string[], expectedRevision: number): Promise<AgentQueueSnapshot>;
+    deleteQueuedAgentMessage(agentId: string, itemId: string, expectedRevision: number): Promise<AgentQueueSnapshot>;
+    retryQueuedAgentMessage(agentId: string, itemId: string, expectedRevision: number): Promise<AgentQueueSnapshot>;
+    sendQueuedAgentMessageNow(agentId: string, itemId: string, expectedRevision: number): Promise<AgentQueueSnapshot>;
+    listQueuedAgentMessages(agentId: string): Promise<AgentQueueSnapshot>;
+    /**
+     * Fetches the image bytes of one queued item. A device that did not queue the
+     * item has no local copy, so pulling it back into the composer would
+     * otherwise drop the images.
+     */
+    getQueuedAgentMessageImages(agentId: string, itemId: string): Promise<Array<{
+        id: string;
+        mimeType: string;
+        fileName?: string | null;
+        data: string;
+    }>>;
+    private requireAgentQueuePayload;
     rewindAgent(agentId: string, messageId: string, mode: "conversation" | "files" | "both"): Promise<AgentRewindResponseMessage["payload"]>;
     cancelAgent(agentId: string): Promise<void>;
     setAgentMode(agentId: string, modeId: string): Promise<AgentProviderNotice | null>;
@@ -904,8 +976,23 @@ export declare class DaemonClient {
     }): Promise<RestartRequestedStatusPayload>;
     shutdownServer(options?: ShutdownServerOptions): Promise<ShutdownRequestedStatusPayload>;
     updateDaemon(requestId?: string): Promise<DaemonUpdateResponse["payload"]>;
-    setVoiceMode(enabled: boolean, agentId?: string): Promise<SetVoiceModePayload>;
-    sendVoiceAudioChunk(audio: string, format: string, isLast?: boolean): Promise<void>;
+    setVoiceMode(enabled: boolean, agentId?: string, input?: {
+        /** Voice attachment identity; the host binds its transport generation to it. */
+        attachmentId?: string;
+        /** Supplied when an existing attachment reclaims itself after a reconnect. */
+        generation?: string;
+    }): Promise<SetVoiceModePayload>;
+    /** Reads this attachment's delivery receipts so the panel can show truthful state. */
+    readVoiceInputReceipts(input: {
+        agentId: string;
+        attachmentId: string;
+        generation: string;
+        after?: string;
+        limit?: number;
+    }): Promise<Extract<SessionOutboundMessage, {
+        type: "voice.input.receipts.read.response";
+    }>["payload"]>;
+    sendVoiceAudioChunk(audio: string, format: string, isLast?: boolean, transport?: VoiceTransport): Promise<void>;
     startDictationStream(dictationId: string, format: string): Promise<void>;
     sendDictationStreamChunk(dictationId: string, seq: number, audio: string, format: string): void;
     finishDictationStream(dictationId: string, finalSeq: number): Promise<{
@@ -913,8 +1000,8 @@ export declare class DaemonClient {
         text: string;
     }>;
     cancelDictationStream(dictationId: string): void;
-    abortRequest(): Promise<void>;
-    audioPlayed(id: string): Promise<void>;
+    abortRequest(transport?: VoiceTransport): Promise<void>;
+    audioPlayed(id: string, error?: string, transport?: VoiceTransport): Promise<void>;
     getCheckoutStatus(cwd: string, options?: {
         requestId?: string;
     }): Promise<CheckoutStatusPayload>;

package/dist/daemon-client.js

@@ -1770,6 +1770,41 @@ export class DaemonClient {
             throw new Error(payload.error ?? "updateAgent rejected");
         }
     }
+    async updateCompanionEntry(input) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "agent.companion.update_entry.request",
+                agentId: input.agentId,
+                entryId: input.entryId,
+                action: input.action,
+                status: input.status,
+                text: input.text,
+                answerText: input.answerText,
+                sourceId: input.sourceId,
+            },
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "updateCompanionEntry rejected");
+        }
+    }
+    /**
+     * Backfills an agent's artifact feed from files already on disk. Needed for
+     * agents whose work predates the artifact feed, whose feeds are otherwise
+     * permanently empty.
+     */
+    async scanAgentArtifacts(agentId, options) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "agent.artifacts.scan.request",
+                agentId,
+                ...(options?.limit !== undefined ? { limit: options.limit } : {}),
+            },
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "scanAgentArtifacts rejected");
+        }
+        return { addedOrUpdated: payload.addedOrUpdated, total: payload.total };
+    }
     async renameProject(projectId, customName, requestId) {
         const payload = await this.sendCorrelatedSessionRequest({
             requestId,
@@ -2210,6 +2245,96 @@ export class DaemonClient {
     async sendMessage(agentId, text, options) {
         await this.sendAgentMessage(agentId, text, options);
     }
+    // ==========================================================================
+    // Durable agent message queue — see docs/queue-mirroring.md.
+    // Gated on server_info.features.durableAgentQueueV1; callers must check the
+    // flag before reaching any of these. Mutations are revision-checked: a stale
+    // expectedRevision is rejected with the `queue_revision_conflict` code
+    // instead of overwriting another device's edit.
+    // ==========================================================================
+    /**
+     * Admits a prompt into the durable queue with an explicit delivery intent.
+     * `itemId` comes from the caller so an optimistic local row and the stored
+     * item share an id, which makes a reconnect retry of the same enqueue a
+     * daemon-side no-op instead of a duplicate.
+     */
+    async enqueueAgentMessage(input) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "agent.queue.enqueue.request",
+                agentId: input.agentId,
+                itemId: input.itemId,
+                text: input.text,
+                intent: input.intent,
+                ...(input.images?.length ? { images: input.images } : {}),
+                ...(input.attachments?.length ? { attachments: input.attachments } : {}),
+                ...(input.composerAttachments?.length
+                    ? { composerAttachments: input.composerAttachments }
+                    : {}),
+            },
+        }));
+    }
+    async updateQueuedAgentMessage(input) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: {
+                type: "agent.queue.update.request",
+                agentId: input.agentId,
+                itemId: input.itemId,
+                text: input.text,
+                expectedRevision: input.expectedRevision,
+                ...(input.images?.length ? { images: input.images } : {}),
+                ...(input.attachments?.length ? { attachments: input.attachments } : {}),
+                ...(input.composerAttachments?.length
+                    ? { composerAttachments: input.composerAttachments }
+                    : {}),
+            },
+        }));
+    }
+    async reorderQueuedAgentMessages(agentId, itemIds, expectedRevision) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "agent.queue.reorder.request", agentId, itemIds, expectedRevision },
+        }));
+    }
+    async deleteQueuedAgentMessage(agentId, itemId, expectedRevision) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "agent.queue.delete.request", agentId, itemId, expectedRevision },
+        }));
+    }
+    async retryQueuedAgentMessage(agentId, itemId, expectedRevision) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "agent.queue.retry.request", agentId, itemId, expectedRevision },
+        }));
+    }
+    async sendQueuedAgentMessageNow(agentId, itemId, expectedRevision) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "agent.queue.send_now.request", agentId, itemId, expectedRevision },
+        }));
+    }
+    async listQueuedAgentMessages(agentId) {
+        return this.requireAgentQueuePayload(await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "agent.queue.list.request", agentId },
+        }));
+    }
+    /**
+     * Fetches the image bytes of one queued item. A device that did not queue the
+     * item has no local copy, so pulling it back into the composer would
+     * otherwise drop the images.
+     */
+    async getQueuedAgentMessageImages(agentId, itemId) {
+        const payload = await this.sendNamespacedCorrelatedSessionRequest({
+            message: { type: "agent.queue.get_item_images.request", agentId, itemId },
+        });
+        if (payload.error) {
+            throw new Error(payload.error);
+        }
+        return payload.images;
+    }
+    requireAgentQueuePayload(payload) {
+        if (!payload.queue) {
+            throw new Error(payload.error ?? "Agent queue request rejected");
+        }
+        return payload.queue;
+    }
     async rewindAgent(agentId, messageId, mode) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
@@ -2483,12 +2608,14 @@ export class DaemonClient {
     // ============================================================================
     // Audio / Voice
     // ============================================================================
-    async setVoiceMode(enabled, agentId) {
+    async setVoiceMode(enabled, agentId, input) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
             type: "set_voice_mode",
             enabled,
             ...(agentId ? { agentId } : {}),
+            ...(input?.attachmentId ? { attachmentId: input.attachmentId } : {}),
+            ...(input?.generation ? { generation: input.generation } : {}),
             requestId,
         });
         const response = await this.sendRequest({
@@ -2512,8 +2639,28 @@ export class DaemonClient {
         }
         return response;
     }
-    async sendVoiceAudioChunk(audio, format, isLast = false) {
-        this.sendSessionMessage({ type: "voice_audio_chunk", audio, format, isLast });
+    /** Reads this attachment's delivery receipts so the panel can show truthful state. */
+    async readVoiceInputReceipts(input) {
+        const requestId = this.createRequestId();
+        const response = await this.sendRequest({
+            requestId,
+            message: { type: "voice.input.receipts.read.request", requestId, ...input },
+            select: (msg) => msg.type === "voice.input.receipts.read.response" && msg.payload.requestId === requestId
+                ? msg.payload
+                : null,
+        });
+        if (response.error)
+            throw new Error(response.error);
+        return response;
+    }
+    async sendVoiceAudioChunk(audio, format, isLast = false, transport) {
+        this.sendSessionMessage({
+            type: "voice_audio_chunk",
+            audio,
+            format,
+            isLast,
+            ...transport,
+        });
     }
     async startDictationStream(dictationId, format) {
         const ack = this.waitForWithCancel((msg) => {
@@ -2674,11 +2821,16 @@ export class DaemonClient {
     cancelDictationStream(dictationId) {
         this.sendSessionMessageStrict({ type: "dictation_stream_cancel", dictationId });
     }
-    async abortRequest() {
-        this.sendSessionMessage({ type: "abort_request" });
+    async abortRequest(transport) {
+        this.sendSessionMessage({ type: "abort_request", ...transport });
     }
-    async audioPlayed(id) {
-        this.sendSessionMessage({ type: "audio_played", id });
+    async audioPlayed(id, error, transport) {
+        this.sendSessionMessageStrict({
+            type: "audio_played",
+            id,
+            ...(error !== undefined ? { error } : {}),
+            ...transport,
+        });
     }
     // ============================================================================
     // Git Operations

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camerontaylor/paseo-client",
-  "version": "0.11.1-fork.1",
+  "version": "0.11.2-fork.1",
   "description": "Paseo client SDK package",
   "files": [
     "dist",
@@ -39,8 +39,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@camerontaylor/paseo-protocol": "0.11.1-fork.1",
-    "@camerontaylor/paseo-relay": "0.11.1-fork.1",
+    "@camerontaylor/paseo-protocol": "0.11.2-fork.1",
+    "@camerontaylor/paseo-relay": "0.11.2-fork.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {