@getpaseo/protocol 0.2.3 → 0.2.5

package/dist/git-remote.d.ts

@@ -1,6 +1,13 @@
 export interface GitRemoteLocation {
     transport: "scp" | "ssh" | "http" | "https";
     host: string;
+    /**
+     * Explicit non-default port from the remote (e.g. a self-hosted forge on
+     * `:60443`), or undefined for a default-port or scp-form remote. Kept separate
+     * from `host` so host-identity matching (forge detection, cloud-host checks)
+     * stays port-agnostic; only consumers that reconstruct a URL (web links) use it.
+     */
+    port?: string;
     path: string;
 }
 export interface GitHubRemoteIdentity {

package/dist/git-remote.js

@@ -5,6 +5,11 @@ const TRANSPORT_BY_PROTOCOL = {
     "http:": "http",
     "ssh:": "ssh",
 };
+const DEFAULT_PORT_BY_PROTOCOL = {
+    "https:": "443",
+    "http:": "80",
+    "ssh:": "22",
+};
 export function parseGitHubRemoteUrl(remoteUrl) {
     const location = parseGitRemoteLocation(remoteUrl);
     if (!location || !isGitHubHost(location.host))
@@ -27,7 +32,9 @@ export function parseGitRemoteLocation(remoteUrl) {
     const trimmed = remoteUrl.trim();
     if (!trimmed)
         return null;
-    const scpLike = trimmed.match(/^[^@]+@([^:]+):(.+)$/u);
+    // scp form has no scheme. Testing it first would match `ssh://git@host:22/x`
+    // — `[^@]+` happily eats `ssh://git` — and swallow the port into the path.
+    const scpLike = trimmed.includes("://") ? null : trimmed.match(/^[^@]+@([^:]+):(.+)$/u);
     if (scpLike) {
         const host = normalizeHost(scpLike[1] ?? "");
         const path = normalizeRemotePath(scpLike[2] ?? "");
@@ -56,7 +63,9 @@ export function parseGitRemoteLocation(remoteUrl) {
     const normalizedPath = normalizeRemotePath(path);
     if (!isValidRemoteHost(host) || !normalizedPath)
         return null;
-    return { transport, host, path: normalizedPath };
+    const protocol = parsed.protocol.toLowerCase();
+    const port = parsed.port && parsed.port !== DEFAULT_PORT_BY_PROTOCOL[protocol] ? parsed.port : undefined;
+    return { transport, host, port, path: normalizedPath };
 }
 export function parseGitHubRemoteIdentity(path) {
     const segments = path.split("/").filter(Boolean);

package/dist/messages.d.ts

@@ -821,6 +821,10 @@ export declare const FetchWorkspacesRequestMessageSchema: z.ZodObject<{
         subscriptionId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+export declare const ProjectListRequestMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.list.request">;
+    requestId: z.ZodString;
+}, z.core.$strip>;
 export declare const FetchAgentHistoryRequestMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"fetch_agent_history_request">;
     requestId: z.ZodString;
@@ -3133,6 +3137,9 @@ export declare const SessionInboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zod
     subscribe: z.ZodOptional<z.ZodObject<{
         subscriptionId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"project.list.request">;
+    requestId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"fetch_agent_request">;
     requestId: z.ZodString;
@@ -4842,6 +4849,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         workspaceFileEditing: z.ZodOptional<z.ZodBoolean>;
         providerUsageList: z.ZodOptional<z.ZodBoolean>;
         agentDetach: z.ZodOptional<z.ZodBoolean>;
+        agentThinkingUpdate: z.ZodOptional<z.ZodBoolean>;
         daemonDiagnostics: z.ZodOptional<z.ZodBoolean>;
         daemonSelfUpdate: z.ZodOptional<z.ZodBoolean>;
         agentForkContext: z.ZodOptional<z.ZodBoolean>;
@@ -4852,6 +4860,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         projectGithubClone: z.ZodOptional<z.ZodBoolean>;
         workspaceGithubRepositorySearch: z.ZodOptional<z.ZodBoolean>;
         projectCreateDirectory: z.ZodOptional<z.ZodBoolean>;
+        projectList: z.ZodOptional<z.ZodBoolean>;
         commitsList: z.ZodOptional<z.ZodBoolean>;
         commitBaseClassification: z.ZodOptional<z.ZodBoolean>;
         providerRemoval: z.ZodOptional<z.ZodBoolean>;
@@ -4899,6 +4908,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         workspaceFileEditing?: boolean | undefined;
         providerUsageList?: boolean | undefined;
         agentDetach?: boolean | undefined;
+        agentThinkingUpdate?: boolean | undefined;
         daemonDiagnostics?: boolean | undefined;
         daemonSelfUpdate?: boolean | undefined;
         agentForkContext?: boolean | undefined;
@@ -4909,6 +4919,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         projectGithubClone?: boolean | undefined;
         workspaceGithubRepositorySearch?: boolean | undefined;
         projectCreateDirectory?: boolean | undefined;
+        projectList?: boolean | undefined;
         commitsList?: boolean | undefined;
         commitBaseClassification?: boolean | undefined;
         providerRemoval?: boolean | undefined;
@@ -4957,6 +4968,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         workspaceFileEditing?: boolean | undefined;
         providerUsageList?: boolean | undefined;
         agentDetach?: boolean | undefined;
+        agentThinkingUpdate?: boolean | undefined;
         daemonDiagnostics?: boolean | undefined;
         daemonSelfUpdate?: boolean | undefined;
         agentForkContext?: boolean | undefined;
@@ -4967,6 +4979,7 @@ export declare const ServerInfoStatusPayloadSchema: z.ZodPipe<z.ZodObject<{
         projectGithubClone?: boolean | undefined;
         workspaceGithubRepositorySearch?: boolean | undefined;
         projectCreateDirectory?: boolean | undefined;
+        projectList?: boolean | undefined;
         commitsList?: boolean | undefined;
         commitBaseClassification?: boolean | undefined;
         providerRemoval?: boolean | undefined;
@@ -6746,6 +6759,7 @@ export declare const FetchRecentProviderSessionsResponseMessageSchema: z.ZodObje
 }, z.core.$strip>;
 export declare const WorkspaceProjectDescriptorPayloadSchema: z.ZodObject<{
     projectId: z.ZodString;
+    projectKey: z.ZodOptional<z.ZodString>;
     projectDisplayName: z.ZodString;
     projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     projectRootPath: z.ZodString;
@@ -7172,6 +7186,7 @@ export declare const FetchWorkspacesResponseMessageSchema: z.ZodObject<{
         }>>>;
         emptyProjects: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -7607,6 +7622,7 @@ export declare const WorkspaceUpdateMessageSchema: z.ZodObject<{
         id: z.ZodString;
         emptyProject: z.ZodOptional<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -7625,6 +7641,7 @@ export declare const ProjectUpdateMessageSchema: z.ZodObject<{
         kind: z.ZodLiteral<"upsert">;
         project: z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -7639,6 +7656,24 @@ export declare const ProjectUpdateMessageSchema: z.ZodObject<{
         projectId: z.ZodString;
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>;
+export declare const ProjectListResponseMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"project.list.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        projects: z.ZodArray<z.ZodObject<{
+            projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
+            projectDisplayName: z.ZodString;
+            projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            projectRootPath: z.ZodString;
+            projectKind: z.ZodEnum<{
+                git: "git";
+                directory: "directory";
+                non_git: "non_git";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 export declare const ScriptStatusUpdateMessageSchema: z.ZodObject<{
     type: z.ZodLiteral<"script_status_update">;
     payload: z.ZodObject<{
@@ -8188,6 +8223,7 @@ export declare const ProjectAddResponseSchema: z.ZodObject<{
         requestId: z.ZodString;
         project: z.ZodNullable<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -8218,6 +8254,7 @@ export declare const ProjectCreateDirectoryResponseSchema: z.ZodObject<{
         directoryPath: z.ZodNullable<z.ZodString>;
         project: z.ZodNullable<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -8316,6 +8353,7 @@ export declare const ProjectGithubCloneResponseSchema: z.ZodObject<{
         checkoutPath: z.ZodNullable<z.ZodString>;
         project: z.ZodNullable<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -10328,6 +10366,7 @@ export declare const SubscribeCheckoutDiffResponseSchema: z.ZodObject<{
             }>;
             message: z.ZodString;
         }, z.core.$strip>>;
+        diffTooLarge: z.ZodOptional<z.ZodBoolean>;
         requestId: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -10376,6 +10415,7 @@ export declare const CheckoutDiffUpdateSchema: z.ZodObject<{
             }>;
             message: z.ZodString;
         }, z.core.$strip>>;
+        diffTooLarge: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export declare const CheckoutCommitResponseSchema: z.ZodObject<{
@@ -13984,6 +14024,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         id: z.ZodString;
         emptyProject: z.ZodOptional<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -14001,6 +14042,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         kind: z.ZodLiteral<"upsert">;
         project: z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -14014,6 +14056,23 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         kind: z.ZodLiteral<"remove">;
         projectId: z.ZodString;
     }, z.core.$strip>], "kind">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"project.list.response">;
+    payload: z.ZodObject<{
+        requestId: z.ZodString;
+        projects: z.ZodArray<z.ZodObject<{
+            projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
+            projectDisplayName: z.ZodString;
+            projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            projectRootPath: z.ZodString;
+            projectKind: z.ZodEnum<{
+                git: "git";
+                directory: "directory";
+                non_git: "non_git";
+            }>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"script_status_update">;
     payload: z.ZodObject<{
@@ -14979,6 +15038,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         }>>>;
         emptyProjects: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -15000,6 +15060,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         requestId: z.ZodString;
         project: z.ZodNullable<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -15021,6 +15082,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         directoryPath: z.ZodNullable<z.ZodString>;
         project: z.ZodNullable<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -15536,6 +15598,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
         checkoutPath: z.ZodNullable<z.ZodString>;
         project: z.ZodNullable<z.ZodObject<{
             projectId: z.ZodString;
+            projectKey: z.ZodOptional<z.ZodString>;
             projectDisplayName: z.ZodString;
             projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             projectRootPath: z.ZodString;
@@ -17541,6 +17604,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
             }>;
             message: z.ZodString;
         }, z.core.$strip>>;
+        diffTooLarge: z.ZodOptional<z.ZodBoolean>;
         requestId: z.ZodString;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -17588,6 +17652,7 @@ export declare const SessionOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.Zo
             }>;
             message: z.ZodString;
         }, z.core.$strip>>;
+        diffTooLarge: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"checkout_commit_response">;
@@ -20248,6 +20313,7 @@ export type ProjectPlacementPayload = z.infer<typeof ProjectPlacementPayloadSche
 export type WorkspaceStateBucket = z.infer<typeof WorkspaceStateBucketSchema>;
 export type WorkspaceDescriptorPayload = z.infer<typeof WorkspaceDescriptorPayloadSchema>;
 export type WorkspaceProjectDescriptorPayload = z.infer<typeof WorkspaceProjectDescriptorPayloadSchema>;
+export type ProjectListResponseMessage = z.infer<typeof ProjectListResponseMessageSchema>;
 export type WorkspaceScriptLifecycle = z.infer<typeof WorkspaceScriptLifecycleSchema>;
 export type WorkspaceScriptHealth = z.infer<typeof WorkspaceScriptHealthSchema>;
 export type WorkspaceScriptPayload = z.infer<typeof WorkspaceScriptPayloadSchema>;
@@ -20347,6 +20413,7 @@ export type FetchAgentsRequestMessage = z.infer<typeof FetchAgentsRequestMessage
 export type FetchAgentHistoryRequestMessage = z.infer<typeof FetchAgentHistoryRequestMessageSchema>;
 export type FetchRecentProviderSessionsRequestMessage = z.infer<typeof FetchRecentProviderSessionsRequestMessageSchema>;
 export type FetchWorkspacesRequestMessage = z.infer<typeof FetchWorkspacesRequestMessageSchema>;
+export type ProjectListRequestMessage = z.infer<typeof ProjectListRequestMessageSchema>;
 export type FetchAgentRequestMessage = z.infer<typeof FetchAgentRequestMessageSchema>;
 export type AgentForkContextRequestMessage = z.infer<typeof AgentForkContextRequestMessageSchema>;
 export type SendAgentMessageRequest = z.infer<typeof SendAgentMessageRequestSchema>;
@@ -20942,6 +21009,9 @@ export declare const WSSessionInboundSchema: z.ZodObject<{
         subscribe: z.ZodOptional<z.ZodObject<{
             subscriptionId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"project.list.request">;
+        requestId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"fetch_agent_request">;
         requestId: z.ZodString;
@@ -23537,6 +23607,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             id: z.ZodString;
             emptyProject: z.ZodOptional<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -23554,6 +23625,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             kind: z.ZodLiteral<"upsert">;
             project: z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -23567,6 +23639,23 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             kind: z.ZodLiteral<"remove">;
             projectId: z.ZodString;
         }, z.core.$strip>], "kind">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"project.list.response">;
+        payload: z.ZodObject<{
+            requestId: z.ZodString;
+            projects: z.ZodArray<z.ZodObject<{
+                projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
+                projectDisplayName: z.ZodString;
+                projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                projectRootPath: z.ZodString;
+                projectKind: z.ZodEnum<{
+                    git: "git";
+                    directory: "directory";
+                    non_git: "non_git";
+                }>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"script_status_update">;
         payload: z.ZodObject<{
@@ -24532,6 +24621,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             }>>>;
             emptyProjects: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -24553,6 +24643,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             requestId: z.ZodString;
             project: z.ZodNullable<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -24574,6 +24665,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             directoryPath: z.ZodNullable<z.ZodString>;
             project: z.ZodNullable<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -25089,6 +25181,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
             checkoutPath: z.ZodNullable<z.ZodString>;
             project: z.ZodNullable<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -27094,6 +27187,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                 }>;
                 message: z.ZodString;
             }, z.core.$strip>>;
+            diffTooLarge: z.ZodOptional<z.ZodBoolean>;
             requestId: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
@@ -27141,6 +27235,7 @@ export declare const WSSessionOutboundSchema: z.ZodObject<{
                 }>;
                 message: z.ZodString;
             }, z.core.$strip>>;
+            diffTooLarge: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"checkout_commit_response">;
@@ -30165,6 +30260,9 @@ export declare const WSInboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         subscribe: z.ZodOptional<z.ZodObject<{
             subscriptionId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"project.list.request">;
+        requestId: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"fetch_agent_request">;
         requestId: z.ZodString;
@@ -32762,6 +32860,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             id: z.ZodString;
             emptyProject: z.ZodOptional<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -32779,6 +32878,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             kind: z.ZodLiteral<"upsert">;
             project: z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -32792,6 +32892,23 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             kind: z.ZodLiteral<"remove">;
             projectId: z.ZodString;
         }, z.core.$strip>], "kind">;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"project.list.response">;
+        payload: z.ZodObject<{
+            requestId: z.ZodString;
+            projects: z.ZodArray<z.ZodObject<{
+                projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
+                projectDisplayName: z.ZodString;
+                projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                projectRootPath: z.ZodString;
+                projectKind: z.ZodEnum<{
+                    git: "git";
+                    directory: "directory";
+                    non_git: "non_git";
+                }>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"script_status_update">;
         payload: z.ZodObject<{
@@ -33757,6 +33874,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             }>>>;
             emptyProjects: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -33778,6 +33896,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             requestId: z.ZodString;
             project: z.ZodNullable<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -33799,6 +33918,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             directoryPath: z.ZodNullable<z.ZodString>;
             project: z.ZodNullable<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -34314,6 +34434,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
             checkoutPath: z.ZodNullable<z.ZodString>;
             project: z.ZodNullable<z.ZodObject<{
                 projectId: z.ZodString;
+                projectKey: z.ZodOptional<z.ZodString>;
                 projectDisplayName: z.ZodString;
                 projectCustomName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 projectRootPath: z.ZodString;
@@ -36319,6 +36440,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 }>;
                 message: z.ZodString;
             }, z.core.$strip>>;
+            diffTooLarge: z.ZodOptional<z.ZodBoolean>;
             requestId: z.ZodString;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
@@ -36366,6 +36488,7 @@ export declare const WSOutboundMessageSchema: z.ZodDiscriminatedUnion<[z.ZodObje
                 }>;
                 message: z.ZodString;
             }, z.core.$strip>>;
+            diffTooLarge: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"checkout_commit_response">;

package/dist/messages.js

@@ -869,6 +869,10 @@ export const FetchWorkspacesRequestMessageSchema = z.object({
     })
         .optional(),
 });
+export const ProjectListRequestMessageSchema = z.object({
+    type: z.literal("project.list.request"),
+    requestId: z.string(),
+});
 export const FetchAgentHistoryRequestMessageSchema = z.object({
     type: z.literal("fetch_agent_history_request"),
     requestId: z.string(),
@@ -2061,6 +2065,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     FetchAgentHistoryRequestMessageSchema,
     FetchRecentProviderSessionsRequestMessageSchema,
     FetchWorkspacesRequestMessageSchema,
+    ProjectListRequestMessageSchema,
     FetchAgentRequestMessageSchema,
     DeleteAgentRequestMessageSchema,
     ArchiveAgentRequestMessageSchema,
@@ -2387,6 +2392,8 @@ export const ServerInfoStatusPayloadSchema = z
         providerUsageList: z.boolean().optional(),
         // COMPAT(agentDetach): added in v0.1.98, remove gate after 2026-12-19 once daemon floor >= v0.1.98.
         agentDetach: z.boolean().optional(),
+        // COMPAT(agentThinkingUpdate): added in v0.2.4, remove gate after 2027-01-28.
+        agentThinkingUpdate: z.boolean().optional(),
         // COMPAT(daemonDiagnostics): added in v0.1.100, remove gate after 2026-12-25 once daemon floor >= v0.1.100.
         daemonDiagnostics: z.boolean().optional(),
         // COMPAT(daemonSelfUpdate): added in v0.1.93, remove gate after 2026-12-13.
@@ -2407,6 +2414,8 @@ export const ServerInfoStatusPayloadSchema = z
         workspaceGithubRepositorySearch: z.boolean().optional(),
         // COMPAT(projectCreateDirectory): added in v0.1.108, remove gate after 2027-01-15.
         projectCreateDirectory: z.boolean().optional(),
+        // COMPAT(projectList): added in v0.2.4, drop the gate when floor >= v0.2.4.
+        projectList: z.boolean().optional(),
         // COMPAT(commitsList): added in v0.1.110, remove gate after 2027-01-16.
         commitsList: z.boolean().optional(),
         // COMPAT(commitBaseClassification): added in v0.2.0, remove gate after 2027-01-23.
@@ -2787,6 +2796,8 @@ export const FetchRecentProviderSessionsResponseMessageSchema = z.object({
 // workspace is archived.
 export const WorkspaceProjectDescriptorPayloadSchema = z.object({
     projectId: z.string(),
+    // COMPAT(projectKey): added in v0.2.4 on 2026-07-28; remove optional after 2027-01-28.
+    projectKey: z.string().optional(),
     projectDisplayName: z.string(),
     projectCustomName: z.string().nullable().optional(),
     projectRootPath: z.string(),
@@ -2839,6 +2850,13 @@ export const ProjectUpdateMessageSchema = z.object({
         z.object({ kind: z.literal("remove"), projectId: z.string() }),
     ]),
 });
+export const ProjectListResponseMessageSchema = z.object({
+    type: z.literal("project.list.response"),
+    payload: z.object({
+        requestId: z.string(),
+        projects: z.array(WorkspaceProjectDescriptorPayloadSchema),
+    }),
+});
 export const ScriptStatusUpdateMessageSchema = z.object({
     type: z.literal("script_status_update"),
     payload: z.object({
@@ -3589,6 +3607,8 @@ const CheckoutDiffSubscriptionPayloadSchema = z.object({
     cwd: z.string(),
     files: z.array(ParsedDiffFileSchema),
     error: CheckoutErrorSchema.nullable(),
+    // COMPAT(diffTooLarge): added in v0.2.4, keep optional until the daemon floor is v0.2.4.
+    diffTooLarge: z.boolean().optional(),
 });
 export const SubscribeCheckoutDiffResponseSchema = z.object({
     type: z.literal("subscribe_checkout_diff_response"),
@@ -4525,6 +4545,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     AgentUpdateMessageSchema,
     WorkspaceUpdateMessageSchema,
     ProjectUpdateMessageSchema,
+    ProjectListResponseMessageSchema,
     ScriptStatusUpdateMessageSchema,
     WorkspaceSetupProgressMessageSchema,
     WorkspaceSetupStatusResponseMessageSchema,

package/dist/validation/ws-outbound-schema-metadata.d.ts

@@ -1060,6 +1060,7 @@ export declare const WSOutboundMessageSchema: {
                 id: import("zod").ZodString;
                 emptyProject: import("zod").ZodOptional<import("zod").ZodObject<{
                     projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
                     projectDisplayName: import("zod").ZodString;
                     projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
                     projectRootPath: import("zod").ZodString;
@@ -1077,6 +1078,7 @@ export declare const WSOutboundMessageSchema: {
                 kind: import("zod").ZodLiteral<"upsert">;
                 project: import("zod").ZodObject<{
                     projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
                     projectDisplayName: import("zod").ZodString;
                     projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
                     projectRootPath: import("zod").ZodString;
@@ -1090,6 +1092,23 @@ export declare const WSOutboundMessageSchema: {
                 kind: import("zod").ZodLiteral<"remove">;
                 projectId: import("zod").ZodString;
             }, import("zod/v4/core").$strip>], "kind">;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            type: import("zod").ZodLiteral<"project.list.response">;
+            payload: import("zod").ZodObject<{
+                requestId: import("zod").ZodString;
+                projects: import("zod").ZodArray<import("zod").ZodObject<{
+                    projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
+                    projectDisplayName: import("zod").ZodString;
+                    projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+                    projectRootPath: import("zod").ZodString;
+                    projectKind: import("zod").ZodEnum<{
+                        git: "git";
+                        directory: "directory";
+                        non_git: "non_git";
+                    }>;
+                }, import("zod/v4/core").$strip>>;
+            }, import("zod/v4/core").$strip>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             type: import("zod").ZodLiteral<"script_status_update">;
             payload: import("zod").ZodObject<{
@@ -2055,6 +2074,7 @@ export declare const WSOutboundMessageSchema: {
                 }>>>;
                 emptyProjects: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
                     projectDisplayName: import("zod").ZodString;
                     projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
                     projectRootPath: import("zod").ZodString;
@@ -2076,6 +2096,7 @@ export declare const WSOutboundMessageSchema: {
                 requestId: import("zod").ZodString;
                 project: import("zod").ZodNullable<import("zod").ZodObject<{
                     projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
                     projectDisplayName: import("zod").ZodString;
                     projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
                     projectRootPath: import("zod").ZodString;
@@ -2097,6 +2118,7 @@ export declare const WSOutboundMessageSchema: {
                 directoryPath: import("zod").ZodNullable<import("zod").ZodString>;
                 project: import("zod").ZodNullable<import("zod").ZodObject<{
                     projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
                     projectDisplayName: import("zod").ZodString;
                     projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
                     projectRootPath: import("zod").ZodString;
@@ -2612,6 +2634,7 @@ export declare const WSOutboundMessageSchema: {
                 checkoutPath: import("zod").ZodNullable<import("zod").ZodString>;
                 project: import("zod").ZodNullable<import("zod").ZodObject<{
                     projectId: import("zod").ZodString;
+                    projectKey: import("zod").ZodOptional<import("zod").ZodString>;
                     projectDisplayName: import("zod").ZodString;
                     projectCustomName: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
                     projectRootPath: import("zod").ZodString;
@@ -4617,6 +4640,7 @@ export declare const WSOutboundMessageSchema: {
                     }>;
                     message: import("zod").ZodString;
                 }, import("zod/v4/core").$strip>>;
+                diffTooLarge: import("zod").ZodOptional<import("zod").ZodBoolean>;
                 requestId: import("zod").ZodString;
             }, import("zod/v4/core").$strip>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -4664,6 +4688,7 @@ export declare const WSOutboundMessageSchema: {
                     }>;
                     message: import("zod").ZodString;
                 }, import("zod/v4/core").$strip>>;
+                diffTooLarge: import("zod").ZodOptional<import("zod").ZodBoolean>;
             }, import("zod/v4/core").$strip>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             type: import("zod").ZodLiteral<"checkout_commit_response">;