@getpaseo/protocol 0.4.0 → 0.5.0-beta.2

package/dist/messages.js

@@ -5,6 +5,7 @@ import { AGENT_LIFECYCLE_STATUSES } from "./agent-lifecycle.js";
 import { MAX_EXPLICIT_AGENT_TITLE_CHARS } from "./agent-title-limits.js";
 import { AgentProviderSchema } from "./provider-manifest.js";
 import { TOOL_CALL_ICON_NAMES } from "./agent-types.js";
+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";
@@ -86,15 +87,45 @@ const MutableRelayConfigSchema = z
     enabled: z.boolean(),
 })
     .passthrough();
+export const PluginIdSchema = z.string().regex(/^[a-z][a-z0-9-]*$/);
+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.
     relay: MutableRelayConfigSchema.optional(),
     mcp: z
         .object({
+        enabled: z.boolean().optional(),
         injectIntoAgents: z.boolean(),
     })
         .passthrough(),
+    hostnames: z.union([z.literal(true), z.array(z.string())]).optional(),
+    cors: z
+        .object({
+        allowedOrigins: z.array(z.string()),
+    })
+        .passthrough()
+        .optional(),
+    trustedProxies: z.union([z.literal(true), z.array(z.string())]).optional(),
+    git: z
+        .object({
+        maxProcessesPerSecond: z.number().int().positive(),
+        maxProcessConcurrency: z.number().int().positive(),
+    })
+        .optional(),
+    app: z.object({ baseUrl: z.string() }).optional(),
+    catalogRefreshTimeoutMs: z.number().int().positive().optional(),
     browserTools: MutableBrowserToolsConfigSchema.default({ enabled: false }),
     providers: z.record(z.string(), MutableDaemonProviderConfigSchema).default({}),
     metadataGeneration: MutableMetadataGenerationConfigSchema.default({ providers: [] }),
@@ -103,12 +134,15 @@ export const MutableDaemonConfigSchema = z
     appendSystemPrompt: z.string().default(""),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
     agentProfiles: z.array(AgentProfileSchema).optional(),
+    skills: z.object({ selection: AgentSkillSelectionSchema.optional() }).strict().optional(),
+    pluginsEnabled: z.boolean().optional(),
+    plugins: z.record(PluginIdSchema, PluginSourceSchema).optional(),
 })
     .passthrough();
 export const MutableDaemonConfigPatchSchema = z
     .object({
     relay: MutableRelayConfigSchema.partial().optional(),
-    mcp: MutableDaemonConfigSchema.shape.mcp.partial().optional(),
+    mcp: z.object({ injectIntoAgents: z.boolean().optional() }).passthrough().optional(),
     browserTools: MutableBrowserToolsConfigSchema.partial().optional(),
     providers: z
         .record(z.string(), MutableDaemonProviderConfigSchema.partial().passthrough())
@@ -120,6 +154,8 @@ export const MutableDaemonConfigPatchSchema = z
     appendSystemPrompt: z.string().optional(),
     terminalProfiles: z.array(TerminalProfileSchema).optional(),
     agentProfiles: z.array(AgentProfileSchema).optional(),
+    pluginsEnabled: z.boolean().optional(),
+    plugins: z.record(PluginIdSchema, PluginSourceSchema).optional(),
 })
     .partial()
     .passthrough();
@@ -554,6 +590,7 @@ export const AgentStreamEventPayloadSchema = z.discriminatedUnion("type", [
         type: z.literal("timeline"),
         provider: AgentProviderSchema,
         item: AgentTimelineItemPayloadSchema,
+        turnId: z.string().optional(),
     }),
     z.object({
         type: z.literal("permission_requested"),
@@ -750,6 +787,50 @@ export const WorkspacePinSetRequestSchema = z.object({
     pinned: z.boolean(),
     requestId: z.string(),
 });
+export const WorkspaceLabelColorSchema = z.enum(WORKSPACE_LABEL_COLORS);
+export const WorkspaceLabelDefinitionSchema = z.object({
+    name: z.string(),
+    color: WorkspaceLabelColorSchema,
+});
+const WorkspaceLabelSyncCursorSchema = z.object({
+    generation: z.string(),
+    afterSeq: z.number().int().nonnegative(),
+});
+export const WorkspaceLabelListRequestSchema = z.object({
+    type: z.literal("workspace.label.list.request"),
+    requestId: z.string(),
+    subscribe: z.object({ subscriptionId: z.string() }),
+    sync: WorkspaceLabelSyncCursorSchema.optional(),
+});
+export const WorkspaceLabelAssignmentSetRequestSchema = z.object({
+    type: z.literal("workspace.label.assignment.set.request"),
+    requestId: z.string(),
+    workspaceId: z.string(),
+    label: WorkspaceLabelDefinitionSchema,
+    assigned: z.boolean(),
+});
+/**
+ * Editing a label is one operation. A name and a colour are two fields of one thing, and two
+ * RPCs can land half-applied — leaving the catalog in a state the user never asked for and the
+ * UI with nothing true to say. Both fields are optional; omitting one leaves it alone.
+ */
+export const WorkspaceLabelUpdateRequestSchema = z.object({
+    type: z.literal("workspace.label.update.request"),
+    requestId: z.string(),
+    name: z.string(),
+    newName: z.string().optional(),
+    color: WorkspaceLabelColorSchema.optional(),
+});
+export const WorkspaceLabelDeleteRequestSchema = z.object({
+    type: z.literal("workspace.label.delete.request"),
+    requestId: z.string(),
+    name: z.string(),
+});
+export const WorkspaceLabelDeleteInspectRequestSchema = z.object({
+    type: z.literal("workspace.label.delete.inspect.request"),
+    requestId: z.string(),
+    name: z.string(),
+});
 export const WorkspaceRecoveryInspectRequestSchema = z.object({
     type: z.literal("workspace.recovery.inspect.request"),
     workspaceId: z.string(),
@@ -806,6 +887,15 @@ export const ForgeIssueAttachmentSchema = z.object({
     body: z.string().nullable().optional(),
     projectPath: z.string().optional(),
 });
+export const ExternalResourceAttachmentMetadataSchema = z.object({
+    provider: z.string(),
+    providerLabel: z.string(),
+    resourceType: z.string(),
+    id: z.string(),
+    identifier: z.string(),
+    title: z.string(),
+    url: z.string(),
+});
 export const TextAttachmentSchema = z
     .object({
     type: z.literal("text"),
@@ -813,6 +903,7 @@ export const TextAttachmentSchema = z
     contextKind: z.string().optional(),
     title: z.string().nullable().optional(),
     text: z.string(),
+    externalResource: ExternalResourceAttachmentMetadataSchema.optional(),
 })
     .transform(({ contextKind, ...attachment }) => ({
     ...attachment,
@@ -884,17 +975,36 @@ const ImageAttachmentSchema = z.object({
     data: z.string(), // base64 encoded image
     mimeType: z.string(), // e.g., "image/jpeg", "image/png"
 });
+export const ActiveTurnBehaviorSchema = z.enum(["interrupt", "steer"]);
 export const SendAgentMessageSchema = z.object({
     type: z.literal("send_agent_message"),
     agentId: z.string(),
     text: z.string(),
     messageId: z.string().optional(), // Client-provided ID for deduplication
+    activeTurnBehavior: ActiveTurnBehaviorSchema.optional(),
     images: z.array(ImageAttachmentSchema).optional(),
     attachments: AgentAttachmentsSchema,
 });
 // ============================================================================
 // Agent RPCs (requestId-correlated)
 // ============================================================================
+const DirectorySyncRequestSchema = z.object({
+    generation: z.string().optional(),
+    afterSeq: z.number().int().nonnegative().optional(),
+});
+const DirectorySyncRemovalSchema = z.object({
+    id: z.string(),
+    seq: z.number().int().positive(),
+});
+const DirectorySyncMetadataSchema = z.object({
+    generation: z.string(),
+    headSeq: z.number().int().nonnegative(),
+    mode: z.enum(["snapshot", "changes"]),
+    reason: z
+        .enum(["no_cursor", "generation_changed", "cursor_expired", "changes_too_large"])
+        .optional(),
+    removals: z.array(DirectorySyncRemovalSchema),
+});
 export const FetchAgentsRequestMessageSchema = z.object({
     type: z.literal("fetch_agents_request"),
     requestId: z.string(),
@@ -917,6 +1027,8 @@ export const FetchAgentsRequestMessageSchema = z.object({
         subscriptionId: z.string().optional(),
     })
         .optional(),
+    // COMPAT(directorySync): added in v0.3.x, remove optional after 2027-02-12.
+    sync: DirectorySyncRequestSchema.optional(),
 });
 const WorkspaceStateBucketSchema = z.enum([
     "needs_input",
@@ -953,10 +1065,14 @@ export const FetchWorkspacesRequestMessageSchema = z.object({
         subscriptionId: z.string().optional(),
     })
         .optional(),
+    // COMPAT(directorySync): added in v0.3.x, remove optional after 2027-02-12.
+    sync: DirectorySyncRequestSchema.optional(),
 });
 export const ProjectListRequestMessageSchema = z.object({
     type: z.literal("project.list.request"),
     requestId: z.string(),
+    // COMPAT(directorySync): added in v0.3.x, remove optional after 2027-02-12.
+    sync: DirectorySyncRequestSchema.optional(),
 });
 export const FetchAgentHistoryRequestMessageSchema = z.object({
     type: z.literal("fetch_agent_history_request"),
@@ -1000,6 +1116,7 @@ export const SendAgentMessageRequestSchema = z.object({
     agentId: z.string(),
     text: z.string(),
     messageId: z.string().optional(), // Client-provided ID for deduplication
+    activeTurnBehavior: ActiveTurnBehaviorSchema.optional(),
     images: z.array(ImageAttachmentSchema).optional(),
     attachments: AgentAttachmentsSchema,
 });
@@ -1018,6 +1135,10 @@ export const DaemonGetPairingOfferRequestSchema = z.object({
     type: z.literal("daemon.get_pairing_offer.request"),
     requestId: z.string(),
 });
+export const DaemonConfigReloadRequestSchema = z.object({
+    type: z.literal("daemon.config.reload.request"),
+    requestId: z.string(),
+});
 export const HubManagementDaemonConnectRequestSchema = z.object({
     type: z.literal("hub.management.daemon.connect.request"),
     requestId: z.string(),
@@ -1037,6 +1158,81 @@ export const DiagnosticsRequestSchema = z.object({
     type: z.literal("diagnostics.request"),
     requestId: z.string(),
 });
+export const PluginCatalogGetRequestSchema = z.object({
+    type: z.literal("plugin.catalog.get.request"),
+    requestId: z.string(),
+});
+export const PluginListRequestSchema = z.object({
+    type: z.literal("plugin.list.request"),
+    requestId: z.string(),
+});
+export const PluginLogsGetRequestSchema = z.object({
+    type: z.literal("plugin.logs.get.request"),
+    requestId: z.string(),
+    pluginId: PluginIdSchema,
+});
+export const PluginDirectoryInstallRequestSchema = z.object({
+    type: z.literal("plugin.directory.install.request"),
+    requestId: z.string(),
+    path: z.string().min(1),
+    id: PluginIdSchema.optional(),
+});
+export const PluginDirectoryInspectRequestSchema = z.object({
+    type: z.literal("plugin.directory.inspect.request"),
+    requestId: z.string(),
+    path: z.string().min(1),
+});
+function pluginIdRequest(type) {
+    return z.object({ type: z.literal(type), requestId: z.string(), pluginId: PluginIdSchema });
+}
+export const PluginReloadRequestSchema = pluginIdRequest("plugin.reload.request");
+export const PluginEnableRequestSchema = pluginIdRequest("plugin.enable.request");
+export const PluginDisableRequestSchema = pluginIdRequest("plugin.disable.request");
+export const PluginRemoveRequestSchema = pluginIdRequest("plugin.remove.request");
+export const PluginRpcInvokeRequestSchema = z.object({
+    type: z.literal("plugin.rpc.invoke.request"),
+    requestId: z.string(),
+    pluginId: PluginIdSchema,
+    method: z.string().min(1),
+    input: z.unknown(),
+});
+export const AgentSkillOperationSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("add"), name: z.string() }).strict(),
+    z.object({ kind: z.literal("update"), name: z.string() }).strict(),
+    z.object({ kind: z.literal("delete"), name: z.string() }).strict(),
+]);
+export const AgentSkillsStatusSchema = z.object({
+    state: z.enum(["not-installed", "up-to-date", "drift"]),
+    ops: z.array(AgentSkillOperationSchema),
+    available: z.array(z.string()),
+    installed: z.array(z.string()),
+    selection: AgentSkillSelectionSchema,
+});
+export const AgentSkillsConfirmationSchema = z.object({ removals: z.array(z.string()) }).strict();
+export const AgentSkillsSaveResultSchema = AgentSkillsStatusSchema.extend({
+    confirmationRequired: AgentSkillsConfirmationSchema.nullable(),
+});
+function agentSkillsRequest(type) {
+    return z.object({ type: z.literal(type), requestId: z.string() }).strict();
+}
+export const AgentSkillsGetStatusRequestSchema = agentSkillsRequest("agent.skills.get_status.request");
+export const AgentSkillsReconcileRequestSchema = agentSkillsRequest("agent.skills.reconcile.request");
+export const AgentSkillsUninstallRequestSchema = agentSkillsRequest("agent.skills.uninstall.request");
+export const AgentSkillsSaveSelectionRequestSchema = z
+    .object({
+    type: z.literal("agent.skills.save_selection.request"),
+    requestId: z.string(),
+    selection: AgentSkillSelectionSchema,
+    confirmedRemovals: z.array(z.string()).optional(),
+})
+    .strict();
+export const AgentSkillsImportLegacySelectionRequestSchema = z
+    .object({
+    type: z.literal("agent.skills.import_legacy_selection.request"),
+    requestId: z.string(),
+    selection: AgentSkillSelectionSchema,
+})
+    .strict();
 export const GetDaemonConfigRequestMessageSchema = z.object({
     type: z.literal("get_daemon_config_request"),
     requestId: z.string(),
@@ -2300,6 +2496,11 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ProjectRemoveRequestSchema,
     WorkspaceTitleSetRequestSchema,
     WorkspacePinSetRequestSchema,
+    WorkspaceLabelListRequestSchema,
+    WorkspaceLabelAssignmentSetRequestSchema,
+    WorkspaceLabelUpdateRequestSchema,
+    WorkspaceLabelDeleteRequestSchema,
+    WorkspaceLabelDeleteInspectRequestSchema,
     WorkspaceRecoveryInspectRequestSchema,
     WorkspaceRecoveryRestoreRequestSchema,
     SetVoiceModeMessageSchema,
@@ -2307,10 +2508,26 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     WaitForFinishRequestSchema,
     DaemonGetStatusRequestSchema,
     DaemonGetPairingOfferRequestSchema,
+    DaemonConfigReloadRequestSchema,
     HubManagementDaemonConnectRequestSchema,
     HubManagementDaemonGetStatusRequestSchema,
     HubManagementDaemonDisconnectRequestSchema,
     DiagnosticsRequestSchema,
+    PluginCatalogGetRequestSchema,
+    PluginListRequestSchema,
+    PluginLogsGetRequestSchema,
+    PluginDirectoryInstallRequestSchema,
+    PluginDirectoryInspectRequestSchema,
+    PluginReloadRequestSchema,
+    PluginEnableRequestSchema,
+    PluginDisableRequestSchema,
+    PluginRemoveRequestSchema,
+    PluginRpcInvokeRequestSchema,
+    AgentSkillsGetStatusRequestSchema,
+    AgentSkillsReconcileRequestSchema,
+    AgentSkillsUninstallRequestSchema,
+    AgentSkillsSaveSelectionRequestSchema,
+    AgentSkillsImportLegacySelectionRequestSchema,
     GetDaemonConfigRequestMessageSchema,
     SetDaemonConfigRequestMessageSchema,
     ReadProjectConfigRequestMessageSchema,
@@ -2594,6 +2811,10 @@ export const ServerInfoStatusPayloadSchema = z
         providersSnapshot: z.boolean().optional(),
         // COMPAT(providersSnapshotCwd): added in v0.3.2, remove gate after 2027-02-10.
         providersSnapshotCwd: z.boolean().optional(),
+        // COMPAT(directorySync): added in v0.3.x, remove gate after 2027-02-12.
+        directorySync: z.boolean().optional(),
+        // COMPAT(workspaceLabels): added in v0.5.0, remove after 2027-08-14.
+        workspaceLabels: z.boolean().optional(),
         // COMPAT(checkoutForgeSetAutoMerge): added in v0.1.106, remove old
         // checkoutGithubSetAutoMerge fallback after 2026-12-28.
         checkoutForgeSetAutoMerge: z.boolean().optional(),
@@ -2606,10 +2827,20 @@ export const ServerInfoStatusPayloadSchema = z
         forgeSearch: z.boolean().optional(),
         // COMPAT(daemonStatusRpc): added in v0.1.76, remove gate after 2026-11-18.
         daemonStatusRpc: z.boolean().optional(),
+        // COMPAT(daemonConfigReload): added in v0.4.0, remove gate after 2027-02-14.
+        daemonConfigReload: 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(plugins): added in v0.3.0, remove gate after 2027-08-07.
+        plugins: z.boolean().optional(),
+        // COMPAT(pluginManagement): added in v0.4.0, remove gate after 2027-08-14.
+        pluginManagement: z.boolean().optional(),
+        // COMPAT(pluginLogs): added in v0.4.0, remove gate after 2027-08-16.
+        pluginLogs: z.boolean().optional(),
+        // COMPAT(skillManagement): added in v0.4.0, remove gate after 2027-08-16.
+        skillManagement: 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.
@@ -2783,6 +3014,10 @@ export const DaemonConfigChangedStatusPayloadSchema = z
     config: MutableDaemonConfigSchema,
 })
     .passthrough();
+export const PluginCatalogChangedStatusPayloadSchema = z.object({
+    status: z.literal("plugin_catalog_changed"),
+    pluginId: PluginIdSchema,
+});
 export const KnownStatusPayloadSchema = z.discriminatedUnion("status", [
     AgentCreatedStatusPayloadSchema,
     AgentCreateFailedStatusPayloadSchema,
@@ -2791,6 +3026,7 @@ export const KnownStatusPayloadSchema = z.discriminatedUnion("status", [
     ShutdownRequestedStatusPayloadSchema,
     RestartRequestedStatusPayloadSchema,
     DaemonConfigChangedStatusPayloadSchema,
+    PluginCatalogChangedStatusPayloadSchema,
 ]);
 export const ArtifactMessageSchema = z.object({
     type: z.literal("artifact"),
@@ -2888,7 +3124,7 @@ const WorkspaceGitRuntimePayloadSchema = z
 })
     .optional()
     .nullable();
-const WorkspaceGitHubRuntimePayloadSchema = z
+export const WorkspaceGitHubRuntimePayloadSchema = z
     .object({
     featuresEnabled: z.boolean().optional(),
     pullRequest: z
@@ -2959,6 +3195,8 @@ export const WorkspaceDescriptorPayloadSchema = z
     title: z.string().nullable().optional(),
     // COMPAT(workspacePinning): added in v0.1.107, remove optional after 2027-01-12.
     pinnedAt: z.string().nullable().optional(),
+    // COMPAT(workspaceLabels): added in v0.5.0, remove optional after 2027-08-14.
+    labels: z.array(z.string()).optional(),
     archivingAt: z.string().nullable().optional().default(null),
     status: WorkspaceStateBucketSchema,
     // Best-effort workspace status entry timestamp. Old daemons omit the
@@ -2985,6 +3223,8 @@ export const WorkspaceDescriptorPayloadSchema = z
     // Old daemons omit it; absent means the client falls back to GitHub.
     forge: z.string().optional(),
     project: ProjectPlacementPayloadSchema.optional(),
+    // COMPAT(directorySync): sequence of this latest directory projection.
+    syncSeq: z.number().int().positive().optional(),
 })
     .transform((workspace) => ({
     ...workspace,
@@ -2997,10 +3237,14 @@ export const AgentUpdateMessageSchema = z.object({
             kind: z.literal("upsert"),
             agent: AgentSnapshotPayloadSchema,
             project: ProjectPlacementPayloadSchema.nullable().optional(),
+            generation: z.string().optional(),
+            seq: z.number().int().positive().optional(),
         }),
         z.object({
             kind: z.literal("remove"),
             agentId: z.string(),
+            generation: z.string().optional(),
+            seq: z.number().int().positive().optional(),
         }),
     ]),
 });
@@ -3048,6 +3292,8 @@ const AgentDirectoryResponseEntrySchema = z.object({
     // anyway; sending it keeps the client from re-deriving a second opinion that
     // could disagree with the ranking it is explaining.
     searchMatches: z.array(AgentSearchMatchSchema).optional(),
+    // COMPAT(directorySync): sequence of this latest directory projection.
+    syncSeq: z.number().int().positive().optional(),
 });
 const AgentDirectoryPageInfoSchema = z.object({
     nextCursor: z.string().nullable(),
@@ -3061,6 +3307,7 @@ export const FetchAgentsResponseMessageSchema = z.object({
         subscriptionId: z.string().nullable().optional(),
         entries: z.array(AgentDirectoryResponseEntrySchema),
         pageInfo: AgentDirectoryPageInfoSchema,
+        sync: DirectorySyncMetadataSchema.optional(),
     }),
 });
 export const FetchAgentHistoryResponseMessageSchema = z.object({
@@ -3095,8 +3342,14 @@ export const WorkspaceProjectDescriptorPayloadSchema = z.object({
     projectCustomName: z.string().nullable().optional(),
     // COMPAT(projectCustomIcon): added in v0.2.0, remove after 2027-01-20.
     projectCustomIconRevision: z.string().nullable().optional(),
+    // Fingerprints the effective icon, including automatic discovery and the
+    // absence of an icon. Clients may persist icon results against this value.
+    // COMPAT(projectIconCache): added in v0.2.7, remove optional after 2027-02-12.
+    projectIconRevision: z.string().optional(),
     projectRootPath: z.string(),
     projectKind: z.enum(["git", "non_git", "directory"]),
+    // COMPAT(directorySync): sequence of this latest directory projection.
+    syncSeq: z.number().int().positive().optional(),
 });
 export const FetchWorkspacesResponseMessageSchema = z.object({
     type: z.literal("fetch_workspaces_response"),
@@ -3113,6 +3366,7 @@ export const FetchWorkspacesResponseMessageSchema = z.object({
             prevCursor: z.string().nullable(),
             hasMore: z.boolean(),
         }),
+        sync: DirectorySyncMetadataSchema.optional(),
     }),
 });
 export const WorkspaceUpdateMessageSchema = z.object({
@@ -3121,6 +3375,8 @@ export const WorkspaceUpdateMessageSchema = z.object({
         z.object({
             kind: z.literal("upsert"),
             workspace: WorkspaceDescriptorPayloadSchema,
+            generation: z.string().optional(),
+            seq: z.number().int().positive().optional(),
         }),
         z.object({
             kind: z.literal("remove"),
@@ -3135,14 +3391,88 @@ export const WorkspaceUpdateMessageSchema = z.object({
             // Project removal is represented on the existing workspace update channel
             // so old clients can still parse the message and ignore the extra field.
             removedProjectId: z.string().optional(),
+            generation: z.string().optional(),
+            seq: z.number().int().positive().optional(),
         }),
     ]),
 });
+const WorkspaceLabelSyncMetadataSchema = z.object({
+    mode: z.enum(["snapshot", "changes"]),
+    generation: z.string(),
+    headSeq: z.number().int().nonnegative(),
+    removals: z.array(z.object({ name: z.string(), seq: z.number().int().positive() })),
+});
+export const WorkspaceLabelListResponseSchema = z.object({
+    type: z.literal("workspace.label.list.response"),
+    payload: z.object({
+        requestId: z.string(),
+        labels: z.array(WorkspaceLabelDefinitionSchema),
+        sync: WorkspaceLabelSyncMetadataSchema,
+    }),
+});
+export const WorkspaceLabelUpdateSchema = z.object({
+    type: z.literal("workspace.label.update"),
+    payload: z.discriminatedUnion("kind", [
+        z.object({
+            kind: z.literal("upsert"),
+            label: WorkspaceLabelDefinitionSchema,
+            previousName: z.string().optional(),
+            generation: z.string(),
+            seq: z.number().int().positive(),
+        }),
+        z.object({
+            kind: z.literal("remove"),
+            name: z.string(),
+            generation: z.string(),
+            seq: z.number().int().positive(),
+        }),
+    ]),
+});
+export const WorkspaceLabelAssignmentSetResponseSchema = z.object({
+    type: z.literal("workspace.label.assignment.set.response"),
+    payload: z.object({
+        requestId: z.string(),
+        label: WorkspaceLabelDefinitionSchema,
+        workspaceLabels: z.array(z.string()),
+    }),
+});
+export const WorkspaceLabelUpdateResponseSchema = z.object({
+    type: z.literal("workspace.label.update.response"),
+    payload: z.object({
+        requestId: z.string(),
+        label: WorkspaceLabelDefinitionSchema,
+        affectedWorkspaceCount: z.number().int().nonnegative(),
+    }),
+});
+export const WorkspaceLabelDeleteResponseSchema = z.object({
+    type: z.literal("workspace.label.delete.response"),
+    payload: z.object({
+        requestId: z.string(),
+        affectedWorkspaceCount: z.number().int().nonnegative(),
+    }),
+});
+export const WorkspaceLabelDeleteInspectResponseSchema = z.object({
+    type: z.literal("workspace.label.delete.inspect.response"),
+    payload: z.object({
+        requestId: z.string(),
+        affectedWorkspaceCount: z.number().int().nonnegative(),
+    }),
+});
 export const ProjectUpdateMessageSchema = z.object({
     type: z.literal("project.update"),
     payload: z.discriminatedUnion("kind", [
-        z.object({ kind: z.literal("upsert"), project: WorkspaceProjectDescriptorPayloadSchema }),
-        z.object({ kind: z.literal("remove"), projectId: z.string() }),
+        z.object({
+            kind: z.literal("upsert"),
+            project: WorkspaceProjectDescriptorPayloadSchema,
+            generation: z.string().optional(),
+            seq: z.number().int().positive().optional(),
+        }),
+        z.object({
+            kind: z.literal("remove"),
+            projectId: z.string(),
+            generation: z.string().optional(),
+            seq: z.number().int().positive().optional(),
+        }),
     ]),
 });
 export const ProjectListResponseMessageSchema = z.object({
@@ -3150,6 +3480,7 @@ export const ProjectListResponseMessageSchema = z.object({
     payload: z.object({
         requestId: z.string(),
         projects: z.array(WorkspaceProjectDescriptorPayloadSchema),
+        sync: DirectorySyncMetadataSchema.optional(),
     }),
 });
 export const ScriptStatusUpdateMessageSchema = z.object({
@@ -3338,6 +3669,7 @@ const AgentTimelineSeqRangeSchema = z.object({
 export const AgentTimelineEntryPayloadSchema = z.object({
     provider: AgentProviderSchema,
     item: AgentTimelineItemPayloadSchema,
+    turnId: z.string().optional(),
     timestamp: z.string(),
     seqStart: z.number().int().nonnegative(),
     seqEnd: z.number().int().nonnegative(),
@@ -3641,6 +3973,17 @@ export const DaemonGetPairingOfferResponseSchema = z.object({
     })
         .passthrough(),
 });
+export const DaemonConfigReloadResponseSchema = z.object({
+    type: z.literal("daemon.config.reload.response"),
+    payload: z
+        .object({
+        requestId: z.string(),
+        appliedPaths: z.array(z.string()),
+        restartRequiredPaths: z.array(z.string()),
+        overrideControlledPaths: z.array(z.string()),
+    })
+        .passthrough(),
+});
 export const DiagnosticsResponseSchema = z.object({
     type: z.literal("diagnostics.response"),
     payload: z
@@ -3883,6 +4226,10 @@ export const CheckoutPrStatusSchema = z.object({
         status: z.string(),
         url: z.string().nullable(),
         workflow: z.string().optional(),
+        /**
+         * Formatted by the forge adapter: how long a finished check took, or how long a
+         * running one has been going. Raw timestamps stay off the wire.
+         */
         duration: z.string().optional(),
         checkRunId: z.number().optional(),
         workflowRunId: z.number().optional(),
@@ -4928,6 +5275,91 @@ export function parseHubExecutionOutboundMessage(value) {
     }
     return message;
 }
+export const PluginCatalogGetResponseSchema = z.object({
+    type: z.literal("plugin.catalog.get.response"),
+    payload: z.object({
+        requestId: z.string(),
+        plugins: z.array(z.object({
+            id: PluginIdSchema,
+            clientBundle: z.string(),
+        })),
+    }),
+});
+export const PluginStatusSchema = z.enum(["running", "disabled", "failed"]);
+export const PluginListItemSchema = z.object({
+    id: PluginIdSchema,
+    path: z.string(),
+    enabled: z.boolean(),
+    status: PluginStatusSchema,
+    error: z.string().optional(),
+});
+export const PluginLogEntrySchema = z.object({
+    sequence: z.number().int().nonnegative(),
+    timestamp: z.string().datetime(),
+    stream: z.enum(["stdout", "stderr"]),
+    message: z.string(),
+});
+export const PluginListResponseSchema = z.object({
+    type: z.literal("plugin.list.response"),
+    payload: z.object({ requestId: z.string(), plugins: z.array(PluginListItemSchema) }),
+});
+export const PluginLogsGetResponseSchema = z.object({
+    type: z.literal("plugin.logs.get.response"),
+    payload: z.object({
+        requestId: z.string(),
+        pluginId: PluginIdSchema,
+        entries: z.array(PluginLogEntrySchema),
+    }),
+});
+export const PluginDirectoryInstallResponseSchema = z.object({
+    type: z.literal("plugin.directory.install.response"),
+    payload: z.object({ requestId: z.string(), plugin: PluginListItemSchema }),
+});
+export const PluginDirectoryInspectResponseSchema = z.object({
+    type: z.literal("plugin.directory.inspect.response"),
+    payload: z.object({ requestId: z.string(), id: PluginIdSchema }),
+});
+function pluginActionResponse(type) {
+    return z.object({
+        type: z.literal(type),
+        payload: z.object({ requestId: z.string(), plugin: PluginListItemSchema }),
+    });
+}
+export const PluginReloadResponseSchema = pluginActionResponse("plugin.reload.response");
+export const PluginEnableResponseSchema = pluginActionResponse("plugin.enable.response");
+export const PluginDisableResponseSchema = pluginActionResponse("plugin.disable.response");
+export const PluginRemoveResponseSchema = z.object({
+    type: z.literal("plugin.remove.response"),
+    payload: z.object({ requestId: z.string() }).strict(),
+});
+export const PluginRpcInvokeResponseSchema = z.object({
+    type: z.literal("plugin.rpc.invoke.response"),
+    payload: z.object({
+        requestId: z.string(),
+        output: z.unknown(),
+    }),
+});
+function agentSkillsStatusResponse(type) {
+    return z.object({
+        type: z.literal(type),
+        payload: AgentSkillsStatusSchema.extend({ requestId: z.string() }),
+    });
+}
+export const AgentSkillsGetStatusResponseSchema = agentSkillsStatusResponse("agent.skills.get_status.response");
+export const AgentSkillsReconcileResponseSchema = agentSkillsStatusResponse("agent.skills.reconcile.response");
+export const AgentSkillsUninstallResponseSchema = agentSkillsStatusResponse("agent.skills.uninstall.response");
+export const AgentSkillsSaveSelectionResponseSchema = z.object({
+    type: z.literal("agent.skills.save_selection.response"),
+    payload: AgentSkillsSaveResultSchema.extend({ requestId: z.string() }),
+});
+export const AgentSkillsImportLegacySelectionResponseSchema = z.object({
+    type: z.literal("agent.skills.import_legacy_selection.response"),
+    payload: z.object({
+        requestId: z.string(),
+        imported: z.boolean(),
+        selection: AgentSkillSelectionSchema,
+    }),
+});
 export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentCreateResponseSchema,
     HubExecutionAgentValidateResponseSchema,
@@ -4935,6 +5367,21 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     HubExecutionAgentUpdateSchema,
     HubExecutionAgentStreamSchema,
     BrowserAutomationExecuteRequestSchema,
+    PluginCatalogGetResponseSchema,
+    PluginListResponseSchema,
+    PluginLogsGetResponseSchema,
+    PluginDirectoryInstallResponseSchema,
+    PluginDirectoryInspectResponseSchema,
+    PluginReloadResponseSchema,
+    PluginEnableResponseSchema,
+    PluginDisableResponseSchema,
+    PluginRemoveResponseSchema,
+    PluginRpcInvokeResponseSchema,
+    AgentSkillsGetStatusResponseSchema,
+    AgentSkillsReconcileResponseSchema,
+    AgentSkillsUninstallResponseSchema,
+    AgentSkillsSaveSelectionResponseSchema,
+    AgentSkillsImportLegacySelectionResponseSchema,
     ActivityLogMessageSchema,
     AssistantChunkMessageSchema,
     AudioOutputMessageSchema,
@@ -4952,6 +5399,12 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ArtifactMessageSchema,
     AgentUpdateMessageSchema,
     WorkspaceUpdateMessageSchema,
+    WorkspaceLabelListResponseSchema,
+    WorkspaceLabelUpdateSchema,
+    WorkspaceLabelAssignmentSetResponseSchema,
+    WorkspaceLabelUpdateResponseSchema,
+    WorkspaceLabelDeleteResponseSchema,
+    WorkspaceLabelDeleteInspectResponseSchema,
     ProjectUpdateMessageSchema,
     ProjectListResponseMessageSchema,
     ScriptStatusUpdateMessageSchema,
@@ -4992,6 +5445,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     SetVoiceModeResponseMessageSchema,
     DaemonGetStatusResponseSchema,
     DaemonGetPairingOfferResponseSchema,
+    DaemonConfigReloadResponseSchema,
     HubManagementDaemonConnectResponseSchema,
     HubManagementDaemonGetStatusResponseSchema,
     HubManagementDaemonDisconnectResponseSchema,