@opengeni/sdk 0.46.0 → 0.52.1

package/dist/interaction.js

@@ -0,0 +1,55 @@
+import {
+  AttachedBrowserDeviceCollection,
+  AttachedBrowserDeviceResource,
+  BROWSER_CONTROL_MAX_FRAME_HEADER_BYTES,
+  BROWSER_CONTROL_WEBSOCKET_BEARER_PREFIX,
+  BROWSER_CONTROL_WEBSOCKET_PROTOCOL,
+  BROWSER_FRAME_MAX_BYTES,
+  BROWSER_FRAME_MAX_DIMENSION,
+  BROWSER_FRAME_MAX_PIXELS,
+  BrowserIdentityCollection,
+  BrowserIdentityResource,
+  BrowserSessionCollection,
+  BrowserSessionResource,
+  BrowserTargetCollection,
+  COMPUTER_CONTROL_WEBSOCKET_PROTOCOL,
+  ComputerSessionCollection,
+  ComputerSessionResource,
+  ComputerTargetCollection,
+  INTERACTION_PROTOCOL_VERSION,
+  OpenGeniInteractionClient,
+  browserFrameSocketUrl,
+  computerFrameSocketUrl,
+  decodeBrowserFrameMessage,
+  decodeComputerFrameMessage,
+  parseBrowserFrameMetadata,
+  parseComputerFrameMetadata
+} from "./chunk-MZWTWOX6.js";
+export {
+  AttachedBrowserDeviceCollection,
+  AttachedBrowserDeviceResource,
+  BROWSER_CONTROL_MAX_FRAME_HEADER_BYTES,
+  BROWSER_CONTROL_WEBSOCKET_BEARER_PREFIX,
+  BROWSER_CONTROL_WEBSOCKET_PROTOCOL,
+  BROWSER_FRAME_MAX_BYTES,
+  BROWSER_FRAME_MAX_DIMENSION,
+  BROWSER_FRAME_MAX_PIXELS,
+  BrowserIdentityCollection,
+  BrowserIdentityResource,
+  BrowserSessionCollection,
+  BrowserSessionResource,
+  BrowserTargetCollection,
+  COMPUTER_CONTROL_WEBSOCKET_PROTOCOL,
+  ComputerSessionCollection,
+  ComputerSessionResource,
+  ComputerTargetCollection,
+  INTERACTION_PROTOCOL_VERSION,
+  OpenGeniInteractionClient,
+  browserFrameSocketUrl,
+  computerFrameSocketUrl,
+  decodeBrowserFrameMessage,
+  decodeComputerFrameMessage,
+  parseBrowserFrameMetadata,
+  parseComputerFrameMetadata
+};
+//# sourceMappingURL=interaction.js.map

package/dist/interaction.js.map

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

package/dist/memory-slack-client.d.ts

@@ -0,0 +1,13 @@
+import type { OpenGeniClient as OpenGeniCoreClient } from "./client.js";
+import type { MemorySlackPublication, MemorySlackPublicationActionRequest, MemorySlackPublicationConfiguration, MemorySlackPublicationConfigurationResponse, MemorySlackPublicationHistoryResponse, SlackPublicationChannelListResponse, UpdateMemorySlackPublicationConfigurationRequest } from "./memory-slack-delivery.js";
+export type OpenGeniMemorySlackTransport = Pick<OpenGeniCoreClient, "requestJson">;
+/** Optional Memory-to-Slack API surface, isolated from the eager core client graph. */
+export declare class OpenGeniMemorySlackClient {
+    private readonly client;
+    constructor(client: OpenGeniMemorySlackTransport);
+    getMemorySlackPublicationConfiguration(workspaceId: string): Promise<MemorySlackPublicationConfigurationResponse>;
+    updateMemorySlackPublicationConfiguration(workspaceId: string, request: UpdateMemorySlackPublicationConfigurationRequest): Promise<MemorySlackPublicationConfiguration>;
+    listMemorySlackPublicationChannels(workspaceId: string, connectionId: string, cursor?: string): Promise<SlackPublicationChannelListResponse>;
+    listMemorySlackPublications(workspaceId: string): Promise<MemorySlackPublicationHistoryResponse>;
+    actOnMemorySlackPublication(workspaceId: string, publicationId: string, request: MemorySlackPublicationActionRequest): Promise<MemorySlackPublication>;
+}

package/dist/memory-slack-delivery.d.ts

@@ -0,0 +1,99 @@
+export type MemorySlackImportance = "major" | "normal" | "minor";
+export type MemorySlackRequestedMode = "auto" | "review" | "never";
+export type MemorySlackPublicationDistribution = {
+    importance: MemorySlackImportance;
+    audience: "workspace";
+    slackMode: MemorySlackRequestedMode;
+    shareSummary: string;
+};
+export type MemorySlackPublicationConfiguration = {
+    id: string;
+    workspaceId: string;
+    revision: number;
+    enabled: boolean;
+    connectionId: string | null;
+    slackTeamId: string | null;
+    slackChannelId: string | null;
+    slackChannelName: string | null;
+    autoImportances: MemorySlackImportance[];
+    reviewImportances: MemorySlackImportance[];
+    createdBySubjectId: string;
+    createdAt: string;
+};
+export type UpdateMemorySlackPublicationConfigurationRequest = {
+    expectedRevision: number;
+    enabled: boolean;
+    connectionId: string | null;
+    slackChannelId: string | null;
+    slackChannelName: string | null;
+    autoImportances: MemorySlackImportance[];
+    reviewImportances: MemorySlackImportance[];
+};
+export type MemorySlackPublicationConfigurationResponse = {
+    current: MemorySlackPublicationConfiguration | null;
+    history: MemorySlackPublicationConfiguration[];
+};
+export type MemorySlackPublicationState = "review_pending" | "queued" | "delivering" | "retry_wait" | "delivered" | "rejected" | "failed" | "cancelled";
+export type MemorySlackPublicationReceiptKind = "enqueued" | "review_approved" | "review_rejected" | "delivery_claimed" | "retry_scheduled" | "delivered" | "failed" | "cancelled" | "manual_retry";
+export type MemorySlackPublicationReceipt = {
+    id: string;
+    publicationId: string;
+    sequence: number;
+    kind: MemorySlackPublicationReceiptKind;
+    state: MemorySlackPublicationState;
+    attemptNumber: number;
+    actorKind: "human" | "agent" | "service";
+    actorSubjectId: string;
+    operationId: string;
+    errorCode: string | null;
+    retryAt: string | null;
+    slackChannelId: string | null;
+    slackMessageTimestamp: string | null;
+    createdAt: string;
+};
+export type MemorySlackPublication = {
+    id: string;
+    workspaceId: string;
+    configurationRevision: number;
+    connectionId: string;
+    slackTeamId: string;
+    slackChannelId: string;
+    sourceType: "workspace_memory" | "durable_learning";
+    sourceId: string;
+    sourceVersion: string | null;
+    importance: MemorySlackImportance;
+    deliveryMode: "auto" | "review";
+    state: MemorySlackPublicationState;
+    summary: string;
+    sourceLabel: string;
+    authoritativePath: string | null;
+    initiatorKind: "human" | "agent" | "service";
+    initiatorSubjectId: string;
+    initiatingHumanSubjectId: string | null;
+    attemptCount: number;
+    retryAt: string | null;
+    lastErrorCode: string | null;
+    slackMessageTimestamp: string | null;
+    deliveredAt: string | null;
+    terminalAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    receipts: MemorySlackPublicationReceipt[];
+};
+export type MemorySlackPublicationHistoryResponse = {
+    publications: MemorySlackPublication[];
+    nextCursor: string | null;
+};
+export type MemorySlackPublicationActionRequest = {
+    action: "approve" | "reject" | "retry";
+    expectedState: MemorySlackPublicationState;
+};
+export type SlackPublicationChannel = {
+    id: string;
+    name: string | null;
+    isPrivate: boolean;
+};
+export type SlackPublicationChannelListResponse = {
+    channels: SlackPublicationChannel[];
+    nextCursor: string | null;
+};

package/dist/memory-slack.d.ts

@@ -0,0 +1,4 @@
+/** Optional Memory-to-Slack API client; import this entry only where the capability is used. */
+export { OpenGeniMemorySlackClient } from "./memory-slack-client.js";
+export type { OpenGeniMemorySlackTransport } from "./memory-slack-client.js";
+export type { MemorySlackImportance, MemorySlackPublication, MemorySlackPublicationActionRequest, MemorySlackPublicationConfiguration, MemorySlackPublicationConfigurationResponse, MemorySlackPublicationDistribution, MemorySlackPublicationHistoryResponse, MemorySlackPublicationReceipt, MemorySlackPublicationReceiptKind, MemorySlackPublicationState, MemorySlackRequestedMode, SlackPublicationChannel, SlackPublicationChannelListResponse, UpdateMemorySlackPublicationConfigurationRequest, } from "./memory-slack-delivery.js";

package/dist/memory-slack.js

@@ -0,0 +1,44 @@
+// src/memory-slack-client.ts
+var OpenGeniMemorySlackClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async getMemorySlackPublicationConfiguration(workspaceId) {
+    return await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/memory-slack-publications/configuration`
+    );
+  }
+  async updateMemorySlackPublicationConfiguration(workspaceId, request) {
+    return await this.client.requestJson(
+      "PUT",
+      `/v1/workspaces/${workspaceId}/memory-slack-publications/configuration`,
+      request
+    );
+  }
+  async listMemorySlackPublicationChannels(workspaceId, connectionId, cursor) {
+    const query = new URLSearchParams({ connectionId });
+    if (cursor) query.set("cursor", cursor);
+    return await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/memory-slack-publications/channels?${query}`
+    );
+  }
+  async listMemorySlackPublications(workspaceId) {
+    return await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/memory-slack-publications`
+    );
+  }
+  async actOnMemorySlackPublication(workspaceId, publicationId, request) {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/memory-slack-publications/${encodeURIComponent(publicationId)}/action`,
+      request
+    );
+  }
+};
+export {
+  OpenGeniMemorySlackClient
+};
+//# sourceMappingURL=memory-slack.js.map

package/dist/memory-slack.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory-slack-client.ts"],"sourcesContent":["import type { OpenGeniClient as OpenGeniCoreClient } from \"./client\";\nimport type {\n  MemorySlackPublication,\n  MemorySlackPublicationActionRequest,\n  MemorySlackPublicationConfiguration,\n  MemorySlackPublicationConfigurationResponse,\n  MemorySlackPublicationHistoryResponse,\n  SlackPublicationChannelListResponse,\n  UpdateMemorySlackPublicationConfigurationRequest,\n} from \"./memory-slack-delivery\";\n\nexport type OpenGeniMemorySlackTransport = Pick<OpenGeniCoreClient, \"requestJson\">;\n\n/** Optional Memory-to-Slack API surface, isolated from the eager core client graph. */\nexport class OpenGeniMemorySlackClient {\n  constructor(private readonly client: OpenGeniMemorySlackTransport) {}\n\n  async getMemorySlackPublicationConfiguration(\n    workspaceId: string,\n  ): Promise<MemorySlackPublicationConfigurationResponse> {\n    return await this.client.requestJson<MemorySlackPublicationConfigurationResponse>(\n      \"GET\",\n      `/v1/workspaces/${workspaceId}/memory-slack-publications/configuration`,\n    );\n  }\n\n  async updateMemorySlackPublicationConfiguration(\n    workspaceId: string,\n    request: UpdateMemorySlackPublicationConfigurationRequest,\n  ): Promise<MemorySlackPublicationConfiguration> {\n    return await this.client.requestJson<MemorySlackPublicationConfiguration>(\n      \"PUT\",\n      `/v1/workspaces/${workspaceId}/memory-slack-publications/configuration`,\n      request,\n    );\n  }\n\n  async listMemorySlackPublicationChannels(\n    workspaceId: string,\n    connectionId: string,\n    cursor?: string,\n  ): Promise<SlackPublicationChannelListResponse> {\n    const query = new URLSearchParams({ connectionId });\n    if (cursor) query.set(\"cursor\", cursor);\n    return await this.client.requestJson<SlackPublicationChannelListResponse>(\n      \"GET\",\n      `/v1/workspaces/${workspaceId}/memory-slack-publications/channels?${query}`,\n    );\n  }\n\n  async listMemorySlackPublications(\n    workspaceId: string,\n  ): Promise<MemorySlackPublicationHistoryResponse> {\n    return await this.client.requestJson<MemorySlackPublicationHistoryResponse>(\n      \"GET\",\n      `/v1/workspaces/${workspaceId}/memory-slack-publications`,\n    );\n  }\n\n  async actOnMemorySlackPublication(\n    workspaceId: string,\n    publicationId: string,\n    request: MemorySlackPublicationActionRequest,\n  ): Promise<MemorySlackPublication> {\n    return await this.client.requestJson<MemorySlackPublication>(\n      \"POST\",\n      `/v1/workspaces/${workspaceId}/memory-slack-publications/${encodeURIComponent(publicationId)}/action`,\n      request,\n    );\n  }\n}\n"],"mappings":";AAcO,IAAM,4BAAN,MAAgC;AAAA,EACrC,YAA6B,QAAsC;AAAtC;AAAA,EAAuC;AAAA,EAEpE,MAAM,uCACJ,aACsD;AACtD,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,0CACJ,aACA,SAC8C;AAC9C,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,mCACJ,aACA,cACA,QAC8C;AAC9C,UAAM,QAAQ,IAAI,gBAAgB,EAAE,aAAa,CAAC;AAClD,QAAI,OAAQ,OAAM,IAAI,UAAU,MAAM;AACtC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW,uCAAuC,KAAK;AAAA,IAC3E;AAAA,EACF;AAAA,EAEA,MAAM,4BACJ,aACgD;AAChD,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,4BACJ,aACA,eACA,SACiC;AACjC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW,8BAA8B,mBAAmB,aAAa,CAAC;AAAA,MAC5F;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/proxy.d.ts

@@ -1,6 +1,6 @@
-import type { OpenGeniClient } from "./client";
-import type { StreamSessionEventsOptions } from "./stream";
-import type { SessionEvent } from "./types";
+import type { OpenGeniClient } from "./client.js";
+import type { StreamSessionEventsOptions } from "./stream.js";
+import type { SessionEvent } from "./types.js";
 /**
  * Proxy-through-your-own-API helpers.
  *

package/dist/realtime.d.ts

@@ -4,9 +4,9 @@
  * Import this subpath lazily in browser applications. The base `@opengeni/sdk`
  * entry remains free of eager realtime transport initialization.
  */
-import { createCodexRealtimeController, hasStoredSessionRealtimeOwnerProof, sessionRealtimeOwnerStorageKey, sessionRealtimeOwnerStorageNamespace, type CodexRealtimeController, type CodexRealtimeControllerClient, type CodexRealtimeControllerSnapshot, type CodexRealtimeControllerStatus, type CodexRealtimeDiagnostic, type CodexRealtimeDiagnosticKind, type CodexRealtimeMicrophoneState, type CodexRealtimeOwnerStorage, type CreateCodexRealtimeControllerOptions, type RealtimeControllerTransportStarter } from "./codex-realtime-controller";
-import { createGatewayRealtimeTransportStarter } from "./gateway-realtime-transport";
-import type { SessionRealtimeModel, WorkspaceRealtimeModelCatalogResponse } from "./types";
+import { createCodexRealtimeController, hasStoredSessionRealtimeOwnerProof, sessionRealtimeOwnerStorageKey, sessionRealtimeOwnerStorageNamespace, type CodexRealtimeController, type CodexRealtimeControllerClient, type CodexRealtimeControllerSnapshot, type CodexRealtimeControllerStatus, type CodexRealtimeDiagnostic, type CodexRealtimeDiagnosticKind, type CodexRealtimeMicrophoneState, type CodexRealtimeOwnerStorage, type CreateCodexRealtimeControllerOptions, type RealtimeControllerTransportStarter } from "./codex-realtime-controller.js";
+import { createGatewayRealtimeTransportStarter } from "./gateway-realtime-transport.js";
+import type { SessionRealtimeModel, WorkspaceRealtimeModelCatalogResponse } from "./types.js";
 /** Exact backend-facing methods required by the batteries-included realtime SDK. */
 export type SessionRealtimeClientLike = CodexRealtimeControllerClient & {
     getWorkspaceRealtimeModelCatalog(workspaceId: string): Promise<WorkspaceRealtimeModelCatalogResponse>;
@@ -34,12 +34,12 @@ export declare function sessionRealtimeTransportKind(model: SessionRealtimeModel
 export declare function createSessionRealtimeController(options: CreateSessionRealtimeControllerOptions): SessionRealtimeController;
 export { createCodexRealtimeController, createGatewayRealtimeTransportStarter, hasStoredSessionRealtimeOwnerProof, sessionRealtimeOwnerStorageKey, sessionRealtimeOwnerStorageNamespace, };
 export type { CodexRealtimeController, CodexRealtimeControllerClient, CodexRealtimeControllerSnapshot, CodexRealtimeControllerStatus, CodexRealtimeDiagnostic, CodexRealtimeDiagnosticKind, CodexRealtimeMicrophoneState, CodexRealtimeOwnerStorage, CreateCodexRealtimeControllerOptions, RealtimeControllerTransportStarter, };
-export { CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS, projectSessionRealtimeLifecycle, } from "./codex-realtime-controller";
-export type { SessionRealtimeLifecycleProjection } from "./codex-realtime-lifecycle";
-export { CodexRealtimeMicrophoneError, acquireCodexRealtimeMicrophone, codexRealtimeMicrophoneHealthy, startCodexRealtimeWebrtc, } from "./codex-realtime";
-export type { AcquireCodexRealtimeMicrophoneOptions, CodexRealtimeAudibleOutputState, CodexRealtimeConnectionHealth, CodexRealtimeMicrophoneErrorCode, CodexRealtimeNegotiator, CodexRealtimeWebrtcSession, StartCodexRealtimeWebrtcOptions, } from "./codex-realtime";
-export { CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES, CODEX_REALTIME_V3_MAX_EVENT_BYTES, CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES, CODEX_REALTIME_V3_MAX_TEXT_BYTES, CODEX_REALTIME_V3_PENDING_MAX_BYTES, CODEX_REALTIME_V3_PENDING_MAX_ENTRIES, CODEX_REALTIME_V3_SYNC_MAX_ENTRIES, contextAppendChunks, createCodexRealtimeV3Bridge, encodeCodexRealtimeV3DelegationContextAppend, encodeCodexRealtimeV3SessionContextAppend, parseCodexRealtimeV3Event, } from "./codex-realtime-v3";
-export type { CodexRealtimeV3Bridge, CodexRealtimeV3BridgeFatal, CodexRealtimeV3BridgeOptions, CodexRealtimeV3BridgeSnapshot, CodexRealtimeV3ContextAppendChannel, CodexRealtimeV3DelegationContextAppend, CodexRealtimeV3Event, CodexRealtimeV3ParseFailure, CodexRealtimeV3ParseResult, CodexRealtimeV3SessionContextAppend, } from "./codex-realtime-v3";
-export { CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT, CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS, } from "./codex-realtime-v3-wire";
-export type { CodexRealtimeInitialItem } from "./codex-realtime-v3-wire";
-export type { ActivateCodexRealtimeConnectionRequest, BeginSessionRealtimeRequest, CodexRealtimeVoice, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, CodexRealtimeWebrtcVersion, EndSessionRealtimeRequest, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, GatewayRealtimeInitialItem, RenewSessionRealtimeRequest, SessionRealtimeEndReason, SessionRealtimeLedgerEntry, SessionRealtimeMode, SessionRealtimeModel, SessionRealtimeMutationResponse, SessionRealtimeState, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, WorkspaceRealtimeModelCatalogItem, WorkspaceRealtimeModelCatalogResponse, } from "./types";
+export { CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS, projectSessionRealtimeLifecycle, } from "./codex-realtime-controller.js";
+export type { SessionRealtimeLifecycleProjection } from "./codex-realtime-lifecycle.js";
+export { CodexRealtimeMicrophoneError, acquireCodexRealtimeMicrophone, codexRealtimeMicrophoneHealthy, startCodexRealtimeWebrtc, } from "./codex-realtime.js";
+export type { AcquireCodexRealtimeMicrophoneOptions, CodexRealtimeAudibleOutputState, CodexRealtimeConnectionHealth, CodexRealtimeMicrophoneErrorCode, CodexRealtimeNegotiator, CodexRealtimeWebrtcSession, StartCodexRealtimeWebrtcOptions, } from "./codex-realtime.js";
+export { CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES, CODEX_REALTIME_V3_MAX_EVENT_BYTES, CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES, CODEX_REALTIME_V3_MAX_TEXT_BYTES, CODEX_REALTIME_V3_PENDING_MAX_BYTES, CODEX_REALTIME_V3_PENDING_MAX_ENTRIES, CODEX_REALTIME_V3_SYNC_MAX_ENTRIES, contextAppendChunks, createCodexRealtimeV3Bridge, encodeCodexRealtimeV3DelegationContextAppend, encodeCodexRealtimeV3SessionContextAppend, parseCodexRealtimeV3Event, } from "./codex-realtime-v3.js";
+export type { CodexRealtimeV3Bridge, CodexRealtimeV3BridgeFatal, CodexRealtimeV3BridgeOptions, CodexRealtimeV3BridgeSnapshot, CodexRealtimeV3ContextAppendChannel, CodexRealtimeV3DelegationContextAppend, CodexRealtimeV3Event, CodexRealtimeV3ParseFailure, CodexRealtimeV3ParseResult, CodexRealtimeV3SessionContextAppend, } from "./codex-realtime-v3.js";
+export { CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT, CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS, } from "./codex-realtime-v3-wire.js";
+export type { CodexRealtimeInitialItem } from "./codex-realtime-v3-wire.js";
+export type { ActivateCodexRealtimeConnectionRequest, BeginSessionRealtimeRequest, CodexRealtimeVoice, CodexRealtimeWebrtcRequest, CodexRealtimeWebrtcResponse, CodexRealtimeWebrtcVersion, EndSessionRealtimeRequest, GatewayRealtimeConnectRequest, GatewayRealtimeConnectResponse, GatewayRealtimeInitialItem, RenewSessionRealtimeRequest, SessionRealtimeEndReason, SessionRealtimeLedgerEntry, SessionRealtimeMode, SessionRealtimeModel, SessionRealtimeMutationResponse, SessionRealtimeState, SyncSessionRealtimeLedgerRequest, SyncSessionRealtimeLedgerResponse, WorkspaceRealtimeModelCatalogItem, WorkspaceRealtimeModelCatalogResponse, } from "./types.js";

package/dist/retained-artifacts.d.ts

@@ -0,0 +1,12 @@
+import type { GeneratedImageReceipt, GeneratedVideoReceipt, MediaGenerationResult, RetainedArtifactReference } from "./types.js";
+/** Zero-dependency validation for the SDK's permanent generated-image wire receipt. */
+export declare function parseRetainedGeneratedImageReference(value: unknown, expectedWorkspaceId?: string): RetainedArtifactReference | null;
+export declare function generatedImageSandboxPathMatches(artifact: RetainedArtifactReference, sandboxPath: unknown): sandboxPath is string;
+/** Parse the complete closed generated-image tool result. */
+export declare function parseGeneratedImageReceipt(value: unknown, expectedWorkspaceId?: string): GeneratedImageReceipt | null;
+/** Zero-dependency validation for a permanent generated-video reference. */
+export declare function parseRetainedGeneratedVideoReference(value: unknown, expectedWorkspaceId?: string): RetainedArtifactReference | null;
+/** Parse the compact successful video result placed in model/timeline history. */
+export declare function parseGeneratedVideoReceipt(value: unknown, expectedWorkspaceId?: string): GeneratedVideoReceipt | null;
+/** Parse one closed terminal envelope; failures never fabricate an artifact. */
+export declare function parseMediaGenerationResult(value: unknown, expectedWorkspaceId?: string): MediaGenerationResult | null;

package/dist/stream.d.ts

@@ -1,4 +1,4 @@
-import type { SessionEvent } from "./types";
+import type { SessionEvent } from "./types.js";
 /**
  * Transport boundary for the streaming core. The client implements it with
  * `fetch`; unit tests script it directly.
@@ -21,13 +21,25 @@ export type StreamSessionEventsOptions = {
     reconnectDelayMs?: number;
     /** Backoff ceiling. Defaults to 10s. */
     maxReconnectDelayMs?: number;
+    /** Random backoff spread as a fraction of the delay. Defaults to 0.2. */
+    reconnectJitterRatio?: number;
     /**
      * Give up after this many consecutive failed reconnect attempts (i.e. N
      * reconnects = N+1 total open-stream calls). Defaults to unlimited.
      */
     maxReconnectAttempts?: number;
+    /**
+     * Notify the consumer as soon as the SSE response body is open. This callback
+     * is deliberately synchronous and non-blocking: use it to start projection
+     * reconciliation without delaying consumption of live event bytes.
+     */
+    onOpen?: (() => void) | undefined;
     /** Await authoritative client reconciliation before exposing `live`. */
     beforeLive?: (() => void | Promise<void>) | undefined;
+    /** Maximum reconciliation time before reconnecting. Defaults to 15s. */
+    beforeLiveTimeoutMs?: number;
+    /** Maximum time without any SSE bytes before reconnecting. Defaults to 45s. */
+    heartbeatTimeoutMs?: number;
     onStateChange?: (state: StreamConnectionState) => void;
 };
 /**
@@ -46,3 +58,6 @@ export type StreamSessionEventsOptions = {
  * `reconnect` is false, or with an error for non-retryable failures.
  */
 export declare function streamSessionEvents(transport: SessionEventStreamTransport, options?: StreamSessionEventsOptions): AsyncGenerator<SessionEvent, void, void>;
+export declare function runBeforeLive(beforeLive: (() => void | Promise<void>) | undefined, timeoutMs: number, signal: AbortSignal | undefined): Promise<void>;
+export declare function jitteredDelay(delayMs: number, ratio: number): number;
+export declare function withStreamInactivityTimeout(stream: ReadableStream<Uint8Array>, timeoutMs: number, signal: AbortSignal | undefined): ReadableStream<Uint8Array>;

package/dist/terminal.d.ts

@@ -1,4 +1,4 @@
-import type { TerminalCapability } from "./types";
+import type { TerminalCapability } from "./types.js";
 /**
  * Translate the negotiated `pty-ws` Terminal capability into the WebSocket URL
  * the ttyd client dials. The scoped provider token is ALREADY embedded in the

package/dist/transcription.d.ts

@@ -99,7 +99,7 @@ export type TranscriptionResultMetadata = {
 export type TranscriptionDiagnostic = {
     operation: "start" | "session" | "cancel" | "close";
     code: TranscriptionErrorCode;
-    /** Diagnostic-only detail. React sanitizes and bounds this before forwarding it. */
+    /** Exact diagnostic detail forwarded by React without content rewriting. */
     detail: string;
 };
 type TranscriptionEventBase = {
@@ -160,7 +160,7 @@ export type TranscriptionEventListener = (event: TranscriptionEvent) => void;
 export type TranscriptionAdapterStartContext = {
     /** Aborted on local cancellation, policy replacement, timeout, or unmount. */
     signal: AbortSignal;
-    /** Non-UI observability seam; callers receive only bounded, redacted detail. */
+    /** Non-UI observability seam; callers receive the exact provider detail. */
     reportDiagnostic: (diagnostic: TranscriptionDiagnostic) => void;
 };
 export type TranscriptionSession = {