@getpaseo/client 0.1.96 → 0.1.97-beta.1

package/dist/daemon-client.d.ts

@@ -1,6 +1,6 @@
 import type { z } from "zod";
 import { AgentRefreshedStatusPayloadSchema, CheckoutRenameBranchResponseSchema, RenameTerminalResponseSchema, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, type ServerInfoStatusPayload } from "@getpaseo/protocol/messages";
-import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, FileUploadResponse, FileExplorerResponse, FetchAgentTimelineResponseMessage, 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, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision } from "@getpaseo/protocol/messages";
+import type { AgentStreamEventPayload, AgentSnapshotPayload, ProjectPlacementPayload, AgentPermissionResolvedMessage, CreateAgentRequestMessage, CreatePaseoWorktreeRequest, FileDownloadTokenResponse, FileUploadResponse, FileExplorerResponse, FetchAgentTimelineResponseMessage, 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, OpenProjectResponseMessage, ArchiveWorkspaceResponseMessage, WorkspaceSetupStatusResponseMessage, ListCommandsResponse, ListProviderFeaturesResponseMessage, ListProviderModelsResponseMessage, ListProviderModesResponseMessage, ListAvailableProvidersResponse, GetProvidersSnapshotResponseMessage, RefreshProvidersSnapshotResponseMessage, ProviderDiagnosticResponseMessage, DaemonGetStatusResponse, DaemonGetPairingOfferResponse, AgentRewindResponseMessage, ListTerminalsResponse, CreateTerminalResponse, SubscribeTerminalResponse, SubscribeTerminalRequest, CloseItemsResponse, KillTerminalResponse, CaptureTerminalResponse, TerminalInput, SessionInboundMessage, SessionOutboundMessage, SendAgentMessageRequest, PaseoConfigRaw, PaseoConfigRevision, WorkspaceCreateRequest } from "@getpaseo/protocol/messages";
 import type { AgentPermissionRequest, AgentPermissionResponse, AgentPersistenceHandle, 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";
@@ -174,6 +174,9 @@ type PaseoWorktreeArchivePayload = PaseoWorktreeArchiveResponse["payload"];
 type CreatePaseoWorktreePayload = Extract<SessionOutboundMessage, {
     type: "create_paseo_worktree_response";
 }>["payload"];
+type WorkspaceCreatePayload = Extract<SessionOutboundMessage, {
+    type: "workspace.create.response";
+}>["payload"];
 type FileExplorerPayload = FileExplorerResponse["payload"];
 export type FileExplorerDirectoryPayload = NonNullable<FileExplorerPayload["directory"]>;
 type LegacyFileExplorerFilePayload = NonNullable<FileExplorerPayload["file"]>;
@@ -593,6 +596,7 @@ export declare class DaemonClient {
     sendHeartbeat(params: {
         deviceType: "web" | "mobile";
         focusedAgentId: string | null;
+        focusedTerminalId?: string | null;
         lastActivityAt: string;
         appVisible: boolean;
         appVisibilityChangedAt?: string;
@@ -638,6 +642,9 @@ export declare class DaemonClient {
     renameProject(projectId: string, customName: string | null, requestId?: string): Promise<{
         customName: string | null;
     }>;
+    setWorkspaceTitle(workspaceId: string, title: string | null, requestId?: string): Promise<{
+        title: string | null;
+    }>;
     resumeAgent(handle: AgentPersistenceHandle, overrides?: Partial<AgentSessionConfig>): Promise<AgentSnapshotPayload>;
     importAgent(input: ImportAgentInput): Promise<AgentSnapshotPayload>;
     refreshAgent(agentId: string, requestId?: string): Promise<AgentRefreshedStatusPayload>;
@@ -742,8 +749,15 @@ export declare class DaemonClient {
         worktreePath?: string;
         repoRoot?: string;
         branchName?: string;
+        workspaceId?: string;
+        scope?: "workspace" | "worktree";
     }, requestId?: string): Promise<PaseoWorktreeArchivePayload>;
     createPaseoWorktree(input: CreatePaseoWorktreeInput, requestId?: string): Promise<CreatePaseoWorktreePayload>;
+    createWorkspace(input: {
+        source: WorkspaceCreateRequest["source"];
+        title?: string;
+        firstAgentContext?: WorkspaceCreateRequest["firstAgentContext"];
+    }, requestId?: string): Promise<WorkspaceCreatePayload>;
     validateBranch(options: {
         cwd: string;
         branchName: string;
@@ -819,15 +833,20 @@ export declare class DaemonClient {
     waitForFinish(agentId: string, timeout?: number): Promise<WaitForFinishResult>;
     subscribeTerminals(input: {
         cwd: string;
+        workspaceId?: string;
     }): void;
     unsubscribeTerminals(input: {
         cwd: string;
+        workspaceId?: string;
     }): void;
-    listTerminals(cwd?: string, requestId?: string): Promise<ListTerminalsPayload>;
+    listTerminals(cwd?: string, requestId?: string, options?: {
+        workspaceId?: string;
+    }): Promise<ListTerminalsPayload>;
     createTerminal(cwd: string, name?: string, requestId?: string, options?: {
         agentId?: string;
         command?: string;
         args?: string[];
+        workspaceId?: string;
     }): Promise<CreateTerminalPayload>;
     renameTerminal(input: RenameTerminalInput): Promise<RenameTerminalResult>;
     subscribeTerminal(terminalId: string, optionsOrRequestId?: {

package/dist/daemon-client.js

@@ -1,6 +1,7 @@
 import { CLIENT_CAPS } from "@getpaseo/protocol/client-capabilities";
 import { AgentCreateFailedStatusPayloadSchema, AgentCreatedStatusPayloadSchema, AgentRefreshedStatusPayloadSchema, AgentResumedStatusPayloadSchema, parseServerInfoStatusPayload, RestartRequestedStatusPayloadSchema, ShutdownRequestedStatusPayloadSchema, SessionInboundMessageSchema, WSOutboundMessageSchema, } from "@getpaseo/protocol/messages";
 import { isRelayClientWebSocketUrl } from "@getpaseo/protocol/daemon-endpoints";
+import { terminalSubscriptionKey } from "@getpaseo/protocol/terminal-subscription-key";
 import { asUint8Array, decodeFileTransferFrame, encodeFileTransferFrame, decodeTerminalStreamFrame, FileTransferOpcode, TerminalStreamOpcode, } from "@getpaseo/protocol/binary-frames/index";
 import { createRelayE2eeTransportFactory, createWebSocketTransportFactory, decodeMessageData, defaultWebSocketFactory, describeTransportClose, describeTransportError, } from "./daemon-client-transport.js";
 import { DaemonClientRuntimeMetrics } from "./daemon-client-runtime-metrics.js";
@@ -151,7 +152,7 @@ export class DaemonClient {
         this.lastErrorValue = null;
         this.connectionState = { status: "idle" };
         this.checkoutDiffSubscriptions = new Map();
-        this.terminalDirectorySubscriptions = new Set();
+        this.terminalDirectorySubscriptions = new Map();
         this.terminalStreams = new TerminalStreamRouter();
         this.pendingBinaryFileReads = new Map();
         this.activeBinaryFileTransfers = new Map();
@@ -725,6 +726,7 @@ export class DaemonClient {
             type: "client_heartbeat",
             deviceType: params.deviceType,
             focusedAgentId: params.focusedAgentId,
+            focusedTerminalId: params.focusedTerminalId ?? null,
             lastActivityAt: params.lastActivityAt,
             appVisible: params.appVisible,
             appVisibilityChangedAt: params.appVisibilityChangedAt,
@@ -1006,10 +1008,13 @@ export class DaemonClient {
         if (this.terminalDirectorySubscriptions.size === 0) {
             return;
         }
-        for (const cwd of this.terminalDirectorySubscriptions) {
+        for (const subscription of this.terminalDirectorySubscriptions.values()) {
             this.sendSessionMessage({
                 type: "subscribe_terminals_request",
-                cwd,
+                cwd: subscription.cwd,
+                ...(subscription.workspaceId !== undefined
+                    ? { workspaceId: subscription.workspaceId }
+                    : {}),
             });
         }
     }
@@ -1158,6 +1163,22 @@ export class DaemonClient {
         }
         return { customName: payload.customName };
     }
+    async setWorkspaceTitle(workspaceId, title, requestId) {
+        const payload = await this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "workspace.title.set.request",
+                workspaceId,
+                title,
+            },
+            responseType: "workspace.title.set.response",
+            timeout: 10000,
+        });
+        if (!payload.accepted) {
+            throw new Error(payload.error ?? "setWorkspaceTitle rejected");
+        }
+        return { title: payload.title };
+    }
     async resumeAgent(handle, overrides) {
         const requestId = this.createRequestId();
         const message = SessionInboundMessageSchema.parse({
@@ -2088,6 +2109,8 @@ export class DaemonClient {
                 worktreePath: input.worktreePath,
                 repoRoot: input.repoRoot,
                 branchName: input.branchName,
+                ...(input.workspaceId !== undefined ? { workspaceId: input.workspaceId } : {}),
+                ...(input.scope !== undefined ? { scope: input.scope } : {}),
             },
             responseType: "paseo_worktree_archive_response",
             timeout: 60000,
@@ -2112,6 +2135,21 @@ export class DaemonClient {
             timeout: 60000,
         });
     }
+    async createWorkspace(input, requestId) {
+        return this.sendCorrelatedSessionRequest({
+            requestId,
+            message: {
+                type: "workspace.create.request",
+                source: input.source,
+                ...(input.title !== undefined ? { title: input.title } : {}),
+                ...(input.firstAgentContext !== undefined
+                    ? { firstAgentContext: input.firstAgentContext }
+                    : {}),
+            },
+            responseType: "workspace.create.response",
+            timeout: 60000,
+        });
+    }
     async validateBranch(options, requestId) {
         return this.sendCorrelatedSessionRequest({
             requestId,
@@ -2599,30 +2637,36 @@ export class DaemonClient {
     // Terminals
     // ============================================================================
     subscribeTerminals(input) {
-        this.terminalDirectorySubscriptions.add(input.cwd);
+        this.terminalDirectorySubscriptions.set(terminalSubscriptionKey(input.cwd, input.workspaceId), {
+            cwd: input.cwd,
+            workspaceId: input.workspaceId,
+        });
         if (!this.transport || this.connectionState.status !== "connected") {
             return;
         }
         this.sendSessionMessage({
             type: "subscribe_terminals_request",
             cwd: input.cwd,
+            ...(input.workspaceId !== undefined ? { workspaceId: input.workspaceId } : {}),
         });
     }
     unsubscribeTerminals(input) {
-        this.terminalDirectorySubscriptions.delete(input.cwd);
+        this.terminalDirectorySubscriptions.delete(terminalSubscriptionKey(input.cwd, input.workspaceId));
         if (!this.transport || this.connectionState.status !== "connected") {
             return;
         }
         this.sendSessionMessage({
             type: "unsubscribe_terminals_request",
             cwd: input.cwd,
+            ...(input.workspaceId !== undefined ? { workspaceId: input.workspaceId } : {}),
         });
     }
-    async listTerminals(cwd, requestId) {
+    async listTerminals(cwd, requestId, options) {
         const resolvedRequestId = this.createRequestId(requestId);
         const message = SessionInboundMessageSchema.parse({
             type: "list_terminals_request",
             ...(cwd === undefined ? {} : { cwd }),
+            ...(options?.workspaceId !== undefined ? { workspaceId: options.workspaceId } : {}),
             requestId: resolvedRequestId,
         });
         return this.sendCorrelatedRequest({
@@ -2642,6 +2686,7 @@ export class DaemonClient {
             agentId: options?.agentId,
             command: options?.command,
             args: options?.args,
+            ...(options?.workspaceId !== undefined ? { workspaceId: options.workspaceId } : {}),
             requestId: resolvedRequestId,
         });
         return this.sendCorrelatedRequest({

package/dist/index.js

@@ -64,9 +64,11 @@ function createWorkspaceHandleFactory(daemonClient) {
             id,
             latest: () => latest,
             refetch: async (options) => {
+                // Best-effort: fetches one page and matches by id client-side, so a workspace beyond
+                // the first page won't be found. TODO: add a "get workspace by id" lookup and resolve
+                // by exact id instead of paging.
                 const result = await daemonClient.fetchWorkspaces({
                     requestId: options?.requestId,
-                    filter: { idPrefix: id },
                     page: { limit: 25 },
                 });
                 latest = result.entries.find((entry) => entry.id === id) ?? null;

package/package.json

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