@opengeni/config 0.8.1 → 0.9.3

package/dist/index.d.ts

@@ -88,6 +88,12 @@ declare const SettingsSchema: z.ZodObject<{
     observabilityMetricsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
     observabilityOtlpEndpoint: z.ZodOptional<z.ZodString>;
     observabilityOtlpHeaders: z.ZodDefault<z.ZodString>;
+    analyticsEnabled: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    analyticsConsentRequired: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    analyticsReoClientId: z.ZodOptional<z.ZodString>;
+    analyticsPosthogProjectKey: z.ZodOptional<z.ZodString>;
+    analyticsPosthogHost: z.ZodOptional<z.ZodString>;
+    analyticsGa4MeasurementId: z.ZodOptional<z.ZodString>;
     publicBaseUrl: z.ZodOptional<z.ZodString>;
     webBaseUrl: z.ZodOptional<z.ZodString>;
     agentReleasesBaseUrl: z.ZodDefault<z.ZodString>;
@@ -130,6 +136,7 @@ declare const SettingsSchema: z.ZodObject<{
     googleDriveClientId: z.ZodOptional<z.ZodString>;
     googleDriveClientSecret: z.ZodOptional<z.ZodString>;
     maxNestedAgentDepth: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    socialOauthClientsJson: z.ZodDefault<z.ZodString>;
     goalMaxAutoContinuations: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     goalNoProgressLimit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
     agentMaxModelCallsPerTurn: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
@@ -1241,6 +1248,13 @@ export declare function sandboxWarmRateMicrosPerSecond(settings: Settings, backe
  */
 export declare function parseModelProvidersJson(raw: string): RegistryProvider[];
 export declare function parseIntegrationsOauthClientsJson(raw: string | undefined): Record<string, IntegrationOAuthClientConfig>;
+export declare const SocialOAuthClientConfigSchema: z.ZodObject<{
+    clientId: z.ZodString;
+    clientSecret: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SocialOAuthClientConfig = z.infer<typeof SocialOAuthClientConfigSchema>;
+declare const SOCIAL_OAUTH_PROVIDER_IDS: readonly ["x", "reddit"];
+export declare function parseSocialOauthClientsJson(raw: string | undefined): Partial<Record<(typeof SOCIAL_OAUTH_PROVIDER_IDS)[number], SocialOAuthClientConfig>>;
 export declare function parseStaticUsageLimitsJson(raw: string): StaticUsageLimitsConfig;
 export declare function parseStaticEntitlementsJson(raw: string): EntitlementsConfig;
 /**

package/dist/index.js

@@ -175,6 +175,12 @@ var SettingsSchema = z.object({
   observabilityMetricsEnabled: EnvBoolean.default(true),
   observabilityOtlpEndpoint: z.string().url().optional(),
   observabilityOtlpHeaders: z.string().default(""),
+  analyticsEnabled: EnvBoolean.default(false),
+  analyticsConsentRequired: EnvBoolean.default(true),
+  analyticsReoClientId: z.string().max(128).regex(/^[A-Za-z0-9_-]+$/u).optional(),
+  analyticsPosthogProjectKey: z.string().min(1).max(256).optional(),
+  analyticsPosthogHost: z.string().url().max(2048).optional(),
+  analyticsGa4MeasurementId: z.string().max(32).regex(/^G-[A-Z0-9]+$/u).optional(),
   publicBaseUrl: z.string().url().optional(),
   // Browser origin when the web app and API use separate origins in local
   // development. Production normally leaves this unset and uses publicBaseUrl.
@@ -223,6 +229,9 @@ var SettingsSchema = z.object({
   // Undefined is meaningful: the migration boundary persists the product
   // default of 3 when no deployment override is supplied.
   maxNestedAgentDepth: z.coerce.number().int().nonnegative().max(MAX_NESTED_AGENT_DEPTH).optional(),
+  // Operator OAuth apps for first-party social connectors, keyed by provider
+  // id ("x", "reddit"): {"x":{"clientId":"...","clientSecret":"..."}}.
+  socialOauthClientsJson: z.string().default("{}"),
   // Session goal guard rails. Goals are designed for runs that legitimately
   // span days, so length is bounded by pathology detection (no-progress
   // streaks, budget exhaustion), never by count. goalMaxAutoContinuations is
@@ -1218,6 +1227,12 @@ function getSettings() {
     observabilityMetricsEnabled: optional("OPENGENI_OBSERVABILITY_METRICS_ENABLED"),
     observabilityOtlpEndpoint: optional("OPENGENI_OTEL_EXPORTER_OTLP_ENDPOINT") ?? optional("OTEL_EXPORTER_OTLP_ENDPOINT"),
     observabilityOtlpHeaders: optional("OPENGENI_OTEL_EXPORTER_OTLP_HEADERS") ?? optional("OTEL_EXPORTER_OTLP_HEADERS"),
+    analyticsEnabled: optional("OPENGENI_ANALYTICS_ENABLED"),
+    analyticsConsentRequired: optional("OPENGENI_ANALYTICS_CONSENT_REQUIRED"),
+    analyticsReoClientId: optional("OPENGENI_ANALYTICS_REO_CLIENT_ID"),
+    analyticsPosthogProjectKey: optional("OPENGENI_ANALYTICS_POSTHOG_PROJECT_KEY"),
+    analyticsPosthogHost: optional("OPENGENI_ANALYTICS_POSTHOG_HOST"),
+    analyticsGa4MeasurementId: optional("OPENGENI_ANALYTICS_GA4_MEASUREMENT_ID"),
     publicBaseUrl: optional("OPENGENI_PUBLIC_BASE_URL"),
     webBaseUrl: optional("OPENGENI_WEB_BASE_URL"),
     agentReleasesBaseUrl: optional("OPENGENI_AGENT_RELEASES_BASE_URL"),
@@ -1247,6 +1262,7 @@ function getSettings() {
     googleDriveClientId: optional("OPENGENI_GOOGLE_DRIVE_CLIENT_ID"),
     googleDriveClientSecret: optional("OPENGENI_GOOGLE_DRIVE_CLIENT_SECRET"),
     maxNestedAgentDepth: optional("OPENGENI_MAX_NESTED_AGENT_DEPTH"),
+    socialOauthClientsJson: optional("OPENGENI_SOCIAL_OAUTH_CLIENTS_JSON"),
     goalMaxAutoContinuations: optional("OPENGENI_GOAL_MAX_AUTO_CONTINUATIONS"),
     goalNoProgressLimit: optional("OPENGENI_GOAL_NO_PROGRESS_LIMIT"),
     agentMaxModelCallsPerTurn: optional("OPENGENI_AGENT_MAX_MODEL_CALLS_PER_TURN"),
@@ -2651,6 +2667,46 @@ function parseIntegrationsOauthClientsJson(raw) {
   }
   return out;
 }
+var SocialOAuthClientConfigSchema = z.object({
+  clientId: z.string().min(1),
+  clientSecret: z.string().min(1).optional()
+});
+var SOCIAL_OAUTH_PROVIDER_IDS = ["x", "reddit"];
+function parseSocialOauthClientsJson(raw) {
+  if (!raw?.trim() || raw.trim() === "{}") {
+    return {};
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`OPENGENI_SOCIAL_OAUTH_CLIENTS_JSON must be valid JSON: ${message}`, {
+      cause: error
+    });
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(
+      "OPENGENI_SOCIAL_OAUTH_CLIENTS_JSON must be a JSON object keyed by social provider id"
+    );
+  }
+  const out = {};
+  for (const [key, value] of Object.entries(parsed)) {
+    if (!SOCIAL_OAUTH_PROVIDER_IDS.includes(key)) {
+      throw new Error(
+        `OPENGENI_SOCIAL_OAUTH_CLIENTS_JSON provider ${key} is not supported (expected: ${SOCIAL_OAUTH_PROVIDER_IDS.join(", ")})`
+      );
+    }
+    const result = SocialOAuthClientConfigSchema.safeParse(value);
+    if (!result.success) {
+      throw new Error(
+        `OPENGENI_SOCIAL_OAUTH_CLIENTS_JSON client for ${key} is invalid: ${result.error.message}`
+      );
+    }
+    out[key] = result.data;
+  }
+  return out;
+}
 function parseStaticUsageLimitsJson(raw) {
   if (!raw.trim() || raw.trim() === "{}") {
     return {};
@@ -2875,6 +2931,7 @@ function validateSettings(settings) {
     }
   }
   parseIntegrationsOauthClientsJson(settings.integrationsOauthClientsJson);
+  parseSocialOauthClientsJson(settings.socialOauthClientsJson);
   if (settings.productAccessMode === "configured" && !["local", "test"].includes(settings.environment) && !settings.delegationSecret && !settings.authRequired) {
     throw new Error(
       "OPENGENI_PRODUCT_ACCESS_MODE=configured requires OPENGENI_DELEGATION_SECRET or OPENGENI_AUTH_REQUIRED=true outside local/test"
@@ -3180,6 +3237,7 @@ export {
   ModelProviderApi,
   RegistryProviderKind,
   SANDBOX_REQUIRED_ENV,
+  SocialOAuthClientConfigSchema,
   applyGitAuthPointerEnvironment,
   assertTurnExecutionPolicyMatchesConfigV1,
   builtinProviderId,
@@ -3212,6 +3270,7 @@ export {
   parseModelPricingJson,
   parseModelProvidersJson,
   parseSandboxWarmRateJson,
+  parseSocialOauthClientsJson,
   parseStaticEntitlementsJson,
   parseStaticUsageLimitsJson,
   policyProviderIdForModel,