feat(core): expose V2 VCS status and diff APIs (#35129)

packages/protocol/src/api.ts

@@ -27,6 +27,7 @@ import { McpGroup } from "./groups/mcp.js"
 import { CredentialGroup } from "./groups/credential.js"
 import { ProjectGroup } from "./groups/project.js"
 import { ProjectCopyGroup } from "./groups/project-copy.js"
+import { VcsGroup } from "./groups/vcs.js"
 
 type LocationGroups<LocationId extends HttpApiMiddleware.AnyId> =
   | HttpApiGroup.AddMiddleware<typeof LocationGroup, LocationId>
@@ -46,6 +47,7 @@ type LocationGroups<LocationId extends HttpApiMiddleware.AnyId> =
   | HttpApiGroup.AddMiddleware<typeof ShellGroup, LocationId>
   | HttpApiGroup.AddMiddleware<typeof ReferenceGroup, LocationId>
   | HttpApiGroup.AddMiddleware<typeof ProjectCopyGroup, LocationId>
+  | HttpApiGroup.AddMiddleware<typeof VcsGroup, LocationId>
 
 type SessionGroups<SessionLocationId extends HttpApiMiddleware.AnyId, SessionLocationService> =
   | ReturnType<typeof makeSessionGroup<SessionLocationId, SessionLocationService>>
@@ -162,6 +164,7 @@ const makeApiFromGroup = <
     .add(makeQuestionGroup(locationMiddleware, sessionLocationMiddleware))
     .add(ReferenceGroup.middleware(locationMiddleware))
     .add(ProjectCopyGroup.middleware(locationMiddleware))
+    .add(VcsGroup.middleware(locationMiddleware))
     .annotateMerge(
       OpenApi.annotations({
         title: "opencode HttpApi",

packages/protocol/src/client.ts

@@ -56,6 +56,7 @@ export const groupNames = {
   "server.reference": "reference",
   "server.project": "project",
   "server.projectCopy": "projectCopy",
+  "server.vcs": "vcs",
 } as const
 
 export const endpointNames = {

packages/protocol/src/groups/vcs.ts

@@ -0,0 +1,50 @@
+import { FileDiff } from "@opencode-ai/schema/file-diff"
+import { Location } from "@opencode-ai/schema/location"
+import { NonNegativeInt } from "@opencode-ai/schema/schema"
+import { Vcs } from "@opencode-ai/schema/vcs"
+import { Schema } from "effect"
+import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi"
+import { LocationQuery, locationQueryOpenApi } from "./location.js"
+
+const DiffQuery = Schema.Struct({
+  ...LocationQuery.fields,
+  mode: Vcs.Mode,
+  context: Schema.NumberFromString.pipe(Schema.decodeTo(NonNegativeInt), Schema.optional),
+})
+
+export const VcsGroup = HttpApiGroup.make("server.vcs")
+  .add(
+    HttpApiEndpoint.get("vcs.status", "/api/vcs/status", {
+      query: LocationQuery,
+      success: Location.response(Schema.Array(Vcs.FileStatus)),
+    })
+      .annotateMerge(locationQueryOpenApi)
+      .annotateMerge(
+        OpenApi.annotations({
+          identifier: "v2.vcs.status",
+          summary: "VCS status",
+          description: "List uncommitted working-copy changes relative to the requested location.",
+        }),
+      ),
+  )
+  .add(
+    HttpApiEndpoint.get("vcs.diff", "/api/vcs/diff", {
+      query: DiffQuery,
+      success: Location.response(Schema.Array(FileDiff.Info)),
+    })
+      .annotateMerge(locationQueryOpenApi)
+      .annotateMerge(
+        OpenApi.annotations({
+          identifier: "v2.vcs.diff",
+          summary: "VCS diff",
+          description:
+            "Diff the working copy against HEAD (mode git) or the default-branch merge base (mode branch) for the requested location.",
+        }),
+      ),
+  )
+  .annotateMerge(
+    OpenApi.annotations({
+      title: "vcs",
+      description: "Location-scoped version control routes.",
+    }),
+  )