core: expose v2 model listing API (#25821)

packages/opencode/src/server/routes/instance/httpapi/groups/v2.ts

@@ -1,10 +1,14 @@
 import { HttpApi, OpenApi } from "effect/unstable/httpapi"
 import { MessageGroup } from "./v2/message"
+import { ModelGroup } from "./v2/model"
+import { ProviderGroup } from "./v2/provider"
 import { SessionGroup } from "./v2/session"
 
 export const V2Api = HttpApi.make("v2")
   .add(SessionGroup)
   .add(MessageGroup)
+  .add(ModelGroup)
+  .add(ProviderGroup)
   .annotateMerge(
     OpenApi.annotations({
       title: "opencode experimental HttpApi",

packages/opencode/src/server/routes/instance/httpapi/groups/v2/model.ts

@@ -0,0 +1,24 @@
+import { ModelV2 } from "@opencode-ai/core/model"
+import { Schema } from "effect"
+import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi"
+import { Authorization } from "../../middleware/authorization"
+
+export const ModelGroup = HttpApiGroup.make("v2.model")
+  .add(
+    HttpApiEndpoint.get("models", "/api/model", {
+      success: Schema.Array(ModelV2.Info),
+    }).annotateMerge(
+      OpenApi.annotations({
+        identifier: "v2.model.list",
+        summary: "List v2 models",
+        description: "Retrieve available v2 models ordered by release date.",
+      }),
+    ),
+  )
+  .annotateMerge(
+    OpenApi.annotations({
+      title: "v2 models",
+      description: "Experimental v2 model routes.",
+    }),
+  )
+  .middleware(Authorization)

packages/opencode/src/server/routes/instance/httpapi/groups/v2/provider.ts

@@ -0,0 +1,38 @@
+import { ProviderV2 } from "@opencode-ai/core/provider"
+import { Schema } from "effect"
+import { HttpApiEndpoint, HttpApiGroup, OpenApi } from "effect/unstable/httpapi"
+import { ApiNotFoundError } from "../../errors"
+import { Authorization } from "../../middleware/authorization"
+
+export const ProviderGroup = HttpApiGroup.make("v2.provider")
+  .add(
+    HttpApiEndpoint.get("providers", "/api/provider", {
+      success: Schema.Array(ProviderV2.Info),
+    }).annotateMerge(
+      OpenApi.annotations({
+        identifier: "v2.provider.list",
+        summary: "List v2 providers",
+        description: "Retrieve active v2 AI providers so clients can show provider availability and configuration.",
+      }),
+    ),
+  )
+  .add(
+    HttpApiEndpoint.get("provider", "/api/provider/:providerID", {
+      params: { providerID: ProviderV2.ID },
+      success: ProviderV2.Info,
+      error: ApiNotFoundError,
+    }).annotateMerge(
+      OpenApi.annotations({
+        identifier: "v2.provider.get",
+        summary: "Get v2 provider",
+        description: "Retrieve a single v2 AI provider so clients can inspect its availability and endpoint settings.",
+      }),
+    ),
+  )
+  .annotateMerge(
+    OpenApi.annotations({
+      title: "v2 providers",
+      description: "Experimental v2 provider routes.",
+    }),
+  )
+  .middleware(Authorization)

packages/opencode/src/server/routes/instance/httpapi/groups/v2/session.ts

@@ -1,6 +1,6 @@
 import { SessionID } from "@/session/schema"
 import { SessionMessage } from "@/v2/session-message"
-import { Prompt } from "@/v2/session-prompt"
+import { Prompt } from "@opencode-ai/core/session-prompt"
 import { SessionV2 } from "@/v2/session"
 import { Schema } from "effect"
 import { HttpApiEndpoint, HttpApiError, HttpApiGroup, HttpApiSchema, OpenApi } from "effect/unstable/httpapi"

packages/opencode/src/server/routes/instance/httpapi/handlers/v2.ts

@@ -1,6 +1,12 @@
+import { Catalog } from "@opencode-ai/core/catalog"
 import { SessionV2 } from "@/v2/session"
 import { Layer } from "effect"
 import { messageHandlers } from "./v2/message"
+import { modelHandlers } from "./v2/model"
+import { providerHandlers } from "./v2/provider"
 import { sessionHandlers } from "./v2/session"
 
-export const v2Handlers = Layer.mergeAll(sessionHandlers, messageHandlers).pipe(Layer.provide(SessionV2.defaultLayer))
+export const v2Handlers = Layer.mergeAll(sessionHandlers, messageHandlers, modelHandlers, providerHandlers).pipe(
+  Layer.provide(Catalog.defaultLayer),
+  Layer.provide(SessionV2.defaultLayer),
+)

packages/opencode/src/server/routes/instance/httpapi/handlers/v2/model.ts

@@ -0,0 +1,12 @@
+import { Catalog } from "@opencode-ai/core/catalog"
+import { Effect } from "effect"
+import { HttpApiBuilder } from "effect/unstable/httpapi"
+import { InstanceHttpApi } from "../../api"
+
+export const modelHandlers = HttpApiBuilder.group(InstanceHttpApi, "v2.model", (handlers) =>
+  Effect.gen(function* () {
+    const catalog = yield* Catalog.Service
+
+    return handlers.handle("models", () => catalog.model.available())
+  }),
+)

packages/opencode/src/server/routes/instance/httpapi/handlers/v2/provider.ts

@@ -0,0 +1,22 @@
+import { Catalog } from "@opencode-ai/core/catalog"
+import { Effect } from "effect"
+import { HttpApiBuilder } from "effect/unstable/httpapi"
+import { InstanceHttpApi } from "../../api"
+import { notFound } from "../../errors"
+
+export const providerHandlers = HttpApiBuilder.group(InstanceHttpApi, "v2.provider", (handlers) =>
+  Effect.gen(function* () {
+    const catalog = yield* Catalog.Service
+
+    return handlers
+      .handle("providers", () => catalog.provider.available())
+      .handle(
+        "provider",
+        Effect.fn(function* (ctx) {
+          return yield* catalog.provider
+            .get(ctx.params.providerID)
+            .pipe(Effect.catchTag("CatalogV2.ProviderNotFound", () => Effect.fail(notFound("Provider not found"))))
+        }),
+      )
+  }),
+)