@getpaseo/protocol 0.1.110 → 0.2.0-beta.1

package/dist/messages.js

@@ -78,6 +78,7 @@ export const MutableDaemonConfigPatchSchema = z
     providers: z
         .record(z.string(), MutableDaemonProviderConfigSchema.partial().passthrough())
         .optional(),
+    removeProviders: z.array(z.string().min(1)).optional(),
     metadataGeneration: MutableMetadataGenerationConfigSchema.partial().optional(),
     autoArchiveAfterMerge: z.boolean().optional(),
     enableTerminalAgentHooks: z.boolean().optional(),
@@ -150,6 +151,7 @@ export const ProviderSnapshotEntrySchema = z.object({
     provider: AgentProviderSchema,
     status: ProviderStatusSchema,
     enabled: z.boolean().optional().default(true),
+    source: z.enum(["builtin", "custom"]).optional(),
     error: z.string().optional(),
     models: z.array(AgentModelDefinitionSchema).optional(),
     modes: z.array(AgentModeSchema).optional(),
@@ -661,6 +663,16 @@ export const WorkspacePinSetRequestSchema = z.object({
     pinned: z.boolean(),
     requestId: z.string(),
 });
+export const WorkspaceRecoveryInspectRequestSchema = z.object({
+    type: z.literal("workspace.recovery.inspect.request"),
+    workspaceId: z.string(),
+    requestId: z.string(),
+});
+export const WorkspaceRecoveryRestoreRequestSchema = z.object({
+    type: z.literal("workspace.recovery.restore.request"),
+    workspaceId: z.string(),
+    requestId: z.string(),
+});
 export const SetVoiceModeMessageSchema = z.object({
     type: z.literal("set_voice_mode"),
     enabled: z.boolean(),
@@ -677,6 +689,18 @@ export const GitHubPrAttachmentSchema = z.object({
     baseRefName: z.string().nullable().optional(),
     headRefName: z.string().nullable().optional(),
 });
+export const ForgeChangeRequestAttachmentSchema = z.object({
+    type: z.literal("forge_change_request"),
+    mimeType: z.literal("application/paseo-forge-change-request"),
+    forge: z.string().optional().default("github"),
+    number: z.number().int().positive(),
+    title: z.string(),
+    url: z.string(),
+    body: z.string().nullable().optional(),
+    projectPath: z.string().optional(),
+    baseRefName: z.string().nullable().optional(),
+    headRefName: z.string().nullable().optional(),
+});
 export const GitHubIssueAttachmentSchema = z.object({
     type: z.literal("github_issue"),
     mimeType: z.literal("application/github-issue"),
@@ -685,6 +709,16 @@ export const GitHubIssueAttachmentSchema = z.object({
     url: z.string(),
     body: z.string().nullable().optional(),
 });
+export const ForgeIssueAttachmentSchema = z.object({
+    type: z.literal("forge_issue"),
+    mimeType: z.literal("application/paseo-forge-issue"),
+    forge: z.string().optional().default("github"),
+    number: z.number().int().positive(),
+    title: z.string(),
+    url: z.string(),
+    body: z.string().nullable().optional(),
+    projectPath: z.string().optional(),
+});
 export const TextAttachmentSchema = z
     .object({
     type: z.literal("text"),
@@ -731,6 +765,8 @@ export const UploadedFileAttachmentSchema = z.object({
     path: z.string(),
 });
 export const AgentAttachmentSchema = z.discriminatedUnion("type", [
+    ForgeChangeRequestAttachmentSchema,
+    ForgeIssueAttachmentSchema,
     GitHubPrAttachmentSchema,
     GitHubIssueAttachmentSchema,
     TextAttachmentSchema,
@@ -751,6 +787,12 @@ function normalizeAgentAttachments(input) {
     return normalized;
 }
 const AgentAttachmentsSchema = z.unknown().transform(normalizeAgentAttachments).optional();
+export const ChangeRequestCheckoutSourceSchema = z.object({
+    kind: z.literal("change_request"),
+    forge: z.string().optional().default("github"),
+    number: z.number().int().positive(),
+    projectPath: z.string().optional(),
+});
 const ImageAttachmentSchema = z.object({
     data: z.string(), // base64 encoded image
     mimeType: z.string(), // e.g., "image/jpeg", "image/png"
@@ -938,6 +980,9 @@ const GitSetupOptionsSchema = z.object({
     worktreeSlug: z.string().optional(),
     refName: z.string().min(1).optional(),
     action: z.enum(["branch-off", "checkout"]).optional(),
+    checkoutSource: ChangeRequestCheckoutSourceSchema.optional(),
+    // COMPAT(githubPrNumber): added in v0.1.106, remove after 2026-12-28 once
+    // clients send checkoutSource.
     githubPrNumber: z.number().int().positive().optional(),
 });
 export const CreateAgentWorktreeTargetSchema = z.discriminatedUnion("mode", [
@@ -1021,6 +1066,7 @@ export const ImportAgentRequestMessageSchema = z.object({
     sessionId: z.string().optional(),
     providerHandleId: z.string().optional(),
     cwd: z.string().optional(),
+    workspaceId: z.string().optional(),
     labels: z.record(z.string(), z.string()).optional(),
     requestId: z.string(),
 });
@@ -1205,6 +1251,37 @@ export const WorkspacePinSetResponseSchema = z.object({
     type: z.literal("workspace.pin.set.response"),
     payload: WorkspacePinSetResponsePayloadSchema,
 });
+export const WorkspaceRecoveryStateSchema = z.discriminatedUnion("kind", [
+    z.object({
+        kind: z.literal("recoverable"),
+        workspaceId: z.string(),
+        workspaceName: z.string(),
+        action: z.string(),
+        branch: z.string().nullable(),
+    }),
+    z.object({
+        kind: z.literal("unavailable"),
+        workspaceId: z.string(),
+        reason: z.string(),
+        message: z.string(),
+    }),
+]);
+export const WorkspaceRecoveryInspectResponseSchema = z.object({
+    type: z.literal("workspace.recovery.inspect.response"),
+    payload: z.object({
+        requestId: z.string(),
+        state: WorkspaceRecoveryStateSchema,
+    }),
+});
+export const WorkspaceRecoveryRestoreResponseSchema = z.object({
+    type: z.literal("workspace.recovery.restore.response"),
+    payload: z.object({
+        requestId: z.string(),
+        workspaceId: z.string(),
+        accepted: z.boolean(),
+        error: z.string().nullable(),
+    }),
+});
 export const SetVoiceModeResponseMessageSchema = z.object({
     type: z.literal("set_voice_mode_response"),
     payload: z.object({
@@ -1306,6 +1383,15 @@ export const CheckoutPrMergeRequestSchema = z.object({
     mergeMethod: z.enum(["merge", "squash", "rebase"]),
     requestId: z.string(),
 });
+export const CheckoutForgeSetAutoMergeRequestSchema = z.object({
+    type: z.literal("checkout.forge.set_auto_merge.request"),
+    cwd: z.string(),
+    enabled: z.boolean(),
+    mergeMethod: z.enum(["merge", "squash", "rebase"]).optional(),
+    requestId: z.string(),
+});
+// COMPAT(githubAutoMergeRpc): added in v0.1.106, remove after 2026-12-28 once
+// all supported clients use checkout.forge.set_auto_merge.*.
 export const CheckoutGithubSetAutoMergeRequestSchema = z.object({
     type: z.literal("checkout.github.set_auto_merge.request"),
     cwd: z.string(),
@@ -1313,16 +1399,61 @@ export const CheckoutGithubSetAutoMergeRequestSchema = z.object({
     mergeMethod: z.enum(["merge", "squash", "rebase"]).optional(),
     requestId: z.string(),
 });
+const CheckoutCommitFileSchema = z.object({
+    path: z.string(),
+    additions: z.number(),
+    deletions: z.number(),
+    status: z.enum(["added", "modified", "deleted", "renamed"]).optional(),
+});
+const CheckoutCommitSchema = z.object({
+    sha: z.string(),
+    shortSha: z.string(),
+    subject: z.string(),
+    authorName: z.string(),
+    authorDate: z.string(), // ISO 8601
+    isOnRemote: z.boolean(), // false = local-only (unpushed)
+    files: z.array(CheckoutCommitFileSchema),
+});
+export const CheckoutCommitsListRequestSchema = z.object({
+    type: z.literal("checkout.commits.list.request"),
+    cwd: z.string(),
+    requestId: z.string(),
+});
+export const CheckoutCommitFileDiffRequestSchema = z.object({
+    type: z.literal("checkout.commits.file_diff.request"),
+    cwd: z.string(),
+    sha: z.string(),
+    path: z.string(),
+    requestId: z.string(),
+});
 const GitHubRepoSegmentSchema = z.string().regex(/^[A-Za-z0-9._-]+$/);
-export const CheckoutGithubGetCheckDetailsRequestSchema = z.object({
-    type: z.literal("checkout.github.get_check_details.request"),
+const CheckoutCheckDetailsRequestPayloadSchema = z.object({
     cwd: z.string(),
-    repoOwner: GitHubRepoSegmentSchema,
-    repoName: GitHubRepoSegmentSchema,
-    checkRunId: z.number().int().positive(),
+    // GitHub addresses check runs by owner/name. GitLab resolves the project from
+    // cwd and omits these GitHub-only single-segment fields.
+    repoOwner: GitHubRepoSegmentSchema.optional(),
+    repoName: GitHubRepoSegmentSchema.optional(),
+    // Permanently optional: a check addressed only by workflowRunId (Gitea
+    // Actions runs carry no check-run id) is fetchable. Callers send at least one
+    // of checkRunId/workflowRunId; the gated forge RPC only reaches daemons that
+    // understand this.
+    checkRunId: z.number().int().positive().optional(),
     workflowRunId: z.number().int().positive().optional(),
+    // Permanent forge-routing field, optional because only some forges need it:
+    // GitLab routes the check-details fetch to the change request's head pipeline
+    // by iid, so a fork/detached MR pipeline (which lives in the source project,
+    // not the checkout's target project) resolves correctly. GitHub ignores it.
+    changeRequestNumber: z.number().int().positive().optional(),
     requestId: z.string(),
 });
+export const CheckoutForgeGetCheckDetailsRequestSchema = CheckoutCheckDetailsRequestPayloadSchema.extend({
+    type: z.literal("checkout.forge.get_check_details.request"),
+});
+// COMPAT(githubCheckDetailsRpc): added in v0.1.106, remove after 2026-12-28 once
+// all supported clients use checkout.forge.get_check_details.*.
+export const CheckoutGithubGetCheckDetailsRequestSchema = CheckoutCheckDetailsRequestPayloadSchema.extend({
+    type: z.literal("checkout.github.get_check_details.request"),
+});
 export const CheckoutPrStatusRequestSchema = z.object({
     type: z.literal("checkout_pr_status_request"),
     cwd: z.string(),
@@ -1384,17 +1515,41 @@ export const BranchSuggestionsRequestSchema = z.object({
 });
 export const GitHubSearchItemSchema = z.object({
     kind: z.enum(["issue", "pr"]),
+    forge: z.string().optional(),
     number: z.number(),
     title: z.string(),
     url: z.string(),
     state: z.string(),
     body: z.string().nullable(),
     labels: z.array(z.string()),
+    projectPath: z.string().optional(),
     baseRefName: z.string().nullable().optional(),
     headRefName: z.string().nullable().optional(),
     updatedAt: z.string().optional(),
 });
-export const GitHubSearchKindSchema = z.enum(["github-issue", "github-pr"]);
+export const ForgeSearchItemSchema = GitHubSearchItemSchema.extend({
+    kind: z.enum(["issue", "change_request"]),
+});
+// COMPAT(githubSearchKind): added in v0.1.106, remove with the legacy
+// github_search_request RPC after 2026-12-28.
+export const ForgeSearchKindSchema = z.enum([
+    "issue",
+    "change_request",
+    "github-issue",
+    "github-pr",
+    "pr",
+]);
+export const GitHubSearchKindSchema = ForgeSearchKindSchema;
+export const ForgeSearchRequestSchema = z.object({
+    type: z.literal("forge.search.request"),
+    cwd: z.string(),
+    query: z.string(),
+    limit: z.number().int().min(1).max(50).optional(),
+    kinds: z.array(ForgeSearchKindSchema).optional(),
+    requestId: z.string(),
+});
+// COMPAT(githubSearchRpc): added in v0.1.106, remove after 2026-12-28 once
+// clients use forge.search.*.
 export const GitHubSearchRequestSchema = z.object({
     type: z.literal("github_search_request"),
     cwd: z.string(),
@@ -1456,6 +1611,9 @@ export const CreatePaseoWorktreeRequestSchema = z.object({
     firstAgentContext: FirstAgentContextSchema.optional(),
     refName: z.string().min(1).optional(),
     action: z.enum(["branch-off", "checkout"]).optional(),
+    checkoutSource: ChangeRequestCheckoutSourceSchema.optional(),
+    // COMPAT(githubPrNumber): added in v0.1.106, remove after 2026-12-28 once
+    // clients send checkoutSource: { kind: "change_request", forge, number }.
     githubPrNumber: z.number().int().positive().optional(),
     requestId: z.string(),
 });
@@ -1550,6 +1708,9 @@ export const WorkspaceCreateRequestSchema = z.object({
             // Target branch name for checkout, or new branch name for branch-off.
             refName: z.string().min(1).optional(),
             baseBranch: z.string().optional(),
+            checkoutSource: ChangeRequestCheckoutSourceSchema.optional(),
+            // COMPAT(githubPrNumber): added in v0.1.106, remove after 2026-12-28 once
+            // clients send checkoutSource.
             githubPrNumber: z.number().int().positive().optional(),
             worktreeSlug: z.string().optional(),
         }),
@@ -1704,10 +1865,10 @@ export const CreateTerminalRequestSchema = z.object({
     agentId: z.string().optional(),
     command: z.string().optional(),
     args: z.array(z.string()).optional(),
-    // COMPAT(createTerminalSize): added in v0.1.107, drop the optional gate when floor >= v0.1.107.
-    // The client seeds the PTY with its measured viewport size so a new terminal isn't born at the
-    // 80x24 default and then visibly reflowed. Old daemons ignore this field and start at 80x24;
-    // the client's first resize corrects it as before.
+    // Initial PTY size. Added in v0.1.107; the app no longer sends it (the estimate cache that fed
+    // it was removed — the pane-focus resize claim sizes the PTY instead). Kept and honored
+    // permanently: released v0.1.107 clients still send it, and programmatic callers may pass an
+    // exact size. Daemons without it start at 80x24 and the first resize corrects that.
     size: z
         .object({
         rows: z.number().int().positive(),
@@ -1796,6 +1957,8 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     ProjectRemoveRequestSchema,
     WorkspaceTitleSetRequestSchema,
     WorkspacePinSetRequestSchema,
+    WorkspaceRecoveryInspectRequestSchema,
+    WorkspaceRecoveryRestoreRequestSchema,
     SetVoiceModeMessageSchema,
     SendAgentMessageRequestSchema,
     WaitForFinishRequestSchema,
@@ -1848,7 +2011,11 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutRefreshRequestSchema,
     CheckoutPrCreateRequestSchema,
     CheckoutPrMergeRequestSchema,
+    CheckoutForgeSetAutoMergeRequestSchema,
     CheckoutGithubSetAutoMergeRequestSchema,
+    CheckoutCommitsListRequestSchema,
+    CheckoutCommitFileDiffRequestSchema,
+    CheckoutForgeGetCheckDetailsRequestSchema,
     CheckoutGithubGetCheckDetailsRequestSchema,
     CheckoutPrStatusRequestSchema,
     PullRequestTimelineRequestSchema,
@@ -1859,6 +2026,7 @@ export const SessionInboundMessageSchema = z.discriminatedUnion("type", [
     StashListRequestSchema,
     ValidateBranchRequestSchema,
     BranchSuggestionsRequestSchema,
+    ForgeSearchRequestSchema,
     GitHubSearchRequestSchema,
     DirectorySuggestionsRequestSchema,
     PaseoWorktreeListRequestSchema,
@@ -2055,14 +2223,23 @@ export const ServerInfoStatusPayloadSchema = z
     serverId: z.string().trim().min(1),
     hostname: ServerInfoHostnameSchema.optional(),
     version: ServerInfoVersionSchema.optional(),
+    // COMPAT(desktopManaged): added in v0.1.X, remove optional parsing after 2027-01-16.
+    desktopManaged: z.boolean().optional(),
     capabilities: ServerCapabilitiesFromUnknownSchema.optional(),
     // COMPAT(providersSnapshot): added in v0.1.48, remove gating when all clients use snapshot
     features: z
         .object({
         providersSnapshot: z.boolean().optional(),
+        // COMPAT(checkoutForgeSetAutoMerge): added in v0.1.106, remove old
+        // checkoutGithubSetAutoMerge fallback after 2026-12-28.
+        checkoutForgeSetAutoMerge: z.boolean().optional(),
         checkoutGithubSetAutoMerge: z.boolean().optional(),
         // COMPAT(githubCheckDetails): added in v0.1.92, remove gate after 2026-12-08.
         githubCheckDetails: z.boolean().optional(),
+        // COMPAT(forgeCheckDetails): added in v0.1.106, remove githubCheckDetails fallback after 2026-12-28.
+        forgeCheckDetails: z.boolean().optional(),
+        // COMPAT(forgeSearch): added in v0.1.106, remove github_search fallback after 2026-12-28.
+        forgeSearch: z.boolean().optional(),
         // COMPAT(daemonStatusRpc): added in v0.1.76, remove gate after 2026-11-18.
         daemonStatusRpc: z.boolean().optional(),
         // COMPAT(terminalRestoreModes): added in v0.1.81, remove gate after 2026-11-23.
@@ -2079,6 +2256,8 @@ export const ServerInfoStatusPayloadSchema = z
         projectAdd: z.boolean().optional(),
         // COMPAT(worktreeRestore): added in v0.1.97, drop the gate when floor >= v0.1.97
         worktreeRestore: z.boolean().optional(),
+        // COMPAT(workspaceRecovery): added in v0.1.105, remove after 2027-01-11 once daemon floor >= v0.1.105.
+        workspaceRecovery: z.boolean().optional(),
         // COMPAT(providerUsageList): added in v0.1.98, drop the gate when daemon floor >= v0.1.98.
         providerUsageList: z.boolean().optional(),
         // COMPAT(agentDetach): added in v0.1.98, remove gate after 2026-12-19 once daemon floor >= v0.1.98.
@@ -2101,6 +2280,16 @@ 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(commitsList): added in v0.1.110, remove gate after 2027-01-16.
+        commitsList: z.boolean().optional(),
+        // COMPAT(providerRemoval): added in v0.1.105, drop the gate when floor >= v0.1.105.
+        providerRemoval: z.boolean().optional(),
+        // COMPAT(importSessionWorkspaceTarget): added in v0.1.110, remove gate after 2027-01-16.
+        importSessionWorkspaceTarget: z.boolean().optional(),
+        // COMPAT(forgeProviders): added in v0.1.106, drop the gate when daemon floor >= v0.1.106.
+        // Daemon advertises pluggable non-GitHub forge support (the forge registry);
+        // the client gates non-GitHub setup UI on it.
+        forgeProviders: z.boolean().optional(),
     })
         .optional(),
 })
@@ -2374,6 +2563,10 @@ export const WorkspaceDescriptorPayloadSchema = z
     scripts: z.array(WorkspaceScriptPayloadSchema).default([]),
     gitRuntime: WorkspaceGitRuntimePayloadSchema,
     githubRuntime: WorkspaceGitHubRuntimePayloadSchema,
+    // COMPAT(forge): added in v0.1.106, remove after 2026-12-27. The forge resolved
+    // for this workspace, so the sidebar/hover-card render the right brand mark.
+    // Old daemons omit it; absent means the client falls back to GitHub.
+    forge: z.string().optional(),
     project: ProjectPlacementPayloadSchema.optional(),
 })
     .transform((workspace) => ({
@@ -3083,8 +3276,7 @@ const CheckoutPrGithubRepositoryPolicySchema = z
     rebaseMergeAllowed: false,
     viewerDefaultMergeMethod: null,
 });
-const CheckoutPrGithubStatusSchema = z
-    .object({
+const CheckoutPrGithubStatusObjectSchema = z.object({
     mergeStateStatus: z.string().nullable().optional().default(null),
     autoMergeRequest: CheckoutPrGithubAutoMergeRequestSchema,
     viewerCanEnableAutoMerge: z.boolean().optional().default(false),
@@ -3094,9 +3286,23 @@ const CheckoutPrGithubStatusSchema = z
     repository: CheckoutPrGithubRepositoryPolicySchema,
     isMergeQueueEnabled: z.boolean().optional().default(false),
     isInMergeQueue: z.boolean().optional().default(false),
-})
-    .optional();
+});
+const CheckoutPrGithubStatusSchema = CheckoutPrGithubStatusObjectSchema.optional();
+// The open facts envelope for forge-specific PR facts. Permanent — non-GitHub
+// forges deliver their native facts through it. The transitional piece is the
+// `github` mirror above, which stays populated for clients predating this
+// envelope; see COMPAT(forgeSpecific) in status-projection.ts for the shim.
+//
+// NOTE: `forgeSpecific.forge` is a FACTS-FAMILY tag, not the workspace brand id.
+// The whole Gitea family (gitea, forgejo, codeberg) emits `forge: "gitea"` here
+// because they share one facts shape, while the top-level `forge` above carries
+// the specific brand. Validation of family-specific payloads happens at runtime
+// in the consumer that knows that forge family.
+const CheckoutPrForgeSpecificSchema = z.unknown().optional();
 export const CheckoutPrStatusSchema = z.object({
+    // COMPAT(forge): added in v0.1.106, remove the default after 2026-12-27 once daemon floor >= v0.1.106.
+    forge: z.string().optional().default("github"),
+    projectPath: z.string().optional(),
     number: z.number().optional(),
     url: z.string(),
     title: z.string(),
@@ -3127,11 +3333,20 @@ export const CheckoutPrStatusSchema = z.object({
     repoOwner: z.string().optional(),
     repoName: z.string().optional(),
     github: CheckoutPrGithubStatusSchema,
+    forgeSpecific: CheckoutPrForgeSpecificSchema,
 });
+export const ForgeAuthStateSchema = z.unknown().optional();
 const CheckoutPrStatusPayloadSchema = z.object({
     cwd: z.string(),
     status: CheckoutPrStatusSchema.nullable(),
     githubFeaturesEnabled: z.boolean(),
+    // COMPAT(forgeAuthState): added in v0.1.106, remove after 2026-12-27. Optional richer
+    // signal that supersedes githubFeaturesEnabled. The legacy boolean stays for old clients
+    // and may remain true for non-auth error payloads so old clients still show the error.
+    // Drop the boolean once the daemon floor >= v0.1.106.
+    authState: ForgeAuthStateSchema,
+    // COMPAT(forge): added in v0.1.106, remove the default after 2026-12-27 once daemon floor >= v0.1.106.
+    forge: z.string().optional().default("github"),
     error: CheckoutErrorSchema.nullable(),
     requestId: z.string(),
 });
@@ -3237,6 +3452,18 @@ export const CheckoutPrMergeResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const CheckoutForgeSetAutoMergeResponseSchema = z.object({
+    type: z.literal("checkout.forge.set_auto_merge.response"),
+    payload: z.object({
+        cwd: z.string(),
+        enabled: z.boolean(),
+        success: z.boolean(),
+        error: CheckoutErrorSchema.nullable(),
+        requestId: z.string(),
+    }),
+});
+// COMPAT(githubAutoMergeRpc): added in v0.1.106, remove after 2026-12-28 once
+// all supported clients use checkout.forge.set_auto_merge.*.
 export const CheckoutGithubSetAutoMergeResponseSchema = z.object({
     type: z.literal("checkout.github.set_auto_merge.response"),
     payload: z.object({
@@ -3247,6 +3474,29 @@ export const CheckoutGithubSetAutoMergeResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+export const CheckoutCommitsListResponseSchema = z.object({
+    type: z.literal("checkout.commits.list.response"),
+    payload: z.object({
+        cwd: z.string(),
+        baseRef: z.string().nullable(),
+        commits: z.array(CheckoutCommitSchema),
+        error: CheckoutErrorSchema.nullable(),
+        requestId: z.string(),
+    }),
+});
+export const CheckoutCommitFileDiffResponseSchema = z.object({
+    type: z.literal("checkout.commits.file_diff.response"),
+    payload: z.object({
+        cwd: z.string(),
+        sha: z.string(),
+        path: z.string(),
+        // null when the file is absent from the commit or carries no textual diff
+        // (e.g. binary-only changes).
+        file: ParsedDiffFileSchema.nullable(),
+        error: CheckoutErrorSchema.nullable(),
+        requestId: z.string(),
+    }),
+});
 const CheckoutGithubCheckAnnotationSchema = z.object({
     path: z.string().optional(),
     startLine: z.number().optional(),
@@ -3265,6 +3515,31 @@ const CheckoutGithubCheckJobSchema = z.object({
     logTail: z.string().optional(),
     logTruncated: z.boolean().optional(),
 });
+// Statuses stay open strings so future forge values cannot break parsing.
+const CheckoutPipelineJobSchema = z.object({
+    id: z.number(),
+    name: z.string(),
+    stage: z.string(),
+    status: z.string(),
+    rawStatus: z.string(),
+    url: z.string().nullable().optional().default(null),
+    allowFailure: z.boolean().optional().default(false),
+    durationSeconds: z.number().nullable().optional().default(null),
+});
+const CheckoutPipelineStageSchema = z.object({
+    name: z.string(),
+    status: z.string(),
+    jobs: z.array(CheckoutPipelineJobSchema).optional().default([]),
+});
+const CheckoutPipelineSchema = z.object({
+    id: z.number(),
+    status: z.string(),
+    rawStatus: z.string(),
+    url: z.string().nullable().optional().default(null),
+    ref: z.string().nullable().optional().default(null),
+    sha: z.string().nullable().optional().default(null),
+    stages: z.array(CheckoutPipelineStageSchema).optional().default([]),
+});
 export const CheckoutGithubCheckDetailsSchema = z.object({
     checkRunId: z.number(),
     workflowRunId: z.number().nullable().optional(),
@@ -3284,13 +3559,28 @@ export const CheckoutGithubCheckDetailsSchema = z.object({
     annotations: z.array(CheckoutGithubCheckAnnotationSchema).optional().default([]),
     failedJobs: z.array(CheckoutGithubCheckJobSchema).optional().default([]),
     truncated: z.boolean().optional().default(false),
+    // No default: server CheckDetails keeps this optional and GitHub leaves it absent.
+    pipeline: CheckoutPipelineSchema.nullable().optional(),
+});
+export const CheckoutCheckDetailsSchema = CheckoutGithubCheckDetailsSchema;
+export const CheckoutForgeGetCheckDetailsResponseSchema = z.object({
+    type: z.literal("checkout.forge.get_check_details.response"),
+    payload: z.object({
+        cwd: z.string(),
+        success: z.boolean(),
+        details: CheckoutCheckDetailsSchema.nullable().optional().default(null),
+        error: CheckoutErrorSchema.nullable(),
+        requestId: z.string(),
+    }),
 });
+// COMPAT(githubCheckDetailsRpc): added in v0.1.106, remove after 2026-12-28 once
+// all supported clients use checkout.forge.get_check_details.*.
 export const CheckoutGithubGetCheckDetailsResponseSchema = z.object({
     type: z.literal("checkout.github.get_check_details.response"),
     payload: z.object({
         cwd: z.string(),
         success: z.boolean(),
-        details: CheckoutGithubCheckDetailsSchema.nullable().optional().default(null),
+        details: CheckoutCheckDetailsSchema.nullable().optional().default(null),
         error: CheckoutErrorSchema.nullable(),
         requestId: z.string(),
     }),
@@ -3350,6 +3640,16 @@ const PullRequestTimelineCommentItemSchema = z.object({
     // threads under their parent review. Absent on issue comments and on
     // timelines from daemons that predate the field.
     reviewId: z.string().optional(),
+    // Forge-neutral discussion/thread id this comment belongs to, independent of a
+    // file position. GitLab maps its discussion id here so general (non-file)
+    // reply chains group into one thread; file-position threads also carry it.
+    // Absent on standalone comments and on timelines from daemons that predate it.
+    threadId: z.string().optional(),
+    // Forge-neutral resolution state for a thread that has no file position, e.g. a
+    // GitLab general (non-file) discussion that is resolvable. File-position threads
+    // carry their resolution under `location.isResolved` instead. Absent on ordinary
+    // comments, on forges that expose no thread resolution, and on older timelines.
+    threadIsResolved: z.boolean().optional(),
     location: z
         .object({
         path: z.string(),
@@ -3385,6 +3685,10 @@ export const PullRequestTimelineResponseSchema = z.object({
         error: PullRequestTimelineErrorSchema.nullable().optional().default(null),
         requestId: z.string().optional().default(""),
         githubFeaturesEnabled: z.boolean().optional().default(true),
+        // COMPAT(forgeAuthState): added in v0.1.106, remove after 2026-12-27. Optional richer
+        // signal that supersedes githubFeaturesEnabled, mirroring CheckoutPrStatusPayloadSchema.
+        // Drop the boolean once the daemon floor >= v0.1.106.
+        authState: ForgeAuthStateSchema,
     })
         .optional()
         .prefault({}),
@@ -3469,14 +3773,29 @@ export const BranchSuggestionsResponseSchema = z.object({
         requestId: z.string(),
     }),
 });
+const ForgeSearchResponsePayloadSchema = z.object({
+    items: z.array(z.unknown()),
+    authState: z.unknown().optional(),
+    error: z.string().nullable(),
+    requestId: z.string(),
+});
+const GitHubSearchResponsePayloadSchema = z.object({
+    items: z.array(z.unknown()),
+    featuresEnabled: z.boolean().optional(),
+    authState: z.unknown().optional(),
+    githubFeaturesEnabled: z.boolean().optional(),
+    error: z.string().nullable(),
+    requestId: z.string(),
+});
+export const ForgeSearchResponseSchema = z.object({
+    type: z.literal("forge.search.response"),
+    payload: ForgeSearchResponsePayloadSchema,
+});
+// COMPAT(githubSearchRpc): added in v0.1.106, remove after 2026-12-28 once
+// clients use forge.search.*.
 export const GitHubSearchResponseSchema = z.object({
     type: z.literal("github_search_response"),
-    payload: z.object({
-        items: z.array(GitHubSearchItemSchema),
-        githubFeaturesEnabled: z.boolean(),
-        error: z.string().nullable(),
-        requestId: z.string(),
-    }),
+    payload: GitHubSearchResponsePayloadSchema,
 });
 export const DirectorySuggestionsResponseSchema = z.object({
     type: z.literal("directory_suggestions_response"),
@@ -3928,6 +4247,8 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     ProjectRemoveResponseSchema,
     WorkspaceTitleSetResponseSchema,
     WorkspacePinSetResponseSchema,
+    WorkspaceRecoveryInspectResponseSchema,
+    WorkspaceRecoveryRestoreResponseSchema,
     WaitForFinishResponseMessageSchema,
     AgentPermissionRequestMessageSchema,
     AgentPermissionResolvedMessageSchema,
@@ -3946,7 +4267,11 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     CheckoutRefreshResponseSchema,
     CheckoutPrCreateResponseSchema,
     CheckoutPrMergeResponseSchema,
+    CheckoutForgeSetAutoMergeResponseSchema,
     CheckoutGithubSetAutoMergeResponseSchema,
+    CheckoutCommitsListResponseSchema,
+    CheckoutCommitFileDiffResponseSchema,
+    CheckoutForgeGetCheckDetailsResponseSchema,
     CheckoutGithubGetCheckDetailsResponseSchema,
     CheckoutPrStatusResponseSchema,
     PullRequestTimelineResponseSchema,
@@ -3957,6 +4282,7 @@ export const SessionOutboundMessageSchema = z.discriminatedUnion("type", [
     StashListResponseSchema,
     ValidateBranchResponseSchema,
     BranchSuggestionsResponseSchema,
+    ForgeSearchResponseSchema,
     GitHubSearchResponseSchema,
     DirectorySuggestionsResponseSchema,
     PaseoWorktreeListResponseSchema,

package/dist/provider-manifest.d.ts

@@ -22,6 +22,7 @@ export interface AgentProviderDefinition {
         defaultModel?: string;
     };
 }
+export declare const OMP_MODES: AgentProviderModeDefinition[];
 export declare const AGENT_PROVIDER_DEFINITIONS: AgentProviderDefinition[];
 export declare const DEV_AGENT_PROVIDER_DEFINITIONS: AgentProviderDefinition[];
 export declare function getAgentProviderDefinition(provider: string, definitions?: AgentProviderDefinition[]): AgentProviderDefinition;