@opencode/ai 2.0.20 → 2.0.22

package/dist/schema/events.js

@@ -211,6 +211,10 @@ export const ToolError = Schema.Struct({
 export const FinishReasonDetails = Schema.Struct({
     normalized: FinishReason,
     raw: Schema.optional(Schema.String),
+    /** The provider's policy area for a content-filter finish, such as `cyber`. */
+    category: Schema.optional(Schema.String),
+    /** The provider's human-readable reason for a content-filter finish. */
+    explanation: Schema.optional(Schema.String),
 }).annotate({ identifier: "LLM.FinishReasonDetails" });
 export const StepFinish = Schema.Struct({
     type: Schema.tag("step-finish"),

package/dist/schema/options.d.ts

@@ -9,10 +9,21 @@ export type ProviderOptions = Schema.Schema.Type<typeof ProviderOptions>;
 export declare const ProviderMetadata: Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>;
 export type ProviderMetadata = Schema.Schema.Type<typeof ProviderMetadata>;
 export declare const mergeProviderOptions: (...items: ReadonlyArray<ProviderOptions | undefined>) => ProviderOptions | undefined;
+/** Milliseconds for an HTTP timeout, or `false` to disable it. */
+export declare const HttpTimeout: Schema.Union<readonly [Schema.Number, Schema.Literal<false>]>;
+export type HttpTimeout = Schema.Schema.Type<typeof HttpTimeout>;
+/** Applied to `headerTimeout` and `chunkTimeout` when a request leaves them unset. */
+export declare const DEFAULT_HTTP_TIMEOUT_MS = 300000;
 declare const HttpOptions_base: Schema.Class<HttpOptions, Schema.Struct<{
     readonly body: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
     readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly query: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    /** Time allowed for the whole request, from send until the response completes. Unbounded when unset. */
+    readonly timeout: Schema.optional<Schema.Union<readonly [Schema.Number, Schema.Literal<false>]>>;
+    /** Time allowed for response headers to arrive. */
+    readonly headerTimeout: Schema.optional<Schema.Union<readonly [Schema.Number, Schema.Literal<false>]>>;
+    /** Time allowed between streamed response chunks once headers have arrived. */
+    readonly chunkTimeout: Schema.optional<Schema.Union<readonly [Schema.Number, Schema.Literal<false>]>>;
 }>, {}>;
 export declare class HttpOptions extends HttpOptions_base {
 }

package/dist/schema/options.js

@@ -32,10 +32,20 @@ export const ProviderMetadata = Schema.Record(Schema.String, Schema.Record(Schem
     identifier: "LLM.ProviderMetadata",
 });
 export const mergeProviderOptions = (...items) => mergeJsonRecords(...items);
+/** Milliseconds for an HTTP timeout, or `false` to disable it. */
+export const HttpTimeout = Schema.Union([Schema.Number.check(Schema.isGreaterThan(0)), Schema.Literal(false)]);
+/** Applied to `headerTimeout` and `chunkTimeout` when a request leaves them unset. */
+export const DEFAULT_HTTP_TIMEOUT_MS = 300_000;
 export class HttpOptions extends Schema.Class("AI.HttpOptions")({
     body: Schema.optional(JsonSchema),
     headers: Schema.optional(Schema.Record(Schema.String, Schema.String)),
     query: Schema.optional(Schema.Record(Schema.String, Schema.String)),
+    /** Time allowed for the whole request, from send until the response completes. Unbounded when unset. */
+    timeout: Schema.optional(HttpTimeout),
+    /** Time allowed for response headers to arrive. */
+    headerTimeout: Schema.optional(HttpTimeout),
+    /** Time allowed between streamed response chunks once headers have arrived. */
+    chunkTimeout: Schema.optional(HttpTimeout),
 }) {
 }
 (function (HttpOptions) {
@@ -50,9 +60,12 @@ export const mergeHttpOptions = (...items) => {
     const body = mergeJsonRecords(...items.map((item) => item?.body));
     const headers = mergeStringRecords(...items.map((item) => item?.headers));
     const query = mergeStringRecords(...items.map((item) => item?.query));
-    if (!body && !headers && !query)
+    const timeout = items.findLast((item) => item?.timeout !== undefined)?.timeout;
+    const headerTimeout = items.findLast((item) => item?.headerTimeout !== undefined)?.headerTimeout;
+    const chunkTimeout = items.findLast((item) => item?.chunkTimeout !== undefined)?.chunkTimeout;
+    if (!body && !headers && !query && timeout === undefined && headerTimeout === undefined && chunkTimeout === undefined)
         return undefined;
-    return new HttpOptions({ body, headers, query });
+    return new HttpOptions({ body, headers, query, timeout, headerTimeout, chunkTimeout });
 };
 export class GenerationOptions extends Schema.Class("LLM.GenerationOptions")({
     maxTokens: Schema.optional(Schema.Number),

package/dist/testing.d.ts

@@ -228,6 +228,8 @@ export declare const complete: (options: {
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -241,6 +243,8 @@ export declare const complete: (options: {
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -440,6 +444,8 @@ export declare const stop: (...events: readonly LLMEvent[]) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -453,6 +459,8 @@ export declare const stop: (...events: readonly LLMEvent[]) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -652,6 +660,8 @@ export declare const toolCalls: (...events: readonly LLMEvent[]) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -665,6 +675,8 @@ export declare const toolCalls: (...events: readonly LLMEvent[]) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -864,6 +876,8 @@ export declare const text: (value: string, id: string) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -877,6 +891,8 @@ export declare const text: (value: string, id: string) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -1076,6 +1092,8 @@ export declare const textWithUsage: (value: string, id: string, inputTokens: num
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -1089,6 +1107,8 @@ export declare const textWithUsage: (value: string, id: string, inputTokens: num
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -1288,6 +1308,8 @@ export declare const tool: (id: string, name: string, input: unknown) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -1301,6 +1323,8 @@ export declare const tool: (id: string, name: string, input: unknown) => (({
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -1500,6 +1524,8 @@ export declare const failAfter: (error: AIError, ...events: readonly LLMEvent[])
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -1513,6 +1539,8 @@ export declare const failAfter: (error: AIError, ...events: readonly LLMEvent[])
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {
@@ -1712,6 +1740,8 @@ export declare const hangAfter: (...events: readonly LLMEvent[]) => Stream.Strea
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly index: number;
     readonly providerMetadata?: {
@@ -1725,6 +1755,8 @@ export declare const hangAfter: (...events: readonly LLMEvent[]) => Stream.Strea
     readonly reason: {
         readonly normalized: "length" | "stop" | "tool-calls" | "content-filter" | "error" | "unknown";
         readonly raw?: string | undefined;
+        readonly category?: string | undefined;
+        readonly explanation?: string | undefined;
     };
     readonly providerMetadata?: {
         readonly [x: string]: {

package/dist/tool-history.js

@@ -4,11 +4,19 @@ const MISSING_TOOL_RESULT = "Tool result missing";
 export function normalizeToolHistory(messages) {
     const normalized = [];
     const pending = new Map();
-    const appendMissingResults = () => {
-        if (pending.size === 0)
+    // System updates cannot sit between a tool call and its results, so they wait until every pending call is answered.
+    const held = [];
+    const releaseHeld = () => {
+        if (pending.size > 0)
             return;
-        normalized.push(missingToolResults(pending.values()));
+        normalized.push(...held);
+        held.length = 0;
+    };
+    const appendMissingResults = () => {
+        if (pending.size > 0)
+            normalized.push(missingToolResults(pending.values()));
         pending.clear();
+        releaseHeld();
     };
     for (const message of messages) {
         if (message.role === "user" || message.role === "assistant")
@@ -17,6 +25,11 @@ export function normalizeToolHistory(messages) {
             const tool = normalizeToolMessage(message, pending);
             if (tool)
                 normalized.push(tool);
+            releaseHeld();
+            continue;
+        }
+        if (message.role === "system" && pending.size > 0) {
+            held.push(message);
             continue;
         }
         normalized.push(message);
@@ -27,6 +40,7 @@ export function normalizeToolHistory(messages) {
                 pending.set(part.id, part);
         }
     }
+    appendMissingResults();
     return normalized.length === messages.length && normalized.every((message, index) => message === messages[index])
         ? messages
         : normalized;

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "2.0.20",
+  "version": "2.0.22",
   "name": "@opencode/ai",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,7 @@
   "devDependencies": {
     "@clack/prompts": "1.0.0-alpha.1",
     "@effect/platform-node": "4.0.0-rc.112",
-    "@opencode/http-recorder": "2.0.20",
+    "@opencode/http-recorder": "2.0.22",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.4.0",
     "@typescript/native-preview": "7.0.0-dev.20251207.1",
@@ -44,7 +44,7 @@
     "@aws-sdk/credential-providers": "3.1057.0",
     "@smithy/eventstream-codec": "4.2.14",
     "@smithy/util-utf8": "4.2.2",
-    "@opencode/schema": "2.0.20",
+    "@opencode/schema": "2.0.22",
     "aws4fetch": "1.0.20",
     "effect": "4.0.0-rc.112",
     "google-auth-library": "10.5.0"