@ultrst-armada/kloks 1.4.7 → 1.4.8

package/.krusbl-release-attestation.json

@@ -1,8 +1,8 @@
 {
   "schema": 1,
   "packageName": "@ultrst-armada/kloks",
-  "version": "1.4.7",
-  "sourceCommit": "d3bee7220338a9aec6b9787a5308b8dbb2766693",
+  "version": "1.4.8",
+  "sourceCommit": "6ab0d5dfede2344d9dd35ce366b67ac44b808401",
   "releaseWorkflow": "npm Release",
-  "workflowRunId": "39538959938"
+  "workflowRunId": "39557640590"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultrst-armada/kloks",
-  "version": "1.4.7",
+  "version": "1.4.8",
   "private": false,
   "publishConfig": {
     "access": "public",

package/packages/backend/dist/{chunk-ZO3PZGNQ.js → chunk-E72GXBXF.js}

@@ -1,14 +1,3 @@
-// src/workspace/WorkspaceCanonical.ts
-function formatCanonicalWorkspaceFolderName(appName, userName, workspaceName) {
-  const safeApp = appName.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
-  const safeUser = userName.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
-  const safeWs = workspaceName.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
-  return `ultrst_${safeApp}_${safeUser}_${safeWs}`;
-}
-function sanitizeWorkspaceName(name) {
-  return name.replace(/[^a-zA-Z0-9-_\s]/g, "").trim();
-}
-
 // src/core/unifiedDb.ts
 var neon;
 function cleanDbUrl(url) {
@@ -729,8 +718,6 @@ async function getWorkspaceStorageDetails(workspaceId, env) {
 }
 
 export {
-  formatCanonicalWorkspaceFolderName,
-  sanitizeWorkspaceName,
   cleanDbUrl,
   getUnifiedDbUrl,
   queryUnifiedDb,

package/packages/backend/dist/chunk-FZKBTF34.js

@@ -0,0 +1,15 @@
+// src/workspace/WorkspaceCanonical.ts
+function formatCanonicalWorkspaceFolderName(appName, userName, workspaceName) {
+  const safeApp = appName.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
+  const safeUser = userName.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
+  const safeWs = workspaceName.replace(/[^a-zA-Z0-9]/g, "_").toLowerCase();
+  return `ultrst_${safeApp}_${safeUser}_${safeWs}`;
+}
+function sanitizeWorkspaceName(name) {
+  return name.replace(/[^a-zA-Z0-9-_\s]/g, "").trim();
+}
+
+export {
+  formatCanonicalWorkspaceFolderName,
+  sanitizeWorkspaceName
+};

package/packages/backend/dist/{chunk-DULUHQ5S.js → chunk-GPXV4GBD.js}

@@ -12,7 +12,7 @@ import {
   readWorkspaceFile,
   updateWorkspace,
   writeWorkspaceFile
-} from "./chunk-ZO3PZGNQ.js";
+} from "./chunk-E72GXBXF.js";
 
 // src/workspace/WorkspaceFS.ts
 import { SkipoBase } from "@ultrst-armada/kloks/functions";

package/packages/backend/dist/{chunk-ZRYACED2.js → chunk-KYBO7FGP.js}

@@ -2,22 +2,13 @@ import {
   getSrklAccounts,
   srklListBackblazeBuckets
 } from "./chunk-VDROUXFT.js";
-import {
-  StorageAdapterFactory
-} from "./chunk-J2J24JVC.js";
 import {
   b2ListBuckets
 } from "./chunk-4QEMALXF.js";
 import {
-  createWorkspace,
-  deleteWorkspace,
-  findUserWorkspace,
   formatCanonicalWorkspaceFolderName,
-  getWorkspaces,
-  queryUnifiedDb,
-  sanitizeWorkspaceName,
-  updateWorkspace
-} from "./chunk-ZO3PZGNQ.js";
+  sanitizeWorkspaceName
+} from "./chunk-FZKBTF34.js";
 import {
   RateLimiter,
   SessionManager,
@@ -26,8 +17,20 @@ import {
 } from "./chunk-ZDH4XI7W.js";
 import {
   createService,
-  createServiceDefinition
-} from "./chunk-TY32TUNI.js";
+  createServiceDefinition,
+  workspaceGraphService
+} from "./chunk-ZFCEXTNI.js";
+import {
+  StorageAdapterFactory
+} from "./chunk-J2J24JVC.js";
+import {
+  createWorkspace,
+  deleteWorkspace,
+  findUserWorkspace,
+  getWorkspaces,
+  queryUnifiedDb,
+  updateWorkspace
+} from "./chunk-E72GXBXF.js";
 
 // src/krnl-services.ts
 var AuthServiceDefinition = createServiceDefinition({
@@ -332,6 +335,64 @@ var SrklServiceFacade = {
 };
 var krnlSrklServiceDefinition = SrklServiceDefinition;
 var krnlSrklServiceFacade = SrklServiceFacade;
+var WorkspaceGraphServiceDefinition = createServiceDefinition({
+  id: "kloks.backend.workspaceGraph",
+  name: "WorkspaceGraphService",
+  version: "1.0.0",
+  operations: {
+    listGraphs: {
+      id: "WorkspaceGraphService.listGraphs",
+      name: "listGraphs",
+      handler: async (input) => workspaceGraphService.listGraphs(input.userId, input.workspaceId)
+    },
+    createGraph: {
+      id: "WorkspaceGraphService.createGraph",
+      name: "createGraph",
+      handler: async (input) => workspaceGraphService.createGraph(input.userId, input.workspaceId, { name: input.name })
+    },
+    getGraph: {
+      id: "WorkspaceGraphService.getGraph",
+      name: "getGraph",
+      handler: async (input) => workspaceGraphService.getGraph(input.userId, input.workspaceId, input.slug)
+    },
+    saveGraph: {
+      id: "WorkspaceGraphService.saveGraph",
+      name: "saveGraph",
+      handler: async (input) => workspaceGraphService.saveGraph(input.userId, input.workspaceId, input.slug, input)
+    },
+    deleteGraph: {
+      id: "WorkspaceGraphService.deleteGraph",
+      name: "deleteGraph",
+      handler: async (input) => workspaceGraphService.deleteGraph(input.userId, input.workspaceId, input.slug)
+    },
+    duplicateGraph: {
+      id: "WorkspaceGraphService.duplicateGraph",
+      name: "duplicateGraph",
+      handler: async (input) => workspaceGraphService.duplicateGraph(input.userId, input.workspaceId, input.slug, input.newName)
+    },
+    clearGraph: {
+      id: "WorkspaceGraphService.clearGraph",
+      name: "clearGraph",
+      handler: async (input) => workspaceGraphService.clearGraph(input.userId, input.workspaceId, input.slug)
+    }
+  }
+});
+var workspaceGraphServiceInstance = createService(WorkspaceGraphServiceDefinition);
+var WorkspaceGraphServiceFacade = {
+  id: WorkspaceGraphServiceDefinition.id,
+  name: WorkspaceGraphServiceDefinition.name,
+  version: WorkspaceGraphServiceDefinition.version,
+  runtime: "server",
+  deployment: "local",
+  definition: WorkspaceGraphServiceDefinition,
+  createInstance: () => createService(WorkspaceGraphServiceDefinition),
+  execute: async (op, input) => {
+    await workspaceGraphServiceInstance.start();
+    return workspaceGraphServiceInstance.call(op, input);
+  }
+};
+var krnlWorkspaceGraphServiceDefinition = WorkspaceGraphServiceDefinition;
+var krnlWorkspaceGraphServiceFacade = WorkspaceGraphServiceFacade;
 
 export {
   AuthServiceDefinition,
@@ -361,5 +422,9 @@ export {
   SrklServiceDefinition,
   SrklServiceFacade,
   krnlSrklServiceDefinition,
-  krnlSrklServiceFacade
+  krnlSrklServiceFacade,
+  WorkspaceGraphServiceDefinition,
+  WorkspaceGraphServiceFacade,
+  krnlWorkspaceGraphServiceDefinition,
+  krnlWorkspaceGraphServiceFacade
 };

package/packages/backend/dist/{chunk-7B24ZWB3.js → chunk-R27SHBHK.js}

@@ -2,7 +2,7 @@ import {
   createService,
   createServiceDefinition,
   createServiceProxy
-} from "./chunk-TY32TUNI.js";
+} from "./chunk-ZFCEXTNI.js";
 
 // src/services/ServiceBoundary.ts
 function createLocalService(definition) {

package/packages/backend/dist/{chunk-TY32TUNI.js → chunk-ZFCEXTNI.js}

@@ -1,3 +1,10 @@
+import {
+  StorageAdapterFactory
+} from "./chunk-J2J24JVC.js";
+import {
+  findUserWorkspace
+} from "./chunk-E72GXBXF.js";
+
 // ../../node_modules/.pnpm/@ultrst-armada+krnl@1.0.3/node_modules/@ultrst-armada/krnl/packages/core/dist/index.js
 var ServiceStateStore = class {
   state;
@@ -369,8 +376,158 @@ function createServiceProxy(definition, adapter, endpoint) {
 }
 var asyncHooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
 
+// src/services/workspaceGraphService.ts
+function slugify(name) {
+  const value = String(name || "").trim().replace(/[/\\]+/g, "_").replace(/[<>:"|?*]/g, "").slice(0, 80);
+  return value || "New Graph";
+}
+function storage() {
+  return StorageAdapterFactory.create({
+    provider: "local_fs",
+    basePath: process.env.KLOKS_GRAPH_STORAGE_ROOT || "./workspaces-data"
+  });
+}
+function graphPath(workspaceId, slug) {
+  return `workspaces/${workspaceId}/graphs/${slug}.graph.json`;
+}
+async function assertWorkspace(userId, workspaceId) {
+  const result = await findUserWorkspace(workspaceId);
+  if (!result.workspace || !result.user || result.user.id !== userId) {
+    throw new Error(`Workspace ${workspaceId} does not exist`);
+  }
+  return result.workspace;
+}
+async function readGraph(workspaceId, slug) {
+  const adapter = storage();
+  const path = graphPath(workspaceId, slug);
+  if (!await adapter.exists(path)) return null;
+  const raw = new TextDecoder().decode(await adapter.read(path));
+  return JSON.parse(raw);
+}
+async function writeGraph(document) {
+  const adapter = storage();
+  await adapter.write(graphPath(document.workspaceId, document.graphSlug), JSON.stringify(document, null, 2), "application/json");
+}
+function toDocument(workspaceId, id, name, slug, nodes = [], edges = [], createdAt = (/* @__PURE__ */ new Date()).toISOString()) {
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  return {
+    $schema: "https://skipo.dev/schemas/node-graph.v1.json",
+    version: "1.0.0",
+    appId: workspaceId,
+    appName: name,
+    createdAt,
+    updatedAt: now,
+    exportedAt: now,
+    workspaceId,
+    graphId: id,
+    graphSlug: slug,
+    graph: { nodes, edges }
+  };
+}
+var workspaceGraphService = {
+  async listGraphs(userId, workspaceId) {
+    await assertWorkspace(userId, workspaceId);
+    const adapter = storage();
+    const files = await adapter.list(`workspaces/${workspaceId}/graphs`);
+    const graphs = [];
+    for (const file of files.filter((item) => item.path.endsWith(".graph.json"))) {
+      try {
+        const raw = new TextDecoder().decode(await adapter.read(file.path));
+        const graph = JSON.parse(raw);
+        graphs.push({
+          id: graph.graphId,
+          name: graph.appName,
+          slug: graph.graphSlug,
+          createdAt: graph.createdAt,
+          updatedAt: graph.updatedAt,
+          nodeCount: graph.graph.nodes.length
+        });
+      } catch {
+      }
+    }
+    graphs.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+    return { success: true, graphs };
+  },
+  async createGraph(userId, workspaceId, input) {
+    await assertWorkspace(userId, workspaceId);
+    const targetName = String(input?.name || "").trim().slice(0, 80) || "New Graph";
+    const baseSlug = slugify(targetName);
+    let slug = baseSlug;
+    let n = 2;
+    while (await readGraph(workspaceId, slug)) slug = `${baseSlug} (${n++})`;
+    const graph = toDocument(workspaceId, `graph-${Date.now()}`, targetName, slug);
+    await writeGraph(graph);
+    return { success: true, graph, graphs: (await this.listGraphs(userId, workspaceId)).graphs };
+  },
+  async getGraph(userId, workspaceId, slug) {
+    await assertWorkspace(userId, workspaceId);
+    const graph = await readGraph(workspaceId, slug);
+    if (!graph) throw new Error(`Graph "${slug}" not found`);
+    return { success: true, graph };
+  },
+  async saveGraph(userId, workspaceId, slug, patch) {
+    await assertWorkspace(userId, workspaceId);
+    const existing = await readGraph(workspaceId, slug);
+    if (!existing) throw new Error(`Graph "${slug}" not found`);
+    const next = {
+      ...existing,
+      appName: typeof patch.name === "string" && patch.name.trim() ? patch.name.trim().slice(0, 80) : existing.appName,
+      graph: {
+        nodes: Array.isArray(patch.nodes) ? patch.nodes : existing.graph.nodes,
+        edges: Array.isArray(patch.edges) ? patch.edges : existing.graph.edges
+      },
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      exportedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    await writeGraph(next);
+    return { success: true, graph: next };
+  },
+  async deleteGraph(userId, workspaceId, slug) {
+    await assertWorkspace(userId, workspaceId);
+    const adapter = storage();
+    const path = graphPath(workspaceId, slug);
+    if (!await adapter.exists(path)) throw new Error(`Graph "${slug}" not found`);
+    await adapter.delete(path);
+    return { success: true, deletedSlug: slug, graphs: (await this.listGraphs(userId, workspaceId)).graphs };
+  },
+  async duplicateGraph(userId, workspaceId, slug, newName) {
+    const existing = (await this.getGraph(userId, workspaceId, slug)).graph;
+    const targetName = (newName || `${existing.appName} (Copy)`).trim().slice(0, 80);
+    const baseSlug = slugify(targetName);
+    let newSlug = baseSlug;
+    let n = 2;
+    while (await readGraph(workspaceId, newSlug)) newSlug = `${baseSlug} (${n++})`;
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const graph = {
+      ...JSON.parse(JSON.stringify(existing)),
+      graphId: `graph-${Date.now()}`,
+      graphSlug: newSlug,
+      appName: targetName,
+      createdAt: now,
+      updatedAt: now,
+      exportedAt: now
+    };
+    await writeGraph(graph);
+    return { success: true, graph, graphs: (await this.listGraphs(userId, workspaceId)).graphs };
+  },
+  async clearGraph(userId, workspaceId, slug) {
+    const existing = (await this.getGraph(userId, workspaceId, slug)).graph;
+    return this.saveGraph(userId, workspaceId, slug, { nodes: [], edges: [] });
+  },
+  async getGraphDocument(userId, workspaceId, slug) {
+    return (await this.getGraph(userId, workspaceId, slug)).graph;
+  },
+  async saveGraphDocument(userId, workspaceId, document) {
+    await assertWorkspace(userId, workspaceId);
+    if (document.workspaceId !== workspaceId) throw new Error("Graph workspace mismatch");
+    await writeGraph({ ...document, updatedAt: (/* @__PURE__ */ new Date()).toISOString(), exportedAt: (/* @__PURE__ */ new Date()).toISOString() });
+    return { success: true, graph: document };
+  }
+};
+
 export {
   createServiceDefinition,
   createService,
-  createServiceProxy
+  createServiceProxy,
+  workspaceGraphService
 };

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

@@ -10,9 +10,9 @@ export { A as AuthContext, B as BackendClient, a as BackendClientOptions, b as B
 export { BackendContract, BackendRegistry, CallbackDefinition, ConcurrencyConflictError, ConcurrencyManager, DomainContract, EventDefinition, HealthMonitor, IdempotencyManager, InProcessExecutor, JobDefinition, JobHandler, JobScheduler, LoadBalancer, LockManager, OperationDefinition, RemoteExecutor, RemoteExecutorOptions, createEmptyContract } from './connectivity/index.js';
 export { BackendClientInstance, BackendProvider, BackendProviderProps, useBackend, useBackendClient } from './client/index.js';
 export { AdaptedStorageConnection, AppAccountManifest, AppServiceDeclaration, CANONICAL_SRKL_URL, CredentialRegistryMap, EcosystemAccount, EcosystemAccountsRequest, EcosystemAccountsResponse, EcosystemServiceCategory, KeyMaterial, ServiceAccountEntry, SrklClient, SrklClientOptions, SrklCredentialRegistry, SrklEcosystemQueryOptions, SrklEcosystemResponse, SrklServiceAccount, SrklVaultAccessClient, SrklVaultAccessResponse, UseSrklServicesOptions, UseSrklServicesResult, VaultAccessClientOptions, createSrklClient, decryptVaultBufferInBrowser, getPrimarySrklDeploymentUrl, getSrklAccounts, globalCredentialRegistry, hexToBytes, srklListBackblazeBuckets, srklService, syncSrklAccounts, useSrklServices } from './srkl/index.js';
-export { CompositeBackend, EndpointGenerator, GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, LocalService, NodeGraphPersistenceService, NodeGraphValidationResult, RemoteServiceProxy, SaveGraphOptions, UniversalAppEntity, UniversalGraphEdge, UniversalGraphNode, UniversalNodeGraphDocument, UniversalStorageConnection, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument } from './services/index.js';
+export { CompositeBackend, EndpointGenerator, GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, LocalService, NodeGraphPersistenceService, NodeGraphValidationResult, RemoteServiceProxy, SaveGraphOptions, UniversalAppEntity, UniversalGraphEdge, UniversalGraphNode, UniversalNodeGraphDocument, UniversalStorageConnection, WorkspaceGraphDocument, WorkspaceGraphSummary, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument, workspaceGraphService } 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';
-export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, SrklServiceDefinition, SrklServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade, krnlAuthServiceDefinition, krnlAuthServiceFacade, krnlControlPlaneServiceDefinition, krnlControlPlaneServiceFacade, krnlDatabaseServiceDefinition, krnlDatabaseServiceFacade, krnlGeminiServiceDefinition, krnlGeminiServiceFacade, krnlSrklServiceDefinition, krnlSrklServiceFacade, krnlStorageServiceDefinition, krnlStorageServiceFacade, krnlWorkspaceServiceDefinition, krnlWorkspaceServiceFacade } from './krnl-services.js';
+export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, SrklServiceDefinition, SrklServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceGraphServiceDefinition, WorkspaceGraphServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade, krnlAuthServiceDefinition, krnlAuthServiceFacade, krnlControlPlaneServiceDefinition, krnlControlPlaneServiceFacade, krnlDatabaseServiceDefinition, krnlDatabaseServiceFacade, krnlGeminiServiceDefinition, krnlGeminiServiceFacade, krnlSrklServiceDefinition, krnlSrklServiceFacade, krnlStorageServiceDefinition, krnlStorageServiceFacade, krnlWorkspaceGraphServiceDefinition, krnlWorkspaceGraphServiceFacade, krnlWorkspaceServiceDefinition, krnlWorkspaceServiceFacade } from './krnl-services.js';
 export { EndpointDescriptor, IService, ProtocolAdapter, ServiceDefinition } from '@ultrst-armada/krnl';
 import 'react';
 

package/packages/backend/dist/index.js

@@ -27,7 +27,7 @@ import {
   setWorkingWorkspaceConfig,
   syncWorkspace,
   workingWorkspaceService
-} from "./chunk-DULUHQ5S.js";
+} from "./chunk-GPXV4GBD.js";
 import {
   AuthServiceDefinition,
   AuthServiceFacade,
@@ -41,6 +41,8 @@ import {
   SrklServiceFacade,
   StorageServiceDefinition,
   StorageServiceFacade,
+  WorkspaceGraphServiceDefinition,
+  WorkspaceGraphServiceFacade,
   WorkspaceServiceDefinition,
   WorkspaceServiceFacade,
   krnlAuthServiceDefinition,
@@ -55,29 +57,16 @@ import {
   krnlSrklServiceFacade,
   krnlStorageServiceDefinition,
   krnlStorageServiceFacade,
+  krnlWorkspaceGraphServiceDefinition,
+  krnlWorkspaceGraphServiceFacade,
   krnlWorkspaceServiceDefinition,
   krnlWorkspaceServiceFacade
-} from "./chunk-ZRYACED2.js";
+} from "./chunk-KYBO7FGP.js";
 import {
   getPrimarySrklDeploymentUrl,
   getSrklAccounts,
   srklListBackblazeBuckets
 } from "./chunk-VDROUXFT.js";
-import {
-  BackblazeB2Adapter,
-  BaseStorageAdapter,
-  LocalFSAdapter,
-  S3Adapter,
-  StorageAdapterFactory,
-  SupabaseStorageAdapter,
-  ensureS3DirectoryMarker,
-  isSecretMasked,
-  normalizeBackblazeCredentials,
-  permanentDeleteS3Folder,
-  permanentDeleteS3Object,
-  renameS3Folder,
-  resolveBackblazeEndpoint
-} from "./chunk-J2J24JVC.js";
 import {
   authorizeB2,
   b2DownloadFile,
@@ -86,36 +75,9 @@ import {
   b2UploadFile
 } from "./chunk-4QEMALXF.js";
 import {
-  b2DeleteFileVersion,
-  b2DeleteFolder,
-  b2ListBuckets as b2ListBuckets2,
-  cleanDbUrl,
-  createWorkspace,
-  deleteWorkspace,
-  deleteWorkspaceFile,
-  deleteWorkspaceFolder,
-  findUserWorkspace,
   formatCanonicalWorkspaceFolderName,
-  getB2BucketId,
-  getUnifiedDbUrl,
-  getWorkspaceFolderPrefix,
-  getWorkspaceStorageDetails,
-  getWorkspaces,
-  isB2Workspace,
-  listWorkspaceFiles,
-  loadWorkspaceData,
-  queryUnifiedDb,
-  readWorkspaceFile,
-  renameAppInWorkspaceData,
-  resolveWorkspaceConnection,
-  sanitizeWorkspaceName,
-  saveWorkspaceData,
-  syncWorkspaceCreateToBucket,
-  syncWorkspaceDataToBucket,
-  syncWorkspaceDeleteToBucket,
-  updateWorkspace,
-  writeWorkspaceFile
-} from "./chunk-ZO3PZGNQ.js";
+  sanitizeWorkspaceName
+} from "./chunk-FZKBTF34.js";
 import {
   BaseApiRoute,
   createSSEResponse,
@@ -134,11 +96,6 @@ import {
   loginSystemUser,
   resolveUserFromToken
 } from "./chunk-ZDH4XI7W.js";
-import {
-  BackendProvider,
-  useBackend,
-  useBackendClient
-} from "./chunk-G3ZOSXUR.js";
 import {
   BackendRegistry,
   ConcurrencyConflictError,
@@ -152,6 +109,19 @@ import {
   RemoteExecutor,
   createEmptyContract
 } from "./chunk-5E6JRFUH.js";
+import {
+  AuditLogger,
+  ControlPlaneManager,
+  DatabaseClusterManager,
+  detectDatabaseEngine,
+  getSystemDatabaseUrls,
+  resolveSystemDatabaseClusterNodes
+} from "./chunk-RCCQ7IRM.js";
+import {
+  BackendProvider,
+  useBackend,
+  useBackendClient
+} from "./chunk-G3ZOSXUR.js";
 import {
   BackendClient,
   BackendResolver,
@@ -163,14 +133,6 @@ import {
   WebSocketTransport,
   createBackendClient
 } from "./chunk-NIP22V2G.js";
-import {
-  AuditLogger,
-  ControlPlaneManager,
-  DatabaseClusterManager,
-  detectDatabaseEngine,
-  getSystemDatabaseUrls,
-  resolveSystemDatabaseClusterNodes
-} from "./chunk-RCCQ7IRM.js";
 import {
   CompositeBackend,
   EndpointGenerator,
@@ -184,8 +146,54 @@ import {
   nodeGraphPersistence,
   parseGraphJsonFile,
   validateGraphDocument
-} from "./chunk-7B24ZWB3.js";
-import "./chunk-TY32TUNI.js";
+} from "./chunk-R27SHBHK.js";
+import {
+  workspaceGraphService
+} from "./chunk-ZFCEXTNI.js";
+import {
+  BackblazeB2Adapter,
+  BaseStorageAdapter,
+  LocalFSAdapter,
+  S3Adapter,
+  StorageAdapterFactory,
+  SupabaseStorageAdapter,
+  ensureS3DirectoryMarker,
+  isSecretMasked,
+  normalizeBackblazeCredentials,
+  permanentDeleteS3Folder,
+  permanentDeleteS3Object,
+  renameS3Folder,
+  resolveBackblazeEndpoint
+} from "./chunk-J2J24JVC.js";
+import {
+  b2DeleteFileVersion,
+  b2DeleteFolder,
+  b2ListBuckets as b2ListBuckets2,
+  cleanDbUrl,
+  createWorkspace,
+  deleteWorkspace,
+  deleteWorkspaceFile,
+  deleteWorkspaceFolder,
+  findUserWorkspace,
+  getB2BucketId,
+  getUnifiedDbUrl,
+  getWorkspaceFolderPrefix,
+  getWorkspaceStorageDetails,
+  getWorkspaces,
+  isB2Workspace,
+  listWorkspaceFiles,
+  loadWorkspaceData,
+  queryUnifiedDb,
+  readWorkspaceFile,
+  renameAppInWorkspaceData,
+  resolveWorkspaceConnection,
+  saveWorkspaceData,
+  syncWorkspaceCreateToBucket,
+  syncWorkspaceDataToBucket,
+  syncWorkspaceDeleteToBucket,
+  updateWorkspace,
+  writeWorkspaceFile
+} from "./chunk-E72GXBXF.js";
 
 // src/data/BaseDataProvider.ts
 import { SkipoBase } from "@ultrst-armada/kloks/functions";
@@ -4416,6 +4424,8 @@ export {
   WorkingWorkspaceService,
   WorkspaceCloneSyncEngine,
   WorkspaceFS,
+  WorkspaceGraphServiceDefinition,
+  WorkspaceGraphServiceFacade,
   WorkspaceServiceDefinition,
   WorkspaceServiceFacade,
   authorizeB2,
@@ -4527,6 +4537,8 @@ export {
   krnlSrklServiceFacade,
   krnlStorageServiceDefinition,
   krnlStorageServiceFacade,
+  krnlWorkspaceGraphServiceDefinition,
+  krnlWorkspaceGraphServiceFacade,
   krnlWorkspaceServiceDefinition,
   krnlWorkspaceServiceFacade,
   listAllGraphPackages,
@@ -4599,5 +4611,6 @@ export {
   withAuth,
   withCors,
   workingWorkspaceService,
+  workspaceGraphService,
   writeWorkspaceFile
 };

package/packages/backend/dist/krnl-services.d.ts

@@ -155,5 +155,27 @@ declare const krnlSrklServiceFacade: {
     createInstance: () => _ultrst_armada_krnl.ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
     execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
 };
+declare const WorkspaceGraphServiceDefinition: ServiceDefinition;
+declare const WorkspaceGraphServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "server";
+    deployment: "local";
+    definition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+    createInstance: () => _ultrst_armada_krnl.ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
+    execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
+};
+declare const krnlWorkspaceGraphServiceDefinition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+declare const krnlWorkspaceGraphServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "server";
+    deployment: "local";
+    definition: ServiceDefinition<Record<string, unknown>, Record<string, unknown>>;
+    createInstance: () => _ultrst_armada_krnl.ServiceInstance<Record<string, unknown>, Record<string, unknown>>;
+    execute: <TIn = unknown, TOut = unknown>(op: string, input?: TIn) => Promise<TOut>;
+};
 
-export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, SrklServiceDefinition, SrklServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade, krnlAuthServiceDefinition, krnlAuthServiceFacade, krnlControlPlaneServiceDefinition, krnlControlPlaneServiceFacade, krnlDatabaseServiceDefinition, krnlDatabaseServiceFacade, krnlGeminiServiceDefinition, krnlGeminiServiceFacade, krnlSrklServiceDefinition, krnlSrklServiceFacade, krnlStorageServiceDefinition, krnlStorageServiceFacade, krnlWorkspaceServiceDefinition, krnlWorkspaceServiceFacade };
+export { AuthServiceDefinition, AuthServiceFacade, ControlPlaneServiceDefinition, ControlPlaneServiceFacade, DatabaseServiceDefinition, DatabaseServiceFacade, GeminiServiceDefinition, GeminiServiceFacade, SrklServiceDefinition, SrklServiceFacade, StorageServiceDefinition, StorageServiceFacade, WorkspaceGraphServiceDefinition, WorkspaceGraphServiceFacade, WorkspaceServiceDefinition, WorkspaceServiceFacade, krnlAuthServiceDefinition, krnlAuthServiceFacade, krnlControlPlaneServiceDefinition, krnlControlPlaneServiceFacade, krnlDatabaseServiceDefinition, krnlDatabaseServiceFacade, krnlGeminiServiceDefinition, krnlGeminiServiceFacade, krnlSrklServiceDefinition, krnlSrklServiceFacade, krnlStorageServiceDefinition, krnlStorageServiceFacade, krnlWorkspaceGraphServiceDefinition, krnlWorkspaceGraphServiceFacade, krnlWorkspaceServiceDefinition, krnlWorkspaceServiceFacade };

package/packages/backend/dist/krnl-services.js

@@ -11,6 +11,8 @@ import {
   SrklServiceFacade,
   StorageServiceDefinition,
   StorageServiceFacade,
+  WorkspaceGraphServiceDefinition,
+  WorkspaceGraphServiceFacade,
   WorkspaceServiceDefinition,
   WorkspaceServiceFacade,
   krnlAuthServiceDefinition,
@@ -25,15 +27,18 @@ import {
   krnlSrklServiceFacade,
   krnlStorageServiceDefinition,
   krnlStorageServiceFacade,
+  krnlWorkspaceGraphServiceDefinition,
+  krnlWorkspaceGraphServiceFacade,
   krnlWorkspaceServiceDefinition,
   krnlWorkspaceServiceFacade
-} from "./chunk-ZRYACED2.js";
+} from "./chunk-KYBO7FGP.js";
 import "./chunk-VDROUXFT.js";
-import "./chunk-J2J24JVC.js";
 import "./chunk-4QEMALXF.js";
-import "./chunk-ZO3PZGNQ.js";
+import "./chunk-FZKBTF34.js";
 import "./chunk-ZDH4XI7W.js";
-import "./chunk-TY32TUNI.js";
+import "./chunk-ZFCEXTNI.js";
+import "./chunk-J2J24JVC.js";
+import "./chunk-E72GXBXF.js";
 export {
   AuthServiceDefinition,
   AuthServiceFacade,
@@ -47,6 +52,8 @@ export {
   SrklServiceFacade,
   StorageServiceDefinition,
   StorageServiceFacade,
+  WorkspaceGraphServiceDefinition,
+  WorkspaceGraphServiceFacade,
   WorkspaceServiceDefinition,
   WorkspaceServiceFacade,
   krnlAuthServiceDefinition,
@@ -61,6 +68,8 @@ export {
   krnlSrklServiceFacade,
   krnlStorageServiceDefinition,
   krnlStorageServiceFacade,
+  krnlWorkspaceGraphServiceDefinition,
+  krnlWorkspaceGraphServiceFacade,
   krnlWorkspaceServiceDefinition,
   krnlWorkspaceServiceFacade
 };

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

@@ -228,4 +228,67 @@ declare class NodeGraphPersistenceService {
 }
 declare const nodeGraphPersistence: NodeGraphPersistenceService;
 
-export { CompositeBackend, EndpointGenerator, type GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, type LocalService, NodeGraphPersistenceService, type NodeGraphValidationResult, type RemoteServiceProxy, type SaveGraphOptions, type UniversalAppEntity, type UniversalGraphEdge, type UniversalGraphNode, type UniversalNodeGraphDocument, type UniversalStorageConnection, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument };
+/**
+ * @file workspaceGraphService.ts
+ * @description Universal workspace-scoped graph persistence service.
+ *
+ * This service owns graph documents and storage only. It does not know about
+ * BRWLR, Playwright, ZX, node factories, or any application-specific node type.
+ */
+
+interface WorkspaceGraphDocument extends UniversalNodeGraphDocument {
+    workspaceId: string;
+    graphId: string;
+    graphSlug: string;
+}
+interface WorkspaceGraphSummary {
+    id: string;
+    name: string;
+    slug: string;
+    createdAt: string;
+    updatedAt: string;
+    nodeCount: number;
+}
+declare const workspaceGraphService: {
+    listGraphs(userId: string, workspaceId: string): Promise<{
+        success: true;
+        graphs: WorkspaceGraphSummary[];
+    }>;
+    createGraph(userId: string, workspaceId: string, input: {
+        name?: string;
+    }): Promise<{
+        success: true;
+        graph: WorkspaceGraphDocument;
+        graphs: any;
+    }>;
+    getGraph(userId: string, workspaceId: string, slug: string): Promise<{
+        success: true;
+        graph: WorkspaceGraphDocument;
+    }>;
+    saveGraph(userId: string, workspaceId: string, slug: string, patch: {
+        nodes?: UniversalGraphNode[];
+        edges?: UniversalGraphEdge[];
+        name?: string;
+    }): Promise<{
+        success: true;
+        graph: WorkspaceGraphDocument;
+    }>;
+    deleteGraph(userId: string, workspaceId: string, slug: string): Promise<{
+        success: true;
+        deletedSlug: string;
+        graphs: any;
+    }>;
+    duplicateGraph(userId: string, workspaceId: string, slug: string, newName?: string): Promise<{
+        success: true;
+        graph: WorkspaceGraphDocument;
+        graphs: any;
+    }>;
+    clearGraph(userId: string, workspaceId: string, slug: string): Promise<any>;
+    getGraphDocument(userId: string, workspaceId: string, slug: string): Promise<any>;
+    saveGraphDocument(userId: string, workspaceId: string, document: WorkspaceGraphDocument): Promise<{
+        success: true;
+        graph: WorkspaceGraphDocument;
+    }>;
+};
+
+export { CompositeBackend, EndpointGenerator, type GeneratedEndpointSummary, LOCAL_STORAGE_GRAPHS_PREFIX, type LocalService, NodeGraphPersistenceService, type NodeGraphValidationResult, type RemoteServiceProxy, type SaveGraphOptions, type UniversalAppEntity, type UniversalGraphEdge, type UniversalGraphNode, type UniversalNodeGraphDocument, type UniversalStorageConnection, type WorkspaceGraphDocument, type WorkspaceGraphSummary, createBackend, createCompositeService, createLocalService, createRemoteService, exportGraphAsJsonFile, nodeGraphPersistence, parseGraphJsonFile, validateGraphDocument, workspaceGraphService };

package/packages/backend/dist/services/index.js

@@ -11,8 +11,12 @@ import {
   nodeGraphPersistence,
   parseGraphJsonFile,
   validateGraphDocument
-} from "../chunk-7B24ZWB3.js";
-import "../chunk-TY32TUNI.js";
+} from "../chunk-R27SHBHK.js";
+import {
+  workspaceGraphService
+} from "../chunk-ZFCEXTNI.js";
+import "../chunk-J2J24JVC.js";
+import "../chunk-E72GXBXF.js";
 export {
   CompositeBackend,
   EndpointGenerator,
@@ -25,5 +29,6 @@ export {
   exportGraphAsJsonFile,
   nodeGraphPersistence,
   parseGraphJsonFile,
-  validateGraphDocument
+  validateGraphDocument,
+  workspaceGraphService
 };

package/packages/backend/dist/storage/index.js

@@ -1,4 +1,11 @@
 import "../chunk-LS3HWJBX.js";
+import {
+  authorizeB2,
+  b2DownloadFile,
+  b2ListBuckets,
+  b2ListFileNames,
+  b2UploadFile
+} from "../chunk-4QEMALXF.js";
 import {
   BackblazeB2Adapter,
   BaseStorageAdapter,
@@ -14,13 +21,6 @@ import {
   renameS3Folder,
   resolveBackblazeEndpoint
 } from "../chunk-J2J24JVC.js";
-import {
-  authorizeB2,
-  b2DownloadFile,
-  b2ListBuckets,
-  b2ListFileNames,
-  b2UploadFile
-} from "../chunk-4QEMALXF.js";
 export {
   BackblazeB2Adapter,
   BaseStorageAdapter,

package/packages/backend/dist/workspace/index.js

@@ -6,11 +6,12 @@ import {
   WorkspaceFS,
   remoteWorkspaceService,
   workingWorkspaceService
-} from "../chunk-DULUHQ5S.js";
+} from "../chunk-GPXV4GBD.js";
 import {
   formatCanonicalWorkspaceFolderName,
   sanitizeWorkspaceName
-} from "../chunk-ZO3PZGNQ.js";
+} from "../chunk-FZKBTF34.js";
+import "../chunk-E72GXBXF.js";
 export {
   RemoteWorkspaceService,
   SyncEngine,