@elizaos/shared 2.0.0-alpha.538 → 2.0.3-beta.2

package/contracts/feature-result.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Discriminated result type returned by features that depend on a system
+ * permission. Callers branch on `ok`; on failure, `reason` discriminates
+ * between a missing permission, a native error, or an unsupported platform.
+ */
+import type { PermissionId } from "./permissions.js";
+export type FeatureResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    reason: "permission";
+    permission: PermissionId;
+    canRequest: boolean;
+} | {
+    ok: false;
+    reason: "native_error";
+    message: string;
+} | {
+    ok: false;
+    reason: "not_supported";
+    platform: string;
+};
+//# sourceMappingURL=feature-result.d.ts.map

package/contracts/feature-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-result.d.ts","sourceRoot":"","sources":["../../src/contracts/feature-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GACrB;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,YAAY,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;CACrB,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/contracts/feature-result.js

@@ -0,0 +1,7 @@
+/**
+ * Discriminated result type returned by features that depend on a system
+ * permission. Callers branch on `ok`; on failure, `reason` discriminates
+ * between a missing permission, a native error, or an unsupported platform.
+ */
+export {};
+//# sourceMappingURL=feature-result.js.map

package/contracts/feature-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-result.js","sourceRoot":"","sources":["../../src/contracts/feature-result.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/contracts/{onboarding.d.ts → first-run-options.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Shared onboarding contracts.
+ * Shared first-run provider setup contracts.
  */
 import type { DeploymentTargetConfig, LinkedAccountFlagsConfig, LinkedAccountProviderId, ServiceRoutingConfig } from "./service-routing.js";
 export declare const CHARACTER_LANGUAGES: readonly ["en", "zh-CN", "ko", "es", "pt", "vi", "tl"];
@@ -30,20 +30,20 @@ export interface StylePreset {
         };
     }>>;
 }
-export type OnboardingProviderFamily = "anthropic" | "deepseek" | "elizacloud" | "gemini" | "grok" | "groq" | "mistral" | "moonshot" | "ollama" | "openai" | "openrouter" | "together" | "zai" | (string & {});
-export type OnboardingProviderId = "anthropic" | "anthropic-subscription" | "deepseek" | "elizacloud" | "gemini" | "grok" | "groq" | "mistral" | "moonshot" | "ollama" | "openai" | "openai-subscription" | "openrouter" | "together" | "zai" | (string & {});
-export type OnboardingProviderAuthMode = "api-key" | "cloud" | "credentials" | "local" | "subscription" | (string & {});
-export type OnboardingProviderGroup = "cloud" | "local" | "subscription" | (string & {});
+export type FirstRunProviderFamily = "anthropic" | "cerebras" | "deepseek" | "elizacloud" | "gemini" | "grok" | "groq" | "mistral" | "moonshot" | "nearai" | "ollama" | "openai" | "openrouter" | "together" | "zai" | (string & {});
+export type FirstRunProviderId = "anthropic" | "anthropic-subscription" | "cerebras" | "deepseek" | "deepseek-coding-subscription" | "elizacloud" | "gemini" | "gemini-subscription" | "grok" | "groq" | "kimi-coding-subscription" | "mistral" | "moonshot" | "nearai" | "ollama" | "openai" | "openai-subscription" | "openrouter" | "together" | "zai" | "zai-coding-subscription" | (string & {});
+export type FirstRunProviderAuthMode = "api-key" | "cloud" | "credentials" | "local" | "subscription" | (string & {});
+export type FirstRunProviderGroup = "cloud" | "local" | "subscription" | (string & {});
 export interface ProviderOption {
-    id: OnboardingProviderId;
+    id: FirstRunProviderId;
     name: string;
     envKey: string | null;
     pluginName: string;
     keyPrefix: string | null;
     description: string;
-    family: OnboardingProviderFamily;
-    authMode: OnboardingProviderAuthMode;
-    group: OnboardingProviderGroup;
+    family: FirstRunProviderFamily;
+    authMode: FirstRunProviderAuthMode;
+    group: FirstRunProviderGroup;
     order: number;
     recommended?: boolean;
     labelKey?: string;
@@ -60,6 +60,8 @@ export interface ModelOption {
     name: string;
     provider: string;
     description: string;
+    recommended?: boolean;
+    free?: boolean;
 }
 export interface OpenRouterModelOption {
     id: string;
@@ -74,7 +76,7 @@ export interface MessageExample {
     user: string;
     content: MessageExampleContent;
 }
-export interface OnboardingConnectorConfig {
+export interface FirstRunConnectorConfig {
     enabled?: boolean;
     botToken?: string;
     token?: string;
@@ -93,8 +95,8 @@ export interface InventoryProviderOption {
     description: string;
     rpcProviders: RpcProviderOption[];
 }
-export type SubscriptionProviderSelectionId = "anthropic-subscription" | "openai-subscription";
-export type StoredSubscriptionProviderId = "anthropic-subscription" | "openai-codex";
+export type SubscriptionProviderSelectionId = "anthropic-subscription" | "openai-subscription" | "gemini-subscription" | "zai-coding-subscription" | "kimi-coding-subscription" | "deepseek-coding-subscription";
+export type StoredSubscriptionProviderId = "anthropic-subscription" | "openai-codex" | "gemini-cli" | "zai-coding" | "kimi-coding" | "deepseek-coding";
 export declare const SUBSCRIPTION_PROVIDER_SELECTIONS: readonly [{
     readonly id: "anthropic-subscription";
     readonly storedProvider: "anthropic-subscription";
@@ -105,13 +107,33 @@ export declare const SUBSCRIPTION_PROVIDER_SELECTIONS: readonly [{
     readonly storedProvider: "openai-codex";
     readonly family: "openai";
     readonly labelKey: "providerswitcher.chatgptSubscription";
+}, {
+    readonly id: "gemini-subscription";
+    readonly storedProvider: "gemini-cli";
+    readonly family: "gemini";
+    readonly labelKey: "providerswitcher.geminiSubscription";
+}, {
+    readonly id: "zai-coding-subscription";
+    readonly storedProvider: "zai-coding";
+    readonly family: "zai";
+    readonly labelKey: "providerswitcher.zaiCodingPlan";
+}, {
+    readonly id: "kimi-coding-subscription";
+    readonly storedProvider: "kimi-coding";
+    readonly family: "moonshot";
+    readonly labelKey: "providerswitcher.kimiCodingPlan";
+}, {
+    readonly id: "deepseek-coding-subscription";
+    readonly storedProvider: "deepseek-coding";
+    readonly family: "deepseek";
+    readonly labelKey: "providerswitcher.deepseekCodingPlan";
 }];
-export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
+export declare const FIRST_RUN_PROVIDER_CATALOG: readonly [{
     readonly id: "elizacloud";
     readonly name: "Eliza Cloud";
-    readonly envKey: any;
+    readonly envKey: null;
     readonly pluginName: "@elizaos/plugin-elizacloud";
-    readonly keyPrefix: any;
+    readonly keyPrefix: null;
     readonly description: "Managed hosting for Eliza agents and bundled infrastructure.";
     readonly family: "elizacloud";
     readonly authMode: "cloud";
@@ -121,9 +143,9 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
 }, {
     readonly id: "anthropic-subscription";
     readonly name: "Claude Subscription";
-    readonly envKey: any;
+    readonly envKey: null;
     readonly pluginName: "@elizaos/plugin-anthropic";
-    readonly keyPrefix: any;
+    readonly keyPrefix: null;
     readonly description: "Powers task agents via Claude Code CLI. For the main agent, use Eliza Cloud or a direct API key.";
     readonly family: "anthropic";
     readonly authMode: "subscription";
@@ -135,10 +157,10 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
 }, {
     readonly id: "openai-subscription";
     readonly name: "ChatGPT Subscription";
-    readonly envKey: any;
+    readonly envKey: null;
     readonly pluginName: "@elizaos/plugin-openai";
-    readonly keyPrefix: any;
-    readonly description: "Use your ChatGPT Plus or Pro subscription via OAuth.";
+    readonly keyPrefix: null;
+    readonly description: "Powers Codex-backed coding agents through the official Codex surface.";
     readonly family: "openai";
     readonly authMode: "subscription";
     readonly group: "subscription";
@@ -146,6 +168,58 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly recommended: true;
     readonly labelKey: "providerswitcher.chatgptSubscription";
     readonly storedProvider: "openai-codex";
+}, {
+    readonly id: "gemini-subscription";
+    readonly name: "Gemini CLI Subscription";
+    readonly envKey: null;
+    readonly pluginName: "@elizaos/plugin-google-genai";
+    readonly keyPrefix: null;
+    readonly description: "Powers task agents through the authenticated Gemini CLI. No Gemini subscription token is imported into API env vars.";
+    readonly family: "gemini";
+    readonly authMode: "subscription";
+    readonly group: "subscription";
+    readonly order: 35;
+    readonly labelKey: "providerswitcher.geminiSubscription";
+    readonly storedProvider: "gemini-cli";
+}, {
+    readonly id: "zai-coding-subscription";
+    readonly name: "z.ai Coding Plan";
+    readonly envKey: null;
+    readonly pluginName: "@elizaos/plugin-zai";
+    readonly keyPrefix: null;
+    readonly description: "Stores z.ai Coding Plan credentials for the dedicated coding endpoint only, not the general z.ai API key path.";
+    readonly family: "zai";
+    readonly authMode: "subscription";
+    readonly group: "subscription";
+    readonly order: 36;
+    readonly labelKey: "providerswitcher.zaiCodingPlan";
+    readonly storedProvider: "zai-coding";
+}, {
+    readonly id: "kimi-coding-subscription";
+    readonly name: "Kimi Code";
+    readonly envKey: null;
+    readonly pluginName: "@elizaos/plugin-openai";
+    readonly keyPrefix: null;
+    readonly description: "Stores Kimi Code credentials for Kimi's coding endpoint only, not the Moonshot general API key path.";
+    readonly family: "moonshot";
+    readonly authMode: "subscription";
+    readonly group: "subscription";
+    readonly order: 37;
+    readonly labelKey: "providerswitcher.kimiCodingPlan";
+    readonly storedProvider: "kimi-coding";
+}, {
+    readonly id: "deepseek-coding-subscription";
+    readonly name: "DeepSeek Coding Plan";
+    readonly envKey: null;
+    readonly pluginName: "@elizaos/plugin-deepseek";
+    readonly keyPrefix: null;
+    readonly description: "Unavailable until DeepSeek exposes a first-party coding subscription surface that can be integrated without API-key substitution.";
+    readonly family: "deepseek";
+    readonly authMode: "subscription";
+    readonly group: "subscription";
+    readonly order: 38;
+    readonly labelKey: "providerswitcher.deepseekCodingPlan";
+    readonly storedProvider: "deepseek-coding";
 }, {
     readonly id: "anthropic";
     readonly name: "Anthropic";
@@ -185,7 +259,7 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly name: "Gemini";
     readonly envKey: "GOOGLE_GENERATIVE_AI_API_KEY";
     readonly pluginName: "@elizaos/plugin-google-genai";
-    readonly keyPrefix: any;
+    readonly keyPrefix: null;
     readonly description: "Google's Gemini models.";
     readonly family: "gemini";
     readonly authMode: "api-key";
@@ -213,6 +287,17 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly authMode: "api-key";
     readonly group: "local";
     readonly order: 100;
+}, {
+    readonly id: "cerebras";
+    readonly name: "Cerebras";
+    readonly envKey: "CEREBRAS_API_KEY";
+    readonly pluginName: "@elizaos/plugin-openai";
+    readonly keyPrefix: "csk-";
+    readonly description: "Fast inference for open models via Cerebras.";
+    readonly family: "cerebras";
+    readonly authMode: "api-key";
+    readonly group: "local";
+    readonly order: 105;
 }, {
     readonly id: "deepseek";
     readonly name: "DeepSeek";
@@ -229,7 +314,7 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly name: "Mistral";
     readonly envKey: "MISTRAL_API_KEY";
     readonly pluginName: "@elizaos/plugin-mistral";
-    readonly keyPrefix: any;
+    readonly keyPrefix: null;
     readonly description: "Mistral AI models.";
     readonly family: "mistral";
     readonly authMode: "api-key";
@@ -240,7 +325,7 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly name: "Together AI";
     readonly envKey: "TOGETHER_API_KEY";
     readonly pluginName: "@elizaos/plugin-together";
-    readonly keyPrefix: any;
+    readonly keyPrefix: null;
     readonly description: "Open-source model hosting.";
     readonly family: "together";
     readonly authMode: "api-key";
@@ -249,9 +334,9 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
 }, {
     readonly id: "ollama";
     readonly name: "Ollama";
-    readonly envKey: any;
+    readonly envKey: null;
     readonly pluginName: "@elizaos/plugin-ollama";
-    readonly keyPrefix: any;
+    readonly keyPrefix: null;
     readonly description: "Local models, no API key needed.";
     readonly family: "ollama";
     readonly authMode: "local";
@@ -261,13 +346,25 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly id: "zai";
     readonly name: "z.ai";
     readonly envKey: "ZAI_API_KEY";
-    readonly pluginName: "@homunculuslabs/plugin-zai";
-    readonly keyPrefix: any;
-    readonly description: "GLM models via z.ai Coding Plan.";
+    readonly pluginName: "@elizaos/plugin-zai";
+    readonly keyPrefix: null;
+    readonly description: "GLM models via z.ai direct API billing.";
     readonly family: "zai";
     readonly authMode: "api-key";
     readonly group: "local";
     readonly order: 150;
+}, {
+    readonly id: "nearai";
+    readonly name: "NEAR AI";
+    readonly envKey: "NEARAI_API_KEY";
+    readonly pluginName: "@elizaos/plugin-nearai";
+    readonly keyPrefix: null;
+    readonly description: "TEE-backed private inference via NEAR AI Cloud.";
+    readonly family: "nearai";
+    readonly authMode: "api-key";
+    readonly group: "local";
+    readonly order: 155;
+    readonly supportsPrimaryModelOverride: true;
 }, {
     readonly id: "moonshot";
     readonly name: "Kimi / Moonshot";
@@ -281,20 +378,21 @@ export declare const ONBOARDING_PROVIDER_CATALOG: readonly [{
     readonly order: 160;
     readonly supportsPrimaryModelOverride: true;
 }];
-export declare const DIRECT_ACCOUNT_PROVIDER_BY_ONBOARDING_PROVIDER: {
+export declare const DIRECT_ACCOUNT_PROVIDER_BY_FIRST_RUN_PROVIDER: {
     readonly anthropic: "anthropic-api";
     readonly openai: "openai-api";
     readonly deepseek: "deepseek-api";
     readonly zai: "zai-api";
     readonly moonshot: "moonshot-api";
+    readonly cerebras: "cerebras-api";
 };
-export declare const ONBOARDING_CLOUD_PROVIDER_OPTIONS: readonly [{
+export declare const FIRST_RUN_CLOUD_PROVIDER_OPTIONS: readonly [{
     readonly id: "elizacloud";
     readonly name: "Eliza Cloud";
     readonly description: "Managed cloud infrastructure. Wallets, LLMs, and RPCs included.";
 }];
-export type OnboardingLocalProviderId = Exclude<OnboardingProviderId, "elizacloud">;
-interface OnboardingCloudModelPreferences {
+export type FirstRunLocalProviderId = Exclude<FirstRunProviderId, "elizacloud">;
+interface FirstRunCloudModelPreferences {
     nanoModel?: string;
     smallModel?: string;
     mediumModel?: string;
@@ -307,27 +405,27 @@ interface OnboardingCloudModelPreferences {
     responseModel?: string;
     mediaDescriptionModel?: string;
 }
-export interface OnboardingCloudManagedConnection extends OnboardingCloudModelPreferences {
+export interface FirstRunCloudManagedConnection extends FirstRunCloudModelPreferences {
     kind: "cloud-managed";
     cloudProvider: "elizacloud";
     apiKey?: string;
 }
-export interface OnboardingLocalProviderConnection {
+export interface FirstRunLocalProviderConnection {
     kind: "local-provider";
-    provider: OnboardingLocalProviderId;
+    provider: FirstRunLocalProviderId;
     apiKey?: string;
     primaryModel?: string;
 }
-export interface OnboardingRemoteProviderConnection {
+export interface FirstRunRemoteProviderConnection {
     kind: "remote-provider";
     remoteApiBase: string;
     remoteAccessToken?: string;
-    provider?: OnboardingLocalProviderId;
+    provider?: FirstRunLocalProviderId;
     apiKey?: string;
     primaryModel?: string;
 }
-export type OnboardingConnection = OnboardingCloudManagedConnection | OnboardingLocalProviderConnection | OnboardingRemoteProviderConnection;
-export interface OnboardingOptions {
+export type FirstRunConnection = FirstRunCloudManagedConnection | FirstRunLocalProviderConnection | FirstRunRemoteProviderConnection;
+export interface FirstRunOptions {
     names: string[];
     styles: StylePreset[];
     providers: ProviderOption[];
@@ -344,19 +442,19 @@ export interface OnboardingOptions {
     sharedStyleRules: string;
     githubOAuthAvailable?: boolean;
 }
-export interface OnboardingCredentialInputs {
+export interface FirstRunCredentialInputs {
     llmApiKey?: string;
     cloudApiKey?: string;
 }
-export interface OnboardingLlmPersistenceSelection extends OnboardingCloudModelPreferences {
-    backend: OnboardingProviderId;
+export interface FirstRunLlmPersistenceSelection extends FirstRunCloudModelPreferences {
+    backend: FirstRunProviderId;
     transport: "direct" | "remote" | "cloud-proxy";
     apiKey?: string;
     primaryModel?: string;
     remoteApiBase?: string;
     remoteAccessToken?: string;
 }
-export type SubscriptionCredentialSource = "app" | "claude-code-cli" | "setup-token" | "codex-cli" | null;
+export type SubscriptionCredentialSource = "app" | "claude-code-cli" | "setup-token" | "codex-cli" | "gemini-cli" | "coding-plan-key" | "unavailable" | null;
 export interface SubscriptionProviderStatus {
     provider: string;
     /**
@@ -371,6 +469,11 @@ export interface SubscriptionProviderStatus {
     valid: boolean;
     expiresAt: number | null;
     source: SubscriptionCredentialSource;
+    available?: boolean;
+    availabilityReason?: string;
+    allowedClient?: string;
+    loginHint?: string;
+    billingMode?: "subscription-coding-plan" | "subscription-coding-cli";
 }
 export interface SubscriptionStatusResponse {
     providers: SubscriptionProviderStatus[];
@@ -378,45 +481,45 @@ export interface SubscriptionStatusResponse {
 export declare function isSubscriptionProviderSelectionId(value: unknown): value is SubscriptionProviderSelectionId;
 export declare function normalizeSubscriptionProviderSelectionId(value: unknown): SubscriptionProviderSelectionId | null;
 export declare function getStoredSubscriptionProvider(selectionId: SubscriptionProviderSelectionId): StoredSubscriptionProviderId;
-export declare function getSubscriptionProviderFamily(selectionId: SubscriptionProviderSelectionId): "anthropic" | "openai";
+export declare function getSubscriptionProviderFamily(selectionId: SubscriptionProviderSelectionId): "anthropic" | "openai" | "gemini" | "zai" | "moonshot" | "deepseek";
 export declare function requiresAdditionalRuntimeProvider(providerId: unknown): boolean;
-export declare function normalizeOnboardingProviderId(value: unknown): OnboardingProviderId | null;
-export declare function getOnboardingProviderOption(providerId: unknown): ProviderOption | null;
-export declare function getOnboardingProviderFamily(providerId: unknown): OnboardingProviderFamily | null;
-export declare function getStoredOnboardingProviderId(providerId: unknown): string | null;
-export declare function getDirectAccountProviderForOnboardingProvider(providerId: unknown): LinkedAccountProviderId | null;
-export declare function sortOnboardingProviders(providers: readonly ProviderOption[]): ProviderOption[];
-export declare function isCloudManagedConnection(connection: OnboardingConnection | null | undefined): connection is OnboardingCloudManagedConnection;
-export declare function isRemoteProviderConnection(connection: OnboardingConnection | null | undefined): connection is OnboardingRemoteProviderConnection;
-export declare function isLocalProviderConnection(connection: OnboardingConnection | null | undefined): connection is OnboardingLocalProviderConnection;
-export declare function isOnboardingConnectionComplete(connection: OnboardingConnection | null | undefined): boolean;
-export declare function readOnboardingEnvString(config: Record<string, unknown> | null | undefined, key: string): string | undefined;
-export declare function readOnboardingEnvSecret(config: Record<string, unknown> | null | undefined, key: string): string | undefined;
-export declare function getOnboardingProviderSignalEnvKeys(providerId: OnboardingLocalProviderId): string[];
+export declare function normalizeFirstRunProviderId(value: unknown): FirstRunProviderId | null;
+export declare function getFirstRunProviderOption(providerId: unknown): ProviderOption | null;
+export declare function getFirstRunProviderFamily(providerId: unknown): FirstRunProviderFamily | null;
+export declare function getStoredFirstRunProviderId(providerId: unknown): string | null;
+export declare function getDirectAccountProviderForFirstRunProvider(providerId: unknown): LinkedAccountProviderId | null;
+export declare function sortFirstRunProviders(providers: readonly ProviderOption[]): ProviderOption[];
+export declare function isCloudManagedConnection(connection: FirstRunConnection | null | undefined): connection is FirstRunCloudManagedConnection;
+export declare function isRemoteProviderConnection(connection: FirstRunConnection | null | undefined): connection is FirstRunRemoteProviderConnection;
+export declare function isLocalProviderConnection(connection: FirstRunConnection | null | undefined): connection is FirstRunLocalProviderConnection;
+export declare function isFirstRunConnectionComplete(connection: FirstRunConnection | null | undefined): boolean;
+export declare function readFirstRunEnvString(config: Record<string, unknown> | null | undefined, key: string): string | undefined;
+export declare function readFirstRunEnvSecret(config: Record<string, unknown> | null | undefined, key: string): string | undefined;
+export declare function getFirstRunProviderSignalEnvKeys(providerId: FirstRunLocalProviderId): string[];
 export declare function hasExplicitCanonicalRuntimeConfig(config: Record<string, unknown> | null | undefined): boolean;
 export declare function migrateLegacyRuntimeConfig<T extends Record<string, unknown>>(config: T): T;
 export declare function resolveLinkedAccountsInConfig(config: Record<string, unknown> | null | undefined): LinkedAccountFlagsConfig | null;
 export declare function resolveDeploymentTargetInConfig(config: Record<string, unknown> | null | undefined): DeploymentTargetConfig;
 export declare function resolveServiceRoutingInConfig(config: Record<string, unknown> | null | undefined): ServiceRoutingConfig | null;
-export declare function normalizePersistedOnboardingConnection(value: unknown): OnboardingConnection | null;
-export declare function normalizeOnboardingCredentialInputs(value: unknown): OnboardingCredentialInputs | null;
-export interface OnboardingCredentialPersistencePlan {
-    llmSelection: OnboardingLlmPersistenceSelection | null;
+export declare function normalizePersistedFirstRunConnection(value: unknown): FirstRunConnection | null;
+export declare function normalizeFirstRunCredentialInputs(value: unknown): FirstRunCredentialInputs | null;
+export interface FirstRunCredentialPersistencePlan {
+    llmSelection: FirstRunLlmPersistenceSelection | null;
     cloudApiKey?: string;
 }
-export declare function deriveOnboardingCredentialPersistencePlan(args: {
-    credentialInputs?: OnboardingCredentialInputs | null;
+export declare function deriveFirstRunCredentialPersistencePlan(args: {
+    credentialInputs?: FirstRunCredentialInputs | null;
     deploymentTarget?: DeploymentTargetConfig | null;
     serviceRouting?: ServiceRoutingConfig | null;
-}): OnboardingCredentialPersistencePlan;
-export declare function stripOnboardingConnectionSecrets(connection: OnboardingConnection): OnboardingConnection;
-export declare function inferCompatibilityOnboardingConnection(config: Record<string, unknown> | null | undefined): OnboardingConnection | null;
-export declare function inferOnboardingConnectionFromConfig(config: Record<string, unknown> | null | undefined): OnboardingConnection | null;
+}): FirstRunCredentialPersistencePlan;
+export declare function stripFirstRunConnectionSecrets(connection: FirstRunConnection): FirstRunConnection;
+export declare function inferCompatibilityFirstRunConnection(config: Record<string, unknown> | null | undefined): FirstRunConnection | null;
+export declare function inferFirstRunConnectionFromConfig(config: Record<string, unknown> | null | undefined): FirstRunConnection | null;
 export declare function isCloudInferenceSelectedInConfig(config: Record<string, unknown> | null | undefined): boolean;
 /**
  * Register an additional provider option at runtime.
  * Plugins should call this during initialization to add themselves to the
- * onboarding provider catalog.
+ * first-run provider catalog.
  */
 export declare function registerProviderOption(option: ProviderOption): void;
 /**
@@ -425,4 +528,4 @@ export declare function registerProviderOption(option: ProviderOption): void;
  */
 export declare function getProviderOptions(): ProviderOption[];
 export {};
-//# sourceMappingURL=onboarding.d.ts.map
+//# sourceMappingURL=first-run-options.d.ts.map

package/contracts/first-run-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-run-options.d.ts","sourceRoot":"","sources":["../../src/contracts/first-run-options.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EAEvB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,mBAAmB,wDAQtB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,EAAE,CAAC;QACd,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,eAAe,EAAE,KAAK,CACpB,KAAK,CAAC;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC,CACH,CAAC;CACH;AAED,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,UAAU,GACV,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,KAAK,GACL,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,wBAAwB,GACxB,UAAU,GACV,UAAU,GACV,8BAA8B,GAC9B,YAAY,GACZ,QAAQ,GACR,qBAAqB,GACrB,MAAM,GACN,MAAM,GACN,0BAA0B,GAC1B,SAAS,GACT,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,qBAAqB,GACrB,YAAY,GACZ,UAAU,GACV,KAAK,GACL,yBAAyB,GACzB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,OAAO,GACP,aAAa,GACb,OAAO,GACP,cAAc,GACd,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,OAAO,GACP,cAAc,GACd,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,kBAAkB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,QAAQ,EAAE,wBAAwB,CAAC;IACnC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,EAAE,GACR,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,SAAS,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,MAAM,MAAM,+BAA+B,GACvC,wBAAwB,GACxB,qBAAqB,GACrB,qBAAqB,GACrB,yBAAyB,GACzB,0BAA0B,GAC1B,8BAA8B,CAAC;AAEnC,MAAM,MAAM,4BAA4B,GACpC,wBAAwB,GACxB,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,iBAAiB,CAAC;AAEtB,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0C3C,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuRW,CAAC;AAEnD,eAAO,MAAM,6CAA6C;;;;;;;CASzD,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;EAOU,CAAC;AAExD,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;AAEhF,UAAU,6BAA6B;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAkDD,MAAM,WAAW,8BACf,SAAQ,6BAA6B;IACrC,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,EAAE,YAAY,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,iBAAiB,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,kBAAkB,GAC1B,8BAA8B,GAC9B,+BAA+B,GAC/B,gCAAgC,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;QACtB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;KACtB,CAAC;IACF,gBAAgB,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC3C,kBAAkB,EAAE,uBAAuB,EAAE,CAAC;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,+BACf,SAAQ,6BAA6B;IACrC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AACD,MAAM,MAAM,4BAA4B,GACpC,KAAK,GACL,iBAAiB,GACjB,aAAa,GACb,WAAW,GACX,YAAY,GACZ,iBAAiB,GACjB,aAAa,GACb,IAAI,CAAC;AAET,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,4BAA4B,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,0BAA0B,GAAG,yBAAyB,CAAC;CACtE;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,0BAA0B,EAAE,CAAC;CACzC;AAuCD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,+BAA+B,CAI1C;AAED,wBAAgB,wCAAwC,CACtD,KAAK,EAAE,OAAO,GACb,+BAA+B,GAAG,IAAI,CAGxC;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,+BAA+B,GAC3C,4BAA4B,CAM9B;AAED,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,+BAA+B,GAC3C,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,UAAU,CAMrE;AAED,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,OAAO,GAClB,OAAO,CAGT;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,IAAI,CAgD3B;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,OAAO,GAClB,cAAc,GAAG,IAAI,CAOvB;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,OAAO,GAClB,sBAAsB,GAAG,IAAI,CAE/B;AAED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,OAAO,GAClB,MAAM,GAAG,IAAI,CAIf;AAED,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,OAAO,GAClB,uBAAuB,GAAG,IAAI,CAShC;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,cAAc,EAAE,GACnC,cAAc,EAAE,CASlB;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAChD,UAAU,IAAI,8BAA8B,CAE9C;AAED,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAChD,UAAU,IAAI,gCAAgC,CAEhD;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAChD,UAAU,IAAI,+BAA+B,CAE/C;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAmBT;AA6CD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAGpB;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAClD,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAEpB;AAKD,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,uBAAuB,GAClC,MAAM,EAAE,CAUV;AA6BD,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAQT;AAgMD,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,MAAM,EAAE,CAAC,GACR,CAAC,CAwCH;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,wBAAwB,GAAG,IAAI,CAkBjC;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,sBAAsB,CAQxB;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,oBAAoB,GAAG,IAAI,CAgC7B;AA8FD,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,GACb,kBAAkB,GAAG,IAAI,CA6C3B;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,wBAAwB,GAAG,IAAI,CAiBjC;AAED,MAAM,WAAW,iCAAiC;IAChD,YAAY,EAAE,+BAA+B,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,uCAAuC,CAAC,IAAI,EAAE;IAC5D,gBAAgB,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACnD,gBAAgB,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACjD,cAAc,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC9C,GAAG,iCAAiC,CAyEpC;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAuBpB;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,kBAAkB,GAAG,IAAI,CAgE3B;AAED,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,kBAAkB,GAAG,IAAI,CAE3B;AA0CD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAOT;AASD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CASnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CASrD"}