@opengeni/sdk 3.3.2 → 3.5.1-canary.0

package/dist/stream.d.ts

@@ -61,3 +61,5 @@ export declare function streamSessionEvents(transport: SessionEventStreamTranspo
 export declare function runBeforeLive(beforeLive: (() => void | Promise<void>) | undefined, timeoutMs: number, signal: AbortSignal | undefined): Promise<void>;
 export declare function jitteredDelay(delayMs: number, ratio: number): number;
 export declare function withStreamInactivityTimeout(stream: ReadableStream<Uint8Array>, timeoutMs: number, signal: AbortSignal | undefined): ReadableStream<Uint8Array>;
+/** Trusted SSE coverage attached non-enumerably to a streamed event. */
+export declare function sessionEventStreamCoveredThrough(event: SessionEvent): number | null;

package/dist/types.d.ts

@@ -442,6 +442,7 @@ export type McpConnectionAuthoritySelection = {
 };
 export type McpServerConnectionRef = {
     connectionId?: string | undefined;
+    authoritySource?: "host" | undefined;
     provider?: string | undefined;
     providerDomain: string;
     kind?: ConnectionKind | undefined;
@@ -494,6 +495,7 @@ export type CreateConnectionRequest = {
     grantedScopes?: string[] | undefined;
     expiresAt?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
+    operationId?: string | undefined;
 };
 export type PersonalGitHubConnectionMetadata = {
     credentialRole: "opengeni_github_personal";
@@ -841,6 +843,8 @@ export type UpdateConnectionRequest = {
     grantedScopes?: string[] | undefined;
     expiresAt?: string | null | undefined;
     metadata?: Record<string, unknown> | undefined;
+    expectedVersion?: number | undefined;
+    operationId?: string | undefined;
 };
 export type ConnectionResponse = {
     connection: ConnectionMetadata;
@@ -1371,6 +1375,8 @@ export type SessionEvent = {
     sessionId: string;
     /** Per-session sequence number: positive, contiguous, strictly increasing. */
     sequence: number;
+    /** Server-owned durable high-water mark for a synthetic compact event. */
+    coveredThrough?: number | undefined;
     type: SessionEventType;
     payload: unknown;
     occurredAt: string;
@@ -1486,7 +1492,9 @@ export type ToolAuthNeededPayload = {
     providerDomain: string;
     provider?: string | undefined;
     connectionId?: string | null | undefined;
+    authoritySource?: "host" | undefined;
     reason: "missing_connection" | "expired" | "insufficient_scope" | "refresh_failed" | "personal_authority_unavailable" | "unsupported_auth" | "resource_scope_unavailable";
+    hostReason?: "missing_connection" | "expired" | "insufficient_scope" | "refresh_failed" | "personal_authority_unavailable" | "unsupported_auth" | "resource_scope_unavailable" | undefined;
     scopes?: string[] | undefined;
     resource?: string | undefined;
     selectedResources?: Array<{
@@ -2205,6 +2213,8 @@ export type CreateSessionRequest = {
     resources?: ResourceRef[] | undefined;
     /** Inline skills fixed onto this session; omitted children inherit them. */
     skills?: SessionSkill[] | undefined;
+    /** Installed session-selected Skill identities to freeze onto this session at creation. */
+    installedSkillIds?: string[] | undefined;
     tools?: ToolRef[] | undefined;
     metadata?: Record<string, unknown> | undefined;
     model?: string | undefined;
@@ -2287,14 +2297,19 @@ export type ModelCredentialSourceV1 = {
 } | {
     kind: "workspace_connection";
     mechanism: "api_key";
+} | {
+    kind: "organization_connection";
+    mechanism: "api_key";
 };
 export type ModelBillingAttributionV1 = {
-    upstreamPayer: "deployment" | "workspace" | "connected_subscription";
+    upstreamPayer: "deployment" | "workspace" | "organization" | "connected_subscription";
     metering: "opengeni_credits" | "external";
 };
+export type ModelCostClassV1 = "free" | "credits" | "subscription" | "workspace" | "organization";
 export type ModelPricingV1 = {
     inputMicrosPerMillionTokens: number;
     cachedInputMicrosPerMillionTokens?: number | undefined;
+    cacheWriteMicrosPerMillionTokens?: number | undefined;
     outputMicrosPerMillionTokens: number;
     marginBps?: number | undefined;
 };
@@ -2320,7 +2335,7 @@ export type ClientModel = {
     provider: string;
     providerLabel: string;
     api: "responses" | "chat";
-    source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | undefined;
+    source?: "opengeni" | "codex" | "supergrok" | "workspace_gateway" | "openrouter" | undefined;
     contextWindowTokens?: number | undefined;
     schemaVersion?: 1 | undefined;
     aliases?: string[] | undefined;
@@ -2336,6 +2351,7 @@ export type ClientModel = {
     } | undefined;
     credentialSource?: ModelCredentialSourceV1 | undefined;
     billing?: ModelBillingAttributionV1 | undefined;
+    cost?: ModelCostClassV1 | undefined;
     capabilities?: ModelCapabilitiesV1 | undefined;
     pricing?: ModelPricingScheduleV1 | undefined;
     definitionVersion?: string | undefined;
@@ -2361,6 +2377,55 @@ export type WorkspaceModelCatalogModel = ClientModel & {
 export type WorkspaceModelCatalogResponse = {
     models: WorkspaceModelCatalogModel[];
 };
+export type WorkspaceGatewayCustomModel = {
+    id: string;
+    upstreamModelId: string;
+    label: string | null;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+};
+export type WorkspaceGatewayCustomModelsResponse = {
+    models: WorkspaceGatewayCustomModel[];
+};
+export type CreateWorkspaceGatewayCustomModelRequest = {
+    operationId: string;
+    upstreamModelId: string;
+    label?: string | undefined;
+};
+export type DeleteWorkspaceGatewayCustomModelRequest = {
+    expectedVersion: number;
+    operationId: string;
+};
+export type WorkspaceOpenRouterCustomModel = WorkspaceGatewayCustomModel;
+export type WorkspaceOpenRouterCustomModelsResponse = {
+    models: WorkspaceOpenRouterCustomModel[];
+};
+export type CreateWorkspaceOpenRouterCustomModelRequest = CreateWorkspaceGatewayCustomModelRequest;
+export type DeleteWorkspaceOpenRouterCustomModelRequest = DeleteWorkspaceGatewayCustomModelRequest;
+export type OrganizationModelProviderKind = "vercel_gateway" | "openrouter";
+export type OrganizationModelProviderConnection = {
+    providerKind: OrganizationModelProviderKind;
+    status: "active" | "revoked";
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+};
+export type UpsertOrganizationModelProviderConnectionRequest = {
+    operationId: string;
+    expectedVersion?: number | undefined;
+    apiKey: string;
+};
+export type RevokeOrganizationModelProviderConnectionRequest = {
+    operationId: string;
+    expectedVersion: number;
+};
+export type OrganizationProviderCustomModel = WorkspaceGatewayCustomModel;
+export type OrganizationProviderCustomModelsResponse = {
+    models: OrganizationProviderCustomModel[];
+};
+export type CreateOrganizationProviderCustomModelRequest = CreateWorkspaceGatewayCustomModelRequest;
+export type DeleteOrganizationProviderCustomModelRequest = DeleteWorkspaceGatewayCustomModelRequest;
 /**
  * The workspace's hard model/provider allowlist. `null` means unrestricted for
  * that dimension; an empty array is an explicit total block.
@@ -3086,6 +3151,16 @@ export type CreateOrganizationResponse = {
     organization: OrganizationSummary;
     workspaceId: string;
 };
+export type CreateAdditionalOrganizationRequest = {
+    name: string;
+    workspaceName: string;
+    operationId: string;
+};
+export type CreateAdditionalOrganizationResponse = {
+    organization: OrganizationSummary;
+    workspaceId: string;
+    personalWorkspaceId: string;
+};
 export type UpdateOrganizationNameRequest = {
     name: string;
     expectedUpdatedAt: string;
@@ -4744,9 +4819,11 @@ export type CapabilityPackSkillFile = {
 export type CapabilityPackSkill = {
     name: string;
     description?: string | undefined;
+    /** Omitted means workspace-wide; session_selected requires explicit session attachment. */
+    activationMode?: "workspace_managed" | "session_selected" | undefined;
     files: CapabilityPackSkillFile[];
 };
-export type SessionSkill = CapabilityPackSkill;
+export type SessionSkill = Omit<CapabilityPackSkill, "activationMode">;
 export type CapabilityPackVariableSetSpec = {
     description: string;
     requiredVariables: string[];
@@ -4830,6 +4907,7 @@ export type RegisterCapabilityPackRequest = {
     skills?: {
         name: string;
         description?: string | undefined;
+        activationMode?: "workspace_managed" | "session_selected" | undefined;
         files: CapabilityPackSkillFile[];
     }[] | undefined;
     components?: ({
@@ -5194,6 +5272,7 @@ export type CapabilityCatalogItem = {
     /** The connection backing this enabled installation, or null when none is involved. */
     connectionRef: {
         connectionId?: string | undefined;
+        authoritySource?: "host" | undefined;
         providerDomain: string;
         kind: string;
         subjectScope?: "subject" | "workspace" | undefined;
@@ -5776,6 +5855,32 @@ export type GitHubAppInfo = {
 export type GitHubRepositoriesResponse = {
     repositories: GitHubRepository[];
 };
+export type VerifyPublicGitHubRepositoryRefRequest = {
+    url: string;
+    ref: string;
+};
+export type VerifyPublicGitHubRepositoryRefResponse = {
+    owner: string;
+    name: string;
+    fullName: string;
+    canonicalUrl: string;
+    cloneUrl: string;
+    defaultBranch: string;
+    ref: string;
+    commitSha: string;
+};
+export type GitHubRepositoryBranch = {
+    name: string;
+    isDefault: boolean;
+};
+export type ListGitHubRepositoryBranchesOptions = {
+    cursor?: number | undefined;
+    limit?: number | undefined;
+};
+export type GitHubRepositoryBranchesResponse = {
+    branches: GitHubRepositoryBranch[];
+    nextCursor: number | null;
+};
 export type CreateGitHubAppManifestRequest = {
     appName?: string | undefined;
     organization?: string | undefined;
@@ -5846,12 +5951,16 @@ export type InsightsModelUsageRow = {
     creditUsd: number;
     estimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
 };
 export type InsightsSeriesPoint = {
     label: string;
     modelCostUsd: number;
     estimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
     warmSeconds: number;
     inputTokens: number;
     outputTokens: number;
@@ -5880,6 +5989,8 @@ export type InsightsSpendDriver = {
     creditUsd: number;
     estimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
     tokens: number;
     cacheHitPct: number;
     pctOfCreditUsd: number;
@@ -5921,6 +6032,8 @@ export type InsightsScheduleRow = {
     creditUsd: number | null;
     estimatedProviderUsd: number | null;
     estimatedProviderCostKnownCalls: number | null;
+    equivalentCreditUsd: number | null;
+    equivalentCreditCostKnownCalls: number | null;
     tokens: number | null;
     cacheHitPct: number | null;
     billing: InsightsBillingPath | null;
@@ -5944,6 +6057,7 @@ export type InsightsModelCallRow = {
     totalTokens: number | null;
     creditUsd: number;
     estimatedProviderUsd: number | null;
+    equivalentCreditUsd: number | null;
     pricingSource: InsightsPricingSource | null;
 };
 export type ModelContextContributionSource = "workspace_instruction_policy" | "legacy_workspace_instructions" | "preference_registry_descriptor" | "company_profile" | "legacy_memory_v1" | "runtime_skill_catalog";
@@ -5994,6 +6108,10 @@ export type WorkspaceInsightsSnapshot = {
     priorEstimatedProviderUsd: number;
     estimatedProviderCostKnownCalls: number;
     priorEstimatedProviderCostKnownCalls: number;
+    equivalentCreditUsd: number;
+    priorEquivalentCreditUsd: number;
+    equivalentCreditCostKnownCalls: number;
+    priorEquivalentCreditCostKnownCalls: number;
     modelCalls: number;
     priorInputTokens: number;
     priorTotalTokens: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "3.3.2",
+  "version": "3.5.1-canary.0",
   "description": "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   "license": "Apache-2.0",
   "repository": {
@@ -34,6 +34,10 @@
       "types": "./dist/browser.d.ts",
       "import": "./dist/browser.js"
     },
+    "./github-repositories": {
+      "types": "./dist/github-repositories.d.ts",
+      "import": "./dist/github-repositories.js"
+    },
     "./document-authority": {
       "types": "./dist/document-authority.d.ts",
       "import": "./dist/document-authority.js"
@@ -89,6 +93,10 @@
     "./gateway-realtime-transport": {
       "types": "./dist/gateway-realtime-transport.d.ts",
       "import": "./dist/gateway-realtime-transport.js"
+    },
+    "./model-picker-order": {
+      "types": "./dist/model-picker-order.d.ts",
+      "import": "./dist/model-picker-order.js"
     }
   },
   "publishConfig": {
@@ -101,7 +109,7 @@
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
   "dependencies": {
-    "@opengeni/contracts": "^2.9.2"
+    "@opengeni/contracts": "^2.11.1-canary.0"
   },
   "engines": {
     "node": ">=18"

package/src/artifact-client.ts

@@ -1,4 +1,5 @@
 import { OpenGeniDocumentAuthorityClient } from "./document-authority-client";
+import type { FetchResponse } from "./client";
 import type {
   CreateEditableArtifactMaterializationRequest,
   CreateEditableArtifactResourceRequest,
@@ -132,7 +133,7 @@ export class OpenGeniClient extends OpenGeniDocumentAuthorityClient {
     artifactId: string,
     jobId: string,
     options: ReadEditableArtifactMaterializationOptions,
-  ): Promise<Response> {
+  ): Promise<FetchResponse> {
     return await this.requestResponse(
       "GET",
       `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/${encodeURIComponent(artifactId)}/materializations/${encodeURIComponent(jobId)}/download`,

package/src/artifacts.ts

@@ -16,6 +16,7 @@ export type {
 } from "./editable-artifact-resources";
 export type {
   FetchLike,
+  FetchResponse,
   GetSessionOptions,
   OpenGeniClientOptions,
   OpenGeniRequestOptions,

package/src/browser.ts

@@ -2,6 +2,7 @@
 export { OpenGeniClient as OpenGeniBrowserClient } from "./client";
 export type {
   FetchLike,
+  FetchResponse,
   GetSessionOptions,
   OpenGeniClientOptions,
   OpenGeniRequestOptions,
@@ -13,9 +14,11 @@ export type {
 export {
   OpenGeniApiContractMismatchError,
   OpenGeniApiError,
+  OpenGeniSecureContextRequiredError,
   OpenGeniSessionListCursorError,
   OpenGeniStreamError,
   isRetryableStreamError,
 } from "./errors";
+export type { OpenGeniSecureContextRequiredReason } from "./errors";
 export { resolveWorkspaceVoiceInputEnabled } from "./transcription";
 export { OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION } from "./types";