@opengeni/sdk 0.52.1 → 1.0.0

package/dist/interaction.js

@@ -1,54 +1,85 @@
 import {
   AttachedBrowserDeviceCollection,
   AttachedBrowserDeviceResource,
+  AuthRunCollection,
+  AuthRunResource,
   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,
+  BrowserAuthRunCollection,
+  BrowserClipboardResource,
+  BrowserDownloadCollection,
+  BrowserDownloadResource,
   BrowserIdentityCollection,
   BrowserIdentityResource,
   BrowserSessionCollection,
   BrowserSessionResource,
   BrowserTargetCollection,
   COMPUTER_CONTROL_WEBSOCKET_PROTOCOL,
+  ComputerClipboardResource,
   ComputerSessionCollection,
   ComputerSessionResource,
   ComputerTargetCollection,
   INTERACTION_PROTOCOL_VERSION,
+  InteractionInterventionCollection,
+  InteractionInterventionResource,
+  NetworkRouteCollection,
+  NetworkRouteResource,
   OpenGeniInteractionClient,
+  SiteAuthConnectionCollection,
+  SiteAuthConnectionResource,
   browserFrameSocketUrl,
   computerFrameSocketUrl,
   decodeBrowserFrameMessage,
   decodeComputerFrameMessage,
+  decodeComputerFrameMetadataHeader,
+  interactionControlFailureFromError,
   parseBrowserFrameMetadata,
   parseComputerFrameMetadata
-} from "./chunk-MZWTWOX6.js";
+} from "./chunk-NC57YMUO.js";
+import "./chunk-V6GIY62B.js";
 export {
   AttachedBrowserDeviceCollection,
   AttachedBrowserDeviceResource,
+  AuthRunCollection,
+  AuthRunResource,
   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,
+  BrowserAuthRunCollection,
+  BrowserClipboardResource,
+  BrowserDownloadCollection,
+  BrowserDownloadResource,
   BrowserIdentityCollection,
   BrowserIdentityResource,
   BrowserSessionCollection,
   BrowserSessionResource,
   BrowserTargetCollection,
   COMPUTER_CONTROL_WEBSOCKET_PROTOCOL,
+  ComputerClipboardResource,
   ComputerSessionCollection,
   ComputerSessionResource,
   ComputerTargetCollection,
   INTERACTION_PROTOCOL_VERSION,
+  InteractionInterventionCollection,
+  InteractionInterventionResource,
+  NetworkRouteCollection,
+  NetworkRouteResource,
   OpenGeniInteractionClient,
+  SiteAuthConnectionCollection,
+  SiteAuthConnectionResource,
   browserFrameSocketUrl,
   computerFrameSocketUrl,
   decodeBrowserFrameMessage,
   decodeComputerFrameMessage,
+  decodeComputerFrameMetadataHeader,
+  interactionControlFailureFromError,
   parseBrowserFrameMetadata,
   parseComputerFrameMetadata
 };

package/dist/knowledge.d.ts

@@ -0,0 +1,7 @@
+export type { AgentLearningMode, AgentLearningCategory, AgentLearningDefaults, AgentLearningOverrides, AgentLearningContext, AgentLearningOverridePatch, AgentLearningSettingsRecord, AgentLearningOverrideRecord, SaveAgentLearningSettingsRequest, KnowledgeFilePreparationResult, KnowledgeSavePreparationRequest, KnowledgeSavePreparationResponse, KnowledgeOriginalFileDownload, KnowledgeEntryKind, KnowledgeEntryScope, KnowledgeIndexStatus, KnowledgeEntryContent, KnowledgeEntrySource, KnowledgeEntryEvidence, KnowledgeEntryRelationship, KnowledgeEntryRecord, KnowledgeEntrySummary, KnowledgeEntrySaveRequest, KnowledgeEntryReviewRequest, KnowledgeEntryBatchReviewRequest, KnowledgeEntryRestoreRequest, KnowledgeEntryWriteReceipt, KnowledgeEntryListRequest, KnowledgeEntryListResponse, KnowledgeReviewBatch, KnowledgeReviewBatchListRequest, KnowledgeReviewBatchListResponse, AgentInstructionReviewRequest, AgentInstructionReceipt, AgentInstructionReviewItem, AgentInstructionReviewListResponse, } from "@opengeni/contracts";
+import type { OpenGeniClient } from "./client.js";
+import type { KnowledgeSavePreparationRequest, KnowledgeSavePreparationResponse, KnowledgeFilePreparationResult } from "@opengeni/contracts";
+/** Agent-only source preparation is a focused transport surface, outside the browser client. */
+export declare function prepareKnowledgeFile(client: Pick<OpenGeniClient, "requestJson">, workspaceId: string, fileId: string, purpose?: "evidence" | "reference"): Promise<KnowledgeFilePreparationResult>;
+/** Read-only collection/duplicate discovery for a live selected agent or human Knowledge reviewer. */
+export declare function prepareKnowledgeSave(client: Pick<OpenGeniClient, "requestJson">, workspaceId: string, request: KnowledgeSavePreparationRequest): Promise<KnowledgeSavePreparationResponse>;

package/dist/knowledge.js

@@ -0,0 +1,20 @@
+// src/knowledge.ts
+async function prepareKnowledgeFile(client, workspaceId, fileId, purpose) {
+  return client.requestJson(
+    "POST",
+    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/files/${encodeURIComponent(fileId)}/prepare`,
+    purpose ? { purpose } : void 0
+  );
+}
+async function prepareKnowledgeSave(client, workspaceId, request) {
+  return client.requestJson(
+    "POST",
+    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/entries/prepare-save`,
+    request
+  );
+}
+export {
+  prepareKnowledgeFile,
+  prepareKnowledgeSave
+};
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/knowledge.ts"],"sourcesContent":["export type {\n  AgentLearningMode,\n  AgentLearningCategory,\n  AgentLearningDefaults,\n  AgentLearningOverrides,\n  AgentLearningContext,\n  AgentLearningOverridePatch,\n  AgentLearningSettingsRecord,\n  AgentLearningOverrideRecord,\n  SaveAgentLearningSettingsRequest,\n  KnowledgeFilePreparationResult,\n  KnowledgeSavePreparationRequest,\n  KnowledgeSavePreparationResponse,\n  KnowledgeOriginalFileDownload,\n  KnowledgeEntryKind,\n  KnowledgeEntryScope,\n  KnowledgeIndexStatus,\n  KnowledgeEntryContent,\n  KnowledgeEntrySource,\n  KnowledgeEntryEvidence,\n  KnowledgeEntryRelationship,\n  KnowledgeEntryRecord,\n  KnowledgeEntrySummary,\n  KnowledgeEntrySaveRequest,\n  KnowledgeEntryReviewRequest,\n  KnowledgeEntryBatchReviewRequest,\n  KnowledgeEntryRestoreRequest,\n  KnowledgeEntryWriteReceipt,\n  KnowledgeEntryListRequest,\n  KnowledgeEntryListResponse,\n  KnowledgeReviewBatch,\n  KnowledgeReviewBatchListRequest,\n  KnowledgeReviewBatchListResponse,\n  AgentInstructionReviewRequest,\n  AgentInstructionReceipt,\n  AgentInstructionReviewItem,\n  AgentInstructionReviewListResponse,\n} from \"@opengeni/contracts\";\n\nimport type { OpenGeniClient } from \"./client\";\nimport type {\n  KnowledgeSavePreparationRequest,\n  KnowledgeSavePreparationResponse,\n  KnowledgeFilePreparationResult,\n} from \"@opengeni/contracts\";\n\n/** Agent-only source preparation is a focused transport surface, outside the browser client. */\nexport async function prepareKnowledgeFile(\n  client: Pick<OpenGeniClient, \"requestJson\">,\n  workspaceId: string,\n  fileId: string,\n  purpose?: \"evidence\" | \"reference\",\n): Promise<KnowledgeFilePreparationResult> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/files/${encodeURIComponent(fileId)}/prepare`,\n    purpose ? { purpose } : undefined,\n  );\n}\n\n/** Read-only collection/duplicate discovery for a live selected agent or human Knowledge reviewer. */\nexport async function prepareKnowledgeSave(\n  client: Pick<OpenGeniClient, \"requestJson\">,\n  workspaceId: string,\n  request: KnowledgeSavePreparationRequest,\n): Promise<KnowledgeSavePreparationResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/knowledge/entries/prepare-save`,\n    request,\n  );\n}\n"],"mappings":";AA+CA,eAAsB,qBACpB,QACA,aACA,QACA,SACyC;AACzC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC,oBAAoB,mBAAmB,MAAM,CAAC;AAAA,IAC/F,UAAU,EAAE,QAAQ,IAAI;AAAA,EAC1B;AACF;AAGA,eAAsB,qBACpB,QACA,aACA,SAC2C;AAC3C,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACjD;AAAA,EACF;AACF;","names":[]}

package/dist/message-links.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Links an agent writes into chat Markdown that point at OpenGeni-owned objects.
+ *
+ * Agents write these forms (tool receipts and bundled Skills teach them):
+ *
+ * - `artifact:<file uuid>` — a retained workspace file (exports, published files, images).
+ * - `sandbox:<path>[:<line>]` — a file in the session's sandbox or Connected Machine.
+ * - `/workspaces/<ws>/artifacts/editable/<32-hex id>` — a live editable document,
+ *   workbook, or presentation.
+ * - `/workspaces/<ws>/artifacts/<uuid>` — a saved Site / published HTML artifact.
+ * - `/workspaces/<ws>/artifacts/files/<uuid>` — a retained file (console path form).
+ *
+ * None of them is a URL a browser can navigate on its own: the `/workspaces/...`
+ * forms are OpenGeni console routes, so inside another product they resolve
+ * against that product's origin and 404. Parse them with {@link parseOpenGeniLink}
+ * and route each target to the host's own UI (download, panel, page).
+ */
+export type OpenGeniLinkTarget = {
+    kind: "file";
+    fileId: string;
+    workspaceId: string | null;
+    fromSession?: string;
+} | {
+    kind: "editable-artifact";
+    artifactId: string;
+    workspaceId: string;
+    fromSession?: string;
+} | {
+    kind: "site";
+    artifactId: string;
+    workspaceId: string;
+    fromSession?: string;
+} | {
+    kind: "sandbox-file";
+    path: string;
+    line: number | null;
+};
+/** Application scheme names are case-insensitive, unlike their payloads. */
+export declare function openGeniLinkScheme(href: string | undefined): "artifact" | "sandbox" | null;
+/** Reserved references must never fall back to navigation on a host origin. */
+export declare function isReservedOpenGeniLink(href: string | undefined): boolean;
+/**
+ * Parse an OpenGeni `sandbox:` href (plus the historical bare `/workspace/...`
+ * form). The decoded path is intentionally opaque: target selection, path
+ * policy, and filesystem authority belong to the session-aware host.
+ */
+export declare function parseSandboxLink(href: string | undefined): {
+    path: string;
+    line: number | null;
+} | null;
+/** Return the retained-file id of an exact `artifact:<uuid>` reference. */
+export declare function parseRetainedFileReference(href: string | undefined): string | null;
+/**
+ * Classify an agent-authored Markdown href. Returns `null` for ordinary links
+ * (`https://…`, `mailto:`, relative host links), which render as-is.
+ *
+ * Only root-relative console paths are recognized; an absolute URL is always an
+ * ordinary link, so a host's own `https://` routes are never reinterpreted.
+ * A validated `?fromSession=<uuid>` return hint is preserved.
+ */
+export declare function parseOpenGeniLink(href: string | undefined): OpenGeniLinkTarget | null;
+/** The OpenGeni console route for a target (the form agents write). */
+export declare function openGeniConsolePath(target: OpenGeniLinkTarget, workspaceId: string): string | null;
+/**
+ * Request header naming the session an embedded artifact read belongs to.
+ * `createSessionProxyHandler` only serves artifacts OpenGeni lists for it.
+ */
+export declare const SESSION_SCOPE_HEADER = "x-opengeni-session-id";

package/dist/model-context.d.ts

@@ -0,0 +1,68 @@
+export type ModelContextInstructionLayerId = "operational_contract" | "persona_and_core" | "workspace_governance" | "session_instructions" | "workspace_memory" | "skill_catalog" | "codemode" | "code_search" | "git_bindings" | "builtin_skills" | "genesis_title" | "sdk_capability_instructions" | "sandbox_preamble" | "sandbox_filesystem" | "sent_system_instructions" | "identity";
+/** Sections of a modular operational contract, in composition order. */
+export type AgentPromptModuleId = "base_behavior" | "runtime_mechanics" | "renderer_markdown" | "sandbox" | "connected_machine" | "repositories" | "workspace_environment" | "rig" | "artifacts" | "media" | "goals" | "subagents" | "knowledge" | "skills" | "admin" | "attachments";
+export type ModelContextInstructionModule = {
+    id: AgentPromptModuleId;
+    chars: number;
+};
+export type ModelContextInstructionLayer = {
+    id: ModelContextInstructionLayerId;
+    title: string;
+    content: string;
+    utf8Bytes: number;
+    estimatedTokens: number;
+    /** Present on the operational contract of sessions with an agent configuration. */
+    modules?: ModelContextInstructionModule[] | undefined;
+};
+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 = {
+    providerRequest?: {
+        provider: string;
+        body: string | null;
+        unavailableReason?: string | undefined;
+        parts: {
+            key: string;
+            estimatedTokens: number | null;
+            utf8Bytes: number;
+            itemEstimatedTokens?: (number | null)[] | undefined;
+        }[];
+    } | undefined;
+    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-display.d.ts

@@ -0,0 +1,2 @@
+/** One clean model name and maker for every surface outside model settings. */
+export { humanizeModelSlug, isRawModelLabel, modelDisplayName, modelSlug, modelVendor, type ModelDisplayInput, type ModelVendor, } from "@opengeni/contracts/model-display";

package/dist/model-display.js

@@ -0,0 +1,15 @@
+import {
+  humanizeModelSlug,
+  isRawModelLabel,
+  modelDisplayName,
+  modelSlug,
+  modelVendor
+} from "./chunk-ZKPY6YAJ.js";
+export {
+  humanizeModelSlug,
+  isRawModelLabel,
+  modelDisplayName,
+  modelSlug,
+  modelVendor
+};
+//# sourceMappingURL=model-display.js.map

package/dist/model-display.js.map

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

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/organization-integration-policy.d.ts

@@ -0,0 +1,26 @@
+import type { OpenGeniClient } from "./client.js";
+export type OrganizationIntegrationPolicy = {
+    mode: "unrestricted" | "restricted";
+    allowedIntegrationKeys: string[];
+    revision: number;
+};
+export type UpdateOrganizationIntegrationPolicyRequest = {
+    mode: "unrestricted" | "restricted";
+    allowedIntegrationKeys: string[];
+    expectedRevision: number;
+    operationId: string;
+};
+type PolicyClient = Pick<OpenGeniClient, "requestJson">;
+export type OrganizationIntegrationCatalog = {
+    integrations: Array<{
+        key: string;
+        label: string;
+        kind: "curated" | "custom";
+    }>;
+};
+/** Discover stable policy identities; integrations must not guess provider identifiers. */
+export declare function getOrganizationIntegrationCatalog(client: PolicyClient, organizationId: string): Promise<OrganizationIntegrationCatalog>;
+export declare function getOrganizationIntegrationPolicy(client: PolicyClient, organizationId: string): Promise<OrganizationIntegrationPolicy>;
+/** Retain operationId and the exact request when reconciling an uncertain outcome. */
+export declare function updateOrganizationIntegrationPolicy(client: PolicyClient, organizationId: string, request: UpdateOrganizationIntegrationPolicyRequest): Promise<OrganizationIntegrationPolicy>;
+export {};

package/dist/organization-integration-policy.js

@@ -0,0 +1,26 @@
+// src/organization-integration-policy.ts
+async function getOrganizationIntegrationCatalog(client, organizationId) {
+  return client.requestJson(
+    "GET",
+    `/v1/organizations/${encodeURIComponent(organizationId)}/integration-policy/catalog`
+  );
+}
+async function getOrganizationIntegrationPolicy(client, organizationId) {
+  return client.requestJson(
+    "GET",
+    `/v1/organizations/${encodeURIComponent(organizationId)}/integration-policy`
+  );
+}
+async function updateOrganizationIntegrationPolicy(client, organizationId, request) {
+  return client.requestJson(
+    "PUT",
+    `/v1/organizations/${encodeURIComponent(organizationId)}/integration-policy`,
+    request
+  );
+}
+export {
+  getOrganizationIntegrationCatalog,
+  getOrganizationIntegrationPolicy,
+  updateOrganizationIntegrationPolicy
+};
+//# sourceMappingURL=organization-integration-policy.js.map

package/dist/organization-integration-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/organization-integration-policy.ts"],"sourcesContent":["import type { OpenGeniClient } from \"./client\";\n\nexport type OrganizationIntegrationPolicy = {\n  mode: \"unrestricted\" | \"restricted\";\n  allowedIntegrationKeys: string[];\n  revision: number;\n};\n\nexport type UpdateOrganizationIntegrationPolicyRequest = {\n  mode: \"unrestricted\" | \"restricted\";\n  allowedIntegrationKeys: string[];\n  expectedRevision: number;\n  operationId: string;\n};\n\ntype PolicyClient = Pick<OpenGeniClient, \"requestJson\">;\n\nexport type OrganizationIntegrationCatalog = {\n  integrations: Array<{ key: string; label: string; kind: \"curated\" | \"custom\" }>;\n};\n\n/** Discover stable policy identities; integrations must not guess provider identifiers. */\nexport async function getOrganizationIntegrationCatalog(\n  client: PolicyClient,\n  organizationId: string,\n): Promise<OrganizationIntegrationCatalog> {\n  return client.requestJson(\n    \"GET\",\n    `/v1/organizations/${encodeURIComponent(organizationId)}/integration-policy/catalog`,\n  );\n}\n\nexport async function getOrganizationIntegrationPolicy(\n  client: PolicyClient,\n  organizationId: string,\n): Promise<OrganizationIntegrationPolicy> {\n  return client.requestJson(\n    \"GET\",\n    `/v1/organizations/${encodeURIComponent(organizationId)}/integration-policy`,\n  );\n}\n\n/** Retain operationId and the exact request when reconciling an uncertain outcome. */\nexport async function updateOrganizationIntegrationPolicy(\n  client: PolicyClient,\n  organizationId: string,\n  request: UpdateOrganizationIntegrationPolicyRequest,\n): Promise<OrganizationIntegrationPolicy> {\n  return client.requestJson(\n    \"PUT\",\n    `/v1/organizations/${encodeURIComponent(organizationId)}/integration-policy`,\n    request,\n  );\n}\n"],"mappings":";AAsBA,eAAsB,kCACpB,QACA,gBACyC;AACzC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,qBAAqB,mBAAmB,cAAc,CAAC;AAAA,EACzD;AACF;AAEA,eAAsB,iCACpB,QACA,gBACwC;AACxC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,qBAAqB,mBAAmB,cAAc,CAAC;AAAA,EACzD;AACF;AAGA,eAAsB,oCACpB,QACA,gBACA,SACwC;AACxC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,qBAAqB,mBAAmB,cAAc,CAAC;AAAA,IACvD;AAAA,EACF;AACF;","names":[]}

package/dist/organization-private-session-settings.d.ts

@@ -0,0 +1,6 @@
+import type { OpenGeniClient } from "./client.js";
+import type { OrganizationPrivateSessionSettings, UpdateOrganizationPrivateSessionSettingsRequest } from "./types.js";
+type OrganizationPrivateSessionSettingsClient = Pick<OpenGeniClient, "requestJson">;
+export declare function getOrganizationPrivateSessionSettings(client: OrganizationPrivateSessionSettingsClient, organizationId: string): Promise<OrganizationPrivateSessionSettings>;
+export declare function updateOrganizationPrivateSessionSettings(client: OrganizationPrivateSessionSettingsClient, organizationId: string, request: UpdateOrganizationPrivateSessionSettingsRequest): Promise<OrganizationPrivateSessionSettings>;
+export {};

package/dist/organization-private-session-settings.js

@@ -0,0 +1,22 @@
+// src/organization-private-session-settings.ts
+function settingsPath(organizationId) {
+  return `/v1/organizations/${organizationId}/private-session-settings`;
+}
+async function getOrganizationPrivateSessionSettings(client, organizationId) {
+  return await client.requestJson(
+    "GET",
+    settingsPath(organizationId)
+  );
+}
+async function updateOrganizationPrivateSessionSettings(client, organizationId, request) {
+  return await client.requestJson(
+    "PATCH",
+    settingsPath(organizationId),
+    request
+  );
+}
+export {
+  getOrganizationPrivateSessionSettings,
+  updateOrganizationPrivateSessionSettings
+};
+//# sourceMappingURL=organization-private-session-settings.js.map

package/dist/organization-private-session-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/organization-private-session-settings.ts"],"sourcesContent":["import type { OpenGeniClient } from \"./client\";\nimport type {\n  OrganizationPrivateSessionSettings,\n  UpdateOrganizationPrivateSessionSettingsRequest,\n} from \"./types\";\n\ntype OrganizationPrivateSessionSettingsClient = Pick<OpenGeniClient, \"requestJson\">;\n\nfunction settingsPath(organizationId: string): string {\n  return `/v1/organizations/${organizationId}/private-session-settings`;\n}\n\nexport async function getOrganizationPrivateSessionSettings(\n  client: OrganizationPrivateSessionSettingsClient,\n  organizationId: string,\n): Promise<OrganizationPrivateSessionSettings> {\n  return await client.requestJson<OrganizationPrivateSessionSettings>(\n    \"GET\",\n    settingsPath(organizationId),\n  );\n}\n\nexport async function updateOrganizationPrivateSessionSettings(\n  client: OrganizationPrivateSessionSettingsClient,\n  organizationId: string,\n  request: UpdateOrganizationPrivateSessionSettingsRequest,\n): Promise<OrganizationPrivateSessionSettings> {\n  return await client.requestJson<OrganizationPrivateSessionSettings>(\n    \"PATCH\",\n    settingsPath(organizationId),\n    request,\n  );\n}\n"],"mappings":";AAQA,SAAS,aAAa,gBAAgC;AACpD,SAAO,qBAAqB,cAAc;AAC5C;AAEA,eAAsB,sCACpB,QACA,gBAC6C;AAC7C,SAAO,MAAM,OAAO;AAAA,IAClB;AAAA,IACA,aAAa,cAAc;AAAA,EAC7B;AACF;AAEA,eAAsB,yCACpB,QACA,gBACA,SAC6C;AAC7C,SAAO,MAAM,OAAO;AAAA,IAClB;AAAA,IACA,aAAa,cAAc;AAAA,IAC3B;AAAA,EACF;AACF;","names":[]}

package/dist/organization-user-setup.d.ts

@@ -0,0 +1,8 @@
+import type { OpenGeniClient } from "./client.js";
+import type { OrganizationUserSetupDelivery, OrganizationUserSetupPreview, PreviewOrganizationUserSetupRequest, RetryOrganizationUserSetupDeliveryRequest } from "./types.js";
+type OrganizationUserSetupClient = Pick<OpenGeniClient, "requestJson">;
+/** Safe signed-out projection of the exact organization role and shared access in a setup link. */
+export declare function previewOrganizationUserSetup(client: OrganizationUserSetupClient, request: PreviewOrganizationUserSetupRequest): Promise<OrganizationUserSetupPreview>;
+/** Retry a failed or explicitly outcome-unknown delivery with its stable provider key. */
+export declare function retryOrganizationUserSetupDelivery(client: OrganizationUserSetupClient, organizationId: string, invitationId: string, request: RetryOrganizationUserSetupDeliveryRequest): Promise<OrganizationUserSetupDelivery>;
+export {};

package/dist/organization-user-setup.js

@@ -0,0 +1,16 @@
+// src/organization-user-setup.ts
+function previewOrganizationUserSetup(client, request) {
+  return client.requestJson("POST", "/v1/auth/organization-setup/preview", request);
+}
+function retryOrganizationUserSetupDelivery(client, organizationId, invitationId, request) {
+  return client.requestJson(
+    "POST",
+    `/v1/organizations/${organizationId}/invitations/${invitationId}/delivery/retry`,
+    request
+  );
+}
+export {
+  previewOrganizationUserSetup,
+  retryOrganizationUserSetupDelivery
+};
+//# sourceMappingURL=organization-user-setup.js.map

package/dist/organization-user-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/organization-user-setup.ts"],"sourcesContent":["import type { OpenGeniClient } from \"./client\";\nimport type {\n  OrganizationUserSetupDelivery,\n  OrganizationUserSetupPreview,\n  PreviewOrganizationUserSetupRequest,\n  RetryOrganizationUserSetupDeliveryRequest,\n} from \"./types\";\n\ntype OrganizationUserSetupClient = Pick<OpenGeniClient, \"requestJson\">;\n\n/** Safe signed-out projection of the exact organization role and shared access in a setup link. */\nexport function previewOrganizationUserSetup(\n  client: OrganizationUserSetupClient,\n  request: PreviewOrganizationUserSetupRequest,\n): Promise<OrganizationUserSetupPreview> {\n  return client.requestJson(\"POST\", \"/v1/auth/organization-setup/preview\", request);\n}\n\n/** Retry a failed or explicitly outcome-unknown delivery with its stable provider key. */\nexport function retryOrganizationUserSetupDelivery(\n  client: OrganizationUserSetupClient,\n  organizationId: string,\n  invitationId: string,\n  request: RetryOrganizationUserSetupDeliveryRequest,\n): Promise<OrganizationUserSetupDelivery> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/organizations/${organizationId}/invitations/${invitationId}/delivery/retry`,\n    request,\n  );\n}\n"],"mappings":";AAWO,SAAS,6BACd,QACA,SACuC;AACvC,SAAO,OAAO,YAAY,QAAQ,uCAAuC,OAAO;AAClF;AAGO,SAAS,mCACd,QACA,gBACA,cACA,SACwC;AACxC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,qBAAqB,cAAc,gBAAgB,YAAY;AAAA,IAC/D;AAAA,EACF;AACF;","names":[]}

package/dist/pr-review-client.d.ts

@@ -0,0 +1,16 @@
+import type { OpenGeniClient as OpenGeniCoreClient } from "./client.js";
+import type { CreatePrReviewAppRegistrationRequest, CreatePrReviewRepositoryBindingRequest, PrReviewAppRegistration, PrReviewRepositoryBinding, ListPrReviewConfigurationResponse, PrReviewManagedGitHubSetup, UpdatePrReviewAppRegistrationRequest, UpdatePrReviewRepositoryBindingRequest } from "./types.js";
+export type OpenGeniPrReviewTransport = Pick<OpenGeniCoreClient, "requestJson" | "requestVoid">;
+/** Optional OpenGeni Review Bot API surface, isolated from the eager core client graph. */
+export declare class OpenGeniPrReviewClient {
+    private readonly client;
+    constructor(client: OpenGeniPrReviewTransport);
+    listConfiguration(workspaceId: string): Promise<ListPrReviewConfigurationResponse>;
+    getManagedGitHubSetup(workspaceId: string): Promise<PrReviewManagedGitHubSetup>;
+    createAppRegistration(workspaceId: string, request: CreatePrReviewAppRegistrationRequest): Promise<PrReviewAppRegistration>;
+    updateAppRegistration(workspaceId: string, registrationId: string, request: UpdatePrReviewAppRegistrationRequest): Promise<PrReviewAppRegistration>;
+    deleteAppRegistration(workspaceId: string, registrationId: string): Promise<void>;
+    createRepositoryBinding(workspaceId: string, request: CreatePrReviewRepositoryBindingRequest): Promise<PrReviewRepositoryBinding>;
+    updateRepositoryBinding(workspaceId: string, bindingId: string, request: UpdatePrReviewRepositoryBindingRequest): Promise<PrReviewRepositoryBinding>;
+    deleteRepositoryBinding(workspaceId: string, bindingId: string): Promise<void>;
+}

package/dist/pr-review.d.ts

@@ -0,0 +1,4 @@
+/** Optional OpenGeni Review Bot API client; import this entry only where the capability is used. */
+export { OpenGeniPrReviewClient } from "./pr-review-client.js";
+export type { OpenGeniPrReviewTransport } from "./pr-review-client.js";
+export type { CreatePrReviewAppRegistrationRequest, CreatePrReviewRepositoryBindingRequest, PrReviewAppRegistration, PrReviewCredentialKind, PrReviewProvider, PrReviewManagedGitHubInstallation, PrReviewManagedGitHubSetup, PrReviewRepositoryBinding, PrReviewWebhookAuthKind, ListPrReviewConfigurationResponse, UpdatePrReviewAppRegistrationRequest, UpdatePrReviewRepositoryBindingRequest, } from "./types.js";

package/dist/pr-review.js

@@ -0,0 +1,62 @@
+// src/pr-review-client.ts
+var OpenGeniPrReviewClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async listConfiguration(workspaceId) {
+    return await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/pr-review/registrations`
+    );
+  }
+  async getManagedGitHubSetup(workspaceId) {
+    return await this.client.requestJson(
+      "GET",
+      `/v1/workspaces/${workspaceId}/pr-review/github`
+    );
+  }
+  async createAppRegistration(workspaceId, request) {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/pr-review/registrations`,
+      request
+    );
+  }
+  async updateAppRegistration(workspaceId, registrationId, request) {
+    return await this.client.requestJson(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/pr-review/registrations/${encodeURIComponent(registrationId)}`,
+      request
+    );
+  }
+  async deleteAppRegistration(workspaceId, registrationId) {
+    await this.client.requestVoid(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/pr-review/registrations/${encodeURIComponent(registrationId)}`
+    );
+  }
+  async createRepositoryBinding(workspaceId, request) {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${workspaceId}/pr-review/repositories`,
+      request
+    );
+  }
+  async updateRepositoryBinding(workspaceId, bindingId, request) {
+    return await this.client.requestJson(
+      "PATCH",
+      `/v1/workspaces/${workspaceId}/pr-review/repositories/${encodeURIComponent(bindingId)}`,
+      request
+    );
+  }
+  async deleteRepositoryBinding(workspaceId, bindingId) {
+    await this.client.requestVoid(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/pr-review/repositories/${encodeURIComponent(bindingId)}`
+    );
+  }
+};
+export {
+  OpenGeniPrReviewClient
+};
+//# sourceMappingURL=pr-review.js.map

package/dist/pr-review.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pr-review-client.ts"],"sourcesContent":["import type { OpenGeniClient as OpenGeniCoreClient } from \"./client\";\nimport type {\n  CreatePrReviewAppRegistrationRequest,\n  CreatePrReviewRepositoryBindingRequest,\n  PrReviewAppRegistration,\n  PrReviewRepositoryBinding,\n  ListPrReviewConfigurationResponse,\n  PrReviewManagedGitHubSetup,\n  UpdatePrReviewAppRegistrationRequest,\n  UpdatePrReviewRepositoryBindingRequest,\n} from \"./types\";\n\nexport type OpenGeniPrReviewTransport = Pick<OpenGeniCoreClient, \"requestJson\" | \"requestVoid\">;\n\n/** Optional OpenGeni Review Bot API surface, isolated from the eager core client graph. */\nexport class OpenGeniPrReviewClient {\n  constructor(private readonly client: OpenGeniPrReviewTransport) {}\n\n  async listConfiguration(workspaceId: string): Promise<ListPrReviewConfigurationResponse> {\n    return await this.client.requestJson<ListPrReviewConfigurationResponse>(\n      \"GET\",\n      `/v1/workspaces/${workspaceId}/pr-review/registrations`,\n    );\n  }\n\n  async getManagedGitHubSetup(workspaceId: string): Promise<PrReviewManagedGitHubSetup> {\n    return await this.client.requestJson<PrReviewManagedGitHubSetup>(\n      \"GET\",\n      `/v1/workspaces/${workspaceId}/pr-review/github`,\n    );\n  }\n\n  async createAppRegistration(\n    workspaceId: string,\n    request: CreatePrReviewAppRegistrationRequest,\n  ): Promise<PrReviewAppRegistration> {\n    return await this.client.requestJson<PrReviewAppRegistration>(\n      \"POST\",\n      `/v1/workspaces/${workspaceId}/pr-review/registrations`,\n      request,\n    );\n  }\n\n  async updateAppRegistration(\n    workspaceId: string,\n    registrationId: string,\n    request: UpdatePrReviewAppRegistrationRequest,\n  ): Promise<PrReviewAppRegistration> {\n    return await this.client.requestJson<PrReviewAppRegistration>(\n      \"PATCH\",\n      `/v1/workspaces/${workspaceId}/pr-review/registrations/${encodeURIComponent(registrationId)}`,\n      request,\n    );\n  }\n\n  async deleteAppRegistration(workspaceId: string, registrationId: string): Promise<void> {\n    await this.client.requestVoid(\n      \"DELETE\",\n      `/v1/workspaces/${workspaceId}/pr-review/registrations/${encodeURIComponent(registrationId)}`,\n    );\n  }\n\n  async createRepositoryBinding(\n    workspaceId: string,\n    request: CreatePrReviewRepositoryBindingRequest,\n  ): Promise<PrReviewRepositoryBinding> {\n    return await this.client.requestJson<PrReviewRepositoryBinding>(\n      \"POST\",\n      `/v1/workspaces/${workspaceId}/pr-review/repositories`,\n      request,\n    );\n  }\n\n  async updateRepositoryBinding(\n    workspaceId: string,\n    bindingId: string,\n    request: UpdatePrReviewRepositoryBindingRequest,\n  ): Promise<PrReviewRepositoryBinding> {\n    return await this.client.requestJson<PrReviewRepositoryBinding>(\n      \"PATCH\",\n      `/v1/workspaces/${workspaceId}/pr-review/repositories/${encodeURIComponent(bindingId)}`,\n      request,\n    );\n  }\n\n  async deleteRepositoryBinding(workspaceId: string, bindingId: string): Promise<void> {\n    await this.client.requestVoid(\n      \"DELETE\",\n      `/v1/workspaces/${workspaceId}/pr-review/repositories/${encodeURIComponent(bindingId)}`,\n    );\n  }\n}\n"],"mappings":";AAeO,IAAM,yBAAN,MAA6B;AAAA,EAClC,YAA6B,QAAmC;AAAnC;AAAA,EAAoC;AAAA,EAEjE,MAAM,kBAAkB,aAAiE;AACvF,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,sBAAsB,aAA0D;AACpF,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,MAAM,sBACJ,aACA,SACkC;AAClC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,sBACJ,aACA,gBACA,SACkC;AAClC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW,4BAA4B,mBAAmB,cAAc,CAAC;AAAA,MAC3F;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,sBAAsB,aAAqB,gBAAuC;AACtF,UAAM,KAAK,OAAO;AAAA,MAChB;AAAA,MACA,kBAAkB,WAAW,4BAA4B,mBAAmB,cAAc,CAAC;AAAA,IAC7F;AAAA,EACF;AAAA,EAEA,MAAM,wBACJ,aACA,SACoC;AACpC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,wBACJ,aACA,WACA,SACoC;AACpC,WAAO,MAAM,KAAK,OAAO;AAAA,MACvB;AAAA,MACA,kBAAkB,WAAW,2BAA2B,mBAAmB,SAAS,CAAC;AAAA,MACrF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,wBAAwB,aAAqB,WAAkC;AACnF,UAAM,KAAK,OAAO;AAAA,MAChB;AAAA,MACA,kBAAkB,WAAW,2BAA2B,mBAAmB,SAAS,CAAC;AAAA,IACvF;AAAA,EACF;AACF;","names":[]}

package/dist/preference-registry.d.ts

@@ -1,6 +1,6 @@
 export type PreferenceRegistryScope = "organization" | "workspace" | "user";
 export type PreferenceRegistryStatus = "proposed" | "active" | "inactive" | "rejected" | "superseded" | "expired";
-export type PreferenceRegistryProvenanceSource = "human" | "onboarding" | "knowledge_proposal" | "imported_document" | "slack" | "meeting_transcript" | "call_transcript";
+export type PreferenceRegistryProvenanceSource = "human" | "onboarding" | "knowledge_proposal" | "agent" | "portable_skill" | "imported_document" | "slack" | "meeting_transcript" | "call_transcript";
 export type PreferenceRegistryTrust = "untrusted_proposal" | "personal" | "workspace_managed" | "organization_managed";
 export type PreferenceRegistryConflictStrategy = "override" | "merge" | "reject" | "inform";
 export declare function normalizePreferenceRegistryStableKey(value: string): string;
@@ -67,6 +67,7 @@ export type PreferenceRegistryEvent = {
     reason: string;
     createdAt: string;
 };
+export type PreferenceRegistryActivationAuthority = "human_confirmed" | "automatic";
 export type PreferenceRegistryDescriptor = {
     id: string;
     stableKey: string;
@@ -78,6 +79,13 @@ export type PreferenceRegistryDescriptor = {
     contentHash: string;
     precedence: PreferenceRegistryPrecedence;
     provenance: PreferenceRegistryDescriptorProvenance;
+    /**
+     * How the active revision became active. `provenance.trust` stays the frozen
+     * creation-time fact; this is the separate activation question. Null when the
+     * revision became active outside governed learning, or when the descriptor
+     * predates this field.
+     */
+    activationAuthority: PreferenceRegistryActivationAuthority | null;
     expiresAt: string | null;
     retrievalHandle: string;
 };

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.d.ts

@@ -5,13 +5,15 @@
  * 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.js";
-import { createGatewayRealtimeTransportStarter } from "./gateway-realtime-transport.js";
+import { createGatewayRealtimeTransportStarter, createXaiSubscriptionRealtimeTransportStarter } 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>;
+    getWorkspaceRealtimeModelCatalog(workspaceId: string, options?: {
+        signal?: AbortSignal | undefined;
+    }): Promise<WorkspaceRealtimeModelCatalogResponse>;
 };
-export type SessionRealtimeTransportKind = "codex" | "gateway";
+export type SessionRealtimeTransportKind = "codex" | "gateway" | "xai-subscription";
 /** Provider-neutral names for the existing, battle-tested controller projection. */
 export type SessionRealtimeController = CodexRealtimeController;
 export type SessionRealtimeControllerSnapshot = CodexRealtimeControllerSnapshot;
@@ -32,7 +34,7 @@ export declare function sessionRealtimeTransportKind(model: SessionRealtimeModel
  * semantics remain owned by the existing implementations below this facade.
  */
 export declare function createSessionRealtimeController(options: CreateSessionRealtimeControllerOptions): SessionRealtimeController;
-export { createCodexRealtimeController, createGatewayRealtimeTransportStarter, hasStoredSessionRealtimeOwnerProof, sessionRealtimeOwnerStorageKey, sessionRealtimeOwnerStorageNamespace, };
+export { createCodexRealtimeController, createGatewayRealtimeTransportStarter, createXaiSubscriptionRealtimeTransportStarter, 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.js";
 export type { SessionRealtimeLifecycleProjection } from "./codex-realtime-lifecycle.js";