@opengeni/sdk 4.4.1 → 4.5.0

package/README.md

@@ -1332,6 +1332,33 @@ unexpected successful non-JSON response to a mutation has `outcomeUnknown:
 true` because the mutation might already have been accepted. Never turn that
 condition into a new operation by changing its idempotency key.
 
+### Transient read retry
+
+Safe JSON reads (`GET` and `HEAD`) that fail transiently are retried quietly
+inside a small budget, so an API rolling deploy or a short network blip does
+not surface as an error. A failure is transient when the request never got a
+response (`fetch` rejected with a `TypeError`, such as a reset connection) or a
+gateway answered `502`, `503` or `504`. Retries use jittered exponential
+backoff, or the server's `Retry-After` when it fits the budget, and stop as
+soon as the caller's signal aborts. Every attempt of one call carries the same
+correlation ID. Mutations are never retried; they keep the `outcomeUnknown`
+semantics above. Auth, permission, not-found, validation, rate-limit and other
+server errors, and a success response the client cannot accept, surface
+immediately. A `Retry-After` gets up to 20% extra spread so clients told the
+same instant do not return together.
+
+```ts
+const client = new OpenGeniClient({
+  baseUrl,
+  // Defaults: 4 attempts, 250 ms first backoff, 2000 ms backoff cap, 5000 ms total.
+  readRetry: { maxAttempts: 4, initialDelayMs: 250, maxDelayMs: 2_000, maxElapsedMs: 5_000 },
+  // readRetry: false turns it off.
+});
+```
+
+`isTransientRequestError(error)` reports whether an error is this kind of
+transient failure, for callers that keep their own longer retry loop.
+
 ## Streaming guarantees
 
 `client.streamEvents(...)` (and the underlying `streamSessionEvents`) delivers

package/dist/adapters/next.js

@@ -1,10 +1,10 @@
 import {
   createSessionProxyHandler
-} from "../chunk-2RVPHF37.js";
+} from "../chunk-JBAGMSN2.js";
 import "../chunk-UM4ZXXJR.js";
 import "../chunk-QGEIL4TR.js";
 import "../chunk-72YZCZWF.js";
-import "../chunk-BLID3DCD.js";
+import "../chunk-V4AIZAFF.js";
 import "../chunk-ODKRQUWR.js";
 
 // src/adapters/next.ts

package/dist/artifacts.js

@@ -1,11 +1,11 @@
 import {
   OpenGeniClient
-} from "./chunk-3BWTS2MJ.js";
-import "./chunk-CT6P2W2C.js";
-import "./chunk-PVWOBYAZ.js";
+} from "./chunk-ARDVIZIJ.js";
+import "./chunk-WI3WUT5H.js";
+import "./chunk-BXMNDWAN.js";
 import "./chunk-X5ITQVXE.js";
 import "./chunk-72YZCZWF.js";
-import "./chunk-BLID3DCD.js";
+import "./chunk-V4AIZAFF.js";
 import "./chunk-POYRW6KT.js";
 import "./chunk-ODKRQUWR.js";
 export {

package/dist/browser.d.ts

@@ -6,6 +6,8 @@ export type { OpenGeniGeneratedTools, OpenGeniDynamicToolNode, OpenGeniToolCallO
 export type { FetchLike, FetchResponse, GetSessionOptions, OpenGeniClientOptions, OpenGeniRequestOptions, SendMessageInput, SteerMessageResult, TranscribeAudioInput, WorkspaceControlEventPage, } from "./client.js";
 export { OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniSetupError, OpenGeniAllowanceExhaustedError, OpenGeniSessionUsageLimitReachedError, OpenGeniSessionUsageLimitUnsupportedError, OpenGeniSecureContextRequiredError, OpenGeniSessionListCursorError, OpenGeniStreamError, formatErrorMessage, isRetryableStreamError, } from "./errors.js";
 export type { OpenGeniSecureContextRequiredReason } from "./errors.js";
+export { isTransientRequestError } from "./read-retry.js";
+export type { OpenGeniReadRetryOptions } from "./read-retry.js";
 export { resolveWorkspaceVoiceInputEnabled } from "./transcription.js";
 export { OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION } from "./types.js";
 export type { ConnectorToolPermission, ConnectorToolPermissionEntry, ConnectorToolPermissionsResponse, UpdateConnectorToolPermissionsRequest, SessionMcpToolPermissionsResponse, UpdateSessionMcpToolPermissionsRequest, } from "./types.js";

package/dist/browser.js

@@ -7,14 +7,15 @@ import {
   OpenGeniToolsClient
 } from "./chunk-ORYDCRFM.js";
 import {
-  OpenGeniClient
-} from "./chunk-PVWOBYAZ.js";
+  OpenGeniClient,
+  isTransientRequestError
+} from "./chunk-BXMNDWAN.js";
 import "./chunk-X5ITQVXE.js";
 import "./chunk-72YZCZWF.js";
 import {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION
-} from "./chunk-BLID3DCD.js";
+} from "./chunk-V4AIZAFF.js";
 import "./chunk-POYRW6KT.js";
 import {
   OpenGeniAllowanceExhaustedError,
@@ -47,6 +48,7 @@ export {
   OpenGeniToolsClient,
   formatErrorMessage,
   isRetryableStreamError,
+  isTransientRequestError,
   resolveWorkspaceVoiceInputEnabled
 };
 //# sourceMappingURL=browser.js.map

package/dist/chat/index.js

@@ -9,9 +9,9 @@ import {
 } from "../chunk-JO6THLOG.js";
 import {
   OpenGeniEmbeddingClient
-} from "../chunk-IVHLADZ7.js";
-import "../chunk-3BWTS2MJ.js";
-import "../chunk-CT6P2W2C.js";
+} from "../chunk-GRUMGFK6.js";
+import "../chunk-ARDVIZIJ.js";
+import "../chunk-WI3WUT5H.js";
 import {
   chatDefaults
 } from "../chunk-UM4ZXXJR.js";
@@ -24,12 +24,12 @@ import {
   humanInputPending,
   stringValue
 } from "../chunk-OV3POE62.js";
-import "../chunk-PVWOBYAZ.js";
+import "../chunk-BXMNDWAN.js";
 import "../chunk-X5ITQVXE.js";
 import {
   parseSseStream
 } from "../chunk-72YZCZWF.js";
-import "../chunk-BLID3DCD.js";
+import "../chunk-V4AIZAFF.js";
 import "../chunk-POYRW6KT.js";
 import {
   OpenGeniApiError,

package/dist/{chunk-3BWTS2MJ.js → chunk-ARDVIZIJ.js}

@@ -1,6 +1,6 @@
 import {
   OpenGeniDocumentAuthorityClient
-} from "./chunk-CT6P2W2C.js";
+} from "./chunk-WI3WUT5H.js";
 
 // src/artifact-client.ts
 var OpenGeniClient = class extends OpenGeniDocumentAuthorityClient {
@@ -121,4 +121,4 @@ var OpenGeniClient = class extends OpenGeniDocumentAuthorityClient {
 export {
   OpenGeniClient
 };
-//# sourceMappingURL=chunk-3BWTS2MJ.js.map
+//# sourceMappingURL=chunk-ARDVIZIJ.js.map