@getpaseo/protocol 0.3.1 → 0.4.0-beta.2

package/dist/messages.js

@@ -50,6 +50,32 @@ export const TerminalProfileSchema = z
     icon: z.string().optional(),
 })
     .passthrough();
+/**
+ * A named launch bundle: a provider plus the agent-config values a client would
+ * otherwise set one control at a time. Field names mirror `AgentSessionConfig`
+ * so applying a profile is a copy rather than a translation table.
+ *
+ * There is deliberately no system prompt here. `AgentSessionConfig.systemPrompt`
+ * is creation-only, so a profile carrying one would apply when starting a new
+ * agent and silently do nothing when applied to a running one.
+ */
+export const AgentProfileSchema = z
+    .object({
+    id: z.string(),
+    name: z.string(),
+    /** A key into the client's icon registry, not a glyph. Unknown keys draw the default. */
+    icon: z.string().optional(),
+    /** An identity colour name shared with host badges. Unknown values draw unthemed. */
+    color: z.string().optional(),
+    provider: z.string(),
+    model: z.string().optional(),
+    modeId: z.string().optional(),
+    thinkingOptionId: z.string().optional(),
+    featureValues: z.record(z.string(), z.unknown()).optional(),
+    /** Free text, surfaced to orchestrating agents by the `list_profiles` MCP tool. */
+    notes: z.string().optional(),
+})
+    .passthrough();
 const MutableBrowserToolsConfigSchema = z
     .object({
     enabled: z.boolean().default(false),
@@ -76,6 +102,7 @@ export const MutableDaemonConfigSchema = z
     enableTerminalAgentHooks: z.boolean().default(false),
     appendSystemPrompt: z.string().default(""),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
+    agentProfiles: z.array(AgentProfileSchema).optional(),
 })
     .passthrough();
 export const MutableDaemonConfigPatchSchema = z
@@ -92,6 +119,7 @@ export const MutableDaemonConfigPatchSchema = z
     enableTerminalAgentHooks: z.boolean().optional(),
     appendSystemPrompt: z.string().optional(),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
+    agentProfiles: z.array(AgentProfileSchema).optional(),
 })
     .partial()
     .passthrough();
@@ -475,6 +503,9 @@ export const AgentTimelineItemPayloadSchema = z.union([
         items: z.array(z.object({
             text: z.string(),
             completed: z.boolean(),
+            id: z.string().optional(),
+            status: z.enum(["pending", "in_progress", "completed"]).optional(),
+            activeForm: z.string().optional(),
         })),
     }),
     z.object({
@@ -1273,6 +1304,33 @@ export const SetAgentFeatureResponseMessageSchema = z.object({
     type: z.literal("set_agent_feature_response"),
     payload: AgentActionResponsePayloadSchema,
 });
+/**
+ * Every agent-config value a client can change in one shot. Each field is
+ * optional and an omitted field is left alone; `null` on model and thinking
+ * clears them, matching the single-field RPCs above.
+ */
+export const AgentConfigApplySchema = z.object({
+    modelId: z.string().nullable().optional(),
+    modeId: z.string().optional(),
+    thinkingOptionId: z.string().nullable().optional(),
+    featureValues: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Applies a whole config bundle to one agent. The four single-field RPCs above
+ * stay for individual control edits. One request prevents client interruption
+ * and other mutations from interleaving between bundle steps; provider-level
+ * rejection can still leave earlier steps applied.
+ */
+export const AgentConfigApplyRequestMessageSchema = z.object({
+    type: z.literal("agent.config.apply.request"),
+    agentId: z.string(),
+    config: AgentConfigApplySchema,
+    requestId: z.string(),
+});
+export const AgentConfigApplyResponseMessageSchema = z.object({
+    type: z.literal("agent.config.apply.response"),
+    payload: AgentActionResponsePayloadSchema,
+});
 export const AgentDetachRequestMessageSchema = z.object({
     type: z.literal("agent.detach.request"),
     agentId: z.string(),
@@ -1474,6 +1532,12 @@ export const CheckoutRefreshRequestSchema = z.object({
     cwd: z.string(),
     requestId: z.string(),
 });
+export const CheckoutDiscardChangesRequestSchema = z.object({
+    type: z.literal("checkout.discard_changes.request"),
+    cwd: z.string(),
+    paths: z.array(z.string()).min(1),
+    requestId: z.string(),
+});
 export const CheckoutPrCreateRequestSchema = z.object({
     type: z.literal("checkout_pr_create_request"),
     cwd: z.string(),
@@ -1850,6 +1914,8 @@ const DiffHunkSchema = z.object({
 });
 const ParsedDiffFileSchema = z.object({
     path: z.string(),
+    // COMPAT(diffOldPath): added in v0.3.0, remove gate after 2027-02-09.
+    oldPath: z.string().optional(),
     isNew: z.boolean(),
     isDeleted: z.boolean(),
     additions: z.number(),
@@ -1928,6 +1994,33 @@ export const FileWriteRequestSchema = z.object({
     expectedRevision: z.string().optional(),
     requestId: z.string(),
 });
+export const FileEntryCreateRequestSchema = z.object({
+    type: z.literal("fs.entry.create.request"),
+    cwd: z.string(),
+    parentPath: z.string(),
+    name: z.string(),
+    kind: z.enum(["file", "directory"]),
+    requestId: z.string(),
+});
+export const FileEntryRenameRequestSchema = z.object({
+    type: z.literal("fs.entry.rename.request"),
+    cwd: z.string(),
+    path: z.string(),
+    name: z.string(),
+    requestId: z.string(),
+});
+export const FileEntryDuplicateRequestSchema = z.object({
+    type: z.literal("fs.entry.duplicate.request"),
+    cwd: z.string(),
+    path: z.string(),
+    requestId: z.string(),
+});
+export const FileEntryDeleteRequestSchema = z.object({
+    type: z.literal("fs.entry.delete.request"),
+    cwd: z.string(),
+    path: z.string(),
+    requestId: z.string(),
+});
 export const ProjectIconRequestSchema = z.object({
     type: z.literal("project_icon_request"),
     cwd: z.string(),
@@ -1995,6 +2088,17 @@ export const RegisterPushTokenMessageSchema = z.object({
     type: z.literal("register_push_token"),
     token: z.string(),
 });
+export const PushUnregisterRequestSchema = z.object({
+    type: z.literal("push.unregister.request"),
+    token: z.string(),
+    requestId: z.string(),
+});
+export const PushUnregisterResponseSchema = z.object({
+    type: z.literal("push.unregister.response"),
+    payload: z.object({
+        requestId: z.string(),
+    }),
+});
 // ============================================================================
 // Terminal Messages
 // ============================================================================
@@ -2137,6 +2241,15 @@ export const HubExecutionAgentCreateRequestSchema = z.object({
     mcpServers: z.record(z.string(), McpServerConfigSchema).optional(),
     worktree: CreateAgentWorktreeTargetSchema.optional(),
 });
+export const HubExecutionAgentValidateRequestSchema = z.object({
+    type: z.literal("hub.execution.agent.validate.request"),
+    requestId: z.string(),
+    provider: z.string(),
+    model: z.string().optional(),
+    modeId: z.string().optional(),
+    thinkingOptionId: z.string().optional(),
+    providerOptions: ProviderOptionsSchema.optional(),
+});
 const HubExecutionAgentCreateErrorSchema = z.discriminatedUnion("code", [
     z.object({
         code: z.literal("provider_options_invalid"),
@@ -2166,6 +2279,7 @@ export const HubExecutionControlRequestSchema = z.object({
 });
 export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateRequestSchema,
+    HubExecutionAgentValidateRequestSchema,
     HubExecutionControlRequestSchema,
     BrowserAutomationExecuteResponseSchema,
     VoiceAudioChunkMessageSchema,
@@ -2231,6 +2345,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     SetAgentModelRequestMessageSchema,
     SetAgentThinkingRequestMessageSchema,
     SetAgentFeatureRequestMessageSchema,
+    AgentConfigApplyRequestMessageSchema,
     AgentDetachRequestMessageSchema,
     AgentRewindRequestMessageSchema,
     AgentPermissionResponseMessageSchema,
@@ -2243,6 +2358,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPullRequestSchema,
     CheckoutPushRequestSchema,
     CheckoutRefreshRequestSchema,
+    CheckoutDiscardChangesRequestSchema,
     CheckoutPrCreateRequestSchema,
     CheckoutPrMergeRequestSchema,
     CheckoutForgeSetAutoMergeRequestSchema,
@@ -2281,6 +2397,10 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     FileSubscribeRequestSchema,
     FileUnsubscribeRequestSchema,
     FileWriteRequestSchema,
+    FileEntryCreateRequestSchema,
+    FileEntryRenameRequestSchema,
+    FileEntryDuplicateRequestSchema,
+    FileEntryDeleteRequestSchema,
     ProjectIconRequestSchema,
     ProjectIconGetRequestSchema,
     FileDownloadTokenRequestSchema,
@@ -2290,6 +2410,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     PingMessageSchema,
     ListCommandsRequestSchema,
     RegisterPushTokenMessageSchema,
+    PushUnregisterRequestSchema,
     ListTerminalsRequestSchema,
     SubscribeTerminalsRequestSchema,
     UnsubscribeTerminalsRequestSchema,
@@ -2471,6 +2592,8 @@ export const ServerInfoStatusPayloadSchema = z
     features: z
         .object({
         providersSnapshot: z.boolean().optional(),
+        // COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
+        providersSnapshotCwd: z.boolean().optional(),
         // COMPAT(checkoutForgeSetAutoMerge): added in v0.1.106, remove old
         // checkoutGithubSetAutoMerge fallback after 2026-12-28.
         checkoutForgeSetAutoMerge: z.boolean().optional(),
@@ -2485,6 +2608,8 @@ export const ServerInfoStatusPayloadSchema = z
         daemonStatusRpc: z.boolean().optional(),
         // COMPAT(relayConfig): added in v0.2.6, remove gate after 2027-01-31.
         relayConfig: z.boolean().optional(),
+        // COMPAT(pushTokenRevocation): added in v0.3.2, remove gate after 2027-02-10.
+        pushTokenRevocation: z.boolean().optional(),
         // COMPAT(terminalRestoreModes): added in v0.1.81, remove gate after 2026-11-23.
         "terminal-restore-modes": z.boolean().optional(),
         // COMPAT(terminalInputModeReplay): added in v0.2.6, remove gate after 2027-02-02.
@@ -2563,6 +2688,19 @@ export const ServerInfoStatusPayloadSchema = z
         workspaceScriptManagement: z.boolean().optional(),
         // COMPAT(projectCustomIcon): added in v0.2.0, remove after 2027-01-20.
         projectCustomIcon: z.boolean().optional(),
+        // COMPAT(fsEntryOps): added in v0.3.0, remove gate after 2027-02-08.
+        fsEntryOps: z.boolean().optional(),
+        // COMPAT(fsEntryDuplicate): added in v0.3.0, remove gate after 2027-02-09.
+        fsEntryDuplicate: z.boolean().optional(),
+        // COMPAT(checkoutDiscardChanges): added in v0.3.0, remove gate after 2027-02-08.
+        checkoutDiscardChanges: z.boolean().optional(),
+        // COMPAT(agentProfiles): added in v0.3.2, remove gate after 2027-02-11.
+        // An older daemon parses its persisted config strictly, so writing
+        // agentProfiles to one is silently dropped. The client hides the feature
+        // rather than letting a save appear to succeed.
+        agentProfiles: z.boolean().optional(),
+        // COMPAT(agentConfigApply): added in v0.3.2, remove gate after 2027-02-11.
+        agentConfigApply: z.boolean().optional(),
     })
         .optional(),
 })
@@ -3897,6 +4035,15 @@ export const CheckoutGithubSetAutoMergeResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const CheckoutDiscardChangesResponseSchema = z.object({
+    type: z.literal("checkout.discard_changes.response"),
+    payload: z.object({
+        cwd: z.string(),
+        success: z.boolean(),
+        error: CheckoutErrorSchema.nullable(),
+        requestId: z.string(),
+    }),
+});
 export const CheckoutCommitsListResponseSchema = z.object({
     type: z.literal("checkout.commits.list.response"),
     payload: z.object({
@@ -4314,6 +4461,49 @@ export const FileWriteResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const FileEntryCreateResponseSchema = z.object({
+    type: z.literal("fs.entry.create.response"),
+    payload: z.object({
+        cwd: z.string(),
+        parentPath: z.string(),
+        path: z.string().nullable(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const FileEntryRenameResponseSchema = z.object({
+    type: z.literal("fs.entry.rename.response"),
+    payload: z.object({
+        cwd: z.string(),
+        path: z.string(),
+        renamedPath: z.string().nullable(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const FileEntryDuplicateResponseSchema = z.object({
+    type: z.literal("fs.entry.duplicate.response"),
+    payload: z.object({
+        cwd: z.string(),
+        path: z.string(),
+        duplicatedPath: z.string().nullable(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
+export const FileEntryDeleteResponseSchema = z.object({
+    type: z.literal("fs.entry.delete.response"),
+    payload: z.object({
+        cwd: z.string(),
+        path: z.string(),
+        success: z.boolean(),
+        error: z.string().nullable(),
+        requestId: z.string(),
+    }),
+});
 export const FileUpdateSchema = z.object({
     type: z.literal("fs.file.update"),
     payload: z.object({
@@ -4412,6 +4602,7 @@ export const ListAvailableProvidersResponseSchema = z.object({
 export const GetProvidersSnapshotResponseMessageSchema = z.object({
     type: z.literal("get_providers_snapshot_response"),
     payload: z.object({
+        cwd: z.string().optional(),
         entries: z.array(ProviderSnapshotEntrySchema),
         compactSnapshot: CompactProviderSnapshotSchema.optional(),
         snapshotHash: z.string().optional(),
@@ -4671,6 +4862,19 @@ export const HubExecutionAgentCreateResponseSchema = z.object({
         error: HubExecutionAgentCreateErrorSchema.nullable(),
     }),
 });
+export const HubExecutionAgentValidationIssueSchema = z.object({
+    path: z.array(z.union([z.string(), z.number()])),
+    message: z.string(),
+});
+export const HubExecutionAgentValidateResponseSchema = z.object({
+    type: z.literal("hub.execution.agent.validate.response"),
+    payload: z.object({
+        requestId: z.string(),
+        valid: z.boolean(),
+        issues: z.array(HubExecutionAgentValidationIssueSchema),
+        error: z.string().nullable(),
+    }),
+});
 export const HubExecutionControlResponseSchema = z.object({
     type: z.literal("hub.execution.control.response"),
     payload: z.object({
@@ -4699,6 +4903,7 @@ export const HubExecutionAgentStreamSchema = z.object({
 });
 export const HubExecutionOutboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateResponseSchema,
+    HubExecutionAgentValidateResponseSchema,
     HubExecutionControlResponseSchema,
     HubExecutionAgentUpdateSchema,
     HubExecutionAgentStreamSchema,
@@ -4723,6 +4928,7 @@ export function parseHubExecutionOutboundMessage(value) {
 }
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateResponseSchema,
+    HubExecutionAgentValidateResponseSchema,
     HubExecutionControlResponseSchema,
     HubExecutionAgentUpdateSchema,
     HubExecutionAgentStreamSchema,
@@ -4739,6 +4945,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     DictationStreamErrorMessageSchema,
     StatusMessageSchema,
     PongMessageSchema,
+    PushUnregisterResponseSchema,
     RpcErrorMessageSchema,
     ArtifactMessageSchema,
     AgentUpdateMessageSchema,
@@ -4795,6 +5002,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     SetAgentModelResponseMessageSchema,
     SetAgentThinkingResponseMessageSchema,
     SetAgentFeatureResponseMessageSchema,
+    AgentConfigApplyResponseMessageSchema,
     AgentDetachResponseMessageSchema,
     AgentRewindResponseMessageSchema,
     UpdateAgentResponseMessageSchema,
@@ -4821,6 +5029,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutPullResponseSchema,
     CheckoutPushResponseSchema,
     CheckoutRefreshResponseSchema,
+    CheckoutDiscardChangesResponseSchema,
     CheckoutPrCreateResponseSchema,
     CheckoutPrMergeResponseSchema,
     CheckoutForgeSetAutoMergeResponseSchema,
@@ -4848,6 +5057,10 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     FileSubscribeResponseSchema,
     FileUnsubscribeResponseSchema,
     FileWriteResponseSchema,
+    FileEntryCreateResponseSchema,
+    FileEntryRenameResponseSchema,
+    FileEntryDuplicateResponseSchema,
+    FileEntryDeleteResponseSchema,
     FileUpdateSchema,
     ProjectIconResponseSchema,
     ProjectIconGetResponseSchema,