@opengeni/config 1.2.2 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,10 +1,16 @@
1
- import { Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType } from "@opengeni/contracts";
1
+ export { managedUserEmailAllowed } from "./managed-user-admission.js";
2
+ export * from "./realtime-voice-pricing.js";
3
+ export * from "./web-search.js";
4
+ export { CreditPromotionPolicy, signupCreditModelIds, promotionalCreditScope, } from "./credit-promotions.js";
5
+ import { type AgentConfigDeploymentLimits, Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType } from "@opengeni/contracts";
6
+ import type { CodeSearchDeploymentPolicy } from "@opengeni/contracts/code-search";
2
7
  export { XAI_SUBSCRIPTION_MODEL_ID_PREFIX } from "@opengeni/xai-subscription";
3
8
  import { z } from "zod";
4
9
  export declare const DEFAULT_OPENROUTER_MODEL_ID: "openrouter/nvidia/nemotron-3-super-120b-a12b:free";
5
10
  export declare const DEFAULT_MODEL_COST_POLICY_JSON: string;
6
11
  export declare const SANDBOX_ARCHIVE_CAPTURE_MAX_TIMEOUT_MS: number;
7
12
  export declare const SANDBOX_ARCHIVE_CAPTURE_SETTLEMENT_GRACE_MS = 10000;
13
+ export declare const SANDBOX_DEADLINE_COMMAND_STOP_GRACE_MS = 120000;
8
14
  export declare const SANDBOX_SNAPSHOT_MAX_TIMEOUT_MS: number;
9
15
  export declare const GOOGLE_DRIVE_PROVIDER_REQUEST_TIMEOUT_MAX_MS = 60000;
10
16
  export declare const GOOGLE_DRIVE_PROVIDER_RETRY_DELAY_MAX_MS = 60000;
@@ -28,8 +34,9 @@ export declare const sandboxPreparationProfiles: Record<string, {
28
34
  export declare const AGENT_INSTRUCTIONS_CORE_PLACEHOLDER = "{{core}}";
29
35
  /**
30
36
  * Default per-workspace agent persona template. This is the BRAND + tool-usage
31
- * opinion (the white-labellable surface): the "You are an OpenGeni workspace
32
- * agent." identity line, the framing/opinion lines, and the mount-path facts.
37
+ * opinion (the white-labellable surface): the general-assistant identity line,
38
+ * the framing/opinion lines, and the mount-path facts. Domain-specific tooling
39
+ * guidance (for example Terraform or Checkov) belongs in opt-in Skills.
33
40
  *
34
41
  * The CORE that MUST survive any override — the goal-loop ownership line (which
35
42
  * names the opengeni__goal_* tools) and the dynamic workspace-environment block
@@ -45,6 +52,7 @@ export declare const AGENT_INSTRUCTIONS_CORE_PLACEHOLDER = "{{core}}";
45
52
  export declare const DEFAULT_AGENT_INSTRUCTIONS: string;
46
53
  export declare const McpServerConnectionRefSchema: z.ZodObject<{
47
54
  connectionId: z.ZodOptional<z.ZodString>;
55
+ accountSelection: z.ZodOptional<z.ZodLiteral<"all_eligible">>;
48
56
  authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
49
57
  hostBinding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
50
58
  bindingId: z.ZodString;
@@ -77,13 +85,14 @@ export declare const McpOperationRecoverySchema: z.ZodRecord<z.ZodString, z.ZodO
77
85
  observerTool: z.ZodString;
78
86
  }, z.core.$strict>>;
79
87
  /** Public, digest-pinned desktop image used by Modal unless the operator overrides it. */
80
- export declare const DEFAULT_MODAL_IMAGE_REF = "opengenipublicneuacr.azurecr.io/opengeni-desktop@sha256:c3bd17b8841de1bff9bb2777aad422cf8c75de78e2c30f9ac81d0cd6810a1b78";
88
+ export declare const DEFAULT_MODAL_IMAGE_REF = "opengenipublicneuacr.azurecr.io/opengeni-desktop@sha256:554d5b324a580071dd669e7c1190931e498eb1b397412a27c7de84a430ef393a";
81
89
  declare const SettingsSchema: z.ZodObject<{
82
90
  serviceName: z.ZodDefault<z.ZodString>;
83
91
  environment: z.ZodDefault<z.ZodString>;
84
92
  deploymentRevision: z.ZodDefault<z.ZodString>;
85
93
  serverVersion: z.ZodOptional<z.ZodString>;
86
94
  databaseUrl: z.ZodDefault<z.ZodString>;
95
+ apiDatabasePoolMax: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
87
96
  dbSchema: z.ZodDefault<z.ZodString>;
88
97
  rlsStrategy: z.ZodDefault<z.ZodEnum<{
89
98
  force: "force";
@@ -117,15 +126,22 @@ declare const SettingsSchema: z.ZodObject<{
117
126
  observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
118
127
  observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
119
128
  observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
129
+ observabilityDiagnosticsEndpoint: z.ZodOptional<z.ZodString>;
130
+ observabilityDiagnosticsHeaders: z.ZodDefault<z.ZodString>;
120
131
  analyticsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
121
132
  analyticsConsentRequired: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
122
133
  analyticsReoClientId: z.ZodOptional<z.ZodString>;
123
134
  analyticsPosthogProjectKey: z.ZodOptional<z.ZodString>;
124
135
  analyticsPosthogHost: z.ZodOptional<z.ZodString>;
125
136
  analyticsGa4MeasurementId: z.ZodOptional<z.ZodString>;
137
+ legalPrivacyPolicyUrl: z.ZodOptional<z.ZodString>;
138
+ legalTermsOfServiceUrl: z.ZodOptional<z.ZodString>;
139
+ supportEmail: z.ZodOptional<z.ZodString>;
126
140
  publicBaseUrl: z.ZodOptional<z.ZodString>;
141
+ documentationUrl: z.ZodPreprocess<z.ZodDefault<z.ZodNullable<z.ZodURL>>>;
127
142
  mcpOauthEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
128
- mcpOauthTrustedProxyHops: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
143
+ apiTrustedProxyHops: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
144
+ apiTrustedProxyCidrs: z.ZodDefault<z.ZodString>;
129
145
  webBaseUrl: z.ZodOptional<z.ZodString>;
130
146
  agentReleasesBaseUrl: z.ZodDefault<z.ZodString>;
131
147
  agentStableVersion: z.ZodDefault<z.ZodString>;
@@ -135,11 +151,19 @@ declare const SettingsSchema: z.ZodObject<{
135
151
  local: "local";
136
152
  managed: "managed";
137
153
  }>>;
138
- organizationTenancyCanonicalActivationEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
139
154
  billingMode: z.ZodDefault<z.ZodEnum<{
140
155
  disabled: "disabled";
141
156
  stripe: "stripe";
142
157
  }>>;
158
+ verifiedSignupTrialCreditsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
159
+ creditPromotionPolicy: z.ZodPreprocess<z.ZodDefault<z.ZodObject<{
160
+ defaultModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
161
+ signupModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
162
+ offers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
163
+ label: z.ZodString;
164
+ eligibleModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
165
+ }, z.core.$strict>>>;
166
+ }, z.core.$strict>>>;
143
167
  entitlementsMode: z.ZodDefault<z.ZodEnum<{
144
168
  managed: "managed";
145
169
  none: "none";
@@ -150,6 +174,7 @@ declare const SettingsSchema: z.ZodObject<{
150
174
  none: "none";
151
175
  static: "static";
152
176
  }>>;
177
+ usageAllowancesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
153
178
  staticEntitlementsJson: z.ZodDefault<z.ZodString>;
154
179
  staticUsageLimitsJson: z.ZodDefault<z.ZodString>;
155
180
  delegationSecret: z.ZodOptional<z.ZodString>;
@@ -169,11 +194,15 @@ declare const SettingsSchema: z.ZodObject<{
169
194
  browser_auth: "browser_auth";
170
195
  browser_clipboard: "browser_clipboard";
171
196
  browser_debug: "browser_debug";
197
+ browser_download_save: "browser_download_save";
198
+ browser_downloads: "browser_downloads";
172
199
  browser_identity: "browser_identity";
173
200
  browser_lifecycle: "browser_lifecycle";
174
201
  browser_observe: "browser_observe";
175
202
  browser_open: "browser_open";
176
203
  browser_publish: "browser_publish";
204
+ browser_read: "browser_read";
205
+ browser_screenshot: "browser_screenshot";
177
206
  browser_tabs: "browser_tabs";
178
207
  capability_authorization_request: "capability_authorization_request";
179
208
  capability_catalog_search: "capability_catalog_search";
@@ -187,7 +216,9 @@ declare const SettingsSchema: z.ZodObject<{
187
216
  computer_observe: "computer_observe";
188
217
  computer_open: "computer_open";
189
218
  computer_targets: "computer_targets";
219
+ connected_machine_enroll_token: "connected_machine_enroll_token";
190
220
  connected_machine_remove: "connected_machine_remove";
221
+ custom_mcp_setup_request: "custom_mcp_setup_request";
191
222
  editable_artifact_apply: "editable_artifact_apply";
192
223
  editable_artifact_create: "editable_artifact_create";
193
224
  editable_artifact_export: "editable_artifact_export";
@@ -225,6 +256,7 @@ declare const SettingsSchema: z.ZodObject<{
225
256
  knowledge_browse: "knowledge_browse";
226
257
  knowledge_correct: "knowledge_correct";
227
258
  knowledge_get: "knowledge_get";
259
+ knowledge_prepare_save: "knowledge_prepare_save";
228
260
  knowledge_propose: "knowledge_propose";
229
261
  knowledge_retain_file: "knowledge_retain_file";
230
262
  knowledge_retain_message: "knowledge_retain_message";
@@ -277,6 +309,7 @@ declare const SettingsSchema: z.ZodObject<{
277
309
  session_pause: "session_pause";
278
310
  session_resume: "session_resume";
279
311
  session_send_message: "session_send_message";
312
+ session_set_model: "session_set_model";
280
313
  session_set_project: "session_set_project";
281
314
  session_steer: "session_steer";
282
315
  session_wait: "session_wait";
@@ -291,8 +324,11 @@ declare const SettingsSchema: z.ZodObject<{
291
324
  slack_bot_list_files: "slack_bot_list_files";
292
325
  slack_bot_list_users: "slack_bot_list_users";
293
326
  slack_bot_post_message: "slack_bot_post_message";
327
+ slack_bot_prepare_message: "slack_bot_prepare_message";
294
328
  slack_bot_search: "slack_bot_search";
329
+ slack_bot_send_prepared_message: "slack_bot_send_prepared_message";
295
330
  slack_bot_thread_replies: "slack_bot_thread_replies";
331
+ slack_bot_upload_file: "slack_bot_upload_file";
296
332
  social_connections_list: "social_connections_list";
297
333
  social_daily_analysis_context: "social_daily_analysis_context";
298
334
  social_mentions_live: "social_mentions_live";
@@ -337,11 +373,15 @@ declare const SettingsSchema: z.ZodObject<{
337
373
  browser_auth: "browser_auth";
338
374
  browser_clipboard: "browser_clipboard";
339
375
  browser_debug: "browser_debug";
376
+ browser_download_save: "browser_download_save";
377
+ browser_downloads: "browser_downloads";
340
378
  browser_identity: "browser_identity";
341
379
  browser_lifecycle: "browser_lifecycle";
342
380
  browser_observe: "browser_observe";
343
381
  browser_open: "browser_open";
344
382
  browser_publish: "browser_publish";
383
+ browser_read: "browser_read";
384
+ browser_screenshot: "browser_screenshot";
345
385
  browser_tabs: "browser_tabs";
346
386
  capability_authorization_request: "capability_authorization_request";
347
387
  capability_catalog_search: "capability_catalog_search";
@@ -355,7 +395,9 @@ declare const SettingsSchema: z.ZodObject<{
355
395
  computer_observe: "computer_observe";
356
396
  computer_open: "computer_open";
357
397
  computer_targets: "computer_targets";
398
+ connected_machine_enroll_token: "connected_machine_enroll_token";
358
399
  connected_machine_remove: "connected_machine_remove";
400
+ custom_mcp_setup_request: "custom_mcp_setup_request";
359
401
  editable_artifact_apply: "editable_artifact_apply";
360
402
  editable_artifact_create: "editable_artifact_create";
361
403
  editable_artifact_export: "editable_artifact_export";
@@ -393,6 +435,7 @@ declare const SettingsSchema: z.ZodObject<{
393
435
  knowledge_browse: "knowledge_browse";
394
436
  knowledge_correct: "knowledge_correct";
395
437
  knowledge_get: "knowledge_get";
438
+ knowledge_prepare_save: "knowledge_prepare_save";
396
439
  knowledge_propose: "knowledge_propose";
397
440
  knowledge_retain_file: "knowledge_retain_file";
398
441
  knowledge_retain_message: "knowledge_retain_message";
@@ -445,6 +488,7 @@ declare const SettingsSchema: z.ZodObject<{
445
488
  session_pause: "session_pause";
446
489
  session_resume: "session_resume";
447
490
  session_send_message: "session_send_message";
491
+ session_set_model: "session_set_model";
448
492
  session_set_project: "session_set_project";
449
493
  session_steer: "session_steer";
450
494
  session_wait: "session_wait";
@@ -459,8 +503,11 @@ declare const SettingsSchema: z.ZodObject<{
459
503
  slack_bot_list_files: "slack_bot_list_files";
460
504
  slack_bot_list_users: "slack_bot_list_users";
461
505
  slack_bot_post_message: "slack_bot_post_message";
506
+ slack_bot_prepare_message: "slack_bot_prepare_message";
462
507
  slack_bot_search: "slack_bot_search";
508
+ slack_bot_send_prepared_message: "slack_bot_send_prepared_message";
463
509
  slack_bot_thread_replies: "slack_bot_thread_replies";
510
+ slack_bot_upload_file: "slack_bot_upload_file";
464
511
  social_connections_list: "social_connections_list";
465
512
  social_daily_analysis_context: "social_daily_analysis_context";
466
513
  social_mentions_live: "social_mentions_live";
@@ -489,6 +536,7 @@ declare const SettingsSchema: z.ZodObject<{
489
536
  x_search_live: "x_search_live";
490
537
  x_thread_fetch: "x_thread_fetch";
491
538
  }>>>>;
539
+ artifactMaterializerDeployed: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
492
540
  streamTokenSecret: z.ZodOptional<z.ZodString>;
493
541
  streamControlEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
494
542
  workDiscoveryEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
@@ -499,11 +547,17 @@ declare const SettingsSchema: z.ZodObject<{
499
547
  environmentsEncryptionKey: z.ZodOptional<z.ZodString>;
500
548
  integrationsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
501
549
  integrationsStateSecret: z.ZodOptional<z.ZodString>;
550
+ integrationsOauthShortStateEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
502
551
  integrationsAllowPrivateNetworkTargets: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
503
552
  integrationsOauthClientsJson: z.ZodDefault<z.ZodString>;
553
+ gmailWatchTopicName: z.ZodOptional<z.ZodString>;
504
554
  slackClientId: z.ZodOptional<z.ZodString>;
505
555
  slackClientSecret: z.ZodOptional<z.ZodString>;
506
556
  slackSigningSecret: z.ZodOptional<z.ZodString>;
557
+ slackAccessMode: z.ZodDefault<z.ZodEnum<{
558
+ full: "full";
559
+ limited: "limited";
560
+ }>>;
507
561
  slackBotDisplayName: z.ZodDefault<z.ZodEnum<{
508
562
  OpenGeni: "OpenGeni";
509
563
  "OpenGeni Staging": "OpenGeni Staging";
@@ -533,8 +587,6 @@ declare const SettingsSchema: z.ZodObject<{
533
587
  goalIdleBackoffMs: z.ZodDefault<z.ZodPreprocess<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>>;
534
588
  goalIdleBackoffMaxMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
535
589
  childLifecycleNoticesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
536
- hostMcpAuthoritySourceAdmissionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
537
- hostMcpCredentialResolversJson: z.ZodOptional<z.ZodString>;
538
590
  slackWorkspaceRoutingEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
539
591
  agentMaxModelCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
540
592
  contextWindowTokens: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -549,10 +601,12 @@ declare const SettingsSchema: z.ZodObject<{
549
601
  authAllowMetrics: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
550
602
  apiHost: z.ZodDefault<z.ZodString>;
551
603
  apiPort: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
604
+ apiMetricsPort: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
552
605
  workerHttpPort: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
553
606
  opengeniMcpInternalUrl: z.ZodOptional<z.ZodString>;
554
607
  opengeniMcpUrl: z.ZodOptional<z.ZodString>;
555
608
  corsAllowOriginRegex: z.ZodDefault<z.ZodString>;
609
+ localAllowedOrigins: z.ZodOptional<z.ZodString>;
556
610
  openaiProvider: z.ZodDefault<z.ZodEnum<{
557
611
  azure: "azure";
558
612
  openai: "openai";
@@ -591,6 +645,20 @@ declare const SettingsSchema: z.ZodObject<{
591
645
  voiceInputAzureApiVersion: z.ZodOptional<z.ZodString>;
592
646
  voiceInputAzureApiKey: z.ZodOptional<z.ZodString>;
593
647
  voiceInputAzureAdToken: z.ZodOptional<z.ZodString>;
648
+ azureLiveEndpoint: z.ZodOptional<z.ZodString>;
649
+ azureLiveApiKey: z.ZodOptional<z.ZodString>;
650
+ azureLiveDeployment: z.ZodDefault<z.ZodString>;
651
+ azureLiveVoice: z.ZodDefault<z.ZodString>;
652
+ azureLivePricingJson: z.ZodOptional<z.ZodString>;
653
+ aiGatewayRealtimePricingJson: z.ZodOptional<z.ZodString>;
654
+ voiceInputMaiEndpoint: z.ZodOptional<z.ZodString>;
655
+ voiceInputMaiApiKey: z.ZodOptional<z.ZodString>;
656
+ voiceInputMaiApiVersion: z.ZodDefault<z.ZodString>;
657
+ voiceInputMaiPricingJson: z.ZodOptional<z.ZodString>;
658
+ voiceInputMaiModel: z.ZodDefault<z.ZodString>;
659
+ voiceInputAzureModel: z.ZodOptional<z.ZodString>;
660
+ voiceInputOpenaiPricingJson: z.ZodOptional<z.ZodString>;
661
+ voiceInputAzurePricingJson: z.ZodOptional<z.ZodString>;
594
662
  voiceInputCodexExperimentalEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
595
663
  modelPricingJson: z.ZodDefault<z.ZodString>;
596
664
  modelCatalogSource: z.ZodDefault<z.ZodEnum<{
@@ -602,9 +670,11 @@ declare const SettingsSchema: z.ZodObject<{
602
670
  openrouterApiKey: z.ZodOptional<z.ZodString>;
603
671
  resolvedGatewayModelsJson: z.ZodOptional<z.ZodString>;
604
672
  resolvedOpenRouterModelsJson: z.ZodOptional<z.ZodString>;
673
+ resolvedCodexModelsJson: z.ZodOptional<z.ZodString>;
605
674
  modelProvidersJson: z.ZodDefault<z.ZodString>;
606
675
  codexSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
607
676
  supergrokSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
677
+ claudeSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
608
678
  supergrokResponseStreamIdleTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
609
679
  codexConnectedAppsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
610
680
  codexProductSku: z.ZodOptional<z.ZodString>;
@@ -612,6 +682,7 @@ declare const SettingsSchema: z.ZodObject<{
612
682
  lazyToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
613
683
  codexFleetPolicyShadowEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
614
684
  codexRotationNearExhaustionPct: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
685
+ reasoningConfigurationUpdatesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
615
686
  openaiReasoningEffort: z.ZodDefault<z.ZodEnum<{
616
687
  high: "high";
617
688
  low: "low";
@@ -622,6 +693,16 @@ declare const SettingsSchema: z.ZodObject<{
622
693
  xhigh: "xhigh";
623
694
  }>>;
624
695
  openaiAllowedReasoningEfforts: z.ZodDefault<z.ZodString>;
696
+ creditsDefaultModel: z.ZodDefault<z.ZodString>;
697
+ creditsDefaultReasoningEffort: z.ZodDefault<z.ZodEnum<{
698
+ high: "high";
699
+ low: "low";
700
+ max: "max";
701
+ medium: "medium";
702
+ minimal: "minimal";
703
+ none: "none";
704
+ xhigh: "xhigh";
705
+ }>>;
625
706
  openaiResponsesTransport: z.ZodDefault<z.ZodEnum<{
626
707
  http: "http";
627
708
  websocket: "websocket";
@@ -633,6 +714,25 @@ declare const SettingsSchema: z.ZodObject<{
633
714
  openaiReasoningEncryptedContent: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
634
715
  openaiMaxRetries: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
635
716
  webSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
717
+ webSearchProvider: z.ZodOptional<z.ZodString>;
718
+ webSearchApiKey: z.ZodOptional<z.ZodString>;
719
+ webSearchBaseUrl: z.ZodOptional<z.ZodString>;
720
+ webFetchProvider: z.ZodOptional<z.ZodString>;
721
+ webFetchApiKey: z.ZodOptional<z.ZodString>;
722
+ webFetchBaseUrl: z.ZodOptional<z.ZodString>;
723
+ webSearchProviderMode: z.ZodOptional<z.ZodString>;
724
+ webSearchPricingJson: z.ZodOptional<z.ZodString>;
725
+ webSearchRequestTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
726
+ jevApiKey: z.ZodOptional<z.ZodString>;
727
+ jevBaseUrl: z.ZodDefault<z.ZodString>;
728
+ jevModel: z.ZodDefault<z.ZodString>;
729
+ jevRequestTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
730
+ codeSearchMode: z.ZodDefault<z.ZodEnum<{
731
+ default_on: "default_on";
732
+ experiment: "experiment";
733
+ off: "off";
734
+ opt_in: "opt_in";
735
+ }>>;
636
736
  agentInstructionsTemplate: z.ZodDefault<z.ZodString>;
637
737
  azureOpenaiBaseUrl: z.ZodOptional<z.ZodString>;
638
738
  azureOpenaiEndpoint: z.ZodOptional<z.ZodString>;
@@ -662,6 +762,7 @@ declare const SettingsSchema: z.ZodObject<{
662
762
  dockerWorkspaceBaseDir: z.ZodOptional<z.ZodString>;
663
763
  modalAppName: z.ZodDefault<z.ZodString>;
664
764
  modalImageRef: z.ZodOptional<z.ZodString>;
765
+ modalCommandSupervisionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
665
766
  modalImageId: z.ZodOptional<z.ZodString>;
666
767
  modalImageRegistrySecret: z.ZodOptional<z.ZodString>;
667
768
  modalTimeoutSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -726,6 +827,7 @@ declare const SettingsSchema: z.ZodObject<{
726
827
  blaxelTtl: z.ZodOptional<z.ZodString>;
727
828
  cloudflareWorkerUrl: z.ZodOptional<z.ZodString>;
728
829
  cloudflareApiKey: z.ZodOptional<z.ZodString>;
830
+ experimentalBrowserContextPoolEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
729
831
  browserbaseApiKey: z.ZodOptional<z.ZodString>;
730
832
  kernelApiKey: z.ZodOptional<z.ZodString>;
731
833
  kernelEndpoint: z.ZodOptional<z.ZodString>;
@@ -768,6 +870,7 @@ declare const SettingsSchema: z.ZodObject<{
768
870
  sandboxViewerHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
769
871
  sandboxInteractionHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
770
872
  sandboxIdleGraceMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
873
+ sandboxIdleCommandContainmentMs: z.ZodPipe<z.ZodOptional<z.ZodCoercedNumber<unknown>>, z.ZodTransform<number | undefined, number | undefined>>;
771
874
  sandboxSnapshotIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
772
875
  sandboxSnapshotTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
773
876
  sandboxDrainSnapshotTimeoutMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -779,9 +882,15 @@ declare const SettingsSchema: z.ZodObject<{
779
882
  workspaceControlLockTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
780
883
  rigSetupTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
781
884
  sandboxWarmRateMicrosPerSecondJson: z.ZodDefault<z.ZodString>;
885
+ sandboxWarmBillingMode: z.ZodDefault<z.ZodEnum<{
886
+ credits: "credits";
887
+ shadow: "shadow";
888
+ usage_only: "usage_only";
889
+ }>>;
782
890
  sandboxMaxWarmSecondsPerWorkspace: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
783
891
  sandboxPreparationProfiles: z.ZodDefault<z.ZodString>;
784
892
  sandboxEnvAllowlist: z.ZodDefault<z.ZodString>;
893
+ sandboxImageAllowlist: z.ZodDefault<z.ZodString>;
785
894
  objectStorageEndpoint: z.ZodOptional<z.ZodString>;
786
895
  objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
787
896
  objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
@@ -816,6 +925,13 @@ declare const SettingsSchema: z.ZodObject<{
816
925
  documentEmbeddingDimensions: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
817
926
  documentEmbeddingApiKey: z.ZodOptional<z.ZodString>;
818
927
  documentEmbeddingBaseUrl: z.ZodOptional<z.ZodString>;
928
+ documentEmbeddingBillingMode: z.ZodDefault<z.ZodEnum<{
929
+ credits: "credits";
930
+ shadow: "shadow";
931
+ usage_only: "usage_only";
932
+ }>>;
933
+ documentEmbeddingCreditsActivatedAt: z.ZodOptional<z.ZodISODateTime>;
934
+ documentEmbeddingRateMicrosPerMillionBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
819
935
  documentCurationProvider: z.ZodDefault<z.ZodEnum<{
820
936
  heuristic: "heuristic";
821
937
  none: "none";
@@ -854,11 +970,13 @@ declare const SettingsSchema: z.ZodObject<{
854
970
  managedAuthGoogleClientSecret: z.ZodOptional<z.ZodString>;
855
971
  managedAuthGithubClientId: z.ZodOptional<z.ZodString>;
856
972
  managedAuthGithubClientSecret: z.ZodOptional<z.ZodString>;
973
+ allowedUserEmails: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>>>;
857
974
  managedAuthSessionSetMode: z.ZodDefault<z.ZodEnum<{
858
975
  broker: "broker";
859
976
  dual: "dual";
860
977
  legacy: "legacy";
861
978
  }>>;
979
+ managedAuthNewSignupsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
862
980
  organizationUserSetupEmailTokenTransport: z.ZodDefault<z.ZodEnum<{
863
981
  fragment: "fragment";
864
982
  query: "query";
@@ -881,6 +999,7 @@ declare const SettingsSchema: z.ZodObject<{
881
999
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
882
1000
  connectionRef: z.ZodOptional<z.ZodObject<{
883
1001
  connectionId: z.ZodOptional<z.ZodString>;
1002
+ accountSelection: z.ZodOptional<z.ZodLiteral<"all_eligible">>;
884
1003
  authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
885
1004
  hostBinding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
886
1005
  bindingId: z.ZodString;
@@ -913,6 +1032,88 @@ declare const SettingsSchema: z.ZodObject<{
913
1032
  }, z.core.$strip>>>;
914
1033
  }, z.core.$strip>;
915
1034
  export type Settings = z.infer<typeof SettingsSchema>;
1035
+ declare const ArtifactOutboxSettingsSchema: z.ZodObject<{
1036
+ serviceName: z.ZodDefault<z.ZodString>;
1037
+ environment: z.ZodDefault<z.ZodString>;
1038
+ deploymentRevision: z.ZodDefault<z.ZodString>;
1039
+ dbSchema: z.ZodDefault<z.ZodString>;
1040
+ rlsStrategy: z.ZodDefault<z.ZodEnum<{
1041
+ force: "force";
1042
+ scoped: "scoped";
1043
+ }>>;
1044
+ observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1045
+ observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1046
+ observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
1047
+ observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
1048
+ natsUrl: z.ZodDefault<z.ZodString>;
1049
+ selfhostedNatsControlUser: z.ZodOptional<z.ZodString>;
1050
+ selfhostedNatsControlPassword: z.ZodOptional<z.ZodString>;
1051
+ }, z.core.$strip>;
1052
+ declare const ObjectStorageSettingsSchema: z.ZodObject<{
1053
+ objectStorageEndpoint: z.ZodOptional<z.ZodString>;
1054
+ objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
1055
+ objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
1056
+ objectStorageBackend: z.ZodDefault<z.ZodEnum<{
1057
+ "aws-s3": "aws-s3";
1058
+ "azure-blob": "azure-blob";
1059
+ gcs: "gcs";
1060
+ "s3-compatible": "s3-compatible";
1061
+ }>>;
1062
+ objectStorageBucket: z.ZodDefault<z.ZodString>;
1063
+ objectStorageRegion: z.ZodDefault<z.ZodString>;
1064
+ objectStorageAccessKeyId: z.ZodOptional<z.ZodString>;
1065
+ objectStorageSecretAccessKey: z.ZodOptional<z.ZodString>;
1066
+ objectStorageForcePathStyle: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1067
+ objectStorageAzureConnectionString: z.ZodOptional<z.ZodString>;
1068
+ objectStorageAzureAccountName: z.ZodOptional<z.ZodString>;
1069
+ objectStorageAzureAccountKey: z.ZodOptional<z.ZodString>;
1070
+ objectStorageAzureEndpoint: z.ZodOptional<z.ZodString>;
1071
+ objectStorageGcsProjectId: z.ZodOptional<z.ZodString>;
1072
+ objectStorageGcsCredentialsJson: z.ZodOptional<z.ZodString>;
1073
+ objectStorageGcsKeyFilename: z.ZodOptional<z.ZodString>;
1074
+ objectStorageGcsApiEndpoint: z.ZodOptional<z.ZodString>;
1075
+ }, z.core.$strip>;
1076
+ declare const ArtifactMaterializerSettingsSchema: z.ZodObject<{
1077
+ serviceName: z.ZodDefault<z.ZodString>;
1078
+ environment: z.ZodDefault<z.ZodString>;
1079
+ deploymentRevision: z.ZodDefault<z.ZodString>;
1080
+ dbSchema: z.ZodDefault<z.ZodString>;
1081
+ rlsStrategy: z.ZodDefault<z.ZodEnum<{
1082
+ force: "force";
1083
+ scoped: "scoped";
1084
+ }>>;
1085
+ observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1086
+ observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1087
+ observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
1088
+ observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
1089
+ objectStorageEndpoint: z.ZodOptional<z.ZodString>;
1090
+ objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
1091
+ objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
1092
+ objectStorageBackend: z.ZodDefault<z.ZodEnum<{
1093
+ "aws-s3": "aws-s3";
1094
+ "azure-blob": "azure-blob";
1095
+ gcs: "gcs";
1096
+ "s3-compatible": "s3-compatible";
1097
+ }>>;
1098
+ objectStorageBucket: z.ZodDefault<z.ZodString>;
1099
+ objectStorageRegion: z.ZodDefault<z.ZodString>;
1100
+ objectStorageAccessKeyId: z.ZodOptional<z.ZodString>;
1101
+ objectStorageSecretAccessKey: z.ZodOptional<z.ZodString>;
1102
+ objectStorageForcePathStyle: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1103
+ objectStorageAzureConnectionString: z.ZodOptional<z.ZodString>;
1104
+ objectStorageAzureAccountName: z.ZodOptional<z.ZodString>;
1105
+ objectStorageAzureAccountKey: z.ZodOptional<z.ZodString>;
1106
+ objectStorageAzureEndpoint: z.ZodOptional<z.ZodString>;
1107
+ objectStorageGcsProjectId: z.ZodOptional<z.ZodString>;
1108
+ objectStorageGcsCredentialsJson: z.ZodOptional<z.ZodString>;
1109
+ objectStorageGcsKeyFilename: z.ZodOptional<z.ZodString>;
1110
+ objectStorageGcsApiEndpoint: z.ZodOptional<z.ZodString>;
1111
+ }, z.core.$strip>;
1112
+ export type ArtifactOutboxSettings = z.infer<typeof ArtifactOutboxSettingsSchema>;
1113
+ export type ObjectStorageSettings = z.infer<typeof ObjectStorageSettingsSchema>;
1114
+ export type ArtifactMaterializerSettings = z.infer<typeof ArtifactMaterializerSettingsSchema>;
1115
+ export declare function getArtifactOutboxSettings(source?: NodeJS.ProcessEnv): ArtifactOutboxSettings;
1116
+ export declare function getArtifactMaterializerSettings(source?: NodeJS.ProcessEnv): ArtifactMaterializerSettings;
916
1117
  export type McpServerConfig = Settings["mcpServers"][number];
917
1118
  export type GoogleDriveProviderRetryOptions = {
918
1119
  requestTimeoutMs: number;
@@ -943,13 +1144,23 @@ export declare function googleDriveOAuthCallbackUrl(publicBaseUrl: string | unde
943
1144
  /** Exact callback registered on the environment-specific personal GitHub OAuth App. */
944
1145
  export declare function personalGitHubOAuthCallbackUrl(publicBaseUrl: string | undefined): string | null;
945
1146
  /** Declarative voice-input transcription provider ids. */
946
- export type VoiceInputProviderId = "openai" | "azure-openai" | "codex-subscription" | "supergrok-subscription";
1147
+ export type VoiceInputProviderId = "openai" | "azure-openai" | "azure-mai" | "codex-subscription" | "supergrok-subscription";
947
1148
  export type VoiceInputProviderConfig = {
1149
+ id: "azure-mai";
1150
+ kind: "azure-mai";
1151
+ pricing: VoiceInputPricing | null;
1152
+ endpoint: string;
1153
+ apiKey: string;
1154
+ apiVersion: string;
1155
+ model: string;
1156
+ } | {
948
1157
  id: "openai";
949
1158
  kind: "openai";
950
1159
  apiKey: string;
951
1160
  baseUrl: string;
952
1161
  model: string;
1162
+ /** Deployment-funded: Opengeni pays upstream and charges credits. */
1163
+ pricing: VoiceInputPricing | null;
953
1164
  } | {
954
1165
  id: "azure-openai";
955
1166
  kind: "azure-openai";
@@ -958,6 +1169,10 @@ export type VoiceInputProviderConfig = {
958
1169
  apiVersion: string;
959
1170
  apiKey: string | null;
960
1171
  adToken: string | null;
1172
+ /** Underlying model (pricing + response shape); defaults to the deployment name. */
1173
+ model: string;
1174
+ /** Deployment-funded: Opengeni pays upstream and charges credits. */
1175
+ pricing: VoiceInputPricing | null;
961
1176
  } | {
962
1177
  id: "codex-subscription";
963
1178
  kind: "codex-subscription";
@@ -967,6 +1182,17 @@ export type VoiceInputProviderConfig = {
967
1182
  kind: "supergrok-subscription";
968
1183
  experimental: true;
969
1184
  };
1185
+ /** The deployment's Jev key, or undefined when it is missing or a placeholder. */
1186
+ export declare function usableJevApiKey(settings: Pick<Settings, "jevApiKey">): string | undefined;
1187
+ /** Deployment half of agent configuration: hard capability limits. */
1188
+ export declare function agentConfigDeploymentPolicy(settings: FirstPartyMcpToolPolicySettings & Pick<Settings, "webSearchEnabled">): AgentConfigDeploymentLimits;
1189
+ /**
1190
+ * Deployment half of the `code_search` decision. `available` is false when
1191
+ * the mode is off or no usable Jev key is configured; workspaces then cannot
1192
+ * turn it on. `workspaceDefault` applies to workspaces without their own
1193
+ * setting.
1194
+ */
1195
+ export declare function codeSearchDeploymentPolicy(settings: Pick<Settings, "codeSearchMode" | "jevApiKey">): CodeSearchDeploymentPolicy;
970
1196
  /**
971
1197
  * Reject empty / template secrets so `.env.example` placeholders like
972
1198
  * `your-key` cannot advertise voice input as available and then 401 upstream.
@@ -978,6 +1204,93 @@ export declare function isUsableVoiceInputSecret(value: string | null | undefine
978
1204
  * whether at least one non-experimental (or probed experimental) provider exists.
979
1205
  */
980
1206
  export declare function resolveVoiceInputProviderRegistry(settings: Settings): VoiceInputProviderConfig[];
1207
+ /** Why a credentialed deployment-funded voice provider is withheld. */
1208
+ export type VoiceInputPricingIssue = {
1209
+ providerId: "openai" | "azure-openai" | "azure-mai";
1210
+ env: string;
1211
+ reason: "malformed" | "unpriced";
1212
+ message: string;
1213
+ };
1214
+ /**
1215
+ * Pricing problems that withhold a credentialed deployment-funded provider.
1216
+ * A malformed PRICING_JSON never fails boot (workers share this config and
1217
+ * must not crash-loop over a voice-only setting); the API logs each issue
1218
+ * once at startup and the provider stays unavailable.
1219
+ */
1220
+ export declare function voiceInputPricingIssues(settings: Settings): VoiceInputPricingIssue[];
1221
+ /**
1222
+ * Opengeni credit price for one deployment-funded transcription provider.
1223
+ * Rates are upstream list prices in integer USD micros; `marginBps` (500 =
1224
+ * +5%) is added on top, exactly like model pricing. `microsPerMinute` prices
1225
+ * provider-reported audio duration (Whisper, `usage.type: "duration"`) and is
1226
+ * a server-measured WAV duration when provider usage is absent. Token
1227
+ * rates price `usage.type: "tokens"` (gpt-4o-transcribe family); `input`
1228
+ * covers text input tokens and, unless `audioInput` is set, audio tokens.
1229
+ */
1230
+ export type VoiceInputPricing = {
1231
+ microsPerMinute: number;
1232
+ inputMicrosPerMillionTokens?: number | undefined;
1233
+ audioInputMicrosPerMillionTokens?: number | undefined;
1234
+ outputMicrosPerMillionTokens?: number | undefined;
1235
+ marginBps?: number | undefined;
1236
+ };
1237
+ /**
1238
+ * Built-in list prices (OpenAI API pricing, "Transcription models" table)
1239
+ * plus the default 5% Opengeni margin used for model pricing. Azure Global
1240
+ * Standard deployments use the same list prices; set the provider
1241
+ * PRICING_JSON when a deployment's contracted or regional price differs.
1242
+ */
1243
+ export declare const defaultVoiceInputPricing: Readonly<Record<string, VoiceInputPricing>>;
1244
+ /** Lowercased model with a dated snapshot suffix (`-2025-03-20`) removed. */
1245
+ export declare function canonicalVoiceInputModel(model: string): string;
1246
+ /** Whisper reports its billed audio duration only in `verbose_json`. */
1247
+ export declare function voiceInputModelReportsDurationOnly(model: string): boolean;
1248
+ /** Parse one provider pricing JSON. Throws a configuration error when malformed. */
1249
+ export declare function parseVoiceInputPricingJson(raw: string | undefined, env?: string): VoiceInputPricing | null;
1250
+ /** Explicit provider pricing JSON wins; otherwise the built-in list price for the model. */
1251
+ export declare function resolveVoiceInputPricing(raw: string | undefined, model: string): VoiceInputPricing | null;
1252
+ /** Non-throwing {@link resolveVoiceInputPricing} for registry resolution. */
1253
+ export declare function safeResolveVoiceInputPricing(raw: string | undefined, model: string, env?: string): {
1254
+ ok: true;
1255
+ pricing: VoiceInputPricing | null;
1256
+ } | {
1257
+ ok: false;
1258
+ error: string;
1259
+ };
1260
+ /** Same predicate as model/credit limits: credit balance and debits are enforced. */
1261
+ export declare function voiceInputCreditBillingActive(settings: Pick<Settings, "billingMode" | "usageLimitsMode">): boolean;
1262
+ /** Provider-reported transcription usage, normalized. Never client-reported. */
1263
+ export type VoiceInputUsage = {
1264
+ kind: "tokens";
1265
+ inputTokens: number;
1266
+ audioInputTokens: number;
1267
+ textInputTokens: number;
1268
+ outputTokens: number;
1269
+ } | {
1270
+ kind: "duration";
1271
+ seconds: number;
1272
+ };
1273
+ export type VoiceInputCost = {
1274
+ /** Upstream list cost before margin, rounded up to whole micros. */
1275
+ providerCostMicros: number;
1276
+ /** Opengeni credit price after margin, rounded up to whole micros. */
1277
+ creditCostMicros: number;
1278
+ };
1279
+ /** True when token usage can be priced exactly. */
1280
+ export declare function voiceInputPricingHasTokenRates(pricing: VoiceInputPricing): boolean;
1281
+ /**
1282
+ * Exact integer credit math. Token usage needs token rates; duration usage
1283
+ * uses `microsPerMinute` at millisecond resolution. Both round up once, after
1284
+ * summing, so a positive use never becomes a free debit.
1285
+ */
1286
+ export declare function calculateVoiceInputCost(pricing: VoiceInputPricing, usage: VoiceInputUsage): VoiceInputCost;
1287
+ /**
1288
+ * Deployment-funded providers that have credentials but are withheld because
1289
+ * credit billing is active and no price is known. The API logs these (and
1290
+ * malformed pricing, see {@link voiceInputPricingIssues}) once at startup so
1291
+ * an operator sees why voice input stayed unavailable.
1292
+ */
1293
+ export declare function unpricedVoiceInputProviders(settings: Settings): VoiceInputProviderId[];
981
1294
  /** True when the deployment has at least one supported (non-experimental) provider. */
982
1295
  export declare function voiceInputDeploymentConfigured(settings: Settings): boolean;
983
1296
  export type TemporalTlsConnectionConfig = {
@@ -1020,6 +1333,24 @@ export type ModelUsageCostBreakdown = {
1020
1333
  /** OpenGeni credit price after configured margin and latency-mode multiplier. */
1021
1334
  creditCostMicros: number;
1022
1335
  };
1336
+ export type ModelListCostClassesMicros = {
1337
+ uncachedInput: number;
1338
+ cacheRead: number;
1339
+ cacheWrite: number;
1340
+ output: number;
1341
+ };
1342
+ export type ModelListUsageCostSnapshot = ModelUsageCostBreakdown & {
1343
+ /** Captured upstream list costs, summing to providerCostMicros, never debits. */
1344
+ listByClassMicros: ModelListCostClassesMicros | null;
1345
+ /** True only when a returned class split includes latency rounding allocation. */
1346
+ listByClassApprox: boolean;
1347
+ };
1348
+ export type ModelRecordedListCostAllocation = {
1349
+ /** Approximate attribution of a stored upstream total, never a new price. */
1350
+ listByClassMicros: ModelListCostClassesMicros | null;
1351
+ /** True for every eligible historical allocation, including known zero. */
1352
+ listByClassApprox: boolean;
1353
+ };
1023
1354
  export type StaticUsageLimitsConfig = StaticUsageLimits;
1024
1355
  export type EntitlementsConfig = Entitlements;
1025
1356
  export declare const CapabilitySupportV1: z.ZodEnum<{
@@ -1196,7 +1527,7 @@ export type CredentialSourceV1 = {
1196
1527
  mechanism: "api_key" | "azure_ad_bearer" | "none";
1197
1528
  } | {
1198
1529
  kind: "connected_subscription";
1199
- provider: "codex" | "xai";
1530
+ provider: "codex" | "xai" | "claude";
1200
1531
  } | {
1201
1532
  kind: "workspace_connection";
1202
1533
  mechanism: "api_key";
@@ -1216,6 +1547,7 @@ export type BillingAttributionV1 = {
1216
1547
  * silently no-ops hosted tools (see docs/model-providers.md).
1217
1548
  */
1218
1549
  export declare const ModelProviderApi: z.ZodEnum<{
1550
+ "anthropic-messages": "anthropic-messages";
1219
1551
  chat: "chat";
1220
1552
  responses: "responses";
1221
1553
  }>;
@@ -1238,8 +1570,14 @@ export type ModelProviderWireProfile = z.infer<typeof ModelProviderWireProfile>;
1238
1570
  */
1239
1571
  export declare const RegistryProviderKind: z.ZodEnum<{
1240
1572
  anonymous: "anonymous";
1573
+ "anthropic-organization": "anthropic-organization";
1574
+ "anthropic-workspace": "anthropic-workspace";
1241
1575
  "api-key": "api-key";
1576
+ "claude-subscription-organization": "claude-subscription-organization";
1577
+ "claude-subscription-workspace": "claude-subscription-workspace";
1242
1578
  "codex-subscription": "codex-subscription";
1579
+ "direct-azure-workspace": "direct-azure-workspace";
1580
+ "direct-openai-workspace": "direct-openai-workspace";
1243
1581
  "openrouter-organization": "openrouter-organization";
1244
1582
  "openrouter-workspace": "openrouter-workspace";
1245
1583
  "vercel-gateway-managed": "vercel-gateway-managed";
@@ -1249,11 +1587,56 @@ export declare const RegistryProviderKind: z.ZodEnum<{
1249
1587
  }>;
1250
1588
  export type RegistryProviderKind = z.infer<typeof RegistryProviderKind>;
1251
1589
  /** A non-built-in provider declared by the host via OPENGENI_MODEL_PROVIDERS_JSON. */
1590
+ export declare const ClaudeSubscriptionIdentity: z.ZodObject<{
1591
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1592
+ deviceId: z.ZodString;
1593
+ }, z.core.$strict>;
1594
+ export type ClaudeSubscriptionIdentity = z.infer<typeof ClaudeSubscriptionIdentity>;
1595
+ export declare const ClaudeSubscriptionCredential: z.ZodObject<{
1596
+ version: z.ZodLiteral<1>;
1597
+ token: z.ZodString;
1598
+ identity: z.ZodObject<{
1599
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1600
+ deviceId: z.ZodString;
1601
+ }, z.core.$strict>;
1602
+ oauth: z.ZodOptional<z.ZodObject<{
1603
+ refreshToken: z.ZodString;
1604
+ expiresAt: z.ZodString;
1605
+ scopes: z.ZodArray<z.ZodString>;
1606
+ }, z.core.$strict>>;
1607
+ }, z.core.$strict>;
1608
+ declare const AnthropicProviderOptions: z.ZodObject<{
1609
+ identity: z.ZodOptional<z.ZodObject<{
1610
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1611
+ deviceId: z.ZodString;
1612
+ }, z.core.$strict>>;
1613
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1614
+ connectionId: z.ZodString;
1615
+ credentialVersion: z.ZodNumber;
1616
+ }, z.core.$strict>>;
1617
+ auth: z.ZodDefault<z.ZodEnum<{
1618
+ "api-key": "api-key";
1619
+ oauth: "oauth";
1620
+ }>>;
1621
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1622
+ "1h": "1h";
1623
+ "5m": "5m";
1624
+ off: "off";
1625
+ }>>;
1626
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1627
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1628
+ }, z.core.$strip>;
1252
1629
  declare const RegistryProviderSchema: z.ZodObject<{
1253
1630
  kind: z.ZodDefault<z.ZodEnum<{
1254
1631
  anonymous: "anonymous";
1632
+ "anthropic-organization": "anthropic-organization";
1633
+ "anthropic-workspace": "anthropic-workspace";
1255
1634
  "api-key": "api-key";
1635
+ "claude-subscription-organization": "claude-subscription-organization";
1636
+ "claude-subscription-workspace": "claude-subscription-workspace";
1256
1637
  "codex-subscription": "codex-subscription";
1638
+ "direct-azure-workspace": "direct-azure-workspace";
1639
+ "direct-openai-workspace": "direct-openai-workspace";
1257
1640
  "openrouter-organization": "openrouter-organization";
1258
1641
  "openrouter-workspace": "openrouter-workspace";
1259
1642
  "vercel-gateway-managed": "vercel-gateway-managed";
@@ -1264,9 +1647,31 @@ declare const RegistryProviderSchema: z.ZodObject<{
1264
1647
  id: z.ZodString;
1265
1648
  label: z.ZodOptional<z.ZodString>;
1266
1649
  api: z.ZodDefault<z.ZodEnum<{
1650
+ "anthropic-messages": "anthropic-messages";
1267
1651
  chat: "chat";
1268
1652
  responses: "responses";
1269
1653
  }>>;
1654
+ anthropic: z.ZodOptional<z.ZodObject<{
1655
+ identity: z.ZodOptional<z.ZodObject<{
1656
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1657
+ deviceId: z.ZodString;
1658
+ }, z.core.$strict>>;
1659
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1660
+ connectionId: z.ZodString;
1661
+ credentialVersion: z.ZodNumber;
1662
+ }, z.core.$strict>>;
1663
+ auth: z.ZodDefault<z.ZodEnum<{
1664
+ "api-key": "api-key";
1665
+ oauth: "oauth";
1666
+ }>>;
1667
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1668
+ "1h": "1h";
1669
+ "5m": "5m";
1670
+ off: "off";
1671
+ }>>;
1672
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1673
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1674
+ }, z.core.$strip>>;
1270
1675
  wireProfile: z.ZodDefault<z.ZodEnum<{
1271
1676
  "azure-openai": "azure-openai";
1272
1677
  openai: "openai";
@@ -1286,6 +1691,7 @@ declare const RegistryProviderSchema: z.ZodObject<{
1286
1691
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
1287
1692
  label: z.ZodOptional<z.ZodString>;
1288
1693
  shortLabel: z.ZodOptional<z.ZodString>;
1694
+ logoUrl: z.ZodOptional<z.ZodString>;
1289
1695
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
1290
1696
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
1291
1697
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -1499,6 +1905,7 @@ export declare const GatewayCatalogModel: z.ZodObject<{
1499
1905
  upstreamModelId: z.ZodString;
1500
1906
  label: z.ZodString;
1501
1907
  shortLabel: z.ZodOptional<z.ZodString>;
1908
+ logoUrl: z.ZodOptional<z.ZodString>;
1502
1909
  providers: z.ZodArray<z.ZodString>;
1503
1910
  implicitCaching: z.ZodDefault<z.ZodBoolean>;
1504
1911
  vision: z.ZodDefault<z.ZodBoolean>;
@@ -1540,6 +1947,7 @@ export declare const OpenRouterCatalogModel: z.ZodObject<{
1540
1947
  upstreamModelId: z.ZodString;
1541
1948
  label: z.ZodString;
1542
1949
  shortLabel: z.ZodOptional<z.ZodString>;
1950
+ logoUrl: z.ZodOptional<z.ZodString>;
1543
1951
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
1544
1952
  capabilities: z.ZodObject<{
1545
1953
  reasoning: z.ZodObject<{
@@ -1702,9 +2110,31 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1702
2110
  id: z.ZodString;
1703
2111
  label: z.ZodOptional<z.ZodString>;
1704
2112
  api: z.ZodDefault<z.ZodEnum<{
2113
+ "anthropic-messages": "anthropic-messages";
1705
2114
  chat: "chat";
1706
2115
  responses: "responses";
1707
2116
  }>>;
2117
+ anthropic: z.ZodOptional<z.ZodObject<{
2118
+ identity: z.ZodOptional<z.ZodObject<{
2119
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
2120
+ deviceId: z.ZodString;
2121
+ }, z.core.$strict>>;
2122
+ credentialBinding: z.ZodOptional<z.ZodObject<{
2123
+ connectionId: z.ZodString;
2124
+ credentialVersion: z.ZodNumber;
2125
+ }, z.core.$strict>>;
2126
+ auth: z.ZodDefault<z.ZodEnum<{
2127
+ "api-key": "api-key";
2128
+ oauth: "oauth";
2129
+ }>>;
2130
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
2131
+ "1h": "1h";
2132
+ "5m": "5m";
2133
+ off: "off";
2134
+ }>>;
2135
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
2136
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
2137
+ }, z.core.$strip>>;
1708
2138
  wireProfile: z.ZodDefault<z.ZodEnum<{
1709
2139
  "azure-openai": "azure-openai";
1710
2140
  openai: "openai";
@@ -1722,6 +2152,7 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1722
2152
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
1723
2153
  label: z.ZodOptional<z.ZodString>;
1724
2154
  shortLabel: z.ZodOptional<z.ZodString>;
2155
+ logoUrl: z.ZodOptional<z.ZodString>;
1725
2156
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
1726
2157
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
1727
2158
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -1882,12 +2313,334 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1882
2313
  publicDefaultHeaderNames: z.ZodOptional<z.ZodNever>;
1883
2314
  publicDefaultQueryNames: z.ZodOptional<z.ZodNever>;
1884
2315
  }, z.core.$strict>>>;
2316
+ codexModels: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
2317
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
2318
+ label: z.ZodOptional<z.ZodString>;
2319
+ shortLabel: z.ZodOptional<z.ZodString>;
2320
+ logoUrl: z.ZodOptional<z.ZodString>;
2321
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
2322
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
2323
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
2324
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
2325
+ reasoningEffort: z.ZodOptional<z.ZodBoolean>;
2326
+ hostedWebSearch: z.ZodOptional<z.ZodBoolean>;
2327
+ credentialSource: z.ZodOptional<z.ZodNever>;
2328
+ billing: z.ZodOptional<z.ZodNever>;
2329
+ retired: z.ZodOptional<z.ZodBoolean>;
2330
+ id: z.ZodString;
2331
+ upstreamModelId: z.ZodString;
2332
+ capabilities: z.ZodObject<{
2333
+ reasoning: z.ZodObject<{
2334
+ upstream: z.ZodEnum<{
2335
+ supported: "supported";
2336
+ unknown: "unknown";
2337
+ unsupported: "unsupported";
2338
+ }>;
2339
+ runnable: z.ZodBoolean;
2340
+ efforts: z.ZodArray<z.ZodEnum<{
2341
+ high: "high";
2342
+ low: "low";
2343
+ max: "max";
2344
+ medium: "medium";
2345
+ minimal: "minimal";
2346
+ none: "none";
2347
+ xhigh: "xhigh";
2348
+ }>>;
2349
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
2350
+ high: "high";
2351
+ low: "low";
2352
+ max: "max";
2353
+ medium: "medium";
2354
+ minimal: "minimal";
2355
+ none: "none";
2356
+ xhigh: "xhigh";
2357
+ }>>;
2358
+ required: z.ZodBoolean;
2359
+ }, z.core.$strip>;
2360
+ functionCalling: z.ZodObject<{
2361
+ upstream: z.ZodEnum<{
2362
+ supported: "supported";
2363
+ unknown: "unknown";
2364
+ unsupported: "unsupported";
2365
+ }>;
2366
+ runnable: z.ZodBoolean;
2367
+ }, z.core.$strip>;
2368
+ structuredOutput: z.ZodObject<{
2369
+ upstream: z.ZodEnum<{
2370
+ supported: "supported";
2371
+ unknown: "unknown";
2372
+ unsupported: "unsupported";
2373
+ }>;
2374
+ runnable: z.ZodBoolean;
2375
+ }, z.core.$strip>;
2376
+ hostedTools: z.ZodObject<{
2377
+ webSearch: z.ZodObject<{
2378
+ upstream: z.ZodEnum<{
2379
+ supported: "supported";
2380
+ unknown: "unknown";
2381
+ unsupported: "unsupported";
2382
+ }>;
2383
+ runnable: z.ZodBoolean;
2384
+ }, z.core.$strip>;
2385
+ xSearch: z.ZodObject<{
2386
+ upstream: z.ZodEnum<{
2387
+ supported: "supported";
2388
+ unknown: "unknown";
2389
+ unsupported: "unsupported";
2390
+ }>;
2391
+ runnable: z.ZodBoolean;
2392
+ }, z.core.$strip>;
2393
+ codeExecution: z.ZodObject<{
2394
+ upstream: z.ZodEnum<{
2395
+ supported: "supported";
2396
+ unknown: "unknown";
2397
+ unsupported: "unsupported";
2398
+ }>;
2399
+ runnable: z.ZodBoolean;
2400
+ }, z.core.$strip>;
2401
+ imageGeneration: z.ZodDefault<z.ZodObject<{
2402
+ upstream: z.ZodEnum<{
2403
+ supported: "supported";
2404
+ unknown: "unknown";
2405
+ unsupported: "unsupported";
2406
+ }>;
2407
+ runnable: z.ZodBoolean;
2408
+ }, z.core.$strip>>;
2409
+ }, z.core.$strip>;
2410
+ inputModalities: z.ZodArray<z.ZodEnum<{
2411
+ audio: "audio";
2412
+ image: "image";
2413
+ text: "text";
2414
+ }>>;
2415
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
2416
+ outputModalities: z.ZodArray<z.ZodEnum<{
2417
+ audio: "audio";
2418
+ image: "image";
2419
+ text: "text";
2420
+ }>>;
2421
+ transports: z.ZodObject<{
2422
+ sse: z.ZodObject<{
2423
+ upstream: z.ZodEnum<{
2424
+ supported: "supported";
2425
+ unknown: "unknown";
2426
+ unsupported: "unsupported";
2427
+ }>;
2428
+ runnable: z.ZodBoolean;
2429
+ }, z.core.$strip>;
2430
+ responsesWebSocket: z.ZodObject<{
2431
+ upstream: z.ZodEnum<{
2432
+ supported: "supported";
2433
+ unknown: "unknown";
2434
+ unsupported: "unsupported";
2435
+ }>;
2436
+ runnable: z.ZodBoolean;
2437
+ }, z.core.$strip>;
2438
+ realtimeAudio: z.ZodObject<{
2439
+ upstream: z.ZodEnum<{
2440
+ supported: "supported";
2441
+ unknown: "unknown";
2442
+ unsupported: "unsupported";
2443
+ }>;
2444
+ runnable: z.ZodBoolean;
2445
+ }, z.core.$strip>;
2446
+ }, z.core.$strip>;
2447
+ promptCaching: z.ZodOptional<z.ZodObject<{
2448
+ upstream: z.ZodEnum<{
2449
+ supported: "supported";
2450
+ unknown: "unknown";
2451
+ unsupported: "unsupported";
2452
+ }>;
2453
+ runnable: z.ZodBoolean;
2454
+ mode: z.ZodEnum<{
2455
+ automatic: "automatic";
2456
+ implicit: "implicit";
2457
+ none: "none";
2458
+ }>;
2459
+ }, z.core.$strip>>;
2460
+ latencyModes: z.ZodArray<z.ZodObject<{
2461
+ id: z.ZodEnum<{
2462
+ fast: "fast";
2463
+ priority: "priority";
2464
+ standard: "standard";
2465
+ }>;
2466
+ upstream: z.ZodEnum<{
2467
+ supported: "supported";
2468
+ unknown: "unknown";
2469
+ unsupported: "unsupported";
2470
+ }>;
2471
+ runnable: z.ZodBoolean;
2472
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
2473
+ }, z.core.$strip>>;
2474
+ }, z.core.$strip>;
2475
+ pricing: z.ZodOptional<z.ZodNever>;
2476
+ }, z.core.$strict>, z.ZodTransform<{
2477
+ aliases?: string[] | undefined;
2478
+ label?: string | undefined;
2479
+ shortLabel?: string | undefined;
2480
+ logoUrl?: string | undefined;
2481
+ contextWindowTokens?: number | undefined;
2482
+ effectiveContextWindowTokens?: number | undefined;
2483
+ autoCompactTokenLimit?: number | undefined;
2484
+ toolOutputTruncationTokens?: number | undefined;
2485
+ reasoningEffort?: boolean | undefined;
2486
+ hostedWebSearch?: boolean | undefined;
2487
+ credentialSource?: undefined;
2488
+ billing?: undefined;
2489
+ retired?: boolean | undefined;
2490
+ id: string;
2491
+ upstreamModelId: string;
2492
+ pricing?: undefined;
2493
+ capabilities: {
2494
+ reasoning: {
2495
+ upstream: "supported" | "unknown" | "unsupported";
2496
+ runnable: boolean;
2497
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2498
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2499
+ required: boolean;
2500
+ };
2501
+ functionCalling: {
2502
+ upstream: "supported" | "unknown" | "unsupported";
2503
+ runnable: boolean;
2504
+ };
2505
+ structuredOutput: {
2506
+ upstream: "supported" | "unknown" | "unsupported";
2507
+ runnable: boolean;
2508
+ };
2509
+ hostedTools: {
2510
+ webSearch: {
2511
+ upstream: "supported" | "unknown" | "unsupported";
2512
+ runnable: boolean;
2513
+ };
2514
+ xSearch: {
2515
+ upstream: "supported" | "unknown" | "unsupported";
2516
+ runnable: boolean;
2517
+ };
2518
+ codeExecution: {
2519
+ upstream: "supported" | "unknown" | "unsupported";
2520
+ runnable: boolean;
2521
+ };
2522
+ imageGeneration: {
2523
+ upstream: "supported" | "unknown" | "unsupported";
2524
+ runnable: boolean;
2525
+ };
2526
+ };
2527
+ inputModalities: ("audio" | "image" | "text")[];
2528
+ inputFileMediaTypes: string[];
2529
+ outputModalities: ("audio" | "image" | "text")[];
2530
+ transports: {
2531
+ sse: {
2532
+ upstream: "supported" | "unknown" | "unsupported";
2533
+ runnable: boolean;
2534
+ };
2535
+ responsesWebSocket: {
2536
+ upstream: "supported" | "unknown" | "unsupported";
2537
+ runnable: boolean;
2538
+ };
2539
+ realtimeAudio: {
2540
+ upstream: "supported" | "unknown" | "unsupported";
2541
+ runnable: boolean;
2542
+ };
2543
+ };
2544
+ promptCaching?: {
2545
+ upstream: "supported" | "unknown" | "unsupported";
2546
+ runnable: boolean;
2547
+ mode: "automatic" | "implicit" | "none";
2548
+ } | undefined;
2549
+ latencyModes: {
2550
+ id: "fast" | "priority" | "standard";
2551
+ upstream: "supported" | "unknown" | "unsupported";
2552
+ runnable: boolean;
2553
+ billingMultiplierBps?: number | undefined;
2554
+ }[];
2555
+ };
2556
+ }, {
2557
+ aliases?: string[] | undefined;
2558
+ label?: string | undefined;
2559
+ shortLabel?: string | undefined;
2560
+ logoUrl?: string | undefined;
2561
+ contextWindowTokens?: number | undefined;
2562
+ effectiveContextWindowTokens?: number | undefined;
2563
+ autoCompactTokenLimit?: number | undefined;
2564
+ toolOutputTruncationTokens?: number | undefined;
2565
+ reasoningEffort?: boolean | undefined;
2566
+ hostedWebSearch?: boolean | undefined;
2567
+ credentialSource?: undefined;
2568
+ billing?: undefined;
2569
+ retired?: boolean | undefined;
2570
+ id: string;
2571
+ upstreamModelId: string;
2572
+ capabilities: {
2573
+ reasoning: {
2574
+ upstream: "supported" | "unknown" | "unsupported";
2575
+ runnable: boolean;
2576
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2577
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2578
+ required: boolean;
2579
+ };
2580
+ functionCalling: {
2581
+ upstream: "supported" | "unknown" | "unsupported";
2582
+ runnable: boolean;
2583
+ };
2584
+ structuredOutput: {
2585
+ upstream: "supported" | "unknown" | "unsupported";
2586
+ runnable: boolean;
2587
+ };
2588
+ hostedTools: {
2589
+ webSearch: {
2590
+ upstream: "supported" | "unknown" | "unsupported";
2591
+ runnable: boolean;
2592
+ };
2593
+ xSearch: {
2594
+ upstream: "supported" | "unknown" | "unsupported";
2595
+ runnable: boolean;
2596
+ };
2597
+ codeExecution: {
2598
+ upstream: "supported" | "unknown" | "unsupported";
2599
+ runnable: boolean;
2600
+ };
2601
+ imageGeneration: {
2602
+ upstream: "supported" | "unknown" | "unsupported";
2603
+ runnable: boolean;
2604
+ };
2605
+ };
2606
+ inputModalities: ("audio" | "image" | "text")[];
2607
+ inputFileMediaTypes: string[];
2608
+ outputModalities: ("audio" | "image" | "text")[];
2609
+ transports: {
2610
+ sse: {
2611
+ upstream: "supported" | "unknown" | "unsupported";
2612
+ runnable: boolean;
2613
+ };
2614
+ responsesWebSocket: {
2615
+ upstream: "supported" | "unknown" | "unsupported";
2616
+ runnable: boolean;
2617
+ };
2618
+ realtimeAudio: {
2619
+ upstream: "supported" | "unknown" | "unsupported";
2620
+ runnable: boolean;
2621
+ };
2622
+ };
2623
+ promptCaching?: {
2624
+ upstream: "supported" | "unknown" | "unsupported";
2625
+ runnable: boolean;
2626
+ mode: "automatic" | "implicit" | "none";
2627
+ } | undefined;
2628
+ latencyModes: {
2629
+ id: "fast" | "priority" | "standard";
2630
+ upstream: "supported" | "unknown" | "unsupported";
2631
+ runnable: boolean;
2632
+ billingMultiplierBps?: number | undefined;
2633
+ }[];
2634
+ };
2635
+ pricing?: undefined;
2636
+ }>>>>;
1885
2637
  gatewayModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
1886
2638
  productId: z.ZodString;
1887
2639
  workspaceProductId: z.ZodString;
1888
2640
  upstreamModelId: z.ZodString;
1889
2641
  label: z.ZodString;
1890
2642
  shortLabel: z.ZodOptional<z.ZodString>;
2643
+ logoUrl: z.ZodOptional<z.ZodString>;
1891
2644
  providers: z.ZodArray<z.ZodString>;
1892
2645
  implicitCaching: z.ZodDefault<z.ZodBoolean>;
1893
2646
  vision: z.ZodDefault<z.ZodBoolean>;
@@ -1904,6 +2657,7 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1904
2657
  upstreamModelId: z.ZodString;
1905
2658
  label: z.ZodString;
1906
2659
  shortLabel: z.ZodOptional<z.ZodString>;
2660
+ logoUrl: z.ZodOptional<z.ZodString>;
1907
2661
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
1908
2662
  capabilities: z.ZodObject<{
1909
2663
  reasoning: z.ZodObject<{
@@ -2085,6 +2839,7 @@ export type IntegrationOAuthClientConfig = z.infer<typeof IntegrationOAuthClient
2085
2839
  * replacement.
2086
2840
  */
2087
2841
  export interface ResolvedModelProvider {
2842
+ anthropic?: z.infer<typeof AnthropicProviderOptions> | undefined;
2088
2843
  id: string;
2089
2844
  label: string;
2090
2845
  kind: RegistryProviderKind | "openrouter-managed";
@@ -2108,6 +2863,8 @@ export interface ConfiguredModel {
2108
2863
  label: string;
2109
2864
  /** Optional curated compact label for dense UI (e.g. mobile composer). */
2110
2865
  shortLabel?: string | undefined;
2866
+ /** Optional HTTPS maker logo; display metadata does not change execution identity. */
2867
+ logoUrl?: string | undefined;
2111
2868
  providerId: string;
2112
2869
  providerLabel: string;
2113
2870
  api: ModelProviderApi;
@@ -2134,6 +2891,20 @@ export interface ConfiguredModel {
2134
2891
  reasoningEffort: boolean;
2135
2892
  hostedWebSearch: boolean;
2136
2893
  }
2894
+ /**
2895
+ * Whether a resolved route is the deployment-funded OpenRouter free tier: the
2896
+ * managed OpenRouter provider, which sends every workspace's requests with the
2897
+ * deployment's one OpenRouter key, serving an upstream `:free` variant (the
2898
+ * curated catalog admits nothing else). OpenRouter limits free-variant
2899
+ * requests per account per minute and per day, so each request on this route
2900
+ * spends quota that every turn on the deployment shares. A workspace or
2901
+ * organization OpenRouter connection uses its own account and is not this
2902
+ * route.
2903
+ */
2904
+ export declare function isManagedOpenRouterFreeRoute(route: {
2905
+ provider: Pick<ResolvedModelProvider, "kind">;
2906
+ configured: Pick<ConfiguredModel, "upstreamModelId">;
2907
+ }): boolean;
2137
2908
  export declare const VERCEL_AI_GATEWAY_BASE_URL: "https://ai-gateway.vercel.sh/v1";
2138
2909
  export declare const VERCEL_AI_GATEWAY_AI_SDK_BASE_URL: "https://ai-gateway.vercel.sh/v4/ai";
2139
2910
  export declare const VERCEL_AI_GATEWAY_CONNECTION_DOMAIN: "ai-gateway.vercel.sh";
@@ -2218,6 +2989,8 @@ export declare function configuredOpenRouterOrganizationProductModelIds(settings
2218
2989
  * llm-prices.com as a ground-truth canary; it does not generate this table.
2219
2990
  */
2220
2991
  export declare const defaultModelPricing: Record<string, ModelPricingScheduleV1>;
2992
+ /** Reviewed comparison rates only; never debit or execution-definition defaults. */
2993
+ export declare const reviewedModelListPricing: Record<string, ModelPricingScheduleV1>;
2221
2994
  export type SandboxRequiredEnv = {
2222
2995
  field: keyof Settings;
2223
2996
  env: string;
@@ -2237,10 +3010,17 @@ export type FirstPartyMcpToolPolicy = {
2237
3010
  default: FirstPartyMcpToolNameType[];
2238
3011
  allowed: FirstPartyMcpToolNameType[];
2239
3012
  };
3013
+ export type FirstPartyMcpToolPolicySettings = Pick<Settings, "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools" | "artifactMaterializerDeployed">;
3014
+ /**
3015
+ * First-party tools whose backing workload this deployment does not run. They
3016
+ * are absent from the ceiling (never offered) and an explicit request for one
3017
+ * is dropped rather than rejected: it is a deployment fact, not a caller error.
3018
+ */
3019
+ export declare function deploymentUnavailableFirstPartyMcpTools(settings: Pick<Settings, "artifactMaterializerDeployed">): ReadonlySet<FirstPartyMcpToolNameType>;
2240
3020
  /** Resolve the deployment's session-tool defaults and hard execution ceiling. */
2241
- export declare function resolveFirstPartyMcpToolPolicy(settings: Pick<Settings, "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">): FirstPartyMcpToolPolicy;
3021
+ export declare function resolveFirstPartyMcpToolPolicy(settings: FirstPartyMcpToolPolicySettings): FirstPartyMcpToolPolicy;
2242
3022
  /** Apply the deployment ceiling to an existing durable session selection. */
2243
- export declare function allowedFirstPartyMcpToolsForSession(settings: Pick<Settings, "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">, selected: readonly FirstPartyMcpToolNameType[] | null | undefined): FirstPartyMcpToolNameType[];
3023
+ export declare function allowedFirstPartyMcpToolsForSession(settings: FirstPartyMcpToolPolicySettings, selected: readonly FirstPartyMcpToolNameType[] | null | undefined): FirstPartyMcpToolNameType[];
2244
3024
  /**
2245
3025
  * The Modal sandbox idle timeout (seconds) the provider actually passes as
2246
3026
  * idleTimeoutMs (sandbox-file-persistence). When the operator did not pin
@@ -2287,6 +3067,17 @@ export declare function collectSandboxEnvironment(settings: Settings, source?: N
2287
3067
  */
2288
3068
  export declare function resolveProviderApiKey(provider: Pick<RegistryProvider, "apiKey" | "apiKeyEnv">, source?: NodeJS.ProcessEnv): string | undefined;
2289
3069
  export declare function gatewayRequestPolicyForUpstreamModel(upstreamModelId: string, models?: readonly GatewayCatalogModel[]): ConfiguredModel["requestPolicy"];
3070
+ /** Customer-owned OpenAI/Azure routes, bound to immutable connection identity. */
3071
+ export declare function withDirectModelProviders(settings: Settings, connections: readonly {
3072
+ id: string;
3073
+ version: number;
3074
+ subjectId: string | null;
3075
+ kind: string;
3076
+ status: string;
3077
+ providerDomain: string;
3078
+ metadata: Record<string, unknown>;
3079
+ apiKey?: string;
3080
+ }[]): Settings;
2290
3081
  /** Static catalog overlay; it contains no concrete workspace credential. */
2291
3082
  export declare function withWorkspaceGatewayCatalogProvider(settings: Settings, customModels?: readonly {
2292
3083
  upstreamModelId: string;
@@ -2348,7 +3139,22 @@ export declare function serviceTierForLatencyMode(providerId: string, latencyMod
2348
3139
  /** True when the response tier fulfills a non-standard Fast/priority request. */
2349
3140
  export declare function responseSatisfiesLatencyMode(requested: LatencyMode, responseServiceTier: string | null | undefined): boolean;
2350
3141
  export declare function runnableLatencyModesForModel(settings: Settings, modelId: string): LatencyMode[];
3142
+ export declare class UnsupportedLatencyModeError extends Error {
3143
+ readonly modelId: string;
3144
+ readonly latencyMode: LatencyMode;
3145
+ readonly allowedLatencyModes: readonly LatencyMode[];
3146
+ readonly code = "UNSUPPORTED_LATENCY_MODE";
3147
+ constructor(modelId: string, latencyMode: LatencyMode, allowedLatencyModes: readonly LatencyMode[]);
3148
+ }
2351
3149
  export declare function modelCostClassForConfiguredModel(_settings: Settings, model: Pick<ConfiguredModel, "cost">): ConfiguredModelCostClass;
3150
+ /**
3151
+ * The executable model an accepted turn runs: the current definition, except
3152
+ * that a turn frozen before hosted web search was enabled keeps its frozen
3153
+ * tool set (no web_search) on every recovery attempt. Only the next accepted
3154
+ * logical turn resolves the newly enabled tool. Call only with a policy that
3155
+ * already passed assertTurnExecutionPolicyMatchesConfigV1.
3156
+ */
3157
+ export declare function configuredModelForAcceptedTurnExecutionPolicy(model: ConfiguredModel, provider: ResolvedModelProvider, policy: TurnExecutionPolicyV1): ConfiguredModel;
2352
3158
  /**
2353
3159
  * The built-in provider's stable id: "openai" on the OpenAI platform, "azure"
2354
3160
  * on Azure. Exported because the workspace model-policy gate must attribute
@@ -2372,6 +3178,8 @@ export declare function configuredProviders(settings: Settings, source?: NodeJS.
2372
3178
  * select, lease, refresh, or expose a concrete credential; those runtime
2373
3179
  * operations remain owned by the credential allocator.
2374
3180
  */
3181
+ /** Exact upstream slugs of the active Codex catalog (or the built-in fallback list). */
3182
+ export declare function codexUpstreamModelSlugs(settings: Settings): string[];
2375
3183
  export declare function withCodexCatalogProvider(settings: Settings): Settings;
2376
3184
  /**
2377
3185
  * Static SuperGrok product catalogue, matching the Codex subscription seam.
@@ -2412,6 +3220,14 @@ export declare function canonicalizeConfiguredModelId(settings: Settings, modelI
2412
3220
  * openai allow-list, then registry ids.
2413
3221
  */
2414
3222
  export declare function configuredAllowedModels(settings: Settings): string[];
3223
+ /** Retirement is selection metadata, never provider authority or executable identity. */
3224
+ export declare function isModelAvailableForNewSelection(settings: Settings, modelId: string): boolean;
3225
+ /** Called only with the durable policy installed for a claimed accepted attempt. */
3226
+ export declare function settingsForAcceptedSubscriptionTurn(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
3227
+ modelId: string;
3228
+ reasoningEffort: Settings["openaiReasoningEffort"];
3229
+ latencyMode?: LatencyMode;
3230
+ }): Settings;
2415
3231
  /**
2416
3232
  * Resolve a model string to the provider that serves it and its configured
2417
3233
  * shape. Returns undefined when the id is not exposed (built-in allow-list nor
@@ -2439,16 +3255,29 @@ export type ResolveTurnExecutionPolicyV1Input = {
2439
3255
  * callers must keep their live credential/readiness gate authoritative.
2440
3256
  */
2441
3257
  export declare function resolveModelProviderForTurn(settings: Settings, modelId: string): ReturnType<typeof resolveModelProvider>;
3258
+ /**
3259
+ * The requested model cannot start new work: it is retired from new selection
3260
+ * or absent from the configured catalog. Callers that own a durable refusal
3261
+ * (for example a scheduled occurrence) record it instead of failing blindly.
3262
+ */
3263
+ export declare class TurnExecutionPolicyModelUnavailableError extends Error {
3264
+ constructor(message: string);
3265
+ }
2442
3266
  /**
2443
3267
  * Build a trusted, secret-safe execution policy from the normalized catalog.
2444
3268
  * The Codex overlay here contains static product/provider identity only; it
2445
3269
  * neither proves readiness nor chooses, decrypts, leases, or exposes an account.
2446
3270
  */
2447
3271
  export declare function resolveTurnExecutionPolicyV1(settings: Settings, input: ResolveTurnExecutionPolicyV1Input): TurnExecutionPolicyV1;
3272
+ /** Explicit accepted execution identity matches, but its definition digest differs. */
3273
+ export declare class TurnExecutionPolicyDefinitionMismatchError extends Error {
3274
+ readonly code = "turn_execution_policy_definition_mismatch";
3275
+ constructor();
3276
+ }
2448
3277
  /**
2449
3278
  * Parse-time validation lives in @opengeni/contracts; this verifier binds a
2450
3279
  * present snapshot to the current executable definition and exact turn row.
2451
- * Any deployment/provider drift fails before a provider or compaction call.
3280
+ * Non-additive executable drift fails before a provider or compaction call.
2452
3281
  */
2453
3282
  export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
2454
3283
  modelId: string;
@@ -2466,6 +3295,13 @@ export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Setti
2466
3295
  * complete schedule, and always replace the lower-precedence schedule.
2467
3296
  */
2468
3297
  export declare function configuredModelPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
3298
+ /**
3299
+ * Insights list-price metadata, including reviewed namespaced provider routes.
3300
+ * Kept separate from debit/catalog pricing: adding a comparison must not change
3301
+ * an accepted turn's frozen execution-definition hash or payer classification.
3302
+ * Inline registry and explicit product-ID prices always win over projections.
3303
+ */
3304
+ export declare function configuredModelListPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
2469
3305
  /** Legacy flat projection: returns the default/below-threshold price. */
2470
3306
  export declare function configuredModelPricing(settings: Settings): Record<string, ModelPricing>;
2471
3307
  /** Select the per-provider-request price at an exact input-token threshold. */
@@ -2489,6 +3325,29 @@ export declare function calculateModelUsageCostMicros(settings: Settings, model:
2489
3325
  export declare function calculateModelUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
2490
3326
  latencyMode?: LatencyMode;
2491
3327
  }): ModelUsageCostBreakdown;
3328
+ /** Provider-list/equivalent-credit comparison only; never debit authority. */
3329
+ export declare function calculateModelListUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
3330
+ latencyMode?: LatencyMode;
3331
+ }): ModelUsageCostBreakdown;
3332
+ /**
3333
+ * Forward-only list comparison snapshot for the model-call fact writer.
3334
+ * Callers must establish request price provenance (including geography/service
3335
+ * tier) and retain per-request counters. Unknown counters/TTL/modifiers yield
3336
+ * no class split, not invented zeros. Historical facts must not use this helper.
3337
+ * Native Claude details preserve cache_write_tokens_5m and cache_write_tokens_1h.
3338
+ */
3339
+ export declare function calculateModelListUsageCostSnapshot(settings: Settings, model: string, usage: ModelUsageInput, options?: {
3340
+ latencyMode?: LatencyMode;
3341
+ priceContextKnown?: boolean;
3342
+ }): ModelListUsageCostSnapshot;
3343
+ /**
3344
+ * Approximate class attribution of a previously recorded upstream list total.
3345
+ * Current reviewed rates are weights only: this never recomputes that total,
3346
+ * credits, or charges. Missing class counters/rates remain unknown. Historical
3347
+ * cache writes use the schedule's single TTL rate, not an exact TTL assertion.
3348
+ * Reasoning is already included in outputTokens and is never added again.
3349
+ */
3350
+ export declare function allocateRecordedModelListCostByClass(settings: Settings, model: string, usage: ModelUsageInput, recordedProviderCostMicros: number | null | undefined): ModelRecordedListCostAllocation;
2492
3351
  /**
2493
3352
  * Convert AI Gateway's exact USD inference cost to OpenGeni credit micros and
2494
3353
  * apply the configured model margin. Decimal arithmetic is integer-only so a
@@ -2616,6 +3475,7 @@ export declare function applyGitAuthPointerEnvironment(environment: Record<strin
2616
3475
  email: string;
2617
3476
  } | null): Record<string, string>;
2618
3477
  export type StartupRetryOptions = {
3478
+ shouldRetry?: (error: unknown) => boolean;
2619
3479
  attempts?: number;
2620
3480
  initialDelayMs?: number;
2621
3481
  maxDelayMs?: number;
@@ -2627,7 +3487,7 @@ export type StartupRetryOptions = {
2627
3487
  error: unknown;
2628
3488
  }) => void;
2629
3489
  };
2630
- export declare function startupRetryOptions(settings: Settings): Required<Omit<StartupRetryOptions, "onRetry">>;
3490
+ export declare function startupRetryOptions(settings: Settings): Required<Omit<StartupRetryOptions, "onRetry" | "shouldRetry">>;
2631
3491
  export declare function retryStartupDependency<T>(label: string, operation: () => Promise<T>, options?: StartupRetryOptions): Promise<T>;
2632
3492
  export declare function sandboxEnvironmentVariableNames(settings: Settings): string[];
2633
3493
  export declare function sandboxLifecycleHookIds(settings: Settings): string[];
@@ -2676,6 +3536,31 @@ export declare function firstPartyMcpInternalBaseUrl(settings: Settings): string
2676
3536
  export declare function firstPartyMcpWorkspaceUrl(settings: Settings, workspaceId: string): string;
2677
3537
  export declare function firstPartyMcpInternalWorkspaceUrl(settings: Settings, workspaceId: string): string;
2678
3538
  export declare function codemodeWorkspaceUrl(settings: Settings, workspaceId: string): string;
3539
+ export type TrustedProxyCidr = {
3540
+ address: string;
3541
+ prefix: number;
3542
+ family: "ipv4" | "ipv6";
3543
+ };
3544
+ /**
3545
+ * Parse `OPENGENI_API_TRUSTED_PROXY_CIDRS`: comma-separated IPv4/IPv6 CIDRs or
3546
+ * single addresses. Throws on any malformed entry so a typo can never widen or
3547
+ * silently disable the trusted proxy set.
3548
+ */
3549
+ export declare function trustedProxyCidrEntries(raw: string): TrustedProxyCidr[];
3550
+ /**
3551
+ * Parse `OPENGENI_LOCAL_ALLOWED_ORIGINS`: comma-separated exact browser origins
3552
+ * (`http(s)://host[:port]`, no path, query, credentials, or wildcard). Throws on
3553
+ * any malformed entry so a typo can never widen or silently disable the local
3554
+ * browser boundary.
3555
+ */
3556
+ export declare function localAllowedOriginEntries(raw: string | undefined): string[];
3557
+ /**
3558
+ * Local development only: whether a normalized API path is one a sandbox calls
3559
+ * (Codemode, first-party MCP, and the personal Git broker). The Linux Docker
3560
+ * sandbox route relays only these, and the local API serves only these on the
3561
+ * addresses that only sandboxes use (see `apps/api/src/http/local-browser-boundary.ts`).
3562
+ */
3563
+ export declare function localSandboxApiRouteAllowed(pathname: string): boolean;
2679
3564
  /** Validate one fully resolved, secret-bearing executable catalog. */
2680
3565
  export declare function validateModelCatalogSettings(settings: Settings, source?: NodeJS.ProcessEnv): ConfiguredModel[];
2681
3566
  /**
@@ -2740,4 +3625,32 @@ export interface NatsControlPlaneAuth {
2740
3625
  user: string;
2741
3626
  password: string;
2742
3627
  }
2743
- export declare function resolveNatsControlPlaneAuth(settings: Settings): NatsControlPlaneAuth | null;
3628
+ export declare function resolveNatsControlPlaneAuth(settings: Pick<Settings, "selfhostedNatsControlUser" | "selfhostedNatsControlPassword">): NatsControlPlaneAuth | null;
3629
+ /** Image references a workspace may select as its default sandbox image. */
3630
+ export declare function sandboxImageAllowlist(settings: Pick<Settings, "sandboxImageAllowlist">): string[];
3631
+ /** Native Claude connections reuse the encrypted workspace and organization boundaries. */
3632
+ export declare const CLAUDE_CONNECTION_KINDS: readonly ["anthropic", "claude_subscription"];
3633
+ export type ClaudeConnectionKind = (typeof CLAUDE_CONNECTION_KINDS)[number];
3634
+ export declare function claudeNativeModelProfile(upstreamModelId: string): Readonly<{
3635
+ efforts: readonly ReasoningEffort[];
3636
+ defaultEffort: ReasoningEffort | null;
3637
+ contextWindowTokens: number;
3638
+ maxOutputTokens: number;
3639
+ }> | undefined;
3640
+ export declare function claudeProviderId(kind: ClaudeConnectionKind, scope?: "workspace" | "organization"): string;
3641
+ export type ClaudeConnectionCatalog = Partial<Record<ClaudeConnectionKind, {
3642
+ active?: boolean;
3643
+ models: readonly {
3644
+ upstreamModelId: string;
3645
+ label?: string | null;
3646
+ }[];
3647
+ }>>;
3648
+ export declare function withClaudeConnectionCatalog(settings: Settings, connections: ClaudeConnectionCatalog, scope?: "workspace" | "organization"): Settings;
3649
+ export declare function withClaudeConnectionCredential(settings: Settings, kind: ClaudeConnectionKind, credential: string, scope?: "workspace" | "organization", credentialBinding?: {
3650
+ connectionId: string;
3651
+ credentialVersion: number;
3652
+ }): Settings;
3653
+ export * from "./claude-subscription-usage.js";
3654
+ export * from "./claude-subscription-oauth.js";
3655
+ export * from "./subscription-account-selection.js";
3656
+ export * from "./claude-subscription-capacity.js";