@opengeni/config 0.11.0 → 0.13.2

package/dist/index.d.ts

@@ -1,5 +1,10 @@
-import { Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1 } from "@opengeni/contracts";
+import { Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution } from "@opengeni/contracts";
 import { z } from "zod";
+export declare const SANDBOX_ARCHIVE_CAPTURE_MAX_TIMEOUT_MS: number;
+export declare const SANDBOX_ARCHIVE_CAPTURE_SETTLEMENT_GRACE_MS = 10000;
+export declare const SANDBOX_SNAPSHOT_MAX_TIMEOUT_MS: number;
+export declare const SANDBOX_LIFECYCLE_TRANSITION_MAX_WAIT_MS: number;
+export declare const SANDBOX_LIFECYCLE_RETRY_HANDOFF_GRACE_MS = 10000;
 export declare const sandboxPreparationProfiles: Record<string, {
     env: string[];
     hooks: string[];
@@ -84,6 +89,9 @@ declare const SettingsSchema: z.ZodObject<{
     turnWorkerMaxConcurrentTurns: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     turnWorkerTargetCpuUsage: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     turnWorkerTargetMemoryUsage: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    turnWorkerEmergencyMemoryUsage: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    turnWorkerMemoryGuardIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    turnWorkerMemoryGuardSustainMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
@@ -98,6 +106,7 @@ declare const SettingsSchema: z.ZodObject<{
     webBaseUrl: z.ZodOptional<z.ZodString>;
     agentReleasesBaseUrl: z.ZodDefault<z.ZodString>;
     agentStableVersion: z.ZodDefault<z.ZodString>;
+    agentBetaVersion: z.ZodOptional<z.ZodString>;
     productAccessMode: z.ZodDefault<z.ZodEnum<{
         configured: "configured";
         local: "local";
@@ -122,19 +131,22 @@ declare const SettingsSchema: z.ZodObject<{
     delegationSecret: z.ZodOptional<z.ZodString>;
     streamTokenSecret: z.ZodOptional<z.ZodString>;
     streamControlEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
-    toolspaceEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
-    toolspaceMaxCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    codemodeMaxCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     ogtoolPackageSpec: z.ZodOptional<z.ZodString>;
     environmentsEncryptionKey: z.ZodOptional<z.ZodString>;
     integrationsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     integrationsStateSecret: z.ZodOptional<z.ZodString>;
     integrationsAllowPrivateNetworkTargets: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     integrationsOauthClientsJson: z.ZodDefault<z.ZodString>;
+    gmailRestAdapterEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     slackClientId: z.ZodOptional<z.ZodString>;
     slackClientSecret: z.ZodOptional<z.ZodString>;
     slackSigningSecret: z.ZodOptional<z.ZodString>;
     googleDriveClientId: z.ZodOptional<z.ZodString>;
     googleDriveClientSecret: z.ZodOptional<z.ZodString>;
+    googleDriveWorkspaceEventsEnabled: z.ZodOptional<z.ZodPreprocess<z.ZodBoolean>>;
+    atlassianClientId: z.ZodOptional<z.ZodString>;
+    atlassianClientSecret: z.ZodOptional<z.ZodString>;
     maxNestedAgentDepth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     socialOauthClientsJson: z.ZodDefault<z.ZodString>;
     goalMaxAutoContinuations: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -164,6 +176,16 @@ declare const SettingsSchema: z.ZodObject<{
     openaiModel: z.ZodDefault<z.ZodString>;
     openaiAllowedModels: z.ZodDefault<z.ZodString>;
     vercelAiGatewayApiKey: z.ZodOptional<z.ZodString>;
+    imageGenerationModel: z.ZodDefault<z.ZodString>;
+    videoGenerationPollIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    videoGenerationRecoveryDeadlineMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    videoGenerationReferenceUrlTtlSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    videoGenerationMaxConcurrentPerWorkspace: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    videoGenerationWorkspaceQuotaBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    videoGenerationTempDirectory: z.ZodDefault<z.ZodString>;
+    videoGenerationFfprobePath: z.ZodDefault<z.ZodString>;
+    videoGenerationCredit480pMicrosPerSecond: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    videoGenerationCredit720pMicrosPerSecond: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     voiceInputMaxDurationSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     voiceInputMaxSizeBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     voiceInputResumableEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
@@ -190,6 +212,7 @@ declare const SettingsSchema: z.ZodObject<{
     codexConnectedAppsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     codexProductSku: z.ZodOptional<z.ZodString>;
     codexToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    lazyToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     codexCredentialLeasingEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     codexFleetPolicyShadowEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     codexRotationNearExhaustionPct: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -236,6 +259,7 @@ declare const SettingsSchema: z.ZodObject<{
         vercel: "vercel";
     }>>;
     dockerImage: z.ZodDefault<z.ZodString>;
+    sandboxArtifactRuntimeEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     dockerExposedPorts: z.ZodDefault<z.ZodString>;
     dockerNetwork: z.ZodOptional<z.ZodString>;
     dockerWorkspaceBaseDir: z.ZodOptional<z.ZodString>;
@@ -329,6 +353,7 @@ declare const SettingsSchema: z.ZodObject<{
     sandboxSelfhostedControlTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     sandboxLeaseReaperPeriodMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     sandboxViewerHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    sandboxInteractionHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     sandboxIdleGraceMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     sandboxSnapshotIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     sandboxSnapshotTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -507,6 +532,12 @@ export type ModelUsageInput = {
     inputTokensDetails?: Record<string, number> | Array<Record<string, number>> | undefined;
     requestUsageEntries?: ModelUsageInput[] | undefined;
 };
+export type ModelUsageCostBreakdown = {
+    /** Provider-rate cost basis for the exact usage, before OpenGeni margin. */
+    providerCostMicros: number;
+    /** OpenGeni credit price after configured margin and latency-mode multiplier. */
+    creditCostMicros: number;
+};
 export type StaticUsageLimitsConfig = StaticUsageLimits;
 export type EntitlementsConfig = Entitlements;
 export declare const CapabilitySupportV1: z.ZodEnum<{
@@ -593,6 +624,14 @@ export declare const ModelCapabilitiesV1Schema: z.ZodObject<{
             }>;
             runnable: z.ZodBoolean;
         }, z.core.$strip>;
+        imageGeneration: z.ZodDefault<z.ZodObject<{
+            upstream: z.ZodEnum<{
+                supported: "supported";
+                unknown: "unknown";
+                unsupported: "unsupported";
+            }>;
+            runnable: z.ZodBoolean;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     inputModalities: z.ZodArray<z.ZodEnum<{
         audio: "audio";
@@ -812,6 +851,14 @@ declare const RegistryProviderSchema: z.ZodObject<{
                     }>;
                     runnable: z.ZodBoolean;
                 }, z.core.$strip>;
+                imageGeneration: z.ZodDefault<z.ZodObject<{
+                    upstream: z.ZodEnum<{
+                        supported: "supported";
+                        unknown: "unknown";
+                        unsupported: "unsupported";
+                    }>;
+                    runnable: z.ZodBoolean;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
             inputModalities: z.ZodArray<z.ZodEnum<{
                 audio: "audio";
@@ -1080,6 +1127,7 @@ export declare function effectiveModalIdleTimeoutSeconds(settings: Settings): nu
  * consumers at one hour.
  */
 export declare function sandboxArchiveCaptureTimeoutMs(settings: Pick<Settings, "sandboxSnapshotTimeoutMs">): number;
+export declare function sandboxLifecycleTransitionWaitMs(settings: Pick<Settings, "sandboxSnapshotTimeoutMs" | "sandboxLeaseReaperPeriodMs">): number;
 export declare function collectSandboxEnvironment(settings: Settings, source?: NodeJS.ProcessEnv): Record<string, string>;
 /**
  * Resolved API key for a registry provider: the inline `apiKey` when present,
@@ -1105,6 +1153,8 @@ export declare function productLabelForModelId(modelId: string): string;
  * everything else returns null so callers fall back to the full `label`.
  */
 export declare function productShortLabelForModelId(modelId: string): string | null;
+/** Undefined and the exact public OpenAI v1 endpoint are the same direct route. */
+export declare function isDirectOpenAiApiBaseUrl(baseUrl: string | undefined): boolean;
 /**
  * Map OpenGeni latency mode to the provider `service_tier` wire value.
  * Azure and Codex ChatGPT accept `priority`; OpenAI API accepts `fast` (alias of priority).
@@ -1240,6 +1290,9 @@ export declare function configuredEntitlements(settings: Settings): Entitlements
 export declare function calculateModelUsageCostMicros(settings: Settings, model: string, usage: ModelUsageInput, options?: {
     latencyMode?: LatencyMode;
 }): number;
+export declare function calculateModelUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
+    latencyMode?: LatencyMode;
+}): ModelUsageCostBreakdown;
 /**
  * Convert AI Gateway's exact USD inference cost to OpenGeni credit micros and
  * apply the configured model margin. Decimal arithmetic is integer-only so a
@@ -1248,6 +1301,19 @@ export declare function calculateModelUsageCostMicros(settings: Settings, model:
 export declare function calculateGatewayReportedCostMicros(settings: Settings, model: string, inferenceCostUsd: string, options?: {
     inputTokens?: number;
 }): number;
+export declare function calculateGatewayReportedCostBreakdown(settings: Settings, model: string, inferenceCostUsd: string, options?: {
+    inputTokens?: number;
+}): ModelUsageCostBreakdown;
+/**
+ * Exact OpenGeni product price frozen before a managed video request starts.
+ * Gateway reporting is delayed for asynchronous video, so this deliberately
+ * does not masquerade as provider-reported cost.
+ */
+export declare function calculateVideoGenerationCreditCostMicros(settings: Settings, input: {
+    modelId: string;
+    resolution: VideoGenerationResolution;
+    durationSeconds: number;
+}): number;
 export declare function configuredAllowedReasoningEfforts(settings: Settings): Array<z.infer<typeof ReasoningEffort>>;
 /**
  * Decodes OPENGENI_ENVIRONMENTS_ENCRYPTION_KEY (base64, exactly 32 bytes) for
@@ -1411,6 +1477,7 @@ export declare function parseStaticEntitlementsJson(raw: string): EntitlementsCo
  */
 export declare function firstPartyMcpBaseUrl(settings: Settings): string;
 export declare function firstPartyMcpWorkspaceUrl(settings: Settings, workspaceId: string): string;
+export declare function codemodeWorkspaceUrl(settings: Settings, workspaceId: string): string;
 /**
  * Resolve the secret used to sign/verify scoped stream tokens (sandbox contract
  * §C.3). Falls back to `delegationSecret` (the same HMAC envelope family —