@opengeni/config 3.2.1 → 3.2.2

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,8 +1,28 @@
1
1
  export { managedUserEmailAllowed } from "./managed-user-admission.js";
2
- import { type AgentConfigDeploymentLimits, Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType } from "@opengeni/contracts";
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, type OrganizationModelDefaults, type ModelCompactionPolicy, Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, TurnServingPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType, type Session } from "@opengeni/contracts";
3
6
  import type { CodeSearchDeploymentPolicy } from "@opengeni/contracts/code-search";
4
7
  export { XAI_SUBSCRIPTION_MODEL_ID_PREFIX } from "@opengeni/xai-subscription";
5
8
  import { z } from "zod";
9
+ /**
10
+ * Default maximum provider silence on a generic OpenAI-compatible model stream
11
+ * while the worker is waiting for the next chunk. Matches the Codex transport
12
+ * and SuperGrok idle defaults (5 minutes): long enough for a reasoning model's
13
+ * silent thinking gaps, short enough that a wedged stream recovers the same
14
+ * turn instead of hanging until a worker roll.
15
+ */
16
+ export declare const DEFAULT_MODEL_STREAM_IDLE_TIMEOUT_MS = 300000;
17
+ /**
18
+ * Default maximum wait across keepalive-only traffic (SSE comments, `ping` /
19
+ * `keepalive` events, repeated `response.in_progress`) for the next
20
+ * model-progress event on a generic model stream. A provider can keep a
21
+ * connection alive while its generation is wedged; this bounds that case.
22
+ * Ten minutes leaves room for a reasoning model's longest silent thinking
23
+ * window (reasoning summaries stream as progress).
24
+ */
25
+ export declare const DEFAULT_MODEL_STREAM_PROGRESS_TIMEOUT_MS = 600000;
6
26
  export declare const DEFAULT_OPENROUTER_MODEL_ID: "openrouter/nvidia/nemotron-3-super-120b-a12b:free";
7
27
  export declare const DEFAULT_MODEL_COST_POLICY_JSON: string;
8
28
  export declare const SANDBOX_ARCHIVE_CAPTURE_MAX_TIMEOUT_MS: number;
@@ -89,6 +109,7 @@ declare const SettingsSchema: z.ZodObject<{
89
109
  deploymentRevision: z.ZodDefault<z.ZodString>;
90
110
  serverVersion: z.ZodOptional<z.ZodString>;
91
111
  databaseUrl: z.ZodDefault<z.ZodString>;
112
+ apiDatabasePoolMax: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
92
113
  dbSchema: z.ZodDefault<z.ZodString>;
93
114
  rlsStrategy: z.ZodDefault<z.ZodEnum<{
94
115
  force: "force";
@@ -130,6 +151,9 @@ declare const SettingsSchema: z.ZodObject<{
130
151
  analyticsPosthogProjectKey: z.ZodOptional<z.ZodString>;
131
152
  analyticsPosthogHost: z.ZodOptional<z.ZodString>;
132
153
  analyticsGa4MeasurementId: z.ZodOptional<z.ZodString>;
154
+ legalPrivacyPolicyUrl: z.ZodOptional<z.ZodString>;
155
+ legalTermsOfServiceUrl: z.ZodOptional<z.ZodString>;
156
+ supportEmail: z.ZodOptional<z.ZodString>;
133
157
  publicBaseUrl: z.ZodOptional<z.ZodString>;
134
158
  documentationUrl: z.ZodPreprocess<z.ZodDefault<z.ZodNullable<z.ZodURL>>>;
135
159
  mcpOauthEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
@@ -138,18 +162,27 @@ declare const SettingsSchema: z.ZodObject<{
138
162
  webBaseUrl: z.ZodOptional<z.ZodString>;
139
163
  agentReleasesBaseUrl: z.ZodDefault<z.ZodString>;
140
164
  agentStableVersion: z.ZodDefault<z.ZodString>;
165
+ desktopStableVersion: z.ZodOptional<z.ZodString>;
141
166
  agentBetaVersion: z.ZodOptional<z.ZodString>;
167
+ agentAutoUpdate: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
142
168
  productAccessMode: z.ZodDefault<z.ZodEnum<{
143
169
  configured: "configured";
144
170
  local: "local";
145
171
  managed: "managed";
146
172
  }>>;
147
- organizationTenancyCanonicalActivationEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
148
173
  billingMode: z.ZodDefault<z.ZodEnum<{
149
174
  disabled: "disabled";
150
175
  stripe: "stripe";
151
176
  }>>;
152
177
  verifiedSignupTrialCreditsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
178
+ creditPromotionPolicy: z.ZodPreprocess<z.ZodDefault<z.ZodObject<{
179
+ defaultModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
180
+ signupModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
181
+ offers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
182
+ label: z.ZodString;
183
+ eligibleModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
184
+ }, z.core.$strict>>>;
185
+ }, z.core.$strict>>>;
153
186
  entitlementsMode: z.ZodDefault<z.ZodEnum<{
154
187
  managed: "managed";
155
188
  none: "none";
@@ -165,6 +198,9 @@ declare const SettingsSchema: z.ZodObject<{
165
198
  staticUsageLimitsJson: z.ZodDefault<z.ZodString>;
166
199
  delegationSecret: z.ZodOptional<z.ZodString>;
167
200
  defaultFirstPartyMcpTools: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
201
+ admin_action_call: "admin_action_call";
202
+ admin_action_describe: "admin_action_describe";
203
+ admin_actions_search: "admin_actions_search";
168
204
  artifacts_archive: "artifacts_archive";
169
205
  artifacts_create: "artifacts_create";
170
206
  artifacts_get_source: "artifacts_get_source";
@@ -180,6 +216,8 @@ declare const SettingsSchema: z.ZodObject<{
180
216
  browser_auth: "browser_auth";
181
217
  browser_clipboard: "browser_clipboard";
182
218
  browser_debug: "browser_debug";
219
+ browser_download_save: "browser_download_save";
220
+ browser_downloads: "browser_downloads";
183
221
  browser_identity: "browser_identity";
184
222
  browser_lifecycle: "browser_lifecycle";
185
223
  browser_observe: "browser_observe";
@@ -200,6 +238,7 @@ declare const SettingsSchema: z.ZodObject<{
200
238
  computer_observe: "computer_observe";
201
239
  computer_open: "computer_open";
202
240
  computer_targets: "computer_targets";
241
+ connected_machine_enable_screen_control: "connected_machine_enable_screen_control";
203
242
  connected_machine_enroll_token: "connected_machine_enroll_token";
204
243
  connected_machine_remove: "connected_machine_remove";
205
244
  custom_mcp_setup_request: "custom_mcp_setup_request";
@@ -231,6 +270,7 @@ declare const SettingsSchema: z.ZodObject<{
231
270
  goal_resume: "goal_resume";
232
271
  goal_set: "goal_set";
233
272
  goal_update: "goal_update";
273
+ inbox_tidy: "inbox_tidy";
234
274
  instruction_policy_get: "instruction_policy_get";
235
275
  instruction_policy_propose: "instruction_policy_propose";
236
276
  instruction_policy_save: "instruction_policy_save";
@@ -249,6 +289,8 @@ declare const SettingsSchema: z.ZodObject<{
249
289
  memory_correct: "memory_correct";
250
290
  memory_save: "memory_save";
251
291
  memory_search: "memory_search";
292
+ notification_withdraw: "notification_withdraw";
293
+ notify_user: "notify_user";
252
294
  preference_propose: "preference_propose";
253
295
  preference_registry_get: "preference_registry_get";
254
296
  preference_registry_summary: "preference_registry_summary";
@@ -286,20 +328,52 @@ declare const SettingsSchema: z.ZodObject<{
286
328
  scheduled_tasks_resume: "scheduled_tasks_resume";
287
329
  scheduled_tasks_trigger: "scheduled_tasks_trigger";
288
330
  scheduled_tasks_update: "scheduled_tasks_update";
331
+ secret_delete: "secret_delete";
332
+ secret_get: "secret_get";
333
+ secret_move: "secret_move";
334
+ secret_save: "secret_save";
335
+ secret_search: "secret_search";
289
336
  session_create: "session_create";
290
337
  session_events: "session_events";
291
338
  session_get: "session_get";
292
339
  session_human_input_respond: "session_human_input_respond";
340
+ session_message_status: "session_message_status";
293
341
  session_pause: "session_pause";
294
342
  session_resume: "session_resume";
295
343
  session_send_message: "session_send_message";
296
344
  session_set_model: "session_set_model";
297
345
  session_set_project: "session_set_project";
298
346
  session_steer: "session_steer";
347
+ session_target_get: "session_target_get";
348
+ session_target_set: "session_target_set";
299
349
  session_wait: "session_wait";
300
350
  sessions_list: "sessions_list";
301
351
  set_other_session_title: "set_other_session_title";
302
352
  set_session_title: "set_session_title";
353
+ site_data_define_collection: "site_data_define_collection";
354
+ site_data_describe: "site_data_describe";
355
+ site_data_export: "site_data_export";
356
+ site_data_import: "site_data_import";
357
+ site_data_query: "site_data_query";
358
+ site_data_reset: "site_data_reset";
359
+ site_data_write: "site_data_write";
360
+ site_files_delete: "site_files_delete";
361
+ site_files_list: "site_files_list";
362
+ site_files_upload: "site_files_upload";
363
+ site_hostname_check: "site_hostname_check";
364
+ site_publication_apply_fix: "site_publication_apply_fix";
365
+ site_publication_get: "site_publication_get";
366
+ site_publication_update: "site_publication_update";
367
+ site_sql_define_query: "site_sql_define_query";
368
+ site_sql_enable: "site_sql_enable";
369
+ site_sql_execute: "site_sql_execute";
370
+ site_sql_export: "site_sql_export";
371
+ site_sql_import: "site_sql_import";
372
+ site_sql_inspect: "site_sql_inspect";
373
+ site_sql_migrate: "site_sql_migrate";
374
+ site_sql_query: "site_sql_query";
375
+ site_sql_reset: "site_sql_reset";
376
+ site_sql_run: "site_sql_run";
303
377
  slack_bot_channel_history: "slack_bot_channel_history";
304
378
  slack_bot_delete_message: "slack_bot_delete_message";
305
379
  slack_bot_file_content: "slack_bot_file_content";
@@ -342,6 +416,9 @@ declare const SettingsSchema: z.ZodObject<{
342
416
  x_thread_fetch: "x_thread_fetch";
343
417
  }>>>>;
344
418
  allowedFirstPartyMcpTools: z.ZodPreprocess<z.ZodOptional<z.ZodArray<z.ZodEnum<{
419
+ admin_action_call: "admin_action_call";
420
+ admin_action_describe: "admin_action_describe";
421
+ admin_actions_search: "admin_actions_search";
345
422
  artifacts_archive: "artifacts_archive";
346
423
  artifacts_create: "artifacts_create";
347
424
  artifacts_get_source: "artifacts_get_source";
@@ -357,6 +434,8 @@ declare const SettingsSchema: z.ZodObject<{
357
434
  browser_auth: "browser_auth";
358
435
  browser_clipboard: "browser_clipboard";
359
436
  browser_debug: "browser_debug";
437
+ browser_download_save: "browser_download_save";
438
+ browser_downloads: "browser_downloads";
360
439
  browser_identity: "browser_identity";
361
440
  browser_lifecycle: "browser_lifecycle";
362
441
  browser_observe: "browser_observe";
@@ -377,6 +456,7 @@ declare const SettingsSchema: z.ZodObject<{
377
456
  computer_observe: "computer_observe";
378
457
  computer_open: "computer_open";
379
458
  computer_targets: "computer_targets";
459
+ connected_machine_enable_screen_control: "connected_machine_enable_screen_control";
380
460
  connected_machine_enroll_token: "connected_machine_enroll_token";
381
461
  connected_machine_remove: "connected_machine_remove";
382
462
  custom_mcp_setup_request: "custom_mcp_setup_request";
@@ -408,6 +488,7 @@ declare const SettingsSchema: z.ZodObject<{
408
488
  goal_resume: "goal_resume";
409
489
  goal_set: "goal_set";
410
490
  goal_update: "goal_update";
491
+ inbox_tidy: "inbox_tidy";
411
492
  instruction_policy_get: "instruction_policy_get";
412
493
  instruction_policy_propose: "instruction_policy_propose";
413
494
  instruction_policy_save: "instruction_policy_save";
@@ -426,6 +507,8 @@ declare const SettingsSchema: z.ZodObject<{
426
507
  memory_correct: "memory_correct";
427
508
  memory_save: "memory_save";
428
509
  memory_search: "memory_search";
510
+ notification_withdraw: "notification_withdraw";
511
+ notify_user: "notify_user";
429
512
  preference_propose: "preference_propose";
430
513
  preference_registry_get: "preference_registry_get";
431
514
  preference_registry_summary: "preference_registry_summary";
@@ -463,20 +546,52 @@ declare const SettingsSchema: z.ZodObject<{
463
546
  scheduled_tasks_resume: "scheduled_tasks_resume";
464
547
  scheduled_tasks_trigger: "scheduled_tasks_trigger";
465
548
  scheduled_tasks_update: "scheduled_tasks_update";
549
+ secret_delete: "secret_delete";
550
+ secret_get: "secret_get";
551
+ secret_move: "secret_move";
552
+ secret_save: "secret_save";
553
+ secret_search: "secret_search";
466
554
  session_create: "session_create";
467
555
  session_events: "session_events";
468
556
  session_get: "session_get";
469
557
  session_human_input_respond: "session_human_input_respond";
558
+ session_message_status: "session_message_status";
470
559
  session_pause: "session_pause";
471
560
  session_resume: "session_resume";
472
561
  session_send_message: "session_send_message";
473
562
  session_set_model: "session_set_model";
474
563
  session_set_project: "session_set_project";
475
564
  session_steer: "session_steer";
565
+ session_target_get: "session_target_get";
566
+ session_target_set: "session_target_set";
476
567
  session_wait: "session_wait";
477
568
  sessions_list: "sessions_list";
478
569
  set_other_session_title: "set_other_session_title";
479
570
  set_session_title: "set_session_title";
571
+ site_data_define_collection: "site_data_define_collection";
572
+ site_data_describe: "site_data_describe";
573
+ site_data_export: "site_data_export";
574
+ site_data_import: "site_data_import";
575
+ site_data_query: "site_data_query";
576
+ site_data_reset: "site_data_reset";
577
+ site_data_write: "site_data_write";
578
+ site_files_delete: "site_files_delete";
579
+ site_files_list: "site_files_list";
580
+ site_files_upload: "site_files_upload";
581
+ site_hostname_check: "site_hostname_check";
582
+ site_publication_apply_fix: "site_publication_apply_fix";
583
+ site_publication_get: "site_publication_get";
584
+ site_publication_update: "site_publication_update";
585
+ site_sql_define_query: "site_sql_define_query";
586
+ site_sql_enable: "site_sql_enable";
587
+ site_sql_execute: "site_sql_execute";
588
+ site_sql_export: "site_sql_export";
589
+ site_sql_import: "site_sql_import";
590
+ site_sql_inspect: "site_sql_inspect";
591
+ site_sql_migrate: "site_sql_migrate";
592
+ site_sql_query: "site_sql_query";
593
+ site_sql_reset: "site_sql_reset";
594
+ site_sql_run: "site_sql_run";
480
595
  slack_bot_channel_history: "slack_bot_channel_history";
481
596
  slack_bot_delete_message: "slack_bot_delete_message";
482
597
  slack_bot_file_content: "slack_bot_file_content";
@@ -518,6 +633,7 @@ declare const SettingsSchema: z.ZodObject<{
518
633
  x_search_live: "x_search_live";
519
634
  x_thread_fetch: "x_thread_fetch";
520
635
  }>>>>;
636
+ artifactMaterializerDeployed: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
521
637
  streamTokenSecret: z.ZodOptional<z.ZodString>;
522
638
  streamControlEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
523
639
  workDiscoveryEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
@@ -526,17 +642,28 @@ declare const SettingsSchema: z.ZodObject<{
526
642
  workDiscoveryAutomaticNudgesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
527
643
  ogtoolPackageSpec: z.ZodOptional<z.ZodString>;
528
644
  environmentsEncryptionKey: z.ZodOptional<z.ZodString>;
645
+ onePasswordFakeTokens: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
646
+ protonPassCliPath: z.ZodOptional<z.ZodString>;
529
647
  integrationsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
530
648
  integrationsStateSecret: z.ZodOptional<z.ZodString>;
531
- integrationsOauthShortStateEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
532
649
  integrationsAllowPrivateNetworkTargets: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
650
+ privacyOnlyMeAllowed: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
651
+ privacyWorkspaceDefaultRequired: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
652
+ privacyAdminScheduleSummariesRequired: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
533
653
  integrationsOauthClientsJson: z.ZodDefault<z.ZodString>;
654
+ gmailWatchTopicName: z.ZodOptional<z.ZodString>;
534
655
  slackClientId: z.ZodOptional<z.ZodString>;
535
656
  slackClientSecret: z.ZodOptional<z.ZodString>;
536
657
  slackSigningSecret: z.ZodOptional<z.ZodString>;
658
+ slackAccessMode: z.ZodDefault<z.ZodEnum<{
659
+ full: "full";
660
+ limited: "limited";
661
+ }>>;
537
662
  slackBotDisplayName: z.ZodDefault<z.ZodEnum<{
538
663
  OpenGeni: "OpenGeni";
539
664
  "OpenGeni Staging": "OpenGeni Staging";
665
+ Opengeni: "Opengeni";
666
+ "Opengeni Staging": "Opengeni Staging";
540
667
  }>>;
541
668
  slackCommand: z.ZodDefault<z.ZodString>;
542
669
  googleDriveClientId: z.ZodOptional<z.ZodString>;
@@ -563,6 +690,7 @@ declare const SettingsSchema: z.ZodObject<{
563
690
  goalIdleBackoffMs: z.ZodDefault<z.ZodPreprocess<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>>;
564
691
  goalIdleBackoffMaxMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
565
692
  childLifecycleNoticesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
693
+ sessionUsageLimitsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
566
694
  slackWorkspaceRoutingEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
567
695
  agentMaxModelCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
568
696
  contextWindowTokens: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -608,6 +736,8 @@ declare const SettingsSchema: z.ZodObject<{
608
736
  voiceInputResumableMaxDurationSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
609
737
  voiceInputResumableMaxSizeBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
610
738
  voiceInputResumableMaxChunkSizeBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
739
+ sessionArchiveEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
740
+ sessionArchiveIdleDays: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
611
741
  voiceInputResumableRetentionSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
612
742
  voiceInputFfmpegPath: z.ZodDefault<z.ZodString>;
613
743
  voiceInputProviderOrder: z.ZodDefault<z.ZodString>;
@@ -621,7 +751,22 @@ declare const SettingsSchema: z.ZodObject<{
621
751
  voiceInputAzureApiVersion: z.ZodOptional<z.ZodString>;
622
752
  voiceInputAzureApiKey: z.ZodOptional<z.ZodString>;
623
753
  voiceInputAzureAdToken: z.ZodOptional<z.ZodString>;
754
+ azureLiveEndpoint: z.ZodOptional<z.ZodString>;
755
+ azureLiveApiKey: z.ZodOptional<z.ZodString>;
756
+ azureLiveDeployment: z.ZodDefault<z.ZodString>;
757
+ azureLiveVoice: z.ZodDefault<z.ZodString>;
758
+ azureLivePricingJson: z.ZodOptional<z.ZodString>;
759
+ aiGatewayRealtimePricingJson: z.ZodOptional<z.ZodString>;
760
+ voiceInputMaiEndpoint: z.ZodOptional<z.ZodString>;
761
+ voiceInputMaiApiKey: z.ZodOptional<z.ZodString>;
762
+ voiceInputMaiApiVersion: z.ZodDefault<z.ZodString>;
763
+ voiceInputMaiPricingJson: z.ZodOptional<z.ZodString>;
764
+ voiceInputMaiModel: z.ZodDefault<z.ZodString>;
765
+ voiceInputAzureModel: z.ZodOptional<z.ZodString>;
766
+ voiceInputOpenaiPricingJson: z.ZodOptional<z.ZodString>;
767
+ voiceInputAzurePricingJson: z.ZodOptional<z.ZodString>;
624
768
  voiceInputCodexExperimentalEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
769
+ creditMarginBpsOverride: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
625
770
  modelPricingJson: z.ZodDefault<z.ZodString>;
626
771
  modelCatalogSource: z.ZodDefault<z.ZodEnum<{
627
772
  code: "code";
@@ -630,19 +775,31 @@ declare const SettingsSchema: z.ZodObject<{
630
775
  modelCostPolicyJson: z.ZodDefault<z.ZodString>;
631
776
  modelNotesJson: z.ZodDefault<z.ZodString>;
632
777
  openrouterApiKey: z.ZodOptional<z.ZodString>;
778
+ opperApiKey: z.ZodOptional<z.ZodString>;
779
+ managedModelsJson: z.ZodOptional<z.ZodString>;
633
780
  resolvedGatewayModelsJson: z.ZodOptional<z.ZodString>;
634
781
  resolvedOpenRouterModelsJson: z.ZodOptional<z.ZodString>;
782
+ resolvedOpperModelsJson: z.ZodOptional<z.ZodString>;
635
783
  resolvedCodexModelsJson: z.ZodOptional<z.ZodString>;
636
784
  modelProvidersJson: z.ZodDefault<z.ZodString>;
637
785
  codexSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
786
+ experimentSystemPromptCacheSplit: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
787
+ experimentCutPolling: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
788
+ experimentOutputCost: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
638
789
  supergrokSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
639
790
  claudeSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
640
791
  supergrokResponseStreamIdleTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
792
+ modelStreamIdleTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
793
+ modelStreamProgressTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
641
794
  codexConnectedAppsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
642
795
  codexProductSku: z.ZodOptional<z.ZodString>;
643
796
  codexToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
797
+ codexResponsesWebSocketEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
644
798
  lazyToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
645
799
  codexFleetPolicyShadowEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
800
+ subscriptionCoreShadowEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
801
+ subscriptionCrossProviderFailoverEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
802
+ subscriptionCoreShadowTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
646
803
  codexRotationNearExhaustionPct: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
647
804
  reasoningConfigurationUpdatesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
648
805
  openaiReasoningEffort: z.ZodDefault<z.ZodEnum<{
@@ -676,8 +833,20 @@ declare const SettingsSchema: z.ZodObject<{
676
833
  openaiReasoningEncryptedContent: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
677
834
  openaiMaxRetries: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
678
835
  webSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
679
- agentConfigAdmissionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
680
- agentConfigDefaultForNewSessions: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
836
+ webSearchProvider: z.ZodOptional<z.ZodString>;
837
+ webFetchProvider: z.ZodOptional<z.ZodString>;
838
+ webSearchPrefer: z.ZodOptional<z.ZodString>;
839
+ webSearchProviderCredentials: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
840
+ apiKey: z.ZodOptional<z.ZodString>;
841
+ baseUrl: z.ZodOptional<z.ZodString>;
842
+ }, z.core.$strict>>>;
843
+ webSearchApiKey: z.ZodOptional<z.ZodString>;
844
+ webSearchBaseUrl: z.ZodOptional<z.ZodString>;
845
+ webFetchApiKey: z.ZodOptional<z.ZodString>;
846
+ webFetchBaseUrl: z.ZodOptional<z.ZodString>;
847
+ webSearchProviderMode: z.ZodOptional<z.ZodString>;
848
+ webSearchPricingJson: z.ZodOptional<z.ZodString>;
849
+ webSearchRequestTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
681
850
  jevApiKey: z.ZodOptional<z.ZodString>;
682
851
  jevBaseUrl: z.ZodDefault<z.ZodString>;
683
852
  jevModel: z.ZodDefault<z.ZodString>;
@@ -689,6 +858,7 @@ declare const SettingsSchema: z.ZodObject<{
689
858
  opt_in: "opt_in";
690
859
  }>>;
691
860
  agentInstructionsTemplate: z.ZodDefault<z.ZodString>;
861
+ experimentKnowledgeRetrievalGuidance: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
692
862
  azureOpenaiBaseUrl: z.ZodOptional<z.ZodString>;
693
863
  azureOpenaiEndpoint: z.ZodOptional<z.ZodString>;
694
864
  azureOpenaiDeployment: z.ZodOptional<z.ZodString>;
@@ -825,6 +995,7 @@ declare const SettingsSchema: z.ZodObject<{
825
995
  sandboxViewerHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
826
996
  sandboxInteractionHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
827
997
  sandboxIdleGraceMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
998
+ sandboxIdleCommandContainmentMs: z.ZodPipe<z.ZodOptional<z.ZodCoercedNumber<unknown>>, z.ZodTransform<number | undefined, number | undefined>>;
828
999
  sandboxSnapshotIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
829
1000
  sandboxSnapshotTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
830
1001
  sandboxDrainSnapshotTimeoutMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -884,6 +1055,80 @@ declare const SettingsSchema: z.ZodObject<{
884
1055
  shadow: "shadow";
885
1056
  usage_only: "usage_only";
886
1057
  }>>;
1058
+ sitesCloudflareStorageEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1059
+ sitesGatewayInternalOrigin: z.ZodOptional<z.ZodString>;
1060
+ sitesSqlFreeStorageBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1061
+ sitesSqlFreeRowsReadPerMonth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1062
+ sitesSqlFreeRowsWrittenPerMonth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1063
+ sitesSqlFreeCallsPerMinutePerViewer: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1064
+ sitesSqlFreeCallsPerMinutePerSite: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1065
+ sitesSqlMaxRowsPerCall: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1066
+ sitesSqlMaxResponseBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1067
+ sitesSqlTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1068
+ siteDataRecordBytesPerSite: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1069
+ siteDataMaxRecordBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1070
+ siteDataMaxCollectionsPerSite: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1071
+ siteDataFileBytesPerSite: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1072
+ siteDataMaxFileBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1073
+ siteDataWorkspaceBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1074
+ siteDataViewerWritesPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1075
+ siteDataSiteWritesPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1076
+ siteDataViewerReadsPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1077
+ siteDataManagerWritesPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1078
+ siteDataSiteValidationMsPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1079
+ siteDataWorkspaceValidationMsPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1080
+ siteDataMaxRecordsPerCollection: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1081
+ sitesDomain: z.ZodOptional<z.ZodString>;
1082
+ sitesGatewaySecret: z.ZodOptional<z.ZodString>;
1083
+ sitesGatewaySecretPrevious: z.ZodOptional<z.ZodString>;
1084
+ sitesPublicEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1085
+ sitesPublicAgentsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1086
+ sitesLoginOnly: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1087
+ sitesForceNoindex: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1088
+ sitesAbuseEmail: z.ZodOptional<z.ZodString>;
1089
+ sitesGuestAgentHumanCheck: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1090
+ sitesFreeRequestsPerMinutePerVisitor: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1091
+ sitesFreeGuestWritesPerMinute: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1092
+ sitesFreeConversationsPerVisitorPerDay: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1093
+ sitesFreeConversationsPerSitePerDay: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1094
+ sitesFreeTurnsPerConversation: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1095
+ sitesFreeAgentMicrosPerConversation: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1096
+ sitesFreeAgentMicrosPerVisitorPerDay: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1097
+ sitesFreeAgentMicrosPerSitePerMonth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1098
+ sitesAgentMicrosPerSitePerMonth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1099
+ sitesAgentMicrosPerPersonPerDay: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1100
+ sitesGuestConversationsPerVisitorPerDay: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1101
+ sitesGuestConversationsPerSitePerDay: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1102
+ sitesGuestTurnsPerConversation: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1103
+ sitesGuestAgentMicrosPerConversation: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
1104
+ sitesAgentReservationMicrosPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1105
+ sitesCreditsLimitMultiplier: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1106
+ sitesPlatformBillingMode: z.ZodDefault<z.ZodEnum<{
1107
+ credits: "credits";
1108
+ shadow: "shadow";
1109
+ usage_only: "usage_only";
1110
+ }>>;
1111
+ sitesPlatformOverageEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1112
+ sitesPlatformAllowanceRequests: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1113
+ sitesPlatformAllowanceSqlRowsRead: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1114
+ sitesPlatformAllowanceSqlRowsWritten: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1115
+ sitesPlatformAllowanceStorageBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1116
+ sitesPlatformPriceMicrosPerMillionRequests: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1117
+ sitesPlatformPriceMicrosPerMillionSqlRowsRead: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1118
+ sitesPlatformPriceMicrosPerMillionSqlRowsWritten: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1119
+ sitesPlatformPriceMicrosPerGbMonth: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1120
+ sitesPlatformMonthlyLimitUsd: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1121
+ sitesPlatformAlertPercent: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1122
+ sitesReportsPerMinutePerVisitor: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1123
+ sitesViewerSessionIdleSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1124
+ sitesViewerSessionAbsoluteSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1125
+ sitesHostnameHoldDays: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1126
+ sitesCloudflareApiToken: z.ZodOptional<z.ZodString>;
1127
+ sitesCloudflareAccountId: z.ZodOptional<z.ZodString>;
1128
+ sitesCloudflareKvNamespaceId: z.ZodOptional<z.ZodString>;
1129
+ sitesCloudflareZoneId: z.ZodOptional<z.ZodString>;
1130
+ sitesHostMapTtlSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
1131
+ sitesWebRiskApiKey: z.ZodOptional<z.ZodString>;
887
1132
  documentEmbeddingCreditsActivatedAt: z.ZodOptional<z.ZodISODateTime>;
888
1133
  documentEmbeddingRateMicrosPerMillionBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
889
1134
  documentCurationProvider: z.ZodDefault<z.ZodEnum<{
@@ -930,11 +1175,23 @@ declare const SettingsSchema: z.ZodObject<{
930
1175
  dual: "dual";
931
1176
  legacy: "legacy";
932
1177
  }>>;
1178
+ nativeAppSchemes: z.ZodDefault<z.ZodArray<z.ZodString>>;
1179
+ nativeAppIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
1180
+ apnsKeyId: z.ZodOptional<z.ZodString>;
1181
+ apnsTeamId: z.ZodOptional<z.ZodString>;
1182
+ apnsPrivateKey: z.ZodOptional<z.ZodString>;
1183
+ fcmServiceAccountJson: z.ZodOptional<z.ZodString>;
1184
+ managedAuthNewSignupsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1185
+ managedAuthRequireEmailVerification: z.ZodOptional<z.ZodPreprocess<z.ZodBoolean>>;
933
1186
  organizationUserSetupEmailTokenTransport: z.ZodDefault<z.ZodEnum<{
934
1187
  fragment: "fragment";
935
1188
  query: "query";
936
1189
  }>>;
937
1190
  organizationUserSetupQueryEdgeSanitizationConfirmed: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1191
+ managedEmailDelivery: z.ZodDefault<z.ZodEnum<{
1192
+ disabled: "disabled";
1193
+ resend: "resend";
1194
+ }>>;
938
1195
  resendApiKey: z.ZodOptional<z.ZodString>;
939
1196
  emailFrom: z.ZodDefault<z.ZodString>;
940
1197
  stripeSecretKey: z.ZodOptional<z.ZodString>;
@@ -947,6 +1204,7 @@ declare const SettingsSchema: z.ZodObject<{
947
1204
  url: z.ZodString;
948
1205
  allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
949
1206
  timeoutMs: z.ZodOptional<z.ZodNumber>;
1207
+ setupTimeoutMs: z.ZodOptional<z.ZodNumber>;
950
1208
  cacheToolsList: z.ZodDefault<z.ZodBoolean>;
951
1209
  requireApproval: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>]>>;
952
1210
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -1097,13 +1355,23 @@ export declare function googleDriveOAuthCallbackUrl(publicBaseUrl: string | unde
1097
1355
  /** Exact callback registered on the environment-specific personal GitHub OAuth App. */
1098
1356
  export declare function personalGitHubOAuthCallbackUrl(publicBaseUrl: string | undefined): string | null;
1099
1357
  /** Declarative voice-input transcription provider ids. */
1100
- export type VoiceInputProviderId = "openai" | "azure-openai" | "codex-subscription" | "supergrok-subscription";
1358
+ export type VoiceInputProviderId = "openai" | "azure-openai" | "azure-mai" | "codex-subscription" | "supergrok-subscription";
1101
1359
  export type VoiceInputProviderConfig = {
1360
+ id: "azure-mai";
1361
+ kind: "azure-mai";
1362
+ pricing: VoiceInputPricing | null;
1363
+ endpoint: string;
1364
+ apiKey: string;
1365
+ apiVersion: string;
1366
+ model: string;
1367
+ } | {
1102
1368
  id: "openai";
1103
1369
  kind: "openai";
1104
1370
  apiKey: string;
1105
1371
  baseUrl: string;
1106
1372
  model: string;
1373
+ /** Deployment-funded: Opengeni pays upstream and charges credits. */
1374
+ pricing: VoiceInputPricing | null;
1107
1375
  } | {
1108
1376
  id: "azure-openai";
1109
1377
  kind: "azure-openai";
@@ -1112,6 +1380,10 @@ export type VoiceInputProviderConfig = {
1112
1380
  apiVersion: string;
1113
1381
  apiKey: string | null;
1114
1382
  adToken: string | null;
1383
+ /** Underlying model (pricing + response shape); defaults to the deployment name. */
1384
+ model: string;
1385
+ /** Deployment-funded: Opengeni pays upstream and charges credits. */
1386
+ pricing: VoiceInputPricing | null;
1115
1387
  } | {
1116
1388
  id: "codex-subscription";
1117
1389
  kind: "codex-subscription";
@@ -1123,11 +1395,8 @@ export type VoiceInputProviderConfig = {
1123
1395
  };
1124
1396
  /** The deployment's Jev key, or undefined when it is missing or a placeholder. */
1125
1397
  export declare function usableJevApiKey(settings: Pick<Settings, "jevApiKey">): string | undefined;
1126
- /** Deployment half of agent configuration: rollout switches plus hard capability limits. */
1127
- export declare function agentConfigDeploymentPolicy(settings: Pick<Settings, "agentConfigAdmissionEnabled" | "agentConfigDefaultForNewSessions" | "webSearchEnabled" | "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">): AgentConfigDeploymentLimits & {
1128
- admissionEnabled: boolean;
1129
- defaultForNewSessions: boolean;
1130
- };
1398
+ /** Deployment half of agent configuration: hard capability limits. */
1399
+ export declare function agentConfigDeploymentPolicy(settings: FirstPartyMcpToolPolicySettings & Pick<Settings, "webSearchEnabled">): AgentConfigDeploymentLimits;
1131
1400
  /**
1132
1401
  * Deployment half of the `code_search` decision. `available` is false when
1133
1402
  * the mode is off or no usable Jev key is configured; workspaces then cannot
@@ -1146,6 +1415,93 @@ export declare function isUsableVoiceInputSecret(value: string | null | undefine
1146
1415
  * whether at least one non-experimental (or probed experimental) provider exists.
1147
1416
  */
1148
1417
  export declare function resolveVoiceInputProviderRegistry(settings: Settings): VoiceInputProviderConfig[];
1418
+ /** Why a credentialed deployment-funded voice provider is withheld. */
1419
+ export type VoiceInputPricingIssue = {
1420
+ providerId: "openai" | "azure-openai" | "azure-mai";
1421
+ env: string;
1422
+ reason: "malformed" | "unpriced";
1423
+ message: string;
1424
+ };
1425
+ /**
1426
+ * Pricing problems that withhold a credentialed deployment-funded provider.
1427
+ * A malformed PRICING_JSON never fails boot (workers share this config and
1428
+ * must not crash-loop over a voice-only setting); the API logs each issue
1429
+ * once at startup and the provider stays unavailable.
1430
+ */
1431
+ export declare function voiceInputPricingIssues(settings: Settings): VoiceInputPricingIssue[];
1432
+ /**
1433
+ * Opengeni credit price for one deployment-funded transcription provider.
1434
+ * Rates are upstream list prices in integer USD micros; `marginBps` (500 =
1435
+ * +5%) is added on top, exactly like model pricing. `microsPerMinute` prices
1436
+ * provider-reported audio duration (Whisper, `usage.type: "duration"`) and is
1437
+ * a server-measured WAV duration when provider usage is absent. Token
1438
+ * rates price `usage.type: "tokens"` (gpt-4o-transcribe family); `input`
1439
+ * covers text input tokens and, unless `audioInput` is set, audio tokens.
1440
+ */
1441
+ export type VoiceInputPricing = {
1442
+ microsPerMinute: number;
1443
+ inputMicrosPerMillionTokens?: number | undefined;
1444
+ audioInputMicrosPerMillionTokens?: number | undefined;
1445
+ outputMicrosPerMillionTokens?: number | undefined;
1446
+ marginBps?: number | undefined;
1447
+ };
1448
+ /**
1449
+ * Built-in list prices (OpenAI API pricing, "Transcription models" table)
1450
+ * plus the default 5% Opengeni margin used for model pricing. Azure Global
1451
+ * Standard deployments use the same list prices; set the provider
1452
+ * PRICING_JSON when a deployment's contracted or regional price differs.
1453
+ */
1454
+ export declare const defaultVoiceInputPricing: Readonly<Record<string, VoiceInputPricing>>;
1455
+ /** Lowercased model with a dated snapshot suffix (`-2025-03-20`) removed. */
1456
+ export declare function canonicalVoiceInputModel(model: string): string;
1457
+ /** Whisper reports its billed audio duration only in `verbose_json`. */
1458
+ export declare function voiceInputModelReportsDurationOnly(model: string): boolean;
1459
+ /** Parse one provider pricing JSON. Throws a configuration error when malformed. */
1460
+ export declare function parseVoiceInputPricingJson(raw: string | undefined, env?: string): VoiceInputPricing | null;
1461
+ /** Explicit provider pricing JSON wins; otherwise the built-in list price for the model. */
1462
+ export declare function resolveVoiceInputPricing(raw: string | undefined, model: string): VoiceInputPricing | null;
1463
+ /** Non-throwing {@link resolveVoiceInputPricing} for registry resolution. */
1464
+ export declare function safeResolveVoiceInputPricing(raw: string | undefined, model: string, env?: string): {
1465
+ ok: true;
1466
+ pricing: VoiceInputPricing | null;
1467
+ } | {
1468
+ ok: false;
1469
+ error: string;
1470
+ };
1471
+ /** Same predicate as model/credit limits: credit balance and debits are enforced. */
1472
+ export declare function voiceInputCreditBillingActive(settings: Pick<Settings, "billingMode" | "usageLimitsMode">): boolean;
1473
+ /** Provider-reported transcription usage, normalized. Never client-reported. */
1474
+ export type VoiceInputUsage = {
1475
+ kind: "tokens";
1476
+ inputTokens: number;
1477
+ audioInputTokens: number;
1478
+ textInputTokens: number;
1479
+ outputTokens: number;
1480
+ } | {
1481
+ kind: "duration";
1482
+ seconds: number;
1483
+ };
1484
+ export type VoiceInputCost = {
1485
+ /** Upstream list cost before margin, rounded up to whole micros. */
1486
+ providerCostMicros: number;
1487
+ /** Opengeni credit price after margin, rounded up to whole micros. */
1488
+ creditCostMicros: number;
1489
+ };
1490
+ /** True when token usage can be priced exactly. */
1491
+ export declare function voiceInputPricingHasTokenRates(pricing: VoiceInputPricing): boolean;
1492
+ /**
1493
+ * Exact integer credit math. Token usage needs token rates; duration usage
1494
+ * uses `microsPerMinute` at millisecond resolution. Both round up once, after
1495
+ * summing, so a positive use never becomes a free debit.
1496
+ */
1497
+ export declare function calculateVoiceInputCost(pricing: VoiceInputPricing, usage: VoiceInputUsage, marginBpsOverride?: number): VoiceInputCost;
1498
+ /**
1499
+ * Deployment-funded providers that have credentials but are withheld because
1500
+ * credit billing is active and no price is known. The API logs these (and
1501
+ * malformed pricing, see {@link voiceInputPricingIssues}) once at startup so
1502
+ * an operator sees why voice input stayed unavailable.
1503
+ */
1504
+ export declare function unpricedVoiceInputProviders(settings: Settings): VoiceInputProviderId[];
1149
1505
  /** True when the deployment has at least one supported (non-experimental) provider. */
1150
1506
  export declare function voiceInputDeploymentConfigured(settings: Settings): boolean;
1151
1507
  export type TemporalTlsConnectionConfig = {
@@ -1183,11 +1539,29 @@ export type ModelUsageInput = {
1183
1539
  requestUsageEntries?: ModelUsageInput[] | undefined;
1184
1540
  };
1185
1541
  export type ModelUsageCostBreakdown = {
1186
- /** Provider-rate cost basis for the exact usage, before OpenGeni margin. */
1542
+ /** Provider-rate cost basis for the exact usage, before Opengeni margin. */
1187
1543
  providerCostMicros: number;
1188
- /** OpenGeni credit price after configured margin and latency-mode multiplier. */
1544
+ /** Opengeni credit price after configured margin and latency-mode multiplier. */
1189
1545
  creditCostMicros: number;
1190
1546
  };
1547
+ export type ModelListCostClassesMicros = {
1548
+ uncachedInput: number;
1549
+ cacheRead: number;
1550
+ cacheWrite: number;
1551
+ output: number;
1552
+ };
1553
+ export type ModelListUsageCostSnapshot = ModelUsageCostBreakdown & {
1554
+ /** Captured upstream list costs, summing to providerCostMicros, never debits. */
1555
+ listByClassMicros: ModelListCostClassesMicros | null;
1556
+ /** True only when a returned class split includes latency rounding allocation. */
1557
+ listByClassApprox: boolean;
1558
+ };
1559
+ export type ModelRecordedListCostAllocation = {
1560
+ /** Approximate attribution of a stored upstream total, never a new price. */
1561
+ listByClassMicros: ModelListCostClassesMicros | null;
1562
+ /** True for every eligible historical allocation, including known zero. */
1563
+ listByClassApprox: boolean;
1564
+ };
1191
1565
  export type StaticUsageLimitsConfig = StaticUsageLimits;
1192
1566
  export type EntitlementsConfig = Entitlements;
1193
1567
  export declare const CapabilitySupportV1: z.ZodEnum<{
@@ -1364,7 +1738,7 @@ export type CredentialSourceV1 = {
1364
1738
  mechanism: "api_key" | "azure_ad_bearer" | "none";
1365
1739
  } | {
1366
1740
  kind: "connected_subscription";
1367
- provider: "codex" | "xai";
1741
+ provider: "codex" | "xai" | "claude";
1368
1742
  } | {
1369
1743
  kind: "workspace_connection";
1370
1744
  mechanism: "api_key";
@@ -1413,8 +1787,12 @@ export declare const RegistryProviderKind: z.ZodEnum<{
1413
1787
  "claude-subscription-organization": "claude-subscription-organization";
1414
1788
  "claude-subscription-workspace": "claude-subscription-workspace";
1415
1789
  "codex-subscription": "codex-subscription";
1790
+ "direct-azure-workspace": "direct-azure-workspace";
1791
+ "direct-openai-workspace": "direct-openai-workspace";
1416
1792
  "openrouter-organization": "openrouter-organization";
1417
1793
  "openrouter-workspace": "openrouter-workspace";
1794
+ "opper-organization": "opper-organization";
1795
+ "opper-workspace": "opper-workspace";
1418
1796
  "vercel-gateway-managed": "vercel-gateway-managed";
1419
1797
  "vercel-gateway-organization": "vercel-gateway-organization";
1420
1798
  "vercel-gateway-workspace": "vercel-gateway-workspace";
@@ -1470,8 +1848,12 @@ declare const RegistryProviderSchema: z.ZodObject<{
1470
1848
  "claude-subscription-organization": "claude-subscription-organization";
1471
1849
  "claude-subscription-workspace": "claude-subscription-workspace";
1472
1850
  "codex-subscription": "codex-subscription";
1851
+ "direct-azure-workspace": "direct-azure-workspace";
1852
+ "direct-openai-workspace": "direct-openai-workspace";
1473
1853
  "openrouter-organization": "openrouter-organization";
1474
1854
  "openrouter-workspace": "openrouter-workspace";
1855
+ "opper-organization": "opper-organization";
1856
+ "opper-workspace": "opper-workspace";
1475
1857
  "vercel-gateway-managed": "vercel-gateway-managed";
1476
1858
  "vercel-gateway-organization": "vercel-gateway-organization";
1477
1859
  "vercel-gateway-workspace": "vercel-gateway-workspace";
@@ -1505,6 +1887,8 @@ declare const RegistryProviderSchema: z.ZodObject<{
1505
1887
  maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1506
1888
  streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1507
1889
  }, z.core.$strip>>;
1890
+ streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
1891
+ streamProgressTimeoutMs: z.ZodOptional<z.ZodNumber>;
1508
1892
  wireProfile: z.ZodDefault<z.ZodEnum<{
1509
1893
  "azure-openai": "azure-openai";
1510
1894
  openai: "openai";
@@ -1524,6 +1908,7 @@ declare const RegistryProviderSchema: z.ZodObject<{
1524
1908
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
1525
1909
  label: z.ZodOptional<z.ZodString>;
1526
1910
  shortLabel: z.ZodOptional<z.ZodString>;
1911
+ logoUrl: z.ZodOptional<z.ZodString>;
1527
1912
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
1528
1913
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
1529
1914
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -1715,6 +2100,14 @@ export declare const WORKSPACE_OPENROUTER_MODEL_ID_PREFIX: "workspace-openrouter
1715
2100
  export declare const ORGANIZATION_OPENROUTER_PROVIDER_ID: "organization-openrouter";
1716
2101
  export declare const ORGANIZATION_OPENROUTER_MODEL_ID_PREFIX: "organization-openrouter/";
1717
2102
  export declare const OPENROUTER_BASE_URL: "https://openrouter.ai/api/v1";
2103
+ export declare const OPPER_PROVIDER_ID: "opper";
2104
+ export declare const OPPER_MODEL_ID_PREFIX: "opper/";
2105
+ export declare const WORKSPACE_OPPER_PROVIDER_ID: "workspace-opper";
2106
+ export declare const WORKSPACE_OPPER_MODEL_ID_PREFIX: "workspace-opper/";
2107
+ export declare const ORGANIZATION_OPPER_PROVIDER_ID: "organization-opper";
2108
+ export declare const ORGANIZATION_OPPER_MODEL_ID_PREFIX: "organization-opper/";
2109
+ /** Opper's OpenAI-compatible Chat Completions surface (Bearer key). */
2110
+ export declare const OPPER_BASE_URL: "https://api.opper.ai/v3/compat";
1718
2111
  export declare const ModelCostClass: z.ZodEnum<{
1719
2112
  credits: "credits";
1720
2113
  free: "free";
@@ -1737,6 +2130,7 @@ export declare const GatewayCatalogModel: z.ZodObject<{
1737
2130
  upstreamModelId: z.ZodString;
1738
2131
  label: z.ZodString;
1739
2132
  shortLabel: z.ZodOptional<z.ZodString>;
2133
+ logoUrl: z.ZodOptional<z.ZodString>;
1740
2134
  providers: z.ZodArray<z.ZodString>;
1741
2135
  implicitCaching: z.ZodDefault<z.ZodBoolean>;
1742
2136
  vision: z.ZodDefault<z.ZodBoolean>;
@@ -1778,6 +2172,7 @@ export declare const OpenRouterCatalogModel: z.ZodObject<{
1778
2172
  upstreamModelId: z.ZodString;
1779
2173
  label: z.ZodString;
1780
2174
  shortLabel: z.ZodOptional<z.ZodString>;
2175
+ logoUrl: z.ZodOptional<z.ZodString>;
1781
2176
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
1782
2177
  capabilities: z.ZodObject<{
1783
2178
  reasoning: z.ZodObject<{
@@ -1932,6 +2327,196 @@ export declare const OpenRouterCatalogModel: z.ZodObject<{
1932
2327
  apiKey: z.ZodOptional<z.ZodNever>;
1933
2328
  }, z.core.$strict>;
1934
2329
  export type OpenRouterCatalogModel = z.infer<typeof OpenRouterCatalogModel>;
2330
+ /**
2331
+ * One reviewed Opper route. `upstreamModelId` is Opper's exact catalogue id:
2332
+ * a bare upstream name is a pool (Opper picks the serving provider), while a
2333
+ * `provider/model` id pins one route and region. Curated entries pin a route.
2334
+ * Code-defined entries may carry a reviewed price; database documents may not.
2335
+ */
2336
+ export declare const OpperCatalogModel: z.ZodObject<{
2337
+ upstreamModelId: z.ZodString;
2338
+ label: z.ZodString;
2339
+ shortLabel: z.ZodOptional<z.ZodString>;
2340
+ logoUrl: z.ZodOptional<z.ZodString>;
2341
+ aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
2342
+ capabilities: z.ZodObject<{
2343
+ reasoning: z.ZodObject<{
2344
+ upstream: z.ZodEnum<{
2345
+ supported: "supported";
2346
+ unknown: "unknown";
2347
+ unsupported: "unsupported";
2348
+ }>;
2349
+ runnable: z.ZodBoolean;
2350
+ efforts: z.ZodArray<z.ZodEnum<{
2351
+ high: "high";
2352
+ low: "low";
2353
+ max: "max";
2354
+ medium: "medium";
2355
+ minimal: "minimal";
2356
+ none: "none";
2357
+ xhigh: "xhigh";
2358
+ }>>;
2359
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
2360
+ high: "high";
2361
+ low: "low";
2362
+ max: "max";
2363
+ medium: "medium";
2364
+ minimal: "minimal";
2365
+ none: "none";
2366
+ xhigh: "xhigh";
2367
+ }>>;
2368
+ required: z.ZodBoolean;
2369
+ }, z.core.$strip>;
2370
+ functionCalling: z.ZodObject<{
2371
+ upstream: z.ZodEnum<{
2372
+ supported: "supported";
2373
+ unknown: "unknown";
2374
+ unsupported: "unsupported";
2375
+ }>;
2376
+ runnable: z.ZodBoolean;
2377
+ }, z.core.$strip>;
2378
+ structuredOutput: z.ZodObject<{
2379
+ upstream: z.ZodEnum<{
2380
+ supported: "supported";
2381
+ unknown: "unknown";
2382
+ unsupported: "unsupported";
2383
+ }>;
2384
+ runnable: z.ZodBoolean;
2385
+ }, z.core.$strip>;
2386
+ hostedTools: z.ZodObject<{
2387
+ webSearch: z.ZodObject<{
2388
+ upstream: z.ZodEnum<{
2389
+ supported: "supported";
2390
+ unknown: "unknown";
2391
+ unsupported: "unsupported";
2392
+ }>;
2393
+ runnable: z.ZodBoolean;
2394
+ }, z.core.$strip>;
2395
+ xSearch: z.ZodObject<{
2396
+ upstream: z.ZodEnum<{
2397
+ supported: "supported";
2398
+ unknown: "unknown";
2399
+ unsupported: "unsupported";
2400
+ }>;
2401
+ runnable: z.ZodBoolean;
2402
+ }, z.core.$strip>;
2403
+ codeExecution: z.ZodObject<{
2404
+ upstream: z.ZodEnum<{
2405
+ supported: "supported";
2406
+ unknown: "unknown";
2407
+ unsupported: "unsupported";
2408
+ }>;
2409
+ runnable: z.ZodBoolean;
2410
+ }, z.core.$strip>;
2411
+ imageGeneration: z.ZodDefault<z.ZodObject<{
2412
+ upstream: z.ZodEnum<{
2413
+ supported: "supported";
2414
+ unknown: "unknown";
2415
+ unsupported: "unsupported";
2416
+ }>;
2417
+ runnable: z.ZodBoolean;
2418
+ }, z.core.$strip>>;
2419
+ }, z.core.$strip>;
2420
+ inputModalities: z.ZodArray<z.ZodEnum<{
2421
+ audio: "audio";
2422
+ image: "image";
2423
+ text: "text";
2424
+ }>>;
2425
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
2426
+ outputModalities: z.ZodArray<z.ZodEnum<{
2427
+ audio: "audio";
2428
+ image: "image";
2429
+ text: "text";
2430
+ }>>;
2431
+ transports: z.ZodObject<{
2432
+ sse: z.ZodObject<{
2433
+ upstream: z.ZodEnum<{
2434
+ supported: "supported";
2435
+ unknown: "unknown";
2436
+ unsupported: "unsupported";
2437
+ }>;
2438
+ runnable: z.ZodBoolean;
2439
+ }, z.core.$strip>;
2440
+ responsesWebSocket: z.ZodObject<{
2441
+ upstream: z.ZodEnum<{
2442
+ supported: "supported";
2443
+ unknown: "unknown";
2444
+ unsupported: "unsupported";
2445
+ }>;
2446
+ runnable: z.ZodBoolean;
2447
+ }, z.core.$strip>;
2448
+ realtimeAudio: z.ZodObject<{
2449
+ upstream: z.ZodEnum<{
2450
+ supported: "supported";
2451
+ unknown: "unknown";
2452
+ unsupported: "unsupported";
2453
+ }>;
2454
+ runnable: z.ZodBoolean;
2455
+ }, z.core.$strip>;
2456
+ }, z.core.$strip>;
2457
+ promptCaching: z.ZodOptional<z.ZodObject<{
2458
+ upstream: z.ZodEnum<{
2459
+ supported: "supported";
2460
+ unknown: "unknown";
2461
+ unsupported: "unsupported";
2462
+ }>;
2463
+ runnable: z.ZodBoolean;
2464
+ mode: z.ZodEnum<{
2465
+ automatic: "automatic";
2466
+ implicit: "implicit";
2467
+ none: "none";
2468
+ }>;
2469
+ }, z.core.$strip>>;
2470
+ latencyModes: z.ZodArray<z.ZodObject<{
2471
+ id: z.ZodEnum<{
2472
+ fast: "fast";
2473
+ priority: "priority";
2474
+ standard: "standard";
2475
+ }>;
2476
+ upstream: z.ZodEnum<{
2477
+ supported: "supported";
2478
+ unknown: "unknown";
2479
+ unsupported: "unsupported";
2480
+ }>;
2481
+ runnable: z.ZodBoolean;
2482
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
2483
+ }, z.core.$strip>>;
2484
+ }, z.core.$strip>;
2485
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
2486
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
2487
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
2488
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
2489
+ maxOutputTokens: z.ZodOptional<z.ZodNumber>;
2490
+ pricing: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
2491
+ inputMicrosPerMillionTokens: z.ZodNumber;
2492
+ cachedInputMicrosPerMillionTokens: z.ZodOptional<z.ZodNumber>;
2493
+ cacheWriteMicrosPerMillionTokens: z.ZodOptional<z.ZodNumber>;
2494
+ outputMicrosPerMillionTokens: z.ZodNumber;
2495
+ marginBps: z.ZodOptional<z.ZodNumber>;
2496
+ }, z.core.$strip>, z.ZodObject<{
2497
+ default: z.ZodObject<{
2498
+ inputMicrosPerMillionTokens: z.ZodNumber;
2499
+ cachedInputMicrosPerMillionTokens: z.ZodOptional<z.ZodNumber>;
2500
+ cacheWriteMicrosPerMillionTokens: z.ZodOptional<z.ZodNumber>;
2501
+ outputMicrosPerMillionTokens: z.ZodNumber;
2502
+ marginBps: z.ZodOptional<z.ZodNumber>;
2503
+ }, z.core.$strip>;
2504
+ inputTokenTiers: z.ZodOptional<z.ZodArray<z.ZodObject<{
2505
+ minimumInputTokens: z.ZodNumber;
2506
+ pricing: z.ZodObject<{
2507
+ inputMicrosPerMillionTokens: z.ZodNumber;
2508
+ cachedInputMicrosPerMillionTokens: z.ZodOptional<z.ZodNumber>;
2509
+ cacheWriteMicrosPerMillionTokens: z.ZodOptional<z.ZodNumber>;
2510
+ outputMicrosPerMillionTokens: z.ZodNumber;
2511
+ marginBps: z.ZodOptional<z.ZodNumber>;
2512
+ }, z.core.$strip>;
2513
+ }, z.core.$strip>>>;
2514
+ }, z.core.$strip>]>>;
2515
+ credentialSource: z.ZodOptional<z.ZodNever>;
2516
+ billing: z.ZodOptional<z.ZodNever>;
2517
+ apiKey: z.ZodOptional<z.ZodNever>;
2518
+ }, z.core.$strict>;
2519
+ export type OpperCatalogModel = z.infer<typeof OpperCatalogModel>;
1935
2520
  export declare const ModelCatalogDocument: z.ZodObject<{
1936
2521
  schemaVersion: z.ZodLiteral<1>;
1937
2522
  defaultModel: z.ZodOptional<z.ZodString>;
@@ -1965,6 +2550,8 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1965
2550
  maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1966
2551
  streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1967
2552
  }, z.core.$strip>>;
2553
+ streamIdleTimeoutMs: z.ZodOptional<z.ZodNumber>;
2554
+ streamProgressTimeoutMs: z.ZodOptional<z.ZodNumber>;
1968
2555
  wireProfile: z.ZodDefault<z.ZodEnum<{
1969
2556
  "azure-openai": "azure-openai";
1970
2557
  openai: "openai";
@@ -1982,6 +2569,7 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1982
2569
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
1983
2570
  label: z.ZodOptional<z.ZodString>;
1984
2571
  shortLabel: z.ZodOptional<z.ZodString>;
2572
+ logoUrl: z.ZodOptional<z.ZodString>;
1985
2573
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
1986
2574
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
1987
2575
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -2142,10 +2730,11 @@ export declare const ModelCatalogDocument: z.ZodObject<{
2142
2730
  publicDefaultHeaderNames: z.ZodOptional<z.ZodNever>;
2143
2731
  publicDefaultQueryNames: z.ZodOptional<z.ZodNever>;
2144
2732
  }, z.core.$strict>>>;
2145
- codexModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
2733
+ codexModels: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
2146
2734
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
2147
2735
  label: z.ZodOptional<z.ZodString>;
2148
2736
  shortLabel: z.ZodOptional<z.ZodString>;
2737
+ logoUrl: z.ZodOptional<z.ZodString>;
2149
2738
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
2150
2739
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
2151
2740
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -2301,13 +2890,174 @@ export declare const ModelCatalogDocument: z.ZodObject<{
2301
2890
  }, z.core.$strip>>;
2302
2891
  }, z.core.$strip>;
2303
2892
  pricing: z.ZodOptional<z.ZodNever>;
2304
- }, z.core.$strict>>>;
2893
+ }, z.core.$strict>, z.ZodTransform<{
2894
+ aliases?: string[] | undefined;
2895
+ label?: string | undefined;
2896
+ shortLabel?: string | undefined;
2897
+ logoUrl?: string | undefined;
2898
+ contextWindowTokens?: number | undefined;
2899
+ effectiveContextWindowTokens?: number | undefined;
2900
+ autoCompactTokenLimit?: number | undefined;
2901
+ toolOutputTruncationTokens?: number | undefined;
2902
+ reasoningEffort?: boolean | undefined;
2903
+ hostedWebSearch?: boolean | undefined;
2904
+ credentialSource?: undefined;
2905
+ billing?: undefined;
2906
+ retired?: boolean | undefined;
2907
+ id: string;
2908
+ upstreamModelId: string;
2909
+ pricing?: undefined;
2910
+ capabilities: {
2911
+ reasoning: {
2912
+ upstream: "supported" | "unknown" | "unsupported";
2913
+ runnable: boolean;
2914
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2915
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2916
+ required: boolean;
2917
+ };
2918
+ functionCalling: {
2919
+ upstream: "supported" | "unknown" | "unsupported";
2920
+ runnable: boolean;
2921
+ };
2922
+ structuredOutput: {
2923
+ upstream: "supported" | "unknown" | "unsupported";
2924
+ runnable: boolean;
2925
+ };
2926
+ hostedTools: {
2927
+ webSearch: {
2928
+ upstream: "supported" | "unknown" | "unsupported";
2929
+ runnable: boolean;
2930
+ };
2931
+ xSearch: {
2932
+ upstream: "supported" | "unknown" | "unsupported";
2933
+ runnable: boolean;
2934
+ };
2935
+ codeExecution: {
2936
+ upstream: "supported" | "unknown" | "unsupported";
2937
+ runnable: boolean;
2938
+ };
2939
+ imageGeneration: {
2940
+ upstream: "supported" | "unknown" | "unsupported";
2941
+ runnable: boolean;
2942
+ };
2943
+ };
2944
+ inputModalities: ("audio" | "image" | "text")[];
2945
+ inputFileMediaTypes: string[];
2946
+ outputModalities: ("audio" | "image" | "text")[];
2947
+ transports: {
2948
+ sse: {
2949
+ upstream: "supported" | "unknown" | "unsupported";
2950
+ runnable: boolean;
2951
+ };
2952
+ responsesWebSocket: {
2953
+ upstream: "supported" | "unknown" | "unsupported";
2954
+ runnable: boolean;
2955
+ };
2956
+ realtimeAudio: {
2957
+ upstream: "supported" | "unknown" | "unsupported";
2958
+ runnable: boolean;
2959
+ };
2960
+ };
2961
+ promptCaching?: {
2962
+ upstream: "supported" | "unknown" | "unsupported";
2963
+ runnable: boolean;
2964
+ mode: "automatic" | "implicit" | "none";
2965
+ } | undefined;
2966
+ latencyModes: {
2967
+ id: "fast" | "priority" | "standard";
2968
+ upstream: "supported" | "unknown" | "unsupported";
2969
+ runnable: boolean;
2970
+ billingMultiplierBps?: number | undefined;
2971
+ }[];
2972
+ };
2973
+ }, {
2974
+ aliases?: string[] | undefined;
2975
+ label?: string | undefined;
2976
+ shortLabel?: string | undefined;
2977
+ logoUrl?: string | undefined;
2978
+ contextWindowTokens?: number | undefined;
2979
+ effectiveContextWindowTokens?: number | undefined;
2980
+ autoCompactTokenLimit?: number | undefined;
2981
+ toolOutputTruncationTokens?: number | undefined;
2982
+ reasoningEffort?: boolean | undefined;
2983
+ hostedWebSearch?: boolean | undefined;
2984
+ credentialSource?: undefined;
2985
+ billing?: undefined;
2986
+ retired?: boolean | undefined;
2987
+ id: string;
2988
+ upstreamModelId: string;
2989
+ capabilities: {
2990
+ reasoning: {
2991
+ upstream: "supported" | "unknown" | "unsupported";
2992
+ runnable: boolean;
2993
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2994
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2995
+ required: boolean;
2996
+ };
2997
+ functionCalling: {
2998
+ upstream: "supported" | "unknown" | "unsupported";
2999
+ runnable: boolean;
3000
+ };
3001
+ structuredOutput: {
3002
+ upstream: "supported" | "unknown" | "unsupported";
3003
+ runnable: boolean;
3004
+ };
3005
+ hostedTools: {
3006
+ webSearch: {
3007
+ upstream: "supported" | "unknown" | "unsupported";
3008
+ runnable: boolean;
3009
+ };
3010
+ xSearch: {
3011
+ upstream: "supported" | "unknown" | "unsupported";
3012
+ runnable: boolean;
3013
+ };
3014
+ codeExecution: {
3015
+ upstream: "supported" | "unknown" | "unsupported";
3016
+ runnable: boolean;
3017
+ };
3018
+ imageGeneration: {
3019
+ upstream: "supported" | "unknown" | "unsupported";
3020
+ runnable: boolean;
3021
+ };
3022
+ };
3023
+ inputModalities: ("audio" | "image" | "text")[];
3024
+ inputFileMediaTypes: string[];
3025
+ outputModalities: ("audio" | "image" | "text")[];
3026
+ transports: {
3027
+ sse: {
3028
+ upstream: "supported" | "unknown" | "unsupported";
3029
+ runnable: boolean;
3030
+ };
3031
+ responsesWebSocket: {
3032
+ upstream: "supported" | "unknown" | "unsupported";
3033
+ runnable: boolean;
3034
+ };
3035
+ realtimeAudio: {
3036
+ upstream: "supported" | "unknown" | "unsupported";
3037
+ runnable: boolean;
3038
+ };
3039
+ };
3040
+ promptCaching?: {
3041
+ upstream: "supported" | "unknown" | "unsupported";
3042
+ runnable: boolean;
3043
+ mode: "automatic" | "implicit" | "none";
3044
+ } | undefined;
3045
+ latencyModes: {
3046
+ id: "fast" | "priority" | "standard";
3047
+ upstream: "supported" | "unknown" | "unsupported";
3048
+ runnable: boolean;
3049
+ billingMultiplierBps?: number | undefined;
3050
+ }[];
3051
+ };
3052
+ pricing?: undefined;
3053
+ }>>>>;
2305
3054
  gatewayModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
2306
3055
  productId: z.ZodString;
2307
3056
  workspaceProductId: z.ZodString;
2308
3057
  upstreamModelId: z.ZodString;
2309
3058
  label: z.ZodString;
2310
3059
  shortLabel: z.ZodOptional<z.ZodString>;
3060
+ logoUrl: z.ZodOptional<z.ZodString>;
2311
3061
  providers: z.ZodArray<z.ZodString>;
2312
3062
  implicitCaching: z.ZodDefault<z.ZodBoolean>;
2313
3063
  vision: z.ZodDefault<z.ZodBoolean>;
@@ -2324,6 +3074,7 @@ export declare const ModelCatalogDocument: z.ZodObject<{
2324
3074
  upstreamModelId: z.ZodString;
2325
3075
  label: z.ZodString;
2326
3076
  shortLabel: z.ZodOptional<z.ZodString>;
3077
+ logoUrl: z.ZodOptional<z.ZodString>;
2327
3078
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
2328
3079
  capabilities: z.ZodObject<{
2329
3080
  reasoning: z.ZodObject<{
@@ -2477,29 +3228,539 @@ export declare const ModelCatalogDocument: z.ZodObject<{
2477
3228
  pricing: z.ZodOptional<z.ZodNever>;
2478
3229
  apiKey: z.ZodOptional<z.ZodNever>;
2479
3230
  }, z.core.$strict>>>;
2480
- modelNotes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
2481
- billing: z.ZodOptional<z.ZodNever>;
2482
- enabled: z.ZodOptional<z.ZodNever>;
2483
- apiKey: z.ZodOptional<z.ZodNever>;
2484
- bands: z.ZodOptional<z.ZodNever>;
2485
- }, z.core.$strict>;
2486
- export type ModelCatalogDocument = z.infer<typeof ModelCatalogDocument>;
2487
- export declare function parseModelCatalogDocument(value: unknown): ModelCatalogDocument;
2488
- /** Pure secret-free database catalog overlay. getSettings remains env-only. */
2489
- export declare function applyModelCatalogDocument(settings: Settings, rawDocument: unknown): Settings;
2490
- export declare const IntegrationOAuthClientConfigSchema: z.ZodObject<{
2491
- clientId: z.ZodString;
2492
- clientSecret: z.ZodOptional<z.ZodString>;
2493
- tokenEndpointAuthMethod: z.ZodDefault<z.ZodEnum<{
2494
- client_secret_basic: "client_secret_basic";
2495
- client_secret_post: "client_secret_post";
2496
- none: "none";
2497
- }>>;
2498
- }, z.core.$strip>;
2499
- export type IntegrationOAuthClientConfig = z.infer<typeof IntegrationOAuthClientConfigSchema>;
2500
- /**
2501
- * Runtime-resolved provider (built-in or registry), client-construction-ready.
2502
- * The built-in OpenAI/Azure provider is always present and always "responses";
3231
+ opperModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
3232
+ upstreamModelId: z.ZodString;
3233
+ label: z.ZodString;
3234
+ shortLabel: z.ZodOptional<z.ZodString>;
3235
+ logoUrl: z.ZodOptional<z.ZodString>;
3236
+ aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
3237
+ capabilities: z.ZodObject<{
3238
+ reasoning: z.ZodObject<{
3239
+ upstream: z.ZodEnum<{
3240
+ supported: "supported";
3241
+ unknown: "unknown";
3242
+ unsupported: "unsupported";
3243
+ }>;
3244
+ runnable: z.ZodBoolean;
3245
+ efforts: z.ZodArray<z.ZodEnum<{
3246
+ high: "high";
3247
+ low: "low";
3248
+ max: "max";
3249
+ medium: "medium";
3250
+ minimal: "minimal";
3251
+ none: "none";
3252
+ xhigh: "xhigh";
3253
+ }>>;
3254
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
3255
+ high: "high";
3256
+ low: "low";
3257
+ max: "max";
3258
+ medium: "medium";
3259
+ minimal: "minimal";
3260
+ none: "none";
3261
+ xhigh: "xhigh";
3262
+ }>>;
3263
+ required: z.ZodBoolean;
3264
+ }, z.core.$strip>;
3265
+ functionCalling: z.ZodObject<{
3266
+ upstream: z.ZodEnum<{
3267
+ supported: "supported";
3268
+ unknown: "unknown";
3269
+ unsupported: "unsupported";
3270
+ }>;
3271
+ runnable: z.ZodBoolean;
3272
+ }, z.core.$strip>;
3273
+ structuredOutput: z.ZodObject<{
3274
+ upstream: z.ZodEnum<{
3275
+ supported: "supported";
3276
+ unknown: "unknown";
3277
+ unsupported: "unsupported";
3278
+ }>;
3279
+ runnable: z.ZodBoolean;
3280
+ }, z.core.$strip>;
3281
+ hostedTools: z.ZodObject<{
3282
+ webSearch: z.ZodObject<{
3283
+ upstream: z.ZodEnum<{
3284
+ supported: "supported";
3285
+ unknown: "unknown";
3286
+ unsupported: "unsupported";
3287
+ }>;
3288
+ runnable: z.ZodBoolean;
3289
+ }, z.core.$strip>;
3290
+ xSearch: z.ZodObject<{
3291
+ upstream: z.ZodEnum<{
3292
+ supported: "supported";
3293
+ unknown: "unknown";
3294
+ unsupported: "unsupported";
3295
+ }>;
3296
+ runnable: z.ZodBoolean;
3297
+ }, z.core.$strip>;
3298
+ codeExecution: z.ZodObject<{
3299
+ upstream: z.ZodEnum<{
3300
+ supported: "supported";
3301
+ unknown: "unknown";
3302
+ unsupported: "unsupported";
3303
+ }>;
3304
+ runnable: z.ZodBoolean;
3305
+ }, z.core.$strip>;
3306
+ imageGeneration: z.ZodDefault<z.ZodObject<{
3307
+ upstream: z.ZodEnum<{
3308
+ supported: "supported";
3309
+ unknown: "unknown";
3310
+ unsupported: "unsupported";
3311
+ }>;
3312
+ runnable: z.ZodBoolean;
3313
+ }, z.core.$strip>>;
3314
+ }, z.core.$strip>;
3315
+ inputModalities: z.ZodArray<z.ZodEnum<{
3316
+ audio: "audio";
3317
+ image: "image";
3318
+ text: "text";
3319
+ }>>;
3320
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
3321
+ outputModalities: z.ZodArray<z.ZodEnum<{
3322
+ audio: "audio";
3323
+ image: "image";
3324
+ text: "text";
3325
+ }>>;
3326
+ transports: z.ZodObject<{
3327
+ sse: z.ZodObject<{
3328
+ upstream: z.ZodEnum<{
3329
+ supported: "supported";
3330
+ unknown: "unknown";
3331
+ unsupported: "unsupported";
3332
+ }>;
3333
+ runnable: z.ZodBoolean;
3334
+ }, z.core.$strip>;
3335
+ responsesWebSocket: z.ZodObject<{
3336
+ upstream: z.ZodEnum<{
3337
+ supported: "supported";
3338
+ unknown: "unknown";
3339
+ unsupported: "unsupported";
3340
+ }>;
3341
+ runnable: z.ZodBoolean;
3342
+ }, z.core.$strip>;
3343
+ realtimeAudio: z.ZodObject<{
3344
+ upstream: z.ZodEnum<{
3345
+ supported: "supported";
3346
+ unknown: "unknown";
3347
+ unsupported: "unsupported";
3348
+ }>;
3349
+ runnable: z.ZodBoolean;
3350
+ }, z.core.$strip>;
3351
+ }, z.core.$strip>;
3352
+ promptCaching: z.ZodOptional<z.ZodObject<{
3353
+ upstream: z.ZodEnum<{
3354
+ supported: "supported";
3355
+ unknown: "unknown";
3356
+ unsupported: "unsupported";
3357
+ }>;
3358
+ runnable: z.ZodBoolean;
3359
+ mode: z.ZodEnum<{
3360
+ automatic: "automatic";
3361
+ implicit: "implicit";
3362
+ none: "none";
3363
+ }>;
3364
+ }, z.core.$strip>>;
3365
+ latencyModes: z.ZodArray<z.ZodObject<{
3366
+ id: z.ZodEnum<{
3367
+ fast: "fast";
3368
+ priority: "priority";
3369
+ standard: "standard";
3370
+ }>;
3371
+ upstream: z.ZodEnum<{
3372
+ supported: "supported";
3373
+ unknown: "unknown";
3374
+ unsupported: "unsupported";
3375
+ }>;
3376
+ runnable: z.ZodBoolean;
3377
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
3378
+ }, z.core.$strip>>;
3379
+ }, z.core.$strip>;
3380
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
3381
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
3382
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
3383
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
3384
+ maxOutputTokens: z.ZodOptional<z.ZodNumber>;
3385
+ credentialSource: z.ZodOptional<z.ZodNever>;
3386
+ billing: z.ZodOptional<z.ZodNever>;
3387
+ apiKey: z.ZodOptional<z.ZodNever>;
3388
+ pricing: z.ZodOptional<z.ZodNever>;
3389
+ }, z.core.$strict>>>;
3390
+ modelNotes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
3391
+ billing: z.ZodOptional<z.ZodNever>;
3392
+ enabled: z.ZodOptional<z.ZodNever>;
3393
+ apiKey: z.ZodOptional<z.ZodNever>;
3394
+ bands: z.ZodOptional<z.ZodNever>;
3395
+ }, z.core.$strict>;
3396
+ export type ModelCatalogDocument = z.infer<typeof ModelCatalogDocument>;
3397
+ export declare function parseModelCatalogDocument(value: unknown): ModelCatalogDocument;
3398
+ /** Pure secret-free database catalog overlay. getSettings remains env-only. */
3399
+ /**
3400
+ * OPENGENI_MANAGED_MODELS_JSON: the managed-provider slice of a catalog
3401
+ * document for code catalog mode. Each present array uses the database
3402
+ * document's exact strict entry schema (so no entry may carry `pricing`,
3403
+ * credentials, or billing) and replaces that provider's reviewed code table;
3404
+ * an omitted array keeps it. Price authority stays with provider-reported
3405
+ * cost (Gateway/Opper), the reviewed code snapshot, and
3406
+ * OPENGENI_MODEL_PRICING_JSON, which boot validation requires for every
3407
+ * credits-billed product without a reviewed price.
3408
+ */
3409
+ export declare const ManagedModelsOverride: z.ZodObject<{
3410
+ gatewayModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
3411
+ productId: z.ZodString;
3412
+ workspaceProductId: z.ZodString;
3413
+ upstreamModelId: z.ZodString;
3414
+ label: z.ZodString;
3415
+ shortLabel: z.ZodOptional<z.ZodString>;
3416
+ logoUrl: z.ZodOptional<z.ZodString>;
3417
+ providers: z.ZodArray<z.ZodString>;
3418
+ implicitCaching: z.ZodDefault<z.ZodBoolean>;
3419
+ vision: z.ZodDefault<z.ZodBoolean>;
3420
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
3421
+ contextWindowTokens: z.ZodDefault<z.ZodNumber>;
3422
+ effectiveContextWindowTokens: z.ZodDefault<z.ZodNumber>;
3423
+ autoCompactTokenLimit: z.ZodDefault<z.ZodNumber>;
3424
+ credentialSource: z.ZodOptional<z.ZodNever>;
3425
+ billing: z.ZodOptional<z.ZodNever>;
3426
+ apiKey: z.ZodOptional<z.ZodNever>;
3427
+ pricing: z.ZodOptional<z.ZodNever>;
3428
+ }, z.core.$strict>>>;
3429
+ openrouterModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
3430
+ upstreamModelId: z.ZodString;
3431
+ label: z.ZodString;
3432
+ shortLabel: z.ZodOptional<z.ZodString>;
3433
+ logoUrl: z.ZodOptional<z.ZodString>;
3434
+ aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
3435
+ capabilities: z.ZodObject<{
3436
+ reasoning: z.ZodObject<{
3437
+ upstream: z.ZodEnum<{
3438
+ supported: "supported";
3439
+ unknown: "unknown";
3440
+ unsupported: "unsupported";
3441
+ }>;
3442
+ runnable: z.ZodBoolean;
3443
+ efforts: z.ZodArray<z.ZodEnum<{
3444
+ high: "high";
3445
+ low: "low";
3446
+ max: "max";
3447
+ medium: "medium";
3448
+ minimal: "minimal";
3449
+ none: "none";
3450
+ xhigh: "xhigh";
3451
+ }>>;
3452
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
3453
+ high: "high";
3454
+ low: "low";
3455
+ max: "max";
3456
+ medium: "medium";
3457
+ minimal: "minimal";
3458
+ none: "none";
3459
+ xhigh: "xhigh";
3460
+ }>>;
3461
+ required: z.ZodBoolean;
3462
+ }, z.core.$strip>;
3463
+ functionCalling: z.ZodObject<{
3464
+ upstream: z.ZodEnum<{
3465
+ supported: "supported";
3466
+ unknown: "unknown";
3467
+ unsupported: "unsupported";
3468
+ }>;
3469
+ runnable: z.ZodBoolean;
3470
+ }, z.core.$strip>;
3471
+ structuredOutput: z.ZodObject<{
3472
+ upstream: z.ZodEnum<{
3473
+ supported: "supported";
3474
+ unknown: "unknown";
3475
+ unsupported: "unsupported";
3476
+ }>;
3477
+ runnable: z.ZodBoolean;
3478
+ }, z.core.$strip>;
3479
+ hostedTools: z.ZodObject<{
3480
+ webSearch: z.ZodObject<{
3481
+ upstream: z.ZodEnum<{
3482
+ supported: "supported";
3483
+ unknown: "unknown";
3484
+ unsupported: "unsupported";
3485
+ }>;
3486
+ runnable: z.ZodBoolean;
3487
+ }, z.core.$strip>;
3488
+ xSearch: z.ZodObject<{
3489
+ upstream: z.ZodEnum<{
3490
+ supported: "supported";
3491
+ unknown: "unknown";
3492
+ unsupported: "unsupported";
3493
+ }>;
3494
+ runnable: z.ZodBoolean;
3495
+ }, z.core.$strip>;
3496
+ codeExecution: z.ZodObject<{
3497
+ upstream: z.ZodEnum<{
3498
+ supported: "supported";
3499
+ unknown: "unknown";
3500
+ unsupported: "unsupported";
3501
+ }>;
3502
+ runnable: z.ZodBoolean;
3503
+ }, z.core.$strip>;
3504
+ imageGeneration: z.ZodDefault<z.ZodObject<{
3505
+ upstream: z.ZodEnum<{
3506
+ supported: "supported";
3507
+ unknown: "unknown";
3508
+ unsupported: "unsupported";
3509
+ }>;
3510
+ runnable: z.ZodBoolean;
3511
+ }, z.core.$strip>>;
3512
+ }, z.core.$strip>;
3513
+ inputModalities: z.ZodArray<z.ZodEnum<{
3514
+ audio: "audio";
3515
+ image: "image";
3516
+ text: "text";
3517
+ }>>;
3518
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
3519
+ outputModalities: z.ZodArray<z.ZodEnum<{
3520
+ audio: "audio";
3521
+ image: "image";
3522
+ text: "text";
3523
+ }>>;
3524
+ transports: z.ZodObject<{
3525
+ sse: z.ZodObject<{
3526
+ upstream: z.ZodEnum<{
3527
+ supported: "supported";
3528
+ unknown: "unknown";
3529
+ unsupported: "unsupported";
3530
+ }>;
3531
+ runnable: z.ZodBoolean;
3532
+ }, z.core.$strip>;
3533
+ responsesWebSocket: z.ZodObject<{
3534
+ upstream: z.ZodEnum<{
3535
+ supported: "supported";
3536
+ unknown: "unknown";
3537
+ unsupported: "unsupported";
3538
+ }>;
3539
+ runnable: z.ZodBoolean;
3540
+ }, z.core.$strip>;
3541
+ realtimeAudio: z.ZodObject<{
3542
+ upstream: z.ZodEnum<{
3543
+ supported: "supported";
3544
+ unknown: "unknown";
3545
+ unsupported: "unsupported";
3546
+ }>;
3547
+ runnable: z.ZodBoolean;
3548
+ }, z.core.$strip>;
3549
+ }, z.core.$strip>;
3550
+ promptCaching: z.ZodOptional<z.ZodObject<{
3551
+ upstream: z.ZodEnum<{
3552
+ supported: "supported";
3553
+ unknown: "unknown";
3554
+ unsupported: "unsupported";
3555
+ }>;
3556
+ runnable: z.ZodBoolean;
3557
+ mode: z.ZodEnum<{
3558
+ automatic: "automatic";
3559
+ implicit: "implicit";
3560
+ none: "none";
3561
+ }>;
3562
+ }, z.core.$strip>>;
3563
+ latencyModes: z.ZodArray<z.ZodObject<{
3564
+ id: z.ZodEnum<{
3565
+ fast: "fast";
3566
+ priority: "priority";
3567
+ standard: "standard";
3568
+ }>;
3569
+ upstream: z.ZodEnum<{
3570
+ supported: "supported";
3571
+ unknown: "unknown";
3572
+ unsupported: "unsupported";
3573
+ }>;
3574
+ runnable: z.ZodBoolean;
3575
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
3576
+ }, z.core.$strip>>;
3577
+ }, z.core.$strip>;
3578
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
3579
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
3580
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
3581
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
3582
+ credentialSource: z.ZodOptional<z.ZodNever>;
3583
+ billing: z.ZodOptional<z.ZodNever>;
3584
+ pricing: z.ZodOptional<z.ZodNever>;
3585
+ apiKey: z.ZodOptional<z.ZodNever>;
3586
+ }, z.core.$strict>>>;
3587
+ opperModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
3588
+ upstreamModelId: z.ZodString;
3589
+ label: z.ZodString;
3590
+ shortLabel: z.ZodOptional<z.ZodString>;
3591
+ logoUrl: z.ZodOptional<z.ZodString>;
3592
+ aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
3593
+ capabilities: z.ZodObject<{
3594
+ reasoning: z.ZodObject<{
3595
+ upstream: z.ZodEnum<{
3596
+ supported: "supported";
3597
+ unknown: "unknown";
3598
+ unsupported: "unsupported";
3599
+ }>;
3600
+ runnable: z.ZodBoolean;
3601
+ efforts: z.ZodArray<z.ZodEnum<{
3602
+ high: "high";
3603
+ low: "low";
3604
+ max: "max";
3605
+ medium: "medium";
3606
+ minimal: "minimal";
3607
+ none: "none";
3608
+ xhigh: "xhigh";
3609
+ }>>;
3610
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
3611
+ high: "high";
3612
+ low: "low";
3613
+ max: "max";
3614
+ medium: "medium";
3615
+ minimal: "minimal";
3616
+ none: "none";
3617
+ xhigh: "xhigh";
3618
+ }>>;
3619
+ required: z.ZodBoolean;
3620
+ }, z.core.$strip>;
3621
+ functionCalling: z.ZodObject<{
3622
+ upstream: z.ZodEnum<{
3623
+ supported: "supported";
3624
+ unknown: "unknown";
3625
+ unsupported: "unsupported";
3626
+ }>;
3627
+ runnable: z.ZodBoolean;
3628
+ }, z.core.$strip>;
3629
+ structuredOutput: z.ZodObject<{
3630
+ upstream: z.ZodEnum<{
3631
+ supported: "supported";
3632
+ unknown: "unknown";
3633
+ unsupported: "unsupported";
3634
+ }>;
3635
+ runnable: z.ZodBoolean;
3636
+ }, z.core.$strip>;
3637
+ hostedTools: z.ZodObject<{
3638
+ webSearch: z.ZodObject<{
3639
+ upstream: z.ZodEnum<{
3640
+ supported: "supported";
3641
+ unknown: "unknown";
3642
+ unsupported: "unsupported";
3643
+ }>;
3644
+ runnable: z.ZodBoolean;
3645
+ }, z.core.$strip>;
3646
+ xSearch: z.ZodObject<{
3647
+ upstream: z.ZodEnum<{
3648
+ supported: "supported";
3649
+ unknown: "unknown";
3650
+ unsupported: "unsupported";
3651
+ }>;
3652
+ runnable: z.ZodBoolean;
3653
+ }, z.core.$strip>;
3654
+ codeExecution: z.ZodObject<{
3655
+ upstream: z.ZodEnum<{
3656
+ supported: "supported";
3657
+ unknown: "unknown";
3658
+ unsupported: "unsupported";
3659
+ }>;
3660
+ runnable: z.ZodBoolean;
3661
+ }, z.core.$strip>;
3662
+ imageGeneration: z.ZodDefault<z.ZodObject<{
3663
+ upstream: z.ZodEnum<{
3664
+ supported: "supported";
3665
+ unknown: "unknown";
3666
+ unsupported: "unsupported";
3667
+ }>;
3668
+ runnable: z.ZodBoolean;
3669
+ }, z.core.$strip>>;
3670
+ }, z.core.$strip>;
3671
+ inputModalities: z.ZodArray<z.ZodEnum<{
3672
+ audio: "audio";
3673
+ image: "image";
3674
+ text: "text";
3675
+ }>>;
3676
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
3677
+ outputModalities: z.ZodArray<z.ZodEnum<{
3678
+ audio: "audio";
3679
+ image: "image";
3680
+ text: "text";
3681
+ }>>;
3682
+ transports: z.ZodObject<{
3683
+ sse: z.ZodObject<{
3684
+ upstream: z.ZodEnum<{
3685
+ supported: "supported";
3686
+ unknown: "unknown";
3687
+ unsupported: "unsupported";
3688
+ }>;
3689
+ runnable: z.ZodBoolean;
3690
+ }, z.core.$strip>;
3691
+ responsesWebSocket: z.ZodObject<{
3692
+ upstream: z.ZodEnum<{
3693
+ supported: "supported";
3694
+ unknown: "unknown";
3695
+ unsupported: "unsupported";
3696
+ }>;
3697
+ runnable: z.ZodBoolean;
3698
+ }, z.core.$strip>;
3699
+ realtimeAudio: z.ZodObject<{
3700
+ upstream: z.ZodEnum<{
3701
+ supported: "supported";
3702
+ unknown: "unknown";
3703
+ unsupported: "unsupported";
3704
+ }>;
3705
+ runnable: z.ZodBoolean;
3706
+ }, z.core.$strip>;
3707
+ }, z.core.$strip>;
3708
+ promptCaching: z.ZodOptional<z.ZodObject<{
3709
+ upstream: z.ZodEnum<{
3710
+ supported: "supported";
3711
+ unknown: "unknown";
3712
+ unsupported: "unsupported";
3713
+ }>;
3714
+ runnable: z.ZodBoolean;
3715
+ mode: z.ZodEnum<{
3716
+ automatic: "automatic";
3717
+ implicit: "implicit";
3718
+ none: "none";
3719
+ }>;
3720
+ }, z.core.$strip>>;
3721
+ latencyModes: z.ZodArray<z.ZodObject<{
3722
+ id: z.ZodEnum<{
3723
+ fast: "fast";
3724
+ priority: "priority";
3725
+ standard: "standard";
3726
+ }>;
3727
+ upstream: z.ZodEnum<{
3728
+ supported: "supported";
3729
+ unknown: "unknown";
3730
+ unsupported: "unsupported";
3731
+ }>;
3732
+ runnable: z.ZodBoolean;
3733
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
3734
+ }, z.core.$strip>>;
3735
+ }, z.core.$strip>;
3736
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
3737
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
3738
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
3739
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
3740
+ maxOutputTokens: z.ZodOptional<z.ZodNumber>;
3741
+ credentialSource: z.ZodOptional<z.ZodNever>;
3742
+ billing: z.ZodOptional<z.ZodNever>;
3743
+ apiKey: z.ZodOptional<z.ZodNever>;
3744
+ pricing: z.ZodOptional<z.ZodNever>;
3745
+ }, z.core.$strict>>>;
3746
+ }, z.core.$strict>;
3747
+ export type ManagedModelsOverride = z.infer<typeof ManagedModelsOverride>;
3748
+ /** Parse and validate OPENGENI_MANAGED_MODELS_JSON (memoized per raw value). */
3749
+ export declare function parseManagedModelsJson(raw: string): ManagedModelsOverride;
3750
+ export declare function applyModelCatalogDocument(settings: Settings, rawDocument: unknown): Settings;
3751
+ export declare const IntegrationOAuthClientConfigSchema: z.ZodObject<{
3752
+ clientId: z.ZodString;
3753
+ clientSecret: z.ZodOptional<z.ZodString>;
3754
+ tokenEndpointAuthMethod: z.ZodDefault<z.ZodEnum<{
3755
+ client_secret_basic: "client_secret_basic";
3756
+ client_secret_post: "client_secret_post";
3757
+ none: "none";
3758
+ }>>;
3759
+ }, z.core.$strip>;
3760
+ export type IntegrationOAuthClientConfig = z.infer<typeof IntegrationOAuthClientConfigSchema>;
3761
+ /**
3762
+ * Runtime-resolved provider (built-in or registry), client-construction-ready.
3763
+ * The built-in OpenAI/Azure provider is always present and always "responses";
2503
3764
  * registry providers carry their own base URL / key / wire API. Compaction is
2504
3765
  * not a provider capability: all providers use the same durable plaintext
2505
3766
  * replacement.
@@ -2508,7 +3769,7 @@ export interface ResolvedModelProvider {
2508
3769
  anthropic?: z.infer<typeof AnthropicProviderOptions> | undefined;
2509
3770
  id: string;
2510
3771
  label: string;
2511
- kind: RegistryProviderKind | "openrouter-managed";
3772
+ kind: RegistryProviderKind | "openrouter-managed" | "opper-managed";
2512
3773
  api: ModelProviderApi;
2513
3774
  wireProfile: ModelProviderWireProfile;
2514
3775
  builtin: boolean;
@@ -2518,6 +3779,10 @@ export interface ResolvedModelProvider {
2518
3779
  defaultHeaders?: Record<string, string> | undefined;
2519
3780
  publicDefaultQueryNames?: string[] | undefined;
2520
3781
  publicDefaultHeaderNames?: string[] | undefined;
3782
+ /** Generic OpenAI-compatible stream silence bound override (ms). */
3783
+ streamIdleTimeoutMs?: number | undefined;
3784
+ /** Generic OpenAI-compatible keepalive-only progress bound override (ms). */
3785
+ streamProgressTimeoutMs?: number | undefined;
2521
3786
  credentialSource: CredentialSourceV1;
2522
3787
  billing: BillingAttributionV1;
2523
3788
  }
@@ -2529,6 +3794,8 @@ export interface ConfiguredModel {
2529
3794
  label: string;
2530
3795
  /** Optional curated compact label for dense UI (e.g. mobile composer). */
2531
3796
  shortLabel?: string | undefined;
3797
+ /** Optional HTTPS maker logo; display metadata does not change execution identity. */
3798
+ logoUrl?: string | undefined;
2532
3799
  providerId: string;
2533
3800
  providerLabel: string;
2534
3801
  api: ModelProviderApi;
@@ -2575,6 +3842,15 @@ export declare const VERCEL_AI_GATEWAY_CONNECTION_DOMAIN: "ai-gateway.vercel.sh"
2575
3842
  export declare const VERCEL_AI_GATEWAY_CONNECTION_ROLE: "vercel_ai_gateway";
2576
3843
  export declare const WORKSPACE_OPENROUTER_CONNECTION_DOMAIN: "openrouter.ai";
2577
3844
  export declare const WORKSPACE_OPENROUTER_CONNECTION_ROLE: "openrouter";
3845
+ export declare const WORKSPACE_OPPER_CONNECTION_DOMAIN: "api.opper.ai";
3846
+ export declare const WORKSPACE_OPPER_CONNECTION_ROLE: "opper";
3847
+ /**
3848
+ * Opper issues separate management keys (`op-mak-…`) that its inference routes
3849
+ * refuse with 403 ("management API keys cannot be used on inference routes").
3850
+ * Reject them before they are stored so a connection never looks ready while
3851
+ * every turn fails. Returns a user-facing explanation, or null when usable.
3852
+ */
3853
+ export declare function opperCredentialProblem(apiKey: string): string | null;
2578
3854
  export declare const CODEX_REALTIME_MODEL_ID: "gpt-live-1-boulder-alpha";
2579
3855
  export declare const SUPERGROK_REALTIME_MODEL_ID: "supergrok/grok-voice-think-fast-2.0";
2580
3856
  export declare const OPENGENI_REALTIME_MODEL_ID_PREFIX: "opengeni-gateway/";
@@ -2629,6 +3905,35 @@ export declare const OPENGENI_GATEWAY_MODELS: {
2629
3905
  };
2630
3906
  };
2631
3907
  export declare const OPENGENI_OPENROUTER_MODELS: readonly OpenRouterCatalogModel[];
3908
+ /**
3909
+ * Reviewed Opper starter route. Snapshot of Opper's catalogue
3910
+ * (`GET https://api.opper.ai/v3/compat/models`) reviewed 2026-10-05 and probed
3911
+ * live end to end. The route is provider-pinned (`provider/model`) to AWS
3912
+ * Bedrock eu-north-1 (Stockholm) with no provider logging, so Opper never
3913
+ * pools it onto a non-EU provider. `pricing` is Opper's listed supplier rate
3914
+ * (USD per 1M tokens); turns debit Opper's exact reported cost +5% and use
3915
+ * this rate only when cost metadata is absent. Hosts replace this list with
3916
+ * OPENGENI_OPPER_MODELS_JSON (code mode) or the catalog document's
3917
+ * `opperModels` (database mode).
3918
+ */
3919
+ /**
3920
+ * Default automatic-compaction threshold for Claude Opus 5.5 on every route.
3921
+ * Workspaces can still choose another threshold per model.
3922
+ */
3923
+ export declare const OPUS_5_5_AUTO_COMPACT_TOKEN_LIMIT = 300000;
3924
+ export declare const OPENGENI_OPPER_MODELS: readonly OpperCatalogModel[];
3925
+ /** Keepalive-only progress bound for Opper streams: room for a full 128,000-
3926
+ * token hidden-reasoning response at roughly 35 tokens per second. */
3927
+ export declare const OPPER_STREAM_PROGRESS_TIMEOUT_MS: number;
3928
+ /**
3929
+ * `max_tokens` the Opper Chat adapter sends when a request sets none. Opper's
3930
+ * own default is 4,096 output tokens, which hidden reasoning can exhaust before
3931
+ * any answer, and Opper rejects (does not clamp) a value above the route's
3932
+ * limit. A configured entry's `maxOutputTokens` wins; a Claude-family custom id
3933
+ * gets the smallest Claude limit in Opper's catalogue; other ids keep Opper's
3934
+ * default.
3935
+ */
3936
+ export declare function opperMaxOutputTokens(settings: Settings, upstreamModelId: string): number | undefined;
2632
3937
  export declare function configuredGatewayUpstreamModelIds(settings: Settings): string[];
2633
3938
  export declare function configuredGatewayWorkspaceProductModelIds(settings: Settings): string[];
2634
3939
  export declare function configuredGatewayOrganizationProductModelIds(settings: Settings): string[];
@@ -2636,8 +3941,11 @@ export declare function configuredModelInputIdentities(settings: Settings): stri
2636
3941
  export declare function configuredOpenRouterUpstreamModelIds(settings: Settings): string[];
2637
3942
  export declare function configuredOpenRouterWorkspaceProductModelIds(settings: Settings): string[];
2638
3943
  export declare function configuredOpenRouterOrganizationProductModelIds(settings: Settings): string[];
3944
+ export declare function configuredOpperUpstreamModelIds(settings: Settings): string[];
3945
+ export declare function configuredOpperWorkspaceProductModelIds(settings: Settings): string[];
3946
+ export declare function configuredOpperOrganizationProductModelIds(settings: Settings): string[];
2639
3947
  /**
2640
- * Built-in OpenGeni credit pricing schedules.
3948
+ * Built-in Opengeni credit pricing schedules.
2641
3949
  *
2642
3950
  * Rates are provider list prices in USD micros per 1M tokens. Debit applies
2643
3951
  * `marginBps` (500 = +5%) on top. Long-context tiers follow OpenAI's
@@ -2645,7 +3953,7 @@ export declare function configuredOpenRouterOrganizationProductModelIds(settings
2645
3953
  *
2646
3954
  * GPT-5.4 and older families are intentionally omitted — they are no longer
2647
3955
  * offered. Codex / connected-subscription turns use `metering: external`, so
2648
- * this map never debits them, but it does provide their equivalent OpenGeni
3956
+ * this map never debits them, but it does provide their equivalent Opengeni
2649
3957
  * credit price when a matching product model is configured.
2650
3958
  *
2651
3959
  * When adding or changing a billed model, run `bun run check:model-pricing`
@@ -2653,6 +3961,8 @@ export declare function configuredOpenRouterOrganizationProductModelIds(settings
2653
3961
  * llm-prices.com as a ground-truth canary; it does not generate this table.
2654
3962
  */
2655
3963
  export declare const defaultModelPricing: Record<string, ModelPricingScheduleV1>;
3964
+ /** Reviewed comparison rates only; never debit or execution-definition defaults. */
3965
+ export declare const reviewedModelListPricing: Record<string, ModelPricingScheduleV1>;
2656
3966
  export type SandboxRequiredEnv = {
2657
3967
  field: keyof Settings;
2658
3968
  env: string;
@@ -2672,15 +3982,24 @@ export type FirstPartyMcpToolPolicy = {
2672
3982
  default: FirstPartyMcpToolNameType[];
2673
3983
  allowed: FirstPartyMcpToolNameType[];
2674
3984
  };
3985
+ export type FirstPartyMcpToolPolicySettings = Pick<Settings, "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools" | "artifactMaterializerDeployed">;
3986
+ /**
3987
+ * First-party tools whose backing workload this deployment does not run. They
3988
+ * are absent from the ceiling (never offered) and an explicit request for one
3989
+ * is dropped rather than rejected: it is a deployment fact, not a caller error.
3990
+ */
3991
+ export declare function deploymentUnavailableFirstPartyMcpTools(settings: Pick<Settings, "artifactMaterializerDeployed">): ReadonlySet<FirstPartyMcpToolNameType>;
2675
3992
  /** Resolve the deployment's session-tool defaults and hard execution ceiling. */
2676
- export declare function resolveFirstPartyMcpToolPolicy(settings: Pick<Settings, "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">): FirstPartyMcpToolPolicy;
3993
+ export declare function resolveFirstPartyMcpToolPolicy(settings: FirstPartyMcpToolPolicySettings): FirstPartyMcpToolPolicy;
2677
3994
  /** Apply the deployment ceiling to an existing durable session selection. */
2678
- export declare function allowedFirstPartyMcpToolsForSession(settings: Pick<Settings, "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">, selected: readonly FirstPartyMcpToolNameType[] | null | undefined): FirstPartyMcpToolNameType[];
3995
+ export declare function allowedFirstPartyMcpToolsForSession(settings: FirstPartyMcpToolPolicySettings, selected: readonly FirstPartyMcpToolNameType[] | null | undefined): FirstPartyMcpToolNameType[];
3996
+ /** Resolve durable selection intent before freezing a new attempt's catalog. */
3997
+ export declare function resolveSessionFirstPartyMcpTools(settings: FirstPartyMcpToolPolicySettings, session: Pick<Session, "firstPartyMcpTools" | "toolPolicy"> & Partial<Pick<Session, "agent">>, workspaceSettings: unknown): FirstPartyMcpToolNameType[];
2679
3998
  /**
2680
3999
  * The Modal sandbox idle timeout (seconds) the provider actually passes as
2681
4000
  * idleTimeoutMs (sandbox-file-persistence). When the operator did not pin
2682
4001
  * OPENGENI_MODAL_IDLE_TIMEOUT_SECONDS we DEFAULT it to the hard lifetime
2683
- * (modalTimeoutSeconds): OpenGeni's reaper owns box lifecycle, so Modal's
4002
+ * (modalTimeoutSeconds): Opengeni's reaper owns box lifecycle, so Modal's
2684
4003
  * built-in idle-reap (which would otherwise fire on its short server default and
2685
4004
  * kill the box BEFORE the reaper can snapshot /workspace) is pushed out to the
2686
4005
  * hard backstop. An explicit smaller value is honoured (the boot invariant keeps
@@ -2702,15 +4021,26 @@ export declare function effectiveSandboxLifecycle(settings: Settings, backend?:
2702
4021
  /**
2703
4022
  * One shared upper bound for the durable provider-capture claim and for command
2704
4023
  * admission waiting behind it. The SDK request itself is bounded by
2705
- * sandboxSnapshotTimeoutMs; the extra window lets a non-cancellable provider
2706
- * response settle and release its exact claim without turning a normal
2707
- * checkpoint into a visible command failure. Database validation caps both
2708
- * consumers at one hour.
4024
+ * sandboxSnapshotTimeoutMs (a warm host-backed spool capture is stopped there);
4025
+ * the extra window lets a non-cancellable provider response settle and release
4026
+ * its exact claim without turning a normal checkpoint into a visible command
4027
+ * failure. Database validation caps both consumers at one hour.
2709
4028
  */
2710
4029
  export declare function sandboxArchiveCaptureTimeoutMs(settings: Pick<Settings, "sandboxSnapshotTimeoutMs">): number;
2711
4030
  /** Provider operation budget used only by zero-holder drain/rotation capture.
2712
4031
  * Unset preserves the historical shared snapshot budget exactly. */
2713
4032
  export declare function effectiveSandboxDrainSnapshotTimeoutMs(settings: Pick<Settings, "sandboxSnapshotTimeoutMs" | "sandboxDrainSnapshotTimeoutMs">): number;
4033
+ /**
4034
+ * How long before a finite provider deadline the deadline save stops waiting
4035
+ * for an orderly shutdown and becomes mandatory. Past this point the
4036
+ * reaper captures and terminates the box around anything that cannot finish in
4037
+ * time (pending owner quiescence, sibling attempts that do not hold the box,
4038
+ * in-flight requests whose holders are gone, commands that ignored their stop
4039
+ * request) instead of letting the provider kill it uncaptured. It leaves the
4040
+ * legacy command stop grace, the full drain capture budget and two reaper
4041
+ * periods before the deadline, and never exceeds the rotation lead.
4042
+ */
4043
+ export declare function sandboxDeadlineMandatoryCaptureLeadMs(settings: Pick<Settings, "sandboxRotationLeadMs" | "sandboxSnapshotTimeoutMs" | "sandboxDrainSnapshotTimeoutMs" | "sandboxLeaseReaperPeriodMs">): number;
2714
4044
  export declare function sandboxLifecycleTransitionWaitMs(settings: Pick<Settings, "sandboxSnapshotTimeoutMs" | "sandboxDrainSnapshotTimeoutMs" | "sandboxLeaseReaperPeriodMs">): number;
2715
4045
  export declare function collectSandboxEnvironment(settings: Settings, source?: NodeJS.ProcessEnv): Record<string, string>;
2716
4046
  /**
@@ -2722,6 +4052,17 @@ export declare function collectSandboxEnvironment(settings: Settings, source?: N
2722
4052
  */
2723
4053
  export declare function resolveProviderApiKey(provider: Pick<RegistryProvider, "apiKey" | "apiKeyEnv">, source?: NodeJS.ProcessEnv): string | undefined;
2724
4054
  export declare function gatewayRequestPolicyForUpstreamModel(upstreamModelId: string, models?: readonly GatewayCatalogModel[]): ConfiguredModel["requestPolicy"];
4055
+ /** Customer-owned OpenAI/Azure routes, bound to immutable connection identity. */
4056
+ export declare function withDirectModelProviders(settings: Settings, connections: readonly {
4057
+ id: string;
4058
+ version: number;
4059
+ subjectId: string | null;
4060
+ kind: string;
4061
+ status: string;
4062
+ providerDomain: string;
4063
+ metadata: Record<string, unknown>;
4064
+ apiKey?: string;
4065
+ }[]): Settings;
2725
4066
  /** Static catalog overlay; it contains no concrete workspace credential. */
2726
4067
  export declare function withWorkspaceGatewayCatalogProvider(settings: Settings, customModels?: readonly {
2727
4068
  upstreamModelId: string;
@@ -2742,6 +4083,25 @@ export declare function withWorkspaceOpenRouterCredential(settings: Settings, ap
2742
4083
  upstreamModelId: string;
2743
4084
  label?: string | null;
2744
4085
  }[]): Settings;
4086
+ /** Static Opper catalog overlay; it contains no concrete workspace credential. */
4087
+ export declare function withWorkspaceOpperCatalogProvider(settings: Settings, customModels?: readonly {
4088
+ upstreamModelId: string;
4089
+ label?: string | null;
4090
+ }[]): Settings;
4091
+ /** Runtime overlay after the worker resolves the workspace's encrypted Opper key. */
4092
+ export declare function withWorkspaceOpperCredential(settings: Settings, apiKey: string, customModels?: readonly {
4093
+ upstreamModelId: string;
4094
+ label?: string | null;
4095
+ }[]): Settings;
4096
+ /** Secret-free organization Opper catalog overlay. */
4097
+ export declare function withOrganizationOpperCatalogProvider(settings: Settings, customModels?: readonly {
4098
+ upstreamModelId: string;
4099
+ label?: string | null;
4100
+ }[]): Settings;
4101
+ export declare function withOrganizationOpperCredential(settings: Settings, apiKey: string, customModels?: readonly {
4102
+ upstreamModelId: string;
4103
+ label?: string | null;
4104
+ }[]): Settings;
2745
4105
  /** Secret-free organization Vercel AI Gateway catalog overlay. */
2746
4106
  export declare function withOrganizationGatewayCatalogProvider(settings: Settings, customModels?: readonly {
2747
4107
  upstreamModelId: string;
@@ -2775,7 +4135,7 @@ export declare function productShortLabelForModelId(modelId: string): string | n
2775
4135
  /** Undefined and the exact public OpenAI v1 endpoint are the same direct route. */
2776
4136
  export declare function isDirectOpenAiApiBaseUrl(baseUrl: string | undefined): boolean;
2777
4137
  /**
2778
- * Map OpenGeni latency mode to the provider `service_tier` wire value.
4138
+ * Map Opengeni latency mode to the provider `service_tier` wire value.
2779
4139
  * Azure, Codex ChatGPT, and xAI accept `priority`; OpenAI API accepts `fast`.
2780
4140
  * Standard omits the field.
2781
4141
  */
@@ -2783,7 +4143,22 @@ export declare function serviceTierForLatencyMode(providerId: string, latencyMod
2783
4143
  /** True when the response tier fulfills a non-standard Fast/priority request. */
2784
4144
  export declare function responseSatisfiesLatencyMode(requested: LatencyMode, responseServiceTier: string | null | undefined): boolean;
2785
4145
  export declare function runnableLatencyModesForModel(settings: Settings, modelId: string): LatencyMode[];
4146
+ export declare class UnsupportedLatencyModeError extends Error {
4147
+ readonly modelId: string;
4148
+ readonly latencyMode: LatencyMode;
4149
+ readonly allowedLatencyModes: readonly LatencyMode[];
4150
+ readonly code = "UNSUPPORTED_LATENCY_MODE";
4151
+ constructor(modelId: string, latencyMode: LatencyMode, allowedLatencyModes: readonly LatencyMode[]);
4152
+ }
2786
4153
  export declare function modelCostClassForConfiguredModel(_settings: Settings, model: Pick<ConfiguredModel, "cost">): ConfiguredModelCostClass;
4154
+ /**
4155
+ * The executable model an accepted turn runs: the current definition, except
4156
+ * that a turn frozen before hosted web search was enabled keeps its frozen
4157
+ * tool set (no web_search) on every recovery attempt. Only the next accepted
4158
+ * logical turn resolves the newly enabled tool. Call only with a policy that
4159
+ * already passed assertTurnExecutionPolicyMatchesConfigV1.
4160
+ */
4161
+ export declare function configuredModelForAcceptedTurnExecutionPolicy(model: ConfiguredModel, provider: ResolvedModelProvider, policy: TurnExecutionPolicyV1): ConfiguredModel;
2787
4162
  /**
2788
4163
  * The built-in provider's stable id: "openai" on the OpenAI platform, "azure"
2789
4164
  * on Azure. Exported because the workspace model-policy gate must attribute
@@ -2830,6 +4205,18 @@ export declare function withXaiSubscriptionCatalogProvider(settings: Settings):
2830
4205
  * serves. A policy blocking the built-in must block this path too.
2831
4206
  */
2832
4207
  export declare function policyProviderIdForModel(settings: Settings, modelId: string): string;
4208
+ /**
4209
+ * Whether a model id spends Opengeni credits, for the workspace model
4210
+ * policy's credit switch. MUST agree with the cost the worker bills
4211
+ * (`ConfiguredModel.cost === "credits"`):
4212
+ * - a configured model → its own cost class;
4213
+ * - `codex/…`, `xai…/`, and workspace/organization connection ids → never;
4214
+ * - anything else → the legacy built-in fallback, which the deployment pays
4215
+ * and bills in credits unless the cost policy marks that exact id free.
4216
+ * Failing closed here keeps an unknown id from slipping past a workspace
4217
+ * that turned credits off.
4218
+ */
4219
+ export declare function policyChargesCreditsForModel(settings: Settings, modelId: string): boolean;
2833
4220
  /**
2834
4221
  * Every model a client may use, the built-in provider's models first
2835
4222
  * (configuredAllowedModels-from-openai, mapped to "responses" with
@@ -2884,6 +4271,14 @@ export type ResolveTurnExecutionPolicyV1Input = {
2884
4271
  * callers must keep their live credential/readiness gate authoritative.
2885
4272
  */
2886
4273
  export declare function resolveModelProviderForTurn(settings: Settings, modelId: string): ReturnType<typeof resolveModelProvider>;
4274
+ /**
4275
+ * The requested model cannot start new work: it is retired from new selection
4276
+ * or absent from the configured catalog. Callers that own a durable refusal
4277
+ * (for example a scheduled occurrence) record it instead of failing blindly.
4278
+ */
4279
+ export declare class TurnExecutionPolicyModelUnavailableError extends Error {
4280
+ constructor(message: string);
4281
+ }
2887
4282
  /**
2888
4283
  * Build a trusted, secret-safe execution policy from the normalized catalog.
2889
4284
  * The Codex overlay here contains static product/provider identity only; it
@@ -2897,8 +4292,12 @@ export declare class TurnExecutionPolicyDefinitionMismatchError extends Error {
2897
4292
  }
2898
4293
  /**
2899
4294
  * Parse-time validation lives in @opengeni/contracts; this verifier binds a
2900
- * present snapshot to the current executable definition and exact turn row.
2901
- * Any deployment/provider drift fails before a provider or compaction call.
4295
+ * serving snapshot to its executable definition and mapped reasoning. This
4296
+ * does not activate placement or replace the immutable accepted-turn policy.
4297
+ */
4298
+ export declare function assertTurnServingPolicyMatchesConfigV1(settings: Settings, revision: TurnServingPolicyV1, acceptedPolicy: TurnExecutionPolicyV1): ReturnType<typeof assertTurnExecutionPolicyMatchesConfigV1>;
4299
+ /** Bind an accepted snapshot to the current definition and exact turn row.
4300
+ * Non-additive executable drift fails before a provider or compaction call.
2902
4301
  */
2903
4302
  export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
2904
4303
  modelId: string;
@@ -2916,6 +4315,13 @@ export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Setti
2916
4315
  * complete schedule, and always replace the lower-precedence schedule.
2917
4316
  */
2918
4317
  export declare function configuredModelPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
4318
+ /**
4319
+ * Insights list-price metadata, including reviewed namespaced provider routes.
4320
+ * Kept separate from debit/catalog pricing: adding a comparison must not change
4321
+ * an accepted turn's frozen execution-definition hash or payer classification.
4322
+ * Inline registry and explicit product-ID prices always win over projections.
4323
+ */
4324
+ export declare function configuredModelListPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
2919
4325
  /** Legacy flat projection: returns the default/below-threshold price. */
2920
4326
  export declare function configuredModelPricing(settings: Settings): Record<string, ModelPricing>;
2921
4327
  /** Select the per-provider-request price at an exact input-token threshold. */
@@ -2930,7 +4336,15 @@ export declare function contextInputBudgetTokens(settings: Pick<Settings, "conte
2930
4336
  * metadata is authoritative when present; deployment defaults remain the
2931
4337
  * fallback for models that do not declare their own limits.
2932
4338
  */
2933
- export declare function settingsWithResolvedModelContext(settings: Settings, model: Pick<ConfiguredModel, "contextWindowTokens" | "effectiveContextWindowTokens" | "autoCompactTokenLimit" | "toolOutputTruncationTokens">): Settings;
4339
+ export declare function settingsWithResolvedModelContext(settings: Settings, model: Pick<ConfiguredModel, "contextWindowTokens" | "effectiveContextWindowTokens" | "autoCompactTokenLimit" | "toolOutputTruncationTokens"> & {
4340
+ id?: string;
4341
+ }, workspaceSettings?: unknown, organizationDefaults?: Pick<OrganizationModelDefaults, "modelCompactionThresholds"> | null): Settings;
4342
+ /**
4343
+ * One policy projection for settings UI and all model-facing worker paths.
4344
+ * The workspace's own preference wins, then the organization's default for
4345
+ * the model, then the model's own default.
4346
+ */
4347
+ export declare function workspaceModelCompactionPolicy(settings: Settings, model: Pick<ConfiguredModel, "id" | "contextWindowTokens" | "effectiveContextWindowTokens" | "autoCompactTokenLimit">, workspaceSettings: unknown, organizationDefaults?: Pick<OrganizationModelDefaults, "modelCompactionThresholds"> | null): ModelCompactionPolicy;
2934
4348
  export declare function configuredStaticUsageLimits(settings: Settings): StaticUsageLimitsConfig;
2935
4349
  export declare function configuredEntitlements(settings: Settings): EntitlementsConfig;
2936
4350
  export declare function calculateModelUsageCostMicros(settings: Settings, model: string, usage: ModelUsageInput, options?: {
@@ -2939,21 +4353,44 @@ export declare function calculateModelUsageCostMicros(settings: Settings, model:
2939
4353
  export declare function calculateModelUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
2940
4354
  latencyMode?: LatencyMode;
2941
4355
  }): ModelUsageCostBreakdown;
4356
+ /** Provider-list/equivalent-credit comparison only; never debit authority. */
4357
+ export declare function calculateModelListUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
4358
+ latencyMode?: LatencyMode;
4359
+ }): ModelUsageCostBreakdown;
4360
+ /**
4361
+ * Forward-only list comparison snapshot for the model-call fact writer.
4362
+ * Callers must establish request price provenance (including geography/service
4363
+ * tier) and retain per-request counters. Unknown counters/TTL/modifiers yield
4364
+ * no class split, not invented zeros. Historical facts must not use this helper.
4365
+ * Native Claude details preserve cache_write_tokens_5m and cache_write_tokens_1h.
4366
+ */
4367
+ export declare function calculateModelListUsageCostSnapshot(settings: Settings, model: string, usage: ModelUsageInput, options?: {
4368
+ latencyMode?: LatencyMode;
4369
+ priceContextKnown?: boolean;
4370
+ }): ModelListUsageCostSnapshot;
2942
4371
  /**
2943
- * Convert AI Gateway's exact USD inference cost to OpenGeni credit micros and
4372
+ * Approximate class attribution of a previously recorded upstream list total.
4373
+ * Current reviewed rates are weights only: this never recomputes that total,
4374
+ * credits, or charges. Missing class counters/rates remain unknown. Historical
4375
+ * cache writes use the schedule's single TTL rate, not an exact TTL assertion.
4376
+ * Reasoning is already included in outputTokens and is never added again.
4377
+ */
4378
+ export declare function allocateRecordedModelListCostByClass(settings: Settings, model: string, usage: ModelUsageInput, recordedProviderCostMicros: number | null | undefined): ModelRecordedListCostAllocation;
4379
+ /**
4380
+ * Convert AI Gateway's exact USD inference cost to Opengeni credit micros and
2944
4381
  * apply the configured model margin. Decimal arithmetic is integer-only so a
2945
4382
  * sub-micro provider charge cannot be lost to floating-point rounding.
2946
4383
  */
2947
4384
  export declare function calculateGatewayReportedCostMicros(settings: Settings, model: string, inferenceCostUsd: string, options?: {
2948
4385
  inputTokens?: number;
2949
4386
  }): number;
2950
- /** Exact provider-reported Gateway cost without requiring an OpenGeni price schedule. */
4387
+ /** Exact provider-reported Gateway cost without requiring an Opengeni price schedule. */
2951
4388
  export declare function calculateGatewayReportedProviderCostMicros(inferenceCostUsd: string): number;
2952
4389
  export declare function calculateGatewayReportedCostBreakdown(settings: Settings, model: string, inferenceCostUsd: string, options?: {
2953
4390
  inputTokens?: number;
2954
4391
  }): ModelUsageCostBreakdown;
2955
4392
  /**
2956
- * Exact OpenGeni product price frozen before a managed video request starts.
4393
+ * Exact Opengeni product price frozen before a managed video request starts.
2957
4394
  * Gateway reporting is delayed for asynchronous video, so this deliberately
2958
4395
  * does not masquerade as provider-reported cost.
2959
4396
  */
@@ -2977,7 +4414,7 @@ export declare function environmentsEncryptionKeyBytes(settings: Settings): Uint
2977
4414
  */
2978
4415
  export declare function temporalConnectionOptions(settings: Settings): TemporalConnectionOptions;
2979
4416
  /**
2980
- * The connection `search_path` for OpenGeni's db handles + the managed-auth pool
4417
+ * The connection `search_path` for Opengeni's db handles + the managed-auth pool
2981
4418
  * (Step I, §7.8 runtime half). Returns `undefined` when `dbSchema` is unset
2982
4419
  * (standalone) so no `search_path` startup parameter is sent and the server
2983
4420
  * default (`public`) applies — byte-for-byte today's behavior. When `dbSchema`
@@ -2988,6 +4425,15 @@ export declare function temporalConnectionOptions(settings: Settings): TemporalC
2988
4425
  */
2989
4426
  export declare function dbSearchPath(settings: Pick<Settings, "dbSchema">): string | undefined;
2990
4427
  export declare function collectGitIdentityEnvironment(settings: Settings): Record<string, string>;
4428
+ /**
4429
+ * The manifest-env constants predicate (W1 secrets delivery, RM-3). A sandbox
4430
+ * manifest may carry only deployment constants: HOME, PATH, git identity and
4431
+ * askpass pointers, `OPENGENI_*` pointers, and the deployment allowlist
4432
+ * (`sandboxEnvironmentVariableNames`). User secrets never qualify: they are
4433
+ * resolved per command from `{{secret:…}}` references. Used by `buildManifest`
4434
+ * and the persisted-envelope strip as a defensive filter.
4435
+ */
4436
+ export declare function sandboxManifestEnvironmentNamePredicate(settings: Settings): (name: string) => boolean;
2991
4437
  /**
2992
4438
  * The STABLE run-scoped sandbox environment: the subset of a run's box-manifest
2993
4439
  * environment that is IDENTICAL whether the box is first warmed by the worker
@@ -2999,9 +4445,9 @@ export declare function collectGitIdentityEnvironment(settings: Settings): Recor
2999
4445
  * manifest lacks or carries a different value for).
3000
4446
  *
3001
4447
  * Precedence (lowest → highest): deployment allowlist (`collectSandboxEnvironment`)
3002
- * < git identity (`collectGitIdentityEnvironment`) < the session's attached
3003
- * workspace environment < the backend-aware HOME default. Reserved-name validation
3004
- * at write time keeps workspace values from colliding with platform entries.
4448
+ * < git identity (`collectGitIdentityEnvironment`) < the backend-aware HOME default.
4449
+ * The manifest holds deployment constants only: user secrets never ride it.
4450
+ * They are resolved per command from `{{secret:…}}` references (W1 delivery).
3005
4451
  *
3006
4452
  * DELIBERATELY EXCLUDES the per-run, ROTATING git provider token VALUES that
3007
4453
  * `sandboxEnvironmentForRun` mints when a repository resource is
@@ -3017,10 +4463,9 @@ export declare function collectGitIdentityEnvironment(settings: Settings): Recor
3017
4463
  * the platform never mints or seeds git provider tokens there. The attach
3018
4464
  * surfaces have only the `Session` (no repo resources) and so never seed a token,
3019
4465
  * but unwritten files simply yield no auth; the BLOCKING attach-vs-turn error
3020
- * this helper fixes is for the common (no-repo) and workspace-environment-attached
3021
- * provisioned-box cases.
4466
+ * this helper fixes is for the common (no-repo) provisioned-box case.
3022
4467
  */
3023
- export declare function stableSandboxEnvironmentForRun(settings: Settings, workspaceEnvironment?: Record<string, string>, options?: {
4468
+ export declare function stableSandboxEnvironmentForRun(settings: Settings, options?: {
3024
4469
  workspaceId?: string;
3025
4470
  }): Record<string, string>;
3026
4471
  /**
@@ -3094,6 +4539,13 @@ export declare function sandboxWarmRateMicrosPerSecond(settings: Settings, backe
3094
4539
  */
3095
4540
  export declare function parseModelProvidersJson(raw: string): RegistryProvider[];
3096
4541
  export declare function parseIntegrationsOauthClientsJson(raw: string | undefined): Record<string, IntegrationOAuthClientConfig>;
4542
+ /**
4543
+ * The operator-registered client for one authorization server, matched by
4544
+ * exact issuer/URL key first and then trailing-slash-insensitively. The OAuth
4545
+ * start flow and the connector catalog's connectability projection share this
4546
+ * so a catalog row is offered exactly when a start would find a client.
4547
+ */
4548
+ export declare function findIntegrationsOauthClient(configured: Readonly<Record<string, IntegrationOAuthClientConfig>>, candidates: readonly string[]): IntegrationOAuthClientConfig | null;
3097
4549
  export declare const SocialOAuthClientConfigSchema: z.ZodObject<{
3098
4550
  clientId: z.ZodString;
3099
4551
  clientSecret: z.ZodOptional<z.ZodString>;
@@ -3104,12 +4556,18 @@ export declare function parseSocialOauthClientsJson(raw: string | undefined): Pa
3104
4556
  export declare function parseStaticUsageLimitsJson(raw: string): StaticUsageLimitsConfig;
3105
4557
  export declare function parseStaticEntitlementsJson(raw: string): EntitlementsConfig;
3106
4558
  /**
3107
- * The sandbox/external base URL of OpenGeni's first-party MCP endpoint, as a
4559
+ * Setup bound for Opengeni's own MCP servers. They are the deployment's API,
4560
+ * which is briefly slow while it restarts or is under load; the client's
4561
+ * 5-second default turned that into failed turns. Tool calls are unaffected.
4562
+ */
4563
+ export declare const FIRST_PARTY_MCP_SETUP_TIMEOUT_MS = 30000;
4564
+ /**
4565
+ * The sandbox/external base URL of Opengeni's first-party MCP endpoint, as a
3108
4566
  * `{workspaceId}` template. Codemode and remote placements use this route.
3109
4567
  *
3110
4568
  * BINDING CONTRACT (`opengeniMcpUrl`):
3111
4569
  * - STANDALONE (unset): falls back to the loopback default.
3112
- * - EMBEDDED / MOUNTED (must set): when OpenGeni's API is mounted as a host
4570
+ * - EMBEDDED / MOUNTED (must set): when Opengeni's API is mounted as a host
3113
4571
  * sub-app under a prefix (e.g. `https://host/og/v1/...`), the loopback
3114
4572
  * default is WRONG — the worker runs in the host process and `127.0.0.1:
3115
4573
  * ${apiPort}` is not where the mounted, sandbox-routable MCP lives. The host
@@ -3152,6 +4610,13 @@ export declare function localAllowedOriginEntries(raw: string | undefined): stri
3152
4610
  * addresses that only sandboxes use (see `apps/api/src/http/local-browser-boundary.ts`).
3153
4611
  */
3154
4612
  export declare function localSandboxApiRouteAllowed(pathname: string): boolean;
4613
+ /**
4614
+ * Published Sites serve untrusted HTML, so their domain must not hold or sit
4615
+ * inside the console or API hosts: a Site could otherwise read or set their
4616
+ * cookies. A separate registrable domain is required (see
4617
+ * docs/published-sites.md); this catches the nesting a host check can see.
4618
+ */
4619
+ export declare function validateSitesDomain(settings: Pick<Settings, "sitesDomain" | "publicBaseUrl" | "webBaseUrl">): void;
3155
4620
  /** Validate one fully resolved, secret-bearing executable catalog. */
3156
4621
  export declare function validateModelCatalogSettings(settings: Settings, source?: NodeJS.ProcessEnv): ConfiguredModel[];
3157
4622
  /**
@@ -3222,6 +4687,20 @@ export declare function sandboxImageAllowlist(settings: Pick<Settings, "sandboxI
3222
4687
  /** Native Claude connections reuse the encrypted workspace and organization boundaries. */
3223
4688
  export declare const CLAUDE_CONNECTION_KINDS: readonly ["anthropic", "claude_subscription"];
3224
4689
  export type ClaudeConnectionKind = (typeof CLAUDE_CONNECTION_KINDS)[number];
4690
+ export declare function claudeNativeModelProfile(upstreamModelId: string): Readonly<{
4691
+ efforts: readonly ReasoningEffort[];
4692
+ defaultEffort: ReasoningEffort | null;
4693
+ contextWindowTokens: number;
4694
+ maxOutputTokens: number;
4695
+ autoCompactTokenLimit?: number;
4696
+ prefixBoundThinking?: boolean;
4697
+ }> | undefined;
4698
+ /**
4699
+ * Models a new Claude connection offers without anyone adding them. Seeded
4700
+ * once per scope and connection kind, only when that scope never configured
4701
+ * Claude models; a removed model stays removed.
4702
+ */
4703
+ export declare const CLAUDE_DEFAULT_CONNECTION_MODEL_IDS: readonly ["claude-opus-5-5", "claude-sonnet-5-5", "claude-haiku-5-5"];
3225
4704
  export declare function claudeProviderId(kind: ClaudeConnectionKind, scope?: "workspace" | "organization"): string;
3226
4705
  export type ClaudeConnectionCatalog = Partial<Record<ClaudeConnectionKind, {
3227
4706
  active?: boolean;
@@ -3237,3 +4716,5 @@ export declare function withClaudeConnectionCredential(settings: Settings, kind:
3237
4716
  }): Settings;
3238
4717
  export * from "./claude-subscription-usage.js";
3239
4718
  export * from "./claude-subscription-oauth.js";
4719
+ export * from "./subscription-account-selection.js";
4720
+ export * from "./claude-subscription-capacity.js";