@opencode-ai/ai 0.0.0-bootstrap.0 → 0.0.0-next-15618

package/dist/route/auth-options.d.ts

@@ -0,0 +1,34 @@
+import type { Config, Redacted } from "effect";
+import { Auth } from "./auth";
+export type ApiKeyMode = "optional" | "required";
+export type AuthOverride = {
+    readonly auth: Auth.Definition;
+    readonly apiKey?: never;
+};
+export type OptionalApiKeyAuth = {
+    readonly apiKey?: string | Redacted.Redacted<string> | Config.Config<string | Redacted.Redacted<string>>;
+    readonly auth?: never;
+};
+export type RequiredApiKeyAuth = {
+    readonly apiKey: string | Redacted.Redacted<string> | Config.Config<string | Redacted.Redacted<string>>;
+    readonly auth?: never;
+};
+export type ProviderAuthOption<Mode extends ApiKeyMode> = AuthOverride | (Mode extends "optional" ? OptionalApiKeyAuth : RequiredApiKeyAuth);
+export type ModelOptions<Base, Mode extends ApiKeyMode> = Omit<Base, "apiKey" | "auth"> & ProviderAuthOption<Mode>;
+export type ModelArgs<Base, Mode extends ApiKeyMode> = Mode extends "optional" ? readonly [options?: ModelOptions<Base, Mode>] : readonly [options: ModelOptions<Base, Mode>];
+export type ModelFactory<Base, Mode extends ApiKeyMode, Model> = (id: string, ...args: ModelArgs<Base, Mode>) => Model;
+/**
+ * Require at least one of the keys in `T`. Use for option shapes where any
+ * subset of fields is acceptable but at least one must be present (e.g. Azure
+ * accepts `resourceName` or `baseURL`).
+ */
+export type AtLeastOne<T> = {
+    [K in keyof T]: Required<Pick<T, K>> & Partial<Omit<T, K>>;
+}[keyof T];
+/**
+ * Standard bearer-auth resolution for providers: honor an explicit `auth`
+ * override, otherwise resolve `apiKey` (option > config var) and apply it as
+ * a bearer token.
+ */
+export declare const bearer: (options: ProviderAuthOption<"optional">, envVar: string | ReadonlyArray<string>) => Auth.Definition;
+export * as AuthOptions from "./auth-options";

package/dist/route/auth-options.js

@@ -0,0 +1,14 @@
+import { Auth } from "./auth";
+/**
+ * Standard bearer-auth resolution for providers: honor an explicit `auth`
+ * override, otherwise resolve `apiKey` (option > config var) and apply it as
+ * a bearer token.
+ */
+export const bearer = (options, envVar) => {
+    if ("auth" in options && options.auth)
+        return options.auth;
+    return (Array.isArray(envVar) ? envVar : [envVar])
+        .reduce((auth, name) => auth.orElse(Auth.config(name)), Auth.optional("apiKey" in options ? options.apiKey : undefined, "apiKey"))
+        .bearer();
+};
+export * as AuthOptions from "./auth-options";

package/dist/route/auth.d.ts

@@ -0,0 +1,49 @@
+import { Config, Effect, Redacted } from "effect";
+import { Headers } from "effect/unstable/http";
+import { LLMError, type LLMRequest } from "../schema";
+export declare class MissingCredentialError extends Error {
+    readonly source: string;
+    readonly _tag = "MissingCredentialError";
+    constructor(source: string);
+}
+export type CredentialError = MissingCredentialError | Config.ConfigError;
+export type AuthError = CredentialError | LLMError;
+type Secret = string | Redacted.Redacted | Config.Config<string | Redacted.Redacted>;
+export interface AuthInput {
+    readonly request: LLMRequest;
+    readonly method: "POST" | "GET";
+    readonly url: string;
+    readonly body: string;
+    readonly headers: Headers.Headers;
+}
+export interface Credential {
+    readonly load: Effect.Effect<Redacted.Redacted, CredentialError>;
+    readonly orElse: (that: Credential) => Credential;
+    readonly bearer: () => Definition;
+    readonly header: (name: string) => Definition;
+    readonly pipe: <A>(f: (self: Credential) => A) => A;
+}
+export interface Definition {
+    readonly apply: (input: AuthInput) => Effect.Effect<Headers.Headers, AuthError>;
+    readonly andThen: (that: Definition) => Definition;
+    readonly orElse: (that: Definition) => Definition;
+    readonly pipe: <A>(f: (self: Definition) => A) => A;
+}
+export declare const isAuth: (input: unknown) => input is Definition;
+export declare const value: (secret: string, source?: string) => Credential;
+export declare const optional: (secret: Secret | undefined, source?: string) => Credential;
+export declare const config: (name: string) => Credential;
+export declare const effect: (load: Effect.Effect<Redacted.Redacted, CredentialError>) => Credential;
+export declare const none: Definition;
+export declare const headers: (input: Headers.Input) => Definition;
+export declare const remove: (name: string) => Definition;
+export declare const custom: (apply: (input: AuthInput) => Effect.Effect<Headers.Headers, LLMError>) => Definition;
+export declare const passthrough: Definition;
+export declare function bearer(source: Secret | Credential): Definition;
+export declare const apiKey: typeof bearer;
+export declare function header(name: string): (source: Secret | Credential) => Definition;
+export declare function header(name: string, source: Secret | Credential): Definition;
+export declare function bearerHeader(name: string): (source: Secret | Credential) => Definition;
+export declare function bearerHeader(name: string, source: Secret | Credential): Definition;
+export declare const toEffect: (input: Definition) => (authInput: AuthInput) => Effect.Effect<Headers.Headers, LLMError>;
+export * as Auth from "./auth";

package/dist/route/auth.js

@@ -0,0 +1,89 @@
+import { Config, Effect, Redacted } from "effect";
+import { Headers } from "effect/unstable/http";
+import { AuthenticationReason, InvalidRequestReason, LLMError } from "../schema";
+export class MissingCredentialError extends Error {
+    source;
+    _tag = "MissingCredentialError";
+    constructor(source) {
+        super(`Missing auth credential: ${source}`);
+        this.source = source;
+    }
+}
+export const isAuth = (input) => typeof input === "object" && input !== null && "apply" in input && typeof input.apply === "function";
+const credential = (load) => {
+    const self = {
+        load,
+        orElse: (that) => credential(load.pipe(Effect.catch(() => that.load))),
+        bearer: () => fromCredential(self, (secret) => ({ authorization: `Bearer ${secret}` })),
+        header: (name) => fromCredential(self, (secret) => ({ [name]: secret })),
+        pipe: (f) => f(self),
+    };
+    return self;
+};
+const auth = (apply) => {
+    const self = {
+        apply,
+        andThen: (that) => auth((input) => apply(input).pipe(Effect.flatMap((headers) => that.apply({ ...input, headers })))),
+        orElse: (that) => auth((input) => apply(input).pipe(Effect.catch(() => that.apply(input)))),
+        pipe: (f) => f(self),
+    };
+    return self;
+};
+const fromCredential = (source, render) => auth((input) => source.load.pipe(Effect.map((secret) => Headers.setAll(input.headers, render(Redacted.value(secret))))));
+const secretEffect = (secret, source) => {
+    const redacted = typeof secret === "string" ? Redacted.make(secret) : secret;
+    if (Redacted.value(redacted) === "")
+        return Effect.fail(new MissingCredentialError(source));
+    return Effect.succeed(redacted);
+};
+const credentialFromSecret = (secret, source) => {
+    if (typeof secret === "string" || Redacted.isRedacted(secret))
+        return credential(secretEffect(secret, source));
+    return credential(Effect.gen(function* () {
+        return yield* secretEffect(yield* secret, source);
+    }));
+};
+export const value = (secret, source = "value") => credentialFromSecret(secret, source);
+export const optional = (secret, source = "optional value") => secret === undefined
+    ? credential(Effect.fail(new MissingCredentialError(source)))
+    : credentialFromSecret(secret, source);
+export const config = (name) => credentialFromSecret(Config.redacted(name), name);
+export const effect = (load) => credential(load);
+export const none = auth((input) => Effect.succeed(input.headers));
+export const headers = (input) => auth((inputAuth) => Effect.succeed(Headers.setAll(inputAuth.headers, input)));
+export const remove = (name) => auth((input) => Effect.succeed(Headers.remove(input.headers, name)));
+export const custom = (apply) => auth(apply);
+export const passthrough = none;
+const credentialInput = (source) => typeof source === "string" || Redacted.isRedacted(source) || Config.isConfig(source)
+    ? credentialFromSecret(source, "value")
+    : source;
+export function bearer(source) {
+    return credentialInput(source).bearer();
+}
+export const apiKey = bearer;
+export function header(name, source) {
+    if (source === undefined) {
+        return (next) => credentialInput(next).header(name);
+    }
+    return credentialInput(source).header(name);
+}
+export function bearerHeader(name, source) {
+    const render = (input) => fromCredential(credentialInput(input), (secret) => ({ [name]: `Bearer ${secret}` }));
+    if (source === undefined)
+        return render;
+    return render(source);
+}
+const toLLMError = (error) => {
+    if (error instanceof MissingCredentialError || error instanceof Config.ConfigError) {
+        return new LLMError({
+            module: "Auth",
+            method: "apply",
+            reason: error instanceof MissingCredentialError
+                ? new AuthenticationReason({ message: error.message, kind: "missing" })
+                : new InvalidRequestReason({ message: `Failed to resolve auth config: ${error.message}` }),
+        });
+    }
+    return error;
+};
+export const toEffect = (input) => (authInput) => input.apply(authInput).pipe(Effect.mapError(toLLMError));
+export * as Auth from "./auth";

package/dist/route/client.d.ts

@@ -0,0 +1,330 @@
+import { Context, Effect, Layer, Schema, Stream } from "effect";
+import { Auth } from "./auth";
+import { Endpoint, type EndpointPatch } from "./endpoint";
+import { RequestExecutor } from "./executor";
+import { Framing } from "./framing";
+import { HttpTransport } from "./transport";
+import type { Transport, TransportRuntime } from "./transport";
+import type { Protocol } from "./protocol";
+import type { LLMError, PreparedRequestOf, ProtocolID, ProviderOptions } from "../schema";
+import { GenerationOptions, HttpOptions, LLMRequest, LLMResponse, Model, ModelLimits, LLMEvent, ProviderID } from "../schema";
+export interface RouteBody<Body> {
+    /** Schema for the validated provider-native body sent as the JSON request. */
+    readonly schema: Schema.Codec<Body, unknown>;
+    /** Build the provider-native body from a common `LLMRequest`. */
+    readonly from: (request: LLMRequest) => Effect.Effect<Body, LLMError>;
+}
+export interface Route<Body, Prepared = unknown> {
+    readonly id: string;
+    readonly provider?: ProviderID;
+    /** ProviderMetadata namespace emitted and consumed by this route. */
+    readonly providerMetadataKey?: string;
+    readonly protocol: ProtocolID;
+    readonly endpoint: Endpoint.Definition<Body>;
+    readonly auth: Auth.Definition;
+    readonly transport: Transport<Body, Prepared, unknown>;
+    readonly defaults: RouteDefaults;
+    readonly body: RouteBody<Body>;
+    readonly with: (patch: RoutePatch<Body, Prepared>) => Route<Body, Prepared>;
+    readonly model: (input: RouteMappedModelInput) => Model;
+    readonly prepareTransport: (body: Body, request: LLMRequest) => Effect.Effect<Prepared, LLMError>;
+    readonly streamPrepared: (prepared: Prepared, request: LLMRequest, runtime: TransportRuntime) => Stream.Stream<LLMEvent, LLMError>;
+}
+export type AnyRoute = Route<any, any>;
+export type HttpOptionsInput = HttpOptions.Input;
+export type RouteModelInput = Omit<Model.Input, "provider" | "route">;
+export type RouteRoutedModelInput = Omit<Model.Input, "route">;
+export interface RouteDefaults {
+    readonly headers?: Record<string, string>;
+    readonly limits?: ModelLimits;
+    readonly generation?: GenerationOptions;
+    readonly providerOptions?: ProviderOptions;
+    readonly http?: HttpOptions;
+}
+export interface RouteDefaultsInput {
+    readonly headers?: Record<string, string>;
+    readonly limits?: ModelLimits.Input;
+    readonly generation?: GenerationOptions.Input;
+    readonly providerOptions?: ProviderOptions;
+    readonly http?: HttpOptions.Input;
+}
+export interface RoutePatch<Body, Prepared> extends RouteDefaultsInput {
+    readonly id?: string;
+    readonly provider?: string | ProviderID;
+    readonly auth?: Auth.Definition;
+    readonly transport?: Transport<Body, Prepared, unknown>;
+    readonly endpoint?: EndpointPatch<Body>;
+}
+type RouteMappedModelInput = RouteModelInput | RouteRoutedModelInput;
+export declare const generationOptions: (input: GenerationOptions.Input | undefined) => GenerationOptions | undefined;
+export declare const httpOptions: (input: HttpOptionsInput | undefined) => HttpOptions | undefined;
+export interface Interface {
+    /**
+     * Compile a request through protocol body construction, validation, and HTTP
+     * preparation without sending it. Returns the prepared request including the
+     * provider-native body.
+     *
+     * Pass a `Body` type argument to statically expose the route's body
+     * shape (e.g. `prepare<OpenAIChatBody>(...)`) — the runtime body is
+     * identical, so this is a type-level assertion the caller makes about which
+     * route the request will resolve to.
+     */
+    readonly prepare: <Body = unknown>(request: LLMRequest) => Effect.Effect<PreparedRequestOf<Body>, LLMError>;
+    readonly stream: StreamMethod;
+    readonly generate: GenerateMethod;
+}
+export interface StreamMethod {
+    (request: LLMRequest): Stream.Stream<LLMEvent, LLMError>;
+}
+export interface GenerateMethod {
+    (request: LLMRequest): Effect.Effect<LLMResponse, LLMError>;
+}
+declare const Service_base: Context.ServiceClass<Service, "@opencode/LLMClient", Interface>;
+export declare class Service extends Service_base {
+}
+export interface MakeInput<Body, Frame, Event, State> {
+    /** Route id used in diagnostics and prepared request metadata. */
+    readonly id: string;
+    /** Provider identity for route-owned model construction. */
+    readonly provider?: string | ProviderID;
+    /** ProviderMetadata namespace emitted and consumed by this route. */
+    readonly providerMetadataKey?: string;
+    /** Semantic API contract — owns body construction, body schema, and parsing. */
+    readonly protocol: Protocol<Body, Frame, Event, State>;
+    /** Where the request is sent. */
+    readonly endpoint: Endpoint.Definition<Body>;
+    /** Per-request transport auth. Provider facades override this via `route.with(...)`. */
+    readonly auth?: Auth.Definition;
+    /** Stream framing — bytes -> frames before `protocol.stream.event` decoding. */
+    readonly framing: Framing.Definition<Frame>;
+    /** Static / per-request headers added before `auth` runs. */
+    readonly headers?: (input: {
+        readonly request: LLMRequest;
+    }) => Record<string, string>;
+    /** Route/request defaults used when compiling requests for this route. */
+    readonly defaults?: RouteDefaultsInput;
+}
+export interface MakeTransportInput<Body, Prepared, Frame, Event, State> {
+    /** Route id used in diagnostics and prepared request metadata. */
+    readonly id: string;
+    /** Provider identity for route-owned model construction. */
+    readonly provider?: string | ProviderID;
+    /** ProviderMetadata namespace emitted and consumed by this route. */
+    readonly providerMetadataKey?: string;
+    /** Semantic API contract — owns body construction, body schema, and parsing. */
+    readonly protocol: Protocol<Body, Frame, Event, State>;
+    /** Where the request is sent. */
+    readonly endpoint: Endpoint.Definition<Body>;
+    /** Per-request transport auth. Provider facades override this via `route.with(...)`. */
+    readonly auth?: Auth.Definition;
+    /** Static / per-request headers added before `auth` runs. */
+    readonly headers?: (input: {
+        readonly request: LLMRequest;
+    }) => Record<string, string>;
+    /** Runnable transport route. */
+    readonly transport: Transport<Body, Prepared, Frame>;
+    /** Route/request defaults used when compiling requests for this route. */
+    readonly defaults?: RouteDefaultsInput;
+}
+export declare function make<Body, Prepared, Frame, Event, State>(input: MakeTransportInput<Body, Prepared, Frame, Event, State>): Route<Body, Prepared>;
+/**
+ * Build a `Route` by composing the four orthogonal pieces of a deployment:
+ *
+ * - `Protocol` — what is the API I'm speaking?
+ * - `Endpoint` — where do I send the request?
+ * - `Auth` — how do I authenticate it?
+ * - `Framing` — how do I cut the response stream into protocol frames?
+ *
+ * Plus optional `headers` for cross-cutting deployment concerns (provider
+ * version pins, per-deployment quirks).
+ *
+ * This is the canonical route constructor. If a new route does not fit
+ * this four-axis model, add a purpose-built constructor rather than widening
+ * the public surface preemptively.
+ */
+export declare function make<Body, Frame, Event, State>(input: MakeInput<Body, Frame, Event, State>): Route<Body, HttpTransport.HttpPrepared<Frame>>;
+export declare const prepare: <Body = unknown>(request: LLMRequest) => Effect.Effect<PreparedRequestOf<Body>, LLMError>;
+export declare function stream(request: LLMRequest): Stream.Stream<LLMEvent, LLMError>;
+export declare function generate(request: LLMRequest): Effect.Effect<LLMResponse, LLMError>;
+export declare const streamRequest: (request: LLMRequest) => Stream.Stream<{
+    readonly type: "step-start";
+    readonly index: number;
+} | {
+    readonly type: "text-start";
+    readonly id: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "text-delta";
+    readonly id: string;
+    readonly text: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "text-end";
+    readonly id: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "reasoning-start";
+    readonly id: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "reasoning-delta";
+    readonly id: string;
+    readonly text: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "reasoning-end";
+    readonly id: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "tool-input-start";
+    readonly id: string;
+    readonly name: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "tool-input-delta";
+    readonly id: string;
+    readonly name: string;
+    readonly text: string;
+} | {
+    readonly type: "tool-input-end";
+    readonly id: string;
+    readonly name: string;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "tool-call";
+    readonly id: string;
+    readonly name: string;
+    readonly input: unknown;
+    readonly providerExecuted?: boolean | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "tool-result";
+    readonly id: string;
+    readonly name: string;
+    readonly result: {
+        readonly type: "json";
+        readonly value: unknown;
+    } | {
+        readonly type: "text";
+        readonly value: unknown;
+    } | {
+        readonly type: "error";
+        readonly value: unknown;
+    } | {
+        readonly type: "content";
+        readonly value: readonly ({
+            readonly type: "text";
+            readonly text: string;
+        } | {
+            readonly type: "file";
+            readonly uri: string;
+            readonly mime: string;
+            readonly name?: string | undefined;
+        })[];
+    };
+    readonly output?: {
+        readonly structured: unknown;
+        readonly content: readonly ({
+            readonly type: "text";
+            readonly text: string;
+        } | {
+            readonly type: "file";
+            readonly uri: string;
+            readonly mime: string;
+            readonly name?: string | undefined;
+        })[];
+    } | undefined;
+    readonly providerExecuted?: boolean | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "tool-error";
+    readonly id: string;
+    readonly name: string;
+    readonly message: string;
+    readonly error?: unknown;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "step-finish";
+    readonly index: number;
+    readonly reason: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
+    readonly usage?: import("..").Usage | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "finish";
+    readonly reason: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
+    readonly usage?: import("..").Usage | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+} | {
+    readonly type: "provider-error";
+    readonly message: string;
+    readonly classification?: "context-overflow" | undefined;
+    readonly providerMetadata?: {
+        readonly [x: string]: {
+            readonly [x: string]: unknown;
+        };
+    } | undefined;
+}, LLMError, Service>;
+export declare const layer: Layer.Layer<Service, never, RequestExecutor.Service>;
+export declare const Route: {
+    readonly make: typeof make;
+};
+export declare const LLMClient: {
+    readonly Service: typeof Service;
+    readonly layer: Layer.Layer<Service, never, RequestExecutor.Service>;
+    readonly prepare: <Body = unknown>(request: LLMRequest) => Effect.Effect<PreparedRequestOf<Body>, LLMError>;
+    readonly stream: typeof stream;
+    readonly generate: typeof generate;
+};
+export {};