refactor(protocol): extract server contracts (#33708)

packages/protocol/src/groups/provider.ts

@@ -0,0 +1,45 @@
+import { Provider } from "@opencode-ai/schema/provider"
+import { Location } from "@opencode-ai/schema/location"
+import { Schema } from "effect"
+import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi"
+import { ProviderNotFoundError, ServiceUnavailableError } from "../errors"
+import { LocationQuery, locationQueryOpenApi } from "./location"
+
+export const ProviderGroup = HttpApiGroup.make("server.provider")
+  .add(
+    HttpApiEndpoint.get("provider.list", "/api/provider", {
+      query: LocationQuery,
+      success: Location.response(Schema.Array(Provider.Info)),
+      error: ServiceUnavailableError,
+    })
+      .annotateMerge(locationQueryOpenApi)
+      .annotateMerge(
+        OpenApi.annotations({
+          identifier: "v2.provider.list",
+          summary: "List providers",
+          description: "Retrieve active AI providers so clients can show provider availability and configuration.",
+        }),
+      ),
+  )
+  .add(
+    HttpApiEndpoint.get("provider.get", "/api/provider/:providerID", {
+      params: { providerID: Provider.ID },
+      query: LocationQuery,
+      success: Location.response(Provider.Info),
+      error: [ProviderNotFoundError, ServiceUnavailableError],
+    })
+      .annotateMerge(locationQueryOpenApi)
+      .annotateMerge(
+        OpenApi.annotations({
+          identifier: "v2.provider.get",
+          summary: "Get provider",
+          description: "Retrieve a single AI provider so clients can inspect its availability and endpoint settings.",
+        }),
+      ),
+  )
+  .annotateMerge(
+    OpenApi.annotations({
+      title: "providers",
+      description: "Experimental provider routes.",
+    }),
+  )