@opencode-ai/protocol 0.0.0-dev-18671 → 0.0.0-dev-18673

package/dist/groups/vcs.d.ts

@@ -1,6 +1,7 @@
 import { Location } from "@opencode-ai/schema/location";
 import { Schema } from "effect";
 import { HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi";
+import { ServiceUnavailableError } from "../errors.js";
 export declare const VcsGroup: HttpApiGroup.HttpApiGroup<"server.vcs", HttpApiEndpoint.HttpApiEndpoint<"vcs.get", "GET", "/api/vcs", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
@@ -14,7 +15,19 @@ export declare const VcsGroup: HttpApiGroup.HttpApiGroup<"server.vcs", HttpApiEn
             readonly default: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
         }>;
     }>;
-}>>, never, never, never> | HttpApiEndpoint.HttpApiEndpoint<"vcs.status", "GET", "/api/vcs/status", never, Schema.toCodecStringTree<Schema.Struct<{
+}>>, never, never, never> | HttpApiEndpoint.HttpApiEndpoint<"vcs.base", "GET", "/api/vcs/base", never, Schema.toCodecStringTree<Schema.Struct<{
+    readonly location: Schema.optional<Schema.Struct<{
+        readonly directory: Schema.optional<Schema.String>;
+        readonly workspace: Schema.optional<Schema.String>;
+    }>>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly location: typeof Location.Info;
+    readonly data: Schema.NullOr<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly ref: Schema.String;
+        readonly source: Schema.Literals<readonly ["reflog", "default"]>;
+    }>>;
+}>>, Schema.toCodecJson<typeof ServiceUnavailableError>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"vcs.status", "GET", "/api/vcs/status", never, Schema.toCodecStringTree<Schema.Struct<{
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
         readonly workspace: Schema.optional<Schema.String>;
@@ -38,7 +51,8 @@ export declare const VcsGroup: HttpApiGroup.HttpApiGroup<"server.vcs", HttpApiEn
     readonly location: typeof Location.Info;
     readonly data: Schema.$Array<Schema.String>;
 }>>, never, never, never> | HttpApiEndpoint.HttpApiEndpoint<"vcs.diff", "GET", "/api/vcs/diff", never, Schema.toCodecStringTree<Schema.Struct<{
-    readonly mode: Schema.Literals<readonly ["working", "branch"]>;
+    readonly mode: Schema.Literals<readonly ["working", "branch", "committed"]>;
+    readonly base: Schema.decodeTo<Schema.optional<Schema.toType<Schema.String>>, Schema.optionalKey<Schema.String>, never, never>;
     readonly context: Schema.optional<Schema.compose<Schema.Int, Schema.NumberFromString>>;
     readonly location: Schema.optional<Schema.Struct<{
         readonly directory: Schema.optional<Schema.String>;
@@ -53,4 +67,4 @@ export declare const VcsGroup: HttpApiGroup.HttpApiGroup<"server.vcs", HttpApiEn
         readonly deletions: Schema.Int;
         readonly status: Schema.Literals<readonly ["added", "deleted", "modified"]>;
     }>>;
-}>>, never, never, never>, false>;
+}>>, Schema.toCodecJson<typeof ServiceUnavailableError>, never, never>, false>;

package/dist/groups/vcs.js

@@ -1,10 +1,11 @@
 import { FileDiff } from "@opencode-ai/schema/file-diff";
 import { Location } from "@opencode-ai/schema/location";
-import { NonNegativeInt, PositiveInt } from "@opencode-ai/schema/schema";
+import { NonNegativeInt, PositiveInt, optional } 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";
+import { ServiceUnavailableError } from "../errors.js";
 const BranchesQuery = Schema.Struct({
     ...LocationQuery.fields,
     search: Schema.optional(Schema.String),
@@ -13,6 +14,7 @@ const BranchesQuery = Schema.Struct({
 const DiffQuery = Schema.Struct({
     ...LocationQuery.fields,
     mode: Vcs.Mode,
+    base: optional(Schema.String),
     context: Schema.NumberFromString.pipe(Schema.decodeTo(NonNegativeInt), Schema.optional),
 });
 export const VcsGroup = HttpApiGroup.make("server.vcs")
@@ -25,6 +27,17 @@ export const VcsGroup = HttpApiGroup.make("server.vcs")
     identifier: "v2.vcs.get",
     summary: "VCS info",
     description: "Get current and default branch information for the requested location.",
+})))
+    .add(HttpApiEndpoint.get("vcs.base", "/api/vcs/base", {
+    query: LocationQuery,
+    success: Location.response(Schema.NullOr(Vcs.Base)),
+    error: ServiceUnavailableError,
+})
+    .annotateMerge(locationQueryOpenApi)
+    .annotateMerge(OpenApi.annotations({
+    identifier: "v2.vcs.base",
+    summary: "VCS review base",
+    description: "Infer a local review base from named branch creation history, or the repository default only when currently on that branch. Returns null before the first commit or when the provider lacks base metadata; ambiguous Git history requires an explicit base on diff requests.",
 })))
     .add(HttpApiEndpoint.get("vcs.status", "/api/vcs/status", {
     query: LocationQuery,
@@ -49,12 +62,13 @@ export const VcsGroup = HttpApiGroup.make("server.vcs")
     .add(HttpApiEndpoint.get("vcs.diff", "/api/vcs/diff", {
     query: DiffQuery,
     success: Location.response(Schema.Array(FileDiff.Info)),
+    error: ServiceUnavailableError,
 })
     .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.",
+    description: "Diff HEAD to the working copy (working), the base merge-base to the working copy (branch), or the base merge-base to HEAD (committed). Omitting base preserves repository-default comparison; supplying it overrides the comparison without saving it.",
 })))
     .annotateMerge(OpenApi.annotations({
     title: "vcs",

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@opencode-ai/protocol",
-  "version": "0.0.0-dev-18671",
+  "version": "0.0.0-dev-18673",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -32,7 +32,7 @@
     "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@opencode-ai/schema": "0.0.0-dev-18671",
+    "@opencode-ai/schema": "0.0.0-dev-18673",
     "effect": "4.0.0-rc.112"
   },
   "devDependencies": {