@agents-inc/cli 0.86.0 → 0.88.0

package/dist/chunk-O5ZWS26C.js

@@ -1,166 +0,0 @@
-#!/usr/bin/env node
-import {
-  IMPORT_DEFAULTS,
-  computeFileHash,
-  fetchFromSource,
-  getCurrentDate
-} from "./chunk-TMTUTUEV.js";
-import {
-  copy,
-  ensureDir,
-  fileExists,
-  importedSkillMetadataSchema,
-  listDirectories,
-  readFile,
-  warn,
-  writeFile
-} from "./chunk-NUU3U43A.js";
-import {
-  GITHUB_SOURCE,
-  STANDARD_FILES,
-  YAML_FORMATTING
-} from "./chunk-6PGL2XMY.js";
-import {
-  init_esm_shims
-} from "./chunk-DHET7RCE.js";
-
-// src/cli/lib/operations/import-skill.ts
-init_esm_shims();
-import path from "path";
-import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-function parseGitHubSource(source) {
-  if (source.startsWith(GITHUB_SOURCE.HTTPS_PREFIX)) {
-    const path2 = source.replace(GITHUB_SOURCE.HTTPS_PREFIX, "");
-    return {
-      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${path2}`,
-      displaySource: source
-    };
-  }
-  if (source.startsWith(GITHUB_SOURCE.GITHUB_PREFIX) || source.startsWith(GITHUB_SOURCE.GH_PREFIX)) {
-    const normalized = source.startsWith(GITHUB_SOURCE.GH_PREFIX) ? GITHUB_SOURCE.GITHUB_PREFIX + source.slice(GITHUB_SOURCE.GH_PREFIX.length) : source;
-    return {
-      gigetSource: normalized,
-      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${normalized.replace(GITHUB_SOURCE.GITHUB_PREFIX, "")}`
-    };
-  }
-  if (source.includes("/") && !source.includes(":")) {
-    return {
-      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${source}`,
-      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${source}`
-    };
-  }
-  return {
-    gigetSource: source,
-    displaySource: source
-  };
-}
-async function fetchSkillSource(options) {
-  const result = await fetchFromSource(options.gigetSource, {
-    forceRefresh: options.forceRefresh
-  });
-  return { path: result.path, fromCache: result.fromCache };
-}
-async function discoverValidSkills(skillsDir) {
-  const skillDirs = await listDirectories(skillsDir);
-  const validSkills = [];
-  for (const skillDir of skillDirs) {
-    const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);
-    if (await fileExists(skillMdPath)) {
-      validSkills.push(skillDir);
-    }
-  }
-  return validSkills.sort();
-}
-async function importSkillFromSource(options) {
-  const { sourcePath, destPath, skillName, displaySource } = options;
-  const skillMdPath = path.join(sourcePath, STANDARD_FILES.SKILL_MD);
-  if (!await fileExists(skillMdPath)) {
-    throw new Error(
-      `Missing required SKILL.md file at ${skillMdPath}
-Every skill must have a SKILL.md file containing the skill's prompt content.
-Create one with:
-  echo "# ${skillName}" > ${path.join(sourcePath, STANDARD_FILES.SKILL_MD)}`
-    );
-  }
-  const contentHash = await computeFileHash(skillMdPath);
-  await ensureDir(path.dirname(destPath));
-  await copy(sourcePath, destPath);
-  await injectImportedForkedFromMetadata(destPath, skillName, displaySource, contentHash);
-}
-async function injectImportedForkedFromMetadata(destPath, skillName, source, contentHash) {
-  const metadataYamlPath = path.join(destPath, STANDARD_FILES.METADATA_YAML);
-  const metadataJsonPath = path.join(destPath, STANDARD_FILES.METADATA_JSON);
-  const forkedFrom = {
-    source,
-    skillName,
-    contentHash,
-    date: getCurrentDate()
-  };
-  if (await fileExists(metadataYamlPath)) {
-    const rawContent = await readFile(metadataYamlPath);
-    const lines = rawContent.split("\n");
-    let yamlContent2 = rawContent;
-    let schemaComment = "";
-    if (lines[0]?.startsWith("# yaml-language-server:")) {
-      schemaComment = `${lines[0]}
-`;
-      yamlContent2 = lines.slice(1).join("\n");
-    }
-    const raw = parseYaml(yamlContent2);
-    const parseResult = importedSkillMetadataSchema.safeParse(raw);
-    if (!parseResult.success) {
-      warn(
-        `Malformed metadata.yaml at ${metadataYamlPath} \u2014 existing fields may be lost
-  Validation errors: ${parseResult.error.issues.map((i) => i.message).join(", ")}
-  Expected fields: displayName (string), cliDescription (string), category (string)
-  Validate your YAML syntax at https://yamllint.com`
-      );
-    }
-    const metadata = parseResult.success ? parseResult.data : { forkedFrom: void 0 };
-    metadata.forkedFrom = forkedFrom;
-    const newYamlContent = stringifyYaml(metadata, {
-      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
-    });
-    await writeFile(metadataYamlPath, schemaComment + newYamlContent);
-    return;
-  }
-  if (await fileExists(metadataJsonPath)) {
-    const rawContent = await readFile(metadataJsonPath);
-    let jsonParsed;
-    try {
-      jsonParsed = JSON.parse(rawContent);
-    } catch {
-      warn(
-        `Malformed JSON in ${metadataJsonPath} \u2014 skipping metadata injection
-  Common issues: trailing commas, unquoted keys, single quotes instead of double quotes
-  Validate your JSON at https://jsonlint.com`
-      );
-      return;
-    }
-    const jsonResult = importedSkillMetadataSchema.safeParse(jsonParsed);
-    const metadata = jsonResult.success ? jsonResult.data : { forkedFrom: void 0 };
-    metadata.forkedFrom = forkedFrom;
-    const yamlContent2 = stringifyYaml(metadata, { lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE });
-    await writeFile(metadataYamlPath, yamlContent2);
-    return;
-  }
-  const minimalMetadata = {
-    displayName: skillName.split("-").map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" "),
-    cliDescription: "Imported from third-party repository",
-    category: IMPORT_DEFAULTS.CATEGORY,
-    author: IMPORT_DEFAULTS.AUTHOR,
-    forkedFrom
-  };
-  const yamlContent = stringifyYaml(minimalMetadata, {
-    lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE
-  });
-  await writeFile(metadataYamlPath, yamlContent);
-}
-
-export {
-  parseGitHubSource,
-  fetchSkillSource,
-  discoverValidSkills,
-  importSkillFromSource
-};
-//# sourceMappingURL=chunk-O5ZWS26C.js.map

package/dist/chunk-O5ZWS26C.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/cli/lib/operations/import-skill.ts"],"sourcesContent":["import path from \"path\";\nimport { parse as parseYaml, stringify as stringifyYaml } from \"yaml\";\nimport { fetchFromSource } from \"../loading/index.js\";\nimport { importedSkillMetadataSchema } from \"../schemas.js\";\nimport { getCurrentDate, computeFileHash } from \"../versioning.js\";\nimport {\n  copy,\n  fileExists,\n  listDirectories,\n  readFile,\n  writeFile,\n  ensureDir,\n} from \"../../utils/fs.js\";\nimport { warn } from \"../../utils/logger.js\";\nimport { GITHUB_SOURCE, STANDARD_FILES, YAML_FORMATTING } from \"../../consts.js\";\nimport { IMPORT_DEFAULTS } from \"../metadata-keys.js\";\n\n/**\n * Metadata for tracking third-party imports. Different from ForkedFromMetadata\n * in skill-metadata.ts which tracks internal fork lineage (uses skillId\n * instead of source/skillName).\n */\nexport type ImportedForkedFromMetadata = {\n  source: string;\n  skillName: string;\n  contentHash: string;\n  date: string;\n};\n\ntype SkillMetadata = {\n  forkedFrom?: ImportedForkedFromMetadata;\n  [key: string]: unknown;\n};\n\nexport type ParsedGitHubSource = {\n  gigetSource: string;\n  displaySource: string;\n};\n\nexport type FetchSourceOptions = {\n  gigetSource: string;\n  forceRefresh?: boolean;\n};\n\nexport type FetchedSource = {\n  path: string;\n  fromCache: boolean;\n};\n\nexport type ImportSkillOptions = {\n  sourcePath: string;\n  destPath: string;\n  skillName: string;\n  displaySource: string;\n};\n\nexport type ImportSkillResult = {\n  imported: string[];\n  skipped: string[];\n  errors: Array<{ skillName: string; error: string }>;\n};\n\n/**\n * Parses various GitHub URL formats into a normalized giget source string\n * and a human-readable display URL.\n *\n * Supports: `https://github.com/owner/repo`, `github:owner/repo`,\n * `gh:owner/repo`, and bare `owner/repo` formats.\n */\nexport function parseGitHubSource(source: string): ParsedGitHubSource {\n  if (source.startsWith(GITHUB_SOURCE.HTTPS_PREFIX)) {\n    const path = source.replace(GITHUB_SOURCE.HTTPS_PREFIX, \"\");\n    return {\n      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${path}`,\n      displaySource: source,\n    };\n  }\n\n  if (\n    source.startsWith(GITHUB_SOURCE.GITHUB_PREFIX) ||\n    source.startsWith(GITHUB_SOURCE.GH_PREFIX)\n  ) {\n    const normalized = source.startsWith(GITHUB_SOURCE.GH_PREFIX)\n      ? GITHUB_SOURCE.GITHUB_PREFIX + source.slice(GITHUB_SOURCE.GH_PREFIX.length)\n      : source;\n    return {\n      gigetSource: normalized,\n      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${normalized.replace(GITHUB_SOURCE.GITHUB_PREFIX, \"\")}`,\n    };\n  }\n\n  if (source.includes(\"/\") && !source.includes(\":\")) {\n    return {\n      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${source}`,\n      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${source}`,\n    };\n  }\n\n  return {\n    gigetSource: source,\n    displaySource: source,\n  };\n}\n\n/**\n * Fetches a source repository using giget. Wraps `fetchFromSource` from the\n * loading layer.\n */\nexport async function fetchSkillSource(options: FetchSourceOptions): Promise<FetchedSource> {\n  const result = await fetchFromSource(options.gigetSource, {\n    forceRefresh: options.forceRefresh,\n  });\n  return { path: result.path, fromCache: result.fromCache };\n}\n\n/**\n * Discovers valid skill directories within a source path by checking\n * for the presence of SKILL.md files.\n *\n * @returns Sorted list of directory names that contain a SKILL.md file.\n */\nexport async function discoverValidSkills(skillsDir: string): Promise<string[]> {\n  const skillDirs = await listDirectories(skillsDir);\n  const validSkills: string[] = [];\n\n  for (const skillDir of skillDirs) {\n    const skillMdPath = path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD);\n    if (await fileExists(skillMdPath)) {\n      validSkills.push(skillDir);\n    }\n  }\n\n  return validSkills.sort();\n}\n\n/**\n * Imports a single skill from a source directory into the destination.\n *\n * Validates that the source skill has a SKILL.md file, copies the directory,\n * and injects `forkedFrom` metadata into the destination's metadata.yaml.\n *\n * @throws {Error} If the source skill is missing a SKILL.md file.\n */\nexport async function importSkillFromSource(options: ImportSkillOptions): Promise<void> {\n  const { sourcePath, destPath, skillName, displaySource } = options;\n  const skillMdPath = path.join(sourcePath, STANDARD_FILES.SKILL_MD);\n\n  if (!(await fileExists(skillMdPath))) {\n    throw new Error(\n      `Missing required SKILL.md file at ${skillMdPath}\\n` +\n        `Every skill must have a SKILL.md file containing the skill's prompt content.\\n` +\n        `Create one with:\\n` +\n        `  echo \"# ${skillName}\" > ${path.join(sourcePath, STANDARD_FILES.SKILL_MD)}`,\n    );\n  }\n\n  const contentHash = await computeFileHash(skillMdPath);\n\n  await ensureDir(path.dirname(destPath));\n  await copy(sourcePath, destPath);\n\n  await injectImportedForkedFromMetadata(destPath, skillName, displaySource, contentHash);\n}\n\n/**\n * Injects `forkedFrom` metadata into a third-party imported skill's metadata.yaml.\n *\n * Handles three cases:\n * 1. Existing metadata.yaml — preserves fields, adds/overwrites forkedFrom\n * 2. Existing metadata.json — converts to YAML, adds forkedFrom\n * 3. No metadata file — creates minimal metadata.yaml with forkedFrom\n *\n * @remarks\n * Different from `injectForkedFromMetadata` in `skill-metadata.ts` which tracks\n * internal marketplace fork lineage using `skillId`. This function tracks\n * third-party imports using `source` + `skillName`.\n */\nasync function injectImportedForkedFromMetadata(\n  destPath: string,\n  skillName: string,\n  source: string,\n  contentHash: string,\n): Promise<void> {\n  const metadataYamlPath = path.join(destPath, STANDARD_FILES.METADATA_YAML);\n  const metadataJsonPath = path.join(destPath, STANDARD_FILES.METADATA_JSON);\n\n  const forkedFrom: ImportedForkedFromMetadata = {\n    source,\n    skillName,\n    contentHash,\n    date: getCurrentDate(),\n  };\n\n  if (await fileExists(metadataYamlPath)) {\n    const rawContent = await readFile(metadataYamlPath);\n    const lines = rawContent.split(\"\\n\");\n    let yamlContent = rawContent;\n    let schemaComment = \"\";\n\n    if (lines[0]?.startsWith(\"# yaml-language-server:\")) {\n      schemaComment = `${lines[0]}\\n`;\n      yamlContent = lines.slice(1).join(\"\\n\");\n    }\n\n    const raw = parseYaml(yamlContent);\n    const parseResult = importedSkillMetadataSchema.safeParse(raw);\n    if (!parseResult.success) {\n      warn(\n        `Malformed metadata.yaml at ${metadataYamlPath} — existing fields may be lost\\n` +\n          `  Validation errors: ${parseResult.error.issues.map((i) => i.message).join(\", \")}\\n` +\n          `  Expected fields: displayName (string), cliDescription (string), category (string)\\n` +\n          `  Validate your YAML syntax at https://yamllint.com`,\n      );\n    }\n    const metadata = parseResult.success\n      ? (parseResult.data as SkillMetadata)\n      : { forkedFrom: undefined };\n    metadata.forkedFrom = forkedFrom;\n\n    const newYamlContent = stringifyYaml(metadata, {\n      lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE,\n    });\n    await writeFile(metadataYamlPath, schemaComment + newYamlContent);\n    return;\n  }\n\n  if (await fileExists(metadataJsonPath)) {\n    const rawContent = await readFile(metadataJsonPath);\n    let jsonParsed: unknown;\n    try {\n      jsonParsed = JSON.parse(rawContent);\n    } catch {\n      warn(\n        `Malformed JSON in ${metadataJsonPath} — skipping metadata injection\\n` +\n          `  Common issues: trailing commas, unquoted keys, single quotes instead of double quotes\\n` +\n          `  Validate your JSON at https://jsonlint.com`,\n      );\n      return;\n    }\n    const jsonResult = importedSkillMetadataSchema.safeParse(jsonParsed);\n    const metadata = jsonResult.success\n      ? (jsonResult.data as SkillMetadata)\n      : { forkedFrom: undefined };\n    metadata.forkedFrom = forkedFrom;\n\n    const yamlContent = stringifyYaml(metadata, { lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE });\n    await writeFile(metadataYamlPath, yamlContent);\n    return;\n  }\n\n  const minimalMetadata: SkillMetadata = {\n    displayName: skillName\n      .split(\"-\")\n      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n      .join(\" \"),\n    cliDescription: \"Imported from third-party repository\",\n    category: IMPORT_DEFAULTS.CATEGORY,\n    author: IMPORT_DEFAULTS.AUTHOR,\n    forkedFrom,\n  };\n\n  const yamlContent = stringifyYaml(minimalMetadata, {\n    lineWidth: YAML_FORMATTING.LINE_WIDTH_NONE,\n  });\n  await writeFile(metadataYamlPath, yamlContent);\n}\n"],"mappings":"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","names":["path","yamlContent"]}