@treeseed/sdk 0.4.13 → 0.5.0

package/dist/operations/services/config-runtime.d.ts

@@ -1,15 +1,34 @@
 import type { RemoteTreeseedConfig } from '../../remote.ts';
-import { TREESEED_ENVIRONMENT_SCOPES, validateTreeseedEnvironmentValues } from '../../platform/environment.ts';
+import { TREESEED_ENVIRONMENT_SCOPES, type TreeseedEnvironmentValidation, validateTreeseedEnvironmentValues } from '../../platform/environment.ts';
+import { type TreeseedKeyAgentStatus } from './key-agent.ts';
+export { TREESEED_MACHINE_KEY_PASSPHRASE_ENV, TreeseedKeyAgentError } from './key-agent.ts';
 export declare const DEFAULT_TREESEED_API_BASE_URL = "https://api.treeseed.ai";
 export declare const DEFAULT_TEMPLATE_CATALOG_URL = "https://api.treeseed.ai/search/templates";
 export declare const TREESEED_TEMPLATE_CATALOG_URL_ENV = "TREESEED_TEMPLATE_CATALOG_URL";
 export declare const TREESEED_API_BASE_URL_ENV = "TREESEED_API_BASE_URL";
+export declare function listDeprecatedTreeseedLocalEnvFiles(tenantRoot: any): string[];
+export declare function warnDeprecatedTreeseedLocalEnvFiles(tenantRoot: any, write?: (line: string) => void): string[];
 export declare function getTreeseedMachineConfigPaths(tenantRoot: any): {
     configPath: string;
     authPath: string;
     keyPath: string;
     legacyKeyPath: string;
 };
+export declare function withTreeseedKeyAgentAutopromptDisabled<T>(action: () => T): T;
+export declare function inspectTreeseedKeyAgentStatus(tenantRoot: any): TreeseedKeyAgentStatus;
+export declare function unlockTreeseedSecretSessionInteractive(tenantRoot: any): any;
+export declare function unlockTreeseedSecretSessionFromEnv(tenantRoot: any, options?: {}): any;
+export declare function unlockTreeseedSecretSessionWithPassphrase(tenantRoot: any, passphrase: any, options?: {}): any;
+export declare function ensureTreeseedSecretSessionForConfig({ tenantRoot, interactive, env, createIfMissing, allowMigration, promptForPassphrase, promptForNewPassphrase, }: {
+    tenantRoot: string;
+    interactive?: boolean;
+    env?: NodeJS.ProcessEnv;
+    createIfMissing?: boolean;
+    allowMigration?: boolean;
+    promptForPassphrase?: () => Promise<string> | string;
+    promptForNewPassphrase?: () => Promise<string> | string;
+}): Promise<TreeseedConfigSecretSessionBootstrap>;
+export declare function lockTreeseedSecretSession(tenantRoot: any): any;
 export declare function getTreeseedRemoteAuthPaths(tenantRoot: any): {
     authPath: string;
 };
@@ -18,12 +37,16 @@ export type TreeseedConfigEntrySnapshot = {
     id: string;
     label: string;
     group: string;
+    cluster: string;
+    startupProfile: 'core' | 'optional' | 'advanced';
+    requirement: 'required' | 'conditional' | 'optional';
     description: string;
     howToGet: string;
     sensitivity: 'secret' | 'plain' | 'derived';
     targets: string[];
     purposes: string[];
     storage: 'shared' | 'scoped';
+    validation?: TreeseedEnvironmentValidation;
     scope: TreeseedConfigScope;
     sharedScopes: TreeseedConfigScope[];
     required: boolean;
@@ -44,16 +67,30 @@ export type TreeseedCollectedConfigContext = {
     entriesByScope: Record<TreeseedConfigScope, TreeseedConfigEntrySnapshot[]>;
     valuesByScope: Record<TreeseedConfigScope, Record<string, string>>;
     suggestedValuesByScope: Record<TreeseedConfigScope, Record<string, string>>;
-    authStatusByScope: Record<TreeseedConfigScope, ReturnType<typeof createConfigAuthStatus>>;
+    configReadinessByScope: Record<TreeseedConfigScope, ReturnType<typeof createConfigReadiness>>;
     validationByScope: Record<TreeseedConfigScope, ReturnType<typeof validateTreeseedEnvironmentValues>>;
+    sharedStorageMigrations: TreeseedSharedStorageMigrationNotice[];
     registry: ReturnType<typeof collectTreeseedEnvironmentContext>;
 };
+export type TreeseedConfigSecretSessionBootstrap = {
+    status: TreeseedKeyAgentStatus;
+    createdWrappedKey: boolean;
+    migratedWrappedKey: boolean;
+    unlockSource: 'interactive' | 'env' | 'existing-session';
+};
 export type TreeseedConfigValueUpdate = {
     scope: TreeseedConfigScope;
     entryId: string;
     value: string;
     reused?: boolean;
 };
+export type TreeseedSharedStorageMigrationNotice = {
+    entryId: string;
+    label: string;
+    promotedFrom: TreeseedConfigScope;
+    consolidatedScopes: TreeseedConfigScope[];
+    hadConflicts: boolean;
+};
 export declare function createDefaultTreeseedMachineConfig({ tenantRoot, deployConfig, tenantConfig }: {
     tenantRoot: any;
     deployConfig: any;
@@ -92,8 +129,6 @@ export declare function createDefaultTreeseedMachineConfig({ tenantRoot, deployC
                 projectName: string;
                 apiServiceId: string;
                 apiServiceName: string;
-                agentsServiceId: string;
-                agentsServiceName: string;
             };
         };
     };
@@ -112,6 +147,15 @@ export declare function rotateTreeseedMachineKey(tenantRoot: any): {
     keyPath: string;
     rotated: boolean;
 };
+export declare function rotateTreeseedMachineKeyPassphrase(tenantRoot: any, passphrase: any): {
+    keyPath: string;
+    rotated: boolean;
+};
+export declare function migrateTreeseedMachineKeyToWrapped(tenantRoot: any, passphrase: any): {
+    keyPath: string;
+    migrated: boolean;
+    alreadyWrapped: boolean;
+};
 export declare function loadTreeseedRemoteAuthState(tenantRoot: any): {
     version: number;
     sessions: {
@@ -155,6 +199,7 @@ export declare function resolveTreeseedRemoteSession(tenantRoot: any, hostId: an
 } | null;
 export declare function loadTreeseedMachineConfig(tenantRoot: any): any;
 export declare function writeTreeseedMachineConfig(tenantRoot: any, config: any): void;
+export declare function updateTreeseedDeployConfigFeatureToggles(tenantRoot: string, toggles: Partial<Record<'turnstile' | 'smtp', boolean>>): void;
 export declare function resolveTreeseedRemoteConfig(startRoot?: string, env?: NodeJS.ProcessEnv): RemoteTreeseedConfig;
 export declare function resolveTreeseedTemplateCatalogEndpoint(startRoot?: string, env?: NodeJS.ProcessEnv): string;
 export declare function resolveTreeseedTemplateCatalogCachePath(startRoot?: string): string;
@@ -167,7 +212,13 @@ export declare function applyTreeseedSafeRepairs(tenantRoot: string): TreeseedRe
 export declare function resolveTreeseedMachineEnvironmentValues(tenantRoot: any, scope: any): {};
 export declare function setTreeseedMachineEnvironmentValue(tenantRoot: any, scope: any, entry: any, value: any): any;
 export declare function collectTreeseedEnvironmentContext(tenantRoot: any): import("../../platform/environment.ts").TreeseedResolvedEnvironmentRegistry;
-export declare function collectTreeseedConfigSeedValues(tenantRoot: any, scope: any, env?: NodeJS.ProcessEnv): any;
+export declare function collectTreeseedConfigSeedValues(tenantRoot: any, scope: any, env?: NodeJS.ProcessEnv): {};
+export declare function resolveTreeseedLaunchEnvironment({ tenantRoot, scope, baseEnv, overrides, }: {
+    tenantRoot: string;
+    scope: TreeseedConfigScope;
+    baseEnv?: NodeJS.ProcessEnv;
+    overrides?: NodeJS.ProcessEnv;
+}): {};
 export declare function formatTreeseedConfigEnvironmentReport({ tenantRoot, scope, env, revealSecrets }: {
     tenantRoot: any;
     scope: any;
@@ -197,10 +248,6 @@ export declare function assertTreeseedCommandEnvironment({ tenantRoot, scope, pu
     values: {};
     validation: import("../../platform/environment.ts").TreeseedEnvironmentValidationResult;
 };
-export declare function writeTreeseedLocalEnvironmentFiles(tenantRoot: any): {
-    envLocalPath: string;
-    devVarsPath: string;
-};
 export declare function ensureTreeseedActVerificationTooling({ tenantRoot, installIfMissing, env, write }?: {
     tenantRoot?: string | undefined;
     installIfMissing?: boolean | undefined;
@@ -221,6 +268,16 @@ export declare function ensureTreeseedActVerificationTooling({ tenantRoot, insta
         available: any;
         detail: any;
     };
+    wranglerCli: {
+        name: any;
+        available: any;
+        detail: any;
+    };
+    railwayCli: {
+        name: any;
+        available: any;
+        detail: any;
+    };
     actVerificationReady: any;
     remediation: string[];
 };
@@ -235,6 +292,7 @@ export declare function checkTreeseedProviderConnections({ tenantRoot, scope, en
         ready: any;
         detail: any;
     }[];
+    issues: any[];
 };
 export declare function formatTreeseedProviderConnectionReport(report: any): string;
 export declare function syncTreeseedGitHubEnvironment({ tenantRoot, scope, dryRun }?: {
@@ -297,33 +355,53 @@ export declare function initializeTreeseedPersistentEnvironment({ tenantRoot, sc
         siteDataDb: any;
         queue: any;
         content: any;
+        webCache: {
+            webHost: any;
+            contentHost: any;
+            rulesManaged: boolean;
+            lastSyncedAt: any;
+            lastError: any;
+            policy: {
+                sourcePages: {
+                    paths: string[];
+                    browserTtlSeconds: number;
+                    edgeTtlSeconds: number;
+                    staleWhileRevalidateSeconds: number;
+                    staleIfErrorSeconds: number;
+                };
+                contentPages: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
+                r2PublishedObjects: Required<import("../../platform/contracts.ts").TreeseedWebCachePolicyConfig>;
+            };
+            deployPurge: any;
+            contentPurge: any;
+        };
     };
     secrets: string[];
 };
-declare function createConfigAuthStatus(values: any): {
-    gh: {
-        authenticated: boolean;
+declare function createConfigReadiness(values: any, validation: any): {
+    github: {
+        configured: boolean;
     };
-    wrangler: {
-        authenticated: boolean;
+    cloudflare: {
+        configured: boolean;
     };
     railway: {
-        authenticated: boolean;
+        configured: boolean;
     };
-    copilot: {
+    localDevelopment: {
         configured: boolean;
     };
 };
+export declare function configGroupRank(group: any): number;
 export declare function listRelevantTreeseedConfigEntries(registry: any, scope: TreeseedConfigScope): any;
 export declare function collectTreeseedConfigContext({ tenantRoot, scopes, env, }: {
     tenantRoot: string;
     scopes?: TreeseedConfigScope[];
     env?: NodeJS.ProcessEnv;
 }): TreeseedCollectedConfigContext;
-export declare function applyTreeseedConfigValues({ tenantRoot, updates, writeLocalFiles, applyLocalEnvironment, }: {
+export declare function applyTreeseedConfigValues({ tenantRoot, updates, applyLocalEnvironment, }: {
     tenantRoot: string;
     updates: TreeseedConfigValueUpdate[];
-    writeLocalFiles?: boolean;
     applyLocalEnvironment?: boolean;
 }): {
     updated: {
@@ -332,18 +410,16 @@ export declare function applyTreeseedConfigValues({ tenantRoot, updates, writeLo
         reused: boolean;
         cleared: boolean;
     }[];
-    envFiles: {
-        envLocalPath: string;
-        devVarsPath: string;
-    } | null;
+    sharedStorageMigrations: TreeseedSharedStorageMigrationNotice[];
 };
-export declare function finalizeTreeseedConfig({ tenantRoot, scopes, sync, env, checkConnections, initializePersistent, }: {
+export declare function finalizeTreeseedConfig({ tenantRoot, scopes, sync, env, checkConnections, initializePersistent, onProgress, }: {
     tenantRoot: string;
     scopes?: TreeseedConfigScope[];
     sync?: 'none' | 'github' | 'cloudflare' | 'railway' | 'all';
     env?: NodeJS.ProcessEnv;
     checkConnections?: boolean;
     initializePersistent?: boolean;
+    onProgress?: (message: string) => void;
 }): {
     scopes: ("local" | "staging" | "prod")[];
     synced: Record<string, unknown>;
@@ -355,9 +431,12 @@ export declare function finalizeTreeseedConfig({ tenantRoot, scopes, sync, env,
     connectionChecks: ReturnType<typeof checkTreeseedProviderConnections>[];
     validationByScope: Record<TreeseedConfigScope, ReturnType<typeof validateTreeseedEnvironmentValues>>;
     readinessByScope: Record<TreeseedConfigScope, {
+        phase: string;
         configured: boolean;
         provisioned: boolean;
         deployable: boolean;
+        blockers: string[];
+        warnings: string[];
         checks: Record<string, unknown>;
     }>;
 };
@@ -371,4 +450,3 @@ export declare function collectTreeseedPrintEnvReport({ tenantRoot, scope, env,
     revealSecrets: boolean;
     entries: any;
 };
-export {};