@ultrst-armada/kloks 2.0.4 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. package/package.json +76 -1
  2. package/packages/backend/dist/api/index.js +2 -1
  3. package/packages/backend/dist/chunk-23LS4LWC.js +746 -0
  4. package/packages/backend/dist/chunk-3UZFKB4M.js +28 -0
  5. package/packages/backend/dist/chunk-5GW5PJWQ.js +96 -0
  6. package/packages/backend/dist/chunk-5SXOQAAX.js +41 -0
  7. package/packages/backend/dist/chunk-5UVJDX7Q.js +44 -0
  8. package/packages/backend/dist/{chunk-5F5V7NAG.js → chunk-5Y7K7HAT.js} +4 -1
  9. package/packages/backend/dist/chunk-6BL5DXFZ.js +43 -0
  10. package/packages/backend/dist/{chunk-OXEP3AP6.js → chunk-6I7I4C6H.js} +158 -1
  11. package/packages/backend/dist/{chunk-SQKG3S6P.js → chunk-AUNIGE6Q.js} +2 -2
  12. package/packages/backend/dist/{chunk-NY2SQOXI.js → chunk-CDRHYO44.js} +4 -1
  13. package/packages/backend/dist/{chunk-ZBNSK26X.js → chunk-CV55JMT7.js} +6 -5
  14. package/packages/backend/dist/{chunk-KPLDYX5Z.js → chunk-DJ457D5D.js} +33 -26
  15. package/packages/backend/dist/{chunk-FK3OAUXM.js → chunk-DTPCWHQJ.js} +4 -2
  16. package/packages/backend/dist/{chunk-OWMQLML7.js → chunk-EMSSTOOK.js} +33 -2
  17. package/packages/backend/dist/{chunk-Z6G32NQQ.js → chunk-ENMIBY2V.js} +12 -9
  18. package/packages/backend/dist/chunk-EQFZX3JT.js +63 -0
  19. package/packages/backend/dist/chunk-FKK23J2A.js +363 -0
  20. package/packages/backend/dist/chunk-GTKW4IGC.js +197 -0
  21. package/packages/backend/dist/chunk-GVMVYC6C.js +0 -0
  22. package/packages/backend/dist/chunk-HRJCGJTR.js +261 -0
  23. package/packages/backend/dist/chunk-I6T64MLT.js +171 -0
  24. package/packages/backend/dist/chunk-IKDYKRVH.js +51 -0
  25. package/packages/backend/dist/chunk-IP6XWQU2.js +48 -0
  26. package/packages/backend/dist/chunk-JGR6BJVX.js +74 -0
  27. package/packages/backend/dist/{chunk-POLVHTHJ.js → chunk-KCPQWJBO.js} +4 -1
  28. package/packages/backend/dist/chunk-LC6ULEM2.js +125 -0
  29. package/packages/backend/dist/{chunk-NTKUQVCQ.js → chunk-LMUMMVTU.js} +14 -2
  30. package/packages/backend/dist/chunk-LMY6MGFD.js +78 -0
  31. package/packages/backend/dist/chunk-NFK6YFTA.js +157 -0
  32. package/packages/backend/dist/chunk-NZWCPJDJ.js +82 -0
  33. package/packages/backend/dist/chunk-OT2PSPBK.js +74 -0
  34. package/packages/backend/dist/chunk-QYWVZBI6.js +54 -0
  35. package/packages/backend/dist/chunk-TOLAWKAY.js +1132 -0
  36. package/packages/backend/dist/{chunk-OQRQCDS6.js → chunk-TRJVVNO7.js} +2 -2
  37. package/packages/backend/dist/chunk-U7T65YUP.js +889 -0
  38. package/packages/backend/dist/chunk-YFMHT77Z.js +58 -0
  39. package/packages/backend/dist/client-JXGCPWEA.js +7 -0
  40. package/packages/backend/dist/control-plane/index.js +3 -1
  41. package/packages/backend/dist/core/b2DirectCore.test.d.ts +1 -0
  42. package/packages/backend/dist/core/cloudflareIntegrationCore.test.d.ts +1 -0
  43. package/packages/backend/dist/core/googleDriveOAuthCore.d.ts +51 -0
  44. package/packages/backend/dist/core/googleDriveOAuthCore.test.d.ts +1 -0
  45. package/packages/backend/dist/core/index.d.ts +3 -0
  46. package/packages/backend/dist/core/storageConnectionCore.d.ts +136 -0
  47. package/packages/backend/dist/core/storageConnectionCore.test.d.ts +1 -0
  48. package/packages/backend/dist/core/storageConnectionRuntimeCore.d.ts +57 -0
  49. package/packages/backend/dist/core/storageConnectionRuntimeCore.test.d.ts +1 -0
  50. package/packages/backend/dist/core/storageContracts.d.ts +77 -0
  51. package/packages/backend/dist/core/storageProviderRegistry.d.ts +7 -0
  52. package/packages/backend/dist/core/systemCredentialsCore.d.ts +46 -0
  53. package/packages/backend/dist/core/unifiedDb.d.ts +12 -2
  54. package/packages/backend/dist/core/unifiedDb.errors.test.d.ts +1 -0
  55. package/packages/backend/dist/core/unifiedDbNodeAdapter.d.ts +6 -0
  56. package/packages/backend/dist/core/workspaceBucketSyncCore.d.ts +3 -4
  57. package/packages/backend/dist/core/workspaceBucketSyncCore.test.d.ts +1 -0
  58. package/packages/backend/dist/core/workspaceCore.d.ts +25 -6
  59. package/packages/backend/dist/core/workspaceDataCore.test.d.ts +1 -0
  60. package/packages/backend/dist/core/workspaceFileCore.d.ts +25 -7
  61. package/packages/backend/dist/core/workspaceFileCore.test.d.ts +1 -0
  62. package/packages/backend/dist/core/workspaceFileNodeAdapter.d.ts +6 -0
  63. package/packages/backend/dist/core/workspaceStorageDetailsCore.d.ts +4 -8
  64. package/packages/backend/dist/core/workspaceStorageDetailsCore.test.d.ts +1 -0
  65. package/packages/backend/dist/development/index.js +1 -1
  66. package/packages/backend/dist/development/playwrightInspectionService.js +1 -1
  67. package/packages/backend/dist/development/playwrightInspectionSupport.d.ts +1 -0
  68. package/packages/backend/dist/index.d.ts +1 -0
  69. package/packages/backend/dist/index.js +130 -15
  70. package/packages/backend/dist/krnl-services.d.ts +0 -22
  71. package/packages/backend/dist/krnl-services.js +8 -19
  72. package/packages/backend/dist/krnl-services.node.d.ts +28 -0
  73. package/packages/backend/dist/node.d.ts +4 -0
  74. package/packages/backend/dist/node.js +670 -454
  75. package/packages/backend/dist/provider-services/capacity.d.ts +2 -0
  76. package/packages/backend/dist/provider-services/client.d.ts +18 -0
  77. package/packages/backend/dist/provider-services/cloudflare.d.ts +6 -0
  78. package/packages/backend/dist/provider-services/facades.d.ts +44 -0
  79. package/packages/backend/dist/provider-services/gemini.d.ts +8 -0
  80. package/packages/backend/dist/provider-services/google/cloud-run.d.ts +1 -0
  81. package/packages/backend/dist/provider-services/google/cloud-run.js +9 -0
  82. package/packages/backend/dist/provider-services/google/cloud-shell.d.ts +1 -0
  83. package/packages/backend/dist/provider-services/google/cloud-shell.js +9 -0
  84. package/packages/backend/dist/provider-services/google/cloud-storage.d.ts +1 -0
  85. package/packages/backend/dist/provider-services/google/cloud-storage.js +9 -0
  86. package/packages/backend/dist/provider-services/google/drive.d.ts +4 -0
  87. package/packages/backend/dist/provider-services/google/drive.js +20 -0
  88. package/packages/backend/dist/provider-services/google/gemini.d.ts +2 -0
  89. package/packages/backend/dist/provider-services/google/gemini.js +10 -0
  90. package/packages/backend/dist/provider-services/google/index.d.ts +3 -0
  91. package/packages/backend/dist/provider-services/google/index.js +17 -0
  92. package/packages/backend/dist/provider-services/google/vertex-ai.d.ts +1 -0
  93. package/packages/backend/dist/provider-services/google/vertex-ai.js +9 -0
  94. package/packages/backend/dist/provider-services/index.d.ts +11 -0
  95. package/packages/backend/dist/provider-services/index.js +118 -0
  96. package/packages/backend/dist/provider-services/node.d.ts +4 -0
  97. package/packages/backend/dist/provider-services/node.js +40 -0
  98. package/packages/backend/dist/provider-services/operations.d.ts +28 -0
  99. package/packages/backend/dist/provider-services/operations.test.d.ts +1 -0
  100. package/packages/backend/dist/provider-services/provider-services.test.d.ts +1 -0
  101. package/packages/backend/dist/provider-services/registry.d.ts +16 -0
  102. package/packages/backend/dist/provider-services/storage/backblaze-b2.d.ts +7 -0
  103. package/packages/backend/dist/provider-services/storage/backblaze-b2.js +8 -0
  104. package/packages/backend/dist/provider-services/storage/contract.d.ts +45 -0
  105. package/packages/backend/dist/provider-services/storage/dropbox.d.ts +3 -0
  106. package/packages/backend/dist/provider-services/storage/dropbox.js +12 -0
  107. package/packages/backend/dist/provider-services/storage/github.d.ts +4 -0
  108. package/packages/backend/dist/provider-services/storage/github.js +12 -0
  109. package/packages/backend/dist/provider-services/storage/google-drive.d.ts +4 -0
  110. package/packages/backend/dist/provider-services/storage/index.d.ts +7 -0
  111. package/packages/backend/dist/provider-services/storage/node.d.ts +2 -0
  112. package/packages/backend/dist/provider-services/storage/node.js +17 -0
  113. package/packages/backend/dist/provider-services/storage/service.d.ts +27 -0
  114. package/packages/backend/dist/provider-services/storage/storage-contract.test.d.ts +1 -0
  115. package/packages/backend/dist/provider-services/storage-facades.d.ts +55 -0
  116. package/packages/backend/dist/provider-services/storage-node.d.ts +11 -0
  117. package/packages/backend/dist/provider-services/storage-providers.d.ts +30 -0
  118. package/packages/backend/dist/provider-services/storage-providers.test.d.ts +1 -0
  119. package/packages/backend/dist/provider-services/storage.d.ts +3 -0
  120. package/packages/backend/dist/provider-services/storage.js +29 -0
  121. package/packages/backend/dist/provider-services/types.d.ts +61 -0
  122. package/packages/backend/dist/provider-services/vercel.d.ts +13 -0
  123. package/packages/backend/dist/resolver/index.js +13 -0
  124. package/packages/backend/dist/resolver/systemDatabaseUrl.d.ts +16 -12
  125. package/packages/backend/dist/services/node.js +12 -10
  126. package/packages/backend/dist/srkl/index.js +6 -4
  127. package/packages/backend/dist/storage/B2DirectClient.d.ts +7 -13
  128. package/packages/backend/dist/storage/B2DirectClient.test.d.ts +1 -0
  129. package/packages/backend/dist/storage/GoogleDriveWorkspaceService.d.ts +5 -0
  130. package/packages/backend/dist/storage/index.js +4 -3
  131. package/packages/backend/dist/storage/node.js +7 -6
  132. package/packages/backend/dist/storage-workspace.js +1 -1
  133. package/packages/backend/dist/workspace/index.js +2 -1
  134. package/packages/backend/dist/workspace/node.js +12 -7
  135. package/packages/backend/dist/workspaceFileCore-RQO7YMRD.js +28 -0
  136. package/packages/backend/package.json +78 -3
  137. package/packages/services/dist/index.js +8 -2
  138. package/packages/backend/dist/chunk-4QEMALXF.js +0 -90
  139. package/packages/backend/dist/chunk-AOZSDRNY.js +0 -159
  140. package/packages/backend/dist/chunk-GYSZ6CAX.js +0 -19
  141. package/packages/backend/dist/chunk-JCMB7BIM.js +0 -211
  142. package/packages/backend/dist/chunk-JGUWYVOL.js +0 -570
  143. package/packages/backend/dist/chunk-LMOM7CST.js +0 -427
@@ -0,0 +1,55 @@
1
+ export declare const GitHubProviderService: {
2
+ id: string;
3
+ name: string;
4
+ version: string;
5
+ runtime: "server";
6
+ deployment: "local";
7
+ definition: import("@ultrst-armada/krnl").ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
8
+ readonly telemetry: import("@ultrst-armada/krnl").TelemetryController;
9
+ createInstance: () => import("@ultrst-armada/krnl").ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
10
+ execute: <TIn = unknown, TOut = unknown>(operation: string, input: TIn) => Promise<TOut>;
11
+ };
12
+ export declare const GitLabProviderService: {
13
+ id: string;
14
+ name: string;
15
+ version: string;
16
+ runtime: "server";
17
+ deployment: "local";
18
+ definition: import("@ultrst-armada/krnl").ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
19
+ readonly telemetry: import("@ultrst-armada/krnl").TelemetryController;
20
+ createInstance: () => import("@ultrst-armada/krnl").ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
21
+ execute: <TIn = unknown, TOut = unknown>(operation: string, input: TIn) => Promise<TOut>;
22
+ };
23
+ export declare const DropboxProviderService: {
24
+ id: string;
25
+ name: string;
26
+ version: string;
27
+ runtime: "server";
28
+ deployment: "local";
29
+ definition: import("@ultrst-armada/krnl").ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
30
+ readonly telemetry: import("@ultrst-armada/krnl").TelemetryController;
31
+ createInstance: () => import("@ultrst-armada/krnl").ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
32
+ execute: <TIn = unknown, TOut = unknown>(operation: string, input: TIn) => Promise<TOut>;
33
+ };
34
+ export declare const BackblazeB2ProviderService: {
35
+ id: string;
36
+ name: string;
37
+ version: string;
38
+ runtime: "server";
39
+ deployment: "local";
40
+ definition: import("@ultrst-armada/krnl").ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
41
+ readonly telemetry: import("@ultrst-armada/krnl").TelemetryController;
42
+ createInstance: () => import("@ultrst-armada/krnl").ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
43
+ execute: <TIn = unknown, TOut = unknown>(operation: string, input: TIn) => Promise<TOut>;
44
+ };
45
+ export declare const GoogleDriveProviderService: {
46
+ id: string;
47
+ name: string;
48
+ version: string;
49
+ runtime: "server";
50
+ deployment: "local";
51
+ definition: import("@ultrst-armada/krnl").ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
52
+ readonly telemetry: import("@ultrst-armada/krnl").TelemetryController;
53
+ createInstance: () => import("@ultrst-armada/krnl").ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
54
+ execute: <TIn = unknown, TOut = unknown>(operation: string, input: TIn) => Promise<TOut>;
55
+ };
@@ -0,0 +1,11 @@
1
+ export declare const CanonicalStorageProviderService: {
2
+ id: string;
3
+ name: string;
4
+ version: string;
5
+ runtime: "server";
6
+ deployment: "local";
7
+ definition: import("@ultrst-armada/krnl").ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
8
+ readonly telemetry: import("@ultrst-armada/krnl").TelemetryController;
9
+ createInstance: () => import("@ultrst-armada/krnl").ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
10
+ execute: <TIn = unknown, TOut = unknown>(operation: string, input: TIn) => Promise<TOut>;
11
+ };
@@ -0,0 +1,30 @@
1
+ import type { ProviderConnection } from './types.js';
2
+ export { authorizeB2 as authorizeBackblazeB2, b2ListBuckets as listBackblazeB2Buckets, b2ListFileNames as listBackblazeB2Files, b2UploadFile as uploadBackblazeB2File, b2DownloadFile as downloadBackblazeB2File, } from '../storage/B2DirectClient.js';
3
+ export { GoogleDriveWorkspaceService, GOOGLE_DRIVE_WORKSPACE_SCOPE, } from '../storage/GoogleDriveWorkspaceService.js';
4
+ export declare function listGitHubRepositories(connection: ProviderConnection, transport?: typeof fetch, page?: number): Promise<Array<{
5
+ id: number;
6
+ full_name: string;
7
+ private: boolean;
8
+ }>>;
9
+ export declare function listGitHubRepositoryContents(connection: ProviderConnection, owner: string, repo: string, path?: string, transport?: typeof fetch): Promise<unknown>;
10
+ export declare function listGitLabProjects(connection: ProviderConnection, transport?: typeof fetch): Promise<Array<{
11
+ id: number;
12
+ path_with_namespace: string;
13
+ }>>;
14
+ export declare function listGitLabRepositoryTree(connection: ProviderConnection, project: number | string, path?: string, transport?: typeof fetch): Promise<Array<{
15
+ id: string;
16
+ name: string;
17
+ type: string;
18
+ }>>;
19
+ export interface DropboxFolderPage {
20
+ entries: Array<{
21
+ '.tag': string;
22
+ name: string;
23
+ path_lower?: string;
24
+ id?: string;
25
+ }>;
26
+ cursor: string;
27
+ has_more: boolean;
28
+ }
29
+ export declare function listDropboxFolder(connection: ProviderConnection, path?: string, transport?: typeof fetch): Promise<DropboxFolderPage>;
30
+ export declare function continueDropboxFolder(connection: ProviderConnection, cursor: string, transport?: typeof fetch): Promise<DropboxFolderPage>;
@@ -0,0 +1,3 @@
1
+ /** Portable normalized storage contract, without eager loading provider SDKs. */
2
+ export * from './storage/contract.js';
3
+ export * from './storage/service.js';
@@ -0,0 +1,29 @@
1
+ import {
2
+ createCanonicalStorageService,
3
+ getCanonicalStorageCapabilities,
4
+ listCanonicalStorageProviders
5
+ } from "../chunk-IKDYKRVH.js";
6
+ import "../chunk-OT2PSPBK.js";
7
+ import "../chunk-NZWCPJDJ.js";
8
+ import "../chunk-5GW5PJWQ.js";
9
+ import "../chunk-6BL5DXFZ.js";
10
+ import "../chunk-YFMHT77Z.js";
11
+ import "../chunk-FKK23J2A.js";
12
+ import "../chunk-JGR6BJVX.js";
13
+ import {
14
+ UnsupportedStorageOperation,
15
+ assertStorageOperation,
16
+ normalizeStoragePath,
17
+ readOnlyService
18
+ } from "../chunk-5UVJDX7Q.js";
19
+ import "../chunk-I6T64MLT.js";
20
+ import "../chunk-EMSSTOOK.js";
21
+ export {
22
+ UnsupportedStorageOperation,
23
+ assertStorageOperation,
24
+ createCanonicalStorageService,
25
+ getCanonicalStorageCapabilities,
26
+ listCanonicalStorageProviders,
27
+ normalizeStoragePath,
28
+ readOnlyService
29
+ };
@@ -0,0 +1,61 @@
1
+ /** Canonical provider/service identity and quota contracts. No secrets are persisted here. */
2
+ export type ProviderCategory = 'suite' | 'deployment' | 'cloud' | 'ai' | 'storage' | 'developer';
3
+ export type ProviderStatus = 'ready' | 'catalogued' | 'excluded';
4
+ export type CredentialMode = 'api-token' | 'api-key' | 'oauth2' | 'application-key';
5
+ export type RenewalPolicy = 'daily' | 'monthly' | 'ongoing' | 'unknown' | 'trial';
6
+ export interface ProviderDefinition {
7
+ /** A suite groups related service adapters and can expose its own identity API. */
8
+ kind?: 'suite' | 'service';
9
+ id: string;
10
+ name: string;
11
+ category: ProviderCategory;
12
+ status: ProviderStatus;
13
+ parentId?: string;
14
+ credentialModes: readonly CredentialMode[];
15
+ capabilities: readonly string[];
16
+ renewal: RenewalPolicy;
17
+ docsUrl: string;
18
+ /** True only when a specific Kloks API implementation exists. */
19
+ apiImplemented: boolean;
20
+ /** True only when this service can report quota measurements, not infer them. */
21
+ usageImplemented: boolean;
22
+ }
23
+ export type MetricSource = 'provider' | 'estimate' | 'unavailable';
24
+ export type QuotaWindow = 'minute' | 'day' | 'month' | 'billing' | 'rolling-30d';
25
+ export interface ProviderQuotaMetric {
26
+ id: string;
27
+ label: string;
28
+ unit: string;
29
+ used: number | null;
30
+ limit: number | null;
31
+ source: MetricSource;
32
+ window: QuotaWindow;
33
+ /** Only enforce when usage actually covers the corresponding quota window. */
34
+ enforceable: boolean;
35
+ resetAt: string | null;
36
+ }
37
+ export interface ProviderUsageSnapshot {
38
+ providerId: string;
39
+ serviceId: string;
40
+ accountId: string;
41
+ capturedAt: string;
42
+ metrics: ProviderQuotaMetric[];
43
+ error?: string;
44
+ /** A provider can have a healthy API but no accessible quota telemetry. */
45
+ coverage: 'complete' | 'partial' | 'unavailable';
46
+ }
47
+ export interface CapacityDecision {
48
+ status: 'eligible' | 'exhausted' | 'unknown';
49
+ weight: number;
50
+ percentRemaining: number | null;
51
+ bottleneck: string | null;
52
+ reason: string;
53
+ checkedAt: string;
54
+ }
55
+ export interface ProviderConnection {
56
+ providerId: string;
57
+ /** Stable vault account identifier. Never an API credential. */
58
+ accountId: string;
59
+ credential: string;
60
+ accountScope?: string;
61
+ }
@@ -0,0 +1,13 @@
1
+ import type { ProviderConnection, ProviderUsageSnapshot } from './types.js';
2
+ /**
3
+ * Collect Vercel's reported usage without synthesizing CPU, bandwidth or requests.
4
+ * A rolling 30-day window is not assumed to equal the account's billing period.
5
+ */
6
+ export declare function fetchVercelCapacity(connection: ProviderConnection, options: {
7
+ plan: 'hobby' | 'pro' | 'enterprise';
8
+ windowStart: string;
9
+ windowEnd: string;
10
+ /** Verified period boundary from provider billing. Otherwise metrics are informational. */
11
+ billingWindowVerified?: boolean;
12
+ resetAt?: string;
13
+ }, now?: Date, transport?: typeof fetch): Promise<ProviderUsageSnapshot>;
@@ -0,0 +1,13 @@
1
+ import "../chunk-GVMVYC6C.js";
2
+ import {
3
+ normalizeSystemEnvironment,
4
+ resolveSystemDatabaseUrl,
5
+ resolveSystemDatabaseUrlCandidates,
6
+ tryResolveSystemDatabaseUrl
7
+ } from "../chunk-IP6XWQU2.js";
8
+ export {
9
+ normalizeSystemEnvironment,
10
+ resolveSystemDatabaseUrl,
11
+ resolveSystemDatabaseUrlCandidates,
12
+ tryResolveSystemDatabaseUrl
13
+ };
@@ -1,18 +1,22 @@
1
1
  /**
2
2
  * @file systemDatabaseUrl.ts
3
- * @description Centralized SYSTEM_DATABASE_URL resolver adhering to SKIPO Invariant §16.
4
- * Precedence: SYSTEM_DATABASE_URL_1 (primary) > SYSTEM_DATABASE_URL_2 (fallback #1) > SYSTEM_DATABASE_URL_3 (fallback #2).
5
- * Strictly forbids fallback to generic DATABASE_URL.
6
- */
7
- /**
8
- * Resolves the active system database URL following the strict 1 -> 2 -> 3 precedence.
9
- * Throws a deterministic descriptive error if no system database URL is configured.
3
+ * @description The canonical system database URL contract for all runtime targets.
10
4
  *
11
- * @param env - Environment record (defaults to process.env in Node runtime)
12
- * @returns Validated system database connection string
5
+ * SYSTEM_DATABASE_URL is the primary and required deployment binding.
6
+ * SYSTEM_DATABASE_URL_2 and SYSTEM_DATABASE_URL_3 are ordered failover URLs.
7
+ * Generic DATABASE_URL and the retired SYSTEM_DATABASE_URL_1 alias are not accepted.
13
8
  */
14
- export declare function resolveSystemDatabaseUrl(env?: Record<string, string | undefined>): string;
9
+ export type SystemDatabaseEnvironment = Record<string, unknown>;
10
+ /** Return unique configured URLs in primary-then-fallback order. */
11
+ export declare function resolveSystemDatabaseUrlCandidates(env?: SystemDatabaseEnvironment): string[];
12
+ /** Resolve the primary system database URL, followed by the supported failover URLs. */
13
+ export declare function tryResolveSystemDatabaseUrl(env?: SystemDatabaseEnvironment): string | null;
14
+ /** Resolve the configured system database or return a deterministic configuration error. */
15
+ export declare function resolveSystemDatabaseUrl(env?: SystemDatabaseEnvironment): string;
15
16
  /**
16
- * Safe version that returns null instead of throwing if unconfigured.
17
+ * Normalize the canonical system bindings at a Fetch entrypoint boundary.
18
+ * This helper is intentionally runtime-neutral: Node callers pass their
19
+ * environment explicitly; Workers pass platform bindings. It copies only
20
+ * system-owned configuration keys and preserves application-provided bindings.
17
21
  */
18
- export declare function tryResolveSystemDatabaseUrl(env?: Record<string, string | undefined>): string | null;
22
+ export declare function normalizeSystemEnvironment<T extends Record<string, unknown>>(env?: T, runtimeEnvironment?: Record<string, unknown>, requestUrl?: string): T & Record<string, unknown>;
@@ -10,18 +10,20 @@ import {
10
10
  exportGraphAsJsonFile,
11
11
  nodeGraphPersistence,
12
12
  parseGraphJsonFile,
13
- validateGraphDocument
14
- } from "../chunk-OXEP3AP6.js";
15
- import {
13
+ validateGraphDocument,
16
14
  workspaceGraphService
17
- } from "../chunk-AOZSDRNY.js";
18
- import "../chunk-SQKG3S6P.js";
19
- import "../chunk-JGUWYVOL.js";
20
- import "../chunk-OQRQCDS6.js";
21
- import "../chunk-JCMB7BIM.js";
15
+ } from "../chunk-6I7I4C6H.js";
16
+ import "../chunk-AUNIGE6Q.js";
17
+ import "../chunk-TRJVVNO7.js";
22
18
  import "../chunk-HUY4272L.js";
23
- import "../chunk-5F5V7NAG.js";
24
- import "../chunk-OWMQLML7.js";
19
+ import "../chunk-5Y7K7HAT.js";
20
+ import "../chunk-LMY6MGFD.js";
21
+ import "../chunk-23LS4LWC.js";
22
+ import "../chunk-GTKW4IGC.js";
23
+ import "../chunk-TOLAWKAY.js";
24
+ import "../chunk-IP6XWQU2.js";
25
+ import "../chunk-I6T64MLT.js";
26
+ import "../chunk-EMSSTOOK.js";
25
27
  export {
26
28
  CompositeBackend,
27
29
  EndpointGenerator,
@@ -10,14 +10,16 @@ import {
10
10
  srklService,
11
11
  syncSrklAccounts,
12
12
  useSrklServices
13
- } from "../chunk-FK3OAUXM.js";
13
+ } from "../chunk-DTPCWHQJ.js";
14
14
  import {
15
15
  getPrimarySrklDeploymentUrl,
16
16
  getSrklAccounts,
17
17
  srklListBackblazeBuckets
18
- } from "../chunk-KPLDYX5Z.js";
19
- import "../chunk-JCMB7BIM.js";
20
- import "../chunk-4QEMALXF.js";
18
+ } from "../chunk-DJ457D5D.js";
19
+ import "../chunk-TOLAWKAY.js";
20
+ import "../chunk-IP6XWQU2.js";
21
+ import "../chunk-I6T64MLT.js";
22
+ import "../chunk-EMSSTOOK.js";
21
23
  export {
22
24
  CANONICAL_SRKL_URL,
23
25
  SrklClient,
@@ -1,16 +1,10 @@
1
1
  /**
2
- * @file B2DirectClient.ts
3
- * @description Zero-dependency Web Standard Fetch client for Backblaze B2 Direct REST API.
4
- * Identical across Node.js, Vercel Serverless, and Cloudflare Workers (< 200 lines).
2
+ * Backward-compatible storage-layer entrypoint for the canonical B2 client.
3
+ * All provider behavior lives in core/b2DirectCore so connection discovery
4
+ * and workspace file operations share the same authorization and error rules.
5
5
  */
6
- export interface B2AuthToken {
7
- authorizationToken: string;
8
- apiUrl: string;
9
- downloadUrl: string;
10
- accountId: string;
11
- }
12
- export declare function authorizeB2(keyId: string, applicationKey: string): Promise<B2AuthToken>;
13
- export declare function b2ListBuckets(keyId: string, applicationKey: string): Promise<any[]>;
14
- export declare function b2ListFileNames(keyId: string, applicationKey: string, bucketName: string, prefix?: string): Promise<any[]>;
6
+ import { authorizeB2, b2ListBuckets, b2ListFileNames, b2DownloadFile } from '../core/b2DirectCore.js';
7
+ export { authorizeB2, b2ListBuckets, b2ListFileNames, b2DownloadFile };
8
+ export type { B2AuthData as B2AuthToken } from '../core/b2DirectCore.js';
9
+ /** Preserve the legacy string-or-byte payload contract. */
15
10
  export declare function b2UploadFile(keyId: string, applicationKey: string, bucketName: string, fileName: string, content: Uint8Array | string, contentType?: string): Promise<any>;
16
- export declare function b2DownloadFile(keyId: string, applicationKey: string, bucketName: string, fileName: string): Promise<Uint8Array | null>;
@@ -66,6 +66,11 @@ export declare class GoogleDriveWorkspaceService {
66
66
  accountId: string;
67
67
  email?: string;
68
68
  }>;
69
+ /**
70
+ * Folder browsing is always rooted at the persisted workspace root. A caller
71
+ * may browse a descendant, but cannot supply an unrelated Drive folder ID.
72
+ */
73
+ assertFolderWithinRoot(folderId: string): Promise<void>;
69
74
  listFolders(parentFolderId?: string): Promise<GoogleDriveWorkspaceFolder[]>;
70
75
  resolveFolder(folderId: string): Promise<GoogleDriveWorkspaceFolder>;
71
76
  selectRootFolder(folderId: string): Promise<GoogleDriveWorkspaceFolder>;
@@ -6,14 +6,15 @@ import {
6
6
  } from "../chunk-HUY4272L.js";
7
7
  import {
8
8
  BaseStorageAdapter
9
- } from "../chunk-5F5V7NAG.js";
9
+ } from "../chunk-5Y7K7HAT.js";
10
+ import "../chunk-LMY6MGFD.js";
10
11
  import {
11
12
  authorizeB2,
12
13
  b2DownloadFile,
13
14
  b2ListBuckets,
14
15
  b2ListFileNames,
15
- b2UploadFile
16
- } from "../chunk-4QEMALXF.js";
16
+ b2UploadFile2 as b2UploadFile
17
+ } from "../chunk-I6T64MLT.js";
17
18
  export {
18
19
  BaseStorageAdapter,
19
20
  authorizeB2,
@@ -10,10 +10,10 @@ import {
10
10
  permanentDeleteS3Folder,
11
11
  permanentDeleteS3Object,
12
12
  renameS3Folder
13
- } from "../chunk-SQKG3S6P.js";
13
+ } from "../chunk-AUNIGE6Q.js";
14
14
  import {
15
15
  GoogleDriveStorageService
16
- } from "../chunk-OQRQCDS6.js";
16
+ } from "../chunk-TRJVVNO7.js";
17
17
  import {
18
18
  isSecretMasked,
19
19
  normalizeBackblazeCredentials,
@@ -21,15 +21,16 @@ import {
21
21
  } from "../chunk-HUY4272L.js";
22
22
  import {
23
23
  BaseStorageAdapter
24
- } from "../chunk-5F5V7NAG.js";
24
+ } from "../chunk-5Y7K7HAT.js";
25
+ import "../chunk-LMY6MGFD.js";
25
26
  import {
26
27
  authorizeB2,
27
28
  b2DownloadFile,
28
29
  b2ListBuckets,
29
30
  b2ListFileNames,
30
- b2UploadFile
31
- } from "../chunk-4QEMALXF.js";
32
- import "../chunk-OWMQLML7.js";
31
+ b2UploadFile2 as b2UploadFile
32
+ } from "../chunk-I6T64MLT.js";
33
+ import "../chunk-EMSSTOOK.js";
33
34
  export {
34
35
  BackblazeB2Adapter,
35
36
  BaseStorageAdapter,
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  GOOGLE_DRIVE_WORKSPACE_SCOPE,
3
3
  GoogleDriveWorkspaceService
4
- } from "./chunk-OWMQLML7.js";
4
+ } from "./chunk-EMSSTOOK.js";
5
5
  export {
6
6
  GOOGLE_DRIVE_WORKSPACE_SCOPE,
7
7
  GoogleDriveWorkspaceService
@@ -1,7 +1,8 @@
1
1
  import "../chunk-RABSY2JU.js";
2
2
  import {
3
3
  WorkspaceCloneSyncEngine
4
- } from "../chunk-NY2SQOXI.js";
4
+ } from "../chunk-CDRHYO44.js";
5
+ import "../chunk-LMY6MGFD.js";
5
6
  export {
6
7
  WorkspaceCloneSyncEngine
7
8
  };
@@ -5,19 +5,24 @@ import {
5
5
  WorkspaceFS,
6
6
  remoteWorkspaceService,
7
7
  workingWorkspaceService
8
- } from "../chunk-Z6G32NQQ.js";
8
+ } from "../chunk-ENMIBY2V.js";
9
+ import "../chunk-TRJVVNO7.js";
10
+ import "../chunk-LC6ULEM2.js";
11
+ import "../chunk-5Y7K7HAT.js";
9
12
  import {
10
13
  WorkspaceCloneSyncEngine
11
- } from "../chunk-NY2SQOXI.js";
14
+ } from "../chunk-CDRHYO44.js";
15
+ import "../chunk-LMY6MGFD.js";
12
16
  import {
13
17
  formatCanonicalWorkspaceFolderName,
14
18
  sanitizeWorkspaceName
15
19
  } from "../chunk-FZKBTF34.js";
16
- import "../chunk-JGUWYVOL.js";
17
- import "../chunk-OQRQCDS6.js";
18
- import "../chunk-JCMB7BIM.js";
19
- import "../chunk-5F5V7NAG.js";
20
- import "../chunk-OWMQLML7.js";
20
+ import "../chunk-23LS4LWC.js";
21
+ import "../chunk-GTKW4IGC.js";
22
+ import "../chunk-TOLAWKAY.js";
23
+ import "../chunk-IP6XWQU2.js";
24
+ import "../chunk-I6T64MLT.js";
25
+ import "../chunk-EMSSTOOK.js";
21
26
  export {
22
27
  RemoteWorkspaceService,
23
28
  SyncEngine,
@@ -0,0 +1,28 @@
1
+ import {
2
+ configureLocalWorkspaceFileAdapter,
3
+ deleteWorkspaceFile,
4
+ deleteWorkspaceFolder,
5
+ getWorkspaceFolderPrefix,
6
+ isB2Workspace,
7
+ isGoogleDriveWorkspace,
8
+ listWorkspaceFiles,
9
+ normalizeWorkspaceStoragePath,
10
+ readWorkspaceFile,
11
+ writeWorkspaceFile
12
+ } from "./chunk-GTKW4IGC.js";
13
+ import "./chunk-TOLAWKAY.js";
14
+ import "./chunk-IP6XWQU2.js";
15
+ import "./chunk-I6T64MLT.js";
16
+ import "./chunk-EMSSTOOK.js";
17
+ export {
18
+ configureLocalWorkspaceFileAdapter,
19
+ deleteWorkspaceFile,
20
+ deleteWorkspaceFolder,
21
+ getWorkspaceFolderPrefix,
22
+ isB2Workspace,
23
+ isGoogleDriveWorkspace,
24
+ listWorkspaceFiles,
25
+ normalizeWorkspaceStoragePath,
26
+ readWorkspaceFile,
27
+ writeWorkspaceFile
28
+ };
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@kloks/backend",
3
- "version": "1.2.0",
4
- "description": "Kloks Backend Services \u2014 Auth, Storage, Workspace, Control Plane, API, Connectivity & Execution built on KrnlTS",
3
+ "version": "1.2.1",
4
+ "description": "Kloks Backend Services — Auth, Storage, Workspace, Control Plane, API, Connectivity & Execution built on KrnlTS",
5
5
  "type": "module",
6
6
  "private": false,
7
7
  "publishConfig": {
@@ -58,6 +58,11 @@
58
58
  "types": "./dist/srkl/index.d.ts",
59
59
  "default": "./dist/srkl/index.js"
60
60
  },
61
+ "./resolver": {
62
+ "import": "./dist/resolver/index.js",
63
+ "types": "./dist/resolver/index.d.ts",
64
+ "default": "./dist/resolver/index.js"
65
+ },
61
66
  "./services": {
62
67
  "import": "./dist/services/index.js",
63
68
  "types": "./dist/services/index.d.ts",
@@ -78,6 +83,76 @@
78
83
  "types": "./dist/development/webContainerService.d.ts",
79
84
  "default": "./dist/development/webContainerService.js"
80
85
  },
86
+ "./provider-services": {
87
+ "types": "./dist/provider-services/index.d.ts",
88
+ "import": "./dist/provider-services/index.js",
89
+ "default": "./dist/provider-services/index.js"
90
+ },
91
+ "./provider-services/storage": {
92
+ "types": "./dist/provider-services/storage.d.ts",
93
+ "import": "./dist/provider-services/storage.js",
94
+ "default": "./dist/provider-services/storage.js"
95
+ },
96
+ "./provider-services/storage/node": {
97
+ "types": "./dist/provider-services/storage/node.d.ts",
98
+ "import": "./dist/provider-services/storage/node.js",
99
+ "default": "./dist/provider-services/storage/node.js"
100
+ },
101
+ "./provider-services/storage/github": {
102
+ "types": "./dist/provider-services/storage/github.d.ts",
103
+ "import": "./dist/provider-services/storage/github.js",
104
+ "default": "./dist/provider-services/storage/github.js"
105
+ },
106
+ "./provider-services/storage/backblaze-b2": {
107
+ "types": "./dist/provider-services/storage/backblaze-b2.d.ts",
108
+ "import": "./dist/provider-services/storage/backblaze-b2.js",
109
+ "default": "./dist/provider-services/storage/backblaze-b2.js"
110
+ },
111
+ "./provider-services/storage/dropbox": {
112
+ "types": "./dist/provider-services/storage/dropbox.d.ts",
113
+ "import": "./dist/provider-services/storage/dropbox.js",
114
+ "default": "./dist/provider-services/storage/dropbox.js"
115
+ },
116
+ "./provider-services/google": {
117
+ "types": "./dist/provider-services/google/index.d.ts",
118
+ "import": "./dist/provider-services/google/index.js",
119
+ "default": "./dist/provider-services/google/index.js"
120
+ },
121
+ "./provider-services/google/drive": {
122
+ "types": "./dist/provider-services/google/drive.d.ts",
123
+ "import": "./dist/provider-services/google/drive.js",
124
+ "default": "./dist/provider-services/google/drive.js"
125
+ },
126
+ "./provider-services/google/gemini": {
127
+ "types": "./dist/provider-services/google/gemini.d.ts",
128
+ "import": "./dist/provider-services/google/gemini.js",
129
+ "default": "./dist/provider-services/google/gemini.js"
130
+ },
131
+ "./provider-services/google/cloud-run": {
132
+ "types": "./dist/provider-services/google/cloud-run.d.ts",
133
+ "import": "./dist/provider-services/google/cloud-run.js",
134
+ "default": "./dist/provider-services/google/cloud-run.js"
135
+ },
136
+ "./provider-services/google/cloud-storage": {
137
+ "types": "./dist/provider-services/google/cloud-storage.d.ts",
138
+ "import": "./dist/provider-services/google/cloud-storage.js",
139
+ "default": "./dist/provider-services/google/cloud-storage.js"
140
+ },
141
+ "./provider-services/google/cloud-shell": {
142
+ "types": "./dist/provider-services/google/cloud-shell.d.ts",
143
+ "import": "./dist/provider-services/google/cloud-shell.js",
144
+ "default": "./dist/provider-services/google/cloud-shell.js"
145
+ },
146
+ "./provider-services/google/vertex-ai": {
147
+ "types": "./dist/provider-services/google/vertex-ai.d.ts",
148
+ "import": "./dist/provider-services/google/vertex-ai.js",
149
+ "default": "./dist/provider-services/google/vertex-ai.js"
150
+ },
151
+ "./provider-services/node": {
152
+ "types": "./dist/provider-services/node.d.ts",
153
+ "import": "./dist/provider-services/node.js",
154
+ "default": "./dist/provider-services/node.js"
155
+ },
81
156
  "./ai-provider": {
82
157
  "import": "./dist/ai-provider/index.js",
83
158
  "types": "./dist/ai-provider/index.d.ts",
@@ -140,7 +215,7 @@
140
215
  }
141
216
  },
142
217
  "scripts": {
143
- "build": "tsup src/index.ts src/node.ts src/storage/node.ts src/services/node.ts src/workspace/node.ts src/krnl-services.ts src/krnl-ai-services.ts src/services/index.ts src/auth/index.ts src/storage/index.ts src/storage-workspace.ts src/workspace/index.ts src/control-plane/index.ts src/api/index.ts src/connectivity/index.ts src/client/index.ts src/srkl/index.ts src/development/index.ts src/development/webContainerService.ts src/development/webContainerRuntime.ts src/development/playwrightInspectionService.ts src/development/playwrightInspectionTypes.ts src/ai-provider/index.ts src/ai-inference/index.ts src/ai-models/index.ts src/ai-routing/index.ts src/ai-keys/index.ts src/ai-tools/index.ts --format esm --clean --external @kloks/wasm-runtime --external react --external @kloks/state-graph --external @neondatabase/serverless --external @supabase/supabase-js --external @aws-sdk/client-s3 --external @aws-sdk/lib-storage --external zod --external ws --external @webcontainer/api --external playwright --external @dinilmusick/gutts && tsc --emitDeclarationOnly --declaration --project tsconfig.json && tsup src/development/client.ts --format esm --dts --out-dir dist/development --splitting false --platform browser --external @ultrst-armada/krnl",
218
+ "build": "tsup src/index.ts src/node.ts src/storage/node.ts src/services/node.ts src/workspace/node.ts src/krnl-services.ts src/krnl-ai-services.ts src/resolver/index.ts src/services/index.ts src/auth/index.ts src/storage/index.ts src/storage-workspace.ts src/workspace/index.ts src/control-plane/index.ts src/api/index.ts src/connectivity/index.ts src/client/index.ts src/srkl/index.ts src/development/index.ts src/development/webContainerService.ts src/development/webContainerRuntime.ts src/development/playwrightInspectionService.ts src/development/playwrightInspectionTypes.ts src/ai-provider/index.ts src/ai-inference/index.ts src/ai-models/index.ts src/ai-routing/index.ts src/ai-keys/index.ts src/ai-tools/index.ts src/provider-services/index.ts src/provider-services/node.ts src/provider-services/storage.ts src/provider-services/storage/node.ts src/provider-services/storage/github.ts src/provider-services/storage/backblaze-b2.ts src/provider-services/storage/dropbox.ts src/provider-services/google/index.ts src/provider-services/google/drive.ts src/provider-services/google/gemini.ts src/provider-services/google/cloud-run.ts src/provider-services/google/cloud-storage.ts src/provider-services/google/cloud-shell.ts src/provider-services/google/vertex-ai.ts --format esm --clean --external @kloks/wasm-runtime --external react --external @kloks/state-graph --external @neondatabase/serverless --external @supabase/supabase-js --external @aws-sdk/client-s3 --external @aws-sdk/lib-storage --external zod --external ws --external @webcontainer/api --external playwright --external @dinilmusick/gutts && tsc --emitDeclarationOnly --declaration --project tsconfig.json && tsup src/development/client.ts --format esm --dts --out-dir dist/development --splitting false --platform browser --external @ultrst-armada/krnl",
144
219
  "typecheck": "tsc --noEmit",
145
220
  "clean": "rm -rf dist"
146
221
  },
@@ -2947,14 +2947,20 @@ var GitHubVcsProvider = class {
2947
2947
 
2948
2948
  // src/engineering/local-execution-provider.ts
2949
2949
  import { spawn } from "child_process";
2950
+ function buildExecutionEnvironment(explicit = {}) {
2951
+ return {
2952
+ PATH: process.env.PATH || "/usr/local/bin:/usr/bin:/bin",
2953
+ ...explicit
2954
+ };
2955
+ }
2950
2956
  var LocalExecutionProvider = class {
2951
2957
  id = "local";
2952
2958
  async execute(request) {
2953
2959
  const executionId = crypto.randomUUID();
2954
2960
  return new Promise((resolve) => {
2955
- const child = spawn("sh", ["-lc", request.command], {
2961
+ const child = spawn("sh", ["-c", request.command], {
2956
2962
  cwd: request.cwd,
2957
- env: { ...process.env, ...request.environment ?? {} }
2963
+ env: buildExecutionEnvironment(request.environment)
2958
2964
  });
2959
2965
  let stdout = "";
2960
2966
  let stderr = "";