@opencode/ai 0.0.0-dev-21801 → 0.0.0-dev-21803

package/dist/index.js

@@ -1,28 +1,106 @@
-export { AIClient } from "./ai-client.js";
-export { LLMClient } from "./route/client.js";
-export { ImageClient } from "./image-client.js";
-export { Auth } from "./route/auth.js";
-export { Provider } from "./provider.js";
-export { ProviderPackage } from "./provider-package.js";
-export { isContextOverflow, isContextOverflowFailure, isRetryable } from "./provider-error.js";
-export * from "./schema/index.js";
-export { ImageAspectRatio, ImageEvent, ImageModel, ImageModelSchema, ImageRequest, ImageResponse } from "./image.js";
-export { Image } from "./image.js";
-export { VideoClient } from "./video-client.js";
-export { VideoAspectRatio, VideoEvent, VideoFrames, VideoModel, VideoModelSchema, VideoRequest, VideoResponse, } from "./video.js";
-export { Video } from "./video.js";
-export { SpeechClient } from "./speech-client.js";
-export { SpeechEvent, SpeechModel, SpeechModelSchema, SpeechRequest, SpeechResponse, SpeechTimestamp, SpeechVoice, } from "./speech.js";
-export { Speech } from "./speech.js";
-export { TranscriptionClient } from "./transcription-client.js";
-export { TranscriptionEvent, TranscriptionModel, TranscriptionModelSchema, TranscriptionRequest, TranscriptionResponse, TranscriptionSegment, TranscriptionTimestamps, TranscriptionWord, } from "./transcription.js";
-export { Transcription } from "./transcription.js";
-export { DecisionClient } from "./decision-client.js";
-export { ChoiceAnswer, ChoiceQuestion, ChoiceValue, DecisionAnswer, DecisionJsonPart, DecisionMediaPart, DecisionModel, DecisionModelCompatibility, DecisionModelSchema, DecisionPart, DecisionQuestion, DecisionRequest, DecisionResponse, DecisionTextPart, ErrorAnswer, PredicateAnswer, PredicateQuestion, ScoreAnswer, ScoreQuestion, } from "./decision.js";
-export { Decision } from "./decision.js";
-export { DecisionRoute } from "./route/decision.js";
-export { Media } from "./media.js";
-export { Generation } from "./generation.js";
-export { Tool, ToolFailure, toDefinitions } from "./tool.js";
-export { ToolRuntime } from "./tool-runtime.js";
-export * as LLM from "./llm.js";
+import { Effect, Layer, ManagedRuntime, Stream } from "effect";
+import { AIClient } from "./ai-client.js";
+import { Decision } from "./decision.js";
+import { Image } from "./image.js";
+import { LLM } from "./effect.js";
+import { Media } from "./media.js";
+import { RequestExecutor } from "./route/executor.js";
+import { AIError, InvalidRequestError, LanguageModel } from "./schema/index.js";
+import { Speech } from "./speech.js";
+import { Transcription, } from "./transcription.js";
+import { fileMediaType } from "./utils/media-type.js";
+import { Video } from "./video.js";
+// Fails with `signal.reason` so aborted calls reject and aborted streams throw like `fetch`: an `AbortError` by default.
+const abortEffect = (signal) => signal === undefined
+    ? Effect.never
+    : Effect.callback((resume) => {
+        if (signal.aborted) {
+            resume(Effect.fail(signal.reason));
+            return;
+        }
+        const onAbort = () => resume(Effect.fail(signal.reason));
+        signal.addEventListener("abort", onAbort, { once: true });
+        return Effect.sync(() => signal.removeEventListener("abort", onAbort));
+    });
+export const make = (options = {}) => {
+    const runtime = ManagedRuntime.make(AIClient.layerWith(options.layer ?? RequestExecutor.fetchLayer));
+    /** Run any package Effect (for example `LLMClient.compact(...)`) inside this runtime. */
+    const run = (effect, options) => runtime.runPromise(Effect.raceFirst(effect, abortEffect(options?.signal)));
+    const iterate = (stream, options) => Stream.toAsyncIterable(Stream.unwrap(runtime.contextEffect.pipe(Effect.map((context) => stream.pipe(Stream.interruptWhen(abortEffect(options?.signal)), Stream.provideContext(context))))));
+    const handle = (generation) => ({
+        ...generation.snapshot,
+        token: generation.token,
+        await: (options) => run(generation.await({ poll: options?.poll }), options),
+        events: (options) => iterate(generation.events({ poll: options?.poll }), options),
+        result: (options) => run(generation.result(), options),
+        refresh: (options) => run(generation.refresh(), options).then(handle),
+        cancel: (options) => run(generation.cancel(), options),
+    });
+    return {
+        run,
+        /** Decoded asset bytes, downloading `url` sources through the executor. */
+        bytes: (asset, options) => run(asset.bytes(), options),
+        base64: (asset, options) => run(asset.base64(), options),
+        /** Pull a `url` asset into owned bytes before the provider URL expires. */
+        materialize: (asset, options) => run(asset.materialize(), options),
+        /** Read a file into an asset like `Media.file`: sniffed media type, then the extension's. */
+        file: async (path, options) => {
+            const { readFile } = await import("node:fs/promises");
+            return run(Effect.tryPromise({
+                try: (signal) => readFile(path, { signal }),
+                catch: (cause) => fileError(`Failed to read media file ${path}`, cause),
+            }).pipe(Effect.map((buffer) => {
+                const data = new Uint8Array(buffer);
+                return Media.bytes(data, fileMediaType(data, path), options);
+            })), options);
+        },
+        /** Write an asset's bytes like `Media.write`, downloading `url` sources through the executor. */
+        write: async (asset, path, options) => {
+            const { writeFile } = await import("node:fs/promises");
+            return run(asset.bytes().pipe(Effect.flatMap((data) => Effect.tryPromise({
+                try: (signal) => writeFile(path, data, { signal }),
+                catch: (cause) => fileError(`Failed to write media file ${path}`, cause),
+            }))), options);
+        },
+        llm: {
+            request: LLM.request,
+            generate: (input, options) => run(LLM.generate(input), options),
+            stream: (input, options) => iterate(LLM.stream(input), options),
+        },
+        image: {
+            request: Image.request,
+            generate: (input, options) => run(Image.generate(input, { poll: options?.poll }), options),
+            stream: (input, options) => iterate(Image.stream(input, { poll: options?.poll }), options),
+            start: (input, options) => run(Image.start(input), options).then(handle),
+            resume: (model, token, options) => run(Image.resume(model, token), options).then(handle),
+        },
+        video: {
+            request: Video.request,
+            start: (input, options) => run(Video.start(input), options).then(handle),
+            generate: (input, options) => run(Video.generate(input, { poll: options?.poll }), options),
+            resume: (model, token, options) => run(Video.resume(model, token), options).then(handle),
+            stream: (input, options) => iterate(Video.stream(input, { poll: options?.poll }), options),
+        },
+        speech: {
+            request: Speech.request,
+            generate: (input, options) => run(Speech.generate(input), options),
+            stream: (input, options) => iterate(Speech.stream(input), options),
+        },
+        transcription: {
+            request: Transcription.request,
+            generate: (input, options) => run(Transcription.generate(input, { poll: options?.poll }), options),
+            stream: (input, options) => iterate(Transcription.stream(input, { poll: options?.poll }), options),
+            start: (input, options) => run(Transcription.start(input), options).then(handle),
+            resume: (model, token, options) => run(Transcription.resume(model, token), options).then(handle),
+        },
+        decision: {
+            request: Decision.request,
+            generate: (input, options) => run(Decision.generate(input), options),
+        },
+        dispose: () => runtime.dispose(),
+    };
+};
+const fileError = (message, cause) => new AIError({ reason: new InvalidRequestError({ message, cause }) });
+/** Default client over `RequestExecutor.fetchLayer` for scripts; the runtime builds its layer on first use. */
+export const ai = make();
+export * as AI from "./index.js";

package/dist/protocols/alibaba-responses.d.ts

@@ -172,15 +172,15 @@ export declare const protocol: Protocol<{
     } | undefined;
     readonly top_logprobs?: number | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
-    readonly service_tier?: import("../index.js").OpenString<"auto" | "default" | "flex" | "priority"> | undefined;
+    readonly service_tier?: import("../effect.js").OpenString<"auto" | "default" | "flex" | "priority"> | undefined;
     readonly prompt_cache_key?: string | undefined;
-    readonly include?: readonly import("../index.js").OpenString<"code_interpreter_call.outputs" | "computer_call_output.output.image_url" | "file_search_call.results" | "message.input_image.image_url" | "message.output_text.logprobs" | "reasoning.encrypted_content" | "web_search_call.action.sources" | "web_search_call.results">[] | undefined;
+    readonly include?: readonly import("../effect.js").OpenString<"code_interpreter_call.outputs" | "computer_call_output.output.image_url" | "file_search_call.results" | "message.input_image.image_url" | "message.output_text.logprobs" | "reasoning.encrypted_content" | "web_search_call.action.sources" | "web_search_call.results">[] | undefined;
     readonly reasoning?: {
         readonly effort?: OpenResponsesOptions.ReasoningEffort | undefined;
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
     } | undefined;
     readonly text?: {
-        readonly verbosity?: import("../index.js").OpenString<"high" | "low" | "medium"> | undefined;
+        readonly verbosity?: import("../effect.js").OpenString<"high" | "low" | "medium"> | undefined;
     } | undefined;
     readonly max_output_tokens?: number | undefined;
     readonly max_tool_calls?: number | undefined;

package/dist/protocols/openai-compatible-chat.d.ts

@@ -127,7 +127,7 @@ export declare const route: Route<{
     } | undefined;
     readonly store?: boolean | undefined;
     readonly prompt_cache_key?: string | undefined;
-    readonly reasoning_effort?: import("../index.js").ReasoningEffort | undefined;
+    readonly reasoning_effort?: import("../effect.js").ReasoningEffort | undefined;
     readonly tool_stream?: boolean | undefined;
     readonly max_completion_tokens?: number | undefined;
     readonly max_tokens?: number | undefined;

package/dist/protocols/openai-compatible-responses.d.ts

@@ -9,7 +9,7 @@ export declare const route: Route<{
     readonly input: readonly ({
         readonly type: "configuration_update";
         readonly reasoning: {
-            readonly effort: import("../index.js").ReasoningEffort;
+            readonly effort: import("../effect.js").ReasoningEffort;
         };
     } | {
         readonly type: "message";
@@ -166,15 +166,15 @@ export declare const route: Route<{
     } | undefined;
     readonly top_logprobs?: number | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
-    readonly service_tier?: import("../index.js").OpenString<"auto" | "default" | "flex" | "priority"> | undefined;
+    readonly service_tier?: import("../effect.js").OpenString<"auto" | "default" | "flex" | "priority"> | undefined;
     readonly prompt_cache_key?: string | undefined;
-    readonly include?: readonly import("../index.js").OpenString<"code_interpreter_call.outputs" | "computer_call_output.output.image_url" | "file_search_call.results" | "message.input_image.image_url" | "message.output_text.logprobs" | "reasoning.encrypted_content" | "web_search_call.action.sources" | "web_search_call.results">[] | undefined;
+    readonly include?: readonly import("../effect.js").OpenString<"code_interpreter_call.outputs" | "computer_call_output.output.image_url" | "file_search_call.results" | "message.input_image.image_url" | "message.output_text.logprobs" | "reasoning.encrypted_content" | "web_search_call.action.sources" | "web_search_call.results">[] | undefined;
     readonly reasoning?: {
-        readonly effort?: import("../index.js").ReasoningEffort | undefined;
+        readonly effort?: import("../effect.js").ReasoningEffort | undefined;
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
     } | undefined;
     readonly text?: {
-        readonly verbosity?: import("../index.js").OpenString<"high" | "low" | "medium"> | undefined;
+        readonly verbosity?: import("../effect.js").OpenString<"high" | "low" | "medium"> | undefined;
     } | undefined;
     readonly max_output_tokens?: number | undefined;
     readonly max_tool_calls?: number | undefined;

package/dist/protocols/utils/image-sizing.d.ts

@@ -30,5 +30,5 @@ export declare const nearest: (shape: Shape, sizes: ReadonlyArray<Size>) => Size
 /** Reports a size more than 2% off the requested aspect or more than √2 per edge off the requested tier. */
 export declare const notice: (name: string, shape: Shape, size: Size) => Media.Notice | undefined;
 /** Free width and height that must honor the shape; a size that misses it fails instead of returning a notice. */
-export declare const exact: (route: MediaProtocol.Identity, shape: Shape, limits: Limits) => Effect.Effect<undefined, never, never> | Effect.Effect<never, import("../../index.js").AIError, never> | Effect.Effect<Size, never, never>;
+export declare const exact: (route: MediaProtocol.Identity, shape: Shape, limits: Limits) => Effect.Effect<undefined, never, never> | Effect.Effect<never, import("../../effect.js").AIError, never> | Effect.Effect<Size, never, never>;
 export * as ImageSizing from "./image-sizing.js";

package/dist/speech-client.d.ts

@@ -9,7 +9,7 @@ export declare const Service: typeof SpeechClientService;
 export type Service = SpeechClientService;
 export declare const SpeechClient: {
     readonly layer: import("effect/Layer").Layer<SpeechClientService, never, import("./route/executor-service.js").RequestExecutorService>;
-    readonly generate: (request: SpeechRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Effect").Effect<SpeechResponse, import("./index.js").AIError, SpeechClientService>;
+    readonly generate: (request: SpeechRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Effect").Effect<SpeechResponse, import("./effect.js").AIError, SpeechClientService>;
     readonly stream: (request: SpeechRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Stream").Stream<{
         readonly type: "audio-delta";
         readonly chunk: Uint8Array<ArrayBufferLike>;
@@ -58,11 +58,11 @@ export declare const SpeechClient: {
                 readonly [x: string]: unknown;
             };
         } | undefined;
-    } | import("./generation.js").Observation, import("./index.js").AIError, SpeechClientService>;
-    readonly start: (request: SpeechRequestFor) => import("effect/Effect").Effect<import("./generation.js").Generation<SpeechResponse>, import("./index.js").AIError, SpeechClientService>;
+    } | import("./generation.js").Observation, import("./effect.js").AIError, SpeechClientService>;
+    readonly start: (request: SpeechRequestFor) => import("effect/Effect").Effect<import("./generation.js").Generation<SpeechResponse>, import("./effect.js").AIError, SpeechClientService>;
     readonly resume: (model: import("./speech.js").SpeechModel<{
         readonly [x: string]: unknown;
-    }>, token: unknown) => import("effect/Effect").Effect<import("./generation.js").Generation<SpeechResponse>, import("./index.js").AIError, SpeechClientService>;
+    }>, token: unknown) => import("effect/Effect").Effect<import("./generation.js").Generation<SpeechResponse>, import("./effect.js").AIError, SpeechClientService>;
     readonly Service: typeof SpeechClientService;
 };
 export {};

package/dist/transcription-client.d.ts

@@ -9,7 +9,7 @@ export declare const Service: typeof TranscriptionClientService;
 export type Service = TranscriptionClientService;
 export declare const TranscriptionClient: {
     readonly layer: import("effect/Layer").Layer<TranscriptionClientService, never, import("./route/executor-service.js").RequestExecutorService>;
-    readonly generate: (request: TranscriptionRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Effect").Effect<TranscriptionResponse, import("./index.js").AIError, TranscriptionClientService>;
+    readonly generate: (request: TranscriptionRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Effect").Effect<TranscriptionResponse, import("./effect.js").AIError, TranscriptionClientService>;
     readonly stream: (request: TranscriptionRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Stream").Stream<{
         readonly type: "text-delta";
         readonly delta: string;
@@ -74,11 +74,11 @@ export declare const TranscriptionClient: {
             };
         } | undefined;
         readonly type: "finish";
-    } | import("./generation.js").Observation, import("./index.js").AIError, TranscriptionClientService>;
-    readonly start: (request: TranscriptionRequestFor) => import("effect/Effect").Effect<import("./generation.js").Generation<TranscriptionResponse>, import("./index.js").AIError, TranscriptionClientService>;
+    } | import("./generation.js").Observation, import("./effect.js").AIError, TranscriptionClientService>;
+    readonly start: (request: TranscriptionRequestFor) => import("effect/Effect").Effect<import("./generation.js").Generation<TranscriptionResponse>, import("./effect.js").AIError, TranscriptionClientService>;
     readonly resume: (model: import("./transcription.js").TranscriptionModel<{
         readonly [x: string]: unknown;
-    }>, token: unknown) => import("effect/Effect").Effect<import("./generation.js").Generation<TranscriptionResponse>, import("./index.js").AIError, TranscriptionClientService>;
+    }>, token: unknown) => import("effect/Effect").Effect<import("./generation.js").Generation<TranscriptionResponse>, import("./effect.js").AIError, TranscriptionClientService>;
     readonly Service: typeof TranscriptionClientService;
 };
 export {};

package/dist/video-client.d.ts

@@ -9,7 +9,7 @@ export declare const Service: typeof VideoClientService;
 export type Service = VideoClientService;
 export declare const VideoClient: {
     readonly layer: import("effect/Layer").Layer<VideoClientService, never, import("./route/executor-service.js").RequestExecutorService>;
-    readonly generate: (request: VideoRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Effect").Effect<VideoResponse, import("./index.js").AIError, VideoClientService>;
+    readonly generate: (request: VideoRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Effect").Effect<VideoResponse, import("./effect.js").AIError, VideoClientService>;
     readonly stream: (request: VideoRequestFor, options?: import("./generation.js").AwaitOptions) => import("effect/Stream").Stream<{
         readonly type: "video";
         readonly index: number;
@@ -51,11 +51,11 @@ export declare const VideoClient: {
                 readonly [x: string]: unknown;
             };
         } | undefined;
-    } | import("./generation.js").Observation, import("./index.js").AIError, VideoClientService>;
-    readonly start: (request: VideoRequestFor) => import("effect/Effect").Effect<import("./generation.js").Generation<VideoResponse>, import("./index.js").AIError, VideoClientService>;
+    } | import("./generation.js").Observation, import("./effect.js").AIError, VideoClientService>;
+    readonly start: (request: VideoRequestFor) => import("effect/Effect").Effect<import("./generation.js").Generation<VideoResponse>, import("./effect.js").AIError, VideoClientService>;
     readonly resume: (model: import("./video.js").VideoModel<{
         readonly [x: string]: unknown;
-    }>, token: unknown) => import("effect/Effect").Effect<import("./generation.js").Generation<VideoResponse>, import("./index.js").AIError, VideoClientService>;
+    }>, token: unknown) => import("effect/Effect").Effect<import("./generation.js").Generation<VideoResponse>, import("./effect.js").AIError, VideoClientService>;
     readonly Service: typeof VideoClientService;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "0.0.0-dev-21801",
+  "version": "0.0.0-dev-21803",
   "name": "@opencode/ai",
   "type": "module",
   "license": "MIT",
@@ -19,9 +19,9 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
-    "./promise": {
-      "import": "./dist/promise.js",
-      "types": "./dist/promise.d.ts"
+    "./effect": {
+      "import": "./dist/effect.js",
+      "types": "./dist/effect.d.ts"
     },
     "./testing": {
       "import": "./dist/testing.js",
@@ -35,7 +35,7 @@
   "devDependencies": {
     "@clack/prompts": "1.0.0-alpha.1",
     "@effect/platform-node": "4.0.1",
-    "@opencode/http-recorder": "0.0.0-dev-21801",
+    "@opencode/http-recorder": "0.0.0-dev-21803",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.4.3",
     "@typescript/native": "npm:typescript@7.1.0-beta",
@@ -45,7 +45,7 @@
     "@aws-sdk/credential-providers": "3.1057.0",
     "@smithy/eventstream-codec": "4.2.14",
     "@smithy/util-utf8": "4.2.2",
-    "@opencode/schema": "0.0.0-dev-21801",
+    "@opencode/schema": "0.0.0-dev-21803",
     "aws4fetch": "1.0.20",
     "effect": "4.0.1",
     "google-auth-library": "10.5.0"