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