@opengeni/sdk 3.3.2 → 3.4.0

package/dist/tools.d.ts

@@ -0,0 +1,81 @@
+import type { ToolGatewayApprovalResponse, ToolGatewayCatalog, ToolGatewayDeclarationsResponse, ToolGatewayIdentity, ToolGatewayResult, ToolGatewayTarget, ToolGatewayResolvedTool, ToolGatewayInvokeRequest, ToolGatewayInvokeResponse, ToolGatewayTargetApprovalResponse, ToolGatewayManifestRequest, ToolGatewayManifestResponse } from "./types.js";
+export type OpenGeniToolCallOptions = {
+    operationId?: string;
+    signal?: AbortSignal;
+    refreshCatalog?: boolean;
+    /** Server-issued, single-use capability returned by `$approve`. */
+    approvalToken?: string;
+    /** A schema-first precondition; absence on a cold call means current definition. */
+    expectedDefinitionDigest?: string;
+    /** External v1 approval capabilities must explicitly use the legacy adapter. */
+    approvalBinding?: "catalog" | "target";
+};
+export type OpenGeniToolFunction<TArguments extends Record<string, unknown> = Record<string, unknown>, TResult = unknown> = (argumentsValue?: TArguments, options?: OpenGeniToolCallOptions) => Promise<TResult>;
+export interface OpenGeniDynamicToolNamespace {
+    readonly [key: string]: OpenGeniDynamicToolNode;
+}
+export type OpenGeniDynamicToolNode = OpenGeniDynamicToolNamespace & OpenGeniToolFunction;
+/** Declaration-generation target for one exact workspace catalog. */
+export interface OpenGeniGeneratedTools {
+}
+export type OpenGeniWorkspaceTools<TCatalog extends Pick<ToolGatewayCatalog, "version" | "generation" | "digest" | "createdAt" | "entries"> = ToolGatewayCatalog> = OpenGeniGeneratedTools & OpenGeniDynamicToolNamespace & {
+    readonly $targetProtocol?: 1;
+    readonly $resolve: (target: ToolGatewayTarget, options?: {
+        refresh?: boolean;
+        signal?: AbortSignal;
+        siteArtifactId?: string;
+        siteVersionId?: string;
+    }) => Promise<ToolGatewayResolvedTool>;
+    readonly $invoke: (request: ToolGatewayInvokeRequest, options?: {
+        signal?: AbortSignal;
+    }) => Promise<ToolGatewayInvokeResponse>;
+    readonly $manifest: (request: ToolGatewayManifestRequest, options?: {
+        signal?: AbortSignal;
+    }) => Promise<ToolGatewayManifestResponse>;
+    readonly $approveTarget: (identity: ToolGatewayIdentity, argumentsValue?: Record<string, unknown>, options?: OpenGeniToolCallOptions) => Promise<ToolGatewayTargetApprovalResponse>;
+    readonly $catalog: (options?: {
+        refresh?: boolean;
+        signal?: AbortSignal;
+    }) => Promise<TCatalog>;
+    readonly $call: (identity: ToolGatewayIdentity, argumentsValue?: Record<string, unknown>, options?: OpenGeniToolCallOptions) => Promise<unknown>;
+    readonly $approve: (identity: ToolGatewayIdentity, argumentsValue?: Record<string, unknown>, options?: {
+        operationId?: string;
+        signal?: AbortSignal;
+    }) => Promise<ToolGatewayApprovalResponse>;
+    readonly $declarations: (options?: {
+        signal?: AbortSignal;
+    }) => Promise<ToolGatewayDeclarationsResponse>;
+};
+export interface OpenGeniToolTransport {
+    /** Explicit v1 compatibility. Never selected as a retry after an uncertain invoke. */
+    readonly toolGatewayMode?: "catalog" | "target";
+    requestJson<T>(method: string, path: string, body?: unknown, query?: Record<string, string>, options?: {
+        signal?: AbortSignal;
+        timeoutMs?: number;
+    }): Promise<T>;
+}
+export interface OpenGeniToolsFacade {
+    forWorkspace(workspaceId: string): OpenGeniWorkspaceTools;
+}
+export declare class OpenGeniToolCallError extends Error {
+    readonly result: ToolGatewayResult;
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly outcomeUnknown: boolean;
+    constructor(result: ToolGatewayResult);
+}
+/** A catalog refresh invalidated the single-use approval capability for this call. */
+export declare class OpenGeniToolReapprovalRequiredError extends Error {
+    readonly operationId: string;
+    readonly previousCatalogDigest: string;
+    readonly catalogDigest: string;
+    readonly identity: ToolGatewayIdentity;
+    readonly code: "tool_reapproval_required";
+    readonly retryable = false;
+    constructor(operationId: string, previousCatalogDigest: string, catalogDigest: string, identity: ToolGatewayIdentity);
+}
+export declare class OpenGeniToolsClient implements OpenGeniToolsFacade {
+    private readonly transport;
+    constructor(transport: OpenGeniToolTransport);
+    forWorkspace(workspaceId: string): OpenGeniWorkspaceTools;
+}

package/dist/transcription.d.ts

@@ -70,7 +70,7 @@ export type TranscriptionAuthorization = {
     reason: TranscriptionPolicyBlockReason;
 };
 export type TranscriptionLifecycleStatus = "idle" | "requesting-permission" | "listening" | "reconnecting" | "cancelling" | "closed" | "error";
-export type TranscriptionErrorCode = "permission_denied" | "not_supported" | "network" | "provider" | "policy_blocked" | "timeout" | "cancelled" | "unavailable" | "too_large" | "invalid_audio" | "unknown";
+export type TranscriptionErrorCode = "insufficient_credits" | "allowance_exhausted" | "monthly_model_cost_limit" | "permission_denied" | "not_supported" | "network" | "provider" | "policy_blocked" | "timeout" | "cancelled" | "unavailable" | "too_large" | "invalid_audio" | "unknown";
 /** Native browser voice input defaults to the configured deployment capability. */
 export declare function resolveWorkspaceVoiceInputEnabled(settings: unknown): boolean | null;
 export type TranscriptionTimeSpan = {