@opengeni/sdk 3.3.2 → 3.7.0-canary.0

package/dist/model-context.d.ts

@@ -0,0 +1,49 @@
+export type ModelContextInstructionLayerId = "operational_contract" | "persona_and_core" | "workspace_governance" | "session_instructions" | "workspace_memory" | "codemode" | "git_bindings" | "genesis_title" | "sdk_capability_instructions" | "sandbox_preamble" | "sandbox_filesystem" | "sent_system_instructions";
+export type ModelContextInstructionLayer = {
+    id: ModelContextInstructionLayerId;
+    title: string;
+    content: string;
+    utf8Bytes: number;
+    estimatedTokens: number;
+};
+export type ModelContextToolVisibility = "eager" | "searchable";
+export type ModelContextTool = {
+    name: string;
+    type: string;
+    visibility: ModelContextToolVisibility;
+    description?: string | undefined;
+    namespace?: string | undefined;
+    schema?: unknown | undefined;
+    utf8Bytes: number;
+    estimatedTokens: number;
+};
+export type ModelContextSkillKind = "preference_descriptor" | "runtime_skill" | "native_tool_skill";
+export type ModelContextSkill = {
+    kind: ModelContextSkillKind;
+    name: string;
+    description: string;
+    source?: string | undefined;
+    path?: string | undefined;
+};
+export type ModelContextTokenCounts = {
+    instructions: number;
+    tools: number;
+    prefix: number;
+};
+export type ModelContextSnapshot = {
+    version: 1;
+    capturedAt: string;
+    source: "model_request";
+    requestIndex: number;
+    instructions: string;
+    layers: ModelContextInstructionLayer[];
+    tools: ModelContextTool[];
+    skills: ModelContextSkill[];
+    tokens: ModelContextTokenCounts;
+};
+export type SessionModelContextResponse = {
+    sessionId: string;
+    attemptId: string | null;
+    turnId: string | null;
+    snapshot: ModelContextSnapshot | null;
+};

package/dist/model-picker-order.d.ts

@@ -0,0 +1 @@
+export { compareModelPickerOrder, modelPickerBillingClassFor, type ModelPickerBillingCandidate, type ModelPickerBillingClass, } from "@opengeni/contracts/model-picker-order";

package/dist/model-picker-order.js

@@ -0,0 +1,10 @@
+// src/model-picker-order.ts
+import {
+  compareModelPickerOrder,
+  modelPickerBillingClassFor
+} from "@opengeni/contracts/model-picker-order";
+export {
+  compareModelPickerOrder,
+  modelPickerBillingClassFor
+};
+//# sourceMappingURL=model-picker-order.js.map

package/dist/model-picker-order.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/model-picker-order.ts"],"sourcesContent":["export {\n  compareModelPickerOrder,\n  modelPickerBillingClassFor,\n  type ModelPickerBillingCandidate,\n  type ModelPickerBillingClass,\n} from \"@opengeni/contracts/model-picker-order\";\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,OAGK;","names":[]}

package/dist/proxy.d.ts

@@ -1,5 +1,5 @@
 import type { OpenGeniClient } from "./client.js";
-import type { StreamSessionEventsOptions } from "./stream.js";
+import { type StreamSessionEventsOptions } from "./stream.js";
 import type { SessionEvent } from "./types.js";
 /**
  * Proxy-through-your-own-API helpers.
@@ -11,9 +11,10 @@ import type { SessionEvent } from "./types.js";
  * OpenGeni's own SSE stream (`id: <sequence>`, `event: <type>`,
  * `data: <event JSON>`), so the browser side can consume it with this same
  * SDK's streaming core (or a plain `EventSource`), including resume via
- * `?after=` / `Last-Event-ID`.
+ * `?after=` / `Last-Event-ID`. An ordinary event uses its own sequence as the
+ * SSE `id`; a compact event uses the server-owned sequence it covers through.
  */
-/** Format one event exactly as OpenGeni's API emits it over SSE. */
+/** Format one event with the exact OpenGeni data and resume-cursor semantics. */
 export declare function formatSseEvent(event: SessionEvent): string;
 export type SseReStreamOptions = {
     /**
@@ -38,8 +39,9 @@ export declare function sessionEventsToSseStream(events: AsyncIterable<SessionEv
 export declare function sessionEventsToSseResponse(events: AsyncIterable<SessionEvent>, options?: SseReStreamOptions): Response;
 /**
  * Read the resume cursor a reconnecting SSE client sent: the `after` query
- * parameter, or the standard `Last-Event-ID` header (the re-emitted stream
- * sets `id:` to the sequence). Returns 0 (full replay) when absent.
+ * parameter, or the standard `Last-Event-ID` header. Re-emitted streams set
+ * `id:` to the event sequence for ordinary events and the covered high-water
+ * sequence for compact events. Returns 0 (full replay) when absent.
  */
 export declare function resumeSequenceFromRequest(request: Request): number;
 export type ProxySessionEventStreamOptions = Omit<StreamSessionEventsOptions, "after"> & {

package/dist/realtime.js

@@ -27,8 +27,8 @@ import {
   sessionRealtimeOwnerStorageKey,
   sessionRealtimeOwnerStorageNamespace,
   startCodexRealtimeWebrtc
-} from "./chunk-C2H7HBNP.js";
-import "./chunk-C4DJPZRU.js";
+} from "./chunk-7S2MZ65L.js";
+import "./chunk-OO5LPTO7.js";
 
 // src/realtime.ts
 function sessionRealtimeTransportKind(model) {

package/dist/session-titles.d.ts

@@ -1,28 +1,2 @@
-import { AUTOMATIC_SESSION_TITLE_FALLBACK } from "@opengeni/contracts/session-titles";
-import type { Session } from "./types.js";
-export { AUTOMATIC_SESSION_TITLE_FALLBACK };
-export type SessionDisplayTitleInput = {
-    title?: Session["title"] | undefined;
-    titleSource?: Session["titleSource"] | undefined;
-    initialMessage?: Session["initialMessage"] | null | undefined;
-    metadata?: Readonly<Record<string, unknown>> | undefined;
-};
-export type SessionDisplayTitleOptions = {
-    /** Optional metadata fields to try before the opening-prompt preview. */
-    metadataKeys?: readonly string[] | undefined;
-};
-/**
- * Whether the durable title still represents the automatic-title pending state.
- * A user-authored title always wins, even when its literal value is the fallback.
- */
-export declare function sessionTitleIsPending(input: SessionDisplayTitleInput): boolean;
-/**
- * Derive the title a client should display for a session.
- *
- * A semantic agent title or human rename wins. While automatic naming is still
- * pending, clients show a short, sensitive-safe preview of the opening prompt;
- * the preview is never persisted as title metadata and is replaced naturally
- * when `session.title_set` arrives. Obvious credential-, URL-, or identifier-
- * shaped prompt prefixes retain the generic fallback.
- */
-export declare function deriveSessionDisplayTitle(input: SessionDisplayTitleInput, options?: SessionDisplayTitleOptions): string;
+export { AUTOMATIC_SESSION_TITLE_FALLBACK, deriveAutomaticSessionTitlePreview, deriveSessionDisplayTitle, sessionTitleIsPending, } from "@opengeni/contracts/session-titles";
+export type { SessionDisplayTitleInput, SessionDisplayTitleOptions, } from "@opengeni/contracts/session-titles";

package/dist/site.d.ts

@@ -0,0 +1,93 @@
+import { type OpenGeniWorkspaceTools } from "./tools.js";
+import type { ToolGatewayCallRequest, ToolGatewayCallResponse, ToolGatewayCatalog, ToolGatewayDeclarationsResponse } from "./types.js";
+export declare const OPENGENI_SITE_BRIDGE_VERSION: 2;
+export declare const OPENGENI_SITE_BRIDGE_CONNECT: "opengeni.site.connect";
+export declare const OPENGENI_SITE_BRIDGE_READY: "opengeni.site.ready";
+export declare const OPENGENI_SITE_BRIDGE_REQUEST: "opengeni.site.request";
+export declare const OPENGENI_SITE_BRIDGE_RESPONSE: "opengeni.site.response";
+export declare const OPENGENI_SITE_BRIDGE_CANCEL: "opengeni.site.cancel";
+export declare const OPENGENI_SITE_BRIDGE_BOOTSTRAP_GLOBAL: "__opengeniSiteBridgeBootstrapV2";
+export declare const OPENGENI_SITE_LOCAL_CODEMODE_PATH: "/__opengeni/site-tools";
+export type OpenGeniSiteBridgeConnectMessage = {
+    type: typeof OPENGENI_SITE_BRIDGE_CONNECT;
+    version: typeof OPENGENI_SITE_BRIDGE_VERSION;
+};
+export type OpenGeniSiteBridgeReadyMessage = {
+    type: typeof OPENGENI_SITE_BRIDGE_READY;
+    version: typeof OPENGENI_SITE_BRIDGE_VERSION;
+};
+/** Site-originated calls cannot carry host-only approval tokens or Site-version authority. */
+export type OpenGeniSiteToolCallRequest = Omit<ToolGatewayCallRequest, "approvalToken" | "siteArtifactId" | "siteVersionId">;
+/** Host-filtered catalog projection. Tenant routing context never enters Site code. */
+export type OpenGeniSiteToolCatalog = Omit<ToolGatewayCatalog, "accountId" | "workspaceId">;
+export type OpenGeniSiteWorkspaceTools = OpenGeniWorkspaceTools<OpenGeniSiteToolCatalog>;
+export type OpenGeniSiteBridgeRequestMessage = {
+    type: typeof OPENGENI_SITE_BRIDGE_REQUEST;
+    version: typeof OPENGENI_SITE_BRIDGE_VERSION;
+    requestId: string;
+} & ({
+    method: "catalog";
+} | {
+    method: "call";
+    payload: OpenGeniSiteToolCallRequest;
+} | {
+    method: "declarations";
+});
+export type OpenGeniSiteBridgeCancelMessage = {
+    type: typeof OPENGENI_SITE_BRIDGE_CANCEL;
+    version: typeof OPENGENI_SITE_BRIDGE_VERSION;
+    requestId: string;
+};
+export type OpenGeniSiteBridgeResponseMessage = {
+    type: typeof OPENGENI_SITE_BRIDGE_RESPONSE;
+    version: typeof OPENGENI_SITE_BRIDGE_VERSION;
+    requestId: string;
+} & ({
+    ok: true;
+    value: OpenGeniSiteToolCatalog | ToolGatewayCallResponse | ToolGatewayDeclarationsResponse;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        retryable: boolean;
+        outcomeUnknown?: boolean;
+    };
+});
+export type OpenGeniSiteClient = {
+    /** Workspace-bound typed facade. The parent host owns workspace identity and credentials. */
+    readonly tools: OpenGeniSiteWorkspaceTools;
+    close(): void;
+};
+export type OpenGeniSiteClientOptions = {
+    /** Advanced embedding seam; ordinary Sites accept bootstrap only from their exact parent. */
+    parentWindow?: MessageEventSource;
+    /** Advanced embedding seam for listening to the host's document-bound bootstrap message. */
+    siteWindow?: Pick<Window, "parent" | "addEventListener" | "removeEventListener">;
+    /** Test/embedding seam for an already document-bound host bootstrap port. */
+    bootstrapPort?: MessagePort;
+    connectTimeoutMs?: number;
+    requestTimeoutMs?: number;
+    createMessageChannel?: () => MessageChannel;
+    /** Local-preview seam. Top-level pages use this same-origin Codemode proxy automatically. */
+    localCodemodePath?: string | false;
+    /** Test/embedding seam for local-preview requests. */
+    fetch?: typeof globalThis.fetch;
+};
+export declare class OpenGeniSiteBridgeError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly outcomeUnknown: boolean;
+    constructor(code: string, message: string, retryable?: boolean, outcomeUnknown?: boolean);
+}
+/**
+ * Create the browser client used by a Site. Published iframes use the parent
+ * MessagePort; top-level sandbox previews use the same-origin Codemode adapter.
+ * Credentials remain in the selected host and never enter Site code.
+ */
+export declare function createOpenGeniSiteClient(options?: OpenGeniSiteClientOptions): OpenGeniSiteClient;
+export declare function isOpenGeniSiteBridgeConnectMessage(value: unknown): value is OpenGeniSiteBridgeConnectMessage;
+export declare function isOpenGeniSiteBridgeRequestMessage(value: unknown): value is OpenGeniSiteBridgeRequestMessage;
+export declare function isOpenGeniSiteBridgeCancelMessage(value: unknown): value is OpenGeniSiteBridgeCancelMessage;
+/** Strip every host-only field before a call crosses the Site boundary. */
+export declare function sanitizeOpenGeniSiteToolCallRequest(value: ToolGatewayCallRequest): OpenGeniSiteToolCallRequest;

package/dist/site.js

@@ -0,0 +1,35 @@
+import {
+  OPENGENI_SITE_BRIDGE_BOOTSTRAP_GLOBAL,
+  OPENGENI_SITE_BRIDGE_CANCEL,
+  OPENGENI_SITE_BRIDGE_CONNECT,
+  OPENGENI_SITE_BRIDGE_READY,
+  OPENGENI_SITE_BRIDGE_REQUEST,
+  OPENGENI_SITE_BRIDGE_RESPONSE,
+  OPENGENI_SITE_BRIDGE_VERSION,
+  OPENGENI_SITE_LOCAL_CODEMODE_PATH,
+  OpenGeniSiteBridgeError,
+  createOpenGeniSiteClient,
+  isOpenGeniSiteBridgeCancelMessage,
+  isOpenGeniSiteBridgeConnectMessage,
+  isOpenGeniSiteBridgeRequestMessage,
+  sanitizeOpenGeniSiteToolCallRequest
+} from "./chunk-IRAEPLXG.js";
+import "./chunk-FMLDFJ2Q.js";
+import "./chunk-OO5LPTO7.js";
+export {
+  OPENGENI_SITE_BRIDGE_BOOTSTRAP_GLOBAL,
+  OPENGENI_SITE_BRIDGE_CANCEL,
+  OPENGENI_SITE_BRIDGE_CONNECT,
+  OPENGENI_SITE_BRIDGE_READY,
+  OPENGENI_SITE_BRIDGE_REQUEST,
+  OPENGENI_SITE_BRIDGE_RESPONSE,
+  OPENGENI_SITE_BRIDGE_VERSION,
+  OPENGENI_SITE_LOCAL_CODEMODE_PATH,
+  OpenGeniSiteBridgeError,
+  createOpenGeniSiteClient,
+  isOpenGeniSiteBridgeCancelMessage,
+  isOpenGeniSiteBridgeConnectMessage,
+  isOpenGeniSiteBridgeRequestMessage,
+  sanitizeOpenGeniSiteToolCallRequest
+};
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

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

package/dist/stream.d.ts

@@ -61,3 +61,5 @@ export declare function streamSessionEvents(transport: SessionEventStreamTranspo
 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>;
+/** Trusted SSE coverage attached non-enumerably to a streamed event. */
+export declare function sessionEventStreamCoveredThrough(event: SessionEvent): number | null;

package/dist/tools-FSTY4FAY.js

@@ -0,0 +1,12 @@
+import {
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient
+} from "./chunk-FMLDFJ2Q.js";
+import "./chunk-OO5LPTO7.js";
+export {
+  OpenGeniToolCallError,
+  OpenGeniToolReapprovalRequiredError,
+  OpenGeniToolsClient
+};
+//# sourceMappingURL=tools-FSTY4FAY.js.map

package/dist/tools-FSTY4FAY.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,61 @@
+import type { ToolGatewayApprovalResponse, ToolGatewayCatalog, ToolGatewayDeclarationsResponse, ToolGatewayIdentity, ToolGatewayResult } from "./types.js";
+export type OpenGeniToolCallOptions = {
+    operationId?: string;
+    signal?: AbortSignal;
+    refreshCatalog?: boolean;
+    /** Server-issued, single-use capability returned by `$approve`. */
+    approvalToken?: string;
+};
+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 $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 {
+    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;
+}