feat(sdk): add HttpApi clients and embedded host (#33445)

packages/httpapi-codegen/test/generated/client-error.ts

@@ -0,0 +1,5 @@
+import { Schema } from "effect"
+
+export class ClientError extends Schema.TaggedErrorClass<ClientError>()("ClientError", {
+  cause: Schema.Defect(),
+}) {}

packages/httpapi-codegen/test/generated/client.ts

@@ -0,0 +1,16 @@
+// Generated by @opencode-ai/httpapi-codegen. Do not edit.
+import { Effect } from "effect"
+import { HttpApi, HttpApiClient } from "effect/unstable/httpapi"
+import { adaptGroup0, Group0 } from "./session"
+import { adaptGroup1, Group1 } from "./event"
+import { adaptGroup2, Group2 } from "./system"
+
+const Api = HttpApi.make("generated").add(Group0).add(Group1).add(Group2)
+const adaptClient = (raw: HttpApiClient.ForApi<typeof Api>) => ({
+  session: adaptGroup0(raw["session"]),
+  event: adaptGroup1(raw["event"]),
+  ...adaptGroup2({ status: raw["status"] }),
+})
+
+export const make = (options?: { readonly baseUrl?: URL | string }) =>
+  HttpApiClient.make(Api, options).pipe(Effect.map(adaptClient))

packages/httpapi-codegen/test/generated/event.ts

@@ -0,0 +1,39 @@
+// Generated by @opencode-ai/httpapi-codegen. Do not edit.
+import { Effect, Schema, Stream } from "effect"
+import { Sse } from "effect/unstable/encoding"
+import { HttpClientError } from "effect/unstable/http"
+import { HttpApiClient, HttpApiEndpoint, HttpApiGroup, HttpApiSchema } from "effect/unstable/httpapi"
+import { ClientError } from "./client-error"
+
+const Endpoint0SuccessData = Schema.Struct({ type: Schema.String })
+
+const Endpoint0SuccessError = Schema.Never
+
+export const Group1 = HttpApiGroup.make("event", { topLevel: false }).add(
+  HttpApiEndpoint.make("GET")("subscribe", "/event", {
+    success: HttpApiSchema.StreamSse({
+      data: Endpoint0SuccessData,
+      error: Endpoint0SuccessError,
+      contentType: "text/event-stream",
+    }).pipe(HttpApiSchema.status(202)),
+  }),
+)
+
+type RawGroup = HttpApiClient.Client.Group<typeof Group1, "event", never, never>
+
+const Endpoint0DeclaredError = Schema.Union([Endpoint0SuccessError])
+const mapEndpoint0Error = (error: unknown) =>
+  HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error)
+    ? new ClientError({ cause: error })
+    : Schema.is(Endpoint0DeclaredError)(error)
+      ? error
+      : new ClientError({ cause: error })
+const Endpoint0 = (raw: RawGroup) => () =>
+  Stream.unwrap(
+    raw["subscribe"]({}).pipe(
+      Effect.mapError(mapEndpoint0Error),
+      Effect.map((stream) => stream.pipe(Stream.mapError(mapEndpoint0Error))),
+    ),
+  )
+
+export const adaptGroup1 = (raw: RawGroup) => ({ subscribe: Endpoint0(raw) })

packages/httpapi-codegen/test/generated/index.ts

@@ -0,0 +1,2 @@
+export { ClientError } from "./client-error"
+export * as OpenCode from "./client"

packages/httpapi-codegen/test/generated/session.ts

@@ -0,0 +1,96 @@
+// Generated by @opencode-ai/httpapi-codegen. Do not edit.
+import { Effect, Schema } from "effect"
+import { Sse } from "effect/unstable/encoding"
+import { HttpClientError } from "effect/unstable/http"
+import { HttpApiClient, HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi"
+import { ClientError } from "./client-error"
+
+const Endpoint0Success = Schema.String
+
+const Endpoint1Query = Schema.Struct({ archived: Schema.optionalKey(Schema.Union([Schema.Boolean, Schema.Undefined])) })
+
+const Endpoint1Success = Schema.Array(Schema.String)
+
+const Endpoint2Params = Schema.Struct({ sessionID: Schema.String })
+
+const Endpoint2Success = Schema.Struct({ data: Schema.String })
+
+class Endpoint2Error0Class extends Schema.TaggedErrorClass<Endpoint2Error0Class>("Missing")("Missing", {
+  message: Schema.String,
+}) {}
+const Endpoint2Error0 = Endpoint2Error0Class.annotate({ httpApiStatus: 404 })
+
+const Endpoint3Params = Schema.Struct({ sessionID: Schema.String })
+
+const Endpoint3Success = Schema.Void.annotate({ httpApiStatus: 204 })
+
+export const Group0 = HttpApiGroup.make("session", { topLevel: false })
+  .add(HttpApiEndpoint.make("GET")("health", "/session/health", { success: Endpoint0Success }))
+  .add(HttpApiEndpoint.make("GET")("list", "/session", { query: Endpoint1Query, success: Endpoint1Success }))
+  .add(
+    HttpApiEndpoint.make("GET")("get", "/session/:sessionID", {
+      params: Endpoint2Params,
+      success: Endpoint2Success,
+      error: Endpoint2Error0,
+    }),
+  )
+  .add(
+    HttpApiEndpoint.make("POST")("interrupt", "/session/:sessionID/interrupt", {
+      params: Endpoint3Params,
+      success: Endpoint3Success,
+    }),
+  )
+
+type RawGroup = HttpApiClient.Client.Group<typeof Group0, "session", never, never>
+
+const Endpoint0DeclaredError = Schema.Never
+const mapEndpoint0Error = (error: unknown) =>
+  HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error)
+    ? new ClientError({ cause: error })
+    : Schema.is(Endpoint0DeclaredError)(error)
+      ? error
+      : new ClientError({ cause: error })
+const Endpoint0 = (raw: RawGroup) => () => raw["health"]({}).pipe(Effect.mapError(mapEndpoint0Error))
+
+type Endpoint1Input = { readonly archived?: (typeof Endpoint1Query.Type)["archived"] }
+const Endpoint1DeclaredError = Schema.Never
+const mapEndpoint1Error = (error: unknown) =>
+  HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error)
+    ? new ClientError({ cause: error })
+    : Schema.is(Endpoint1DeclaredError)(error)
+      ? error
+      : new ClientError({ cause: error })
+const Endpoint1 = (raw: RawGroup) => (input?: Endpoint1Input) =>
+  raw["list"]({ query: { archived: input?.["archived"] } }).pipe(Effect.mapError(mapEndpoint1Error))
+
+type Endpoint2Input = { readonly sessionID: (typeof Endpoint2Params.Type)["sessionID"] }
+const Endpoint2DeclaredError = Schema.Union([Endpoint2Error0])
+const mapEndpoint2Error = (error: unknown) =>
+  HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error)
+    ? new ClientError({ cause: error })
+    : Schema.is(Endpoint2DeclaredError)(error)
+      ? error
+      : new ClientError({ cause: error })
+const Endpoint2 = (raw: RawGroup) => (input: Endpoint2Input) =>
+  raw["get"]({ params: { sessionID: input["sessionID"] } }).pipe(
+    Effect.mapError(mapEndpoint2Error),
+    Effect.map((value) => value.data),
+  )
+
+type Endpoint3Input = { readonly sessionID: (typeof Endpoint3Params.Type)["sessionID"] }
+const Endpoint3DeclaredError = Schema.Never
+const mapEndpoint3Error = (error: unknown) =>
+  HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error)
+    ? new ClientError({ cause: error })
+    : Schema.is(Endpoint3DeclaredError)(error)
+      ? error
+      : new ClientError({ cause: error })
+const Endpoint3 = (raw: RawGroup) => (input: Endpoint3Input) =>
+  raw["interrupt"]({ params: { sessionID: input["sessionID"] } }).pipe(Effect.mapError(mapEndpoint3Error))
+
+export const adaptGroup0 = (raw: RawGroup) => ({
+  health: Endpoint0(raw),
+  list: Endpoint1(raw),
+  get: Endpoint2(raw),
+  interrupt: Endpoint3(raw),
+})

packages/httpapi-codegen/test/generated/system.ts

@@ -0,0 +1,25 @@
+// Generated by @opencode-ai/httpapi-codegen. Do not edit.
+import { Effect, Schema } from "effect"
+import { Sse } from "effect/unstable/encoding"
+import { HttpClientError } from "effect/unstable/http"
+import { HttpApiClient, HttpApiEndpoint, HttpApiGroup } from "effect/unstable/httpapi"
+import { ClientError } from "./client-error"
+
+const Endpoint0Success = Schema.String
+
+export const Group2 = HttpApiGroup.make("system", { topLevel: true }).add(
+  HttpApiEndpoint.make("GET")("status", "/status", { success: Endpoint0Success }),
+)
+
+type RawGroup = HttpApiClient.Client<typeof Group2>
+
+const Endpoint0DeclaredError = Schema.Never
+const mapEndpoint0Error = (error: unknown) =>
+  HttpClientError.isHttpClientError(error) || Schema.isSchemaError(error) || Sse.Retry.is(error)
+    ? new ClientError({ cause: error })
+    : Schema.is(Endpoint0DeclaredError)(error)
+      ? error
+      : new ClientError({ cause: error })
+const Endpoint0 = (raw: RawGroup) => () => raw["status"]({}).pipe(Effect.mapError(mapEndpoint0Error))
+
+export const adaptGroup2 = (raw: RawGroup) => ({ status: Endpoint0(raw) })