@skaile/workspaces 0.20.0 → 0.22.0-beta.0

package/dist/{chunk-VVS7MACX.js → chunk-TKOLD2O7.js}

@@ -1,5 +1,5 @@
-import { scanDirectory, fromMcpServerMd } from './chunk-FRPKLIEZ.js';
-import { parseAssetRef } from './chunk-37JKX6D7.js';
+import { scanDirectory, fromMcpServerMd } from './chunk-WIR34WMU.js';
+import { parseAssetRef } from './chunk-X5Y4EGZB.js';
 import { mkdirSync, existsSync, readFileSync, writeFileSync, lstatSync, symlinkSync, rmSync, readdirSync } from 'fs';
 import { homedir } from 'os';
 import { join, resolve, parse as parse$1, dirname } from 'path';
@@ -379,7 +379,7 @@ function saveSkWorkspaceConfig(dir, config, name) {
   if (!existsSync(resolvedDir)) {
     mkdirSync(resolvedDir, { recursive: true });
   }
-  writeFileSync(filePath, stringify(config, { lineWidth: 120 }));
+  writeFileSync(filePath, encodeSkaileYaml(config));
   return filePath;
 }
 function listSkWorkspaceConfigs(dir) {
@@ -518,9 +518,29 @@ function mergeSkWorkspaceConfigs(base, overlay) {
     // dependencies: concatenate and dedupe
     dependencies: dedupe([...base.dependencies ?? [], ...overlay.dependencies ?? []]),
     // sources: dedupe by name — overlay entry wins for the same name
-    sources: dedupeByKey([...base.sources ?? [], ...overlay.sources ?? []], "name")
+    sources: dedupeByKey([...base.sources ?? [], ...overlay.sources ?? []], "name"),
+    // plugins: concatenate + dedupe (like dependencies)
+    plugins: dedupe([...base.plugins ?? [], ...overlay.plugins ?? []]),
+    // deploy: overlay wins entirely (scalar-like selection)
+    deploy: overlay.deploy ?? base.deploy
   };
 }
+var KNOWN_DRIVERS = ["omp", "claude-sdk", "codex"];
+var KNOWN_PROVIDERS = [
+  "anthropic",
+  "openai",
+  "google",
+  "mistral",
+  "groq",
+  "openrouter",
+  "deepseek",
+  "xai",
+  "together",
+  "fireworks",
+  "deepgram",
+  "elevenlabs"
+];
+var KNOWN_ACCESS = ["read-only", "read-write"];
 var AGENT_PROFILE_FIELDS = [
   "driver",
   "provider",
@@ -533,23 +553,79 @@ var AGENT_PROFILE_FIELDS = [
 ];
 function normalizeAgentConfig(raw) {
   const looksFlat = AGENT_PROFILE_FIELDS.some((f) => typeof raw[f] === "string");
-  return looksFlat ? { default: raw } : raw;
+  return looksFlat ? { profiles: { default: raw }, wrappedFlat: true } : { profiles: raw, wrappedFlat: false };
 }
 function normalizeConfig(raw) {
+  return normalizeConfigInternal(raw).config;
+}
+function normalizeConfigInternal(raw) {
   const config = {};
+  const diagnostics = [];
   if (raw.name) config.name = String(raw.name);
   if (raw.description) config.description = String(raw.description);
-  const agentConfigRaw = raw["agent-config"] ?? raw.agent_config ?? raw.agentConfig;
+  let agentConfigRaw;
+  let agentConfigKey;
+  if (raw["agent-config"] !== void 0) {
+    agentConfigRaw = raw["agent-config"];
+    agentConfigKey = "agent-config";
+  } else if (raw.agent_config !== void 0) {
+    agentConfigRaw = raw.agent_config;
+    agentConfigKey = "agent_config";
+  } else if (raw.agentConfig !== void 0) {
+    agentConfigRaw = raw.agentConfig;
+    agentConfigKey = "agentConfig";
+  }
   if (agentConfigRaw && typeof agentConfigRaw === "object" && !Array.isArray(agentConfigRaw)) {
-    config.agent_config = normalizeAgentConfig(agentConfigRaw);
+    if (agentConfigKey === "agentConfig") {
+      diagnostics.push({
+        code: "legacy_key_camelcase",
+        severity: "warning",
+        message: 'Non-canonical key "agentConfig" \u2014 use "agent-config".',
+        path: "agentConfig"
+      });
+    }
+    const { profiles, wrappedFlat } = normalizeAgentConfig(
+      agentConfigRaw
+    );
+    if (wrappedFlat) {
+      diagnostics.push({
+        code: "legacy_agent_config_flat",
+        severity: "warning",
+        message: 'Flat agent-config block wrapped as the "default" profile \u2014 nest fields under "default:".',
+        path: agentConfigKey
+      });
+    }
+    config.agent_config = profiles;
   }
   if (Array.isArray(raw.startup)) {
     config.startup = raw.startup;
   }
-  const aiResRaw = raw.ai_resources ?? raw.aiResources;
+  let aiResRaw;
+  let aiResKey;
+  if (raw.ai_resources !== void 0) {
+    aiResRaw = raw.ai_resources;
+    aiResKey = "ai_resources";
+  } else if (raw.aiResources !== void 0) {
+    aiResRaw = raw.aiResources;
+    aiResKey = "aiResources";
+  }
+  if (aiResKey === "aiResources") {
+    diagnostics.push({
+      code: "legacy_key_camelcase",
+      severity: "warning",
+      message: 'Non-canonical key "aiResources" \u2014 use "ai_resources".',
+      path: "aiResources"
+    });
+  }
   if (Array.isArray(aiResRaw)) {
     config.ai_resources = aiResRaw;
   } else if (aiResRaw && typeof aiResRaw === "object") {
+    diagnostics.push({
+      code: "legacy_ai_resources_object",
+      severity: "warning",
+      message: "Legacy ai_resources object form ({sources, requires}) \u2014 use an array of {name, path, dependencies}.",
+      path: aiResKey
+    });
     const old = aiResRaw;
     const sources = Array.isArray(old.sources) ? old.sources : [];
     const requires = Array.isArray(old.requires) ? old.requires.filter(Boolean) : [];
@@ -574,11 +650,28 @@ function normalizeConfig(raw) {
   if (Array.isArray(raw.mcp_servers)) {
     config.mcp_servers = raw.mcp_servers;
   }
+  if (Array.isArray(raw.plugins)) {
+    const specs = raw.plugins.filter((p) => typeof p === "string" && p.length > 0);
+    if (specs.length > 0) config.plugins = specs;
+  }
+  if (raw.deploy && typeof raw.deploy === "object" && !Array.isArray(raw.deploy)) {
+    const d = raw.deploy;
+    if (typeof d.target === "string" && d.target.length > 0) {
+      config.deploy = { target: d.target };
+      if (d.config !== void 0) config.deploy.config = d.config;
+    }
+  }
   if (raw.agent) config.agent = raw.agent;
   if (raw.workspace) config.workspace = raw.workspace;
   if (raw.secrets && typeof raw.secrets === "object") {
     config.secrets = raw.secrets;
   }
+  if (raw.compaction && typeof raw.compaction === "object" && !Array.isArray(raw.compaction)) {
+    config.compaction = raw.compaction;
+  }
+  if (raw.patches && typeof raw.patches === "object" && !Array.isArray(raw.patches)) {
+    config.patches = raw.patches;
+  }
   if (Array.isArray(raw.dependencies)) {
     config.dependencies = raw.dependencies.filter((d) => typeof d === "string");
   }
@@ -599,7 +692,112 @@ function normalizeConfig(raw) {
   if (raw.telemetry && typeof raw.telemetry === "object" && !Array.isArray(raw.telemetry)) {
     config.telemetry = raw.telemetry;
   }
-  return config;
+  return { config, diagnostics };
+}
+function decodeSkaileYaml(text) {
+  let parsed;
+  try {
+    parsed = parse(text) ?? {};
+  } catch (err) {
+    return {
+      config: {},
+      diagnostics: [
+        {
+          code: "yaml_syntax",
+          severity: "error",
+          message: `Invalid YAML: ${err instanceof Error ? err.message : String(err)}`
+        }
+      ]
+    };
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return {
+      config: {},
+      diagnostics: [
+        {
+          code: "non_object_root",
+          severity: "error",
+          message: "skaile.yaml must be a mapping at the top level."
+        }
+      ]
+    };
+  }
+  const result = normalizeConfigInternal(parsed);
+  validateConfigValues(result.config, result.diagnostics);
+  return result;
+}
+function encodeSkaileYaml(config) {
+  return stringify(toCanonicalObject(config), { lineWidth: 120 });
+}
+function validateConfigValues(config, diagnostics) {
+  for (const [profile, p] of Object.entries(config.agent_config ?? {})) {
+    if (p?.driver && !KNOWN_DRIVERS.includes(p.driver)) {
+      diagnostics.push({
+        code: "unknown_driver",
+        severity: "warning",
+        message: `Unknown driver "${p.driver}" \u2014 expected one of: ${KNOWN_DRIVERS.join(", ")}.`,
+        path: `agent-config.${profile}.driver`
+      });
+    }
+    if (p?.provider && !KNOWN_PROVIDERS.includes(p.provider)) {
+      diagnostics.push({
+        code: "unknown_provider",
+        severity: "warning",
+        message: `Unknown provider "${p.provider}" \u2014 expected one of: ${KNOWN_PROVIDERS.join(", ")}.`,
+        path: `agent-config.${profile}.provider`
+      });
+    }
+  }
+  const checkAccess = (access, path) => {
+    if (access && !KNOWN_ACCESS.includes(access)) {
+      diagnostics.push({
+        code: "unknown_access",
+        severity: "warning",
+        message: `Unknown access "${access}" \u2014 expected "read-only" or "read-write".`,
+        path
+      });
+    }
+  };
+  for (const c of config.connectors ?? []) checkAccess(c.access, `connectors.${c.id}.access`);
+  for (const m of config.mounts ?? []) checkAccess(m.access, `mounts.${m.id}.access`);
+}
+var CANONICAL_KEY_ORDER = [
+  "name",
+  "description",
+  "agent_config",
+  "dependencies",
+  "plugins",
+  "sources",
+  "startup",
+  "ai_resources",
+  "connectors",
+  "mcp_servers",
+  "deploy",
+  "mounts",
+  "agent",
+  "workspace",
+  "secrets",
+  "telemetry",
+  "compaction",
+  "patches",
+  "repositories"
+];
+var CONFIG_KEY_TO_YAML = {
+  agent_config: "agent-config"
+};
+function toCanonicalObject(config) {
+  const out = {};
+  const emit = (key) => {
+    const value = config[key];
+    if (value === void 0) return;
+    out[CONFIG_KEY_TO_YAML[key] ?? key] = value;
+  };
+  for (const key of CANONICAL_KEY_ORDER) emit(key);
+  for (const key of Object.keys(config)) {
+    if (CANONICAL_KEY_ORDER.includes(key)) continue;
+    emit(key);
+  }
+  return out;
 }
 function parseConfigFile(filePath, name) {
   let raw;
@@ -608,14 +806,9 @@ function parseConfigFile(filePath, name) {
   } catch {
     return null;
   }
-  let parsed;
-  try {
-    parsed = parse(raw) ?? {};
-  } catch {
-    return null;
-  }
-  const config = normalizeConfig(parsed);
-  return { path: filePath, name, config };
+  const { config, diagnostics } = decodeSkaileYaml(raw);
+  if (diagnostics.some((d) => d.code === "yaml_syntax")) return null;
+  return { path: filePath, name, config, diagnostics };
 }
 function dedupe(arr) {
   return [...new Set(arr)];
@@ -828,6 +1021,6 @@ function resolveAgentDir(projectDir) {
   return resolve(projectDir, definition);
 }
 
-export { COMPACTION_DEFAULTS, SKAILE_YAML_DEFAULT, SKAILE_YAML_SUFFIX, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, checkRepoStatus, checkoutPin, cloneRepo, ensureRepo, findWorkspaceRoot, getGlobalCacheDir, getRepoCommit, isWorkspaceConfigFilename, linkRepo, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, mergeSkWorkspaceConfigs, normalizeConfig, pullRepo, readLinks, resolveAgentDir, resolveAll, resolveAsset, resolveSkWorkspaceConfig, saveSkWorkspaceConfig, scanRepo, unlinkRepo, validateAssetRecipeAttr, workspaceConfigFilename, workspaceNameFromFilename, writeLinks };
-//# sourceMappingURL=chunk-VVS7MACX.js.map
-//# sourceMappingURL=chunk-VVS7MACX.js.map
+export { COMPACTION_DEFAULTS, SKAILE_YAML_DEFAULT, SKAILE_YAML_SUFFIX, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, checkRepoStatus, checkoutPin, cloneRepo, decodeSkaileYaml, encodeSkaileYaml, ensureRepo, findWorkspaceRoot, getGlobalCacheDir, getRepoCommit, isWorkspaceConfigFilename, linkRepo, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, mergeSkWorkspaceConfigs, normalizeConfig, pullRepo, readLinks, resolveAgentDir, resolveAll, resolveAsset, resolveSkWorkspaceConfig, saveSkWorkspaceConfig, scanRepo, unlinkRepo, validateAssetRecipeAttr, workspaceConfigFilename, workspaceNameFromFilename, writeLinks };
+//# sourceMappingURL=chunk-TKOLD2O7.js.map
+//# sourceMappingURL=chunk-TKOLD2O7.js.map