@opengeni/sdk 0.57.0 → 1.0.0

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

@@ -9,7 +9,9 @@ import { createGatewayRealtimeTransportStarter, createXaiSubscriptionRealtimeTra
 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" | "xai-subscription";
 /** Provider-neutral names for the existing, battle-tested controller projection. */

package/dist/realtime.js

@@ -1,7 +1,3 @@
-import {
-  createGatewayRealtimeTransportStarter,
-  createXaiSubscriptionRealtimeTransportStarter
-} from "./chunk-YKZME56C.js";
 import {
   CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,
   CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT,
@@ -27,8 +23,12 @@ import {
   sessionRealtimeOwnerStorageKey,
   sessionRealtimeOwnerStorageNamespace,
   startCodexRealtimeWebrtc
-} from "./chunk-JDLDDRNE.js";
-import "./chunk-GU6JF75T.js";
+} from "./chunk-2UXZUCEZ.js";
+import {
+  createGatewayRealtimeTransportStarter,
+  createXaiSubscriptionRealtimeTransportStarter
+} from "./chunk-KWADQ227.js";
+import "./chunk-V6GIY62B.js";
 
 // src/realtime.ts
 function sessionRealtimeTransportKind(model) {

package/dist/realtime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/realtime.ts"],"sourcesContent":["/**\n * Public, provider-neutral realtime browser SDK.\n *\n * Import this subpath lazily in browser applications. The base `@opengeni/sdk`\n * entry remains free of eager realtime transport initialization.\n */\nimport {\n  createCodexRealtimeController,\n  hasStoredSessionRealtimeOwnerProof,\n  sessionRealtimeOwnerStorageKey,\n  sessionRealtimeOwnerStorageNamespace,\n  type CodexRealtimeController,\n  type CodexRealtimeControllerClient,\n  type CodexRealtimeControllerSnapshot,\n  type CodexRealtimeControllerStatus,\n  type CodexRealtimeDiagnostic,\n  type CodexRealtimeDiagnosticKind,\n  type CodexRealtimeMicrophoneState,\n  type CodexRealtimeOwnerStorage,\n  type CreateCodexRealtimeControllerOptions,\n  type RealtimeControllerTransportStarter,\n} from \"./codex-realtime-controller\";\nimport {\n  createGatewayRealtimeTransportStarter,\n  createXaiSubscriptionRealtimeTransportStarter,\n} from \"./gateway-realtime-transport\";\nimport type { SessionRealtimeModel, WorkspaceRealtimeModelCatalogResponse } from \"./types\";\n\n/** Exact backend-facing methods required by the batteries-included realtime SDK. */\nexport type SessionRealtimeClientLike = CodexRealtimeControllerClient & {\n  getWorkspaceRealtimeModelCatalog(\n    workspaceId: string,\n  ): Promise<WorkspaceRealtimeModelCatalogResponse>;\n};\n\nexport type SessionRealtimeTransportKind = \"codex\" | \"gateway\" | \"xai-subscription\";\n\n/** Provider-neutral names for the existing, battle-tested controller projection. */\nexport type SessionRealtimeController = CodexRealtimeController;\nexport type SessionRealtimeControllerSnapshot = CodexRealtimeControllerSnapshot;\nexport type SessionRealtimeControllerStatus = CodexRealtimeControllerStatus;\nexport type SessionRealtimeDiagnostic = CodexRealtimeDiagnostic;\nexport type SessionRealtimeDiagnosticKind = CodexRealtimeDiagnosticKind;\nexport type SessionRealtimeMicrophoneState = CodexRealtimeMicrophoneState;\nexport type SessionRealtimeOwnerStorage = CodexRealtimeOwnerStorage;\n\nexport type CreateSessionRealtimeControllerOptions = Omit<\n  CreateCodexRealtimeControllerOptions,\n  \"client\" | \"model\" | \"ownerStorageNamespace\" | \"startTransport\"\n> & {\n  client: CodexRealtimeControllerClient;\n  model: SessionRealtimeModel;\n};\n\n/** Select the existing transport without exposing provider mechanics to hosts. */\nexport function sessionRealtimeTransportKind(\n  model: SessionRealtimeModel,\n): SessionRealtimeTransportKind {\n  if (model === \"gpt-live-1-boulder-alpha\") return \"codex\";\n  if (model === \"supergrok/grok-voice-think-fast-2.0\") return \"xai-subscription\";\n  return \"gateway\";\n}\n\n/**\n * Compose the exact current controller with its existing Codex Live or AI\n * Gateway transport. Wire, ledger, delegation, recovery, and lifecycle\n * semantics remain owned by the existing implementations below this facade.\n */\nexport function createSessionRealtimeController(\n  options: CreateSessionRealtimeControllerOptions,\n): SessionRealtimeController {\n  const transport = sessionRealtimeTransportKind(options.model);\n  return createCodexRealtimeController({\n    ...options,\n    ownerStorageNamespace: sessionRealtimeOwnerStorageNamespace(options.model),\n    ...(transport === \"gateway\"\n      ? { startTransport: createGatewayRealtimeTransportStarter() }\n      : transport === \"xai-subscription\"\n        ? { startTransport: createXaiSubscriptionRealtimeTransportStarter() }\n        : {}),\n  });\n}\n\nexport {\n  createCodexRealtimeController,\n  createGatewayRealtimeTransportStarter,\n  createXaiSubscriptionRealtimeTransportStarter,\n  hasStoredSessionRealtimeOwnerProof,\n  sessionRealtimeOwnerStorageKey,\n  sessionRealtimeOwnerStorageNamespace,\n};\nexport type {\n  CodexRealtimeController,\n  CodexRealtimeControllerClient,\n  CodexRealtimeControllerSnapshot,\n  CodexRealtimeControllerStatus,\n  CodexRealtimeDiagnostic,\n  CodexRealtimeDiagnosticKind,\n  CodexRealtimeMicrophoneState,\n  CodexRealtimeOwnerStorage,\n  CreateCodexRealtimeControllerOptions,\n  RealtimeControllerTransportStarter,\n};\n\nexport {\n  CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,\n  projectSessionRealtimeLifecycle,\n} from \"./codex-realtime-controller\";\nexport type { SessionRealtimeLifecycleProjection } from \"./codex-realtime-lifecycle\";\n\nexport {\n  CodexRealtimeMicrophoneError,\n  acquireCodexRealtimeMicrophone,\n  codexRealtimeMicrophoneHealthy,\n  startCodexRealtimeWebrtc,\n} from \"./codex-realtime\";\nexport type {\n  AcquireCodexRealtimeMicrophoneOptions,\n  CodexRealtimeAudibleOutputState,\n  CodexRealtimeConnectionHealth,\n  CodexRealtimeMicrophoneErrorCode,\n  CodexRealtimeNegotiator,\n  CodexRealtimeWebrtcSession,\n  StartCodexRealtimeWebrtcOptions,\n} from \"./codex-realtime\";\n\nexport {\n  CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,\n  CODEX_REALTIME_V3_MAX_EVENT_BYTES,\n  CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,\n  CODEX_REALTIME_V3_MAX_TEXT_BYTES,\n  CODEX_REALTIME_V3_PENDING_MAX_BYTES,\n  CODEX_REALTIME_V3_PENDING_MAX_ENTRIES,\n  CODEX_REALTIME_V3_SYNC_MAX_ENTRIES,\n  contextAppendChunks,\n  createCodexRealtimeV3Bridge,\n  encodeCodexRealtimeV3DelegationContextAppend,\n  encodeCodexRealtimeV3SessionContextAppend,\n  parseCodexRealtimeV3Event,\n} from \"./codex-realtime-v3\";\nexport type {\n  CodexRealtimeV3Bridge,\n  CodexRealtimeV3BridgeFatal,\n  CodexRealtimeV3BridgeOptions,\n  CodexRealtimeV3BridgeSnapshot,\n  CodexRealtimeV3ContextAppendChannel,\n  CodexRealtimeV3DelegationContextAppend,\n  CodexRealtimeV3Event,\n  CodexRealtimeV3ParseFailure,\n  CodexRealtimeV3ParseResult,\n  CodexRealtimeV3SessionContextAppend,\n} from \"./codex-realtime-v3\";\n\nexport {\n  CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT,\n  CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS,\n} from \"./codex-realtime-v3-wire\";\nexport type { CodexRealtimeInitialItem } from \"./codex-realtime-v3-wire\";\n\nexport type {\n  ActivateCodexRealtimeConnectionRequest,\n  BeginSessionRealtimeRequest,\n  CodexRealtimeVoice,\n  CodexRealtimeWebrtcRequest,\n  CodexRealtimeWebrtcResponse,\n  CodexRealtimeWebrtcVersion,\n  EndSessionRealtimeRequest,\n  GatewayRealtimeConnectRequest,\n  GatewayRealtimeConnectResponse,\n  GatewayRealtimeInitialItem,\n  RenewSessionRealtimeRequest,\n  SessionRealtimeEndReason,\n  SessionRealtimeLedgerEntry,\n  SessionRealtimeMode,\n  SessionRealtimeModel,\n  SessionRealtimeMutationResponse,\n  SessionRealtimeState,\n  SyncSessionRealtimeLedgerRequest,\n  SyncSessionRealtimeLedgerResponse,\n  WorkspaceRealtimeModelCatalogItem,\n  WorkspaceRealtimeModelCatalogResponse,\n} from \"./types\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDO,SAAS,6BACd,OAC8B;AAC9B,MAAI,UAAU,2BAA4B,QAAO;AACjD,MAAI,UAAU,sCAAuC,QAAO;AAC5D,SAAO;AACT;AAOO,SAAS,gCACd,SAC2B;AAC3B,QAAM,YAAY,6BAA6B,QAAQ,KAAK;AAC5D,SAAO,8BAA8B;AAAA,IACnC,GAAG;AAAA,IACH,uBAAuB,qCAAqC,QAAQ,KAAK;AAAA,IACzE,GAAI,cAAc,YACd,EAAE,gBAAgB,sCAAsC,EAAE,IAC1D,cAAc,qBACZ,EAAE,gBAAgB,8CAA8C,EAAE,IAClE,CAAC;AAAA,EACT,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/realtime.ts"],"sourcesContent":["/**\n * Public, provider-neutral realtime browser SDK.\n *\n * Import this subpath lazily in browser applications. The base `@opengeni/sdk`\n * entry remains free of eager realtime transport initialization.\n */\nimport {\n  createCodexRealtimeController,\n  hasStoredSessionRealtimeOwnerProof,\n  sessionRealtimeOwnerStorageKey,\n  sessionRealtimeOwnerStorageNamespace,\n  type CodexRealtimeController,\n  type CodexRealtimeControllerClient,\n  type CodexRealtimeControllerSnapshot,\n  type CodexRealtimeControllerStatus,\n  type CodexRealtimeDiagnostic,\n  type CodexRealtimeDiagnosticKind,\n  type CodexRealtimeMicrophoneState,\n  type CodexRealtimeOwnerStorage,\n  type CreateCodexRealtimeControllerOptions,\n  type RealtimeControllerTransportStarter,\n} from \"./codex-realtime-controller\";\nimport {\n  createGatewayRealtimeTransportStarter,\n  createXaiSubscriptionRealtimeTransportStarter,\n} from \"./gateway-realtime-transport\";\nimport type { SessionRealtimeModel, WorkspaceRealtimeModelCatalogResponse } from \"./types\";\n\n/** Exact backend-facing methods required by the batteries-included realtime SDK. */\nexport type SessionRealtimeClientLike = CodexRealtimeControllerClient & {\n  getWorkspaceRealtimeModelCatalog(\n    workspaceId: string,\n    options?: { signal?: AbortSignal | undefined },\n  ): Promise<WorkspaceRealtimeModelCatalogResponse>;\n};\n\nexport type SessionRealtimeTransportKind = \"codex\" | \"gateway\" | \"xai-subscription\";\n\n/** Provider-neutral names for the existing, battle-tested controller projection. */\nexport type SessionRealtimeController = CodexRealtimeController;\nexport type SessionRealtimeControllerSnapshot = CodexRealtimeControllerSnapshot;\nexport type SessionRealtimeControllerStatus = CodexRealtimeControllerStatus;\nexport type SessionRealtimeDiagnostic = CodexRealtimeDiagnostic;\nexport type SessionRealtimeDiagnosticKind = CodexRealtimeDiagnosticKind;\nexport type SessionRealtimeMicrophoneState = CodexRealtimeMicrophoneState;\nexport type SessionRealtimeOwnerStorage = CodexRealtimeOwnerStorage;\n\nexport type CreateSessionRealtimeControllerOptions = Omit<\n  CreateCodexRealtimeControllerOptions,\n  \"client\" | \"model\" | \"ownerStorageNamespace\" | \"startTransport\"\n> & {\n  client: CodexRealtimeControllerClient;\n  model: SessionRealtimeModel;\n};\n\n/** Select the existing transport without exposing provider mechanics to hosts. */\nexport function sessionRealtimeTransportKind(\n  model: SessionRealtimeModel,\n): SessionRealtimeTransportKind {\n  if (model === \"gpt-live-1-boulder-alpha\") return \"codex\";\n  if (model === \"supergrok/grok-voice-think-fast-2.0\") return \"xai-subscription\";\n  return \"gateway\";\n}\n\n/**\n * Compose the exact current controller with its existing Codex Live or AI\n * Gateway transport. Wire, ledger, delegation, recovery, and lifecycle\n * semantics remain owned by the existing implementations below this facade.\n */\nexport function createSessionRealtimeController(\n  options: CreateSessionRealtimeControllerOptions,\n): SessionRealtimeController {\n  const transport = sessionRealtimeTransportKind(options.model);\n  return createCodexRealtimeController({\n    ...options,\n    ownerStorageNamespace: sessionRealtimeOwnerStorageNamespace(options.model),\n    ...(transport === \"gateway\"\n      ? { startTransport: createGatewayRealtimeTransportStarter() }\n      : transport === \"xai-subscription\"\n        ? { startTransport: createXaiSubscriptionRealtimeTransportStarter() }\n        : {}),\n  });\n}\n\nexport {\n  createCodexRealtimeController,\n  createGatewayRealtimeTransportStarter,\n  createXaiSubscriptionRealtimeTransportStarter,\n  hasStoredSessionRealtimeOwnerProof,\n  sessionRealtimeOwnerStorageKey,\n  sessionRealtimeOwnerStorageNamespace,\n};\nexport type {\n  CodexRealtimeController,\n  CodexRealtimeControllerClient,\n  CodexRealtimeControllerSnapshot,\n  CodexRealtimeControllerStatus,\n  CodexRealtimeDiagnostic,\n  CodexRealtimeDiagnosticKind,\n  CodexRealtimeMicrophoneState,\n  CodexRealtimeOwnerStorage,\n  CreateCodexRealtimeControllerOptions,\n  RealtimeControllerTransportStarter,\n};\n\nexport {\n  CODEX_REALTIME_NEGOTIATION_TIMEOUT_MS,\n  projectSessionRealtimeLifecycle,\n} from \"./codex-realtime-controller\";\nexport type { SessionRealtimeLifecycleProjection } from \"./codex-realtime-lifecycle\";\n\nexport {\n  CodexRealtimeMicrophoneError,\n  acquireCodexRealtimeMicrophone,\n  codexRealtimeMicrophoneHealthy,\n  startCodexRealtimeWebrtc,\n} from \"./codex-realtime\";\nexport type {\n  AcquireCodexRealtimeMicrophoneOptions,\n  CodexRealtimeAudibleOutputState,\n  CodexRealtimeConnectionHealth,\n  CodexRealtimeMicrophoneErrorCode,\n  CodexRealtimeNegotiator,\n  CodexRealtimeWebrtcSession,\n  StartCodexRealtimeWebrtcOptions,\n} from \"./codex-realtime\";\n\nexport {\n  CODEX_REALTIME_CONTEXT_APPEND_MAX_BYTES,\n  CODEX_REALTIME_V3_MAX_EVENT_BYTES,\n  CODEX_REALTIME_V3_MAX_IDENTIFIER_BYTES,\n  CODEX_REALTIME_V3_MAX_TEXT_BYTES,\n  CODEX_REALTIME_V3_PENDING_MAX_BYTES,\n  CODEX_REALTIME_V3_PENDING_MAX_ENTRIES,\n  CODEX_REALTIME_V3_SYNC_MAX_ENTRIES,\n  contextAppendChunks,\n  createCodexRealtimeV3Bridge,\n  encodeCodexRealtimeV3DelegationContextAppend,\n  encodeCodexRealtimeV3SessionContextAppend,\n  parseCodexRealtimeV3Event,\n} from \"./codex-realtime-v3\";\nexport type {\n  CodexRealtimeV3Bridge,\n  CodexRealtimeV3BridgeFatal,\n  CodexRealtimeV3BridgeOptions,\n  CodexRealtimeV3BridgeSnapshot,\n  CodexRealtimeV3ContextAppendChannel,\n  CodexRealtimeV3DelegationContextAppend,\n  CodexRealtimeV3Event,\n  CodexRealtimeV3ParseFailure,\n  CodexRealtimeV3ParseResult,\n  CodexRealtimeV3SessionContextAppend,\n} from \"./codex-realtime-v3\";\n\nexport {\n  CODEX_REALTIME_INITIAL_ITEMS_MAX_COUNT,\n  CODEX_REALTIME_INITIAL_ITEMS_MAX_TOKENS,\n} from \"./codex-realtime-v3-wire\";\nexport type { CodexRealtimeInitialItem } from \"./codex-realtime-v3-wire\";\n\nexport type {\n  ActivateCodexRealtimeConnectionRequest,\n  BeginSessionRealtimeRequest,\n  CodexRealtimeVoice,\n  CodexRealtimeWebrtcRequest,\n  CodexRealtimeWebrtcResponse,\n  CodexRealtimeWebrtcVersion,\n  EndSessionRealtimeRequest,\n  GatewayRealtimeConnectRequest,\n  GatewayRealtimeConnectResponse,\n  GatewayRealtimeInitialItem,\n  RenewSessionRealtimeRequest,\n  SessionRealtimeEndReason,\n  SessionRealtimeLedgerEntry,\n  SessionRealtimeMode,\n  SessionRealtimeModel,\n  SessionRealtimeMutationResponse,\n  SessionRealtimeState,\n  SyncSessionRealtimeLedgerRequest,\n  SyncSessionRealtimeLedgerResponse,\n  WorkspaceRealtimeModelCatalogItem,\n  WorkspaceRealtimeModelCatalogResponse,\n} from \"./types\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDO,SAAS,6BACd,OAC8B;AAC9B,MAAI,UAAU,2BAA4B,QAAO;AACjD,MAAI,UAAU,sCAAuC,QAAO;AAC5D,SAAO;AACT;AAOO,SAAS,gCACd,SAC2B;AAC3B,QAAM,YAAY,6BAA6B,QAAQ,KAAK;AAC5D,SAAO,8BAA8B;AAAA,IACnC,GAAG;AAAA,IACH,uBAAuB,qCAAqC,QAAQ,KAAK;AAAA,IACzE,GAAI,cAAc,YACd,EAAE,gBAAgB,sCAAsC,EAAE,IAC1D,cAAc,qBACZ,EAAE,gBAAgB,8CAA8C,EAAE,IAClE,CAAC;AAAA,EACT,CAAC;AACH;","names":[]}

package/dist/retained-artifacts.d.ts

@@ -1,4 +1,8 @@
-import type { GeneratedImageReceipt, GeneratedVideoReceipt, MediaGenerationResult, RetainedArtifactReference } from "./types.js";
+import type { GeneratedImageReceipt, GeneratedVideoReceipt, MediaGenerationResult, RetainedArtifactReference, SandboxFileArtifactReceipt } from "./types.js";
+/** Zero-dependency validation for a permanent generic workspace-file receipt. */
+export declare function parseRetainedWorkspaceFileReference(value: unknown, expectedWorkspaceId?: string): RetainedArtifactReference | null;
+/** Parse the closed result returned by sandbox_file_publish and the session API. */
+export declare function parseSandboxFileArtifactReceipt(value: unknown, expectedWorkspaceId?: string): SandboxFileArtifactReceipt | null;
 /** 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;

package/dist/session-history-import.d.ts

@@ -0,0 +1,22 @@
+import type { OpenGeniClient } from "./client.js";
+import type { AppendArchivedSessionEventsRequest, AppendArchivedSessionEventsResponse, ImportArchivedSessionRequest, ImportArchivedSessionResponse } from "@opengeni/contracts";
+export type { ArchivedSessionImportEvent, AppendArchivedSessionEventsRequest, AppendArchivedSessionEventsResponse, ImportArchivedSessionRequest, ImportArchivedSessionResponse, SessionImportedArchive, } from "@opengeni/contracts";
+type SessionHistoryImportClient = Pick<OpenGeniClient, "requestJson">;
+/**
+ * Server-only migration of a read-only archive, not model-facing conversation
+ * history. Use an asUser client to preserve the verified creator/owner. Persist
+ * importId and retry the exact request after an uncertain outcome.
+ * Requires sessions:create in the authenticated actor's permissions.
+ */
+export declare function importArchivedSession(client: SessionHistoryImportClient, workspaceId: string, request: ImportArchivedSessionRequest): Promise<ImportArchivedSessionResponse>;
+/**
+ * Append historical events at the acknowledged nextOffset. Retrying the exact
+ * batchId, offset and events replays its receipt; conflicting reuse returns 409.
+ * Each request accepts at most 100 events / 1 MiB, with 256 KiB per event.
+ * Requires sessions:control and the same authenticated importer.
+ */
+export declare function appendArchivedSessionEvents(client: SessionHistoryImportClient, workspaceId: string, importId: string, request: AppendArchivedSessionEventsRequest): Promise<AppendArchivedSessionEventsResponse>;
+/** Import through an existing external tenant mapping; this does not onboard it. */
+export declare function importExternalWorkspaceArchivedSession(client: SessionHistoryImportClient, source: string, externalId: string, request: ImportArchivedSessionRequest): Promise<ImportArchivedSessionResponse>;
+/** Append to an archive through the same external tenant mapping and actor. */
+export declare function appendExternalWorkspaceArchivedSessionEvents(client: SessionHistoryImportClient, source: string, externalId: string, importId: string, request: AppendArchivedSessionEventsRequest): Promise<AppendArchivedSessionEventsResponse>;

package/dist/session-history-import.js

@@ -0,0 +1,36 @@
+// src/session-history-import.ts
+function importArchivedSession(client, workspaceId, request) {
+  return client.requestJson(
+    "POST",
+    `/v1/workspaces/${encodeURIComponent(workspaceId)}/session-imports`,
+    request
+  );
+}
+function appendArchivedSessionEvents(client, workspaceId, importId, request) {
+  return client.requestJson(
+    "POST",
+    `/v1/workspaces/${encodeURIComponent(workspaceId)}/session-imports/${encodeURIComponent(importId)}/events`,
+    request
+  );
+}
+function importExternalWorkspaceArchivedSession(client, source, externalId, request) {
+  return client.requestJson(
+    "POST",
+    `/v1/workspaces/external/${encodeURIComponent(source)}/${encodeURIComponent(externalId)}/session-imports`,
+    request
+  );
+}
+function appendExternalWorkspaceArchivedSessionEvents(client, source, externalId, importId, request) {
+  return client.requestJson(
+    "POST",
+    `/v1/workspaces/external/${encodeURIComponent(source)}/${encodeURIComponent(externalId)}/session-imports/${encodeURIComponent(importId)}/events`,
+    request
+  );
+}
+export {
+  appendArchivedSessionEvents,
+  appendExternalWorkspaceArchivedSessionEvents,
+  importArchivedSession,
+  importExternalWorkspaceArchivedSession
+};
+//# sourceMappingURL=session-history-import.js.map

package/dist/session-history-import.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-history-import.ts"],"sourcesContent":["import type { OpenGeniClient } from \"./client\";\nimport type {\n  AppendArchivedSessionEventsRequest,\n  AppendArchivedSessionEventsResponse,\n  ImportArchivedSessionRequest,\n  ImportArchivedSessionResponse,\n} from \"@opengeni/contracts\";\n\nexport type {\n  ArchivedSessionImportEvent,\n  AppendArchivedSessionEventsRequest,\n  AppendArchivedSessionEventsResponse,\n  ImportArchivedSessionRequest,\n  ImportArchivedSessionResponse,\n  SessionImportedArchive,\n} from \"@opengeni/contracts\";\n\ntype SessionHistoryImportClient = Pick<OpenGeniClient, \"requestJson\">;\n\n/**\n * Server-only migration of a read-only archive, not model-facing conversation\n * history. Use an asUser client to preserve the verified creator/owner. Persist\n * importId and retry the exact request after an uncertain outcome.\n * Requires sessions:create in the authenticated actor's permissions.\n */\nexport function importArchivedSession(\n  client: SessionHistoryImportClient,\n  workspaceId: string,\n  request: ImportArchivedSessionRequest,\n): Promise<ImportArchivedSessionResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/session-imports`,\n    request,\n  );\n}\n\n/**\n * Append historical events at the acknowledged nextOffset. Retrying the exact\n * batchId, offset and events replays its receipt; conflicting reuse returns 409.\n * Each request accepts at most 100 events / 1 MiB, with 256 KiB per event.\n * Requires sessions:control and the same authenticated importer.\n */\nexport function appendArchivedSessionEvents(\n  client: SessionHistoryImportClient,\n  workspaceId: string,\n  importId: string,\n  request: AppendArchivedSessionEventsRequest,\n): Promise<AppendArchivedSessionEventsResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/${encodeURIComponent(workspaceId)}/session-imports/${encodeURIComponent(importId)}/events`,\n    request,\n  );\n}\n\n/** Import through an existing external tenant mapping; this does not onboard it. */\nexport function importExternalWorkspaceArchivedSession(\n  client: SessionHistoryImportClient,\n  source: string,\n  externalId: string,\n  request: ImportArchivedSessionRequest,\n): Promise<ImportArchivedSessionResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/external/${encodeURIComponent(source)}/${encodeURIComponent(externalId)}/session-imports`,\n    request,\n  );\n}\n\n/** Append to an archive through the same external tenant mapping and actor. */\nexport function appendExternalWorkspaceArchivedSessionEvents(\n  client: SessionHistoryImportClient,\n  source: string,\n  externalId: string,\n  importId: string,\n  request: AppendArchivedSessionEventsRequest,\n): Promise<AppendArchivedSessionEventsResponse> {\n  return client.requestJson(\n    \"POST\",\n    `/v1/workspaces/external/${encodeURIComponent(source)}/${encodeURIComponent(externalId)}/session-imports/${encodeURIComponent(importId)}/events`,\n    request,\n  );\n}\n"],"mappings":";AAyBO,SAAS,sBACd,QACA,aACA,SACwC;AACxC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC;AAAA,IACjD;AAAA,EACF;AACF;AAQO,SAAS,4BACd,QACA,aACA,UACA,SAC8C;AAC9C,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,kBAAkB,mBAAmB,WAAW,CAAC,oBAAoB,mBAAmB,QAAQ,CAAC;AAAA,IACjG;AAAA,EACF;AACF;AAGO,SAAS,uCACd,QACA,QACA,YACA,SACwC;AACxC,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,2BAA2B,mBAAmB,MAAM,CAAC,IAAI,mBAAmB,UAAU,CAAC;AAAA,IACvF;AAAA,EACF;AACF;AAGO,SAAS,6CACd,QACA,QACA,YACA,UACA,SAC8C;AAC9C,SAAO,OAAO;AAAA,IACZ;AAAA,IACA,2BAA2B,mBAAmB,MAAM,CAAC,IAAI,mBAAmB,UAAU,CAAC,oBAAoB,mBAAmB,QAAQ,CAAC;AAAA,IACvI;AAAA,EACF;AACF;","names":[]}

package/dist/session-list-entries.d.ts

@@ -0,0 +1 @@
+export { sessionListEntry } from "@opengeni/contracts/session-list-entries";

package/dist/session-list-entries.js

@@ -0,0 +1,7 @@
+import {
+  sessionListEntry
+} from "./chunk-GZYZT22T.js";
+export {
+  sessionListEntry
+};
+//# sourceMappingURL=session-list-entries.js.map

package/dist/session-list-entries.js.map

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