@skaile/workspaces 4.15.0 → 4.16.1

package/dist/{chunk-QWGSKDD7.js → chunk-DF7C3KZK.js}

@@ -3,7 +3,7 @@ import { decodeSkaileManifest, SKAILE_MANIFEST_FILENAME } from './chunk-P4VHQA4N
 import { scanDirectory, parseFrontmatter, bundleDepRefs, fromMcpServerMdContent, withFsDeadline, tryWithFsDeadline, fsDeadlineMs } from './chunk-2FBPAR2V.js';
 import { isValidAssetName, slugifyAssetName, parseAssetRef, assetRefToStr } from './chunk-GEEW6SY2.js';
 import { isRetentionValue } from './chunk-C3CAXQMA.js';
-import { existsSync, mkdirSync, renameSync, readdirSync, rmdirSync, readFileSync, writeFileSync, lstatSync, symlinkSync, rmSync, constants } from 'fs';
+import { existsSync, mkdirSync, renameSync, readdirSync, rmdirSync, readFileSync, writeFileSync, lstatSync, symlinkSync, rmSync, constants, statSync } from 'fs';
 import { readdir, stat, cp, rm, open, readFile } from 'fs/promises';
 import { homedir } from 'os';
 import { join, dirname, relative, resolve, parse as parse$1, basename, sep } from 'path';
@@ -2163,6 +2163,117 @@ function findAiAssetsDir(from) {
   }
   return void 0;
 }
+var AGENT_MANIFEST_FILE = "agent.yaml";
+var AI_ASSETS_AGENT_WALK_DEPTH = 6;
+var AgentRefResolutionError = class extends Error {
+  code;
+  /** The raw `agent.definition` value. */
+  definition;
+  /** Agent trees searched, in precedence order (empty for `invalid_ref`). */
+  searched;
+  /** Directories declaring the name (`ambiguous` only). */
+  matches;
+  constructor(code, definition, message, searched = [], matches = []) {
+    super(message);
+    this.name = "AgentRefResolutionError";
+    this.code = code;
+    this.definition = definition;
+    this.searched = searched;
+    this.matches = matches;
+  }
+};
+function agentRefName(definition) {
+  let canonicalError;
+  try {
+    return parseAssetRef(definition).name;
+  } catch (err) {
+    canonicalError = err instanceof Error ? err.message : String(err);
+  }
+  const bare = /^agent:([\w.-]+)$/.exec(definition.trim());
+  if (bare) return bare[1];
+  throw new AgentRefResolutionError(
+    "invalid_ref",
+    definition,
+    `agent.definition "${definition}" is not a valid agent reference \u2014 use \`agent:@<publisher>/<name>[#pin]\` or \`agent:<name>\` (${canonicalError})`
+  );
+}
+function declaredAgentName(manifestPath) {
+  let raw;
+  try {
+    raw = readFileSync(manifestPath, "utf-8");
+  } catch {
+    return void 0;
+  }
+  try {
+    const doc = parse(raw);
+    return typeof doc?.name === "string" ? doc.name : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function agentSearchSubdirs(dir) {
+  let entries;
+  try {
+    entries = readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+  const result = [];
+  for (const entry of entries) {
+    if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      result.push(full);
+    } else if (entry.isSymbolicLink()) {
+      try {
+        if (statSync(full).isDirectory()) result.push(full);
+      } catch {
+      }
+    }
+  }
+  return result.sort();
+}
+function findAgentDirsByName(root, name, depth) {
+  const matches = [];
+  const visit = (dir, remaining) => {
+    if (remaining === 0) return;
+    for (const child of agentSearchSubdirs(dir)) {
+      if (declaredAgentName(join(child, AGENT_MANIFEST_FILE)) === name) matches.push(child);
+      visit(child, remaining - 1);
+    }
+  };
+  visit(root, depth);
+  return matches;
+}
+function resolveAgentRef(projectDir, definition) {
+  const name = agentRefName(definition);
+  const trees = [
+    { root: join(projectDir, ".skaile", "assets", "agent"), depth: 1 },
+    { root: join(projectDir, "agents"), depth: 1 }
+  ];
+  const aiAssetsDir = findAiAssetsDir(projectDir);
+  if (aiAssetsDir) trees.push({ root: aiAssetsDir, depth: AI_ASSETS_AGENT_WALK_DEPTH });
+  const searched = trees.map((t) => t.root);
+  for (const { root, depth } of trees) {
+    const matches = findAgentDirsByName(root, name, depth);
+    if (matches.length === 1) return matches[0];
+    if (matches.length > 1) {
+      throw new AgentRefResolutionError(
+        "ambiguous",
+        definition,
+        `agent.definition "${definition}": ${matches.length} agent.yaml files under ${root} declare name "${name}": ${matches.join(", ")}`,
+        searched,
+        matches
+      );
+    }
+  }
+  throw new AgentRefResolutionError(
+    "not_found",
+    definition,
+    `agent.definition "${definition}": no agent.yaml declaring name "${name}" in ${searched.join(", ")}${aiAssetsDir ? "" : " (no ai-assets/ directory above the project)"}`,
+    searched
+  );
+}
 function resolveAgentDir(projectDir) {
   const config = resolveSkWorkspaceConfig(projectDir);
   const definition = config.agent?.definition;
@@ -2174,11 +2285,11 @@ function resolveAgentDir(projectDir) {
     return join(aiAssetsDir, relPath);
   }
   if (definition.startsWith("agent:")) {
-    return void 0;
+    return resolveAgentRef(projectDir, definition);
   }
   return resolve(projectDir, definition);
 }
 
-export { COMPACTION_DEFAULTS, CanonicalRefConflictError, DEFAULT_RECIPE_ATTR, SKAILE_YAML_DEFAULT, SKAILE_YAML_SUFFIX, SKILL_ALLOWLIST_FILE, SKILL_ALLOWLIST_VERSION, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, STAGED_SKILL_MARKER, __resetCacheMigrationMemo, buildProvenanceIndex, checkRepoStatus, checkoutPin, cloneRepo, coerceVersion, decodeSkaileYaml, deriveSingleMaterializedMcpDeclaration, encodeSkaileYaml, ensureRepo, findWorkspaceRoot, getGlobalCacheDir, getRepoCommit, globalCacheRoot, globalSkaileDir, isStagedSkillMarkerFor, isWorkspaceConfigFilename, linkRepo, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, matchPin, mergeLegacyEntriesInto, mergeLegacyEntriesKeyed, mergeSkWorkspaceConfigs, migrateLegacyDir, normalizeConfig, pullRepo, pullRepoResult, readLinks, readSkillAllowList, resolveAgentDir, resolveAll, resolveAsset, resolveCompactionThresholdPercent, resolveGlobalBackends, resolveGlobalSkWorkspaceConfig, resolveSkWorkspaceConfig, resolveSourcePublisher, saveSkWorkspaceConfig, scanRepo, sourceCacheKey, sourceShortName, stageMaterializedSkills, stagedSkillMarkerState, storeManifestSlug, unlinkRepo, unstageSkill, validateAssetRecipeAttr, validateAssetRecipeFlake, workspaceConfigFilename, workspaceNameFromFilename, writeLinks };
-//# sourceMappingURL=chunk-QWGSKDD7.js.map
-//# sourceMappingURL=chunk-QWGSKDD7.js.map
+export { AgentRefResolutionError, COMPACTION_DEFAULTS, CanonicalRefConflictError, DEFAULT_RECIPE_ATTR, SKAILE_YAML_DEFAULT, SKAILE_YAML_SUFFIX, SKILL_ALLOWLIST_FILE, SKILL_ALLOWLIST_VERSION, SK_WORKSPACE_DEFAULT_NAME, SK_WORKSPACE_SUFFIX, STAGED_SKILL_MARKER, __resetCacheMigrationMemo, buildProvenanceIndex, checkRepoStatus, checkoutPin, cloneRepo, coerceVersion, decodeSkaileYaml, deriveSingleMaterializedMcpDeclaration, encodeSkaileYaml, ensureRepo, findWorkspaceRoot, getGlobalCacheDir, getRepoCommit, globalCacheRoot, globalSkaileDir, isStagedSkillMarkerFor, isWorkspaceConfigFilename, linkRepo, listSkWorkspaceConfigs, loadMcpServerDeclarations, loadSkWorkspaceConfig, matchPin, mergeLegacyEntriesInto, mergeLegacyEntriesKeyed, mergeSkWorkspaceConfigs, migrateLegacyDir, normalizeConfig, pullRepo, pullRepoResult, readLinks, readSkillAllowList, resolveAgentDir, resolveAll, resolveAsset, resolveCompactionThresholdPercent, resolveGlobalBackends, resolveGlobalSkWorkspaceConfig, resolveSkWorkspaceConfig, resolveSourcePublisher, saveSkWorkspaceConfig, scanRepo, sourceCacheKey, sourceShortName, stageMaterializedSkills, stagedSkillMarkerState, storeManifestSlug, unlinkRepo, unstageSkill, validateAssetRecipeAttr, validateAssetRecipeFlake, workspaceConfigFilename, workspaceNameFromFilename, writeLinks };
+//# sourceMappingURL=chunk-DF7C3KZK.js.map
+//# sourceMappingURL=chunk-DF7C3KZK.js.map