@ultrst-armada/kloks 1.7.1 → 1.9.0

package/packages/backend/dist/index.js

@@ -32,7 +32,7 @@ import {
 } from "./chunk-3IUA66RS.js";
 import {
   S3Adapter
-} from "./chunk-JUPWFW7V.js";
+} from "./chunk-RBQ4CW3T.js";
 import {
   RemoteWorkspaceService,
   SyncEngine,
@@ -48,7 +48,7 @@ import {
   setWorkingWorkspaceConfig,
   syncWorkspace,
   workingWorkspaceService
-} from "./chunk-6W7OAGNV.js";
+} from "./chunk-BTMIK44G.js";
 import {
   AuthServiceDefinition,
   AuthServiceFacade,
@@ -82,10 +82,10 @@ import {
   krnlWorkspaceGraphServiceFacade,
   krnlWorkspaceServiceDefinition,
   krnlWorkspaceServiceFacade
-} from "./chunk-7ZT2ZPPH.js";
+} from "./chunk-UMEO6XS4.js";
 import {
   workspaceGraphService
-} from "./chunk-F6IDQLC2.js";
+} from "./chunk-VKSGYMAH.js";
 import {
   getPrimarySrklDeploymentUrl,
   getSrklAccounts,
@@ -93,22 +93,17 @@ import {
 } from "./chunk-XHADDA75.js";
 import {
   BackblazeB2Adapter,
-  BaseStorageAdapter,
-  GoogleDriveAdapter,
   LocalFSAdapter,
   StorageAdapterFactory,
   SupabaseStorageAdapter,
-  createGoogleDriveAuthorizationUrl,
   ensureS3DirectoryMarker,
-  exchangeGoogleDriveCode,
   isSecretMasked,
   normalizeBackblazeCredentials,
   permanentDeleteS3Folder,
   permanentDeleteS3Object,
-  refreshGoogleDriveAccessToken,
   renameS3Folder,
   resolveBackblazeEndpoint
-} from "./chunk-R45CEV46.js";
+} from "./chunk-SHZAQTIT.js";
 import {
   authorizeB2,
   b2DownloadFile,
@@ -150,6 +145,13 @@ import {
   getUnifiedDbUrl,
   queryUnifiedDb
 } from "./chunk-VAFCR2MS.js";
+import {
+  BaseStorageAdapter,
+  GoogleDriveAdapter,
+  createGoogleDriveAuthorizationUrl,
+  exchangeGoogleDriveCode,
+  refreshGoogleDriveAccessToken
+} from "./chunk-KKRWZDMN.js";
 import {
   BaseApiRoute,
   createSSEResponse,
@@ -161,13 +163,15 @@ import {
   BaseAccountProvider,
   LocalAccountProvider,
   PasswordHasher
-} from "./chunk-MPYASJ5A.js";
+} from "./chunk-W6JNJD3Q.js";
 import {
+  CanonicalAuthClient,
   RateLimiter,
   SessionManager,
+  createCanonicalAuthClient,
   loginSystemUser,
   resolveUserFromToken
-} from "./chunk-ZDH4XI7W.js";
+} from "./chunk-WTBAG4AV.js";
 import {
   BackendProvider,
   useBackend,
@@ -2054,6 +2058,8 @@ async function fetchCloudflareData(payload, rawUserId, env) {
         id: p.name || p.id,
         name: p.name,
         type: "PAGES_PROJECT",
+        providerProjectId: p.id,
+        providerDeploymentId: p.latest_deployment?.id,
         status: p.latest_deployment?.status || "READY",
         framework: "Cloudflare Pages",
         domain: pDomain,
@@ -2188,6 +2194,7 @@ function buildProjectObservability(projects, deployments, user) {
       fastDataTransferFormatted: "100 MB",
       middlewareInvocations: 10,
       middlewareInvocationsFormatted: "10",
+      latestDeploymentId: latestDep?.id,
       latestDeploymentUrl: `https://${cleanDeploymentUrl}`,
       latestDeploymentStatus: displayStatus,
       latestDeploymentCreatedAt: new Date(createdAtTime).toISOString(),
@@ -2205,7 +2212,8 @@ function buildProjectsList(observability) {
     url: po.latestDeploymentUrl,
     domain: po.domains && po.domains[0] || `${po.projectName}.vercel.app`,
     domains: po.domains || [`${po.projectName}.vercel.app`],
-    updatedAt: po.latestDeploymentCreatedAt
+    updatedAt: po.latestDeploymentCreatedAt,
+    deploymentId: po.latestDeploymentId
   }));
 }
 
@@ -2374,6 +2382,142 @@ async function fetchVercelData(payload, rawUserId, env) {
   }
 }
 
+// src/core/deploymentControlCore.ts
+function firstString(...values) {
+  return values.find((value) => typeof value === "string" && value.trim().length > 0)?.trim() || "";
+}
+async function resolveVercelCredentials(payload, userId, env) {
+  const credentials = payload.credentials || {};
+  let token = firstString(payload.token, payload.apiToken, payload.accessToken, credentials.token, credentials.apiToken, credentials.accessToken);
+  let teamId = firstString(payload.teamId, credentials.teamId);
+  if ((!token || !teamId) && userId && (payload.accountId || credentials.accountId)) {
+    const accountId = firstString(payload.accountId, credentials.accountId);
+    const srkl = await getSrklAccounts2(userId, "vercel", env);
+    const account = srkl.accounts?.find((item) => item.id === accountId);
+    const accountCredentials = account?.credentials || account?.metadata?.credentials || {};
+    token ||= firstString(accountCredentials.token, accountCredentials.apiToken, accountCredentials.accessToken);
+    teamId ||= firstString(accountCredentials.teamId);
+  }
+  if (!token) throw new Error("Vercel API token is missing or not configured for this account.");
+  return { token, teamId };
+}
+async function resolveCloudflareCredentials(payload, userId, env) {
+  const credentials = payload.credentials || {};
+  let token = firstString(payload.token, payload.apiToken, payload.accessToken, credentials.token, credentials.apiToken, credentials.accessToken);
+  let accountId = firstString(payload.accountId, payload.cfAccountId, payload.accountTag, credentials.accountId, credentials.cfAccountId, credentials.accountTag);
+  let authKey = firstString(payload.authKey, payload.globalApiKey, credentials.authKey, credentials.globalApiKey);
+  let authEmail = firstString(payload.authEmail, payload.email, credentials.authEmail, credentials.email);
+  if (!token && !authKey || !accountId) {
+    const requestedAccountId = firstString(payload.accountId, credentials.accountId);
+    if (userId && requestedAccountId) {
+      const srkl = await getSrklAccounts2(userId, "cloudflare", env);
+      const account = srkl.accounts?.find((item) => item.id === requestedAccountId);
+      const accountCredentials = account?.credentials || account?.metadata?.credentials || {};
+      token ||= firstString(accountCredentials.token, accountCredentials.apiToken, accountCredentials.accessToken);
+      accountId ||= firstString(accountCredentials.accountId, accountCredentials.cfAccountId, accountCredentials.accountTag);
+      authKey ||= firstString(accountCredentials.authKey, accountCredentials.globalApiKey);
+      authEmail ||= firstString(accountCredentials.authEmail, accountCredentials.email);
+    }
+  }
+  if (!token && !authKey) throw new Error("Cloudflare API Token or Global API Key required.");
+  if (!accountId) throw new Error("Cloudflare Account ID is required.");
+  return { token, accountId, authKey, authEmail };
+}
+function cloudflareHeaders(token, authKey, authEmail) {
+  const headers = { "Content-Type": "application/json", "User-Agent": "Kloks-DeploymentControl/1.0" };
+  if (token) headers.Authorization = `Bearer ${token}`;
+  else {
+    headers["X-Auth-Key"] = authKey;
+    headers["X-Auth-Email"] = authEmail;
+  }
+  return headers;
+}
+async function assertOk(response, provider) {
+  if (response.ok) return;
+  const body = await response.json().catch(() => ({}));
+  const message = body?.error?.message || body?.errors?.[0]?.message || body?.message || response.statusText;
+  throw new Error(`${provider} API error (${response.status}): ${message}`);
+}
+async function pauseVercelProject(projectId, payload = {}, userId, env) {
+  if (!projectId?.trim()) throw new Error("Vercel project ID is required.");
+  const { token, teamId } = await resolveVercelCredentials(payload, userId, env);
+  const query = teamId ? `?teamId=${encodeURIComponent(teamId)}` : "";
+  const response = await fetch(`https://api.vercel.com/v1/projects/${encodeURIComponent(projectId)}/pause${query}`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" }
+  });
+  await assertOk(response, "Vercel");
+  return { success: true, provider: "VERCEL", projectId, controlState: "PAUSED" };
+}
+async function resumeVercelProject(projectId, payload = {}, userId, env) {
+  if (!projectId?.trim()) throw new Error("Vercel project ID is required.");
+  const { token, teamId } = await resolveVercelCredentials(payload, userId, env);
+  const query = teamId ? `?teamId=${encodeURIComponent(teamId)}` : "";
+  const response = await fetch(`https://api.vercel.com/v1/projects/${encodeURIComponent(projectId)}/unpause${query}`, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" }
+  });
+  await assertOk(response, "Vercel");
+  return { success: true, provider: "VERCEL", projectId, controlState: "ACTIVE" };
+}
+async function pauseCloudflarePagesProject(projectName, payload = {}, userId, env) {
+  if (!projectName?.trim()) throw new Error("Cloudflare Pages project name is required.");
+  const { token, accountId, authKey, authEmail } = await resolveCloudflareCredentials(payload, userId, env);
+  const base = `https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(accountId)}/pages/projects/${encodeURIComponent(projectName)}`;
+  const currentResponse = await fetch(base, { headers: cloudflareHeaders(token, authKey, authEmail) });
+  await assertOk(currentResponse, "Cloudflare");
+  const current = await currentResponse.json();
+  const config = current?.result?.source?.config;
+  if (!config) throw new Error("Cloudflare Pages project has no source deployment configuration to pause.");
+  const pauseState = {
+    productionDeploymentsEnabled: config.production_deployments_enabled !== false,
+    previewDeploymentSetting: config.preview_deployment_setting || "all"
+  };
+  const updateResponse = await fetch(base, {
+    method: "PATCH",
+    headers: cloudflareHeaders(token, authKey, authEmail),
+    body: JSON.stringify({
+      source: {
+        type: current?.result?.source?.type,
+        config: {
+          ...config,
+          production_deployments_enabled: false,
+          preview_deployment_setting: "none"
+        }
+      }
+    })
+  });
+  await assertOk(updateResponse, "Cloudflare");
+  return { success: true, provider: "CLOUDFLARE", projectId: projectName, controlState: "PAUSED", pauseState };
+}
+async function resumeCloudflarePagesProject(projectName, pauseState, payload = {}, userId, env) {
+  if (!projectName?.trim()) throw new Error("Cloudflare Pages project name is required.");
+  if (!pauseState) throw new Error("Cloudflare Pages pause state is required to resume safely.");
+  const { token, accountId, authKey, authEmail } = await resolveCloudflareCredentials(payload, userId, env);
+  const base = `https://api.cloudflare.com/client/v4/accounts/${encodeURIComponent(accountId)}/pages/projects/${encodeURIComponent(projectName)}`;
+  const currentResponse = await fetch(base, { headers: cloudflareHeaders(token, authKey, authEmail) });
+  await assertOk(currentResponse, "Cloudflare");
+  const current = await currentResponse.json();
+  const config = current?.result?.source?.config;
+  if (!config) throw new Error("Cloudflare Pages project has no source deployment configuration to resume.");
+  const updateResponse = await fetch(base, {
+    method: "PATCH",
+    headers: cloudflareHeaders(token, authKey, authEmail),
+    body: JSON.stringify({
+      source: {
+        type: current?.result?.source?.type,
+        config: {
+          ...config,
+          production_deployments_enabled: pauseState.productionDeploymentsEnabled,
+          preview_deployment_setting: pauseState.previewDeploymentSetting
+        }
+      }
+    })
+  });
+  await assertOk(updateResponse, "Cloudflare");
+  return { success: true, provider: "CLOUDFLARE", projectId: projectName, controlState: "ACTIVE" };
+}
+
 // src/server/wavHelper.ts
 function createWavBuffer(sampleRate, numChannels, samples) {
   const numSamples = samples[0].length;
@@ -4210,6 +4354,7 @@ export {
   BaseStorageAdapter,
   CANONICAL_SRKL_URL,
   CallbackRegistry,
+  CanonicalAuthClient,
   CloudflareResourceFetcher,
   CodeDiagnosticsService,
   CodeValidationRuntime,
@@ -4308,6 +4453,7 @@ export {
   createAssetSubfolder,
   createBackend,
   createBackendClient,
+  createCanonicalAuthClient,
   createCompositeService,
   createCredential,
   createEmptyContract,
@@ -4424,6 +4570,8 @@ export {
   nodeGraphPersistence,
   normalizeBackblazeCredentials,
   parseGraphJsonFile,
+  pauseCloudflarePagesProject,
+  pauseVercelProject,
   permanentDeleteS3Folder,
   permanentDeleteS3Object,
   queryUnifiedDb,
@@ -4442,6 +4590,8 @@ export {
   resolveUserFromToken,
   resolveWorkspaceConnection,
   resolveWorkspaceDir,
+  resumeCloudflarePagesProject,
+  resumeVercelProject,
   sanitizeWorkspaceName,
   saveAssetToGraph,
   saveAssetToPool,

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

@@ -31,15 +31,16 @@ import {
   krnlWorkspaceGraphServiceFacade,
   krnlWorkspaceServiceDefinition,
   krnlWorkspaceServiceFacade
-} from "./chunk-7ZT2ZPPH.js";
-import "./chunk-F6IDQLC2.js";
+} from "./chunk-UMEO6XS4.js";
+import "./chunk-VKSGYMAH.js";
 import "./chunk-XHADDA75.js";
-import "./chunk-R45CEV46.js";
+import "./chunk-SHZAQTIT.js";
 import "./chunk-4QEMALXF.js";
 import "./chunk-FZKBTF34.js";
 import "./chunk-6K75XXFD.js";
 import "./chunk-VAFCR2MS.js";
-import "./chunk-ZDH4XI7W.js";
+import "./chunk-KKRWZDMN.js";
+import "./chunk-WTBAG4AV.js";
 import "./chunk-TY32TUNI.js";
 export {
   AuthServiceDefinition,

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

@@ -14,10 +14,11 @@ import {
 } from "../chunk-RBF2OGMC.js";
 import {
   workspaceGraphService
-} from "../chunk-F6IDQLC2.js";
-import "../chunk-R45CEV46.js";
+} from "../chunk-VKSGYMAH.js";
+import "../chunk-SHZAQTIT.js";
 import "../chunk-6K75XXFD.js";
 import "../chunk-VAFCR2MS.js";
+import "../chunk-KKRWZDMN.js";
 import "../chunk-TY32TUNI.js";
 export {
   CompositeBackend,

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

@@ -1,5 +1,5 @@
-import { B as BaseStorageAdapter, S as StorageConfig, F as FileInfo, D as DeleteFolderResult, R as RenameFolderResult, C as ConnectionTestResult } from '../BaseStorageAdapter-6x_BQiB3.js';
-export { a as StorageMode, b as StorageProviderType, U as UploadResult } from '../BaseStorageAdapter-6x_BQiB3.js';
+import { B as BaseStorageAdapter, S as StorageConfig, F as FileInfo, D as DeleteFolderResult, R as RenameFolderResult, C as ConnectionTestResult } from '../BaseStorageAdapter-EUCSvJse.js';
+export { a as StorageMode, b as StorageProviderType, U as UploadResult } from '../BaseStorageAdapter-EUCSvJse.js';
 import '@ultrst-armada/kloks/functions';
 
 declare class LocalFSAdapter extends BaseStorageAdapter {

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

@@ -1,24 +1,19 @@
 import {
   S3Adapter
-} from "../chunk-JUPWFW7V.js";
+} from "../chunk-RBQ4CW3T.js";
 import {
   BackblazeB2Adapter,
-  BaseStorageAdapter,
-  GoogleDriveAdapter,
   LocalFSAdapter,
   StorageAdapterFactory,
   SupabaseStorageAdapter,
-  createGoogleDriveAuthorizationUrl,
   ensureS3DirectoryMarker,
-  exchangeGoogleDriveCode,
   isSecretMasked,
   normalizeBackblazeCredentials,
   permanentDeleteS3Folder,
   permanentDeleteS3Object,
-  refreshGoogleDriveAccessToken,
   renameS3Folder,
   resolveBackblazeEndpoint
-} from "../chunk-R45CEV46.js";
+} from "../chunk-SHZAQTIT.js";
 import {
   authorizeB2,
   b2DownloadFile,
@@ -26,6 +21,13 @@ import {
   b2ListFileNames,
   b2UploadFile
 } from "../chunk-4QEMALXF.js";
+import {
+  BaseStorageAdapter,
+  GoogleDriveAdapter,
+  createGoogleDriveAuthorizationUrl,
+  exchangeGoogleDriveCode,
+  refreshGoogleDriveAccessToken
+} from "../chunk-KKRWZDMN.js";
 export {
   BackblazeB2Adapter,
   BaseStorageAdapter,

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

@@ -1,4 +1,4 @@
-import { B as BaseStorageAdapter, F as FileInfo } from '../BaseStorageAdapter-6x_BQiB3.js';
+import { B as BaseStorageAdapter, F as FileInfo } from '../BaseStorageAdapter-EUCSvJse.js';
 import { SkipoBase } from '@ultrst-armada/kloks/functions';
 
 interface WorkspaceDescriptor {

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

@@ -6,13 +6,14 @@ import {
   WorkspaceFS,
   remoteWorkspaceService,
   workingWorkspaceService
-} from "../chunk-6W7OAGNV.js";
+} from "../chunk-BTMIK44G.js";
 import {
   formatCanonicalWorkspaceFolderName,
   sanitizeWorkspaceName
 } from "../chunk-FZKBTF34.js";
 import "../chunk-6K75XXFD.js";
 import "../chunk-VAFCR2MS.js";
+import "../chunk-KKRWZDMN.js";
 export {
   RemoteWorkspaceService,
   SyncEngine,

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

@@ -575,6 +575,111 @@ interface ServiceUISchema {
     operationBindings: OperationBinding[];
 }
 
+type MonacoDiagnosticSeverity = 'error' | 'warning' | 'info' | 'hint';
+interface MonacoDiagnostic {
+    message: string;
+    severity: MonacoDiagnosticSeverity;
+    startLineNumber: number;
+    startColumn: number;
+    endLineNumber: number;
+    endColumn: number;
+    code?: string;
+}
+interface MonacoDocument {
+    uri: string;
+    language: string;
+    value: string;
+    version: number;
+    diagnostics: MonacoDiagnostic[];
+}
+interface MonacoEditorOptions {
+    readOnly?: boolean;
+    minimap?: boolean;
+    fontSize?: number;
+    wordWrap?: 'off' | 'on' | 'wordWrapColumn' | 'bounded';
+}
+interface MonacoIdeSession {
+    sessionId: string;
+    document: MonacoDocument;
+    options: MonacoEditorOptions;
+    createdAt: number;
+    updatedAt: number;
+}
+interface MonacoCreateSessionInput {
+    sessionId?: string;
+    uri: string;
+    language: string;
+    value: string;
+    options?: MonacoEditorOptions;
+}
+interface MonacoUpdateDocumentInput {
+    sessionId: string;
+    value: string;
+    language?: string;
+}
+
+type UIAuthoringContext = 'service' | 'general-component' | 'application';
+type UIAuthoringNodeKind = 'page' | 'section' | 'component';
+interface UIAuthoringNode {
+    id: string;
+    kind: UIAuthoringNodeKind;
+    name: string;
+    componentId?: string;
+    assetRef?: AssetRef;
+    parentId?: string;
+    props: Record<string, string | number | boolean>;
+}
+interface UIAuthoringBinding {
+    componentId: string;
+    property: string;
+    target: {
+        kind: 'api-input';
+        apiId: string;
+        field: string;
+        fieldType: string;
+    } | {
+        kind: 'api-output';
+        apiId: string;
+        field: string;
+        fieldType: string;
+    };
+}
+interface UIAuthoringOperation {
+    operationId: string;
+    name: string;
+    description?: string;
+    inputFields?: Array<{
+        name: string;
+        type: string;
+    }>;
+    outputFields?: Array<{
+        name: string;
+        type: string;
+    }>;
+}
+interface UIAuthoringSession {
+    sessionId: string;
+    context: UIAuthoringContext;
+    nodes: UIAuthoringNode[];
+    bindings: UIAuthoringBinding[];
+    operations: UIAuthoringOperation[];
+    metadata: Record<string, string>;
+}
+interface UIAuthoringCreateInput {
+    sessionId?: string;
+    context: UIAuthoringContext;
+    operations?: UIAuthoringOperation[];
+    metadata?: Record<string, string>;
+}
+interface UIAuthoringValidation {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+declare const UI_AUTHORING_SCHEMA_VERSION = "1.0.0";
+declare function suggestUIComponent(fieldType: string): string;
+declare function buildServiceUISchema(session: UIAuthoringSession): ServiceUISchema;
+
 declare const KLOKS_CANONICAL_CONTRACT: {
     package: string;
     version: string;
@@ -594,4 +699,4 @@ declare const KLOKS_CANONICAL_CONTRACT: {
     validateCompatibility: (consumerSymbols?: string[]) => CompatibilityCheckResult;
 };
 
-export { type AssetRef, type AudioBusConfig, AudioBusConfigSchema, type AudioHardwareState, AudioHardwareStateSchema, type BackendOperation, BackendOperationSchema, type CompatibilityCheckResult, type ComponentDescriptor, type ContractDiffResult, type ContractSnapshot, ContractSnapshotSchema, type ExportSymbolEntry, type GraphEntityMetadata, GraphEntityMetadataSchema, KLOKS_CANONICAL_CONTRACT, KLOKS_PUBLIC_SURFACE, type MidiCommandType, MidiCommandTypeSchema, type MidiEventPayload, MidiEventPayloadSchema, type NodeDimensions2D, NodeDimensions2DSchema, type NodeHeaderStyle, NodeHeaderStyleSchema, type NodeScreenRect2D, NodeScreenRect2DSchema, type OperationBinding, type PageDescriptor, type PublicContractDefinition, PublicContractDefinitionSchema, QWNSR_REQUIRED_SURFACE, type SectionDescriptor, type ServiceUISchema, type SocketDirection, SocketDirectionSchema, type SocketGeometryConfig, SocketGeometryConfigSchema, type SocketPosition2D, SocketPosition2DSchema, type SocketStyleConfig, SocketStyleConfigSchema, type UIRequirementMode, type WireAnimationConfig, WireAnimationConfigSchema, type WireCurveStyle, WireCurveStyleSchema, type WireEndpoint2D, WireEndpoint2DSchema, type WireVisualConfig, WireVisualConfigSchema, createKloksSnapshot, diffContractSnapshots, validateConsumerSurfaceCompatibility };
+export { type AssetRef, type AudioBusConfig, AudioBusConfigSchema, type AudioHardwareState, AudioHardwareStateSchema, type BackendOperation, BackendOperationSchema, type CompatibilityCheckResult, type ComponentDescriptor, type ContractDiffResult, type ContractSnapshot, ContractSnapshotSchema, type ExportSymbolEntry, type GraphEntityMetadata, GraphEntityMetadataSchema, KLOKS_CANONICAL_CONTRACT, KLOKS_PUBLIC_SURFACE, type MidiCommandType, MidiCommandTypeSchema, type MidiEventPayload, MidiEventPayloadSchema, type MonacoCreateSessionInput, type MonacoDiagnostic, type MonacoDiagnosticSeverity, type MonacoDocument, type MonacoEditorOptions, type MonacoIdeSession, type MonacoUpdateDocumentInput, type NodeDimensions2D, NodeDimensions2DSchema, type NodeHeaderStyle, NodeHeaderStyleSchema, type NodeScreenRect2D, NodeScreenRect2DSchema, type OperationBinding, type PageDescriptor, type PublicContractDefinition, PublicContractDefinitionSchema, QWNSR_REQUIRED_SURFACE, type SectionDescriptor, type ServiceUISchema, type SocketDirection, SocketDirectionSchema, type SocketGeometryConfig, SocketGeometryConfigSchema, type SocketPosition2D, SocketPosition2DSchema, type SocketStyleConfig, SocketStyleConfigSchema, type UIAuthoringBinding, type UIAuthoringContext, type UIAuthoringCreateInput, type UIAuthoringNode, type UIAuthoringNodeKind, type UIAuthoringOperation, type UIAuthoringSession, type UIAuthoringValidation, type UIRequirementMode, UI_AUTHORING_SCHEMA_VERSION, type WireAnimationConfig, WireAnimationConfigSchema, type WireCurveStyle, WireCurveStyleSchema, type WireEndpoint2D, WireEndpoint2DSchema, type WireVisualConfig, WireVisualConfigSchema, buildServiceUISchema, createKloksSnapshot, diffContractSnapshots, suggestUIComponent, validateConsumerSurfaceCompatibility };

package/packages/contracts/dist/index.js

@@ -381,6 +381,64 @@ function diffContractSnapshots(previous, current) {
   };
 }
 
+// src/uiAuthoringSchema.ts
+var UI_AUTHORING_SCHEMA_VERSION = "1.0.0";
+function suggestUIComponent(fieldType) {
+  const normalized = fieldType.toLowerCase();
+  if (normalized === "email") return "TextInput.email";
+  if (normalized === "password") return "TextInput.password";
+  if (normalized === "boolean" || normalized === "bool") return "ToggleInput";
+  if (normalized === "number" || normalized === "integer" || normalized === "float") return "NumberInput";
+  if (normalized.includes("date")) return "DateInput";
+  return "TextInput";
+}
+function buildServiceUISchema(session) {
+  if (session.context !== "service") throw new Error("Service UI schema generation requires service context.");
+  const pages = session.nodes.filter((node) => node.kind === "page");
+  const sections = session.nodes.filter((node) => node.kind === "section");
+  const components = session.nodes.filter((node) => node.kind === "component");
+  const assetRefs = components.map((node) => node.assetRef).filter(Boolean);
+  return {
+    schemaId: `kloks.authored-ui.${session.sessionId}`,
+    schemaVersion: UI_AUTHORING_SCHEMA_VERSION,
+    serviceId: session.metadata.serviceId || "unknown-service",
+    requirementMode: "optional",
+    pages: pages.map((page) => ({
+      name: page.name,
+      sections: sections.filter((section) => section.parentId === page.id).map((section) => ({
+        name: section.name,
+        assetRef: section.assetRef,
+        components: components.filter((component) => component.parentId === section.id).map((component) => ({
+          name: component.name,
+          assetRef: component.assetRef,
+          description: component.props.description
+        })),
+        description: section.props.description
+      })),
+      description: page.props.description
+    })),
+    sections: sections.map((section) => ({
+      name: section.name,
+      assetRef: section.assetRef,
+      components: components.filter((component) => component.parentId === section.id).map((component) => ({
+        name: component.name,
+        assetRef: component.assetRef
+      })),
+      description: section.props.description
+    })),
+    components: components.map((component) => ({
+      name: component.name,
+      assetRef: component.assetRef,
+      description: component.props.description
+    })),
+    assetRefs,
+    operationBindings: session.bindings.map((binding) => ({
+      operationId: binding.target.apiId,
+      uiPath: binding.componentId
+    }))
+  };
+}
+
 // src/index.ts
 var KLOKS_CANONICAL_CONTRACT = {
   package: "@ultrst-armada/kloks",
@@ -407,11 +465,14 @@ export {
   SocketGeometryConfigSchema,
   SocketPosition2DSchema,
   SocketStyleConfigSchema,
+  UI_AUTHORING_SCHEMA_VERSION,
   WireAnimationConfigSchema,
   WireCurveStyleSchema,
   WireEndpoint2DSchema,
   WireVisualConfigSchema,
+  buildServiceUISchema,
   createKloksSnapshot,
   diffContractSnapshots,
+  suggestUIComponent,
   validateConsumerSurfaceCompatibility
 };

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

@@ -3,7 +3,7 @@ import { ServiceDefinition, IService, EndpointDescriptor, ProtocolAdapter } from
 import { AdminDatabaseClusterConfig, DatabaseConnectionEntry, UserStorageConnection, AuthState, UserAccount, UserRole, UserWorkspaceRecord } from '@ultrst-armada/kloks/state-graph';
 export { AuthState, UserAccount, UserRole, UserSession, UserStorageConnection, UserWorkspaceRecord } from '@ultrst-armada/kloks/state-graph';
 import * as _kloks_contracts from '@ultrst-armada/kloks/contracts';
-import { ServiceUISchema } from '@ultrst-armada/kloks/contracts';
+import { ServiceUISchema, MonacoIdeSession, UIAuthoringSession } from '@ultrst-armada/kloks/contracts';
 
 interface SystemEnvironmentStatus {
     databaseUrlConfigured: boolean;
@@ -276,6 +276,40 @@ declare const StorageServiceUISchema: ServiceUISchema;
 
 declare const SystemDbServiceUISchema: ServiceUISchema;
 
+interface MonacoState extends Record<string, unknown> {
+    sessions: Record<string, MonacoIdeSession>;
+}
+declare const MonacoIdeServiceDefinition: ServiceDefinition<MonacoState>;
+declare function createMonacoIdeService(): IService<MonacoState>;
+declare const MonacoIdeServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "client";
+    deployment: "local";
+    definition: ServiceDefinition<MonacoState, Record<string, unknown>>;
+    service: IService<MonacoState, Record<string, unknown>>;
+    createInstance: typeof createMonacoIdeService;
+    execute: <TIn = unknown, TOut = unknown>(operation: string, input?: TIn) => Promise<TOut>;
+};
+
+interface UIAuthoringState extends Record<string, unknown> {
+    sessions: Record<string, UIAuthoringSession>;
+}
+declare const UIAuthoringServiceDefinition: ServiceDefinition<UIAuthoringState>;
+declare function createUIAuthoringService(): IService<UIAuthoringState>;
+declare const UIAuthoringServiceFacade: {
+    id: string;
+    name: string;
+    version: string;
+    runtime: "client";
+    deployment: "local";
+    definition: ServiceDefinition<UIAuthoringState, Record<string, unknown>>;
+    service: IService<UIAuthoringState, Record<string, unknown>>;
+    createInstance: typeof createUIAuthoringService;
+    execute: <TIn = unknown, TOut = unknown>(operation: string, input?: TIn) => Promise<TOut>;
+};
+
 declare const AuthClientServiceDefinition: ServiceDefinition;
 declare const AuthClientServiceFacade: {
     id: string;
@@ -417,4 +451,4 @@ declare const krnlServiceDDefinition: ServiceDefinition<Record<string, unknown>,
 declare const krnlServiceDFacade: ServiceFacade<Record<string, unknown>, Record<string, unknown>>;
 declare const krnlExposeServiceD: typeof exposeServiceD;
 
-export { AuthClientServiceDefinition, AuthClientServiceFacade, type AuthListener, AuthService, AuthServiceUISchema, CLEAN_DATABASE_CLUSTER, type CounterState, DEFAULT_CONNECTIONS, type IAuthStore, type MathInput, type ProtocolExposureHandle, STORAGE_KEY_CONNECTIONS, ServiceADefinition, ServiceAFacade, ServiceBDefinition, ServiceBFacade, ServiceCDefinition, ServiceCFacade, ServiceDDefinition, ServiceDFacade, type ServiceFacade, StorageClientServiceDefinition, StorageClientServiceFacade, StorageService, StorageServiceUISchema, SystemDbClientServiceDefinition, SystemDbClientServiceFacade, SystemDbService, SystemDbServiceUISchema, type SystemEnvironmentStatus, type SystemTelemetry, type TelemetryEvents, authService, clearSession, createServiceB, createServiceC, createWorkspace, deleteWorkspace, exposeServiceD, fetchWorkspaces, krnlAuthClientServiceDefinition, krnlAuthClientServiceFacade, krnlCreateServiceB, krnlCreateServiceC, krnlExposeServiceD, krnlServiceADefinition, krnlServiceAFacade, krnlServiceBDefinition, krnlServiceBFacade, krnlServiceCDefinition, krnlServiceCFacade, krnlServiceDDefinition, krnlServiceDFacade, krnlStorageClientServiceDefinition, krnlStorageClientServiceFacade, krnlSystemDbClientServiceDefinition, krnlSystemDbClientServiceFacade, loadDatabase, loginAdmin, loginUser, persistDatabase, register, restoreSession, setActiveWorkspace, setSession, storageService, systemDbService, updateWorkspace, verifyPassword };
+export { AuthClientServiceDefinition, AuthClientServiceFacade, type AuthListener, AuthService, AuthServiceUISchema, CLEAN_DATABASE_CLUSTER, type CounterState, DEFAULT_CONNECTIONS, type IAuthStore, type MathInput, MonacoIdeServiceDefinition, MonacoIdeServiceFacade, type ProtocolExposureHandle, STORAGE_KEY_CONNECTIONS, ServiceADefinition, ServiceAFacade, ServiceBDefinition, ServiceBFacade, ServiceCDefinition, ServiceCFacade, ServiceDDefinition, ServiceDFacade, type ServiceFacade, StorageClientServiceDefinition, StorageClientServiceFacade, StorageService, StorageServiceUISchema, SystemDbClientServiceDefinition, SystemDbClientServiceFacade, SystemDbService, SystemDbServiceUISchema, type SystemEnvironmentStatus, type SystemTelemetry, type TelemetryEvents, UIAuthoringServiceDefinition, UIAuthoringServiceFacade, authService, clearSession, createMonacoIdeService, createServiceB, createServiceC, createUIAuthoringService, createWorkspace, deleteWorkspace, exposeServiceD, fetchWorkspaces, krnlAuthClientServiceDefinition, krnlAuthClientServiceFacade, krnlCreateServiceB, krnlCreateServiceC, krnlExposeServiceD, krnlServiceADefinition, krnlServiceAFacade, krnlServiceBDefinition, krnlServiceBFacade, krnlServiceCDefinition, krnlServiceCFacade, krnlServiceDDefinition, krnlServiceDFacade, krnlStorageClientServiceDefinition, krnlStorageClientServiceFacade, krnlSystemDbClientServiceDefinition, krnlSystemDbClientServiceFacade, loadDatabase, loginAdmin, loginUser, persistDatabase, register, restoreSession, setActiveWorkspace, setSession, storageService, systemDbService, updateWorkspace, verifyPassword };