@ultrst-armada/kloks 1.1.0 → 1.2.0

package/packages/backend/dist/index.d.ts

@@ -5,7 +5,7 @@ export { B2AuthToken, BackblazeB2Adapter, LocalFSAdapter, S3Adapter, StorageAdap
 export { CloneReplicationResult, ConflictPolicy, SyncEngine, SyncState, WorkspaceCloneSyncEngine, WorkspaceConfig, WorkspaceDescriptor, WorkspaceFS, WorkspaceSecondaryClone, WorkspaceSyncSummary, formatCanonicalWorkspaceFolderName, sanitizeWorkspaceName } from './workspace/index.js';
 export { AuditEvent, AuditLogger, ClusterConfig, ControlPlaneManager, DatabaseClusterManager, HealthStatus, detectDatabaseEngine, getSystemDatabaseUrls, resolveSystemDatabaseClusterNodes } from './control-plane/index.js';
 export { ApiError, ApiResponse, BaseApiRoute, Middleware, RouteConfig, createSSEResponse, withAuth, withCors } from './api/index.js';
-import { SkipoBase } from '@ultrst-armada/kloks/functions';
+import { SkipoBase } from '@kloks/functions';
 export { A as AuthContext, B as BackendExecutor, a as BackendInstance, C as CallbackHandle, b as CapabilityContext, D as Delegation, c as DistributedLock, I as IdempotentRequest, J as Job, d as JobPriority, e as JobState, M as Message, f as MessageType, R as ResolutionStrategy, g as ResourceVersion, h as RoutingStrategy } from './types-BERZJ93O.js';
 export { BackendContract, BackendRegistry, CallbackDefinition, ConcurrencyConflictError, ConcurrencyManager, DomainContract, EventDefinition, HealthMonitor, InProcessExecutor, JobDefinition, JobHandler, JobScheduler, LoadBalancer, LockManager, OperationDefinition, RemoteExecutor, RemoteExecutorOptions, createEmptyContract } from './connectivity/index.js';
 export { B as BackendClient, a as BackendClientOptions, b as BackendResolver, c as BackendResolverOptions, C as CallbackFn, d as CallbackRegistry, D as DomainProxy, E as ErrorHandler, e as EventBus, f as EventHandler, F as FrontendSession, g as FrontendSessionOptions, G as GapHandler, H as HTTPTransport, h as HTTPTransportOptions, I as ITransport, M as MessageHandler, S as SequenceCheckResult, i as SequenceTracker, W as WebSocketTransport, j as WebSocketTransportOptions, k as createBackendClient } from './WebSocketTransport-CxUzUfwl.js';
@@ -14,7 +14,7 @@ export { BackendClientInstance, BackendProvider, BackendProviderProps, useBacken
 export { AdaptedStorageConnection, AppAccountManifest, AppServiceDeclaration, CANONICAL_SRKL_URL, EcosystemAccount, EcosystemAccountsRequest, EcosystemAccountsResponse, EcosystemServiceCategory, SrklClient, SrklClientOptions, SrklEcosystemQueryOptions, SrklEcosystemResponse, SrklServiceAccount, UseSrklServicesOptions, UseSrklServicesResult, createSrklClient, getPrimarySrklDeploymentUrl, getSrklAccounts, srklListBackblazeBuckets, useSrklServices } from './srkl/index.js';
 export { BackendCommand, DomainService, ExecutableBackendFacade, ExecutionContext, JobDependencyGraph, NormalizedResult, OperationComponent, ResultFlowBridge, ServiceDispatcher, StateUpdateEvent, WorkerExecutionBoundary, createOperationComponent } from './execution/index.js';
 export { CompositeBackend, EndpointGenerator, GeneratedEndpointSummary, LocalService, RemoteServiceProxy, createBackend, createCompositeService, createLocalService, createRemoteService } from './services/index.js';
-import { AssetDataType as AssetDataType$1, AssetChannelType as AssetChannelType$1, GraphFolderInfo as GraphFolderInfo$1, GraphAssetItem as GraphAssetItem$1, SpaceNode, NodeConnection, DawProject } from '@ultrst-armada/kloks/state-graph';
+import { AssetDataType as AssetDataType$1, AssetChannelType as AssetChannelType$1, GraphFolderInfo as GraphFolderInfo$1, GraphAssetItem as GraphAssetItem$1, SpaceNode, NodeConnection, DawProject } from '@kloks/state-graph';
 export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, ExecutionServiceDefinition, ExecutionServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade } from './krnl-services.js';
 export { EndpointDescriptor, IService, ProtocolAdapter, ServiceDefinition } from '@ultrst-armada/krnl';
 import 'react';
@@ -325,46 +325,465 @@ declare function getSrklStatus(env?: Record<string, unknown>): Promise<{
 }>;
 
 /**
- * @file workspaceCloneSyncCore.ts
- * @description Primary Storage Vault -> Secondary Storage Clones Replication Engine for Qwnsr.
- * Replicates active workspace data from Primary Vault to Redundant Clones (B2 or Local).
- * Conforms to Skipo Governance (< 200 lines).
+ * @file credentialVaultCore.ts
+ * @description Universal Workspace-Scoped Credential Vault.
+ * AES-256-GCM + PBKDF2 Web Crypto, non-sensitive manifest.json + encrypted secrets/*.bin (< 200 lines).
  */
-interface WorkspaceSecondaryClone {
+interface CredentialEntry {
     id: string;
-    label: string;
-    provider: 'backblaze_b2' | 'local_fs' | string;
-    b2BucketName?: string;
-    b2KeyId?: string;
-    b2ApplicationKey?: string;
-    b2Region?: string;
-    b2Endpoint?: string;
-    localFolderName?: string;
-    localFolderKey?: string;
+    name: string;
+    type: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata?: Record<string, unknown>;
+}
+interface CredentialManifest {
+    version: 1;
+    entries: CredentialEntry[];
+}
+declare function encryptSecretToBlob(plaintext: string | object, vaultKey: string): Promise<Uint8Array>;
+declare function decryptSecretFromBlob(blob: Uint8Array, vaultKey: string): Promise<any>;
+declare function loadCredentialManifest(workspace: any, connection: any): Promise<CredentialManifest>;
+declare function saveCredentialManifest(workspace: any, connection: any, manifest: CredentialManifest): Promise<void>;
+declare function listCredentials(workspace: any, connection: any): Promise<CredentialEntry[]>;
+declare function getCredential(workspace: any, connection: any, id: string, vaultKey: string): Promise<any>;
+declare function createCredential(workspace: any, connection: any, payload: {
+    id?: string;
+    name: string;
+    type: string;
+    secret: any;
+    metadata?: Record<string, unknown>;
+}, vaultKey: string): Promise<CredentialEntry>;
+declare function updateCredential(workspace: any, connection: any, id: string, payload: {
+    name?: string;
+    type?: string;
+    secret?: any;
+    metadata?: Record<string, unknown>;
+}, vaultKey: string): Promise<CredentialEntry>;
+declare function deleteCredential(workspace: any, connection: any, id: string): Promise<boolean>;
+declare function exportEncryptedCredentials(workspace: any, connection: any, ids: string[], exportKey: string, vaultKey: string): Promise<{
+    exportVersion: 1;
+    timestamp: string;
+    package: string;
+}>;
+declare function importEncryptedCredentials(workspace: any, connection: any, packageB64: string, exportKey: string, vaultKey: string): Promise<CredentialEntry[]>;
+
+/**
+ * @file publicRoutesStore.ts
+ * @description In-memory store and interface for DEPM public routes.
+ * Pure Web-standard, zero Node/Express dependencies (< 100 lines).
+ */
+interface PublicRouteRecord {
+    id: string;
+    path: string;
+    name?: string;
+    status: 'PUBLISHED' | 'DRAFT' | 'PAUSED';
+    public: boolean;
+    endpoint: string;
+    deployments: Array<{
+        id: string;
+        name: string;
+        url: string;
+        provider?: string;
+        weight: number;
+        healthy: boolean;
+        priority?: number;
+        region?: string;
+    }>;
+    load_balancing_config: {
+        strategy: 'MAX_WEIGHT' | 'WEIGHTED' | 'ROUND_ROBIN' | 'RANDOM' | 'FAILOVER_PRIORITY';
+        healthCheckRequired?: boolean;
+        autoRedirectDelayMs?: number;
+        preserveQueryParams?: boolean;
+        preservePathSuffix?: boolean;
+        fallbackUrl?: string;
+    };
     createdAt: string;
-    lastSyncedAt?: string;
-    filesSynced?: number;
-    status?: 'CONNECTED' | 'SYNCED' | 'ERROR';
+    updatedAt: string;
+    stats?: {
+        requests: number;
+        lastRoutedAt?: string;
+    };
 }
-declare function saveWorkspaceClonesState(userId: string, workspaceId: string, clones: WorkspaceSecondaryClone[], autoSync?: boolean): Promise<void>;
-declare function syncPrimaryToClones(workspaceId: string, targetCloneIds?: string[]): Promise<{
+declare let serverPublicRoutes: PublicRouteRecord[];
+declare function setServerPublicRoutes(routes: PublicRouteRecord[]): void;
+
+/**
+ * @file routesCore.ts
+ * @description Universal Gateway & Routing Service for DEPM.
+ * Governs public routes resolution, dynamic database hydration, and load-balancing ingress.
+ * Runs identically in Node.js, Vercel Serverless, and Cloudflare Workers (< 200 lines).
+ */
+
+declare function getPublicRoutes(): {
+    success: boolean;
+    count: number;
+    routes: PublicRouteRecord[];
+};
+declare function getPublicRouteByPath(rawPath: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    error: string;
+    status: number;
+    route?: undefined;
+} | {
+    success: boolean;
+    route: PublicRouteRecord;
+    status: number;
+    error?: undefined;
+}>;
+declare function getAllRoutes(): {
+    success: boolean;
+    count: number;
+    routes: PublicRouteRecord[];
+};
+declare function deleteRoute(id: string): {
+    success: boolean;
+    count: number;
+};
+declare function upsertRoute(rawRouteData: any): {
+    success: boolean;
+    error: string;
+    status: number;
+    route?: undefined;
+} | {
+    success: boolean;
+    route: PublicRouteRecord;
+    status: number;
+    error?: undefined;
+};
+declare function getGatewayConfig(env?: Record<string, unknown>): {
+    success: boolean;
+    domain: string;
+    gatewayDomain: string;
+    isConfigured: boolean;
+    mode: string;
+    registeredRoutesCount: number;
+    activeRoutes: {
+        id: string;
+        path: string;
+        deploymentsCount: number;
+    }[];
+};
+declare function getExecutions(appId: string): {
+    success: boolean;
+    appId: string;
+    count: number;
+    executions: any[];
+};
+declare function recordExecution(appId: string, data: any): {
+    success: boolean;
+    execution: {
+        id: string;
+        appId: string;
+        timestamp: string;
+        durationMs: any;
+        status: any;
+        details: any;
+    };
+};
+declare function matchGatewayIngress(urlPath: string, search?: string): {
+    destinationUrl: string;
+} | null;
+declare function matchGatewayIngressAsync(urlPath: string, search?: string, env?: Record<string, unknown>): Promise<{
+    destinationUrl: string;
+} | null>;
+
+/**
+ * @file dynamicRouteResolver.ts
+ * @description Resolves public ingress routes and calculates dynamic deployment weights
+ * directly from live database user profiles and account resources.
+ * Works across Node.js, Vercel Serverless, and Cloudflare Workers (< 160 lines).
+ */
+
+declare function resolveDynamicRouteFromDb(rawPath: string, env?: Record<string, unknown>): Promise<PublicRouteRecord | null>;
+
+/**
+ * @file workspaceDataCore.ts
+ * @description User-Scoped Workspace Data Persistence for DEPM.
+ * Persists apps, graphs, ecosystems to "ultrst-users".app_profiles.depm.workspace_data[workspaceId].
+ * Runs identically in Node.js, Vercel Serverless, and Cloudflare Workers (< 200 lines).
+ */
+declare function loadWorkspaceData(userId?: string, workspaceId?: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    error: string;
+    workspace: any;
+    workspaceId?: undefined;
+} | {
     success: boolean;
+    workspace: any;
     workspaceId: string;
-    syncedClones: any[];
-    totalFilesSynced: number;
-    error?: string;
+    error?: undefined;
+}>;
+declare function saveWorkspaceData(userId: string | undefined, workspaceId: string, data: any, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    error: string;
+    workspaceId?: undefined;
+    workspace?: undefined;
+    protected?: undefined;
+} | {
+    success: boolean;
+    workspaceId: string;
+    workspace: any;
+    protected: boolean;
+    error?: undefined;
+} | {
+    success: boolean;
+    workspaceId: string;
+    workspace: any;
+    error?: undefined;
+    protected?: undefined;
+}>;
+declare function renameAppInWorkspaceData(userId: string | undefined, workspaceId: string, appId: string, newName: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    error: string;
+    workspace: any;
+    workspaceId?: undefined;
+} | {
+    success: boolean;
+    workspace: any;
+    workspaceId: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    workspaceId?: undefined;
+    workspace?: undefined;
+    protected?: undefined;
+}>;
+
+/**
+ * @file workspaceStorageDetailsCore.ts
+ * @description Inspection of workspace cloud storage directly via Backblaze B2.
+ * Runs identically in Node.js, Vercel Serverless, and Cloudflare Workers (< 200 lines).
+ */
+declare function getWorkspaceStorageDetails(workspaceId: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    error: string;
+    workspaceId?: undefined;
+    storageProvider?: undefined;
+    connection?: undefined;
+    folderPrefix?: undefined;
+    localStats?: undefined;
+    bucket?: undefined;
+    files?: undefined;
+    fileCount?: undefined;
+} | {
+    success: boolean;
+    workspaceId: string;
+    storageProvider: any;
+    connection: any;
+    folderPrefix: any;
+    localStats: {
+        exists: boolean;
+        appsCount: number;
+        ecosystemsCount: number;
+    };
+    bucket: any;
+    files: any[];
+    error?: undefined;
+    fileCount?: undefined;
+} | {
+    success: boolean;
+    workspaceId: string;
+    storageProvider: string;
+    connection: {
+        id: any;
+        label: any;
+        provider: any;
+    };
+    folderPrefix: any;
+    bucket: {
+        name: any;
+        status: string;
+        id?: undefined;
+        type?: undefined;
+        endpoint?: undefined;
+        region?: undefined;
+    };
+    files: any[];
+    error?: undefined;
+    localStats?: undefined;
+    fileCount?: undefined;
+} | {
+    success: boolean;
+    workspaceId: string;
+    storageProvider: string;
+    connection: {
+        id: any;
+        label: any;
+        provider: any;
+    };
+    folderPrefix: any;
+    bucket: {
+        id: any;
+        name: any;
+        type: any;
+        endpoint: any;
+        region: any;
+        status: string;
+    };
+    fileCount: number;
+    files: {
+        fileName: any;
+        sizeBytes: any;
+        uploadTimestamp: any;
+    }[];
+    error?: undefined;
+    localStats?: undefined;
+} | {
+    success: boolean;
+    workspaceId: string;
+    storageProvider: string;
+    error: any;
+    folderPrefix: any;
+    connection?: undefined;
+    localStats?: undefined;
+    bucket?: undefined;
+    files?: undefined;
+    fileCount?: undefined;
+}>;
+
+/**
+ * @file workspaceCore.ts
+ * @description Universal Workspace Core Service for DEPM.
+ * Governs workspaces CRUD and Workspace Cloud Storage (Backblaze B2 via SRKL).
+ * Runs identically in Node.js, Vercel Serverless, and Cloudflare Workers (< 200 lines).
+ */
+
+declare function findUserWorkspace(workspaceId: string, env?: Record<string, unknown>): Promise<{
+    user: any;
+    workspace: any;
+    connection: any;
+}>;
+declare function getWorkspaces(userId?: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    workspaces: any;
+    activeWorkspaceId: any;
+    storage_connections: any;
 }>;
-declare function addWorkspaceSecondaryClone(workspaceId: string, clone: Omit<WorkspaceSecondaryClone, 'id' | 'createdAt'>): Promise<{
+declare function createWorkspace(userId: string, wsData: any, env?: Record<string, unknown>): Promise<{
     success: boolean;
-    clone: WorkspaceSecondaryClone;
-    clones: WorkspaceSecondaryClone[];
+    workspace: any;
+    workspaces: any;
+}>;
+declare function updateWorkspace(userId: string, params: any, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    workspace: any;
+    workspaces: any;
+}>;
+declare function deleteWorkspace(userId: string, wsId: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    workspaces: any;
+}>;
+
+/**
+ * @file workspaceFileCore.ts
+ * @description Universal Workspace File IO Abstraction.
+ * Routes reads, writes, and deletions to Local Disk or Backblaze B2 Object Storage (< 200 lines).
+ */
+declare function getWorkspaceFolderPrefix(workspace: any): string;
+declare function isB2Workspace(workspace: any, connection: any): boolean;
+declare function writeWorkspaceFile(workspace: any, connection: any, relativePath: string, content: string | Uint8Array, contentType?: string): Promise<void>;
+declare function readWorkspaceFile(workspace: any, connection: any, relativePath: string): Promise<Uint8Array | null>;
+declare function deleteWorkspaceFile(workspace: any, connection: any, relativePath: string): Promise<boolean>;
+declare function listWorkspaceFiles(workspace: any, connection: any, subPrefix?: string): Promise<Array<{
+    fileName: string;
+    sizeBytes: number;
+    uploadTimestamp?: number;
+}>>;
+declare function deleteWorkspaceFolder(workspace: any, connection: any): Promise<void>;
+
+/**
+ * @file workspaceBucketSyncCore.ts
+ * @description Workspace Backblaze B2 Direct Storage Synchronization.
+ * Directly handles folder creation, file uploads (workspace.json, ecosystem.json), and cleanup.
+ * Conforms to Law L2, L3, L9 (< 200 lines).
+ */
+declare function resolveWorkspaceConnection(profiles: any, workspace: any): any;
+declare function syncWorkspaceCreateToBucket(workspace: any, connection: any, env?: Record<string, unknown>): Promise<void>;
+declare function syncWorkspaceDeleteToBucket(workspace: any, connection: any, env?: Record<string, unknown>): Promise<void>;
+declare function syncWorkspaceDataToBucket(workspace: any, connection: any, data: any, env?: Record<string, unknown>): Promise<void>;
+
+/**
+ * @file cloudflareIntegrationCore.ts
+ * @description Cloudflare Integration Service for DEPM Engine.
+ * Fetches Workers and Pages projects referencing Srkl-Engine surveillance (< 200 lines).
+ */
+declare function fetchCloudflareData(payload: Record<string, any>, rawUserId?: string, env?: Record<string, unknown>): Promise<{
+    success: boolean;
+    provider?: string;
+    tier?: string;
+    isFree?: boolean;
+    projectsCount?: number;
+    accountName?: string;
+    accountId?: string;
+    projects?: any[];
+    projectObservability?: any[];
+    workers?: any[];
+    pages?: any[];
+    usageMetrics?: any;
+    unifiedMetrics?: any;
+    error?: string;
 }>;
-declare function removeWorkspaceSecondaryClone(workspaceId: string, cloneId: string): Promise<{
+
+/**
+ * @file vercelIntegrationCore.ts
+ * @description Authentic Vercel API Integration for DEPM Engine.
+ * Fetches user profile, projects, deployments, and usage telemetry (< 200 lines).
+ */
+declare function fetchVercelData(payload: Record<string, any>, rawUserId?: string, env?: Record<string, unknown>): Promise<{
     success: boolean;
-    deletedId: string;
-    clones: WorkspaceSecondaryClone[];
+    error?: string;
+    tier?: string;
+    isHobby?: boolean;
+    projectsCount?: number;
+    projects?: any[];
+    projectObservability?: any[];
+    usageMetrics?: any;
+    user?: any;
+    rawUsagePayload?: any;
 }>;
 
+/**
+ * @file vercelTransformer.ts
+ * @description Transforms raw Vercel REST API responses into normalized observability entities (< 200 lines).
+ */
+declare function formatRelativeCreated(timestamp: number | string, creator: string): string;
+declare function buildProjectObservability(projects: any[], deployments: any[], user: any): {
+    projectId: any;
+    projectName: any;
+    framework: any;
+    status: "ACTIVE" | "ERROR" | "PAUSED" | "BUILDING";
+    displayStatus: string;
+    isPaused: boolean;
+    deploymentUrl: string;
+    domains: string[];
+    createdAt: string;
+    createdRelative: string;
+    createdBy: any;
+    edgeRequests: number;
+    edgeRequestsFormatted: string;
+    fastDataTransferGb: number;
+    fastDataTransferFormatted: string;
+    middlewareInvocations: number;
+    middlewareInvocationsFormatted: string;
+    latestDeploymentUrl: string;
+    latestDeploymentStatus: string;
+    latestDeploymentCreatedAt: string;
+    gitRepo: string;
+    gitBranch: any;
+}[];
+declare function buildProjectsList(observability: any[]): {
+    id: any;
+    name: any;
+    status: any;
+    framework: any;
+    url: any;
+    domain: any;
+    domains: any;
+    updatedAt: any;
+}[];
+
 declare function createWavBuffer(sampleRate: number, numChannels: number, samples: Float32Array[]): Buffer;
 
 declare function ensureGlobalSamples(globalSamplesDir: string): Promise<void>;
@@ -689,4 +1108,376 @@ declare function getWorkspaceGraph(workspaceIdOrSlug: string, graphIdOrName: str
 declare function saveWorkspaceGraph(workspaceIdOrSlug: string, graphIdOrName: string, payload: Record<string, any>): Promise<DawProject>;
 declare function deleteWorkspaceGraph(workspaceIdOrSlug: string, graphIdOrName: string): Promise<boolean>;
 
-export { type AssetChannelType, type AssetDataType, type AssetFolderInfo, type AssetPoolItem, type AssetPoolScope, type B2AuthData, type BackendFacade, BaseDataProvider, type Deployment, type FunctionSet, FunctionalityTable, GRAPHS_ROOT, type IDataProvider, LEGACY_PROJECTS_ROOT, type OrchestrationFn, PROJECTS_ROOT, type ProjectMetadata, type QueryFilter, type Runtime, SAMPLES_GLOBAL_ROOT, SUPPORTED_AUDIO_EXTS, SUPPORTED_MIDI_EXTS, type ServerAudioSampleItem, type ServiceFacade, type ServiceRegistryRecord, type SortOrder, type SrklB2Account, SrklStorageService, type SyncFileResult, type UnifiedQueryResult, WORKSPACE_ASSETS_ROOT, WORKSPACE_ROOT, type WorkingWorkspaceConfig, type WorkspaceFolderResolution, type WorkspaceStorageConfig, addWorkspaceSecondaryClone, b2DeleteFileVersion, b2DeleteFolder, cleanDbUrl, configureStarterProjectTemplate, createAssetSubfolder, createGraphAssetFolder, createGraphAssetFolder as createGraphAssetSubfolder, createGraphPackage, createWavBuffer, createWorkspaceGraph, deleteAssetFromGraph, deleteAssetFromPool, deleteGlobalSample, deleteGraphPackage, deleteProject, deleteProjectSample, deleteWorkspaceGraph, ensureAssetPoolDirectories, ensureGlobalSamples, ensureGraphAssetDirectories, ensureProjectAssets, ensureProjectsRoot, ensureWorkspaceStructure, findWorkspaceRecord, getAssetPoolLocationPath, getAssetPoolPublicUrl, getB2BucketId, getDefaultWorkingWorkspaceDir, getGraphPackageById, getPrimarySrklDeploymentUrl as getPrimarySrklCoreDeploymentUrl, getProjectById, getSrklAccounts as getSrklCoreAccounts, getSrklStatus, getUnifiedDbUrl, getUsers, getWorkingWorkspaceConfig, getWorkingWorkspaceDir, getWorkspaceFolderKey, getWorkspaceGraph, importGraphDependency, initGlobalSamplesDirectory, listAllGraphPackages, listAllProjects, listBackblazeBuckets, listGlobalSamples, listProjectSamples, listWorkspaceGraphs, loginUser, queryUnifiedDb, removeGraphDependency, removeWorkspaceSecondaryClone, resolveWorkspaceDir, saveAssetToGraph, saveAssetToPool, saveGlobalSample, saveGraphPackage, saveProject, saveProjectSample, saveWorkspaceClonesState, saveWorkspaceGraph, scanAssetPool, scanGraphAssets, seedDefaultAssets, seedStarterGraphAssets, setWorkingWorkspaceConfig, srklListBackblazeBuckets as srklCoreListBackblazeBuckets, syncPrimaryToClones, syncWorkspace, validateServiceDefinition };
+type ProviderType = 'VERCEL' | 'CLOUDFLARE' | 'AWS' | 'GCP' | 'FASTLY' | 'BACKBLAZE_B2' | 'CLOUDFLARE_R2' | 'SUPABASE' | 'NEON' | 'POSTGRESQL';
+type HealthState = 'HEALTHY' | 'DEGRADED' | 'UNHEALTHY';
+type AccountTier = 'hobby' | 'pro' | 'enterprise' | 'free' | 'payg' | 'custom';
+
+interface UnifiedResourceMetricItem<T = number> {
+    used: T;
+    limit: T;
+    usedFormatted: string;
+    limitFormatted: string;
+    percent: number;
+    remainingFormatted: string;
+}
+interface UnifiedResourceMetrics {
+    provider: ProviderType;
+    periodLabel: string;
+    tier: string;
+    isFreeTier: boolean;
+    activeCpu: {
+        usedSeconds: number;
+        limitSeconds: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        percent: number;
+        remainingFormatted: string;
+    };
+    invocations: {
+        usedCount: number;
+        limitCount: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        percent: number;
+        remainingFormatted: string;
+    };
+    edgeRequests: {
+        usedCount: number;
+        limitCount: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        percent: number;
+        remainingFormatted: string;
+    };
+    bandwidth: {
+        usedMb: number;
+        limitMb: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        percent: number;
+        remainingFormatted: string;
+    };
+    memory?: {
+        usedGbHours: number;
+        limitGbHours: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        percent: number;
+        remainingFormatted: string;
+    };
+    storage?: {
+        usedMb: number;
+        limitMb: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        percent: number;
+        remainingFormatted?: string;
+    };
+    details?: Record<string, any>;
+}
+interface CloudflareProjectItem {
+    id: string;
+    name: string;
+    type: 'worker' | 'pages';
+    status: 'ACTIVE' | 'PAUSED';
+    subdomain?: string;
+    routes?: string[];
+    updatedAt?: string;
+}
+interface CloudflareObservability {
+    projectId: string;
+    projectName: string;
+    status: 'ACTIVE' | 'PAUSED';
+    cpuTimeMs: number;
+    cpuTimeFormatted: string;
+    requestsCount: number;
+    requestsFormatted: string;
+    subrequestsCount: number;
+    bandwidthMb: number;
+    errorsCount: number;
+    updatedAt: string;
+}
+interface CloudflareUsageMetrics extends UnifiedResourceMetrics {
+    provider: 'CLOUDFLARE';
+    workersCount: number;
+    pagesCount: number;
+    subrequests: {
+        usedCount: number;
+        usedFormatted: string;
+    };
+    errors: {
+        usedCount: number;
+        usedFormatted: string;
+    };
+}
+
+interface VercelUsageMetrics {
+    periodLabel: string;
+    fluidActiveCpu: {
+        usedSeconds: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitSeconds: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    functionInvocations: {
+        usedCount: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitCount: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    edgeRequests: {
+        usedCount: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitCount: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    fluidProvisionedMemory: {
+        usedGbHours: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitGbHours: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    functionsStorage: {
+        usedMb: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitMb: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    fastDataTransfer: {
+        usedGb: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitGb: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    middlewareInvocations: {
+        usedCount: number;
+        usedFormatted: string;
+        limitFormatted?: string;
+        limitCount?: number;
+        percent?: number;
+    };
+    fastOriginTransfer?: {
+        usedMb: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitMb: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    edgeRequestCpuDuration?: {
+        usedSeconds: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitSeconds: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+    isrReads?: {
+        usedCount: number;
+        usedFormatted: string;
+        limitFormatted: string;
+        limitCount: number;
+        percent: number;
+        remainingFormatted: string;
+    };
+}
+interface VercelProjectObservability {
+    projectId: string;
+    projectName: string;
+    framework?: string;
+    status: 'ACTIVE' | 'PAUSED' | 'BUILDING' | 'ERROR';
+    displayStatus?: string;
+    isPaused: boolean;
+    edgeRequests: number;
+    edgeRequestsFormatted: string;
+    fastDataTransferGb: number;
+    fastDataTransferFormatted: string;
+    middlewareInvocations: number;
+    middlewareInvocationsFormatted: string;
+    deploymentUrl?: string;
+    domains: string[];
+    createdAt?: string;
+    createdRelative?: string;
+    createdBy?: string;
+    sourceRepo?: string;
+    sourceBranch?: string;
+    commitSha?: string;
+    commitMessage?: string;
+    latestDeploymentUrl?: string;
+    latestDeploymentStatus?: string;
+    latestDeploymentCreatedAt?: string;
+    gitRepo?: string;
+    gitBranch?: string;
+}
+
+interface AccountEntity {
+    id: string;
+    provider: ProviderType;
+    name: string;
+    emailOrSlug: string;
+    tier?: AccountTier;
+    status: 'CONNECTED' | 'EXPIRING' | 'ERROR';
+    credentialType: 'API_TOKEN' | 'OAUTH' | 'SERVICE_KEY';
+    deploymentCount: number;
+    aggregateUsage: number;
+    aggregateSpend: number;
+    aggregateQuota: number;
+    resetTime: string;
+    createdAt: string;
+    weightPreference?: number;
+    usageMetrics?: VercelUsageMetrics;
+    projectObservability?: VercelProjectObservability[];
+    projectsList?: Array<{
+        id: string;
+        name: string;
+        status: 'ACTIVE' | 'PAUSED';
+        framework?: string;
+        url?: string;
+        updatedAt?: string;
+    }>;
+    metadata?: Record<string, any>;
+    sharedVariables?: Record<string, string>;
+}
+interface DeploymentEntity {
+    id: string;
+    name: string;
+    provider: ProviderType;
+    accountId: string;
+    providerDeploymentId: string;
+    publicOrigin: string;
+    bubbleTargetType?: 'DOMAIN' | 'DEPLOYMENT';
+    domainUrl?: string;
+    deploymentUrl?: string;
+    status: 'READY' | 'BUILDING' | 'ERROR' | 'OFFLINE';
+    health: HealthState;
+    usage: number;
+    spend: number;
+    quota: number;
+    quotaRemaining: number;
+    resetTime: string;
+    requestRate: number;
+    resourceRate: number;
+    createdAt: string;
+}
+
+declare abstract class BaseResourceFetcher {
+    abstract readonly provider: ProviderType;
+    abstract readonly defaultTier: string;
+    /**
+     * Constructs HTTP authorization headers from stored account credentials.
+     */
+    protected abstract getAuthHeaders(creds: Record<string, any>): Record<string, string>;
+    /**
+     * Queries the provider's live metrics endpoint(s).
+     */
+    protected abstract fetchRawUsage(creds: Record<string, any>, options?: any): Promise<any>;
+    /**
+     * Transforms provider-specific raw payload into the normalized UnifiedResourceMetrics structure.
+     */
+    abstract transformMetrics(raw: any, tier?: string, projectsCount?: number): UnifiedResourceMetrics;
+    /**
+     * Template method: Resolves credentials, queries the provider's APIs, and normalizes metrics.
+     */
+    fetchMetrics(account: AccountEntity): Promise<UnifiedResourceMetrics>;
+    /**
+     * Shared weighted resource score calculation (0.0 to 1.0).
+     * - Active CPU receives the highest weight (50% / 0.50).
+     * - Invocations: 15% (0.15).
+     * - Compute Memory / Subrequests: 15% (0.15).
+     * - Edge Requests: 10% (0.10).
+     * - Bandwidth / Data Transfer: 5% (0.05).
+     * - Other compute / network metrics: 5% (0.05).
+     * - Storage parameters (Functions Storage, Deployment Storage, R2) are strictly EXCLUDED (0%).
+     */
+    computeWeightScore(metrics?: UnifiedResourceMetrics | Record<string, any>, deployment?: DeploymentEntity, account?: AccountEntity): number;
+}
+
+declare class VercelResourceFetcher extends BaseResourceFetcher {
+    readonly provider: ProviderType;
+    readonly defaultTier = "hobby";
+    protected getAuthHeaders(creds: Record<string, any>): Record<string, string>;
+    protected fetchRawUsage(creds: Record<string, any>, options?: any): Promise<any>;
+    transformMetrics(raw: any, tier?: string, projectsCount?: number): UnifiedResourceMetrics;
+}
+
+declare class CloudflareResourceFetcher extends BaseResourceFetcher {
+    readonly provider: ProviderType;
+    readonly defaultTier = "free";
+    protected getAuthHeaders(creds: Record<string, any>): Record<string, string>;
+    protected fetchRawUsage(creds: Record<string, any>, options?: any): Promise<any>;
+    transformMetrics(raw: any, tier?: string, projectsCount?: number): UnifiedResourceMetrics;
+}
+
+type ResourceCategory = 'compute' | 'memory' | 'execution' | 'requests' | 'network' | 'storage';
+interface GeneralizedResourceMetric {
+    id: string;
+    name: string;
+    category: ResourceCategory;
+    used: number;
+    limit: number;
+    unit: string;
+    usedFormatted: string;
+    limitFormatted: string;
+    remainingFormatted: string;
+    percentUsed: number;
+    percentRemaining: number;
+    isMonthlyDepletable: boolean;
+    importanceWeight: number;
+}
+interface GeneralizedResourceVector {
+    provider: ProviderType | string;
+    tier: string;
+    periodLabel: string;
+    metrics: GeneralizedResourceMetric[];
+    metadata?: Record<string, any>;
+}
+interface ResourceCalculationResult {
+    effectiveWeight: number;
+    percentRemaining: number;
+    dominantBottleneck: GeneralizedResourceMetric;
+    metrics: GeneralizedResourceMetric[];
+    summaryLabel: string;
+}
+interface IResourceProviderAdapter {
+    readonly provider: ProviderType;
+    readonly defaultTier: string;
+    fetchUsage(creds: Record<string, any>, options?: any): Promise<any>;
+    transformToGeneralizedVector(raw: any, tier?: string, projectsCount?: number, existingMetrics?: any): GeneralizedResourceVector;
+}
+
+declare class ResourceFetcherRegistry {
+    private static fetchers;
+    private static adapters;
+    private static defaultFetcher;
+    private static defaultAdapter;
+    static register(fetcher: BaseResourceFetcher): void;
+    static getFetcher(provider?: ProviderType | string): BaseResourceFetcher;
+    static getAdapter(provider?: ProviderType | string): IResourceProviderAdapter;
+    static getSupportedProviders(): string[];
+    /**
+     * Dynamically fetches live metrics for an account using its matching provider fetcher.
+     */
+    static fetchAccountMetrics(account: AccountEntity): Promise<UnifiedResourceMetrics>;
+    /**
+     * Computes the normalized resource weight score (0.00 to 1.00) using the decoupled Universal Calculator.
+     */
+    static computeScore(account?: AccountEntity, deployment?: DeploymentEntity): number;
+    /**
+     * Full calculation returning effective weight, percent remaining, and dominant bottleneck.
+     */
+    static calculateDetailedScore(account?: AccountEntity, deployment?: DeploymentEntity): ResourceCalculationResult;
+}
+
+export { type AssetChannelType, type AssetDataType, type AssetFolderInfo, type AssetPoolItem, type AssetPoolScope, type B2AuthData, type BackendFacade, BaseDataProvider, BaseResourceFetcher, type CloudflareObservability, type CloudflareProjectItem, CloudflareResourceFetcher, type CloudflareUsageMetrics, type CredentialEntry, type CredentialManifest, type Deployment, type FunctionSet, FunctionalityTable, GRAPHS_ROOT, type IDataProvider, LEGACY_PROJECTS_ROOT, type OrchestrationFn, PROJECTS_ROOT, type ProjectMetadata, type PublicRouteRecord, type QueryFilter, ResourceFetcherRegistry, type Runtime, SAMPLES_GLOBAL_ROOT, SUPPORTED_AUDIO_EXTS, SUPPORTED_MIDI_EXTS, type ServerAudioSampleItem, type ServiceFacade, type ServiceRegistryRecord, type SortOrder, type SrklB2Account, SrklStorageService, type SyncFileResult, type UnifiedQueryResult, type UnifiedResourceMetricItem, type UnifiedResourceMetrics, VercelResourceFetcher, WORKSPACE_ASSETS_ROOT, WORKSPACE_ROOT, type WorkingWorkspaceConfig, type WorkspaceFolderResolution, type WorkspaceStorageConfig, b2DeleteFileVersion, b2DeleteFolder, buildProjectObservability, buildProjectsList, cleanDbUrl, configureStarterProjectTemplate, createAssetSubfolder, createCredential, createGraphAssetFolder, createGraphAssetFolder as createGraphAssetSubfolder, createGraphPackage, createWavBuffer, createWorkspace, createWorkspaceGraph, decryptSecretFromBlob, deleteAssetFromGraph, deleteAssetFromPool, deleteCredential, deleteGlobalSample, deleteGraphPackage, deleteProject, deleteProjectSample, deleteRoute, deleteWorkspace, deleteWorkspaceFile, deleteWorkspaceFolder, deleteWorkspaceGraph, encryptSecretToBlob, ensureAssetPoolDirectories, ensureGlobalSamples, ensureGraphAssetDirectories, ensureProjectAssets, ensureProjectsRoot, ensureWorkspaceStructure, exportEncryptedCredentials, fetchCloudflareData, fetchVercelData, findUserWorkspace, findWorkspaceRecord, formatRelativeCreated, getAllRoutes, getAssetPoolLocationPath, getAssetPoolPublicUrl, getB2BucketId, getCredential, getDefaultWorkingWorkspaceDir, getExecutions, getGatewayConfig, getGraphPackageById, getPrimarySrklDeploymentUrl as getPrimarySrklCoreDeploymentUrl, getProjectById, getPublicRouteByPath, getPublicRoutes, getSrklAccounts as getSrklCoreAccounts, getSrklStatus, getUnifiedDbUrl, getUsers, getWorkingWorkspaceConfig, getWorkingWorkspaceDir, getWorkspaceFolderKey, getWorkspaceFolderPrefix, getWorkspaceGraph, getWorkspaceStorageDetails, getWorkspaces, importEncryptedCredentials, importGraphDependency, initGlobalSamplesDirectory, isB2Workspace, listAllGraphPackages, listAllProjects, listBackblazeBuckets, listCredentials, listGlobalSamples, listProjectSamples, listWorkspaceFiles, listWorkspaceGraphs, loadCredentialManifest, loadWorkspaceData, loginUser, matchGatewayIngress, matchGatewayIngressAsync, queryUnifiedDb, readWorkspaceFile, recordExecution, removeGraphDependency, renameAppInWorkspaceData, resolveDynamicRouteFromDb, resolveWorkspaceConnection, resolveWorkspaceDir, saveAssetToGraph, saveAssetToPool, saveCredentialManifest, saveGlobalSample, saveGraphPackage, saveProject, saveProjectSample, saveWorkspaceData, saveWorkspaceGraph, scanAssetPool, scanGraphAssets, seedDefaultAssets, seedStarterGraphAssets, serverPublicRoutes, setServerPublicRoutes, setWorkingWorkspaceConfig, srklListBackblazeBuckets as srklCoreListBackblazeBuckets, syncWorkspace, syncWorkspaceCreateToBucket, syncWorkspaceDataToBucket, syncWorkspaceDeleteToBucket, updateCredential, updateWorkspace, upsertRoute, validateServiceDefinition, writeWorkspaceFile };