@opengeni/config 1.1.0-canary.0 → 1.1.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,13 @@
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
+ import { type AgentConfigDeploymentLimits, Entitlements, LatencyMode, ReasoningEffort, SandboxBackend, StaticUsageLimits, TurnExecutionPolicyV1, type TurnExecutionLatencyModeSourceV1, type TurnExecutionModelSourceV1, type TurnExecutionReasoningSourceV1, type VideoGenerationResolution, type FirstPartyMcpToolName as FirstPartyMcpToolNameType } from "@opengeni/contracts";
3
+ import type { CodeSearchDeploymentPolicy } from "@opengeni/contracts/code-search";
2
4
  export { XAI_SUBSCRIPTION_MODEL_ID_PREFIX } from "@opengeni/xai-subscription";
3
5
  import { z } from "zod";
4
6
  export declare const DEFAULT_OPENROUTER_MODEL_ID: "openrouter/nvidia/nemotron-3-super-120b-a12b:free";
5
7
  export declare const DEFAULT_MODEL_COST_POLICY_JSON: string;
6
8
  export declare const SANDBOX_ARCHIVE_CAPTURE_MAX_TIMEOUT_MS: number;
7
9
  export declare const SANDBOX_ARCHIVE_CAPTURE_SETTLEMENT_GRACE_MS = 10000;
10
+ export declare const SANDBOX_DEADLINE_COMMAND_STOP_GRACE_MS = 120000;
8
11
  export declare const SANDBOX_SNAPSHOT_MAX_TIMEOUT_MS: number;
9
12
  export declare const GOOGLE_DRIVE_PROVIDER_REQUEST_TIMEOUT_MAX_MS = 60000;
10
13
  export declare const GOOGLE_DRIVE_PROVIDER_RETRY_DELAY_MAX_MS = 60000;
@@ -28,8 +31,9 @@ export declare const sandboxPreparationProfiles: Record<string, {
28
31
  export declare const AGENT_INSTRUCTIONS_CORE_PLACEHOLDER = "{{core}}";
29
32
  /**
30
33
  * 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.
34
+ * opinion (the white-labellable surface): the general-assistant identity line,
35
+ * the framing/opinion lines, and the mount-path facts. Domain-specific tooling
36
+ * guidance (for example Terraform or Checkov) belongs in opt-in Skills.
33
37
  *
34
38
  * The CORE that MUST survive any override — the goal-loop ownership line (which
35
39
  * names the opengeni__goal_* tools) and the dynamic workspace-environment block
@@ -45,6 +49,14 @@ export declare const AGENT_INSTRUCTIONS_CORE_PLACEHOLDER = "{{core}}";
45
49
  export declare const DEFAULT_AGENT_INSTRUCTIONS: string;
46
50
  export declare const McpServerConnectionRefSchema: z.ZodObject<{
47
51
  connectionId: z.ZodOptional<z.ZodString>;
52
+ accountSelection: z.ZodOptional<z.ZodLiteral<"all_eligible">>;
53
+ authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
54
+ hostBinding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
55
+ bindingId: z.ZodString;
56
+ generation: z.ZodNumber;
57
+ }, z.core.$strict>, z.ZodObject<{
58
+ selection: z.ZodLiteral<"accepted_turn">;
59
+ }, z.core.$strict>]>>;
48
60
  provider: z.ZodOptional<z.ZodString>;
49
61
  providerDomain: z.ZodString;
50
62
  kind: z.ZodOptional<z.ZodEnum<{
@@ -59,25 +71,25 @@ export declare const McpServerConnectionRefSchema: z.ZodObject<{
59
71
  id: z.ZodString;
60
72
  kind: z.ZodLiteral<"repository">;
61
73
  }, 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
74
  subjectScope: z.ZodOptional<z.ZodEnum<{
68
75
  subject: "subject";
69
76
  workspace: "workspace";
70
77
  }>>;
71
78
  }, z.core.$strict>;
72
79
  export type McpServerConnectionRef = z.infer<typeof McpServerConnectionRefSchema>;
80
+ /** Operator-owned protocol binding. Tool annotations cannot establish recovery. */
81
+ export declare const McpOperationRecoverySchema: z.ZodRecord<z.ZodString, z.ZodObject<{
82
+ observerTool: z.ZodString;
83
+ }, z.core.$strict>>;
73
84
  /** Public, digest-pinned desktop image used by Modal unless the operator overrides it. */
74
- export declare const DEFAULT_MODAL_IMAGE_REF = "opengenipublicneuacr.azurecr.io/opengeni-desktop@sha256:c3bd17b8841de1bff9bb2777aad422cf8c75de78e2c30f9ac81d0cd6810a1b78";
85
+ export declare const DEFAULT_MODAL_IMAGE_REF = "opengenipublicneuacr.azurecr.io/opengeni-desktop@sha256:554d5b324a580071dd669e7c1190931e498eb1b397412a27c7de84a430ef393a";
75
86
  declare const SettingsSchema: z.ZodObject<{
76
87
  serviceName: z.ZodDefault<z.ZodString>;
77
88
  environment: z.ZodDefault<z.ZodString>;
78
89
  deploymentRevision: z.ZodDefault<z.ZodString>;
79
90
  serverVersion: z.ZodOptional<z.ZodString>;
80
91
  databaseUrl: z.ZodDefault<z.ZodString>;
92
+ apiDatabasePoolMax: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
81
93
  dbSchema: z.ZodDefault<z.ZodString>;
82
94
  rlsStrategy: z.ZodDefault<z.ZodEnum<{
83
95
  force: "force";
@@ -111,15 +123,22 @@ declare const SettingsSchema: z.ZodObject<{
111
123
  observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
112
124
  observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
113
125
  observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
126
+ observabilityDiagnosticsEndpoint: z.ZodOptional<z.ZodString>;
127
+ observabilityDiagnosticsHeaders: z.ZodDefault<z.ZodString>;
114
128
  analyticsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
115
129
  analyticsConsentRequired: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
116
130
  analyticsReoClientId: z.ZodOptional<z.ZodString>;
117
131
  analyticsPosthogProjectKey: z.ZodOptional<z.ZodString>;
118
132
  analyticsPosthogHost: z.ZodOptional<z.ZodString>;
119
133
  analyticsGa4MeasurementId: z.ZodOptional<z.ZodString>;
134
+ legalPrivacyPolicyUrl: z.ZodOptional<z.ZodString>;
135
+ legalTermsOfServiceUrl: z.ZodOptional<z.ZodString>;
136
+ supportEmail: z.ZodOptional<z.ZodString>;
120
137
  publicBaseUrl: z.ZodOptional<z.ZodString>;
138
+ documentationUrl: z.ZodPreprocess<z.ZodDefault<z.ZodNullable<z.ZodURL>>>;
121
139
  mcpOauthEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
122
- mcpOauthTrustedProxyHops: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
140
+ apiTrustedProxyHops: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
141
+ apiTrustedProxyCidrs: z.ZodDefault<z.ZodString>;
123
142
  webBaseUrl: z.ZodOptional<z.ZodString>;
124
143
  agentReleasesBaseUrl: z.ZodDefault<z.ZodString>;
125
144
  agentStableVersion: z.ZodDefault<z.ZodString>;
@@ -129,11 +148,11 @@ declare const SettingsSchema: z.ZodObject<{
129
148
  local: "local";
130
149
  managed: "managed";
131
150
  }>>;
132
- organizationTenancyCanonicalActivationEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
133
151
  billingMode: z.ZodDefault<z.ZodEnum<{
134
152
  disabled: "disabled";
135
153
  stripe: "stripe";
136
154
  }>>;
155
+ verifiedSignupTrialCreditsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
137
156
  entitlementsMode: z.ZodDefault<z.ZodEnum<{
138
157
  managed: "managed";
139
158
  none: "none";
@@ -144,6 +163,7 @@ declare const SettingsSchema: z.ZodObject<{
144
163
  none: "none";
145
164
  static: "static";
146
165
  }>>;
166
+ usageAllowancesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
147
167
  staticEntitlementsJson: z.ZodDefault<z.ZodString>;
148
168
  staticUsageLimitsJson: z.ZodDefault<z.ZodString>;
149
169
  delegationSecret: z.ZodOptional<z.ZodString>;
@@ -163,11 +183,15 @@ declare const SettingsSchema: z.ZodObject<{
163
183
  browser_auth: "browser_auth";
164
184
  browser_clipboard: "browser_clipboard";
165
185
  browser_debug: "browser_debug";
186
+ browser_download_save: "browser_download_save";
187
+ browser_downloads: "browser_downloads";
166
188
  browser_identity: "browser_identity";
167
189
  browser_lifecycle: "browser_lifecycle";
168
190
  browser_observe: "browser_observe";
169
191
  browser_open: "browser_open";
170
192
  browser_publish: "browser_publish";
193
+ browser_read: "browser_read";
194
+ browser_screenshot: "browser_screenshot";
171
195
  browser_tabs: "browser_tabs";
172
196
  capability_authorization_request: "capability_authorization_request";
173
197
  capability_catalog_search: "capability_catalog_search";
@@ -181,7 +205,9 @@ declare const SettingsSchema: z.ZodObject<{
181
205
  computer_observe: "computer_observe";
182
206
  computer_open: "computer_open";
183
207
  computer_targets: "computer_targets";
208
+ connected_machine_enroll_token: "connected_machine_enroll_token";
184
209
  connected_machine_remove: "connected_machine_remove";
210
+ custom_mcp_setup_request: "custom_mcp_setup_request";
185
211
  editable_artifact_apply: "editable_artifact_apply";
186
212
  editable_artifact_create: "editable_artifact_create";
187
213
  editable_artifact_export: "editable_artifact_export";
@@ -210,11 +236,21 @@ declare const SettingsSchema: z.ZodObject<{
210
236
  goal_resume: "goal_resume";
211
237
  goal_set: "goal_set";
212
238
  goal_update: "goal_update";
239
+ instruction_policy_get: "instruction_policy_get";
213
240
  instruction_policy_propose: "instruction_policy_propose";
241
+ instruction_policy_save: "instruction_policy_save";
214
242
  interaction_discover: "interaction_discover";
215
243
  interaction_request_human: "interaction_request_human";
244
+ knowledge_archive: "knowledge_archive";
245
+ knowledge_browse: "knowledge_browse";
216
246
  knowledge_correct: "knowledge_correct";
247
+ knowledge_get: "knowledge_get";
248
+ knowledge_prepare_save: "knowledge_prepare_save";
217
249
  knowledge_propose: "knowledge_propose";
250
+ knowledge_retain_file: "knowledge_retain_file";
251
+ knowledge_retain_message: "knowledge_retain_message";
252
+ knowledge_save: "knowledge_save";
253
+ knowledge_search: "knowledge_search";
218
254
  memory_correct: "memory_correct";
219
255
  memory_save: "memory_save";
220
256
  memory_search: "memory_search";
@@ -262,6 +298,7 @@ declare const SettingsSchema: z.ZodObject<{
262
298
  session_pause: "session_pause";
263
299
  session_resume: "session_resume";
264
300
  session_send_message: "session_send_message";
301
+ session_set_model: "session_set_model";
265
302
  session_set_project: "session_set_project";
266
303
  session_steer: "session_steer";
267
304
  session_wait: "session_wait";
@@ -276,8 +313,11 @@ declare const SettingsSchema: z.ZodObject<{
276
313
  slack_bot_list_files: "slack_bot_list_files";
277
314
  slack_bot_list_users: "slack_bot_list_users";
278
315
  slack_bot_post_message: "slack_bot_post_message";
316
+ slack_bot_prepare_message: "slack_bot_prepare_message";
279
317
  slack_bot_search: "slack_bot_search";
318
+ slack_bot_send_prepared_message: "slack_bot_send_prepared_message";
280
319
  slack_bot_thread_replies: "slack_bot_thread_replies";
320
+ slack_bot_upload_file: "slack_bot_upload_file";
281
321
  social_connections_list: "social_connections_list";
282
322
  social_daily_analysis_context: "social_daily_analysis_context";
283
323
  social_mentions_live: "social_mentions_live";
@@ -322,11 +362,15 @@ declare const SettingsSchema: z.ZodObject<{
322
362
  browser_auth: "browser_auth";
323
363
  browser_clipboard: "browser_clipboard";
324
364
  browser_debug: "browser_debug";
365
+ browser_download_save: "browser_download_save";
366
+ browser_downloads: "browser_downloads";
325
367
  browser_identity: "browser_identity";
326
368
  browser_lifecycle: "browser_lifecycle";
327
369
  browser_observe: "browser_observe";
328
370
  browser_open: "browser_open";
329
371
  browser_publish: "browser_publish";
372
+ browser_read: "browser_read";
373
+ browser_screenshot: "browser_screenshot";
330
374
  browser_tabs: "browser_tabs";
331
375
  capability_authorization_request: "capability_authorization_request";
332
376
  capability_catalog_search: "capability_catalog_search";
@@ -340,7 +384,9 @@ declare const SettingsSchema: z.ZodObject<{
340
384
  computer_observe: "computer_observe";
341
385
  computer_open: "computer_open";
342
386
  computer_targets: "computer_targets";
387
+ connected_machine_enroll_token: "connected_machine_enroll_token";
343
388
  connected_machine_remove: "connected_machine_remove";
389
+ custom_mcp_setup_request: "custom_mcp_setup_request";
344
390
  editable_artifact_apply: "editable_artifact_apply";
345
391
  editable_artifact_create: "editable_artifact_create";
346
392
  editable_artifact_export: "editable_artifact_export";
@@ -369,11 +415,21 @@ declare const SettingsSchema: z.ZodObject<{
369
415
  goal_resume: "goal_resume";
370
416
  goal_set: "goal_set";
371
417
  goal_update: "goal_update";
418
+ instruction_policy_get: "instruction_policy_get";
372
419
  instruction_policy_propose: "instruction_policy_propose";
420
+ instruction_policy_save: "instruction_policy_save";
373
421
  interaction_discover: "interaction_discover";
374
422
  interaction_request_human: "interaction_request_human";
423
+ knowledge_archive: "knowledge_archive";
424
+ knowledge_browse: "knowledge_browse";
375
425
  knowledge_correct: "knowledge_correct";
426
+ knowledge_get: "knowledge_get";
427
+ knowledge_prepare_save: "knowledge_prepare_save";
376
428
  knowledge_propose: "knowledge_propose";
429
+ knowledge_retain_file: "knowledge_retain_file";
430
+ knowledge_retain_message: "knowledge_retain_message";
431
+ knowledge_save: "knowledge_save";
432
+ knowledge_search: "knowledge_search";
377
433
  memory_correct: "memory_correct";
378
434
  memory_save: "memory_save";
379
435
  memory_search: "memory_search";
@@ -421,6 +477,7 @@ declare const SettingsSchema: z.ZodObject<{
421
477
  session_pause: "session_pause";
422
478
  session_resume: "session_resume";
423
479
  session_send_message: "session_send_message";
480
+ session_set_model: "session_set_model";
424
481
  session_set_project: "session_set_project";
425
482
  session_steer: "session_steer";
426
483
  session_wait: "session_wait";
@@ -435,8 +492,11 @@ declare const SettingsSchema: z.ZodObject<{
435
492
  slack_bot_list_files: "slack_bot_list_files";
436
493
  slack_bot_list_users: "slack_bot_list_users";
437
494
  slack_bot_post_message: "slack_bot_post_message";
495
+ slack_bot_prepare_message: "slack_bot_prepare_message";
438
496
  slack_bot_search: "slack_bot_search";
497
+ slack_bot_send_prepared_message: "slack_bot_send_prepared_message";
439
498
  slack_bot_thread_replies: "slack_bot_thread_replies";
499
+ slack_bot_upload_file: "slack_bot_upload_file";
440
500
  social_connections_list: "social_connections_list";
441
501
  social_daily_analysis_context: "social_daily_analysis_context";
442
502
  social_mentions_live: "social_mentions_live";
@@ -475,11 +535,17 @@ declare const SettingsSchema: z.ZodObject<{
475
535
  environmentsEncryptionKey: z.ZodOptional<z.ZodString>;
476
536
  integrationsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
477
537
  integrationsStateSecret: z.ZodOptional<z.ZodString>;
538
+ integrationsOauthShortStateEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
478
539
  integrationsAllowPrivateNetworkTargets: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
479
540
  integrationsOauthClientsJson: z.ZodDefault<z.ZodString>;
541
+ gmailWatchTopicName: z.ZodOptional<z.ZodString>;
480
542
  slackClientId: z.ZodOptional<z.ZodString>;
481
543
  slackClientSecret: z.ZodOptional<z.ZodString>;
482
544
  slackSigningSecret: z.ZodOptional<z.ZodString>;
545
+ slackAccessMode: z.ZodDefault<z.ZodEnum<{
546
+ full: "full";
547
+ limited: "limited";
548
+ }>>;
483
549
  slackBotDisplayName: z.ZodDefault<z.ZodEnum<{
484
550
  OpenGeni: "OpenGeni";
485
551
  "OpenGeni Staging": "OpenGeni Staging";
@@ -509,8 +575,6 @@ declare const SettingsSchema: z.ZodObject<{
509
575
  goalIdleBackoffMs: z.ZodDefault<z.ZodPreprocess<z.ZodReadonly<z.ZodArray<z.ZodNumber>>>>;
510
576
  goalIdleBackoffMaxMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
511
577
  childLifecycleNoticesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
512
- hostMcpAuthoritySourceAdmissionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
513
- hostMcpCredentialResolversJson: z.ZodOptional<z.ZodString>;
514
578
  slackWorkspaceRoutingEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
515
579
  agentMaxModelCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
516
580
  contextWindowTokens: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -525,10 +589,12 @@ declare const SettingsSchema: z.ZodObject<{
525
589
  authAllowMetrics: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
526
590
  apiHost: z.ZodDefault<z.ZodString>;
527
591
  apiPort: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
592
+ apiMetricsPort: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
528
593
  workerHttpPort: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
529
594
  opengeniMcpInternalUrl: z.ZodOptional<z.ZodString>;
530
595
  opengeniMcpUrl: z.ZodOptional<z.ZodString>;
531
596
  corsAllowOriginRegex: z.ZodDefault<z.ZodString>;
597
+ localAllowedOrigins: z.ZodOptional<z.ZodString>;
532
598
  openaiProvider: z.ZodDefault<z.ZodEnum<{
533
599
  azure: "azure";
534
600
  openai: "openai";
@@ -578,9 +644,11 @@ declare const SettingsSchema: z.ZodObject<{
578
644
  openrouterApiKey: z.ZodOptional<z.ZodString>;
579
645
  resolvedGatewayModelsJson: z.ZodOptional<z.ZodString>;
580
646
  resolvedOpenRouterModelsJson: z.ZodOptional<z.ZodString>;
647
+ resolvedCodexModelsJson: z.ZodOptional<z.ZodString>;
581
648
  modelProvidersJson: z.ZodDefault<z.ZodString>;
582
649
  codexSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
583
650
  supergrokSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
651
+ claudeSubscriptionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
584
652
  supergrokResponseStreamIdleTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
585
653
  codexConnectedAppsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
586
654
  codexProductSku: z.ZodOptional<z.ZodString>;
@@ -588,6 +656,7 @@ declare const SettingsSchema: z.ZodObject<{
588
656
  lazyToolSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
589
657
  codexFleetPolicyShadowEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
590
658
  codexRotationNearExhaustionPct: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
659
+ reasoningConfigurationUpdatesEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
591
660
  openaiReasoningEffort: z.ZodDefault<z.ZodEnum<{
592
661
  high: "high";
593
662
  low: "low";
@@ -598,6 +667,16 @@ declare const SettingsSchema: z.ZodObject<{
598
667
  xhigh: "xhigh";
599
668
  }>>;
600
669
  openaiAllowedReasoningEfforts: z.ZodDefault<z.ZodString>;
670
+ creditsDefaultModel: z.ZodDefault<z.ZodString>;
671
+ creditsDefaultReasoningEffort: z.ZodDefault<z.ZodEnum<{
672
+ high: "high";
673
+ low: "low";
674
+ max: "max";
675
+ medium: "medium";
676
+ minimal: "minimal";
677
+ none: "none";
678
+ xhigh: "xhigh";
679
+ }>>;
601
680
  openaiResponsesTransport: z.ZodDefault<z.ZodEnum<{
602
681
  http: "http";
603
682
  websocket: "websocket";
@@ -609,6 +688,16 @@ declare const SettingsSchema: z.ZodObject<{
609
688
  openaiReasoningEncryptedContent: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
610
689
  openaiMaxRetries: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
611
690
  webSearchEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
691
+ jevApiKey: z.ZodOptional<z.ZodString>;
692
+ jevBaseUrl: z.ZodDefault<z.ZodString>;
693
+ jevModel: z.ZodDefault<z.ZodString>;
694
+ jevRequestTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
695
+ codeSearchMode: z.ZodDefault<z.ZodEnum<{
696
+ default_on: "default_on";
697
+ experiment: "experiment";
698
+ off: "off";
699
+ opt_in: "opt_in";
700
+ }>>;
612
701
  agentInstructionsTemplate: z.ZodDefault<z.ZodString>;
613
702
  azureOpenaiBaseUrl: z.ZodOptional<z.ZodString>;
614
703
  azureOpenaiEndpoint: z.ZodOptional<z.ZodString>;
@@ -638,6 +727,7 @@ declare const SettingsSchema: z.ZodObject<{
638
727
  dockerWorkspaceBaseDir: z.ZodOptional<z.ZodString>;
639
728
  modalAppName: z.ZodDefault<z.ZodString>;
640
729
  modalImageRef: z.ZodOptional<z.ZodString>;
730
+ modalCommandSupervisionEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
641
731
  modalImageId: z.ZodOptional<z.ZodString>;
642
732
  modalImageRegistrySecret: z.ZodOptional<z.ZodString>;
643
733
  modalTimeoutSeconds: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -702,6 +792,7 @@ declare const SettingsSchema: z.ZodObject<{
702
792
  blaxelTtl: z.ZodOptional<z.ZodString>;
703
793
  cloudflareWorkerUrl: z.ZodOptional<z.ZodString>;
704
794
  cloudflareApiKey: z.ZodOptional<z.ZodString>;
795
+ experimentalBrowserContextPoolEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
705
796
  browserbaseApiKey: z.ZodOptional<z.ZodString>;
706
797
  kernelApiKey: z.ZodOptional<z.ZodString>;
707
798
  kernelEndpoint: z.ZodOptional<z.ZodString>;
@@ -744,6 +835,7 @@ declare const SettingsSchema: z.ZodObject<{
744
835
  sandboxViewerHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
745
836
  sandboxInteractionHolderTtlMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
746
837
  sandboxIdleGraceMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
838
+ sandboxIdleCommandContainmentMs: z.ZodPipe<z.ZodOptional<z.ZodCoercedNumber<unknown>>, z.ZodTransform<number | undefined, number | undefined>>;
747
839
  sandboxSnapshotIntervalMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
748
840
  sandboxSnapshotTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
749
841
  sandboxDrainSnapshotTimeoutMs: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
@@ -755,9 +847,15 @@ declare const SettingsSchema: z.ZodObject<{
755
847
  workspaceControlLockTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
756
848
  rigSetupTimeoutMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
757
849
  sandboxWarmRateMicrosPerSecondJson: z.ZodDefault<z.ZodString>;
850
+ sandboxWarmBillingMode: z.ZodDefault<z.ZodEnum<{
851
+ credits: "credits";
852
+ shadow: "shadow";
853
+ usage_only: "usage_only";
854
+ }>>;
758
855
  sandboxMaxWarmSecondsPerWorkspace: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
759
856
  sandboxPreparationProfiles: z.ZodDefault<z.ZodString>;
760
857
  sandboxEnvAllowlist: z.ZodDefault<z.ZodString>;
858
+ sandboxImageAllowlist: z.ZodDefault<z.ZodString>;
761
859
  objectStorageEndpoint: z.ZodOptional<z.ZodString>;
762
860
  objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
763
861
  objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
@@ -792,6 +890,13 @@ declare const SettingsSchema: z.ZodObject<{
792
890
  documentEmbeddingDimensions: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
793
891
  documentEmbeddingApiKey: z.ZodOptional<z.ZodString>;
794
892
  documentEmbeddingBaseUrl: z.ZodOptional<z.ZodString>;
893
+ documentEmbeddingBillingMode: z.ZodDefault<z.ZodEnum<{
894
+ credits: "credits";
895
+ shadow: "shadow";
896
+ usage_only: "usage_only";
897
+ }>>;
898
+ documentEmbeddingCreditsActivatedAt: z.ZodOptional<z.ZodISODateTime>;
899
+ documentEmbeddingRateMicrosPerMillionBytes: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
795
900
  documentCurationProvider: z.ZodDefault<z.ZodEnum<{
796
901
  heuristic: "heuristic";
797
902
  none: "none";
@@ -830,11 +935,13 @@ declare const SettingsSchema: z.ZodObject<{
830
935
  managedAuthGoogleClientSecret: z.ZodOptional<z.ZodString>;
831
936
  managedAuthGithubClientId: z.ZodOptional<z.ZodString>;
832
937
  managedAuthGithubClientSecret: z.ZodOptional<z.ZodString>;
938
+ allowedUserEmails: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodEmail, z.ZodTransform<string, string>>>>;
833
939
  managedAuthSessionSetMode: z.ZodDefault<z.ZodEnum<{
834
940
  broker: "broker";
835
941
  dual: "dual";
836
942
  legacy: "legacy";
837
943
  }>>;
944
+ managedAuthNewSignupsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
838
945
  organizationUserSetupEmailTokenTransport: z.ZodDefault<z.ZodEnum<{
839
946
  fragment: "fragment";
840
947
  query: "query";
@@ -857,6 +964,14 @@ declare const SettingsSchema: z.ZodObject<{
857
964
  headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
858
965
  connectionRef: z.ZodOptional<z.ZodObject<{
859
966
  connectionId: z.ZodOptional<z.ZodString>;
967
+ accountSelection: z.ZodOptional<z.ZodLiteral<"all_eligible">>;
968
+ authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
969
+ hostBinding: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
970
+ bindingId: z.ZodString;
971
+ generation: z.ZodNumber;
972
+ }, z.core.$strict>, z.ZodObject<{
973
+ selection: z.ZodLiteral<"accepted_turn">;
974
+ }, z.core.$strict>]>>;
860
975
  provider: z.ZodOptional<z.ZodString>;
861
976
  providerDomain: z.ZodString;
862
977
  kind: z.ZodOptional<z.ZodEnum<{
@@ -871,19 +986,99 @@ declare const SettingsSchema: z.ZodObject<{
871
986
  id: z.ZodString;
872
987
  kind: z.ZodLiteral<"repository">;
873
988
  }, z.core.$strict>>>;
874
- authoritySource: z.ZodOptional<z.ZodLiteral<"host">>;
875
- hostBinding: z.ZodOptional<z.ZodObject<{
876
- bindingId: z.ZodString;
877
- generation: z.ZodNumber;
878
- }, z.core.$strict>>;
879
989
  subjectScope: z.ZodOptional<z.ZodEnum<{
880
990
  subject: "subject";
881
991
  workspace: "workspace";
882
992
  }>>;
883
993
  }, z.core.$strict>>;
994
+ operationRecovery: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
995
+ observerTool: z.ZodString;
996
+ }, z.core.$strict>>>;
884
997
  }, z.core.$strip>>>;
885
998
  }, z.core.$strip>;
886
999
  export type Settings = z.infer<typeof SettingsSchema>;
1000
+ declare const ArtifactOutboxSettingsSchema: z.ZodObject<{
1001
+ serviceName: z.ZodDefault<z.ZodString>;
1002
+ environment: z.ZodDefault<z.ZodString>;
1003
+ deploymentRevision: z.ZodDefault<z.ZodString>;
1004
+ dbSchema: z.ZodDefault<z.ZodString>;
1005
+ rlsStrategy: z.ZodDefault<z.ZodEnum<{
1006
+ force: "force";
1007
+ scoped: "scoped";
1008
+ }>>;
1009
+ observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1010
+ observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1011
+ observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
1012
+ observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
1013
+ natsUrl: z.ZodDefault<z.ZodString>;
1014
+ selfhostedNatsControlUser: z.ZodOptional<z.ZodString>;
1015
+ selfhostedNatsControlPassword: z.ZodOptional<z.ZodString>;
1016
+ }, z.core.$strip>;
1017
+ declare const ObjectStorageSettingsSchema: z.ZodObject<{
1018
+ objectStorageEndpoint: z.ZodOptional<z.ZodString>;
1019
+ objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
1020
+ objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
1021
+ objectStorageBackend: z.ZodDefault<z.ZodEnum<{
1022
+ "aws-s3": "aws-s3";
1023
+ "azure-blob": "azure-blob";
1024
+ gcs: "gcs";
1025
+ "s3-compatible": "s3-compatible";
1026
+ }>>;
1027
+ objectStorageBucket: z.ZodDefault<z.ZodString>;
1028
+ objectStorageRegion: z.ZodDefault<z.ZodString>;
1029
+ objectStorageAccessKeyId: z.ZodOptional<z.ZodString>;
1030
+ objectStorageSecretAccessKey: z.ZodOptional<z.ZodString>;
1031
+ objectStorageForcePathStyle: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1032
+ objectStorageAzureConnectionString: z.ZodOptional<z.ZodString>;
1033
+ objectStorageAzureAccountName: z.ZodOptional<z.ZodString>;
1034
+ objectStorageAzureAccountKey: z.ZodOptional<z.ZodString>;
1035
+ objectStorageAzureEndpoint: z.ZodOptional<z.ZodString>;
1036
+ objectStorageGcsProjectId: z.ZodOptional<z.ZodString>;
1037
+ objectStorageGcsCredentialsJson: z.ZodOptional<z.ZodString>;
1038
+ objectStorageGcsKeyFilename: z.ZodOptional<z.ZodString>;
1039
+ objectStorageGcsApiEndpoint: z.ZodOptional<z.ZodString>;
1040
+ }, z.core.$strip>;
1041
+ declare const ArtifactMaterializerSettingsSchema: z.ZodObject<{
1042
+ serviceName: z.ZodDefault<z.ZodString>;
1043
+ environment: z.ZodDefault<z.ZodString>;
1044
+ deploymentRevision: z.ZodDefault<z.ZodString>;
1045
+ dbSchema: z.ZodDefault<z.ZodString>;
1046
+ rlsStrategy: z.ZodDefault<z.ZodEnum<{
1047
+ force: "force";
1048
+ scoped: "scoped";
1049
+ }>>;
1050
+ observabilityStructuredLogs: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1051
+ observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1052
+ observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
1053
+ observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
1054
+ objectStorageEndpoint: z.ZodOptional<z.ZodString>;
1055
+ objectStorageInternalEndpoint: z.ZodOptional<z.ZodString>;
1056
+ objectStorageSandboxEndpoint: z.ZodOptional<z.ZodString>;
1057
+ objectStorageBackend: z.ZodDefault<z.ZodEnum<{
1058
+ "aws-s3": "aws-s3";
1059
+ "azure-blob": "azure-blob";
1060
+ gcs: "gcs";
1061
+ "s3-compatible": "s3-compatible";
1062
+ }>>;
1063
+ objectStorageBucket: z.ZodDefault<z.ZodString>;
1064
+ objectStorageRegion: z.ZodDefault<z.ZodString>;
1065
+ objectStorageAccessKeyId: z.ZodOptional<z.ZodString>;
1066
+ objectStorageSecretAccessKey: z.ZodOptional<z.ZodString>;
1067
+ objectStorageForcePathStyle: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
1068
+ objectStorageAzureConnectionString: z.ZodOptional<z.ZodString>;
1069
+ objectStorageAzureAccountName: z.ZodOptional<z.ZodString>;
1070
+ objectStorageAzureAccountKey: z.ZodOptional<z.ZodString>;
1071
+ objectStorageAzureEndpoint: z.ZodOptional<z.ZodString>;
1072
+ objectStorageGcsProjectId: z.ZodOptional<z.ZodString>;
1073
+ objectStorageGcsCredentialsJson: z.ZodOptional<z.ZodString>;
1074
+ objectStorageGcsKeyFilename: z.ZodOptional<z.ZodString>;
1075
+ objectStorageGcsApiEndpoint: z.ZodOptional<z.ZodString>;
1076
+ }, z.core.$strip>;
1077
+ export type ArtifactOutboxSettings = z.infer<typeof ArtifactOutboxSettingsSchema>;
1078
+ export type ObjectStorageSettings = z.infer<typeof ObjectStorageSettingsSchema>;
1079
+ export type ArtifactMaterializerSettings = z.infer<typeof ArtifactMaterializerSettingsSchema>;
1080
+ export declare function getArtifactOutboxSettings(source?: NodeJS.ProcessEnv): ArtifactOutboxSettings;
1081
+ export declare function getArtifactMaterializerSettings(source?: NodeJS.ProcessEnv): ArtifactMaterializerSettings;
887
1082
  export type McpServerConfig = Settings["mcpServers"][number];
888
1083
  export type GoogleDriveProviderRetryOptions = {
889
1084
  requestTimeoutMs: number;
@@ -938,6 +1133,17 @@ export type VoiceInputProviderConfig = {
938
1133
  kind: "supergrok-subscription";
939
1134
  experimental: true;
940
1135
  };
1136
+ /** The deployment's Jev key, or undefined when it is missing or a placeholder. */
1137
+ export declare function usableJevApiKey(settings: Pick<Settings, "jevApiKey">): string | undefined;
1138
+ /** Deployment half of agent configuration: hard capability limits. */
1139
+ export declare function agentConfigDeploymentPolicy(settings: Pick<Settings, "webSearchEnabled" | "defaultFirstPartyMcpTools" | "allowedFirstPartyMcpTools">): AgentConfigDeploymentLimits;
1140
+ /**
1141
+ * Deployment half of the `code_search` decision. `available` is false when
1142
+ * the mode is off or no usable Jev key is configured; workspaces then cannot
1143
+ * turn it on. `workspaceDefault` applies to workspaces without their own
1144
+ * setting.
1145
+ */
1146
+ export declare function codeSearchDeploymentPolicy(settings: Pick<Settings, "codeSearchMode" | "jevApiKey">): CodeSearchDeploymentPolicy;
941
1147
  /**
942
1148
  * Reject empty / template secrets so `.env.example` placeholders like
943
1149
  * `your-key` cannot advertise voice input as available and then 401 upstream.
@@ -991,6 +1197,24 @@ export type ModelUsageCostBreakdown = {
991
1197
  /** OpenGeni credit price after configured margin and latency-mode multiplier. */
992
1198
  creditCostMicros: number;
993
1199
  };
1200
+ export type ModelListCostClassesMicros = {
1201
+ uncachedInput: number;
1202
+ cacheRead: number;
1203
+ cacheWrite: number;
1204
+ output: number;
1205
+ };
1206
+ export type ModelListUsageCostSnapshot = ModelUsageCostBreakdown & {
1207
+ /** Captured upstream list costs, summing to providerCostMicros, never debits. */
1208
+ listByClassMicros: ModelListCostClassesMicros | null;
1209
+ /** True only when a returned class split includes latency rounding allocation. */
1210
+ listByClassApprox: boolean;
1211
+ };
1212
+ export type ModelRecordedListCostAllocation = {
1213
+ /** Approximate attribution of a stored upstream total, never a new price. */
1214
+ listByClassMicros: ModelListCostClassesMicros | null;
1215
+ /** True for every eligible historical allocation, including known zero. */
1216
+ listByClassApprox: boolean;
1217
+ };
994
1218
  export type StaticUsageLimitsConfig = StaticUsageLimits;
995
1219
  export type EntitlementsConfig = Entitlements;
996
1220
  export declare const CapabilitySupportV1: z.ZodEnum<{
@@ -1167,7 +1391,7 @@ export type CredentialSourceV1 = {
1167
1391
  mechanism: "api_key" | "azure_ad_bearer" | "none";
1168
1392
  } | {
1169
1393
  kind: "connected_subscription";
1170
- provider: "codex" | "xai";
1394
+ provider: "codex" | "xai" | "claude";
1171
1395
  } | {
1172
1396
  kind: "workspace_connection";
1173
1397
  mechanism: "api_key";
@@ -1187,6 +1411,7 @@ export type BillingAttributionV1 = {
1187
1411
  * silently no-ops hosted tools (see docs/model-providers.md).
1188
1412
  */
1189
1413
  export declare const ModelProviderApi: z.ZodEnum<{
1414
+ "anthropic-messages": "anthropic-messages";
1190
1415
  chat: "chat";
1191
1416
  responses: "responses";
1192
1417
  }>;
@@ -1209,8 +1434,14 @@ export type ModelProviderWireProfile = z.infer<typeof ModelProviderWireProfile>;
1209
1434
  */
1210
1435
  export declare const RegistryProviderKind: z.ZodEnum<{
1211
1436
  anonymous: "anonymous";
1437
+ "anthropic-organization": "anthropic-organization";
1438
+ "anthropic-workspace": "anthropic-workspace";
1212
1439
  "api-key": "api-key";
1440
+ "claude-subscription-organization": "claude-subscription-organization";
1441
+ "claude-subscription-workspace": "claude-subscription-workspace";
1213
1442
  "codex-subscription": "codex-subscription";
1443
+ "direct-azure-workspace": "direct-azure-workspace";
1444
+ "direct-openai-workspace": "direct-openai-workspace";
1214
1445
  "openrouter-organization": "openrouter-organization";
1215
1446
  "openrouter-workspace": "openrouter-workspace";
1216
1447
  "vercel-gateway-managed": "vercel-gateway-managed";
@@ -1220,11 +1451,56 @@ export declare const RegistryProviderKind: z.ZodEnum<{
1220
1451
  }>;
1221
1452
  export type RegistryProviderKind = z.infer<typeof RegistryProviderKind>;
1222
1453
  /** A non-built-in provider declared by the host via OPENGENI_MODEL_PROVIDERS_JSON. */
1454
+ export declare const ClaudeSubscriptionIdentity: z.ZodObject<{
1455
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1456
+ deviceId: z.ZodString;
1457
+ }, z.core.$strict>;
1458
+ export type ClaudeSubscriptionIdentity = z.infer<typeof ClaudeSubscriptionIdentity>;
1459
+ export declare const ClaudeSubscriptionCredential: z.ZodObject<{
1460
+ version: z.ZodLiteral<1>;
1461
+ token: z.ZodString;
1462
+ identity: z.ZodObject<{
1463
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1464
+ deviceId: z.ZodString;
1465
+ }, z.core.$strict>;
1466
+ oauth: z.ZodOptional<z.ZodObject<{
1467
+ refreshToken: z.ZodString;
1468
+ expiresAt: z.ZodString;
1469
+ scopes: z.ZodArray<z.ZodString>;
1470
+ }, z.core.$strict>>;
1471
+ }, z.core.$strict>;
1472
+ declare const AnthropicProviderOptions: z.ZodObject<{
1473
+ identity: z.ZodOptional<z.ZodObject<{
1474
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1475
+ deviceId: z.ZodString;
1476
+ }, z.core.$strict>>;
1477
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1478
+ connectionId: z.ZodString;
1479
+ credentialVersion: z.ZodNumber;
1480
+ }, z.core.$strict>>;
1481
+ auth: z.ZodDefault<z.ZodEnum<{
1482
+ "api-key": "api-key";
1483
+ oauth: "oauth";
1484
+ }>>;
1485
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1486
+ "1h": "1h";
1487
+ "5m": "5m";
1488
+ off: "off";
1489
+ }>>;
1490
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1491
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1492
+ }, z.core.$strip>;
1223
1493
  declare const RegistryProviderSchema: z.ZodObject<{
1224
1494
  kind: z.ZodDefault<z.ZodEnum<{
1225
1495
  anonymous: "anonymous";
1496
+ "anthropic-organization": "anthropic-organization";
1497
+ "anthropic-workspace": "anthropic-workspace";
1226
1498
  "api-key": "api-key";
1499
+ "claude-subscription-organization": "claude-subscription-organization";
1500
+ "claude-subscription-workspace": "claude-subscription-workspace";
1227
1501
  "codex-subscription": "codex-subscription";
1502
+ "direct-azure-workspace": "direct-azure-workspace";
1503
+ "direct-openai-workspace": "direct-openai-workspace";
1228
1504
  "openrouter-organization": "openrouter-organization";
1229
1505
  "openrouter-workspace": "openrouter-workspace";
1230
1506
  "vercel-gateway-managed": "vercel-gateway-managed";
@@ -1235,9 +1511,31 @@ declare const RegistryProviderSchema: z.ZodObject<{
1235
1511
  id: z.ZodString;
1236
1512
  label: z.ZodOptional<z.ZodString>;
1237
1513
  api: z.ZodDefault<z.ZodEnum<{
1514
+ "anthropic-messages": "anthropic-messages";
1238
1515
  chat: "chat";
1239
1516
  responses: "responses";
1240
1517
  }>>;
1518
+ anthropic: z.ZodOptional<z.ZodObject<{
1519
+ identity: z.ZodOptional<z.ZodObject<{
1520
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1521
+ deviceId: z.ZodString;
1522
+ }, z.core.$strict>>;
1523
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1524
+ connectionId: z.ZodString;
1525
+ credentialVersion: z.ZodNumber;
1526
+ }, z.core.$strict>>;
1527
+ auth: z.ZodDefault<z.ZodEnum<{
1528
+ "api-key": "api-key";
1529
+ oauth: "oauth";
1530
+ }>>;
1531
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1532
+ "1h": "1h";
1533
+ "5m": "5m";
1534
+ off: "off";
1535
+ }>>;
1536
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1537
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1538
+ }, z.core.$strip>>;
1241
1539
  wireProfile: z.ZodDefault<z.ZodEnum<{
1242
1540
  "azure-openai": "azure-openai";
1243
1541
  openai: "openai";
@@ -1673,9 +1971,31 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1673
1971
  id: z.ZodString;
1674
1972
  label: z.ZodOptional<z.ZodString>;
1675
1973
  api: z.ZodDefault<z.ZodEnum<{
1974
+ "anthropic-messages": "anthropic-messages";
1676
1975
  chat: "chat";
1677
1976
  responses: "responses";
1678
1977
  }>>;
1978
+ anthropic: z.ZodOptional<z.ZodObject<{
1979
+ identity: z.ZodOptional<z.ZodObject<{
1980
+ accountUuid: z.ZodUnion<readonly [z.ZodString, z.ZodLiteral<"">]>;
1981
+ deviceId: z.ZodString;
1982
+ }, z.core.$strict>>;
1983
+ credentialBinding: z.ZodOptional<z.ZodObject<{
1984
+ connectionId: z.ZodString;
1985
+ credentialVersion: z.ZodNumber;
1986
+ }, z.core.$strict>>;
1987
+ auth: z.ZodDefault<z.ZodEnum<{
1988
+ "api-key": "api-key";
1989
+ oauth: "oauth";
1990
+ }>>;
1991
+ cacheTtl: z.ZodDefault<z.ZodEnum<{
1992
+ "1h": "1h";
1993
+ "5m": "5m";
1994
+ off: "off";
1995
+ }>>;
1996
+ maxOutputTokens: z.ZodDefault<z.ZodNumber>;
1997
+ streamIdleTimeoutMs: z.ZodDefault<z.ZodNumber>;
1998
+ }, z.core.$strip>>;
1679
1999
  wireProfile: z.ZodDefault<z.ZodEnum<{
1680
2000
  "azure-openai": "azure-openai";
1681
2001
  openai: "openai";
@@ -1853,6 +2173,324 @@ export declare const ModelCatalogDocument: z.ZodObject<{
1853
2173
  publicDefaultHeaderNames: z.ZodOptional<z.ZodNever>;
1854
2174
  publicDefaultQueryNames: z.ZodOptional<z.ZodNever>;
1855
2175
  }, z.core.$strict>>>;
2176
+ codexModels: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodObject<{
2177
+ aliases: z.ZodOptional<z.ZodArray<z.ZodString>>;
2178
+ label: z.ZodOptional<z.ZodString>;
2179
+ shortLabel: z.ZodOptional<z.ZodString>;
2180
+ contextWindowTokens: z.ZodOptional<z.ZodNumber>;
2181
+ effectiveContextWindowTokens: z.ZodOptional<z.ZodNumber>;
2182
+ autoCompactTokenLimit: z.ZodOptional<z.ZodNumber>;
2183
+ toolOutputTruncationTokens: z.ZodOptional<z.ZodNumber>;
2184
+ reasoningEffort: z.ZodOptional<z.ZodBoolean>;
2185
+ hostedWebSearch: z.ZodOptional<z.ZodBoolean>;
2186
+ credentialSource: z.ZodOptional<z.ZodNever>;
2187
+ billing: z.ZodOptional<z.ZodNever>;
2188
+ retired: z.ZodOptional<z.ZodBoolean>;
2189
+ id: z.ZodString;
2190
+ upstreamModelId: z.ZodString;
2191
+ capabilities: z.ZodObject<{
2192
+ reasoning: z.ZodObject<{
2193
+ upstream: z.ZodEnum<{
2194
+ supported: "supported";
2195
+ unknown: "unknown";
2196
+ unsupported: "unsupported";
2197
+ }>;
2198
+ runnable: z.ZodBoolean;
2199
+ efforts: z.ZodArray<z.ZodEnum<{
2200
+ high: "high";
2201
+ low: "low";
2202
+ max: "max";
2203
+ medium: "medium";
2204
+ minimal: "minimal";
2205
+ none: "none";
2206
+ xhigh: "xhigh";
2207
+ }>>;
2208
+ defaultEffort: z.ZodNullable<z.ZodEnum<{
2209
+ high: "high";
2210
+ low: "low";
2211
+ max: "max";
2212
+ medium: "medium";
2213
+ minimal: "minimal";
2214
+ none: "none";
2215
+ xhigh: "xhigh";
2216
+ }>>;
2217
+ required: z.ZodBoolean;
2218
+ }, z.core.$strip>;
2219
+ functionCalling: z.ZodObject<{
2220
+ upstream: z.ZodEnum<{
2221
+ supported: "supported";
2222
+ unknown: "unknown";
2223
+ unsupported: "unsupported";
2224
+ }>;
2225
+ runnable: z.ZodBoolean;
2226
+ }, z.core.$strip>;
2227
+ structuredOutput: z.ZodObject<{
2228
+ upstream: z.ZodEnum<{
2229
+ supported: "supported";
2230
+ unknown: "unknown";
2231
+ unsupported: "unsupported";
2232
+ }>;
2233
+ runnable: z.ZodBoolean;
2234
+ }, z.core.$strip>;
2235
+ hostedTools: z.ZodObject<{
2236
+ webSearch: z.ZodObject<{
2237
+ upstream: z.ZodEnum<{
2238
+ supported: "supported";
2239
+ unknown: "unknown";
2240
+ unsupported: "unsupported";
2241
+ }>;
2242
+ runnable: z.ZodBoolean;
2243
+ }, z.core.$strip>;
2244
+ xSearch: z.ZodObject<{
2245
+ upstream: z.ZodEnum<{
2246
+ supported: "supported";
2247
+ unknown: "unknown";
2248
+ unsupported: "unsupported";
2249
+ }>;
2250
+ runnable: z.ZodBoolean;
2251
+ }, z.core.$strip>;
2252
+ codeExecution: z.ZodObject<{
2253
+ upstream: z.ZodEnum<{
2254
+ supported: "supported";
2255
+ unknown: "unknown";
2256
+ unsupported: "unsupported";
2257
+ }>;
2258
+ runnable: z.ZodBoolean;
2259
+ }, z.core.$strip>;
2260
+ imageGeneration: z.ZodDefault<z.ZodObject<{
2261
+ upstream: z.ZodEnum<{
2262
+ supported: "supported";
2263
+ unknown: "unknown";
2264
+ unsupported: "unsupported";
2265
+ }>;
2266
+ runnable: z.ZodBoolean;
2267
+ }, z.core.$strip>>;
2268
+ }, z.core.$strip>;
2269
+ inputModalities: z.ZodArray<z.ZodEnum<{
2270
+ audio: "audio";
2271
+ image: "image";
2272
+ text: "text";
2273
+ }>>;
2274
+ inputFileMediaTypes: z.ZodDefault<z.ZodArray<z.ZodString>>;
2275
+ outputModalities: z.ZodArray<z.ZodEnum<{
2276
+ audio: "audio";
2277
+ image: "image";
2278
+ text: "text";
2279
+ }>>;
2280
+ transports: z.ZodObject<{
2281
+ sse: z.ZodObject<{
2282
+ upstream: z.ZodEnum<{
2283
+ supported: "supported";
2284
+ unknown: "unknown";
2285
+ unsupported: "unsupported";
2286
+ }>;
2287
+ runnable: z.ZodBoolean;
2288
+ }, z.core.$strip>;
2289
+ responsesWebSocket: z.ZodObject<{
2290
+ upstream: z.ZodEnum<{
2291
+ supported: "supported";
2292
+ unknown: "unknown";
2293
+ unsupported: "unsupported";
2294
+ }>;
2295
+ runnable: z.ZodBoolean;
2296
+ }, z.core.$strip>;
2297
+ realtimeAudio: z.ZodObject<{
2298
+ upstream: z.ZodEnum<{
2299
+ supported: "supported";
2300
+ unknown: "unknown";
2301
+ unsupported: "unsupported";
2302
+ }>;
2303
+ runnable: z.ZodBoolean;
2304
+ }, z.core.$strip>;
2305
+ }, z.core.$strip>;
2306
+ promptCaching: z.ZodOptional<z.ZodObject<{
2307
+ upstream: z.ZodEnum<{
2308
+ supported: "supported";
2309
+ unknown: "unknown";
2310
+ unsupported: "unsupported";
2311
+ }>;
2312
+ runnable: z.ZodBoolean;
2313
+ mode: z.ZodEnum<{
2314
+ automatic: "automatic";
2315
+ implicit: "implicit";
2316
+ none: "none";
2317
+ }>;
2318
+ }, z.core.$strip>>;
2319
+ latencyModes: z.ZodArray<z.ZodObject<{
2320
+ id: z.ZodEnum<{
2321
+ fast: "fast";
2322
+ priority: "priority";
2323
+ standard: "standard";
2324
+ }>;
2325
+ upstream: z.ZodEnum<{
2326
+ supported: "supported";
2327
+ unknown: "unknown";
2328
+ unsupported: "unsupported";
2329
+ }>;
2330
+ runnable: z.ZodBoolean;
2331
+ billingMultiplierBps: z.ZodOptional<z.ZodNumber>;
2332
+ }, z.core.$strip>>;
2333
+ }, z.core.$strip>;
2334
+ pricing: z.ZodOptional<z.ZodNever>;
2335
+ }, z.core.$strict>, z.ZodTransform<{
2336
+ aliases?: string[] | undefined;
2337
+ label?: string | undefined;
2338
+ shortLabel?: string | undefined;
2339
+ contextWindowTokens?: number | undefined;
2340
+ effectiveContextWindowTokens?: number | undefined;
2341
+ autoCompactTokenLimit?: number | undefined;
2342
+ toolOutputTruncationTokens?: number | undefined;
2343
+ reasoningEffort?: boolean | undefined;
2344
+ hostedWebSearch?: boolean | undefined;
2345
+ credentialSource?: undefined;
2346
+ billing?: undefined;
2347
+ retired?: boolean | undefined;
2348
+ id: string;
2349
+ upstreamModelId: string;
2350
+ pricing?: undefined;
2351
+ capabilities: {
2352
+ reasoning: {
2353
+ upstream: "supported" | "unknown" | "unsupported";
2354
+ runnable: boolean;
2355
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2356
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2357
+ required: boolean;
2358
+ };
2359
+ functionCalling: {
2360
+ upstream: "supported" | "unknown" | "unsupported";
2361
+ runnable: boolean;
2362
+ };
2363
+ structuredOutput: {
2364
+ upstream: "supported" | "unknown" | "unsupported";
2365
+ runnable: boolean;
2366
+ };
2367
+ hostedTools: {
2368
+ webSearch: {
2369
+ upstream: "supported" | "unknown" | "unsupported";
2370
+ runnable: boolean;
2371
+ };
2372
+ xSearch: {
2373
+ upstream: "supported" | "unknown" | "unsupported";
2374
+ runnable: boolean;
2375
+ };
2376
+ codeExecution: {
2377
+ upstream: "supported" | "unknown" | "unsupported";
2378
+ runnable: boolean;
2379
+ };
2380
+ imageGeneration: {
2381
+ upstream: "supported" | "unknown" | "unsupported";
2382
+ runnable: boolean;
2383
+ };
2384
+ };
2385
+ inputModalities: ("audio" | "image" | "text")[];
2386
+ inputFileMediaTypes: string[];
2387
+ outputModalities: ("audio" | "image" | "text")[];
2388
+ transports: {
2389
+ sse: {
2390
+ upstream: "supported" | "unknown" | "unsupported";
2391
+ runnable: boolean;
2392
+ };
2393
+ responsesWebSocket: {
2394
+ upstream: "supported" | "unknown" | "unsupported";
2395
+ runnable: boolean;
2396
+ };
2397
+ realtimeAudio: {
2398
+ upstream: "supported" | "unknown" | "unsupported";
2399
+ runnable: boolean;
2400
+ };
2401
+ };
2402
+ promptCaching?: {
2403
+ upstream: "supported" | "unknown" | "unsupported";
2404
+ runnable: boolean;
2405
+ mode: "automatic" | "implicit" | "none";
2406
+ } | undefined;
2407
+ latencyModes: {
2408
+ id: "fast" | "priority" | "standard";
2409
+ upstream: "supported" | "unknown" | "unsupported";
2410
+ runnable: boolean;
2411
+ billingMultiplierBps?: number | undefined;
2412
+ }[];
2413
+ };
2414
+ }, {
2415
+ aliases?: string[] | undefined;
2416
+ label?: string | undefined;
2417
+ shortLabel?: string | undefined;
2418
+ contextWindowTokens?: number | undefined;
2419
+ effectiveContextWindowTokens?: number | undefined;
2420
+ autoCompactTokenLimit?: number | undefined;
2421
+ toolOutputTruncationTokens?: number | undefined;
2422
+ reasoningEffort?: boolean | undefined;
2423
+ hostedWebSearch?: boolean | undefined;
2424
+ credentialSource?: undefined;
2425
+ billing?: undefined;
2426
+ retired?: boolean | undefined;
2427
+ id: string;
2428
+ upstreamModelId: string;
2429
+ capabilities: {
2430
+ reasoning: {
2431
+ upstream: "supported" | "unknown" | "unsupported";
2432
+ runnable: boolean;
2433
+ efforts: ("high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh")[];
2434
+ defaultEffort: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh" | null;
2435
+ required: boolean;
2436
+ };
2437
+ functionCalling: {
2438
+ upstream: "supported" | "unknown" | "unsupported";
2439
+ runnable: boolean;
2440
+ };
2441
+ structuredOutput: {
2442
+ upstream: "supported" | "unknown" | "unsupported";
2443
+ runnable: boolean;
2444
+ };
2445
+ hostedTools: {
2446
+ webSearch: {
2447
+ upstream: "supported" | "unknown" | "unsupported";
2448
+ runnable: boolean;
2449
+ };
2450
+ xSearch: {
2451
+ upstream: "supported" | "unknown" | "unsupported";
2452
+ runnable: boolean;
2453
+ };
2454
+ codeExecution: {
2455
+ upstream: "supported" | "unknown" | "unsupported";
2456
+ runnable: boolean;
2457
+ };
2458
+ imageGeneration: {
2459
+ upstream: "supported" | "unknown" | "unsupported";
2460
+ runnable: boolean;
2461
+ };
2462
+ };
2463
+ inputModalities: ("audio" | "image" | "text")[];
2464
+ inputFileMediaTypes: string[];
2465
+ outputModalities: ("audio" | "image" | "text")[];
2466
+ transports: {
2467
+ sse: {
2468
+ upstream: "supported" | "unknown" | "unsupported";
2469
+ runnable: boolean;
2470
+ };
2471
+ responsesWebSocket: {
2472
+ upstream: "supported" | "unknown" | "unsupported";
2473
+ runnable: boolean;
2474
+ };
2475
+ realtimeAudio: {
2476
+ upstream: "supported" | "unknown" | "unsupported";
2477
+ runnable: boolean;
2478
+ };
2479
+ };
2480
+ promptCaching?: {
2481
+ upstream: "supported" | "unknown" | "unsupported";
2482
+ runnable: boolean;
2483
+ mode: "automatic" | "implicit" | "none";
2484
+ } | undefined;
2485
+ latencyModes: {
2486
+ id: "fast" | "priority" | "standard";
2487
+ upstream: "supported" | "unknown" | "unsupported";
2488
+ runnable: boolean;
2489
+ billingMultiplierBps?: number | undefined;
2490
+ }[];
2491
+ };
2492
+ pricing?: undefined;
2493
+ }>>>>;
1856
2494
  gatewayModels: z.ZodDefault<z.ZodArray<z.ZodObject<{
1857
2495
  productId: z.ZodString;
1858
2496
  workspaceProductId: z.ZodString;
@@ -2056,6 +2694,7 @@ export type IntegrationOAuthClientConfig = z.infer<typeof IntegrationOAuthClient
2056
2694
  * replacement.
2057
2695
  */
2058
2696
  export interface ResolvedModelProvider {
2697
+ anthropic?: z.infer<typeof AnthropicProviderOptions> | undefined;
2059
2698
  id: string;
2060
2699
  label: string;
2061
2700
  kind: RegistryProviderKind | "openrouter-managed";
@@ -2105,6 +2744,20 @@ export interface ConfiguredModel {
2105
2744
  reasoningEffort: boolean;
2106
2745
  hostedWebSearch: boolean;
2107
2746
  }
2747
+ /**
2748
+ * Whether a resolved route is the deployment-funded OpenRouter free tier: the
2749
+ * managed OpenRouter provider, which sends every workspace's requests with the
2750
+ * deployment's one OpenRouter key, serving an upstream `:free` variant (the
2751
+ * curated catalog admits nothing else). OpenRouter limits free-variant
2752
+ * requests per account per minute and per day, so each request on this route
2753
+ * spends quota that every turn on the deployment shares. A workspace or
2754
+ * organization OpenRouter connection uses its own account and is not this
2755
+ * route.
2756
+ */
2757
+ export declare function isManagedOpenRouterFreeRoute(route: {
2758
+ provider: Pick<ResolvedModelProvider, "kind">;
2759
+ configured: Pick<ConfiguredModel, "upstreamModelId">;
2760
+ }): boolean;
2108
2761
  export declare const VERCEL_AI_GATEWAY_BASE_URL: "https://ai-gateway.vercel.sh/v1";
2109
2762
  export declare const VERCEL_AI_GATEWAY_AI_SDK_BASE_URL: "https://ai-gateway.vercel.sh/v4/ai";
2110
2763
  export declare const VERCEL_AI_GATEWAY_CONNECTION_DOMAIN: "ai-gateway.vercel.sh";
@@ -2189,6 +2842,8 @@ export declare function configuredOpenRouterOrganizationProductModelIds(settings
2189
2842
  * llm-prices.com as a ground-truth canary; it does not generate this table.
2190
2843
  */
2191
2844
  export declare const defaultModelPricing: Record<string, ModelPricingScheduleV1>;
2845
+ /** Reviewed comparison rates only; never debit or execution-definition defaults. */
2846
+ export declare const reviewedModelListPricing: Record<string, ModelPricingScheduleV1>;
2192
2847
  export type SandboxRequiredEnv = {
2193
2848
  field: keyof Settings;
2194
2849
  env: string;
@@ -2258,6 +2913,17 @@ export declare function collectSandboxEnvironment(settings: Settings, source?: N
2258
2913
  */
2259
2914
  export declare function resolveProviderApiKey(provider: Pick<RegistryProvider, "apiKey" | "apiKeyEnv">, source?: NodeJS.ProcessEnv): string | undefined;
2260
2915
  export declare function gatewayRequestPolicyForUpstreamModel(upstreamModelId: string, models?: readonly GatewayCatalogModel[]): ConfiguredModel["requestPolicy"];
2916
+ /** Customer-owned OpenAI/Azure routes, bound to immutable connection identity. */
2917
+ export declare function withDirectModelProviders(settings: Settings, connections: readonly {
2918
+ id: string;
2919
+ version: number;
2920
+ subjectId: string | null;
2921
+ kind: string;
2922
+ status: string;
2923
+ providerDomain: string;
2924
+ metadata: Record<string, unknown>;
2925
+ apiKey?: string;
2926
+ }[]): Settings;
2261
2927
  /** Static catalog overlay; it contains no concrete workspace credential. */
2262
2928
  export declare function withWorkspaceGatewayCatalogProvider(settings: Settings, customModels?: readonly {
2263
2929
  upstreamModelId: string;
@@ -2319,6 +2985,13 @@ export declare function serviceTierForLatencyMode(providerId: string, latencyMod
2319
2985
  /** True when the response tier fulfills a non-standard Fast/priority request. */
2320
2986
  export declare function responseSatisfiesLatencyMode(requested: LatencyMode, responseServiceTier: string | null | undefined): boolean;
2321
2987
  export declare function runnableLatencyModesForModel(settings: Settings, modelId: string): LatencyMode[];
2988
+ export declare class UnsupportedLatencyModeError extends Error {
2989
+ readonly modelId: string;
2990
+ readonly latencyMode: LatencyMode;
2991
+ readonly allowedLatencyModes: readonly LatencyMode[];
2992
+ readonly code = "UNSUPPORTED_LATENCY_MODE";
2993
+ constructor(modelId: string, latencyMode: LatencyMode, allowedLatencyModes: readonly LatencyMode[]);
2994
+ }
2322
2995
  export declare function modelCostClassForConfiguredModel(_settings: Settings, model: Pick<ConfiguredModel, "cost">): ConfiguredModelCostClass;
2323
2996
  /**
2324
2997
  * The built-in provider's stable id: "openai" on the OpenAI platform, "azure"
@@ -2343,6 +3016,8 @@ export declare function configuredProviders(settings: Settings, source?: NodeJS.
2343
3016
  * select, lease, refresh, or expose a concrete credential; those runtime
2344
3017
  * operations remain owned by the credential allocator.
2345
3018
  */
3019
+ /** Exact upstream slugs of the active Codex catalog (or the built-in fallback list). */
3020
+ export declare function codexUpstreamModelSlugs(settings: Settings): string[];
2346
3021
  export declare function withCodexCatalogProvider(settings: Settings): Settings;
2347
3022
  /**
2348
3023
  * Static SuperGrok product catalogue, matching the Codex subscription seam.
@@ -2383,6 +3058,14 @@ export declare function canonicalizeConfiguredModelId(settings: Settings, modelI
2383
3058
  * openai allow-list, then registry ids.
2384
3059
  */
2385
3060
  export declare function configuredAllowedModels(settings: Settings): string[];
3061
+ /** Retirement is selection metadata, never provider authority or executable identity. */
3062
+ export declare function isModelAvailableForNewSelection(settings: Settings, modelId: string): boolean;
3063
+ /** Called only with the durable policy installed for a claimed accepted attempt. */
3064
+ export declare function settingsForAcceptedSubscriptionTurn(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
3065
+ modelId: string;
3066
+ reasoningEffort: Settings["openaiReasoningEffort"];
3067
+ latencyMode?: LatencyMode;
3068
+ }): Settings;
2386
3069
  /**
2387
3070
  * Resolve a model string to the provider that serves it and its configured
2388
3071
  * shape. Returns undefined when the id is not exposed (built-in allow-list nor
@@ -2410,16 +3093,29 @@ export type ResolveTurnExecutionPolicyV1Input = {
2410
3093
  * callers must keep their live credential/readiness gate authoritative.
2411
3094
  */
2412
3095
  export declare function resolveModelProviderForTurn(settings: Settings, modelId: string): ReturnType<typeof resolveModelProvider>;
3096
+ /**
3097
+ * The requested model cannot start new work: it is retired from new selection
3098
+ * or absent from the configured catalog. Callers that own a durable refusal
3099
+ * (for example a scheduled occurrence) record it instead of failing blindly.
3100
+ */
3101
+ export declare class TurnExecutionPolicyModelUnavailableError extends Error {
3102
+ constructor(message: string);
3103
+ }
2413
3104
  /**
2414
3105
  * Build a trusted, secret-safe execution policy from the normalized catalog.
2415
3106
  * The Codex overlay here contains static product/provider identity only; it
2416
3107
  * neither proves readiness nor chooses, decrypts, leases, or exposes an account.
2417
3108
  */
2418
3109
  export declare function resolveTurnExecutionPolicyV1(settings: Settings, input: ResolveTurnExecutionPolicyV1Input): TurnExecutionPolicyV1;
3110
+ /** Explicit accepted execution identity matches, but its definition digest differs. */
3111
+ export declare class TurnExecutionPolicyDefinitionMismatchError extends Error {
3112
+ readonly code = "turn_execution_policy_definition_mismatch";
3113
+ constructor();
3114
+ }
2419
3115
  /**
2420
3116
  * Parse-time validation lives in @opengeni/contracts; this verifier binds a
2421
3117
  * present snapshot to the current executable definition and exact turn row.
2422
- * Any deployment/provider drift fails before a provider or compaction call.
3118
+ * Non-additive executable drift fails before a provider or compaction call.
2423
3119
  */
2424
3120
  export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Settings, policy: TurnExecutionPolicyV1, expected: {
2425
3121
  modelId: string;
@@ -2437,6 +3133,13 @@ export declare function assertTurnExecutionPolicyMatchesConfigV1(settings: Setti
2437
3133
  * complete schedule, and always replace the lower-precedence schedule.
2438
3134
  */
2439
3135
  export declare function configuredModelPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
3136
+ /**
3137
+ * Insights list-price metadata, including reviewed namespaced provider routes.
3138
+ * Kept separate from debit/catalog pricing: adding a comparison must not change
3139
+ * an accepted turn's frozen execution-definition hash or payer classification.
3140
+ * Inline registry and explicit product-ID prices always win over projections.
3141
+ */
3142
+ export declare function configuredModelListPricingSchedules(settings: Settings): Record<string, ModelPricingScheduleV1>;
2440
3143
  /** Legacy flat projection: returns the default/below-threshold price. */
2441
3144
  export declare function configuredModelPricing(settings: Settings): Record<string, ModelPricing>;
2442
3145
  /** Select the per-provider-request price at an exact input-token threshold. */
@@ -2460,6 +3163,29 @@ export declare function calculateModelUsageCostMicros(settings: Settings, model:
2460
3163
  export declare function calculateModelUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
2461
3164
  latencyMode?: LatencyMode;
2462
3165
  }): ModelUsageCostBreakdown;
3166
+ /** Provider-list/equivalent-credit comparison only; never debit authority. */
3167
+ export declare function calculateModelListUsageCostBreakdown(settings: Settings, model: string, usage: ModelUsageInput, options?: {
3168
+ latencyMode?: LatencyMode;
3169
+ }): ModelUsageCostBreakdown;
3170
+ /**
3171
+ * Forward-only list comparison snapshot for the model-call fact writer.
3172
+ * Callers must establish request price provenance (including geography/service
3173
+ * tier) and retain per-request counters. Unknown counters/TTL/modifiers yield
3174
+ * no class split, not invented zeros. Historical facts must not use this helper.
3175
+ * Native Claude details preserve cache_write_tokens_5m and cache_write_tokens_1h.
3176
+ */
3177
+ export declare function calculateModelListUsageCostSnapshot(settings: Settings, model: string, usage: ModelUsageInput, options?: {
3178
+ latencyMode?: LatencyMode;
3179
+ priceContextKnown?: boolean;
3180
+ }): ModelListUsageCostSnapshot;
3181
+ /**
3182
+ * Approximate class attribution of a previously recorded upstream list total.
3183
+ * Current reviewed rates are weights only: this never recomputes that total,
3184
+ * credits, or charges. Missing class counters/rates remain unknown. Historical
3185
+ * cache writes use the schedule's single TTL rate, not an exact TTL assertion.
3186
+ * Reasoning is already included in outputTokens and is never added again.
3187
+ */
3188
+ export declare function allocateRecordedModelListCostByClass(settings: Settings, model: string, usage: ModelUsageInput, recordedProviderCostMicros: number | null | undefined): ModelRecordedListCostAllocation;
2463
3189
  /**
2464
3190
  * Convert AI Gateway's exact USD inference cost to OpenGeni credit micros and
2465
3191
  * apply the configured model margin. Decimal arithmetic is integer-only so a
@@ -2587,6 +3313,7 @@ export declare function applyGitAuthPointerEnvironment(environment: Record<strin
2587
3313
  email: string;
2588
3314
  } | null): Record<string, string>;
2589
3315
  export type StartupRetryOptions = {
3316
+ shouldRetry?: (error: unknown) => boolean;
2590
3317
  attempts?: number;
2591
3318
  initialDelayMs?: number;
2592
3319
  maxDelayMs?: number;
@@ -2598,7 +3325,7 @@ export type StartupRetryOptions = {
2598
3325
  error: unknown;
2599
3326
  }) => void;
2600
3327
  };
2601
- export declare function startupRetryOptions(settings: Settings): Required<Omit<StartupRetryOptions, "onRetry">>;
3328
+ export declare function startupRetryOptions(settings: Settings): Required<Omit<StartupRetryOptions, "onRetry" | "shouldRetry">>;
2602
3329
  export declare function retryStartupDependency<T>(label: string, operation: () => Promise<T>, options?: StartupRetryOptions): Promise<T>;
2603
3330
  export declare function sandboxEnvironmentVariableNames(settings: Settings): string[];
2604
3331
  export declare function sandboxLifecycleHookIds(settings: Settings): string[];
@@ -2647,6 +3374,31 @@ export declare function firstPartyMcpInternalBaseUrl(settings: Settings): string
2647
3374
  export declare function firstPartyMcpWorkspaceUrl(settings: Settings, workspaceId: string): string;
2648
3375
  export declare function firstPartyMcpInternalWorkspaceUrl(settings: Settings, workspaceId: string): string;
2649
3376
  export declare function codemodeWorkspaceUrl(settings: Settings, workspaceId: string): string;
3377
+ export type TrustedProxyCidr = {
3378
+ address: string;
3379
+ prefix: number;
3380
+ family: "ipv4" | "ipv6";
3381
+ };
3382
+ /**
3383
+ * Parse `OPENGENI_API_TRUSTED_PROXY_CIDRS`: comma-separated IPv4/IPv6 CIDRs or
3384
+ * single addresses. Throws on any malformed entry so a typo can never widen or
3385
+ * silently disable the trusted proxy set.
3386
+ */
3387
+ export declare function trustedProxyCidrEntries(raw: string): TrustedProxyCidr[];
3388
+ /**
3389
+ * Parse `OPENGENI_LOCAL_ALLOWED_ORIGINS`: comma-separated exact browser origins
3390
+ * (`http(s)://host[:port]`, no path, query, credentials, or wildcard). Throws on
3391
+ * any malformed entry so a typo can never widen or silently disable the local
3392
+ * browser boundary.
3393
+ */
3394
+ export declare function localAllowedOriginEntries(raw: string | undefined): string[];
3395
+ /**
3396
+ * Local development only: whether a normalized API path is one a sandbox calls
3397
+ * (Codemode, first-party MCP, and the personal Git broker). The Linux Docker
3398
+ * sandbox route relays only these, and the local API serves only these on the
3399
+ * addresses that only sandboxes use (see `apps/api/src/http/local-browser-boundary.ts`).
3400
+ */
3401
+ export declare function localSandboxApiRouteAllowed(pathname: string): boolean;
2650
3402
  /** Validate one fully resolved, secret-bearing executable catalog. */
2651
3403
  export declare function validateModelCatalogSettings(settings: Settings, source?: NodeJS.ProcessEnv): ConfiguredModel[];
2652
3404
  /**
@@ -2711,4 +3463,32 @@ export interface NatsControlPlaneAuth {
2711
3463
  user: string;
2712
3464
  password: string;
2713
3465
  }
2714
- export declare function resolveNatsControlPlaneAuth(settings: Settings): NatsControlPlaneAuth | null;
3466
+ export declare function resolveNatsControlPlaneAuth(settings: Pick<Settings, "selfhostedNatsControlUser" | "selfhostedNatsControlPassword">): NatsControlPlaneAuth | null;
3467
+ /** Image references a workspace may select as its default sandbox image. */
3468
+ export declare function sandboxImageAllowlist(settings: Pick<Settings, "sandboxImageAllowlist">): string[];
3469
+ /** Native Claude connections reuse the encrypted workspace and organization boundaries. */
3470
+ export declare const CLAUDE_CONNECTION_KINDS: readonly ["anthropic", "claude_subscription"];
3471
+ export type ClaudeConnectionKind = (typeof CLAUDE_CONNECTION_KINDS)[number];
3472
+ export declare function claudeNativeModelProfile(upstreamModelId: string): Readonly<{
3473
+ efforts: readonly ReasoningEffort[];
3474
+ defaultEffort: ReasoningEffort | null;
3475
+ contextWindowTokens: number;
3476
+ maxOutputTokens: number;
3477
+ }> | undefined;
3478
+ export declare function claudeProviderId(kind: ClaudeConnectionKind, scope?: "workspace" | "organization"): string;
3479
+ export type ClaudeConnectionCatalog = Partial<Record<ClaudeConnectionKind, {
3480
+ active?: boolean;
3481
+ models: readonly {
3482
+ upstreamModelId: string;
3483
+ label?: string | null;
3484
+ }[];
3485
+ }>>;
3486
+ export declare function withClaudeConnectionCatalog(settings: Settings, connections: ClaudeConnectionCatalog, scope?: "workspace" | "organization"): Settings;
3487
+ export declare function withClaudeConnectionCredential(settings: Settings, kind: ClaudeConnectionKind, credential: string, scope?: "workspace" | "organization", credentialBinding?: {
3488
+ connectionId: string;
3489
+ credentialVersion: number;
3490
+ }): Settings;
3491
+ export * from "./claude-subscription-usage.js";
3492
+ export * from "./claude-subscription-oauth.js";
3493
+ export * from "./subscription-account-selection.js";
3494
+ export * from "./claude-subscription-capacity.js";