@camerontaylor/paseo-protocol 0.8.0-fork.1 → 0.9.0-beta.2.fork.1

package/dist/messages.js

@@ -1,3 +1,9 @@
+import { AgentProfileSchema, AgentSkillSelectionSchema } from "./agent-profile.js";
+export { AgentProfileSchema, AgentSkillSelectionSchema, } from "./agent-profile.js";
+import { PluginIdSchema, PluginRequirementsSchema, PluginSourceSchema } from "./plugin-config.js";
+export { PluginIdSchema, PluginRequirementsSchema, DirectoryPluginSourceSchema, PluginSourceSchema, } from "./plugin-config.js";
+import { TerminalProfileSchema } from "./terminal-profile.js";
+export { TerminalProfileSchema } from "./terminal-profile.js";
 import { z } from "zod";
 import { TerminalActivitySchema } from "./terminal-activity.js";
 import { CLIENT_CAPS } from "./client-capabilities.js";
@@ -10,7 +16,7 @@ import { WORKSPACE_LABEL_COLORS } from "./workspace-labels.js";
 import { ChatCreateRequestSchema, ChatListRequestSchema, ChatInspectRequestSchema, ChatDeleteRequestSchema, ChatPostRequestSchema, ChatReadRequestSchema, ChatWaitRequestSchema, ChatCreateResponseSchema, ChatListResponseSchema, ChatInspectResponseSchema, ChatDeleteResponseSchema, ChatPostResponseSchema, ChatReadResponseSchema, ChatWaitResponseSchema, } from "./chat/rpc-schemas.js";
 import { ScheduleCreateRequestSchema, ScheduleListRequestSchema, ScheduleInspectRequestSchema, ScheduleLogsRequestSchema, SchedulePauseRequestSchema, ScheduleResumeRequestSchema, ScheduleDeleteRequestSchema, ScheduleRunOnceRequestSchema, ScheduleUpdateRequestSchema, ScheduleCreateResponseSchema, ScheduleListResponseSchema, ScheduleInspectResponseSchema, ScheduleLogsResponseSchema, SchedulePauseResponseSchema, ScheduleResumeResponseSchema, ScheduleDeleteResponseSchema, ScheduleRunOnceResponseSchema, ScheduleUpdateResponseSchema, } from "./schedule/rpc-schemas.js";
 import { LoopRunRequestSchema, LoopListRequestSchema, LoopInspectRequestSchema, LoopLogsRequestSchema, LoopStopRequestSchema, LoopRunResponseSchema, LoopListResponseSchema, LoopInspectResponseSchema, LoopLogsResponseSchema, LoopStopResponseSchema, } from "./loop/rpc-schemas.js";
-import { BrowserAutomationExecuteRequestSchema, BrowserAutomationExecuteResponseSchema, } from "./browser-automation/rpc-schemas.js";
+import { BROWSER_AUTOMATION_COMMAND_NAMES, BrowserAutomationExecuteRequestSchema, BrowserAutomationExecuteResponseSchema, } from "./browser-automation/rpc-schemas.js";
 import { BrowserAutomationHostCapabilitySchema } from "./browser-automation/capabilities.js";
 import { PaseoConfigRawSchema, PaseoLifecycleCommandRawSchema, PaseoMetadataGenerationEntrySchema, PaseoMetadataGenerationSchema, PaseoScriptEntryRawSchema, PaseoWorktreeConfigRawSchema, PaseoConfigRevisionSchema, ProjectConfigRpcErrorSchema, } from "./paseo-config-schema.js";
 export { PaseoConfigRawSchema, PaseoLifecycleCommandRawSchema, PaseoMetadataGenerationEntrySchema, PaseoMetadataGenerationSchema, PaseoScriptEntryRawSchema, PaseoWorktreeConfigRawSchema, };
@@ -56,41 +62,6 @@ const MutableMetadataGenerationConfigSchema = z
     providers: z.array(MutableStructuredGenerationProviderSchema).default([]),
 })
     .passthrough();
-export const TerminalProfileSchema = z
-    .object({
-    id: z.string(),
-    name: z.string(),
-    command: z.string(),
-    args: z.array(z.string()).optional(),
-    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),
@@ -101,21 +72,6 @@ const MutableRelayConfigSchema = z
     enabled: z.boolean(),
 })
     .passthrough();
-export const PluginIdSchema = z.string().regex(/^[a-z][a-z0-9-]*$/);
-// Semver validation belongs at the manifest/runtime boundary, not on the wire.
-export const PluginRequirementsSchema = z.object({ paseo: z.string().optional() });
-export const DirectoryPluginSourceSchema = z
-    .object({
-    source: z.literal("directory"),
-    path: z.string().min(1),
-    enabled: z.boolean().optional(),
-})
-    .strict();
-export const PluginSourceSchema = z.discriminatedUnion("source", [DirectoryPluginSourceSchema]);
-export const AgentSkillSelectionSchema = z.discriminatedUnion("mode", [
-    z.object({ mode: z.literal("all") }).strict(),
-    z.object({ mode: z.literal("custom"), skills: z.array(z.string()) }).strict(),
-]);
 export const MutableDaemonConfigSchema = z
     .object({
     // COMPAT(relayConfig): added in v0.2.6, remove after 2027-01-31 when old daemons are unsupported.
@@ -842,7 +798,7 @@ const WorkspaceLabelSyncCursorSchema = z.object({
 export const WorkspaceLabelListRequestSchema = z.object({
     type: z.literal("workspace.label.list.request"),
     requestId: z.string(),
-    subscribe: z.object({ subscriptionId: z.string() }),
+    subscribe: z.object({ subscriptionId: z.string().optional() }).optional(),
     sync: WorkspaceLabelSyncCursorSchema.optional(),
 });
 export const WorkspaceLabelAssignmentSetRequestSchema = z.object({
@@ -1127,9 +1083,8 @@ export const FetchAgentHistoryRequestMessageSchema = z.object({
     type: z.literal("fetch_agent_history_request"),
     requestId: z.string(),
     filter: AgentDirectoryFilterSchema.optional(),
-    // A ranked free-text query over agent title, workspace name, branch, and
-    // project name. Present only on history: agent subscriptions filter on
-    // structure, not on relevance. Ranking replaces `sort` when it is set.
+    // A free-text filter over agent title, workspace name, branch, and project name.
+    // Matching rows follow the requested sort and cursor pagination.
     search: z.string().optional(),
     sort: z
         .array(z.object({
@@ -1248,6 +1203,48 @@ export const PluginSourceInstallRequestSchema = z.object({
     // COMPAT(plugin-source-path): accepted for v0.7 clients; remove after 2027-09-01.
     pluginPath: z.string().min(1).optional(),
 });
+export const PluginSourceIdentitySchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("directory"), path: z.string() }),
+    z.object({ kind: z.literal("git"), remote: z.string(), pluginPath: z.string() }),
+    z.object({ kind: z.literal("npm"), packageName: z.string(), pluginPath: z.string() }),
+]);
+export const PluginInstallationSchema = z.object({
+    identity: PluginSourceIdentitySchema,
+    currentRevision: z.string().optional(),
+});
+export const PluginUpdateTargetSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("git"), commit: z.string().regex(/^[0-9a-f]{40,64}$/) }),
+    z.object({
+        kind: z.literal("npm"),
+        version: z.string().min(1),
+        resolved: z.string().url(),
+        integrity: z.string().min(1),
+    }),
+]);
+export const PluginUpdateProposalSchema = z.object({
+    id: PluginIdSchema,
+    expected: z.object({
+        identity: PluginSourceIdentitySchema,
+        installationRoot: z.string(),
+        revision: z.string(),
+    }),
+    target: PluginUpdateTargetSchema,
+});
+export const PluginUpdateSelectionSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("git"), ref: z.string().min(1) }),
+    z.object({ kind: z.literal("npm"), version: z.string().min(1) }),
+]);
+export const PluginUpdatePreviewRequestSchema = z.object({
+    type: z.literal("plugin.source.update.preview.request"),
+    requestId: z.string(),
+    pluginId: PluginIdSchema.optional(),
+    target: PluginUpdateSelectionSchema.optional(),
+});
+export const PluginUpdateApplyRequestSchema = z.object({
+    type: z.literal("plugin.source.update.apply.request"),
+    requestId: z.string(),
+    proposals: z.array(PluginUpdateProposalSchema).min(1),
+});
 export const PluginSourceStatusRequestSchema = z.object({
     type: z.literal("plugin.source.status.request"),
     requestId: z.string(),
@@ -1536,6 +1533,13 @@ export const FetchAgentTimelineRequestMessageSchema = z.object({
     // Allow the client to merge this bounded page outside its contiguous loaded range.
     mergeWindow: z.boolean().optional(),
 });
+export const AgentTimelineSearchRequestMessageSchema = z.object({
+    type: z.literal("agent.timeline.search.request"),
+    agentId: z.string(),
+    requestId: z.string(),
+    query: z.string(),
+    cursor: z.number().int().nonnegative().optional(),
+});
 export const AgentTimelineListPromptsRequestMessageSchema = z.object({
     type: z.literal("agent.timeline.list_prompts.request"),
     agentId: z.string(),
@@ -1815,7 +1819,13 @@ export const CheckoutStatusRequestSchema = z.object({
 });
 export const SubscribeCheckoutDiffRequestSchema = z.object({
     type: z.literal("subscribe_checkout_diff_request"),
-    subscriptionId: z.string(),
+    subscriptionId: z.string().optional(),
+    cwd: z.string(),
+    compare: CheckoutDiffCompareSchema,
+    requestId: z.string(),
+});
+export const CheckoutDiffGetRequestSchema = z.object({
+    type: z.literal("checkout.diff.get.request"),
     cwd: z.string(),
     compare: CheckoutDiffCompareSchema,
     requestId: z.string(),
@@ -2330,7 +2340,7 @@ export const FileSubscribeRequestSchema = z.object({
     type: z.literal("fs.file.subscribe.request"),
     cwd: z.string(),
     path: z.string(),
-    subscriptionId: z.string(),
+    subscriptionId: z.string().optional(),
     requestId: z.string(),
 });
 export const FileUnsubscribeRequestSchema = z.object({
@@ -2463,6 +2473,7 @@ export const ListTerminalsRequestSchema = z.object({
 });
 export const SubscribeTerminalsRequestSchema = z.object({
     type: z.literal("subscribe_terminals_request"),
+    requestId: z.string().optional(),
     cwd: z.string(),
     workspaceId: z.string().optional(),
 });
@@ -2637,17 +2648,53 @@ export const SessionEventSubscriptionSchema = z.enum([
     "agent_attention_required",
     "agent_permission_request",
     "agent_permission_resolved",
+    "checkout_status_update",
+    "script_status_update",
+    "workspace_setup_progress",
+    "agent.provider_subagents.update",
+    "agent.side_conversation.update",
+    "agent.side_conversation.removed",
+    "terminal_attention_required",
+    "status.server_info",
+    "status.daemon_config_changed",
+    "status.plugin_catalog_changed",
+    "status.plugin_settings_changed",
+    "activity_log",
+    "hub.execution.agent.update",
+    "hub.execution.agent.stream",
 ]);
 export const SessionEventsSetSubscriptionRequestSchema = z.object({
     type: z.literal("session.events.set_subscription.request"),
     requestId: z.string(),
     events: z.array(SessionEventSubscriptionSchema),
+    notifications: z.boolean().optional(),
 });
 export const SessionEventsSetSubscriptionResponseSchema = z.object({
     type: z.literal("session.events.set_subscription.response"),
-    payload: z.object({ requestId: z.string() }),
+    payload: z.object({ requestId: z.string(), subscriptionId: z.string().optional() }),
+});
+export const BrowserHostRegisterRequestSchema = z.object({
+    type: z.literal("browser.host.register.request"),
+    requestId: z.string(),
+    hostKind: z.string().min(1),
+    supportedCommands: z.array(z.enum(BROWSER_AUTOMATION_COMMAND_NAMES)).min(1),
+});
+export const BrowserHostRegisterResponseSchema = z.object({
+    type: z.literal("browser.host.register.response"),
+    payload: z.object({ requestId: z.string(), subscriptionId: z.string() }),
+});
+export const SubscriptionReleaseRequestSchema = z.object({
+    type: z.literal("subscription.release.request"),
+    requestId: z.string(),
+    subscriptionId: z.string(),
+});
+export const SubscriptionReleaseResponseSchema = z.object({
+    type: z.literal("subscription.release.response"),
+    payload: z.object({ requestId: z.string(), subscriptionId: z.string() }),
 });
 export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
+    BrowserHostRegisterRequestSchema,
+    SubscriptionReleaseRequestSchema,
     SessionEventsSetSubscriptionRequestSchema,
     HubExecutionAgentCreateRequestSchema,
     HubExecutionAgentValidateRequestSchema,
@@ -2697,6 +2744,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     PluginSourceInstallRequestSchema,
     PluginSourceStatusRequestSchema,
     PluginSourceUpdateRequestSchema,
+    PluginUpdatePreviewRequestSchema,
+    PluginUpdateApplyRequestSchema,
     PluginReloadRequestSchema,
     PluginEnableRequestSchema,
     PluginDisableRequestSchema,
@@ -2733,6 +2782,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     RestartServerRequestMessageSchema,
     DaemonUpdateRequestMessageSchema,
     FetchAgentTimelineRequestMessageSchema,
+    AgentTimelineSearchRequestMessageSchema,
     AgentTimelineListPromptsRequestMessageSchema,
     ProviderSubagentListRequestMessageSchema,
     ProviderSubagentTimelineRequestMessageSchema,
@@ -2750,6 +2800,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     AgentRewindRequestMessageSchema,
     AgentPermissionResponseMessageSchema,
     CheckoutStatusRequestSchema,
+    CheckoutDiffGetRequestSchema,
     SubscribeCheckoutDiffRequestSchema,
     UnsubscribeCheckoutDiffRequestSchema,
     CheckoutCommitRequestSchema,
@@ -2855,6 +2906,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
 // Session Outbound Messages (Session emits these)
 // ============================================================================
 export const ActivityLogPayloadSchema = z.object({
+    subscriptionId: z.string().optional(),
     id: z.string(),
     timestamp: z.coerce.date(),
     type: z.enum(["transcript", "assistant", "tool_call", "tool_result", "error", "system"]),
@@ -3051,6 +3103,10 @@ export const ServerInfoStatusPayloadSchema = z
         pluginLogs: z.boolean().optional(),
         // COMPAT(pluginGitManagement): added in v0.7.0, remove gate after 2027-08-26.
         pluginGitManagement: z.boolean().optional(),
+        // COMPAT(pluginSourceInstallation): added in v0.8.0; remove gate after 2027-03-16 once daemon floor supports source identifiers.
+        pluginSourceInstallation: z.boolean().optional(),
+        // COMPAT(pluginSourceUpdates): added in v0.8.0; remove gate after 2027-03-16 once daemon floor supports reviewed updates.
+        pluginSourceUpdates: z.boolean().optional(),
         // COMPAT(pluginThemes): added in v0.5.0, remove gate after 2027-08-20.
         // A daemon that predates this flag keeps `addTheme` in the server bundle it compiles,
         // so a theme plugin cannot start there at all.
@@ -3101,6 +3157,8 @@ export const ServerInfoStatusPayloadSchema = z
         agentForkContextCursor: z.boolean().optional(),
         // COMPAT(providerSubagents): added in v0.1.107, remove gate after 2027-01-12.
         providerSubagents: z.boolean().optional(),
+        // COMPAT(projectedSubagentTimeline): added after v0.8.0, remove gates after 2027-03-14; retain wire field.
+        projectedSubagentTimeline: z.boolean().optional(),
         // COMPAT(providerSubagentNesting): added in v0.7, remove gate after 2027-03-04.
         providerSubagentNesting: z.boolean().optional(),
         // COMPAT(sideConversations): added in 0.7.0-beta.2.fork.1, fork-only — stock peers never gain it, so the gate lasts as long as stock peers are supported.
@@ -3142,6 +3200,7 @@ export const ServerInfoStatusPayloadSchema = z
         // COMPAT(selectiveAgentTimeline): added in v0.1.106, remove after 2027-01-12.
         selectiveAgentTimeline: z.boolean().optional(),
         explicitEventSubscriptions: z.boolean().optional(),
+        ownedSubscriptions: z.boolean().optional(),
         // COMPAT(canonicalSubmittedPrompts): added in v0.2.6, remove gate after 2027-01-30.
         canonicalSubmittedPrompts: z.boolean().optional(),
         // COMPAT(agentTurnIdentity): accept peers that observed pre-release v0.2.6 through 2027-01-31.
@@ -3479,6 +3538,7 @@ export const AgentUpdateMessageSchema = z.object({
     type: z.literal("agent_update"),
     payload: z.discriminatedUnion("kind", [
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("upsert"),
             agent: AgentSnapshotPayloadSchema,
             project: ProjectPlacementPayloadSchema.nullable().optional(),
@@ -3486,6 +3546,7 @@ export const AgentUpdateMessageSchema = z.object({
             seq: z.number().int().positive().optional(),
         }),
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("remove"),
             agentId: z.string(),
             generation: z.string().optional(),
@@ -3496,6 +3557,7 @@ export const AgentUpdateMessageSchema = z.object({
 export const AgentStreamMessageSchema = z.object({
     type: z.literal("agent_stream"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         agentId: z.string(),
         event: AgentStreamEventPayloadSchema,
         timestamp: z.string(),
@@ -3529,13 +3591,10 @@ export const AgentSearchMatchSchema = z.object({
 const AgentDirectoryResponseEntrySchema = z.object({
     agent: AgentSnapshotPayloadSchema,
     project: ProjectPlacementPayloadSchema,
-    // Relevance of this entry to the request's `search`, lower being better.
-    // Set only when the request carried a query; a client merging results from
-    // several hosts needs it to interleave their separately ranked pages.
+    // Legacy relevance metadata remains accepted from older daemons.
+    // Current history responses use the requested chronological sort.
     searchScore: z.number().optional(),
-    // Where the query matched, so the row can mark it. The ranker computes this
-    // anyway; sending it keeps the client from re-deriving a second opinion that
-    // could disagree with the ranking it is explaining.
+    // Legacy server-generated highlights. Current clients highlight displayed text locally.
     searchMatches: z.array(AgentSearchMatchSchema).optional(),
     // COMPAT(directorySync): sequence of this latest directory projection.
     syncSeq: z.number().int().positive().optional(),
@@ -3561,9 +3620,7 @@ export const FetchAgentHistoryResponseMessageSchema = z.object({
         requestId: z.string(),
         entries: z.array(AgentDirectoryResponseEntrySchema),
         pageInfo: AgentDirectoryPageInfoSchema,
-        // More sessions matched the request's `search` than the page could hold.
-        // Distinct from `pageInfo.hasMore`, which promises a fetchable next page —
-        // a ranked result set has none, and the way on is a narrower query.
+        // Older daemons truncate relevance-ranked searches instead of returning a cursor.
         searchTruncated: z.boolean().optional(),
     }),
 });
@@ -3624,12 +3681,14 @@ export const WorkspaceUpdateMessageSchema = z.object({
     type: z.literal("workspace_update"),
     payload: z.discriminatedUnion("kind", [
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("upsert"),
             workspace: WorkspaceDescriptorPayloadSchema,
             generation: z.string().optional(),
             seq: z.number().int().positive().optional(),
         }),
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("remove"),
             id: z.string(),
             // COMPAT(workspaceProjects): added in v0.1.97, drop the optional gate when floor >= v0.1.97.
@@ -3657,6 +3716,7 @@ export const WorkspaceLabelListResponseSchema = z.object({
     type: z.literal("workspace.label.list.response"),
     payload: z.object({
         requestId: z.string(),
+        subscriptionId: z.string().optional(),
         labels: z.array(WorkspaceLabelDefinitionSchema),
         sync: WorkspaceLabelSyncMetadataSchema,
     }),
@@ -3665,6 +3725,7 @@ export const WorkspaceLabelUpdateSchema = z.object({
     type: z.literal("workspace.label.update"),
     payload: z.discriminatedUnion("kind", [
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("upsert"),
             label: WorkspaceLabelDefinitionSchema,
             previousName: z.string().optional(),
@@ -3672,6 +3733,7 @@ export const WorkspaceLabelUpdateSchema = z.object({
             seq: z.number().int().positive(),
         }),
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("remove"),
             name: z.string(),
             generation: z.string(),
@@ -3713,12 +3775,14 @@ export const ProjectUpdateMessageSchema = z.object({
     type: z.literal("project.update"),
     payload: z.discriminatedUnion("kind", [
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("upsert"),
             project: WorkspaceProjectDescriptorPayloadSchema,
             generation: z.string().optional(),
             seq: z.number().int().positive().optional(),
         }),
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("remove"),
             projectId: z.string(),
             generation: z.string().optional(),
@@ -3737,6 +3801,7 @@ export const ProjectListResponseMessageSchema = z.object({
 export const ScriptStatusUpdateMessageSchema = z.object({
     type: z.literal("script_status_update"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         workspaceId: z.string(),
         scripts: z.array(WorkspaceScriptPayloadSchema),
     }),
@@ -3744,6 +3809,7 @@ export const ScriptStatusUpdateMessageSchema = z.object({
 export const WorkspaceSetupProgressMessageSchema = z.object({
     type: z.literal("workspace_setup_progress"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         workspaceId: z.string(),
         status: z.enum(["running", "completed", "failed", "blocked"]),
         detail: WorktreeSetupDetailPayloadSchema,
@@ -3981,8 +4047,20 @@ export const FetchAgentTimelineResponseMessageSchema = z.object({
 export const AgentTimelineReplacementMessageSchema = z.object({
     type: z.literal("agent.timeline.replacement"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
+        agentId: z.string(),
+        epoch: z.string(),
+    }),
+});
+export const AgentTimelineSearchResponseMessageSchema = z.object({
+    type: z.literal("agent.timeline.search.response"),
+    payload: z.object({
+        requestId: z.string(),
         agentId: z.string(),
         epoch: z.string(),
+        locations: z.array(z.object({ seq: z.number().int().nonnegative(), role: z.enum(["user", "assistant"]) })),
+        nextCursor: z.number().int().nonnegative().nullable(),
+        error: z.string().nullable(),
     }),
 });
 export const AgentTimelineListPromptsResponseMessageSchema = z.object({
@@ -4034,6 +4112,9 @@ export const ProviderSubagentTimelineResponseMessageSchema = z.object({
         provider: AgentProviderSchema.nullable(),
         direction: z.enum(["tail", "before", "after"]),
         epoch: z.string(),
+        projection: z.literal("projected").optional(),
+        startCursor: AgentTimelineCursorSchema.nullable().optional(),
+        endCursor: AgentTimelineCursorSchema.nullable().optional(),
         reset: z.boolean(),
         staleCursor: z.boolean(),
         gap: z.boolean(),
@@ -4048,6 +4129,14 @@ export const ProviderSubagentTimelineResponseMessageSchema = z.object({
             item: AgentTimelineItemPayloadSchema,
             timestamp: z.string(),
             seq: z.number().int().nonnegative(),
+            seqStart: z.number().int().nonnegative().optional(),
+            seqEnd: z.number().int().nonnegative().optional(),
+            sourceSeqRanges: z
+                .array(z.object({
+                startSeq: z.number().int().nonnegative(),
+                endSeq: z.number().int().nonnegative(),
+            }))
+                .optional(),
         })),
         error: z.string().nullable(),
     }),
@@ -4056,10 +4145,12 @@ export const ProviderSubagentUpdateMessageSchema = z.object({
     type: z.literal("agent.provider_subagents.update"),
     payload: z.discriminatedUnion("kind", [
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("upsert"),
             subagent: ProviderSubagentDescriptorPayloadSchema,
         }),
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("timeline"),
             parentAgentId: z.string(),
             subagentId: z.string(),
@@ -4070,6 +4161,7 @@ export const ProviderSubagentUpdateMessageSchema = z.object({
             epoch: z.string(),
         }),
         z.object({
+            subscriptionId: z.string().optional(),
             kind: z.literal("remove"),
             parentAgentId: z.string(),
             subagentId: z.string(),
@@ -4146,6 +4238,7 @@ export const SideConversationRemovedMessageSchema = z.object({
 export const SetAgentTimelineSubscriptionResponseMessageSchema = z.object({
     type: z.literal("agent.timeline.set_subscription.response"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         agentIds: z.array(z.string()),
         requestId: z.string(),
     }),
@@ -4153,6 +4246,7 @@ export const SetAgentTimelineSubscriptionResponseMessageSchema = z.object({
 export const AgentAttentionRequiredMessageSchema = z.object({
     type: z.literal("agent_attention_required"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         agentId: z.string(),
         reason: z.enum(["finished", "error", "permission"]),
         timestamp: z.string(),
@@ -4224,7 +4318,7 @@ export const CreationSnapshotSchema = z.object({
 });
 export const WorkspaceCreationUpdateSchema = z.object({
     type: z.literal("workspace.create.update"),
-    payload: CreationSnapshotSchema,
+    payload: CreationSnapshotSchema.extend({ subscriptionId: z.string().optional() }),
 });
 export const AgentCreationUpdateSchema = WorkspaceCreationUpdateSchema.extend({
     type: z.literal("agent.create.update"),
@@ -4233,6 +4327,7 @@ export const CreationSubscribeResponseSchema = z.object({
     type: z.literal("creation.subscribe.response"),
     payload: z.object({
         requestId: z.string(),
+        subscriptionId: z.string().optional(),
         snapshot: CreationSnapshotSchema.nullable(),
         error: z.string().nullable(),
     }),
@@ -4462,6 +4557,7 @@ export const WriteProjectConfigResponseMessageSchema = z.object({
 export const AgentPermissionRequestMessageSchema = z.object({
     type: z.literal("agent_permission_request"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         agentId: z.string(),
         request: AgentPermissionRequestPayloadSchema,
     }),
@@ -4469,6 +4565,7 @@ export const AgentPermissionRequestMessageSchema = z.object({
 export const AgentPermissionResolvedMessageSchema = z.object({
     type: z.literal("agent_permission_resolved"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         agentId: z.string(),
         requestId: z.string(),
         resolution: AgentPermissionResponseSchema,
@@ -4677,6 +4774,7 @@ const CheckoutPrStatusPayloadSchema = z.object({
     requestId: z.string(),
 });
 const CheckoutStatusUpdateMetadataSchema = z.object({
+    subscriptionId: z.string().optional(),
     prStatus: CheckoutPrStatusPayloadSchema.optional(),
 });
 export const CheckoutStatusUpdateSchema = z.object({
@@ -4703,6 +4801,12 @@ export const SubscribeCheckoutDiffResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const CheckoutDiffGetResponseSchema = z.object({
+    type: z.literal("checkout.diff.get.response"),
+    payload: CheckoutDiffSubscriptionPayloadSchema.omit({ subscriptionId: true }).extend({
+        requestId: z.string(),
+    }),
+});
 export const CheckoutDiffUpdateSchema = z.object({
     type: z.literal("checkout_diff_update"),
     payload: CheckoutDiffSubscriptionPayloadSchema,
@@ -5392,6 +5496,7 @@ export const GetProvidersSnapshotResponseMessageSchema = z.object({
 export const ProvidersSnapshotUpdateMessageSchema = z.object({
     type: z.literal("providers_snapshot_update"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         cwd: z.string().optional(),
         entries: z.array(ProviderSnapshotEntrySchema),
         compactSnapshot: CompactProviderSnapshotSchema.optional(),
@@ -5541,6 +5646,9 @@ export const ListTerminalsResponseSchema = z.object({
 export const TerminalsChangedSchema = z.object({
     type: z.literal("terminals_changed"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
+        requestId: z.string().optional(),
+        workspaceId: z.string().optional(),
         cwd: z.string(),
         terminals: z.array(TerminalInfoSchema.omit({ cwd: true })),
     }),
@@ -5567,6 +5675,7 @@ export const SubscribeTerminalResponseSchema = z.object({
         z.object({
             terminalId: z.string(),
             slot: z.number().int().min(0).max(255),
+            subscriptionId: z.string().optional(),
             error: z.null(),
             requestId: z.string(),
         }),
@@ -5597,12 +5706,16 @@ export const CaptureTerminalResponseSchema = z.object({
 export const TerminalStreamExitSchema = z.object({
     type: z.literal("terminal_stream_exit"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         terminalId: z.string(),
+        // Observation failure; the underlying terminal process may still be running.
+        error: z.string().optional(),
     }),
 });
 export const TerminalAttentionRequiredSchema = z.object({
     type: z.literal("terminal_attention_required"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         serverId: z.string().optional(),
         terminalId: z.string(),
         cwd: z.string(),
@@ -5668,6 +5781,7 @@ export const HubExecutionControlResponseSchema = z.object({
 export const HubExecutionAgentUpdateSchema = z.object({
     type: z.literal("hub.execution.agent.update"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         executionId: z.string(),
         agentId: z.string(),
         agent: AgentSnapshotPayloadSchema,
@@ -5676,6 +5790,7 @@ export const HubExecutionAgentUpdateSchema = z.object({
 export const HubExecutionAgentStreamSchema = z.object({
     type: z.literal("hub.execution.agent.stream"),
     payload: z.object({
+        subscriptionId: z.string().optional(),
         executionId: z.string(),
         agentId: z.string(),
         event: AgentStreamEventPayloadSchema,
@@ -5718,12 +5833,21 @@ export const PluginCatalogGetResponseSchema = z.object({
     }),
 });
 export const PluginStatusSchema = z.enum(["running", "disabled", "failed"]);
+export const PluginNpmInstallationSchema = z.object({
+    packageName: z.string(),
+    requestedSpec: z.string(),
+    version: z.string(),
+    integrity: z.string(),
+});
 export const PluginListItemSchema = z.object({
     id: PluginIdSchema,
+    description: z.string().optional(),
     path: z.string(),
     enabled: z.boolean(),
     status: PluginStatusSchema,
     source: z.enum(["directory", "git"]).optional(),
+    npm: PluginNpmInstallationSchema.optional(),
+    installation: PluginInstallationSchema.optional(),
     remote: z.string().optional(),
     ref: z.string().optional(),
     commit: z.string().optional(),
@@ -5762,6 +5886,8 @@ export const PluginSourceInstallResponseSchema = z.object({
 export const PluginSourceStatusItemSchema = z.object({
     id: PluginIdSchema,
     source: z.enum(["directory", "git"]),
+    npm: PluginNpmInstallationSchema.optional(),
+    installation: PluginInstallationSchema.optional(),
     path: z.string(),
     remote: z.string().optional(),
     ref: z.string().optional(),
@@ -5785,6 +5911,30 @@ export const PluginSourceUpdateResponseSchema = z.object({
     type: z.literal("plugin.source.update.response"),
     payload: z.object({ requestId: z.string(), plugins: z.array(PluginSourceUpdateItemSchema) }),
 });
+export const PluginUpdatePreviewSchema = z.object({
+    id: PluginIdSchema,
+    outcome: z.enum(["update", "current", "installed-newer", "local", "error"]),
+    current: PluginInstallationSchema.optional(),
+    target: PluginUpdateTargetSchema.optional(),
+    links: z.array(z.string()),
+    proposal: PluginUpdateProposalSchema.optional(),
+    error: z.string().optional(),
+});
+export const PluginUpdateResultSchema = z.object({
+    id: PluginIdSchema,
+    outcome: z.enum(["updated", "error"]),
+    plugin: PluginListItemSchema.optional(),
+    error: z.string().optional(),
+    warning: z.string().optional(),
+});
+export const PluginUpdatePreviewResponseSchema = z.object({
+    type: z.literal("plugin.source.update.preview.response"),
+    payload: z.object({ requestId: z.string(), plugins: z.array(PluginUpdatePreviewSchema) }),
+});
+export const PluginUpdateApplyResponseSchema = z.object({
+    type: z.literal("plugin.source.update.apply.response"),
+    payload: z.object({ requestId: z.string(), plugins: z.array(PluginUpdateResultSchema) }),
+});
 function pluginActionResponse(type) {
     return z.object({
         type: z.literal(type),
@@ -5835,6 +5985,8 @@ export const AgentSkillsImportLegacySelectionResponseSchema = z.object({
     }),
 });
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
+    BrowserHostRegisterResponseSchema,
+    SubscriptionReleaseResponseSchema,
     SessionEventsSetSubscriptionResponseSchema,
     HubExecutionAgentCreateResponseSchema,
     HubExecutionAgentValidateResponseSchema,
@@ -5850,6 +6002,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     PluginSourceInstallResponseSchema,
     PluginSourceStatusResponseSchema,
     PluginSourceUpdateResponseSchema,
+    PluginUpdatePreviewResponseSchema,
+    PluginUpdateApplyResponseSchema,
     PluginReloadResponseSchema,
     PluginEnableResponseSchema,
     PluginDisableResponseSchema,
@@ -5911,6 +6065,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     FetchAgentResponseMessageSchema,
     FetchAgentTimelineResponseMessageSchema,
     AgentTimelineReplacementMessageSchema,
+    AgentTimelineSearchResponseMessageSchema,
     AgentTimelineListPromptsResponseMessageSchema,
     ProviderSubagentListResponseMessageSchema,
     ProviderSubagentTimelineResponseMessageSchema,
@@ -5969,6 +6124,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     CloseItemsResponseSchema,
     CheckoutStatusResponseSchema,
     CheckoutStatusUpdateSchema,
+    CheckoutDiffGetResponseSchema,
     SubscribeCheckoutDiffResponseSchema,
     CheckoutDiffUpdateSchema,
     CheckoutCommitResponseSchema,