@zhivex-ai/core 1.21.0 → 1.23.0-next.0

package/dist/types/generation.d.ts

@@ -1,3 +1,4 @@
+import type { BoundedReplayBroadcastOptions } from "../bounded-broadcast.js";
 import type { z, ZodTypeAny } from "zod";
 import type { AgentApprovalRequest, AgentApprovalResolution, FinishReason, ProviderOptions, ReasoningConfig, RetryOptions, StructuredOutputConfig, StructuredOutputMode, TokenUsage } from "./common.js";
 import type { GenerateInputSource, ModelMessage, ToolCall, ToolChoice, ToolExecutionResult } from "./messages.js";
@@ -52,7 +53,10 @@ export type GenerateTextOptions<TModel extends LanguageModel = LanguageModel, TC
     }) => void | Promise<void>;
     /** Existing completed steps preceding this invocation. */
     stepOffset?: number;
+    /** Positive safe integer. Defaults to 1. */
     maxSteps?: number;
+    /** Streaming replay/queue limits. Full replay with overflow errors is the default. */
+    streamBuffer?: BoundedReplayBroadcastOptions;
     temperature?: number;
     maxTokens?: number;
     reasoning?: ReasoningConfig;
@@ -98,11 +102,13 @@ export interface GenerateObjectOutput<TSchema extends ZodTypeAny> extends Genera
 export interface StreamObjectResult<TSchema extends ZodTypeAny> {
     eventStream: AsyncIterable<ObjectStreamEvent<z.infer<TSchema>, Partial<z.infer<TSchema>>>>;
     partialObjectStream: AsyncIterable<Partial<z.infer<TSchema>>>;
+    /** Text only. Provider errors are reported by eventStream and collect(); await collect() to verify success. */
     textStream: AsyncIterable<string>;
     collect: () => Promise<GenerateObjectOutput<TSchema>>;
 }
 export interface StreamTextResult {
     eventStream: AsyncIterable<StreamEvent>;
+    /** Text only. Provider errors are reported by eventStream and collect(); await collect() to verify success. */
     textStream: AsyncIterable<string>;
     collect: () => Promise<GenerateTextOutput>;
 }

package/dist/types/generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/types/generation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../../src/types/generation.ts"],"names":[],"mappings":"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"}

package/dist/validate-max-steps.d.ts

@@ -0,0 +1,2 @@
+export declare const validateMaxSteps: (value: number | undefined) => number;
+//# sourceMappingURL=validate-max-steps.d.ts.map

package/dist/validate-max-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-max-steps.d.ts","sourceRoot":"","sources":["../src/validate-max-steps.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,UAAW,MAAM,GAAG,SAAS,KAAG,MAM5D,CAAC"}

package/dist/validate-max-steps.js

@@ -0,0 +1,9 @@
+import { ValidationError } from "./errors.js";
+export const validateMaxSteps = (value) => {
+    const resolved = value ?? 1;
+    if (!Number.isSafeInteger(resolved) || resolved < 1) {
+        throw new ValidationError('"maxSteps" must be a positive safe integer.');
+    }
+    return resolved;
+};
+//# sourceMappingURL=validate-max-steps.js.map

package/dist/validate-max-steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-max-steps.js","sourceRoot":"","sources":["../src/validate-max-steps.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAU,EAAE;IACpE,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,eAAe,CAAC,6CAA6C,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhivex-ai/core",
-  "version": "1.21.0",
+  "version": "1.23.0-next.0",
   "description": "Shared contracts and runtime helpers for Zhivex AI SDK.",
   "license": "MIT",
   "type": "module",