@opengeni/sdk 0.57.0 → 1.0.0

package/dist/adapters/hono.d.ts

@@ -0,0 +1,16 @@
+/** Any web-standard handler: `createSessionProxyHandler`, `createChatHandler`, or your own. */
+export type WebHandler = (request: Request) => Promise<Response>;
+/** The part of Hono's context this adapter uses (no Hono dependency). */
+export type HonoContextLike = {
+    req: {
+        raw: Request;
+    };
+};
+/**
+ * Expose a web-standard handler as a Hono handler:
+ *
+ * ```ts
+ * app.all("/api/opengeni/*", toHonoHandler(handler));
+ * ```
+ */
+export declare function toHonoHandler(handler: WebHandler): (context: HonoContextLike) => Promise<Response>;

package/dist/adapters/hono.js

@@ -0,0 +1,8 @@
+// src/adapters/hono.ts
+function toHonoHandler(handler) {
+  return async (context) => await handler(context.req.raw);
+}
+export {
+  toHonoHandler
+};
+//# sourceMappingURL=hono.js.map

package/dist/adapters/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/hono.ts"],"sourcesContent":["/** Any web-standard handler: `createSessionProxyHandler`, `createChatHandler`, or your own. */\nexport type WebHandler = (request: Request) => Promise<Response>;\n\n/** The part of Hono's context this adapter uses (no Hono dependency). */\nexport type HonoContextLike = { req: { raw: Request } };\n\n/**\n * Expose a web-standard handler as a Hono handler:\n *\n * ```ts\n * app.all(\"/api/opengeni/*\", toHonoHandler(handler));\n * ```\n */\nexport function toHonoHandler(\n  handler: WebHandler,\n): (context: HonoContextLike) => Promise<Response> {\n  return async (context) => await handler(context.req.raw);\n}\n"],"mappings":";AAaO,SAAS,cACd,SACiD;AACjD,SAAO,OAAO,YAAY,MAAM,QAAQ,QAAQ,IAAI,GAAG;AACzD;","names":[]}

package/dist/adapters/next.d.ts

@@ -0,0 +1,29 @@
+import { createSessionProxyHandler, type SessionProxyHandlerOptions } from "../session-proxy.js";
+/** Any web-standard handler: `createSessionProxyHandler`, `createChatHandler`, or your own. */
+export type WebHandler = (request: Request) => Promise<Response>;
+/** Route handlers for a Next.js App Router catch-all route. */
+export type NextRouteHandlers = {
+    GET: WebHandler;
+    POST: WebHandler;
+    PUT: WebHandler;
+    PATCH: WebHandler;
+    DELETE: WebHandler;
+};
+/**
+ * Expose a web-standard handler as Next.js App Router route handlers.
+ *
+ * ```ts
+ * // app/api/opengeni/[...path]/route.ts
+ * export const dynamic = "force-dynamic";
+ * export const { GET, POST, PUT, PATCH, DELETE } = toNextRouteHandlers(handler);
+ * ```
+ *
+ * Next passes the full request URL (including any `basePath`), so the proxy's
+ * own `/v1/` detection routes it; responses, including SSE, stream as-is.
+ */
+export declare function toNextRouteHandlers(handler: WebHandler): NextRouteHandlers;
+/**
+ * `createSessionProxyHandler` as Next.js App Router route handlers, for
+ * `app/<mount>/[...path]/route.ts`.
+ */
+export declare function createSessionProxyRoute(target: Parameters<typeof createSessionProxyHandler>[0], options: SessionProxyHandlerOptions): NextRouteHandlers;

package/dist/adapters/next.js

@@ -0,0 +1,22 @@
+import {
+  createSessionProxyHandler
+} from "../chunk-RWKB6YZG.js";
+import "../chunk-UM4ZXXJR.js";
+import "../chunk-U6CV2SXO.js";
+import "../chunk-APXVSSSY.js";
+import "../chunk-YIKA2QT4.js";
+import "../chunk-V6GIY62B.js";
+
+// src/adapters/next.ts
+function toNextRouteHandlers(handler) {
+  const route = async (request) => await handler(request);
+  return { GET: route, POST: route, PUT: route, PATCH: route, DELETE: route };
+}
+function createSessionProxyRoute(target, options) {
+  return toNextRouteHandlers(createSessionProxyHandler(target, options));
+}
+export {
+  createSessionProxyRoute,
+  toNextRouteHandlers
+};
+//# sourceMappingURL=next.js.map

package/dist/adapters/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/next.ts"],"sourcesContent":["import { createSessionProxyHandler, type SessionProxyHandlerOptions } from \"../session-proxy\";\n\n/** Any web-standard handler: `createSessionProxyHandler`, `createChatHandler`, or your own. */\nexport type WebHandler = (request: Request) => Promise<Response>;\n\n/** Route handlers for a Next.js App Router catch-all route. */\nexport type NextRouteHandlers = {\n  GET: WebHandler;\n  POST: WebHandler;\n  PUT: WebHandler;\n  PATCH: WebHandler;\n  DELETE: WebHandler;\n};\n\n/**\n * Expose a web-standard handler as Next.js App Router route handlers.\n *\n * ```ts\n * // app/api/opengeni/[...path]/route.ts\n * export const dynamic = \"force-dynamic\";\n * export const { GET, POST, PUT, PATCH, DELETE } = toNextRouteHandlers(handler);\n * ```\n *\n * Next passes the full request URL (including any `basePath`), so the proxy's\n * own `/v1/` detection routes it; responses, including SSE, stream as-is.\n */\nexport function toNextRouteHandlers(handler: WebHandler): NextRouteHandlers {\n  // Next calls route handlers with (request, context); only the request matters.\n  const route: WebHandler = async (request) => await handler(request);\n  return { GET: route, POST: route, PUT: route, PATCH: route, DELETE: route };\n}\n\n/**\n * `createSessionProxyHandler` as Next.js App Router route handlers, for\n * `app/<mount>/[...path]/route.ts`.\n */\nexport function createSessionProxyRoute(\n  target: Parameters<typeof createSessionProxyHandler>[0],\n  options: SessionProxyHandlerOptions,\n): NextRouteHandlers {\n  return toNextRouteHandlers(createSessionProxyHandler(target, options));\n}\n"],"mappings":";;;;;;;;;;AA0BO,SAAS,oBAAoB,SAAwC;AAE1E,QAAM,QAAoB,OAAO,YAAY,MAAM,QAAQ,OAAO;AAClE,SAAO,EAAE,KAAK,OAAO,MAAM,OAAO,KAAK,OAAO,OAAO,OAAO,QAAQ,MAAM;AAC5E;AAMO,SAAS,wBACd,QACA,SACmB;AACnB,SAAO,oBAAoB,0BAA0B,QAAQ,OAAO,CAAC;AACvE;","names":[]}

package/dist/allowance-refusal.d.ts

@@ -0,0 +1,2 @@
+/** Browser-safe allowance presentation without exposing the server core. */
+export { allowanceExhaustedMessage, parseAllowanceExhaustedRefusal, } from "@opengeni/contracts/allowance-refusal";

package/dist/allowance-refusal.js

@@ -0,0 +1,50 @@
+// ../contracts/src/allowance-refusal.ts
+var MESSAGE_MAX_UTF8_BYTES = 1024;
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function resetTimestamp(value) {
+  if (value === null) return true;
+  if (typeof value !== "string" || value.length > 64) return false;
+  const parts = /^(\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/.exec(
+    value
+  );
+  if (!parts || !Number.isFinite(Date.parse(value))) return false;
+  const year = Number(parts[1]);
+  const month = Number(parts[2]);
+  const day = Number(parts[3]);
+  const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const days = [31, leapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  return day <= days[month - 1];
+}
+function parseAllowanceExhaustedRefusal(value) {
+  const source = record(value);
+  if (source?.code !== "allowance_exhausted") return null;
+  const fields = record(source.details) ?? source;
+  const scope = fields.scope;
+  const subjectId = scope === "member" ? fields.subjectId : void 0;
+  if (typeof source.message !== "string" || scope !== "workspace" && scope !== "member" || !resetTimestamp(fields.resetsAt) || subjectId !== void 0 && (typeof subjectId !== "string" || subjectId.length === 0 || subjectId.length > 1024 || subjectId.includes("\0"))) {
+    return null;
+  }
+  const normalized = source.message.slice(0, MESSAGE_MAX_UTF8_BYTES * 2).replace(/[\u0000-\u001f\u007f]+/g, " ").trim();
+  const bytes = new TextEncoder().encode(normalized.slice(0, MESSAGE_MAX_UTF8_BYTES * 2));
+  let end = Math.min(bytes.length, MESSAGE_MAX_UTF8_BYTES);
+  while (end > 0 && end < bytes.length && (bytes[end] & 192) === 128) end -= 1;
+  return {
+    code: "allowance_exhausted",
+    scope,
+    resetsAt: fields.resetsAt,
+    ...typeof subjectId === "string" ? { subjectId } : {},
+    message: new TextDecoder().decode(bytes.slice(0, end)).trim()
+  };
+}
+function allowanceExhaustedMessage(refusal) {
+  const remedy = refusal.scope === "workspace" ? "The workspace usage allowance is exhausted. An organization administrator or a full-access organization API key can raise the workspace ceiling or add an allowance grant." : "The member usage allowance is exhausted. A workspace administrator or a full-access organization API key can adjust the member ceiling.";
+  const reset = refusal.resetsAt === null ? "This allowance has no automatic reset." : `It resets at ${new Date(refusal.resetsAt).toISOString().slice(0, 16).replace("T", " ")} UTC.`;
+  return `${remedy} ${reset}`;
+}
+export {
+  allowanceExhaustedMessage,
+  parseAllowanceExhaustedRefusal
+};
+//# sourceMappingURL=allowance-refusal.js.map

package/dist/allowance-refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../contracts/src/allowance-refusal.ts"],"sourcesContent":["import type { AllowanceExhaustedRefusal } from \"./usage-allowances\";\n\nconst MESSAGE_MAX_UTF8_BYTES = 1_024;\n\nfunction record(value: unknown): Record<string, unknown> | null {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\n/** Mirror the canonical offset datetime's calendar/time bounds without loading\n * the schema runtime into synchronous browser/React Native session projection.\n * Contract-parity tests guard this deliberately small, bounded wire leaf.\n */\nfunction resetTimestamp(value: unknown): value is string | null {\n  if (value === null) return true;\n  if (typeof value !== \"string\" || value.length > 64) return false;\n  const parts =\n    /^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$/.exec(\n      value,\n    );\n  if (!parts || !Number.isFinite(Date.parse(value))) return false;\n  const year = Number(parts[1]);\n  const month = Number(parts[2]);\n  const day = Number(parts[3]);\n  const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);\n  const days = [31, leapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];\n  return day <= days[month - 1]!;\n}\n\n/** Select only public refusal fields, including from an API error's details.\n * LimitDecision's allowed:false and transport/SQL diagnostics never cross out.\n */\nexport function parseAllowanceExhaustedRefusal(value: unknown): AllowanceExhaustedRefusal | null {\n  const source = record(value);\n  if (source?.code !== \"allowance_exhausted\") return null;\n  const fields = record(source.details) ?? source;\n  const scope = fields.scope;\n  const subjectId = scope === \"member\" ? fields.subjectId : undefined;\n  if (\n    typeof source.message !== \"string\" ||\n    (scope !== \"workspace\" && scope !== \"member\") ||\n    !resetTimestamp(fields.resetsAt) ||\n    (subjectId !== undefined &&\n      (typeof subjectId !== \"string\" ||\n        subjectId.length === 0 ||\n        subjectId.length > 1_024 ||\n        subjectId.includes(\"\\0\")))\n  ) {\n    return null;\n  }\n  const normalized = source.message\n    .slice(0, MESSAGE_MAX_UTF8_BYTES * 2)\n    .replace(/[\\u0000-\\u001f\\u007f]+/g, \" \")\n    .trim();\n  const bytes = new TextEncoder().encode(normalized.slice(0, MESSAGE_MAX_UTF8_BYTES * 2));\n  let end = Math.min(bytes.length, MESSAGE_MAX_UTF8_BYTES);\n  while (end > 0 && end < bytes.length && (bytes[end]! & 0xc0) === 0x80) end -= 1;\n  return {\n    code: \"allowance_exhausted\",\n    scope,\n    resetsAt: fields.resetsAt,\n    ...(typeof subjectId === \"string\" ? { subjectId } : {}),\n    message: new TextDecoder().decode(bytes.slice(0, end)).trim(),\n  };\n}\n\n/** Bounded, fixed remedies: a ceiling is not an exhausted billing source.\n * Never interpolate arbitrary exception prose or a member identifier.\n */\nexport function allowanceExhaustedMessage(refusal: AllowanceExhaustedRefusal): string {\n  const remedy =\n    refusal.scope === \"workspace\"\n      ? \"The workspace usage allowance is exhausted. An organization administrator or a full-access organization API key can raise the workspace ceiling or add an allowance grant.\"\n      : \"The member usage allowance is exhausted. A workspace administrator or a full-access organization API key can adjust the member ceiling.\";\n  const reset =\n    refusal.resetsAt === null\n      ? \"This allowance has no automatic reset.\"\n      : `It resets at ${new Date(refusal.resetsAt).toISOString().slice(0, 16).replace(\"T\", \" \")} UTC.`;\n  return `${remedy} ${reset}`;\n}\n"],"mappings":";AAEA,IAAM,yBAAyB;AAE/B,SAAS,OAAO,OAAgD;AAC9D,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IACrE,QACD;AACN;AAMA,SAAS,eAAe,OAAwC;AAC9D,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,GAAI,QAAO;AAC3D,QAAM,QACJ,sIAAsI;AAAA,IACpI;AAAA,EACF;AACF,MAAI,CAAC,SAAS,CAAC,OAAO,SAAS,KAAK,MAAM,KAAK,CAAC,EAAG,QAAO;AAC1D,QAAM,OAAO,OAAO,MAAM,CAAC,CAAC;AAC5B,QAAM,QAAQ,OAAO,MAAM,CAAC,CAAC;AAC7B,QAAM,MAAM,OAAO,MAAM,CAAC,CAAC;AAC3B,QAAM,WAAW,OAAO,MAAM,MAAM,OAAO,QAAQ,KAAK,OAAO,QAAQ;AACvE,QAAM,OAAO,CAAC,IAAI,WAAW,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE;AAC5E,SAAO,OAAO,KAAK,QAAQ,CAAC;AAC9B;AAKO,SAAS,+BAA+B,OAAkD;AAC/F,QAAM,SAAS,OAAO,KAAK;AAC3B,MAAI,QAAQ,SAAS,sBAAuB,QAAO;AACnD,QAAM,SAAS,OAAO,OAAO,OAAO,KAAK;AACzC,QAAM,QAAQ,OAAO;AACrB,QAAM,YAAY,UAAU,WAAW,OAAO,YAAY;AAC1D,MACE,OAAO,OAAO,YAAY,YACzB,UAAU,eAAe,UAAU,YACpC,CAAC,eAAe,OAAO,QAAQ,KAC9B,cAAc,WACZ,OAAO,cAAc,YACpB,UAAU,WAAW,KACrB,UAAU,SAAS,QACnB,UAAU,SAAS,IAAI,IAC3B;AACA,WAAO;AAAA,EACT;AACA,QAAM,aAAa,OAAO,QACvB,MAAM,GAAG,yBAAyB,CAAC,EACnC,QAAQ,2BAA2B,GAAG,EACtC,KAAK;AACR,QAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,WAAW,MAAM,GAAG,yBAAyB,CAAC,CAAC;AACtF,MAAI,MAAM,KAAK,IAAI,MAAM,QAAQ,sBAAsB;AACvD,SAAO,MAAM,KAAK,MAAM,MAAM,WAAW,MAAM,GAAG,IAAK,SAAU,IAAM,QAAO;AAC9E,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,GAAI,OAAO,cAAc,WAAW,EAAE,UAAU,IAAI,CAAC;AAAA,IACrD,SAAS,IAAI,YAAY,EAAE,OAAO,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,KAAK;AAAA,EAC9D;AACF;AAKO,SAAS,0BAA0B,SAA4C;AACpF,QAAM,SACJ,QAAQ,UAAU,cACd,+KACA;AACN,QAAM,QACJ,QAAQ,aAAa,OACjB,2CACA,gBAAgB,IAAI,KAAK,QAAQ,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,KAAK,GAAG,CAAC;AAC7F,SAAO,GAAG,MAAM,IAAI,KAAK;AAC3B;","names":[]}

package/dist/artifact-catalog.d.ts

@@ -0,0 +1,31 @@
+import type { RetainedArtifactReference } from "./types.js";
+export type ArtifactCatalogKind = "site" | "document" | "spreadsheet" | "presentation" | "image" | "file";
+/** Native IDs are unique within a kind; use `${kind}:${id}` as a UI key. */
+export type ArtifactCatalogItem = {
+    id: string;
+    kind: ArtifactCatalogKind;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    status: "active" | "archived";
+    /** Present only when the viewer can read this session. */
+    sourceSessionId?: string;
+    versionId?: string;
+    file?: RetainedArtifactReference;
+    filename?: string;
+    contentType?: string;
+    sizeBytes?: number;
+};
+export type ArtifactCatalogListOptions = {
+    sourceSessionId?: string;
+    q?: string;
+    kind?: ArtifactCatalogKind;
+    sort?: "updated" | "newest" | "title";
+    status?: "active" | "archived";
+    limit?: number;
+    cursor?: string;
+};
+export type ArtifactCatalogListResponse = {
+    items: ArtifactCatalogItem[];
+    nextCursor: string | null;
+};

package/dist/artifact-client.d.ts

@@ -1,8 +1,11 @@
-import { OpenGeniClient as OpenGeniCoreClient } from "./client.js";
+import { OpenGeniDocumentAuthorityClient } from "./document-authority-client.js";
+import type { FetchResponse } from "./client.js";
+import type { SiteToolCallRequest } from "./site-tool-bridge.js";
+import type { ToolGatewayCallResponse } from "./types.js";
+import type { CreateWorkspaceArtifactRequest, PublishWorkspaceArtifactVersionRequest, WorkspaceArtifactContentResponse, WorkspaceArtifactMutationResponse } from "./workspace-artifacts.js";
 import type { CreateEditableArtifactMaterializationRequest, CreateEditableArtifactResourceRequest, EditableArtifactListResource, EditableArtifactMaterializationJobResource, EditableArtifactPinnedVersionResource, EditableArtifactResource, ImportEditableArtifactResourceRequest, ListSessionEditableArtifactResourcesOptions, PinEditableArtifactVersionRequest, ReadEditableArtifactMaterializationOptions, ReadEditableArtifactResourceOptions } from "./editable-artifact-resources.js";
-import type { CreateWorkspaceArtifactRequest, PublishWorkspaceArtifactVersionRequest, RollbackWorkspaceArtifactRequest, WorkspaceArtifactContentResponse, WorkspaceArtifactDetailResponse, WorkspaceArtifactListOptions, WorkspaceArtifactListResponse, WorkspaceArtifactMutationResponse } from "./workspace-artifacts.js";
-/** Public SDK client. Artifact operations stay out of the console's eager core graph. */
-export declare class OpenGeniClient extends OpenGeniCoreClient {
+/** Public SDK client. Optional operator and artifact operations stay out of the console core. */
+export declare class OpenGeniClient extends OpenGeniDocumentAuthorityClient {
     createEditableArtifact(workspaceId: string, request: CreateEditableArtifactResourceRequest, options?: Readonly<{
         signal?: AbortSignal | undefined;
     }>): Promise<EditableArtifactResource>;
@@ -19,11 +22,20 @@ export declare class OpenGeniClient extends OpenGeniCoreClient {
     }>): Promise<EditableArtifactMaterializationJobResource>;
     getEditableArtifactMaterialization(workspaceId: string, artifactId: string, jobId: string, options: ReadEditableArtifactMaterializationOptions): Promise<EditableArtifactMaterializationJobResource>;
     /** The caller owns the returned bounded response stream. */
-    downloadEditableArtifactMaterialization(workspaceId: string, artifactId: string, jobId: string, options: ReadEditableArtifactMaterializationOptions): Promise<Response>;
-    listWorkspaceArtifacts(workspaceId: string, options?: WorkspaceArtifactListOptions): Promise<WorkspaceArtifactListResponse>;
-    getWorkspaceArtifact(workspaceId: string, artifactId: string): Promise<WorkspaceArtifactDetailResponse>;
-    getWorkspaceArtifactContent(workspaceId: string, artifactId: string, versionId?: string): Promise<WorkspaceArtifactContentResponse>;
-    createWorkspaceArtifact(workspaceId: string, request: CreateWorkspaceArtifactRequest): Promise<WorkspaceArtifactMutationResponse>;
-    publishWorkspaceArtifactVersion(workspaceId: string, artifactId: string, request: PublishWorkspaceArtifactVersionRequest): Promise<WorkspaceArtifactMutationResponse>;
-    rollbackWorkspaceArtifact(workspaceId: string, artifactId: string, request: RollbackWorkspaceArtifactRequest): Promise<WorkspaceArtifactMutationResponse>;
+    downloadEditableArtifactMaterialization(workspaceId: string, artifactId: string, jobId: string, options: ReadEditableArtifactMaterializationOptions): Promise<FetchResponse>;
+    /** Exact Site-version gateway call. Keep this client on the authenticated host;
+     * the API enforces live viewer access and the version's declared tool allowlist. */
+    callWorkspaceSiteTool(workspaceId: string, request: SiteToolCallRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<ToolGatewayCallResponse>;
+    getWorkspaceArtifactContent(workspaceId: string, artifactId: string, versionOrOptions?: string | {
+        versionId?: string;
+        signal?: AbortSignal;
+    }): Promise<WorkspaceArtifactContentResponse>;
+    createWorkspaceArtifact(workspaceId: string, request: CreateWorkspaceArtifactRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<WorkspaceArtifactMutationResponse>;
+    publishWorkspaceArtifactVersion(workspaceId: string, artifactId: string, request: PublishWorkspaceArtifactVersionRequest, options?: {
+        signal?: AbortSignal;
+    }): Promise<WorkspaceArtifactMutationResponse>;
 }

package/dist/artifacts.d.ts

@@ -1,4 +1,4 @@
 /** Artifact-only API client entry; keeps unrelated SDK surfaces out of editor bundles. */
 export { OpenGeniClient } from "./artifact-client.js";
 export type { CreateEditableArtifactMaterializationRequest, CreateEditableArtifactResourceRequest, EditableArtifactListResource, EditableArtifactMaterializationFormat, EditableArtifactMaterializationJobResource, EditableArtifactMaterializationResultResource, EditableArtifactPinnedVersionResource, EditableArtifactResource, ListSessionEditableArtifactResourcesOptions, PinEditableArtifactVersionRequest, ReadEditableArtifactMaterializationOptions, ReadEditableArtifactResourceOptions, } from "./editable-artifact-resources.js";
-export type { FetchLike, OpenGeniClientOptions, OpenGeniRequestOptions } from "./client.js";
+export type { FetchLike, FetchResponse, GetSessionOptions, OpenGeniClientOptions, OpenGeniRequestOptions, } from "./client.js";

package/dist/artifacts.js

@@ -1,10 +1,12 @@
 import {
   OpenGeniClient
-} from "./chunk-JRPFWI6T.js";
-import "./chunk-PKQ377ED.js";
-import "./chunk-HJ3HHUT5.js";
-import "./chunk-GU6JF75T.js";
-import "./chunk-ST5DDKJP.js";
+} from "./chunk-AH5D5Q5V.js";
+import "./chunk-HMGADJGZ.js";
+import "./chunk-FG3OO5LM.js";
+import "./chunk-APXVSSSY.js";
+import "./chunk-YIKA2QT4.js";
+import "./chunk-NC57YMUO.js";
+import "./chunk-V6GIY62B.js";
 export {
   OpenGeniClient
 };

package/dist/automations-client.d.ts

@@ -0,0 +1,17 @@
+import type { AutomationRun, AutomationSource, AutomationTrigger, AutomationWebhookResult, CreateAutomationSourceRequest, CreateAutomationTriggerRequest, TriggerAutomationManuallyRequest, UpdateAutomationSourceRequest, UpdateAutomationTriggerRequest } from "@opengeni/contracts";
+import type { OpenGeniClient as OpenGeniCoreClient } from "./client.js";
+export type OpenGeniAutomationsTransport = Pick<OpenGeniCoreClient, "requestJson">;
+export declare class OpenGeniAutomationsClient {
+    private readonly client;
+    constructor(client: OpenGeniAutomationsTransport);
+    listSources(workspaceId: string): Promise<AutomationSource[]>;
+    createSource(workspaceId: string, request: CreateAutomationSourceRequest): Promise<AutomationSource>;
+    updateSource(workspaceId: string, sourceId: string, request: UpdateAutomationSourceRequest): Promise<AutomationSource>;
+    disableSource(workspaceId: string, sourceId: string): Promise<void>;
+    listTriggers(workspaceId: string): Promise<AutomationTrigger[]>;
+    createTrigger(workspaceId: string, request: CreateAutomationTriggerRequest): Promise<AutomationTrigger>;
+    updateTrigger(workspaceId: string, triggerId: string, request: UpdateAutomationTriggerRequest): Promise<AutomationTrigger>;
+    disableTrigger(workspaceId: string, triggerId: string, expectedRevision: number): Promise<void>;
+    listRuns(workspaceId: string): Promise<AutomationRun[]>;
+    triggerManually(workspaceId: string, sourceId: string, request: TriggerAutomationManuallyRequest): Promise<AutomationWebhookResult>;
+}

package/dist/automations.d.ts

@@ -0,0 +1,3 @@
+export { OpenGeniAutomationsClient } from "./automations-client.js";
+export type { OpenGeniAutomationsTransport } from "./automations-client.js";
+export type { AutomationAcceptedExecution, AutomationNormalizedEvent, AutomationRun, AutomationSource, AutomationTrigger, AutomationWebhookResult, CreateAutomationSourceRequest, CreateAutomationTriggerRequest, TriggerAutomationManuallyRequest, UpdateAutomationSourceRequest, UpdateAutomationTriggerRequest, } from "@opengeni/contracts";

package/dist/automations.js

@@ -0,0 +1,84 @@
+// src/automations-client.ts
+var OpenGeniAutomationsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async listSources(workspaceId) {
+    const result = await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources`
+    );
+    return result.sources;
+  }
+  async createSource(workspaceId, request) {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources`,
+      request
+    );
+  }
+  async updateSource(workspaceId, sourceId, request) {
+    return await this.client.requestJson(
+      "PATCH",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}`,
+      request
+    );
+  }
+  async disableSource(workspaceId, sourceId) {
+    await this.client.requestJson(
+      "DELETE",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}`,
+      void 0,
+      {},
+      { responseType: "void" }
+    );
+  }
+  async listTriggers(workspaceId) {
+    const result = await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers`
+    );
+    return result.triggers;
+  }
+  async createTrigger(workspaceId, request) {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers`,
+      request
+    );
+  }
+  async updateTrigger(workspaceId, triggerId, request) {
+    return await this.client.requestJson(
+      "PATCH",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers/${encodeURIComponent(triggerId)}`,
+      request
+    );
+  }
+  async disableTrigger(workspaceId, triggerId, expectedRevision) {
+    await this.client.requestJson(
+      "DELETE",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers/${encodeURIComponent(triggerId)}?expectedRevision=${expectedRevision}`,
+      void 0,
+      {},
+      { responseType: "void" }
+    );
+  }
+  async listRuns(workspaceId) {
+    const result = await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/runs`
+    );
+    return result.runs;
+  }
+  async triggerManually(workspaceId, sourceId, request) {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}/events`,
+      request
+    );
+  }
+};
+export {
+  OpenGeniAutomationsClient
+};
+//# sourceMappingURL=automations.js.map

package/dist/automations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/automations-client.ts"],"sourcesContent":["import type {\n  AutomationRun,\n  AutomationSource,\n  AutomationTrigger,\n  AutomationWebhookResult,\n  CreateAutomationSourceRequest,\n  CreateAutomationTriggerRequest,\n  TriggerAutomationManuallyRequest,\n  UpdateAutomationSourceRequest,\n  UpdateAutomationTriggerRequest,\n} from \"@opengeni/contracts\";\nimport type { OpenGeniClient as OpenGeniCoreClient } from \"./client\";\n\nexport type OpenGeniAutomationsTransport = Pick<OpenGeniCoreClient, \"requestJson\">;\n\nexport class OpenGeniAutomationsClient {\n  constructor(private readonly client: OpenGeniAutomationsTransport) {}\n\n  async listSources(workspaceId: string): Promise<AutomationSource[]> {\n    const result = await this.client.requestJson<{ sources: AutomationSource[] }>(\n      \"GET\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources`,\n    );\n    return result.sources;\n  }\n\n  async createSource(\n    workspaceId: string,\n    request: CreateAutomationSourceRequest,\n  ): Promise<AutomationSource> {\n    return await this.client.requestJson(\n      \"POST\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources`,\n      request,\n    );\n  }\n\n  async updateSource(\n    workspaceId: string,\n    sourceId: string,\n    request: UpdateAutomationSourceRequest,\n  ): Promise<AutomationSource> {\n    return await this.client.requestJson(\n      \"PATCH\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}`,\n      request,\n    );\n  }\n\n  async disableSource(workspaceId: string, sourceId: string): Promise<void> {\n    await this.client.requestJson<void>(\n      \"DELETE\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}`,\n      undefined,\n      {},\n      { responseType: \"void\" },\n    );\n  }\n\n  async listTriggers(workspaceId: string): Promise<AutomationTrigger[]> {\n    const result = await this.client.requestJson<{ triggers: AutomationTrigger[] }>(\n      \"GET\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers`,\n    );\n    return result.triggers;\n  }\n\n  async createTrigger(\n    workspaceId: string,\n    request: CreateAutomationTriggerRequest,\n  ): Promise<AutomationTrigger> {\n    return await this.client.requestJson(\n      \"POST\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers`,\n      request,\n    );\n  }\n\n  async updateTrigger(\n    workspaceId: string,\n    triggerId: string,\n    request: UpdateAutomationTriggerRequest,\n  ): Promise<AutomationTrigger> {\n    return await this.client.requestJson(\n      \"PATCH\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers/${encodeURIComponent(triggerId)}`,\n      request,\n    );\n  }\n\n  async disableTrigger(\n    workspaceId: string,\n    triggerId: string,\n    expectedRevision: number,\n  ): Promise<void> {\n    await this.client.requestJson<void>(\n      \"DELETE\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers/${encodeURIComponent(triggerId)}?expectedRevision=${expectedRevision}`,\n      undefined,\n      {},\n      { responseType: \"void\" },\n    );\n  }\n\n  async listRuns(workspaceId: string): Promise<AutomationRun[]> {\n    const result = await this.client.requestJson<{ runs: AutomationRun[] }>(\n      \"GET\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/runs`,\n    );\n    return result.runs;\n  }\n\n  async triggerManually(\n    workspaceId: string,\n    sourceId: string,\n    request: TriggerAutomationManuallyRequest,\n  ): Promise<AutomationWebhookResult> {\n    return await this.client.requestJson(\n      \"POST\",\n      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}/events`,\n      request,\n    );\n  }\n}\n"],"mappings":";AAeO,IAAM,4BAAN,MAAgC;AAAA,EACrC,YAA6B,QAAsC;AAAtC;AAAA,EAAuC;AAAA,EAEpE,MAAM,YAAY,aAAkD;AAClE,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACnD;AACA,WAAO,OAAO;AAAA,EAChB;AAAA,EAEA,MAAM,aACJ,aACA,SAC2B;AAC3B,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,aACJ,aACA,UACA,SAC2B;AAC3B,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC,wBAAwB,mBAAmB,QAAQ,CAAC;AAAA,MACrG;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,cAAc,aAAqB,UAAiC;AACxE,UAAM,KAAK,OAAO;AAAA,MAChB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC,wBAAwB,mBAAmB,QAAQ,CAAC;AAAA,MACrG;AAAA,MACA,CAAC;AAAA,MACD,EAAE,cAAc,OAAO;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,aAAmD;AACpE,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACnD;AACA,WAAO,OAAO;AAAA,EAChB;AAAA,EAEA,MAAM,cACJ,aACA,SAC4B;AAC5B,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,cACJ,aACA,WACA,SAC4B;AAC5B,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC,yBAAyB,mBAAmB,SAAS,CAAC;AAAA,MACvG;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,eACJ,aACA,WACA,kBACe;AACf,UAAM,KAAK,OAAO;AAAA,MAChB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC,yBAAyB,mBAAmB,SAAS,CAAC,qBAAqB,gBAAgB;AAAA,MAC5I;AAAA,MACA,CAAC;AAAA,MACD,EAAE,cAAc,OAAO;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,aAA+C;AAC5D,UAAM,SAAS,MAAM,KAAK,OAAO;AAAA,MAC/B;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACnD;AACA,WAAO,OAAO;AAAA,EAChB;AAAA,EAEA,MAAM,gBACJ,aACA,UACA,SACkC;AAClC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,mBAAmB,WAAW,CAAC,wBAAwB,mBAAmB,QAAQ,CAAC;AAAA,MACrG;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/browser.d.ts

@@ -0,0 +1,11 @@
+/** Browser-console client. Optional SDK surfaces must not enter this eager graph. */
+export { OpenGeniClient as OpenGeniBrowserClient } from "./client.js";
+export type { SessionMessageSearchRequest, SessionMessageSearchMatch, SessionMessageSearchResponse, SessionMessagePreview, SessionMessagePreviewReference, } from "./session-message-search.js";
+export { OpenGeniToolCallError, OpenGeniToolReapprovalRequiredError, OpenGeniToolsClient, } from "./tools.js";
+export type { OpenGeniGeneratedTools, OpenGeniDynamicToolNode, OpenGeniToolCallOptions, OpenGeniToolFunction, OpenGeniToolsFacade, OpenGeniWorkspaceTools, } from "./tools.js";
+export type { FetchLike, FetchResponse, GetSessionOptions, OpenGeniClientOptions, OpenGeniRequestOptions, SendMessageInput, SteerMessageResult, TranscribeAudioInput, WorkspaceControlEventPage, } from "./client.js";
+export { OpenGeniApiContractMismatchError, OpenGeniApiError, OpenGeniSetupError, OpenGeniAllowanceExhaustedError, OpenGeniSecureContextRequiredError, OpenGeniSessionListCursorError, OpenGeniStreamError, formatErrorMessage, isRetryableStreamError, } from "./errors.js";
+export type { OpenGeniSecureContextRequiredReason } from "./errors.js";
+export { resolveWorkspaceVoiceInputEnabled } from "./transcription.js";
+export { OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION } from "./types.js";
+export type { ConnectorToolPermission, ConnectorToolPermissionEntry, ConnectorToolPermissionsResponse, UpdateConnectorToolPermissionsRequest, } from "./types.js";

package/dist/browser.js

@@ -0,0 +1,47 @@
+import {
+  resolveWorkspaceVoiceInputEnabled
+} from "./chunk-VYCTL62C.js";
+import {
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient
+} from "./chunk-4SMEOV3P.js";
+import {
+  OpenGeniClient
+} from "./chunk-FG3OO5LM.js";
+import "./chunk-APXVSSSY.js";
+import {
+  OPENGENI_API_CONTRACT_HEADER,
+  OPENGENI_API_CONTRACT_REVISION
+} from "./chunk-YIKA2QT4.js";
+import "./chunk-NC57YMUO.js";
+import {
+  OpenGeniAllowanceExhaustedError,
+  OpenGeniApiContractMismatchError,
+  OpenGeniApiError,
+  OpenGeniSecureContextRequiredError,
+  OpenGeniSessionListCursorError,
+  OpenGeniSetupError,
+  OpenGeniStreamError,
+  formatErrorMessage,
+  isRetryableStreamError
+} from "./chunk-V6GIY62B.js";
+export {
+  OPENGENI_API_CONTRACT_HEADER,
+  OPENGENI_API_CONTRACT_REVISION,
+  OpenGeniAllowanceExhaustedError,
+  OpenGeniApiContractMismatchError,
+  OpenGeniApiError,
+  OpenGeniClient as OpenGeniBrowserClient,
+  OpenGeniSecureContextRequiredError,
+  OpenGeniSessionListCursorError,
+  OpenGeniSetupError,
+  OpenGeniStreamError,
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient,
+  formatErrorMessage,
+  isRetryableStreamError,
+  resolveWorkspaceVoiceInputEnabled
+};
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chat/fold.d.ts

@@ -0,0 +1,75 @@
+import type { SessionEvent } from "../types.js";
+import { OpenGeniChatError, type ChatChunk, type ChatPending, type ChatReply } from "./types.js";
+/**
+ * Event folding shared by `send`, `stream`, and every protocol adapter.
+ *
+ * One fold covers one logical turn: text deltas accumulate into message
+ * segments (a tool call closes the current segment, the completed event
+ * reconciles it), tool call/output pairs become tool chunks, and the turn
+ * settles on a terminal event or a human wait. Events that carry a different
+ * turn id than the expected one are ignored so a queued follow-up never ends
+ * early on the previous turn's settlement.
+ *
+ * A segment belongs to one provider message when events carry `messageId`: a
+ * delta for another message starts a new segment, and a completion reconciles
+ * only the segment of its own message. Completions may arrive after later
+ * messages already streamed, so matching by position would let one message's
+ * completion close another's segment and repeat its text.
+ *
+ * Commentary (`phase: "commentary"`) narrates the work, like a tool chunk, so
+ * it is held back from the reply text. Only a turn that settles without any
+ * answer text falls back to its latest commentary, emitted at settlement.
+ */
+export type ChatTurnTerminal = "completed" | "failed" | "cancelled" | "pending";
+export type ChatFoldStep = {
+    chunks: ChatChunk[];
+    terminal: ChatTurnTerminal | null;
+};
+/** Incremental replay of unresolved requests, without retaining the event log. */
+export declare class ChatPendingFold {
+    private readonly requests;
+    push(event: SessionEvent): void;
+    pending(now?: number): ChatPending[];
+    private put;
+}
+export declare class ChatTurnFold {
+    private readonly workspaceId;
+    private readonly sessionId;
+    readonly events: SessionEvent[];
+    turnId: string | null;
+    pending: ChatPending | null;
+    failure: SessionEvent | null;
+    private emptyFinalReply;
+    private readonly segments;
+    private readonly openTools;
+    constructor(workspaceId: string, sessionId: string, expectedTurnId: string | null);
+    get text(): string;
+    push(event: SessionEvent): ChatFoldStep;
+    reply(terminal: ChatTurnTerminal): ChatReply;
+    /** The error to throw for a `turn.failed` settlement. */
+    failureError(): OpenGeniChatError;
+    private messageDelta;
+    private messageCompleted;
+    private segmentOf;
+    /** Deltas that carried no identity, still streaming the text this completion names. */
+    private unidentifiedStreamingSegment;
+    private latestAnswer;
+    private findLastSegment;
+    /**
+     * Complete an answer segment. Only the newest answer can grow: a remainder
+     * for an earlier one would land after later text for append-only consumers.
+     */
+    private extendAnswer;
+    private closeSegments;
+    /**
+     * Close the turn's text. A turn that produced commentary but no answer text
+     * (for example one that ends waiting for a worker) replies with its latest
+     * commentary rather than nothing.
+     */
+    private settleSegments;
+    private startSegment;
+}
+export declare function approvalPending(payload: Record<string, unknown>): ChatPending | null;
+export declare function humanInputPending(payload: Record<string, unknown>): ChatPending | null;
+export declare function asRecord(value: unknown): Record<string, unknown>;
+export declare function stringValue(value: unknown): string | undefined;

package/dist/chat/handler.d.ts

@@ -0,0 +1,41 @@
+import { type ChatResolve } from "./http.js";
+import type { OpenGeni } from "./opengeni.js";
+import { type ChatChunk, type ChatRespondInput } from "./types.js";
+export { CHAT_CONVERSATION_HEADER, type ChatResolution, type ChatResolve } from "./http.js";
+export type ChatHandlerFormat = "native" | "vercel" | "openai-chat" | "openai-responses";
+export type ChatHandlerOptions = {
+    /** Mandatory host auth hook; see {@link ChatResolve}. */
+    resolve: ChatResolve;
+    /** Default wire format; a request may override it with the format header. */
+    format?: ChatHandlerFormat | undefined;
+    /** Vercel format only: also emit OpenGeni's own tool activity (see `UIMessageStreamOptions.toolParts`). */
+    toolParts?: boolean | undefined;
+};
+/** Per-request wire-format override header. */
+export declare const CHAT_FORMAT_HEADER = "x-opengeni-chat-format";
+/**
+ * One request handler for a product's chat endpoint. `POST` with `{ message }`
+ * streams the reply in the selected format; `POST .../respond` answers a
+ * pending approval or human-input request and streams the continuation;
+ * `GET` returns the conversation's history as JSON. Every other method is a
+ * 405. The conversation is the host's resolution, else the
+ * `x-opengeni-conversation` header, else the wire format's own field.
+ */
+export declare function createChatHandler(og: OpenGeni, options: ChatHandlerOptions): (request: Request) => Promise<Response>;
+/** `POST { message }` -> native SSE of {@link ChatChunk} (`event: chunk`). */
+export declare function handleNativeChatRequest(og: OpenGeni, request: Request, resolve: ChatResolve): Promise<Response>;
+/**
+ * `GET` -> `{ conversation, sessionId, created, messages, pending, status }`: the user and
+ * assistant text of the conversation so a client can restore it on reload
+ * (`messages` is empty and `created` false before the first message).
+ */
+export declare function handleNativeHistoryRequest(og: OpenGeni, request: Request, resolve: ChatResolve): Promise<Response>;
+/** `POST .../respond { requestId, decision | answers | skip }` -> native SSE of the continuation. */
+export declare function handleNativeRespondRequest(og: OpenGeni, request: Request, resolve: ChatResolve): Promise<Response>;
+export declare function respondInputFromBody(body: Record<string, unknown> | null): ChatRespondInput | null;
+/** Native wire format: `event: chunk` per {@link ChatChunk}, `event: error` on failure. */
+export declare function chatChunksToSseBlocks(chunks: AsyncIterable<ChatChunk>): AsyncGenerator<string, void, void>;
+export declare function chatChunksToSseStream(chunks: AsyncIterable<ChatChunk>, onCancel?: () => void): ReadableStream<Uint8Array>;
+export declare function chatChunksToSseResponse(chunks: AsyncIterable<ChatChunk>): Response;
+/** Browser-side reader for the native wire format. Throws {@link OpenGeniChatError} on `event: error`. */
+export declare function parseChatChunkStream(stream: ReadableStream<Uint8Array>): AsyncGenerator<ChatChunk, void, void>;