@opengeni/config 1.2.0-canary.1 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,10 +1,14 @@
1
- import { Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType } from "@opengeni/contracts";
1
+ export { managedUserEmailAllowed } from "./managed-user-admission.js";
2
+ export { CreditPromotionPolicy, signupCreditModelIds, promotionalCreditScope, } from "./credit-promotions.js";
3
+ import { type AgentConfigDeploymentLimits, Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType } from "@opengeni/contracts";
4
+ import type { CodeSearchDeploymentPolicy } from "@opengeni/contracts/code-search";
2
5
  export { XAI_SUBSCRIPTION_MODEL_ID_PREFIX } from "@opengeni/xai-subscription";
3
6
  import { z } from "zod";
4
7
  export declare const DEFAULT_OPENROUTER_MODEL_ID: "openrouter/nvidia/nemotron-3-super-120b-a12b:free";
5
8
  export declare const DEFAULT_MODEL_COST_POLICY_JSON: string;
6
9
  export declare const SANDBOX_ARCHIVE_CAPTURE_MAX_TIMEOUT_MS: number;
7
10
  export declare const SANDBOX_ARCHIVE_CAPTURE_SETTLEMENT_GRACE_MS = 10000;
11
+ export declare const SANDBOX_DEADLINE_COMMAND_STOP_GRACE_MS = 120000;
8
12
  export declare const SANDBOX_SNAPSHOT_MAX_TIMEOUT_MS: number;
9
13
  export declare const GOOGLE_DRIVE_PROVIDER_REQUEST_TIMEOUT_MAX_MS = 60000;
10
14
  export declare const GOOGLE_DRIVE_PROVIDER_RETRY_DELAY_MAX_MS = 60000;
@@ -28,8 +32,9 @@ export declare const sandboxPreparationProfiles: Record<string, {
28
32
  export declare const AGENT_INSTRUCTIONS_CORE_PLACEHOLDER = "{{core}}";
29
33
  /**
30
34
  * Default per-workspace agent persona template. This is the BRAND + tool-usage
31
- * opinion (the white-labellable surface): the "You are an OpenGeni workspace
32
- * agent." identity line, the framing/opinion lines, and the mount-path facts.
35
+ * opinion (the white-labellable surface): the general-assistant identity line,
36
+ * the framing/opinion lines, and the mount-path facts. Domain-specific tooling
37
+ * guidance (for example Terraform or Checkov) belongs in opt-in Skills.
33
38
  *
34
39
  * The CORE that MUST survive any override — the goal-loop ownership line (which
35
40
  * names the opengeni__goal_* tools) and the dynamic workspace-environment block
@@ -45,6 +50,14 @@ export declare const AGENT_INSTRUCTIONS_CORE_PLACEHOLDER = "{{core}}";
45
50
  export declare const DEFAULT_AGENT_INSTRUCTIONS: string;
46
51
  export declare const McpServerConnectionRefSchema: z.ZodObject<{
47
52
  connectionId: z.ZodOptional<z.ZodString>;
53
+ accountSelection: z.ZodOptional<z.ZodLiteral<"all_eligible">>;
54
+ authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
55
+ hostBinding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
56
+ bindingId: z.ZodString;
57
+ generation: z.ZodNumber;
58
+ }, z.core.$strict>, z.ZodObject<{
59
+ selection: z.ZodLiteral<"accepted_turn">;
60
+ }, z.core.$strict>]>>;
48
61
  provider: z.ZodOptional<z.ZodString>;
49
62
  providerDomain: z.ZodString;
50
63
  kind: z.ZodOptional<z.ZodEnum<{
@@ -59,11 +72,6 @@ export declare const McpServerConnectionRefSchema: z.ZodObject<{
59
72
  id: z.ZodString;
60
73
  kind: z.ZodLiteral<"repository">;
61
74
  }, z.core.$strict>>>;
62
- authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
63
- hostBinding: z.ZodOptional<z.ZodObject<{
64
- bindingId: z.ZodString;
65
- generation: z.ZodNumber;
66
- }, z.core.$strict>>;
67
75
  subjectScope: z.ZodOptional<z.ZodEnum<{
68
76
  subject: "subject";
69
77
  workspace: "workspace";
@@ -75,13 +83,14 @@ export declare const McpOperationRecoverySchema: z.ZodRecord<z.ZodString, z.ZodO
75
83
  observerTool: z.ZodString;
76
84
  }, z.core.$strict>>;
77
85
  /** Public, digest-pinned desktop image used by Modal unless the operator overrides it. */
78
- export declare const DEFAULT_MODAL_IMAGE_REF = "opengenipublicneuacr.azurecr.io/opengeni-desktop@sha256:c3bd17b8841de1bff9bb2777aad422cf8c75de78e2c30f9ac81d0cd6810a1b78";
86
+ export declare const DEFAULT_MODAL_IMAGE_REF = "opengenipublicneuacr.azurecr.io/opengeni-desktop@sha256:554d5b324a580071dd669e7c1190931e498eb1b397412a27c7de84a430ef393a";
79
87
  declare const SettingsSchema: z.ZodObject<{
80
88
  serviceName: z.ZodDefault<z.ZodString>;
81
89
  environment: z.ZodDefault<z.ZodString>;
82
90
  deploymentRevision: z.ZodDefault<z.ZodString>;
83
91
  serverVersion: z.ZodOptional<z.ZodString>;
84
92
  databaseUrl: z.ZodDefault<z.ZodString>;
93
+ apiDatabasePoolMax: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
85
94
  dbSchema: z.ZodDefault<z.ZodString>;
86
95
  rlsStrategy: z.ZodDefault<z.ZodEnum<{
87
96
  force: "force";
@@ -115,15 +124,22 @@ declare const SettingsSchema: z.ZodObject<{
115
124
  observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
116
125
  observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
117
126
  observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
127
+ observabilityDiagnosticsEndpoint: z.ZodOptional<z.ZodString>;
128
+ observabilityDiagnosticsHeaders: z.ZodDefault<z.ZodString>;
118
129
  analyticsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
119
130
  analyticsConsentRequired: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
120
131
  analyticsReoClientId: z.ZodOptional<z.ZodString>;
121
132
  analyticsPosthogProjectKey: z.ZodOptional<z.ZodString>;
122
133
  analyticsPosthogHost: z.ZodOptional<z.ZodString>;
123
134
  analyticsGa4MeasurementId: z.ZodOptional<z.ZodString>;
135
+ legalPrivacyPolicyUrl: z.ZodOptional<z.ZodString>;
136
+ legalTermsOfServiceUrl: z.ZodOptional<z.ZodString>;
137
+ supportEmail: z.ZodOptional<z.ZodString>;
124
138
  publicBaseUrl: z.ZodOptional<z.ZodString>;
139
+ documentationUrl: z.ZodPreprocess<z.ZodDefault<z.ZodNullable<z.ZodURL>>>;
125
140
  mcpOauthEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
126
- mcpOauthTrustedProxyHops: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
141
+ apiTrustedProxyHops: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
142
+ apiTrustedProxyCidrs: z.ZodDefault<z.ZodString>;
127
143
  webBaseUrl: z.ZodOptional<z.ZodString>;
128
144
  agentReleasesBaseUrl: z.ZodDefault<z.ZodString>;
129
145
  agentStableVersion: z.ZodDefault<z.ZodString>;
@@ -133,11 +149,19 @@ declare const SettingsSchema: z.ZodObject<{
133
149
  local: "local";
134
150
  managed: "managed";
135
151
  }>>;
136
- organizationTenancyCanonicalActivationEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
137
152
  billingMode: z.ZodDefault<z.ZodEnum<{
138
153
  disabled: "disabled";
139
154
  stripe: "stripe";
140
155
  }>>;
156
+ verifiedSignupTrialCreditsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
157
+ creditPromotionPolicy: z.ZodPreprocess<z.ZodDefault<z.ZodObject<{
158
+ defaultModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
159
+ signupModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
160
+ offers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
161
+ label: z.ZodString;
162
+ eligibleModelIds: z.ZodOptional<z.ZodPipe<z.ZodArray<z.ZodString>, z.ZodTransform<string[], string[]>>>;
163
+ }, z.core.$strict>>>;
164
+ }, z.core.$strict>>>;
141
165
  entitlementsMode: z.ZodDefault<z.ZodEnum<{
142
166
  managed: "managed";
143
167
  none: "none";
@@ -148,6 +172,7 @@ declare const SettingsSchema: z.ZodObject<{
148
172
  none: "none";
149
173
  static: "static";
150
174
  }>>;
175
+ usageAllowancesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
151
176
  staticEntitlementsJson: z.ZodDefault<z.ZodString>;
152
177
  staticUsageLimitsJson: z.ZodDefault<z.ZodString>;
153
178
  delegationSecret: z.ZodOptional<z.ZodString>;
@@ -167,11 +192,15 @@ declare const SettingsSchema: z.ZodObject<{
167
192
  browser_auth: "browser_auth";
168
193
  browser_clipboard: "browser_clipboard";
169
194
  browser_debug: "browser_debug";
195
+ browser_download_save: "browser_download_save";
196
+ browser_downloads: "browser_downloads";
170
197
  browser_identity: "browser_identity";
171
198
  browser_lifecycle: "browser_lifecycle";
172
199
  browser_observe: "browser_observe";
173
200
  browser_open: "browser_open";
174
201
  browser_publish: "browser_publish";
202
+ browser_read: "browser_read";
203
+ browser_screenshot: "browser_screenshot";
175
204
  browser_tabs: "browser_tabs";
176
205
  capability_authorization_request: "capability_authorization_request";
177
206
  capability_catalog_search: "capability_catalog_search";
@@ -185,7 +214,9 @@ declare const SettingsSchema: z.ZodObject<{
185
214
  computer_observe: "computer_observe";
186
215
  computer_open: "computer_open";
187
216
  computer_targets: "computer_targets";
217
+ connected_machine_enroll_token: "connected_machine_enroll_token";
188
218
  connected_machine_remove: "connected_machine_remove";
219
+ custom_mcp_setup_request: "custom_mcp_setup_request";
189
220
  editable_artifact_apply: "editable_artifact_apply";
190
221
  editable_artifact_create: "editable_artifact_create";
191
222
  editable_artifact_export: "editable_artifact_export";
@@ -214,11 +245,21 @@ declare const SettingsSchema: z.ZodObject<{
214
245
  goal_resume: "goal_resume";
215
246
  goal_set: "goal_set";
216
247
  goal_update: "goal_update";
248
+ instruction_policy_get: "instruction_policy_get";
217
249
  instruction_policy_propose: "instruction_policy_propose";
250
+ instruction_policy_save: "instruction_policy_save";
218
251
  interaction_discover: "interaction_discover";
219
252
  interaction_request_human: "interaction_request_human";
253
+ knowledge_archive: "knowledge_archive";
254
+ knowledge_browse: "knowledge_browse";
220
255
  knowledge_correct: "knowledge_correct";
256
+ knowledge_get: "knowledge_get";
257
+ knowledge_prepare_save: "knowledge_prepare_save";
221
258
  knowledge_propose: "knowledge_propose";
259
+ knowledge_retain_file: "knowledge_retain_file";
260
+ knowledge_retain_message: "knowledge_retain_message";
261
+ knowledge_save: "knowledge_save";
262
+ knowledge_search: "knowledge_search";
222
263
  memory_correct: "memory_correct";
223
264
  memory_save: "memory_save";
224
265
  memory_search: "memory_search";
@@ -266,6 +307,7 @@ declare const SettingsSchema: z.ZodObject<{
266
307
  session_pause: "session_pause";
267
308
  session_resume: "session_resume";
268
309
  session_send_message: "session_send_message";
310
+ session_set_model: "session_set_model";
269
311
  session_set_project: "session_set_project";
270
312
  session_steer: "session_steer";
271
313
  session_wait: "session_wait";
@@ -280,8 +322,11 @@ declare const SettingsSchema: z.ZodObject<{
280
322
  slack_bot_list_files: "slack_bot_list_files";
281
323
  slack_bot_list_users: "slack_bot_list_users";
282
324
  slack_bot_post_message: "slack_bot_post_message";
325
+ slack_bot_prepare_message: "slack_bot_prepare_message";
283
326
  slack_bot_search: "slack_bot_search";
327
+ slack_bot_send_prepared_message: "slack_bot_send_prepared_message";
284
328
  slack_bot_thread_replies: "slack_bot_thread_replies";
329
+ slack_bot_upload_file: "slack_bot_upload_file";
285
330
  social_connections_list: "social_connections_list";
286
331
  social_daily_analysis_context: "social_daily_analysis_context";
287
332
  social_mentions_live: "social_mentions_live";
@@ -326,11 +371,15 @@ declare const SettingsSchema: z.ZodObject<{
326
371
  browser_auth: "browser_auth";
327
372
  browser_clipboard: "browser_clipboard";
328
373
  browser_debug: "browser_debug";
374
+ browser_download_save: "browser_download_save";
375
+ browser_downloads: "browser_downloads";
329
376
  browser_identity: "browser_identity";
330
377
  browser_lifecycle: "browser_lifecycle";
331
378
  browser_observe: "browser_observe";
332
379
  browser_open: "browser_open";
333
380
  browser_publish: "browser_publish";
381
+ browser_read: "browser_read";
382
+ browser_screenshot: "browser_screenshot";
334
383
  browser_tabs: "browser_tabs";
335
384
  capability_authorization_request: "capability_authorization_request";
336
385
  capability_catalog_search: "capability_catalog_search";
@@ -344,7 +393,9 @@ declare const SettingsSchema: z.ZodObject<{
344
393
  computer_observe: "computer_observe";
345
394
  computer_open: "computer_open";
346
395
  computer_targets: "computer_targets";
396
+ connected_machine_enroll_token: "connected_machine_enroll_token";
347
397
  connected_machine_remove: "connected_machine_remove";
398
+ custom_mcp_setup_request: "custom_mcp_setup_request";
348
399
  editable_artifact_apply: "editable_artifact_apply";
349
400
  editable_artifact_create: "editable_artifact_create";
350
401
  editable_artifact_export: "editable_artifact_export";
@@ -373,11 +424,21 @@ declare const SettingsSchema: z.ZodObject<{
373
424
  goal_resume: "goal_resume";
374
425
  goal_set: "goal_set";
375
426
  goal_update: "goal_update";
427
+ instruction_policy_get: "instruction_policy_get";
376
428
  instruction_policy_propose: "instruction_policy_propose";
429
+ instruction_policy_save: "instruction_policy_save";
377
430
  interaction_discover: "interaction_discover";
378
431
  interaction_request_human: "interaction_request_human";
432
+ knowledge_archive: "knowledge_archive";
433
+ knowledge_browse: "knowledge_browse";
379
434
  knowledge_correct: "knowledge_correct";
435
+ knowledge_get: "knowledge_get";
436
+ knowledge_prepare_save: "knowledge_prepare_save";
380
437
  knowledge_propose: "knowledge_propose";
438
+ knowledge_retain_file: "knowledge_retain_file";
439
+ knowledge_retain_message: "knowledge_retain_message";
440
+ knowledge_save: "knowledge_save";
441
+ knowledge_search: "knowledge_search";
381
442
  memory_correct: "memory_correct";
382
443
  memory_save: "memory_save";
383
444
  memory_search: "memory_search";
@@ -425,6 +486,7 @@ declare const SettingsSchema: z.ZodObject<{
425
486
  session_pause: "session_pause";
426
487
  session_resume: "session_resume";
427
488
  session_send_message: "session_send_message";
489
+ session_set_model: "session_set_model";
428
490
  session_set_project: "session_set_project";
429
491
  session_steer: "session_steer";
430
492
  session_wait: "session_wait";
@@ -439,8 +501,11 @@ declare const SettingsSchema: z.ZodObject<{
439
501
  slack_bot_list_files: "slack_bot_list_files";
440
502
  slack_bot_list_users: "slack_bot_list_users";
441
503
  slack_bot_post_message: "slack_bot_post_message";
504
+ slack_bot_prepare_message: "slack_bot_prepare_message";
442
505
  slack_bot_search: "slack_bot_search";
506
+ slack_bot_send_prepared_message: "slack_bot_send_prepared_message";
443
507
  slack_bot_thread_replies: "slack_bot_thread_replies";
508
+ slack_bot_upload_file: "slack_bot_upload_file";
444
509
  social_connections_list: "social_connections_list";
445
510
  social_daily_analysis_context: "social_daily_analysis_context";
446
511
  social_mentions_live: "social_mentions_live";
@@ -479,11 +544,17 @@ declare const SettingsSchema: z.ZodObject<{
479
544
  environmentsEncryptionKey: z.ZodOptional<z.ZodString>;
480
545
  integrationsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
481
546
  integrationsStateSecret: z.ZodOptional<z.ZodString>;
547
+ integrationsOauthShortStateEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
482
548
  integrationsAllowPrivateNetworkTargets: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
483
549
  integrationsOauthClientsJson: z.ZodDefault<z.ZodString>;
550
+ gmailWatchTopicName: z.ZodOptional<z.ZodString>;
484
551
  slackClientId: z.ZodOptional<z.ZodString>;
485
552
  slackClientSecret: z.ZodOptional<z.ZodString>;
486
553
  slackSigningSecret: z.ZodOptional<z.ZodString>;
554
+ slackAccessMode: z.ZodDefault<z.ZodEnum<{
555
+ full: "full";
556
+ limited: "limited";
557
+ }>>;
487
558
  slackBotDisplayName: z.ZodDefault<z.ZodEnum<{
488
559
  OpenGeni: "OpenGeni";
489
560
  "OpenGeni Staging": "OpenGeni Staging";
@@ -513,8 +584,6 @@ declare const SettingsSchema: z.ZodObject<{
513
584
  goalIdleBackoffMs: z.ZodDefault<z.ZodPreprocess<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>>;
514
585
  goalIdleBackoffMaxMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
515
586
  childLifecycleNoticesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
516
- hostMcpAuthoritySourceAdmissionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
517
- hostMcpCredentialResolversJson: z.ZodOptional<z.ZodString>;
518
587
  slackWorkspaceRoutingEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
519
588
  agentMaxModelCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
520
589
  contextWindowTokens: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -529,10 +598,12 @@ declare const SettingsSchema: z.ZodObject<{
529
598
  authAllowMetrics: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
530
599
  apiHost: z.ZodDefault<z.ZodString>;
531
600
  apiPort: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
601
+ apiMetricsPort: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
532
602
  workerHttpPort: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
533
603
  opengeniMcpInternalUrl: z.ZodOptional<z.ZodString>;
534
604
  opengeniMcpUrl: z.ZodOptional<z.ZodString>;
535
605
  corsAllowOriginRegex: z.ZodDefault<z.ZodString>;
606
+ localAllowedOrigins: z.ZodOptional<z.ZodString>;
536
607
  openaiProvider: z.ZodDefault<z.ZodEnum<{
537
608
  azure: "azure";
538
609
  openai: "openai";
@@ -582,9 +653,11 @@ declare const SettingsSchema: z.ZodObject<{
582
653
  openrouterApiKey: z.ZodOptional<z.ZodString>;
583
654
  resolvedGatewayModelsJson: z.ZodOptional<z.ZodString>;
584
655
  resolvedOpenRouterModelsJson: z.ZodOptional<z.ZodString>;
656
+ resolvedCodexModelsJson: z.ZodOptional<z.ZodString>;
585
657
  modelProvidersJson: z.ZodDefault<z.ZodString>;
586
658
  codexSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
587
659
  supergrokSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
660
+ claudeSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
588
661
  supergrokResponseStreamIdleTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
589
662
  codexConnectedAppsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
590
663
  codexProductSku: z.ZodOptional<z.ZodString>;
@@ -592,6 +665,7 @@ declare const SettingsSchema: z.ZodObject<{
592
665
  lazyToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
593
666
  codexFleetPolicyShadowEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
594
667
  codexRotationNearExhaustionPct: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
668
+ reasoningConfigurationUpdatesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
595
669
  openaiReasoningEffort: z.ZodDefault<z.ZodEnum<{
596
670
  high: "high";
597
671
  low: "low";
@@ -602,6 +676,16 @@ declare const SettingsSchema: z.ZodObject<{
602
676
  xhigh: "xhigh";
603
677
  }>>;
604
678
  openaiAllowedReasoningEfforts: z.ZodDefault<z.ZodString>;
679
+ creditsDefaultModel: z.ZodDefault<z.ZodString>;
680
+ creditsDefaultReasoningEffort: z.ZodDefault<z.ZodEnum<{
681
+ high: "high";
682
+ low: "low";
683
+ max: "max";
684
+ medium: "medium";
685
+ minimal: "minimal";
686
+ none: "none";
687
+ xhigh: "xhigh";
688
+ }>>;
605
689
  openaiResponsesTransport: z.ZodDefault<z.ZodEnum<{
606
690
  http: "http";
607
691
  websocket: "websocket";
@@ -613,6 +697,16 @@ declare const SettingsSchema: z.ZodObject<{
613
697
  openaiReasoningEncryptedContent: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
614
698
  openaiMaxRetries: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
615
699
  webSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
700
+ jevApiKey: z.ZodOptional<z.ZodString>;
701
+ jevBaseUrl: z.ZodDefault<z.ZodString>;
702
+ jevModel: z.ZodDefault<z.ZodString>;
703
+ jevRequestTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
704
+ codeSearchMode: z.ZodDefault<z.ZodEnum<{
705
+ default_on: "default_on";
706
+ experiment: "experiment";
707
+ off: "off";
708
+ opt_in: "opt_in";
709
+ }>>;
616
710
  agentInstructionsTemplate: z.ZodDefault<z.ZodString>;
617
711
  azureOpenaiBaseUrl: z.ZodOptional<z.ZodString>;
618
712
  azureOpenaiEndpoint: z.ZodOptional<z.ZodString>;
@@ -642,6 +736,7 @@ declare const SettingsSchema: z.ZodObject<{
642
736
  dockerWorkspaceBaseDir: z.ZodOptional<z.ZodString>;
643
737
  modalAppName: z.ZodDefault<z.ZodString>;
644
738
  modalImageRef: z.ZodOptional<z.ZodString>;
739
+ modalCommandSupervisionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
645
740
  modalImageId: z.ZodOptional<z.ZodString>;
646
741
  modalImageRegistrySecret: z.ZodOptional<z.ZodString>;
647
742
  modalTimeoutSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -706,6 +801,7 @@ declare const SettingsSchema: z.ZodObject<{
706
801
  blaxelTtl: z.ZodOptional<z.ZodString>;
707
802
  cloudflareWorkerUrl: z.ZodOptional<z.ZodString>;
708
803
  cloudflareApiKey: z.ZodOptional<z.ZodString>;
804
+ experimentalBrowserContextPoolEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
709
805
  browserbaseApiKey: z.ZodOptional<z.ZodString>;
710
806
  kernelApiKey: z.ZodOptional<z.ZodString>;
711
807
  kernelEndpoint: z.ZodOptional<z.ZodString>;
@@ -748,6 +844,7 @@ declare const SettingsSchema: z.ZodObject<{
748
844
  sandboxViewerHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
749
845
  sandboxInteractionHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
750
846
  sandboxIdleGraceMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
847
+ sandboxIdleCommandContainmentMs: z.ZodPipe<z.ZodOptional<z.ZodCoercedNumber<unknown>>, z.ZodTransform<number | undefined, number | undefined>>;
751
848
  sandboxSnapshotIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
752
849
  sandboxSnapshotTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
753
850
  sandboxDrainSnapshotTimeoutMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -759,9 +856,15 @@ declare const SettingsSchema: z.ZodObject<{
759
856
  workspaceControlLockTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
760
857
  rigSetupTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
761
858
  sandboxWarmRateMicrosPerSecondJson: z.ZodDefault<z.ZodString>;
859
+ sandboxWarmBillingMode: z.ZodDefault<z.ZodEnum<{
860
+ credits: "credits";
861
+ shadow: "shadow";
862
+ usage_only: "usage_only";
863
+ }>>;
762
864
  sandboxMaxWarmSecondsPerWorkspace: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
763
865
  sandboxPreparationProfiles: z.ZodDefault<z.ZodString>;
764
866
  sandboxEnvAllowlist: z.ZodDefault<z.ZodString>;
867
+ sandboxImageAllowlist: z.ZodDefault<z.ZodString>;
765
868
  objectStorageEndpoint: z.ZodOptional<z.ZodString>;
766
869
  objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
767
870
  objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
@@ -796,6 +899,13 @@ declare const SettingsSchema: z.ZodObject<{
796
899
  documentEmbeddingDimensions: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
797
900
  documentEmbeddingApiKey: z.ZodOptional<z.ZodString>;
798
901
  documentEmbeddingBaseUrl: z.ZodOptional<z.ZodString>;
902
+ documentEmbeddingBillingMode: z.ZodDefault<z.ZodEnum<{
903
+ credits: "credits";
904
+ shadow: "shadow";
905
+ usage_only: "usage_only";
906
+ }>>;
907
+ documentEmbeddingCreditsActivatedAt: z.ZodOptional<z.ZodISODateTime>;
908
+ documentEmbeddingRateMicrosPerMillionBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
799
909
  documentCurationProvider: z.ZodDefault<z.ZodEnum<{
800
910
  heuristic: "heuristic";
801
911
  none: "none";
@@ -834,11 +944,13 @@ declare const SettingsSchema: z.ZodObject<{
834
944
  managedAuthGoogleClientSecret: z.ZodOptional<z.ZodString>;
835
945
  managedAuthGithubClientId: z.ZodOptional<z.ZodString>;
836
946
  managedAuthGithubClientSecret: z.ZodOptional<z.ZodString>;
947
+ allowedUserEmails: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>>>;
837
948
  managedAuthSessionSetMode: z.ZodDefault<z.ZodEnum<{
838
949
  broker: "broker";
839
950
  dual: "dual";
840
951
  legacy: "legacy";
841
952
  }>>;
953
+ managedAuthNewSignupsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
842
954
  organizationUserSetupEmailTokenTransport: z.ZodDefault<z.ZodEnum<{
843
955
  fragment: "fragment";
844
956
  query: "query";
@@ -861,6 +973,14 @@ declare const SettingsSchema: z.ZodObject<{
861
973
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
862
974
  connectionRef: z.ZodOptional<z.ZodObject<{
863
975
  connectionId: z.ZodOptional<z.ZodString>;
976
+ accountSelection: z.ZodOptional<z.ZodLiteral<"all_eligible">>;
977
+ authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
978
+ hostBinding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
979
+ bindingId: z.ZodString;
980
+ generation: z.ZodNumber;
981
+ }, z.core.$strict>, z.ZodObject<{
982
+ selection: z.ZodLiteral<"accepted_turn">;
983
+ }, z.core.$strict>]>>;
864
984
  provider: z.ZodOptional<z.ZodString>;
865
985
  providerDomain: z.ZodString;
866
986
  kind: z.ZodOptional<z.ZodEnum<{
@@ -875,11 +995,6 @@ declare const SettingsSchema: z.ZodObject<{
875
995
  id: z.ZodString;
876
996
  kind: z.ZodLiteral<"repository">;
877
997
  }, z.core.$strict>>>;
878
- authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
879
- hostBinding: z.ZodOptional<z.ZodObject<{
880
- bindingId: z.ZodString;
881
- generation: z.ZodNumber;
882
- }, z.core.$strict>>;
883
998
  subjectScope: z.ZodOptional<z.ZodEnum<{
884
999
  subject: "subject";
885
1000
  workspace: "workspace";
@@ -891,6 +1006,88 @@ declare const SettingsSchema: z.ZodObject<{
891
1006
  }, z.core.$strip>>>;
892
1007
  }, z.core.$strip>;
893
1008
  export type Settings = z.infer<typeof SettingsSchema>;
1009
+ declare const ArtifactOutboxSettingsSchema: z.ZodObject<{
1010
+ serviceName: z.ZodDefault<z.ZodString>;
1011
+ environment: z.ZodDefault<z.ZodString>;
1012
+ deploymentRevision: z.ZodDefault<z.ZodString>;
1013
+ dbSchema: z.ZodDefault<z.ZodString>;
1014
+ rlsStrategy: z.ZodDefault<z.ZodEnum<{
1015
+ force: "force";
1016
+ scoped: "scoped";
1017
+ }>>;
1018
+ observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1019
+ observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1020
+ observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
1021
+ observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
1022
+ natsUrl: z.ZodDefault<z.ZodString>;
1023
+ selfhostedNatsControlUser: z.ZodOptional<z.ZodString>;
1024
+ selfhostedNatsControlPassword: z.ZodOptional<z.ZodString>;
1025
+ }, z.core.$strip>;
1026
+ declare const ObjectStorageSettingsSchema: z.ZodObject<{
1027
+ objectStorageEndpoint: z.ZodOptional<z.ZodString>;
1028
+ objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
1029
+ objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
1030
+ objectStorageBackend: z.ZodDefault<z.ZodEnum<{
1031
+ "aws-s3": "aws-s3";
1032
+ "azure-blob": "azure-blob";
1033
+ gcs: "gcs";
1034
+ "s3-compatible": "s3-compatible";
1035
+ }>>;
1036
+ objectStorageBucket: z.ZodDefault<z.ZodString>;
1037
+ objectStorageRegion: z.ZodDefault<z.ZodString>;
1038
+ objectStorageAccessKeyId: z.ZodOptional<z.ZodString>;
1039
+ objectStorageSecretAccessKey: z.ZodOptional<z.ZodString>;
1040
+ objectStorageForcePathStyle: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1041
+ objectStorageAzureConnectionString: z.ZodOptional<z.ZodString>;
1042
+ objectStorageAzureAccountName: z.ZodOptional<z.ZodString>;
1043
+ objectStorageAzureAccountKey: z.ZodOptional<z.ZodString>;
1044
+ objectStorageAzureEndpoint: z.ZodOptional<z.ZodString>;
1045
+ objectStorageGcsProjectId: z.ZodOptional<z.ZodString>;
1046
+ objectStorageGcsCredentialsJson: z.ZodOptional<z.ZodString>;
1047
+ objectStorageGcsKeyFilename: z.ZodOptional<z.ZodString>;
1048
+ objectStorageGcsApiEndpoint: z.ZodOptional<z.ZodString>;
1049
+ }, z.core.$strip>;
1050
+ declare const ArtifactMaterializerSettingsSchema: z.ZodObject<{
1051
+ serviceName: z.ZodDefault<z.ZodString>;
1052
+ environment: z.ZodDefault<z.ZodString>;
1053
+ deploymentRevision: z.ZodDefault<z.ZodString>;
1054
+ dbSchema: z.ZodDefault<z.ZodString>;
1055
+ rlsStrategy: z.ZodDefault<z.ZodEnum<{
1056
+ force: "force";
1057
+ scoped: "scoped";
1058
+ }>>;
1059
+ observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1060
+ observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1061
+ observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
1062
+ observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
1063
+ objectStorageEndpoint: z.ZodOptional<z.ZodString>;
1064
+ objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
1065
+ objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
1066
+ objectStorageBackend: z.ZodDefault<z.ZodEnum<{
1067
+ "aws-s3": "aws-s3";
1068
+ "azure-blob": "azure-blob";
1069
+ gcs: "gcs";
1070
+ "s3-compatible": "s3-compatible";
1071
+ }>>;
1072
+ objectStorageBucket: z.ZodDefault<z.ZodString>;
1073
+ objectStorageRegion: z.ZodDefault<z.ZodString>;
1074
+ objectStorageAccessKeyId: z.ZodOptional<z.ZodString>;
1075
+ objectStorageSecretAccessKey: z.ZodOptional<z.ZodString>;
1076
+ objectStorageForcePathStyle: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1077
+ objectStorageAzureConnectionString: z.ZodOptional<z.ZodString>;
1078
+ objectStorageAzureAccountName: z.ZodOptional<z.ZodString>;
1079
+ objectStorageAzureAccountKey: z.ZodOptional<z.ZodString>;
1080
+ objectStorageAzureEndpoint: z.ZodOptional<z.ZodString>;
1081
+ objectStorageGcsProjectId: z.ZodOptional<z.ZodString>;
1082
+ objectStorageGcsCredentialsJson: z.ZodOptional<z.ZodString>;
1083
+ objectStorageGcsKeyFilename: z.ZodOptional<z.ZodString>;
1084
+ objectStorageGcsApiEndpoint: z.ZodOptional<z.ZodString>;
1085
+ }, z.core.$strip>;
1086
+ export type ArtifactOutboxSettings = z.infer<typeof ArtifactOutboxSettingsSchema>;
1087
+ export type ObjectStorageSettings = z.infer<typeof ObjectStorageSettingsSchema>;
1088
+ export type ArtifactMaterializerSettings = z.infer<typeof ArtifactMaterializerSettingsSchema>;
1089
+ export declare function getArtifactOutboxSettings(source?: NodeJS.ProcessEnv): ArtifactOutboxSettings;
1090
+ export declare function getArtifactMaterializerSettings(source?: NodeJS.ProcessEnv): ArtifactMaterializerSettings;
894
1091
  export type McpServerConfig = Settings["mcpServers"][number];
895
1092
  export type GoogleDriveProviderRetryOptions = {
896
1093
  requestTimeoutMs: number;
@@ -945,6 +1142,17 @@ export type VoiceInputProviderConfig = {
945
1142
  kind: "supergrok-subscription";
946
1143
  experimental: true;
947
1144
  };
1145
+ /** The deployment's Jev key, or undefined when it is missing or a placeholder. */
1146
+ export declare function usableJevApiKey(settings: Pick<Settings, "jevApiKey">): string | undefined;
1147
+ /** Deployment half of agent configuration: hard capability limits. */
1148
+ export declare function agentConfigDeploymentPolicy(settings: Pick<Settings, "webSearchEnabled" | "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">): AgentConfigDeploymentLimits;
1149
+ /**
1150
+ * Deployment half of the `code_search` decision. `available` is false when
1151
+ * the mode is off or no usable Jev key is configured; workspaces then cannot
1152
+ * turn it on. `workspaceDefault` applies to workspaces without their own
1153
+ * setting.
1154
+ */
1155
+ export declare function codeSearchDeploymentPolicy(settings: Pick<Settings, "codeSearchMode" | "jevApiKey">): CodeSearchDeploymentPolicy;
948
1156
  /**
949
1157
  * Reject empty / template secrets so `.env.example` placeholders like
950
1158
  * `your-key` cannot advertise voice input as available and then 401 upstream.
@@ -998,6 +1206,24 @@ export type ModelUsageCostBreakdown = {
998
1206
  /** OpenGeni credit price after configured margin and latency-mode multiplier. */
999
1207
  creditCostMicros: number;
1000
1208
  };
1209
+ export type ModelListCostClassesMicros = {
1210
+ uncachedInput: number;
1211
+ cacheRead: number;
1212
+ cacheWrite: number;
1213
+ output: number;
1214
+ };
1215
+ export type ModelListUsageCostSnapshot = ModelUsageCostBreakdown & {
1216
+ /** Captured upstream list costs, summing to providerCostMicros, never debits. */
1217
+ listByClassMicros: ModelListCostClassesMicros | null;
1218
+ /** True only when a returned class split includes latency rounding allocation. */
1219
+ listByClassApprox: boolean;
1220
+ };
1221
+ export type ModelRecordedListCostAllocation = {
1222
+ /** Approximate attribution of a stored upstream total, never a new price. */
1223
+ listByClassMicros: ModelListCostClassesMicros | null;
1224
+ /** True for every eligible historical allocation, including known zero. */
1225
+ listByClassApprox: boolean;
1226
+ };
1001
1227
  export type StaticUsageLimitsConfig = StaticUsageLimits;
1002
1228
  export type EntitlementsConfig = Entitlements;
1003
1229
  export declare const CapabilitySupportV1: z.ZodEnum<{
@@ -1174,7 +1400,7 @@ export type CredentialSourceV1 = {
1174
1400
  mechanism: "api_key" | "azure_ad_bearer" | "none";
1175
1401
  } | {
1176
1402
  kind: "connected_subscription";
1177
- provider: "codex" | "xai";
1403
+ provider: "codex" | "xai" | "claude";
1178
1404
  } | {
1179
1405
  kind: "workspace_connection";
1180
1406
  mechanism: "api_key";
@@ -1194,6 +1420,7 @@ export type BillingAttributionV1 = {
1194
1420
  * silently no-ops hosted tools (see docs/model-providers.md).
1195
1421
  */
1196
1422
  export declare const ModelProviderApi: z.ZodEnum<{
1423
+ "anthropic-messages": "anthropic-messages";
1197
1424
  chat: "chat";
1198
1425
  responses: "responses";
1199
1426
  }>;
@@ -1216,8 +1443,14 @@ export type ModelProviderWireProfile = z.infer<typeof ModelProviderWireProfile>;
1216
1443
  */
1217
1444
  export declare const RegistryProviderKind: z.ZodEnum<{
1218
1445
  anonymous: "anonymous";
1446
+ "anthropic-organization": "anthropic-organization";
1447
+ "anthropic-workspace": "anthropic-workspace";
1219
1448
  "api-key": "api-key";
1449
+ "claude-subscription-organization": "claude-subscription-organization";
1450
+ "claude-subscription-workspace": "claude-subscription-workspace";
1220
1451
  "codex-subscription": "codex-subscription";
1452
+ "direct-azure-workspace": "direct-azure-workspace";
1453
+ "direct-openai-workspace": "direct-openai-workspace";
1221
1454
  "openrouter-organization": "openrouter-organization";
1222
1455
  "openrouter-workspace": "openrouter-workspace";
1223
1456
  "vercel-gateway-managed": "vercel-gateway-managed";
@@ -1227,11 +1460,56 @@ export declare const RegistryProviderKind: z.ZodEnum<{
1227
1460
  }>;
1228
1461
  export type RegistryProviderKind = z.infer<typeof RegistryProviderKind>;
1229
1462
  /** A non-built-in provider declared by the host via OPENGENI_MODEL_PROVIDERS_JSON. */
1463
+ export declare const ClaudeSubscriptionIdentity: z.ZodObject<{
1464
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1465
+ deviceId: z.ZodString;
1466
+ }, z.core.$strict>;
1467
+ export type ClaudeSubscriptionIdentity = z.infer<typeof ClaudeSubscriptionIdentity>;
1468
+ export declare const ClaudeSubscriptionCredential: z.ZodObject<{
1469
+ version: z.ZodLiteral<1>;
1470
+ token: z.ZodString;
1471
+ identity: z.ZodObject<{
1472
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1473
+ deviceId: z.ZodString;
1474
+ }, z.core.$strict>;
1475
+ oauth: z.ZodOptional<z.ZodObject<{
1476
+ refreshToken: z.ZodString;
1477
+ expiresAt: z.ZodString;
1478
+ scopes: z.ZodArray<z.ZodString>;
1479
+ }, z.core.$strict>>;
1480
+ }, z.core.$strict>;
1481
+ declare const AnthropicProviderOptions: z.ZodObject<{
1482
+ identity: z.ZodOptional<z.ZodObject<{
1483
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1484
+ deviceId: z.ZodString;
1485
+ }, z.core.$strict>>;
1486
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1487
+ connectionId: z.ZodString;
1488
+ credentialVersion: z.ZodNumber;
1489
+ }, z.core.$strict>>;
1490
+ auth: z.ZodDefault<z.ZodEnum<{
1491
+ "api-key": "api-key";
1492
+ oauth: "oauth";
1493
+ }>>;
1494
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1495
+ "1h": "1h";
1496
+ "5m": "5m";
1497
+ off: "off";
1498
+ }>>;
1499
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1500
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1501
+ }, z.core.$strip>;
1230
1502
  declare const RegistryProviderSchema: z.ZodObject<{
1231
1503
  kind: z.ZodDefault<z.ZodEnum<{
1232
1504
  anonymous: "anonymous";
1505
+ "anthropic-organization": "anthropic-organization";
1506
+ "anthropic-workspace": "anthropic-workspace";
1233
1507
  "api-key": "api-key";
1508
+ "claude-subscription-organization": "claude-subscription-organization";
1509
+ "claude-subscription-workspace": "claude-subscription-workspace";
1234
1510
  "codex-subscription": "codex-subscription";
1511
+ "direct-azure-workspace": "direct-azure-workspace";
1512
+ "direct-openai-workspace": "direct-openai-workspace";
1235
1513
  "openrouter-organization": "openrouter-organization";
1236
1514
  "openrouter-workspace": "openrouter-workspace";
1237
1515
  "vercel-gateway-managed": "vercel-gateway-managed";
@@ -1242,9 +1520,31 @@ declare const RegistryProviderSchema: z.ZodObject<{
1242
1520
  id: z.ZodString;
1243
1521
  label: z.ZodOptional<z.ZodString>;
1244
1522
  api: z.ZodDefault<z.ZodEnum<{
1523
+ "anthropic-messages": "anthropic-messages";
1245
1524
  chat: "chat";
1246
1525
  responses: "responses";
1247
1526
  }>>;
1527
+ anthropic: z.ZodOptional<z.ZodObject<{
1528
+ identity: z.ZodOptional<z.ZodObject<{
1529
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1530
+ deviceId: z.ZodString;
1531
+ }, z.core.$strict>>;
1532
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1533
+ connectionId: z.ZodString;
1534
+ credentialVersion: z.ZodNumber;
1535
+ }, z.core.$strict>>;
1536
+ auth: z.ZodDefault<z.ZodEnum<{
1537
+ "api-key": "api-key";
1538
+ oauth: "oauth";
1539
+ }>>;
1540
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1541
+ "1h": "1h";
1542
+ "5m": "5m";
1543
+ off: "off";
1544
+ }>>;
1545
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1546
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1547
+ }, z.core.$strip>>;
1248
1548
  wireProfile: z.ZodDefault<z.ZodEnum<{
1249
1549
  "azure-openai": "azure-openai";
1250
1550
  openai: "openai";
@@ -1264,6 +1564,7 @@ declare const RegistryProviderSchema: z.ZodObject<{
1264
1564
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
1265
1565
  label: z.ZodOptional<z.ZodString>;
1266
1566
  shortLabel: z.ZodOptional<z.ZodString>;
1567
+ logoUrl: z.ZodOptional<z.ZodString>;
1267
1568
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
1268
1569
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
1269
1570
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -1477,6 +1778,7 @@ export declare const GatewayCatalogModel: z.ZodObject<{
1477
1778
  upstreamModelId: z.ZodString;
1478
1779
  label: z.ZodString;
1479
1780
  shortLabel: z.ZodOptional<z.ZodString>;
1781
+ logoUrl: z.ZodOptional<z.ZodString>;
1480
1782
  providers: z.ZodArray<z.ZodString>;
1481
1783
  implicitCaching: z.ZodDefault<z.ZodBoolean>;
1482
1784
  vision: z.ZodDefault<z.ZodBoolean>;
@@ -1518,6 +1820,7 @@ export declare const OpenRouterCatalogModel: z.ZodObject<{
1518
1820
  upstreamModelId: z.ZodString;
1519
1821
  label: z.ZodString;
1520
1822
  shortLabel: z.ZodOptional<z.ZodString>;
1823
+ logoUrl: z.ZodOptional<z.ZodString>;
1521
1824
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
1522
1825
  capabilities: z.ZodObject<{
1523
1826
  reasoning: z.ZodObject<{
@@ -1680,9 +1983,31 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1680
1983
  id: z.ZodString;
1681
1984
  label: z.ZodOptional<z.ZodString>;
1682
1985
  api: z.ZodDefault<z.ZodEnum<{
1986
+ "anthropic-messages": "anthropic-messages";
1683
1987
  chat: "chat";
1684
1988
  responses: "responses";
1685
1989
  }>>;
1990
+ anthropic: z.ZodOptional<z.ZodObject<{
1991
+ identity: z.ZodOptional<z.ZodObject<{
1992
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1993
+ deviceId: z.ZodString;
1994
+ }, z.core.$strict>>;
1995
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1996
+ connectionId: z.ZodString;
1997
+ credentialVersion: z.ZodNumber;
1998
+ }, z.core.$strict>>;
1999
+ auth: z.ZodDefault<z.ZodEnum<{
2000
+ "api-key": "api-key";
2001
+ oauth: "oauth";
2002
+ }>>;
2003
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
2004
+ "1h": "1h";
2005
+ "5m": "5m";
2006
+ off: "off";
2007
+ }>>;
2008
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
2009
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
2010
+ }, z.core.$strip>>;
1686
2011
  wireProfile: z.ZodDefault<z.ZodEnum<{
1687
2012
  "azure-openai": "azure-openai";
1688
2013
  openai: "openai";
@@ -1700,6 +2025,7 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1700
2025
  aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
1701
2026
  label: z.ZodOptional<z.ZodString>;
1702
2027
  shortLabel: z.ZodOptional<z.ZodString>;
2028
+ logoUrl: z.ZodOptional<z.ZodString>;
1703
2029
  contextWindowTokens: z.ZodOptional<z.ZodNumber>;
1704
2030
  effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
1705
2031
  autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
@@ -1860,12 +2186,334 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1860
2186
  publicDefaultHeaderNames: z.ZodOptional<z.ZodNever>;
1861
2187
  publicDefaultQueryNames: z.ZodOptional<z.ZodNever>;
1862
2188
  }, z.core.$strict>>>;
2189
+ codexModels: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
2190
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
2191
+ label: z.ZodOptional<z.ZodString>;
2192
+ shortLabel: z.ZodOptional<z.ZodString>;
2193
+ logoUrl: z.ZodOptional<z.ZodString>;
2194
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
2195
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
2196
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
2197
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
2198
+ reasoningEffort: z.ZodOptional<z.ZodBoolean>;
2199
+ hostedWebSearch: z.ZodOptional<z.ZodBoolean>;
2200
+ credentialSource: z.ZodOptional<z.ZodNever>;
2201
+ billing: z.ZodOptional<z.ZodNever>;
2202
+ retired: z.ZodOptional<z.ZodBoolean>;
2203
+ id: z.ZodString;
2204
+ upstreamModelId: z.ZodString;
2205
+ capabilities: z.ZodObject<{
2206
+ reasoning: z.ZodObject<{
2207
+ upstream: z.ZodEnum<{
2208
+ supported: "supported";
2209
+ unknown: "unknown";
2210
+ unsupported: "unsupported";
2211
+ }>;
2212
+ runnable: z.ZodBoolean;
2213
+ efforts: z.ZodArray<z.ZodEnum<{
2214
+ high: "high";
2215
+ low: "low";
2216
+ max: "max";
2217
+ medium: "medium";
2218
+ minimal: "minimal";
2219
+ none: "none";
2220
+ xhigh: "xhigh";
2221
+ }>>;
2222
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
2223
+ high: "high";
2224
+ low: "low";
2225
+ max: "max";
2226
+ medium: "medium";
2227
+ minimal: "minimal";
2228
+ none: "none";
2229
+ xhigh: "xhigh";
2230
+ }>>;
2231
+ required: z.ZodBoolean;
2232
+ }, z.core.$strip>;
2233
+ functionCalling: z.ZodObject<{
2234
+ upstream: z.ZodEnum<{
2235
+ supported: "supported";
2236
+ unknown: "unknown";
2237
+ unsupported: "unsupported";
2238
+ }>;
2239
+ runnable: z.ZodBoolean;
2240
+ }, z.core.$strip>;
2241
+ structuredOutput: z.ZodObject<{
2242
+ upstream: z.ZodEnum<{
2243
+ supported: "supported";
2244
+ unknown: "unknown";
2245
+ unsupported: "unsupported";
2246
+ }>;
2247
+ runnable: z.ZodBoolean;
2248
+ }, z.core.$strip>;
2249
+ hostedTools: z.ZodObject<{
2250
+ webSearch: z.ZodObject<{
2251
+ upstream: z.ZodEnum<{
2252
+ supported: "supported";
2253
+ unknown: "unknown";
2254
+ unsupported: "unsupported";
2255
+ }>;
2256
+ runnable: z.ZodBoolean;
2257
+ }, z.core.$strip>;
2258
+ xSearch: z.ZodObject<{
2259
+ upstream: z.ZodEnum<{
2260
+ supported: "supported";
2261
+ unknown: "unknown";
2262
+ unsupported: "unsupported";
2263
+ }>;
2264
+ runnable: z.ZodBoolean;
2265
+ }, z.core.$strip>;
2266
+ codeExecution: z.ZodObject<{
2267
+ upstream: z.ZodEnum<{
2268
+ supported: "supported";
2269
+ unknown: "unknown";
2270
+ unsupported: "unsupported";
2271
+ }>;
2272
+ runnable: z.ZodBoolean;
2273
+ }, z.core.$strip>;
2274
+ imageGeneration: z.ZodDefault<z.ZodObject<{
2275
+ upstream: z.ZodEnum<{
2276
+ supported: "supported";
2277
+ unknown: "unknown";
2278
+ unsupported: "unsupported";
2279
+ }>;
2280
+ runnable: z.ZodBoolean;
2281
+ }, z.core.$strip>>;
2282
+ }, z.core.$strip>;
2283
+ inputModalities: z.ZodArray<z.ZodEnum<{
2284
+ audio: "audio";
2285
+ image: "image";
2286
+ text: "text";
2287
+ }>>;
2288
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
2289
+ outputModalities: z.ZodArray<z.ZodEnum<{
2290
+ audio: "audio";
2291
+ image: "image";
2292
+ text: "text";
2293
+ }>>;
2294
+ transports: z.ZodObject<{
2295
+ sse: z.ZodObject<{
2296
+ upstream: z.ZodEnum<{
2297
+ supported: "supported";
2298
+ unknown: "unknown";
2299
+ unsupported: "unsupported";
2300
+ }>;
2301
+ runnable: z.ZodBoolean;
2302
+ }, z.core.$strip>;
2303
+ responsesWebSocket: z.ZodObject<{
2304
+ upstream: z.ZodEnum<{
2305
+ supported: "supported";
2306
+ unknown: "unknown";
2307
+ unsupported: "unsupported";
2308
+ }>;
2309
+ runnable: z.ZodBoolean;
2310
+ }, z.core.$strip>;
2311
+ realtimeAudio: z.ZodObject<{
2312
+ upstream: z.ZodEnum<{
2313
+ supported: "supported";
2314
+ unknown: "unknown";
2315
+ unsupported: "unsupported";
2316
+ }>;
2317
+ runnable: z.ZodBoolean;
2318
+ }, z.core.$strip>;
2319
+ }, z.core.$strip>;
2320
+ promptCaching: z.ZodOptional<z.ZodObject<{
2321
+ upstream: z.ZodEnum<{
2322
+ supported: "supported";
2323
+ unknown: "unknown";
2324
+ unsupported: "unsupported";
2325
+ }>;
2326
+ runnable: z.ZodBoolean;
2327
+ mode: z.ZodEnum<{
2328
+ automatic: "automatic";
2329
+ implicit: "implicit";
2330
+ none: "none";
2331
+ }>;
2332
+ }, z.core.$strip>>;
2333
+ latencyModes: z.ZodArray<z.ZodObject<{
2334
+ id: z.ZodEnum<{
2335
+ fast: "fast";
2336
+ priority: "priority";
2337
+ standard: "standard";
2338
+ }>;
2339
+ upstream: z.ZodEnum<{
2340
+ supported: "supported";
2341
+ unknown: "unknown";
2342
+ unsupported: "unsupported";
2343
+ }>;
2344
+ runnable: z.ZodBoolean;
2345
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
2346
+ }, z.core.$strip>>;
2347
+ }, z.core.$strip>;
2348
+ pricing: z.ZodOptional<z.ZodNever>;
2349
+ }, z.core.$strict>, z.ZodTransform<{
2350
+ aliases?: string[] | undefined;
2351
+ label?: string | undefined;
2352
+ shortLabel?: string | undefined;
2353
+ logoUrl?: string | undefined;
2354
+ contextWindowTokens?: number | undefined;
2355
+ effectiveContextWindowTokens?: number | undefined;
2356
+ autoCompactTokenLimit?: number | undefined;
2357
+ toolOutputTruncationTokens?: number | undefined;
2358
+ reasoningEffort?: boolean | undefined;
2359
+ hostedWebSearch?: boolean | undefined;
2360
+ credentialSource?: undefined;
2361
+ billing?: undefined;
2362
+ retired?: boolean | undefined;
2363
+ id: string;
2364
+ upstreamModelId: string;
2365
+ pricing?: undefined;
2366
+ capabilities: {
2367
+ reasoning: {
2368
+ upstream: "supported" | "unknown" | "unsupported";
2369
+ runnable: boolean;
2370
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2371
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2372
+ required: boolean;
2373
+ };
2374
+ functionCalling: {
2375
+ upstream: "supported" | "unknown" | "unsupported";
2376
+ runnable: boolean;
2377
+ };
2378
+ structuredOutput: {
2379
+ upstream: "supported" | "unknown" | "unsupported";
2380
+ runnable: boolean;
2381
+ };
2382
+ hostedTools: {
2383
+ webSearch: {
2384
+ upstream: "supported" | "unknown" | "unsupported";
2385
+ runnable: boolean;
2386
+ };
2387
+ xSearch: {
2388
+ upstream: "supported" | "unknown" | "unsupported";
2389
+ runnable: boolean;
2390
+ };
2391
+ codeExecution: {
2392
+ upstream: "supported" | "unknown" | "unsupported";
2393
+ runnable: boolean;
2394
+ };
2395
+ imageGeneration: {
2396
+ upstream: "supported" | "unknown" | "unsupported";
2397
+ runnable: boolean;
2398
+ };
2399
+ };
2400
+ inputModalities: ("audio" | "image" | "text")[];
2401
+ inputFileMediaTypes: string[];
2402
+ outputModalities: ("audio" | "image" | "text")[];
2403
+ transports: {
2404
+ sse: {
2405
+ upstream: "supported" | "unknown" | "unsupported";
2406
+ runnable: boolean;
2407
+ };
2408
+ responsesWebSocket: {
2409
+ upstream: "supported" | "unknown" | "unsupported";
2410
+ runnable: boolean;
2411
+ };
2412
+ realtimeAudio: {
2413
+ upstream: "supported" | "unknown" | "unsupported";
2414
+ runnable: boolean;
2415
+ };
2416
+ };
2417
+ promptCaching?: {
2418
+ upstream: "supported" | "unknown" | "unsupported";
2419
+ runnable: boolean;
2420
+ mode: "automatic" | "implicit" | "none";
2421
+ } | undefined;
2422
+ latencyModes: {
2423
+ id: "fast" | "priority" | "standard";
2424
+ upstream: "supported" | "unknown" | "unsupported";
2425
+ runnable: boolean;
2426
+ billingMultiplierBps?: number | undefined;
2427
+ }[];
2428
+ };
2429
+ }, {
2430
+ aliases?: string[] | undefined;
2431
+ label?: string | undefined;
2432
+ shortLabel?: string | undefined;
2433
+ logoUrl?: string | undefined;
2434
+ contextWindowTokens?: number | undefined;
2435
+ effectiveContextWindowTokens?: number | undefined;
2436
+ autoCompactTokenLimit?: number | undefined;
2437
+ toolOutputTruncationTokens?: number | undefined;
2438
+ reasoningEffort?: boolean | undefined;
2439
+ hostedWebSearch?: boolean | undefined;
2440
+ credentialSource?: undefined;
2441
+ billing?: undefined;
2442
+ retired?: boolean | undefined;
2443
+ id: string;
2444
+ upstreamModelId: string;
2445
+ capabilities: {
2446
+ reasoning: {
2447
+ upstream: "supported" | "unknown" | "unsupported";
2448
+ runnable: boolean;
2449
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2450
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2451
+ required: boolean;
2452
+ };
2453
+ functionCalling: {
2454
+ upstream: "supported" | "unknown" | "unsupported";
2455
+ runnable: boolean;
2456
+ };
2457
+ structuredOutput: {
2458
+ upstream: "supported" | "unknown" | "unsupported";
2459
+ runnable: boolean;
2460
+ };
2461
+ hostedTools: {
2462
+ webSearch: {
2463
+ upstream: "supported" | "unknown" | "unsupported";
2464
+ runnable: boolean;
2465
+ };
2466
+ xSearch: {
2467
+ upstream: "supported" | "unknown" | "unsupported";
2468
+ runnable: boolean;
2469
+ };
2470
+ codeExecution: {
2471
+ upstream: "supported" | "unknown" | "unsupported";
2472
+ runnable: boolean;
2473
+ };
2474
+ imageGeneration: {
2475
+ upstream: "supported" | "unknown" | "unsupported";
2476
+ runnable: boolean;
2477
+ };
2478
+ };
2479
+ inputModalities: ("audio" | "image" | "text")[];
2480
+ inputFileMediaTypes: string[];
2481
+ outputModalities: ("audio" | "image" | "text")[];
2482
+ transports: {
2483
+ sse: {
2484
+ upstream: "supported" | "unknown" | "unsupported";
2485
+ runnable: boolean;
2486
+ };
2487
+ responsesWebSocket: {
2488
+ upstream: "supported" | "unknown" | "unsupported";
2489
+ runnable: boolean;
2490
+ };
2491
+ realtimeAudio: {
2492
+ upstream: "supported" | "unknown" | "unsupported";
2493
+ runnable: boolean;
2494
+ };
2495
+ };
2496
+ promptCaching?: {
2497
+ upstream: "supported" | "unknown" | "unsupported";
2498
+ runnable: boolean;
2499
+ mode: "automatic" | "implicit" | "none";
2500
+ } | undefined;
2501
+ latencyModes: {
2502
+ id: "fast" | "priority" | "standard";
2503
+ upstream: "supported" | "unknown" | "unsupported";
2504
+ runnable: boolean;
2505
+ billingMultiplierBps?: number | undefined;
2506
+ }[];
2507
+ };
2508
+ pricing?: undefined;
2509
+ }>>>>;
1863
2510
  gatewayModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
1864
2511
  productId: z.ZodString;
1865
2512
  workspaceProductId: z.ZodString;
1866
2513
  upstreamModelId: z.ZodString;
1867
2514
  label: z.ZodString;
1868
2515
  shortLabel: z.ZodOptional<z.ZodString>;
2516
+ logoUrl: z.ZodOptional<z.ZodString>;
1869
2517
  providers: z.ZodArray<z.ZodString>;
1870
2518
  implicitCaching: z.ZodDefault<z.ZodBoolean>;
1871
2519
  vision: z.ZodDefault<z.ZodBoolean>;
@@ -1882,6 +2530,7 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1882
2530
  upstreamModelId: z.ZodString;
1883
2531
  label: z.ZodString;
1884
2532
  shortLabel: z.ZodOptional<z.ZodString>;
2533
+ logoUrl: z.ZodOptional<z.ZodString>;
1885
2534
  aliases: z.ZodDefault<z.ZodArray<z.ZodString>>;
1886
2535
  capabilities: z.ZodObject<{
1887
2536
  reasoning: z.ZodObject<{
@@ -2063,6 +2712,7 @@ export type IntegrationOAuthClientConfig = z.infer<typeof IntegrationOAuthClient
2063
2712
  * replacement.
2064
2713
  */
2065
2714
  export interface ResolvedModelProvider {
2715
+ anthropic?: z.infer<typeof AnthropicProviderOptions> | undefined;
2066
2716
  id: string;
2067
2717
  label: string;
2068
2718
  kind: RegistryProviderKind | "openrouter-managed";
@@ -2086,6 +2736,8 @@ export interface ConfiguredModel {
2086
2736
  label: string;
2087
2737
  /** Optional curated compact label for dense UI (e.g. mobile composer). */
2088
2738
  shortLabel?: string | undefined;
2739
+ /** Optional HTTPS maker logo; display metadata does not change execution identity. */
2740
+ logoUrl?: string | undefined;
2089
2741
  providerId: string;
2090
2742
  providerLabel: string;
2091
2743
  api: ModelProviderApi;
@@ -2112,6 +2764,20 @@ export interface ConfiguredModel {
2112
2764
  reasoningEffort: boolean;
2113
2765
  hostedWebSearch: boolean;
2114
2766
  }
2767
+ /**
2768
+ * Whether a resolved route is the deployment-funded OpenRouter free tier: the
2769
+ * managed OpenRouter provider, which sends every workspace's requests with the
2770
+ * deployment's one OpenRouter key, serving an upstream `:free` variant (the
2771
+ * curated catalog admits nothing else). OpenRouter limits free-variant
2772
+ * requests per account per minute and per day, so each request on this route
2773
+ * spends quota that every turn on the deployment shares. A workspace or
2774
+ * organization OpenRouter connection uses its own account and is not this
2775
+ * route.
2776
+ */
2777
+ export declare function isManagedOpenRouterFreeRoute(route: {
2778
+ provider: Pick<ResolvedModelProvider, "kind">;
2779
+ configured: Pick<ConfiguredModel, "upstreamModelId">;
2780
+ }): boolean;
2115
2781
  export declare const VERCEL_AI_GATEWAY_BASE_URL: "https://ai-gateway.vercel.sh/v1";
2116
2782
  export declare const VERCEL_AI_GATEWAY_AI_SDK_BASE_URL: "https://ai-gateway.vercel.sh/v4/ai";
2117
2783
  export declare const VERCEL_AI_GATEWAY_CONNECTION_DOMAIN: "ai-gateway.vercel.sh";
@@ -2196,6 +2862,8 @@ export declare function configuredOpenRouterOrganizationProductModelIds(settings
2196
2862
  * llm-prices.com as a ground-truth canary; it does not generate this table.
2197
2863
  */
2198
2864
  export declare const defaultModelPricing: Record<string, ModelPricingScheduleV1>;
2865
+ /** Reviewed comparison rates only; never debit or execution-definition defaults. */
2866
+ export declare const reviewedModelListPricing: Record<string, ModelPricingScheduleV1>;
2199
2867
  export type SandboxRequiredEnv = {
2200
2868
  field: keyof Settings;
2201
2869
  env: string;
@@ -2265,6 +2933,17 @@ export declare function collectSandboxEnvironment(settings: Settings, source?: N
2265
2933
  */
2266
2934
  export declare function resolveProviderApiKey(provider: Pick<RegistryProvider, "apiKey" | "apiKeyEnv">, source?: NodeJS.ProcessEnv): string | undefined;
2267
2935
  export declare function gatewayRequestPolicyForUpstreamModel(upstreamModelId: string, models?: readonly GatewayCatalogModel[]): ConfiguredModel["requestPolicy"];
2936
+ /** Customer-owned OpenAI/Azure routes, bound to immutable connection identity. */
2937
+ export declare function withDirectModelProviders(settings: Settings, connections: readonly {
2938
+ id: string;
2939
+ version: number;
2940
+ subjectId: string | null;
2941
+ kind: string;
2942
+ status: string;
2943
+ providerDomain: string;
2944
+ metadata: Record<string, unknown>;
2945
+ apiKey?: string;
2946
+ }[]): Settings;
2268
2947
  /** Static catalog overlay; it contains no concrete workspace credential. */
2269
2948
  export declare function withWorkspaceGatewayCatalogProvider(settings: Settings, customModels?: readonly {
2270
2949
  upstreamModelId: string;
@@ -2326,6 +3005,13 @@ export declare function serviceTierForLatencyMode(providerId: string, latencyMod
2326
3005
  /** True when the response tier fulfills a non-standard Fast/priority request. */
2327
3006
  export declare function responseSatisfiesLatencyMode(requested: LatencyMode, responseServiceTier: string | null | undefined): boolean;
2328
3007
  export declare function runnableLatencyModesForModel(settings: Settings, modelId: string): LatencyMode[];
3008
+ export declare class UnsupportedLatencyModeError extends Error {
3009
+ readonly modelId: string;
3010
+ readonly latencyMode: LatencyMode;
3011
+ readonly allowedLatencyModes: readonly LatencyMode[];
3012
+ readonly code = "UNSUPPORTED_LATENCY_MODE";
3013
+ constructor(modelId: string, latencyMode: LatencyMode, allowedLatencyModes: readonly LatencyMode[]);
3014
+ }
2329
3015
  export declare function modelCostClassForConfiguredModel(_settings: Settings, model: Pick<ConfiguredModel, "cost">): ConfiguredModelCostClass;
2330
3016
  /**
2331
3017
  * The built-in provider's stable id: "openai" on the OpenAI platform, "azure"
@@ -2350,6 +3036,8 @@ export declare function configuredProviders(settings: Settings, source?: NodeJS.
2350
3036
  * select, lease, refresh, or expose a concrete credential; those runtime
2351
3037
  * operations remain owned by the credential allocator.
2352
3038
  */
3039
+ /** Exact upstream slugs of the active Codex catalog (or the built-in fallback list). */
3040
+ export declare function codexUpstreamModelSlugs(settings: Settings): string[];
2353
3041
  export declare function withCodexCatalogProvider(settings: Settings): Settings;
2354
3042
  /**
2355
3043
  * Static SuperGrok product catalogue, matching the Codex subscription seam.
@@ -2390,6 +3078,14 @@ export declare function canonicalizeConfiguredModelId(settings: Settings, modelI
2390
3078
  * openai allow-list, then registry ids.
2391
3079
  */
2392
3080
  export declare function configuredAllowedModels(settings: Settings): string[];
3081
+ /** Retirement is selection metadata, never provider authority or executable identity. */
3082
+ export declare function isModelAvailableForNewSelection(settings: Settings, modelId: string): boolean;
3083
+ /** Called only with the durable policy installed for a claimed accepted attempt. */
3084
+ export declare function settingsForAcceptedSubscriptionTurn(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
3085
+ modelId: string;
3086
+ reasoningEffort: Settings["openaiReasoningEffort"];
3087
+ latencyMode?: LatencyMode;
3088
+ }): Settings;
2393
3089
  /**
2394
3090
  * Resolve a model string to the provider that serves it and its configured
2395
3091
  * shape. Returns undefined when the id is not exposed (built-in allow-list nor
@@ -2417,16 +3113,29 @@ export type ResolveTurnExecutionPolicyV1Input = {
2417
3113
  * callers must keep their live credential/readiness gate authoritative.
2418
3114
  */
2419
3115
  export declare function resolveModelProviderForTurn(settings: Settings, modelId: string): ReturnType<typeof resolveModelProvider>;
3116
+ /**
3117
+ * The requested model cannot start new work: it is retired from new selection
3118
+ * or absent from the configured catalog. Callers that own a durable refusal
3119
+ * (for example a scheduled occurrence) record it instead of failing blindly.
3120
+ */
3121
+ export declare class TurnExecutionPolicyModelUnavailableError extends Error {
3122
+ constructor(message: string);
3123
+ }
2420
3124
  /**
2421
3125
  * Build a trusted, secret-safe execution policy from the normalized catalog.
2422
3126
  * The Codex overlay here contains static product/provider identity only; it
2423
3127
  * neither proves readiness nor chooses, decrypts, leases, or exposes an account.
2424
3128
  */
2425
3129
  export declare function resolveTurnExecutionPolicyV1(settings: Settings, input: ResolveTurnExecutionPolicyV1Input): TurnExecutionPolicyV1;
3130
+ /** Explicit accepted execution identity matches, but its definition digest differs. */
3131
+ export declare class TurnExecutionPolicyDefinitionMismatchError extends Error {
3132
+ readonly code = "turn_execution_policy_definition_mismatch";
3133
+ constructor();
3134
+ }
2426
3135
  /**
2427
3136
  * Parse-time validation lives in @opengeni/contracts; this verifier binds a
2428
3137
  * present snapshot to the current executable definition and exact turn row.
2429
- * Any deployment/provider drift fails before a provider or compaction call.
3138
+ * Non-additive executable drift fails before a provider or compaction call.
2430
3139
  */
2431
3140
  export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
2432
3141
  modelId: string;
@@ -2444,6 +3153,13 @@ export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Setti
2444
3153
  * complete schedule, and always replace the lower-precedence schedule.
2445
3154
  */
2446
3155
  export declare function configuredModelPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
3156
+ /**
3157
+ * Insights list-price metadata, including reviewed namespaced provider routes.
3158
+ * Kept separate from debit/catalog pricing: adding a comparison must not change
3159
+ * an accepted turn's frozen execution-definition hash or payer classification.
3160
+ * Inline registry and explicit product-ID prices always win over projections.
3161
+ */
3162
+ export declare function configuredModelListPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
2447
3163
  /** Legacy flat projection: returns the default/below-threshold price. */
2448
3164
  export declare function configuredModelPricing(settings: Settings): Record<string, ModelPricing>;
2449
3165
  /** Select the per-provider-request price at an exact input-token threshold. */
@@ -2467,6 +3183,29 @@ export declare function calculateModelUsageCostMicros(settings: Settings, model:
2467
3183
  export declare function calculateModelUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
2468
3184
  latencyMode?: LatencyMode;
2469
3185
  }): ModelUsageCostBreakdown;
3186
+ /** Provider-list/equivalent-credit comparison only; never debit authority. */
3187
+ export declare function calculateModelListUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
3188
+ latencyMode?: LatencyMode;
3189
+ }): ModelUsageCostBreakdown;
3190
+ /**
3191
+ * Forward-only list comparison snapshot for the model-call fact writer.
3192
+ * Callers must establish request price provenance (including geography/service
3193
+ * tier) and retain per-request counters. Unknown counters/TTL/modifiers yield
3194
+ * no class split, not invented zeros. Historical facts must not use this helper.
3195
+ * Native Claude details preserve cache_write_tokens_5m and cache_write_tokens_1h.
3196
+ */
3197
+ export declare function calculateModelListUsageCostSnapshot(settings: Settings, model: string, usage: ModelUsageInput, options?: {
3198
+ latencyMode?: LatencyMode;
3199
+ priceContextKnown?: boolean;
3200
+ }): ModelListUsageCostSnapshot;
3201
+ /**
3202
+ * Approximate class attribution of a previously recorded upstream list total.
3203
+ * Current reviewed rates are weights only: this never recomputes that total,
3204
+ * credits, or charges. Missing class counters/rates remain unknown. Historical
3205
+ * cache writes use the schedule's single TTL rate, not an exact TTL assertion.
3206
+ * Reasoning is already included in outputTokens and is never added again.
3207
+ */
3208
+ export declare function allocateRecordedModelListCostByClass(settings: Settings, model: string, usage: ModelUsageInput, recordedProviderCostMicros: number | null | undefined): ModelRecordedListCostAllocation;
2470
3209
  /**
2471
3210
  * Convert AI Gateway's exact USD inference cost to OpenGeni credit micros and
2472
3211
  * apply the configured model margin. Decimal arithmetic is integer-only so a
@@ -2594,6 +3333,7 @@ export declare function applyGitAuthPointerEnvironment(environment: Record<strin
2594
3333
  email: string;
2595
3334
  } | null): Record<string, string>;
2596
3335
  export type StartupRetryOptions = {
3336
+ shouldRetry?: (error: unknown) => boolean;
2597
3337
  attempts?: number;
2598
3338
  initialDelayMs?: number;
2599
3339
  maxDelayMs?: number;
@@ -2605,7 +3345,7 @@ export type StartupRetryOptions = {
2605
3345
  error: unknown;
2606
3346
  }) => void;
2607
3347
  };
2608
- export declare function startupRetryOptions(settings: Settings): Required<Omit<StartupRetryOptions, "onRetry">>;
3348
+ export declare function startupRetryOptions(settings: Settings): Required<Omit<StartupRetryOptions, "onRetry" | "shouldRetry">>;
2609
3349
  export declare function retryStartupDependency<T>(label: string, operation: () => Promise<T>, options?: StartupRetryOptions): Promise<T>;
2610
3350
  export declare function sandboxEnvironmentVariableNames(settings: Settings): string[];
2611
3351
  export declare function sandboxLifecycleHookIds(settings: Settings): string[];
@@ -2654,6 +3394,31 @@ export declare function firstPartyMcpInternalBaseUrl(settings: Settings): string
2654
3394
  export declare function firstPartyMcpWorkspaceUrl(settings: Settings, workspaceId: string): string;
2655
3395
  export declare function firstPartyMcpInternalWorkspaceUrl(settings: Settings, workspaceId: string): string;
2656
3396
  export declare function codemodeWorkspaceUrl(settings: Settings, workspaceId: string): string;
3397
+ export type TrustedProxyCidr = {
3398
+ address: string;
3399
+ prefix: number;
3400
+ family: "ipv4" | "ipv6";
3401
+ };
3402
+ /**
3403
+ * Parse `OPENGENI_API_TRUSTED_PROXY_CIDRS`: comma-separated IPv4/IPv6 CIDRs or
3404
+ * single addresses. Throws on any malformed entry so a typo can never widen or
3405
+ * silently disable the trusted proxy set.
3406
+ */
3407
+ export declare function trustedProxyCidrEntries(raw: string): TrustedProxyCidr[];
3408
+ /**
3409
+ * Parse `OPENGENI_LOCAL_ALLOWED_ORIGINS`: comma-separated exact browser origins
3410
+ * (`http(s)://host[:port]`, no path, query, credentials, or wildcard). Throws on
3411
+ * any malformed entry so a typo can never widen or silently disable the local
3412
+ * browser boundary.
3413
+ */
3414
+ export declare function localAllowedOriginEntries(raw: string | undefined): string[];
3415
+ /**
3416
+ * Local development only: whether a normalized API path is one a sandbox calls
3417
+ * (Codemode, first-party MCP, and the personal Git broker). The Linux Docker
3418
+ * sandbox route relays only these, and the local API serves only these on the
3419
+ * addresses that only sandboxes use (see `apps/api/src/http/local-browser-boundary.ts`).
3420
+ */
3421
+ export declare function localSandboxApiRouteAllowed(pathname: string): boolean;
2657
3422
  /** Validate one fully resolved, secret-bearing executable catalog. */
2658
3423
  export declare function validateModelCatalogSettings(settings: Settings, source?: NodeJS.ProcessEnv): ConfiguredModel[];
2659
3424
  /**
@@ -2718,4 +3483,32 @@ export interface NatsControlPlaneAuth {
2718
3483
  user: string;
2719
3484
  password: string;
2720
3485
  }
2721
- export declare function resolveNatsControlPlaneAuth(settings: Settings): NatsControlPlaneAuth | null;
3486
+ export declare function resolveNatsControlPlaneAuth(settings: Pick<Settings, "selfhostedNatsControlUser" | "selfhostedNatsControlPassword">): NatsControlPlaneAuth | null;
3487
+ /** Image references a workspace may select as its default sandbox image. */
3488
+ export declare function sandboxImageAllowlist(settings: Pick<Settings, "sandboxImageAllowlist">): string[];
3489
+ /** Native Claude connections reuse the encrypted workspace and organization boundaries. */
3490
+ export declare const CLAUDE_CONNECTION_KINDS: readonly ["anthropic", "claude_subscription"];
3491
+ export type ClaudeConnectionKind = (typeof CLAUDE_CONNECTION_KINDS)[number];
3492
+ export declare function claudeNativeModelProfile(upstreamModelId: string): Readonly<{
3493
+ efforts: readonly ReasoningEffort[];
3494
+ defaultEffort: ReasoningEffort | null;
3495
+ contextWindowTokens: number;
3496
+ maxOutputTokens: number;
3497
+ }> | undefined;
3498
+ export declare function claudeProviderId(kind: ClaudeConnectionKind, scope?: "workspace" | "organization"): string;
3499
+ export type ClaudeConnectionCatalog = Partial<Record<ClaudeConnectionKind, {
3500
+ active?: boolean;
3501
+ models: readonly {
3502
+ upstreamModelId: string;
3503
+ label?: string | null;
3504
+ }[];
3505
+ }>>;
3506
+ export declare function withClaudeConnectionCatalog(settings: Settings, connections: ClaudeConnectionCatalog, scope?: "workspace" | "organization"): Settings;
3507
+ export declare function withClaudeConnectionCredential(settings: Settings, kind: ClaudeConnectionKind, credential: string, scope?: "workspace" | "organization", credentialBinding?: {
3508
+ connectionId: string;
3509
+ credentialVersion: number;
3510
+ }): Settings;
3511
+ export * from "./claude-subscription-usage.js";
3512
+ export * from "./claude-subscription-oauth.js";
3513
+ export * from "./subscription-account-selection.js";
3514
+ export * from "./claude-subscription-capacity.js";