@xopcai/xopc 0.0.29 → 0.0.31

package/dist/src/agent/skills/skill-view-path.js

@@ -1,8 +1,13 @@
-import { resolve, sep } from "path";
-import { existsSync, realpathSync } from "fs";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
+import { parseSkillToolConditions } from "./skill-tool-gating.js";
+import { parseRequiredEnvVarNames } from "./required-env-vars.js";
+import { parseSkillMetadata } from "./parse-skill-metadata.js";
+import { join, resolve, sep } from "path";
+import { existsSync, readFileSync, realpathSync } from "fs";
 //#region src/agent/skills/skill-view-path.ts
 /**
 * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.
+* Also provides localized SKILL.md resolution for multi-language display.
 */
 const ALLOWED_TOP = new Set([
 	"references",
@@ -66,7 +71,65 @@ function resolveSkillReadablePath(skill, subPath) {
 		};
 	}
 }
+/**
+* Resolve a localized SKILL.md for display (e.g. SKILL-zh.md, SKILL-en.md).
+* Falls back to the base SKILL.md content if no localized file exists.
+*
+* This is the **display** path — execution always reads the base SKILL.md.
+*/
+function resolveLocalizedSkillMarkdown(skill, lang) {
+	if (!lang) return null;
+	const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();
+	if (!normalizedLang || normalizedLang === "en") return null;
+	const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);
+	if (!existsSync(localizedPath)) return null;
+	try {
+		const { frontmatter, content } = parseFrontmatter(readFileSync(localizedPath, "utf-8"));
+		const fm = frontmatter;
+		const name = typeof fm.name === "string" && fm.name.trim() || skill.name;
+		const description = (typeof fm.description === "string" ? fm.description.trim() : "") || skill.description;
+		const metadata = parseSkillMetadata(fm);
+		if (!metadata.name.trim()) metadata.name = name;
+		if (!metadata.description.trim()) metadata.description = description;
+		const toolConditions = parseSkillToolConditions(fm);
+		const requiredEnvVarNames = parseRequiredEnvVarNames(fm);
+		return {
+			name,
+			description,
+			bodyMarkdown: content.trim(),
+			disableModelInvocation: skill.disableModelInvocation,
+			metadata,
+			toolConditions,
+			requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : void 0
+		};
+	} catch {
+		return null;
+	}
+}
+/**
+* Lightweight localized name/description lookup (frontmatter only) for list views.
+* Reuses the same SKILL-{lang}.md resolution as {@link resolveLocalizedSkillMarkdown}.
+*/
+function resolveLocalizedSkillMeta(skill, lang) {
+	const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();
+	if (!normalizedLang || normalizedLang === "en") return null;
+	const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);
+	if (!existsSync(localizedPath)) return null;
+	try {
+		const { frontmatter } = parseFrontmatter(readFileSync(localizedPath, "utf-8"));
+		const fm = frontmatter;
+		const name = typeof fm.name === "string" && fm.name.trim() ? fm.name.trim() : void 0;
+		const description = typeof fm.description === "string" && fm.description.trim() ? fm.description.trim() : void 0;
+		if (!name && !description) return null;
+		return {
+			name: name ?? skill.name,
+			description: description ?? skill.description
+		};
+	} catch {
+		return null;
+	}
+}
 //#endregion
-export { resolveSkillReadablePath };
+export { resolveLocalizedSkillMarkdown, resolveLocalizedSkillMeta, resolveSkillReadablePath };
 
 //# sourceMappingURL=skill-view-path.js.map

package/dist/src/agent/skills/skill-view-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-view-path.js","names":[],"sources":["../../../../src/agent/skills/skill-view-path.ts"],"sourcesContent":["/**\n * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.\n */\n\nimport { existsSync, realpathSync } from 'fs';\nimport { resolve, sep } from 'path';\n\nimport type { Skill } from './types.js';\n\nconst ALLOWED_TOP = new Set(['references', 'templates', 'scripts', 'assets']);\n\nexport type ResolveSkillFileResult =\n  | { ok: true; absolutePath: string }\n  | { ok: false; error: string };\n\nfunction isSkillMdSegment(p: string): boolean {\n  const s = p.trim();\n  return s === 'SKILL.md' || s.toLowerCase() === 'skill.md';\n}\n\nfunction isInsideDir(dirReal: string, fileReal: string): boolean {\n  const prefix = dirReal.endsWith(sep) ? dirReal : dirReal + sep;\n  return fileReal === dirReal || fileReal.startsWith(prefix);\n}\n\n/**\n * Resolve a readable file path for {@link skill}. Empty or SKILL.md → main SKILL.md file.\n * Other paths must live under references/, templates/, scripts/, or assets/.\n */\nexport function resolveSkillReadablePath(\n  skill: Skill,\n  subPath: string | undefined,\n): ResolveSkillFileResult {\n  const base = skill.baseDir;\n  const trimmed = subPath?.trim() ?? '';\n\n  let target: string;\n  if (!trimmed || trimmed === '.' || isSkillMdSegment(trimmed)) {\n    target = skill.filePath;\n  } else {\n    const norm = trimmed.replace(/\\\\/g, '/');\n    if (norm.includes('..')) {\n      return { ok: false, error: 'Invalid path: path traversal is not allowed.' };\n    }\n    if (norm.startsWith('/') || /^[A-Za-z]:/.test(norm)) {\n      return {\n        ok: false,\n        error: 'Invalid path: use a path relative to the skill directory.',\n      };\n    }\n    const first = norm.split('/').filter(Boolean)[0] ?? '';\n    if (!ALLOWED_TOP.has(first)) {\n      return {\n        ok: false,\n        error: `Invalid path: must be under references/, templates/, scripts/, or assets/ (or omit path for SKILL.md).`,\n      };\n    }\n    target = resolve(base, norm);\n  }\n\n  try {\n    const baseReal = realpathSync(base);\n    if (!existsSync(target)) {\n      return { ok: false, error: `File not found: ${trimmed || 'SKILL.md'}` };\n    }\n    const targetReal = realpathSync(target);\n    if (!isInsideDir(baseReal, targetReal)) {\n      return { ok: false, error: 'Resolved path escapes the skill directory.' };\n    }\n    return { ok: true, absolutePath: targetReal };\n  } catch (e) {\n    return { ok: false, error: e instanceof Error ? e.message : String(e) };\n  }\n}\n"],"mappings":";;;;;;AASA,MAAM,cAAc,IAAI,IAAI;CAAC;CAAc;CAAa;CAAW;CAAS,CAAC;AAM7E,SAAS,iBAAiB,GAAoB;CAC5C,MAAM,IAAI,EAAE,MAAM;AAClB,QAAO,MAAM,cAAc,EAAE,aAAa,KAAK;;AAGjD,SAAS,YAAY,SAAiB,UAA2B;CAC/D,MAAM,SAAS,QAAQ,SAAS,IAAI,GAAG,UAAU,UAAU;AAC3D,QAAO,aAAa,WAAW,SAAS,WAAW,OAAO;;;;;;AAO5D,SAAgB,yBACd,OACA,SACwB;CACxB,MAAM,OAAO,MAAM;CACnB,MAAM,UAAU,SAAS,MAAM,IAAI;CAEnC,IAAI;AACJ,KAAI,CAAC,WAAW,YAAY,OAAO,iBAAiB,QAAQ,CAC1D,UAAS,MAAM;MACV;EACL,MAAM,OAAO,QAAQ,QAAQ,OAAO,IAAI;AACxC,MAAI,KAAK,SAAS,KAAK,CACrB,QAAO;GAAE,IAAI;GAAO,OAAO;GAAgD;AAE7E,MAAI,KAAK,WAAW,IAAI,IAAI,aAAa,KAAK,KAAK,CACjD,QAAO;GACL,IAAI;GACJ,OAAO;GACR;EAEH,MAAM,QAAQ,KAAK,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,MAAM;AACpD,MAAI,CAAC,YAAY,IAAI,MAAM,CACzB,QAAO;GACL,IAAI;GACJ,OAAO;GACR;AAEH,WAAS,QAAQ,MAAM,KAAK;;AAG9B,KAAI;EACF,MAAM,WAAW,aAAa,KAAK;AACnC,MAAI,CAAC,WAAW,OAAO,CACrB,QAAO;GAAE,IAAI;GAAO,OAAO,mBAAmB,WAAW;GAAc;EAEzE,MAAM,aAAa,aAAa,OAAO;AACvC,MAAI,CAAC,YAAY,UAAU,WAAW,CACpC,QAAO;GAAE,IAAI;GAAO,OAAO;GAA8C;AAE3E,SAAO;GAAE,IAAI;GAAM,cAAc;GAAY;UACtC,GAAG;AACV,SAAO;GAAE,IAAI;GAAO,OAAO,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;GAAE"}
+{"version":3,"file":"skill-view-path.js","names":[],"sources":["../../../../src/agent/skills/skill-view-path.ts"],"sourcesContent":["/**\n * Resolve safe paths for skill_view: only SKILL.md (default) or files under allowlisted subdirs.\n * Also provides localized SKILL.md resolution for multi-language display.\n */\n\nimport { existsSync, readFileSync, realpathSync } from 'fs';\nimport { join, resolve, sep } from 'path';\n\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { parseRequiredEnvVarNames } from './required-env-vars.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { parseSkillToolConditions } from './skill-tool-gating.js';\nimport type { Skill, SkillMarkdownPreviewPayload } from './types.js';\n\nconst ALLOWED_TOP = new Set(['references', 'templates', 'scripts', 'assets']);\n\nexport type ResolveSkillFileResult =\n  | { ok: true; absolutePath: string }\n  | { ok: false; error: string };\n\nfunction isSkillMdSegment(p: string): boolean {\n  const s = p.trim();\n  return s === 'SKILL.md' || s.toLowerCase() === 'skill.md';\n}\n\nfunction isInsideDir(dirReal: string, fileReal: string): boolean {\n  const prefix = dirReal.endsWith(sep) ? dirReal : dirReal + sep;\n  return fileReal === dirReal || fileReal.startsWith(prefix);\n}\n\n/**\n * Resolve a readable file path for {@link skill}. Empty or SKILL.md → main SKILL.md file.\n * Other paths must live under references/, templates/, scripts/, or assets/.\n */\nexport function resolveSkillReadablePath(\n  skill: Skill,\n  subPath: string | undefined,\n): ResolveSkillFileResult {\n  const base = skill.baseDir;\n  const trimmed = subPath?.trim() ?? '';\n\n  let target: string;\n  if (!trimmed || trimmed === '.' || isSkillMdSegment(trimmed)) {\n    target = skill.filePath;\n  } else {\n    const norm = trimmed.replace(/\\\\/g, '/');\n    if (norm.includes('..')) {\n      return { ok: false, error: 'Invalid path: path traversal is not allowed.' };\n    }\n    if (norm.startsWith('/') || /^[A-Za-z]:/.test(norm)) {\n      return {\n        ok: false,\n        error: 'Invalid path: use a path relative to the skill directory.',\n      };\n    }\n    const first = norm.split('/').filter(Boolean)[0] ?? '';\n    if (!ALLOWED_TOP.has(first)) {\n      return {\n        ok: false,\n        error: `Invalid path: must be under references/, templates/, scripts/, or assets/ (or omit path for SKILL.md).`,\n      };\n    }\n    target = resolve(base, norm);\n  }\n\n  try {\n    const baseReal = realpathSync(base);\n    if (!existsSync(target)) {\n      return { ok: false, error: `File not found: ${trimmed || 'SKILL.md'}` };\n    }\n    const targetReal = realpathSync(target);\n    if (!isInsideDir(baseReal, targetReal)) {\n      return { ok: false, error: 'Resolved path escapes the skill directory.' };\n    }\n    return { ok: true, absolutePath: targetReal };\n  } catch (e) {\n    return { ok: false, error: e instanceof Error ? e.message : String(e) };\n  }\n}\n\n/**\n * Resolve a localized SKILL.md for display (e.g. SKILL-zh.md, SKILL-en.md).\n * Falls back to the base SKILL.md content if no localized file exists.\n *\n * This is the **display** path — execution always reads the base SKILL.md.\n */\nexport function resolveLocalizedSkillMarkdown(\n  skill: Skill,\n  lang?: string,\n): SkillMarkdownPreviewPayload | null {\n  if (!lang) {\n    return null; // caller should fall back to skill.content\n  }\n\n  // Normalize: prefer two-letter code\n  const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();\n  if (!normalizedLang || normalizedLang === 'en') {\n    return null; // 'en' is the base SKILL.md\n  }\n\n  const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);\n  if (!existsSync(localizedPath)) {\n    return null;\n  }\n\n  try {\n    const rawContent = readFileSync(localizedPath, 'utf-8');\n    const { frontmatter, content } = parseFrontmatter(rawContent);\n    const fm = frontmatter as Record<string, unknown>;\n\n    const name = (typeof fm.name === 'string' && fm.name.trim()) || skill.name;\n    const descFromFm = typeof fm.description === 'string' ? fm.description.trim() : '';\n    const description = descFromFm || skill.description;\n    const metadata = parseSkillMetadata(fm);\n    if (!metadata.name.trim()) metadata.name = name;\n    if (!metadata.description.trim()) metadata.description = description;\n\n    const toolConditions = parseSkillToolConditions(fm);\n    const requiredEnvVarNames = parseRequiredEnvVarNames(fm);\n\n    return {\n      name,\n      description,\n      bodyMarkdown: content.trim(),\n      disableModelInvocation: skill.disableModelInvocation,\n      metadata,\n      toolConditions,\n      requiredEnvVarNames: requiredEnvVarNames.length > 0 ? requiredEnvVarNames : undefined,\n    };\n  } catch {\n    return null; // parse error → fall back\n  }\n}\n\n/**\n * Lightweight localized name/description lookup (frontmatter only) for list views.\n * Reuses the same SKILL-{lang}.md resolution as {@link resolveLocalizedSkillMarkdown}.\n */\nexport function resolveLocalizedSkillMeta(\n  skill: Skill,\n  lang: string,\n): { name: string; description: string } | null {\n  const normalizedLang = lang.split(/[-_]/)[0]?.toLowerCase();\n  if (!normalizedLang || normalizedLang === 'en') return null;\n\n  const localizedPath = join(skill.baseDir, `SKILL-${normalizedLang}.md`);\n  if (!existsSync(localizedPath)) return null;\n\n  try {\n    const rawContent = readFileSync(localizedPath, 'utf-8');\n    const { frontmatter } = parseFrontmatter(rawContent);\n    const fm = frontmatter as Record<string, unknown>;\n    const name = typeof fm.name === 'string' && fm.name.trim() ? fm.name.trim() : undefined;\n    const description =\n      typeof fm.description === 'string' && fm.description.trim() ? fm.description.trim() : undefined;\n    if (!name && !description) return null;\n    return {\n      name: name ?? skill.name,\n      description: description ?? skill.description,\n    };\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/skills-marketplace.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Skills marketplace facade: delegates to a {@link SkillsMarketplaceAdapter}
+ * (store.xopc.ai or SkillHub).
+ */
+import type { Config } from '../../config/schema.js';
+import { getMarketplaceAdapter, getMarketplaceProviderDisplayName, resolveSkillsMarketplaceProvider } from './marketplace/resolve-adapter.js';
+import type { MarketplaceCategoryOption, SkillsStoreListParams, UnifiedMarketplaceListResponse, UnifiedMarketplacePackageDetail } from './marketplace/adapters/store/store-api-client.js';
+export type { SkillsMarketplaceAdapter } from './marketplace/adapter.types.js';
+export type { SkillsMarketplaceProvider } from './marketplace/adapters/store/store-api-client.js';
+export { getMarketplaceAdapter, getMarketplaceProviderDisplayName, resolveSkillsMarketplaceProvider };
+export type { MarketplaceCategoryOption, MarketplacePackageDetail, SkillsStoreListParams, SkillsStoreListResponse, UnifiedMarketplaceListResponse, UnifiedMarketplacePackageDetail, } from './marketplace/adapters/store/store-api-client.js';
+export declare function listMarketplaceCategories(config: Config): Promise<{
+    items: MarketplaceCategoryOption[];
+}>;
+export declare function listMarketplacePackages(config: Config, params: SkillsStoreListParams): Promise<UnifiedMarketplaceListResponse>;
+export declare function getMarketplacePackageDetail(config: Config, packageName: string): Promise<UnifiedMarketplacePackageDetail>;
+export declare function downloadFromMarketplace(config: Config, packageName: string, version?: string): Promise<{
+    buffer: Buffer;
+    skillId: string;
+    version: string;
+}>;

package/dist/src/agent/skills/skills-marketplace.js

@@ -0,0 +1,18 @@
+import { getMarketplaceAdapter, getMarketplaceProviderDisplayName, resolveSkillsMarketplaceProvider } from "./marketplace/resolve-adapter.js";
+//#region src/agent/skills/skills-marketplace.ts
+async function listMarketplaceCategories(config) {
+	return { items: await getMarketplaceAdapter(config).listCategories(config) };
+}
+async function listMarketplacePackages(config, params) {
+	return getMarketplaceAdapter(config).listPackages(config, params);
+}
+async function getMarketplacePackageDetail(config, packageName) {
+	return getMarketplaceAdapter(config).getPackageDetail(config, packageName);
+}
+async function downloadFromMarketplace(config, packageName, version) {
+	return getMarketplaceAdapter(config).downloadPackage(config, packageName, version);
+}
+//#endregion
+export { downloadFromMarketplace, getMarketplaceAdapter, getMarketplacePackageDetail, getMarketplaceProviderDisplayName, listMarketplaceCategories, listMarketplacePackages, resolveSkillsMarketplaceProvider };
+
+//# sourceMappingURL=skills-marketplace.js.map

package/dist/src/agent/skills/skills-marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-marketplace.js","names":[],"sources":["../../../../src/agent/skills/skills-marketplace.ts"],"sourcesContent":["/**\n * Skills marketplace facade: delegates to a {@link SkillsMarketplaceAdapter}\n * (store.xopc.ai or SkillHub).\n */\n\nimport type { Config } from '../../config/schema.js';\nimport {\n  getMarketplaceAdapter,\n  getMarketplaceProviderDisplayName,\n  resolveSkillsMarketplaceProvider,\n} from './marketplace/resolve-adapter.js';\nimport type {\n  MarketplaceCategoryOption,\n  SkillsStoreListParams,\n  UnifiedMarketplaceListResponse,\n  UnifiedMarketplacePackageDetail,\n} from './marketplace/adapters/store/store-api-client.js';\n\nexport type { SkillsMarketplaceAdapter } from './marketplace/adapter.types.js';\nexport type { SkillsMarketplaceProvider } from './marketplace/adapters/store/store-api-client.js';\nexport { getMarketplaceAdapter, getMarketplaceProviderDisplayName, resolveSkillsMarketplaceProvider };\nexport type {\n  MarketplaceCategoryOption,\n  MarketplacePackageDetail,\n  SkillsStoreListParams,\n  SkillsStoreListResponse,\n  UnifiedMarketplaceListResponse,\n  UnifiedMarketplacePackageDetail,\n} from './marketplace/adapters/store/store-api-client.js';\n\nexport async function listMarketplaceCategories(\n  config: Config,\n): Promise<{ items: MarketplaceCategoryOption[] }> {\n  const items = await getMarketplaceAdapter(config).listCategories(config);\n  return { items };\n}\n\nexport async function listMarketplacePackages(\n  config: Config,\n  params: SkillsStoreListParams,\n): Promise<UnifiedMarketplaceListResponse> {\n  return getMarketplaceAdapter(config).listPackages(config, params);\n}\n\nexport async function getMarketplacePackageDetail(\n  config: Config,\n  packageName: string,\n): Promise<UnifiedMarketplacePackageDetail> {\n  return getMarketplaceAdapter(config).getPackageDetail(config, packageName);\n}\n\nexport async function downloadFromMarketplace(\n  config: Config,\n  packageName: string,\n  version?: string,\n): Promise<{ buffer: Buffer; skillId: string; version: string }> {\n  return getMarketplaceAdapter(config).downloadPackage(config, packageName, version);\n}\n"],"mappings":";;AA8BA,eAAsB,0BACpB,QACiD;AAEjD,QAAO,EAAE,OAAA,MADW,sBAAsB,OAAO,CAAC,eAAe,OAAO,EACxD;;AAGlB,eAAsB,wBACpB,QACA,QACyC;AACzC,QAAO,sBAAsB,OAAO,CAAC,aAAa,QAAQ,OAAO;;AAGnE,eAAsB,4BACpB,QACA,aAC0C;AAC1C,QAAO,sBAAsB,OAAO,CAAC,iBAAiB,QAAQ,YAAY;;AAG5E,eAAsB,wBACpB,QACA,aACA,SAC+D;AAC/D,QAAO,sBAAsB,OAAO,CAAC,gBAAgB,QAAQ,aAAa,QAAQ"}

package/dist/src/agent/skills/test-framework.d.ts

@@ -68,7 +68,6 @@ export declare class SkillTestFramework {
      * Test code examples
      */
     testExamples(content: string, _skillDir: string): Promise<TestResult>;
-    private extractMetadata;
     private validateInstallSpec;
     private extractCodeBlocks;
     private validateShellSyntax;

package/dist/src/agent/skills/test-framework.js

@@ -2,6 +2,7 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { hasBinary, init_installer } from "./installer.js";
+import { parseSkillMetadata } from "./parse-skill-metadata.js";
 import { scanSkillDirectory } from "./scanner.js";
 import { basename, join, relative } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
@@ -41,7 +42,7 @@ var SkillTestFramework = class {
 		results.push(parseResult);
 		if (parseResult.status === "fail") return this.createReport(skillDir, results);
 		const { frontmatter } = parseFrontmatter(readFileSync(skillMdPath, "utf-8"));
-		const metadata = this.extractMetadata(frontmatter);
+		const metadata = parseSkillMetadata(frontmatter);
 		if (!this.options.skipDeps) {
 			const depsResult = await this.testDependencies(metadata);
 			results.push(depsResult);
@@ -269,25 +270,6 @@ var SkillTestFramework = class {
 			duration: Date.now() - startTime
 		};
 	}
-	extractMetadata(frontmatter) {
-		const xopcMeta = frontmatter.metadata?.xopc;
-		const metadata = {
-			name: frontmatter.name || "",
-			description: frontmatter.description || "",
-			emoji: xopcMeta?.emoji || frontmatter.emoji || void 0,
-			homepage: frontmatter.homepage || void 0,
-			os: xopcMeta?.os || frontmatter.os || void 0,
-			requires: xopcMeta?.requires || frontmatter.requires || void 0,
-			install: xopcMeta?.install || frontmatter.install || void 0
-		};
-		if (xopcMeta) metadata.xopc = {
-			emoji: xopcMeta.emoji || void 0,
-			requires: xopcMeta.requires || void 0,
-			install: xopcMeta.install || void 0,
-			os: xopcMeta.os || void 0
-		};
-		return metadata;
-	}
 	validateInstallSpec(spec) {
 		switch (spec.kind) {
 			case "brew":

package/dist/src/agent/skills/test-framework.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-framework.js","names":[],"sources":["../../../../src/agent/skills/test-framework.ts"],"sourcesContent":["/**\n * Skill Test Framework\n * \n * Comprehensive testing framework for skills.\n * Validates SKILL.md format, dependencies, security, and examples.\n */\n\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport { basename, join, relative } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { scanSkillDirectory } from './scanner.js';\nimport { hasBinary } from './installer.js';\nimport type { SkillMetadata, SkillInstallSpec, SkillRequires } from './types.js';\n\nconst log = createLogger('SkillTestFramework');\n\n// ============================================================================\n// Test Result Types\n// ============================================================================\n\nexport type TestStatus = 'pass' | 'fail' | 'warn' | 'skip';\n\nexport interface TestResult {\n  name: string;\n  status: TestStatus;\n  message?: string;\n  details?: string[];\n  duration?: number;\n}\n\nexport interface SkillTestReport {\n  skillName: string;\n  skillPath: string;\n  timestamp: number;\n  results: TestResult[];\n  summary: {\n    total: number;\n    passed: number;\n    failed: number;\n    warnings: number;\n    skipped: number;\n  };\n  passed: boolean;\n}\n\nexport interface TestOptions {\n  /** Skip security tests */\n  skipSecurity?: boolean;\n  /** Skip dependency tests */\n  skipDeps?: boolean;\n  /** Skip example tests */\n  skipExamples?: boolean;\n  /** Strict mode - fail on warnings */\n  strict?: boolean;\n  /** Timeout for example tests (ms) */\n  exampleTimeout?: number;\n  /** Working directory for example tests */\n  cwd?: string;\n}\n\n// ============================================================================\n// Test Framework Core\n// ============================================================================\n\nexport class SkillTestFramework {\n  private options: TestOptions;\n\n  constructor(options: TestOptions = {}) {\n    this.options = {\n      skipSecurity: false,\n      skipDeps: false,\n      skipExamples: false,\n      strict: false,\n      exampleTimeout: 10000,\n      cwd: process.cwd(),\n      ...options,\n    };\n  }\n\n  /**\n   * Run all tests for a skill\n   */\n  async testSkill(skillDir: string): Promise<SkillTestReport> {\n    const results: TestResult[] = [];\n\n    log.info({ skillDir }, 'Testing skill');\n\n    // Validate skill directory\n    if (!existsSync(skillDir)) {\n      return this.createFailureReport(skillDir, 'Skill directory not found');\n    }\n\n    const skillMdPath = join(skillDir, 'SKILL.md');\n    if (!existsSync(skillMdPath)) {\n      return this.createFailureReport(skillDir, 'SKILL.md not found');\n    }\n\n    // Parse SKILL.md\n    const parseResult = this.testSkillMdFormat(skillMdPath);\n    results.push(parseResult);\n\n    if (parseResult.status === 'fail') {\n      return this.createReport(skillDir, results);\n    }\n\n    const { frontmatter } = parseFrontmatter(readFileSync(skillMdPath, 'utf-8'));\n    const metadata = this.extractMetadata(frontmatter);\n\n    // Run dependency tests\n    if (!this.options.skipDeps) {\n      const depsResult = await this.testDependencies(metadata);\n      results.push(depsResult);\n    }\n\n    // Run security tests\n    if (!this.options.skipSecurity) {\n      const securityResult = await this.testSecurity(skillDir);\n      results.push(securityResult);\n    }\n\n    // Run metadata tests\n    const metadataResult = this.testMetadata(metadata, skillDir);\n    results.push(metadataResult);\n\n    // Run example tests\n    if (!this.options.skipExamples) {\n      const content = readFileSync(skillMdPath, 'utf-8');\n      const examplesResult = await this.testExamples(content, skillDir);\n      results.push(examplesResult);\n    }\n\n    return this.createReport(skillDir, results);\n  }\n\n  /**\n   * Test SKILL.md format\n   */\n  testSkillMdFormat(filePath: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n\n    try {\n      const content = readFileSync(filePath, 'utf-8');\n\n      // Check for frontmatter\n      if (!content.startsWith('---')) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing YAML frontmatter',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      const { frontmatter } = parseFrontmatter(content);\n\n      // Required fields\n      const requiredFields = ['name', 'description'];\n      for (const field of requiredFields) {\n        if (!frontmatter[field]) {\n          details.push(`Missing required field: ${field}`);\n        }\n      }\n\n      if (details.length > 0) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing required frontmatter fields',\n          details,\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Validate field types\n      if (typeof frontmatter.name !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"name\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (typeof frontmatter.description !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"description\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Check for content after frontmatter\n      const { content: bodyContent } = parseFrontmatter(content);\n      if (!bodyContent || bodyContent.length < 10) {\n        return {\n          name: 'SKILL.md format',\n          status: 'warn',\n          message: 'SKILL.md body is too short',\n          details: ['Consider adding more detailed documentation'],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'SKILL.md format',\n        status: 'pass',\n        message: 'Valid SKILL.md format',\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'SKILL.md format',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Failed to parse SKILL.md',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test dependencies\n   */\n  async testDependencies(metadata: SkillMetadata): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n    let hasFailures = false;\n\n    const requires = metadata.xopc?.requires;\n\n    if (!requires) {\n      return {\n        name: 'Dependencies',\n        status: 'skip',\n        message: 'No dependencies declared',\n        duration: Date.now() - startTime,\n      };\n    }\n\n    // Check required binaries\n    if (requires.bins) {\n      for (const bin of requires.bins) {\n        const available = hasBinary(bin);\n        if (!available) {\n          details.push(`Missing required binary: ${bin}`);\n          hasFailures = true;\n        } else {\n          details.push(`Found binary: ${bin}`);\n        }\n      }\n    }\n\n    // Check anyBins (OR condition)\n    if (requires.anyBins) {\n      const hasAny = requires.anyBins.some(bin => hasBinary(bin));\n      if (!hasAny) {\n        details.push(`Missing binaries (need one of): ${requires.anyBins.join(', ')}`);\n        hasFailures = true;\n      } else {\n        details.push(`Found at least one binary from: ${requires.anyBins.join(', ')}`);\n      }\n    }\n\n    // Check install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Available installers: ${installSpecs.map(s => s.kind).join(', ')}`);\n      \n      // Validate install specs\n      for (const spec of installSpecs) {\n        const installCheck = this.validateInstallSpec(spec);\n        if (installCheck.status === 'fail') {\n          details.push(installCheck.message);\n          hasWarnings = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Dependencies',\n      status: hasFailures ? 'fail' : hasWarnings ? 'warn' : 'pass',\n      message: hasFailures ? 'Missing dependencies' : hasWarnings ? 'Dependency warnings' : 'All dependencies satisfied',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test security\n   */\n  async testSecurity(skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n\n    try {\n      const summary = await scanSkillDirectory(skillDir);\n\n      const details: string[] = [\n        `Critical: ${summary.critical}`,\n        `Warnings: ${summary.warn}`,\n        `Info: ${summary.info}`,\n      ];\n\n      if (summary.critical > 0) {\n        return {\n          name: 'Security',\n          status: 'fail',\n          message: 'Critical security issues found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'critical')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (summary.warn > 0) {\n        return {\n          name: 'Security',\n          status: 'warn',\n          message: 'Security warnings found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'warning')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'Security',\n        status: 'pass',\n        message: 'No security issues',\n        details,\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'Security',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Security scan failed',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test metadata\n   */\n  testMetadata(metadata: SkillMetadata, _skillDir: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n\n    // Check for emoji\n    const emoji = metadata.xopc?.emoji;\n    if (emoji) {\n      details.push(`Emoji: ${emoji}`);\n    } else {\n      details.push('No emoji defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for homepage\n    if (metadata.homepage) {\n      details.push(`Homepage: ${metadata.homepage}`);\n    } else {\n      details.push('No homepage defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for OS restrictions\n    const os = metadata.xopc?.os;\n    if (os) {\n      details.push(`Supported OS: ${os.join(', ')}`);\n    }\n\n    // Check for install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Installers: ${installSpecs.length} defined`);\n    }\n\n    return {\n      name: 'Metadata',\n      status: hasWarnings ? 'warn' : 'pass',\n      message: hasWarnings ? 'Metadata could be improved' : 'Complete metadata',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test code examples\n   */\n  async testExamples(content: string, _skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasFailures = false;\n\n    // Extract code blocks\n    const codeBlocks = this.extractCodeBlocks(content);\n    \n    if (codeBlocks.length === 0) {\n      return {\n        name: 'Examples',\n        status: 'warn',\n        message: 'No code examples found',\n        details: ['Consider adding usage examples'],\n        duration: Date.now() - startTime,\n      };\n    }\n\n    details.push(`Found ${codeBlocks.length} code block(s)`);\n\n    // Test shell command examples (basic validation)\n    const shellCommands = codeBlocks.filter(block => {\n      const lang = block.language?.toLowerCase();\n      return lang === 'bash' || lang === 'sh' || lang === 'shell';\n    });\n\n    if (shellCommands.length > 0) {\n      details.push(`Shell examples: ${shellCommands.length}`);\n      \n      // Validate command syntax (basic check)\n      for (const cmd of shellCommands) {\n        const syntaxCheck = this.validateShellSyntax(cmd.code);\n        if (!syntaxCheck.valid) {\n          details.push(`Invalid syntax: ${syntaxCheck.error}`);\n          hasFailures = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Examples',\n      status: hasFailures ? 'fail' : 'pass',\n      message: hasFailures ? 'Invalid examples found' : 'Examples validated',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  // ============================================================================\n  // Helper Methods\n  // ============================================================================\n\n  private extractMetadata(frontmatter: Record<string, unknown>): SkillMetadata {\n    // Only support metadata.xopc nested structure\n    const meta = frontmatter.metadata as Record<string, unknown> | undefined;\n    const xopcMeta = meta?.xopc as Record<string, unknown> | undefined;\n    \n    const metadata: SkillMetadata = {\n      name: frontmatter.name as string || '',\n      description: frontmatter.description as string || '',\n      emoji: xopcMeta?.emoji as string || frontmatter.emoji as string || undefined,\n      homepage: frontmatter.homepage as string || undefined,\n      os: xopcMeta?.os as Array<'darwin' | 'linux' | 'win32'> || frontmatter.os as Array<'darwin' | 'linux' | 'win32'> || undefined,\n      requires: xopcMeta?.requires as SkillRequires || frontmatter.requires as SkillRequires || undefined,\n      install: xopcMeta?.install as SkillInstallSpec[] || frontmatter.install as SkillInstallSpec[] || undefined,\n    };\n\n    // Store xopc metadata for reference\n    if (xopcMeta) {\n      metadata.xopc = {\n        emoji: xopcMeta.emoji as string || undefined,\n        requires: xopcMeta.requires as SkillRequires || undefined,\n        install: xopcMeta.install as SkillInstallSpec[] || undefined,\n        os: xopcMeta.os as Array<'darwin' | 'linux' | 'win32'> || undefined,\n      };\n    }\n\n    return metadata;\n  }\n\n  private validateInstallSpec(spec: SkillInstallSpec): TestResult {\n    switch (spec.kind) {\n      case 'brew':\n        if (!spec.formula) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Brew installer missing \"formula\" field',\n          };\n        }\n        break;\n      case 'pnpm':\n      case 'npm':\n      case 'yarn':\n      case 'bun':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Node installer missing \"package\" field',\n          };\n        }\n        break;\n      case 'go':\n        if (!spec.module) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Go installer missing \"module\" field',\n          };\n        }\n        break;\n      case 'uv':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'UV installer missing \"package\" field',\n          };\n        }\n        break;\n    }\n    return { name: 'Install spec', status: 'pass' };\n  }\n\n  private extractCodeBlocks(content: string): Array<{ language: string; code: string }> {\n    const blocks: Array<{ language: string; code: string }> = [];\n    const regex = /```(\\w+)?\\n([\\s\\S]*?)```/g;\n    let match;\n\n    while ((match = regex.exec(content)) !== null) {\n      blocks.push({\n        language: match[1] || 'text',\n        code: match[2].trim(),\n      });\n    }\n\n    return blocks;\n  }\n\n  private validateShellSyntax(code: string): { valid: boolean; error?: string } {\n    // Basic validation - check for common syntax errors\n    const lines = code.split('\\n').filter(line => line.trim() && !line.trim().startsWith('#'));\n    \n    for (const line of lines) {\n      // Check for unclosed quotes\n      const singleQuotes = (line.match(/'/g) || []).length;\n      const doubleQuotes = (line.match(/\"/g) || []).length;\n      \n      if (singleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed single quote' };\n      }\n      if (doubleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed double quote' };\n      }\n      \n      // Check for unclosed parentheses/brackets\n      const openParens = (line.match(/\\(/g) || []).length;\n      const closeParens = (line.match(/\\)/g) || []).length;\n      if (openParens !== closeParens) {\n        return { valid: false, error: 'Mismatched parentheses' };\n      }\n    }\n\n    return { valid: true };\n  }\n\n  private createReport(skillDir: string, results: TestResult[]): SkillTestReport {\n    const summary = {\n      total: results.length,\n      passed: results.filter(r => r.status === 'pass').length,\n      failed: results.filter(r => r.status === 'fail').length,\n      warnings: results.filter(r => r.status === 'warn').length,\n      skipped: results.filter(r => r.status === 'skip').length,\n    };\n\n    const passed = summary.failed === 0 && (this.options.strict ? summary.warnings === 0 : true);\n\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results,\n      summary,\n      passed,\n    };\n  }\n\n  private createFailureReport(skillDir: string, message: string): SkillTestReport {\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results: [{\n        name: 'Validation',\n        status: 'fail',\n        message,\n      }],\n      summary: {\n        total: 1,\n        passed: 0,\n        failed: 1,\n        warnings: 0,\n        skipped: 0,\n      },\n      passed: false,\n    };\n  }\n}\n\n// ============================================================================\n// Test Runner\n// ============================================================================\n\nexport interface TestRunnerOptions extends TestOptions {\n  /** Skills directory to test */\n  skillsDir: string;\n  /** Output format */\n  format?: 'text' | 'json' | 'tap';\n  /** Verbose output */\n  verbose?: boolean;\n}\n\nexport class SkillTestRunner {\n  private options: TestRunnerOptions;\n  private framework: SkillTestFramework;\n\n  constructor(options: TestRunnerOptions) {\n    this.options = options;\n    this.framework = new SkillTestFramework(options);\n  }\n\n  async run(): Promise<{ reports: SkillTestReport[]; passed: boolean }> {\n    const reports: SkillTestReport[] = [];\n    const skillsDir = this.options.skillsDir;\n\n    log.info({ skillsDir }, 'Running skill tests');\n\n    // Find all skill directories\n    const skillDirs = this.findSkillDirectories(skillsDir);\n\n    for (const skillDir of skillDirs) {\n      const report = await this.framework.testSkill(skillDir);\n      reports.push(report);\n    }\n\n    const allPassed = reports.every(r => r.passed);\n\n    return { reports, passed: allPassed };\n  }\n\n  private findSkillDirectories(skillsDir: string): string[] {\n    const dirs: string[] = [];\n\n    try {\n      const entries = readdirSync(skillsDir, { withFileTypes: true });\n      \n      for (const entry of entries) {\n        if (entry.isDirectory() && !entry.name.startsWith('.')) {\n          const skillDir = join(skillsDir, entry.name);\n          const skillMdPath = join(skillDir, 'SKILL.md');\n          \n          if (existsSync(skillMdPath)) {\n            dirs.push(skillDir);\n          }\n        }\n      }\n    } catch (err) {\n      log.warn({ error: err }, 'Failed to scan skills directory');\n    }\n\n    return dirs;\n  }\n}\n\n/**\n * Format test results as text\n */\nexport function formatTestResults(reports: SkillTestReport[], verbose = false): string {\n  const lines: string[] = [];\n  \n  for (const report of reports) {\n    const icon = report.passed ? '✅' : '❌';\n    lines.push(`\\n${icon} ${report.skillName}`);\n    lines.push('─'.repeat(50));\n\n    for (const result of report.results) {\n      const statusIcon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : result.status === 'warn' ? '⚠' : '○';\n      lines.push(`  ${statusIcon} ${result.name}: ${result.message || ''}`);\n      \n      if (verbose && result.details) {\n        for (const detail of result.details) {\n          lines.push(`     ${detail}`);\n        }\n      }\n    }\n\n    lines.push(`  Summary: ${report.summary.passed}/${report.summary.total} passed`);\n    if (report.summary.failed > 0) {\n      lines.push(`  Failed: ${report.summary.failed}`);\n    }\n    if (report.summary.warnings > 0) {\n      lines.push(`  Warnings: ${report.summary.warnings}`);\n    }\n  }\n\n  const totalTests = reports.reduce((sum, r) => sum + r.summary.total, 0);\n  const totalPassed = reports.reduce((sum, r) => sum + r.summary.passed, 0);\n  const totalFailed = reports.reduce((sum, r) => sum + r.summary.failed, 0);\n  const totalWarnings = reports.reduce((sum, r) => sum + r.summary.warnings, 0);\n\n  lines.push('\\n' + '='.repeat(50));\n  lines.push(`Total: ${totalTests} tests, ${totalPassed} passed, ${totalFailed} failed, ${totalWarnings} warnings`);\n  \n  const allPassed = reports.every(r => r.passed);\n  lines.push(`Result: ${allPassed ? '✅ PASSED' : '❌ FAILED'}`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format test results as JSON\n */\nexport function formatTestResultsJson(reports: SkillTestReport[]): string {\n  return JSON.stringify({\n    timestamp: new Date().toISOString(),\n    totalSkills: reports.length,\n    passedSkills: reports.filter(r => r.passed).length,\n    reports,\n  }, null, 2);\n}\n\n/**\n * Format test results as TAP (Test Anything Protocol)\n */\nexport function formatTestResultsTap(reports: SkillTestReport[]): string {\n  const lines: string[] = [];\n  let testNum = 1;\n\n  lines.push(`TAP version 13`);\n  lines.push(`1..${reports.reduce((sum, r) => sum + r.results.length, 0)}`);\n\n  for (const report of reports) {\n    for (const result of report.results) {\n      const status = result.status === 'pass' ? 'ok' : 'not ok';\n      const testId = testNum++;\n      lines.push(`${status} ${testId} - ${report.skillName}: ${result.name}`);\n      \n      if (result.status === 'fail' && result.message) {\n        lines.push(`  ---`);\n        lines.push(`  message: ${result.message}`);\n        lines.push(`  ...`);\n      }\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}
+{"version":3,"file":"test-framework.js","names":[],"sources":["../../../../src/agent/skills/test-framework.ts"],"sourcesContent":["/**\n * Skill Test Framework\n * \n * Comprehensive testing framework for skills.\n * Validates SKILL.md format, dependencies, security, and examples.\n */\n\nimport { existsSync, readFileSync, readdirSync } from 'fs';\nimport { basename, join, relative } from 'path';\nimport { createLogger } from '../../utils/logger.js';\nimport { parseFrontmatter } from '../../markdown/frontmatter.js';\nimport { parseSkillMetadata } from './parse-skill-metadata.js';\nimport { scanSkillDirectory } from './scanner.js';\nimport { hasBinary } from './installer.js';\nimport type { SkillMetadata, SkillInstallSpec } from './types.js';\n\nconst log = createLogger('SkillTestFramework');\n\n// ============================================================================\n// Test Result Types\n// ============================================================================\n\nexport type TestStatus = 'pass' | 'fail' | 'warn' | 'skip';\n\nexport interface TestResult {\n  name: string;\n  status: TestStatus;\n  message?: string;\n  details?: string[];\n  duration?: number;\n}\n\nexport interface SkillTestReport {\n  skillName: string;\n  skillPath: string;\n  timestamp: number;\n  results: TestResult[];\n  summary: {\n    total: number;\n    passed: number;\n    failed: number;\n    warnings: number;\n    skipped: number;\n  };\n  passed: boolean;\n}\n\nexport interface TestOptions {\n  /** Skip security tests */\n  skipSecurity?: boolean;\n  /** Skip dependency tests */\n  skipDeps?: boolean;\n  /** Skip example tests */\n  skipExamples?: boolean;\n  /** Strict mode - fail on warnings */\n  strict?: boolean;\n  /** Timeout for example tests (ms) */\n  exampleTimeout?: number;\n  /** Working directory for example tests */\n  cwd?: string;\n}\n\n// ============================================================================\n// Test Framework Core\n// ============================================================================\n\nexport class SkillTestFramework {\n  private options: TestOptions;\n\n  constructor(options: TestOptions = {}) {\n    this.options = {\n      skipSecurity: false,\n      skipDeps: false,\n      skipExamples: false,\n      strict: false,\n      exampleTimeout: 10000,\n      cwd: process.cwd(),\n      ...options,\n    };\n  }\n\n  /**\n   * Run all tests for a skill\n   */\n  async testSkill(skillDir: string): Promise<SkillTestReport> {\n    const results: TestResult[] = [];\n\n    log.info({ skillDir }, 'Testing skill');\n\n    // Validate skill directory\n    if (!existsSync(skillDir)) {\n      return this.createFailureReport(skillDir, 'Skill directory not found');\n    }\n\n    const skillMdPath = join(skillDir, 'SKILL.md');\n    if (!existsSync(skillMdPath)) {\n      return this.createFailureReport(skillDir, 'SKILL.md not found');\n    }\n\n    // Parse SKILL.md\n    const parseResult = this.testSkillMdFormat(skillMdPath);\n    results.push(parseResult);\n\n    if (parseResult.status === 'fail') {\n      return this.createReport(skillDir, results);\n    }\n\n    const { frontmatter } = parseFrontmatter(readFileSync(skillMdPath, 'utf-8'));\n    const metadata = parseSkillMetadata(frontmatter);\n\n    // Run dependency tests\n    if (!this.options.skipDeps) {\n      const depsResult = await this.testDependencies(metadata);\n      results.push(depsResult);\n    }\n\n    // Run security tests\n    if (!this.options.skipSecurity) {\n      const securityResult = await this.testSecurity(skillDir);\n      results.push(securityResult);\n    }\n\n    // Run metadata tests\n    const metadataResult = this.testMetadata(metadata, skillDir);\n    results.push(metadataResult);\n\n    // Run example tests\n    if (!this.options.skipExamples) {\n      const content = readFileSync(skillMdPath, 'utf-8');\n      const examplesResult = await this.testExamples(content, skillDir);\n      results.push(examplesResult);\n    }\n\n    return this.createReport(skillDir, results);\n  }\n\n  /**\n   * Test SKILL.md format\n   */\n  testSkillMdFormat(filePath: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n\n    try {\n      const content = readFileSync(filePath, 'utf-8');\n\n      // Check for frontmatter\n      if (!content.startsWith('---')) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing YAML frontmatter',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      const { frontmatter } = parseFrontmatter(content);\n\n      // Required fields\n      const requiredFields = ['name', 'description'];\n      for (const field of requiredFields) {\n        if (!frontmatter[field]) {\n          details.push(`Missing required field: ${field}`);\n        }\n      }\n\n      if (details.length > 0) {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Missing required frontmatter fields',\n          details,\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Validate field types\n      if (typeof frontmatter.name !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"name\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (typeof frontmatter.description !== 'string') {\n        return {\n          name: 'SKILL.md format',\n          status: 'fail',\n          message: 'Field \"description\" must be a string',\n          duration: Date.now() - startTime,\n        };\n      }\n\n      // Check for content after frontmatter\n      const { content: bodyContent } = parseFrontmatter(content);\n      if (!bodyContent || bodyContent.length < 10) {\n        return {\n          name: 'SKILL.md format',\n          status: 'warn',\n          message: 'SKILL.md body is too short',\n          details: ['Consider adding more detailed documentation'],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'SKILL.md format',\n        status: 'pass',\n        message: 'Valid SKILL.md format',\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'SKILL.md format',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Failed to parse SKILL.md',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test dependencies\n   */\n  async testDependencies(metadata: SkillMetadata): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n    let hasFailures = false;\n\n    const requires = metadata.xopc?.requires;\n\n    if (!requires) {\n      return {\n        name: 'Dependencies',\n        status: 'skip',\n        message: 'No dependencies declared',\n        duration: Date.now() - startTime,\n      };\n    }\n\n    // Check required binaries\n    if (requires.bins) {\n      for (const bin of requires.bins) {\n        const available = hasBinary(bin);\n        if (!available) {\n          details.push(`Missing required binary: ${bin}`);\n          hasFailures = true;\n        } else {\n          details.push(`Found binary: ${bin}`);\n        }\n      }\n    }\n\n    // Check anyBins (OR condition)\n    if (requires.anyBins) {\n      const hasAny = requires.anyBins.some(bin => hasBinary(bin));\n      if (!hasAny) {\n        details.push(`Missing binaries (need one of): ${requires.anyBins.join(', ')}`);\n        hasFailures = true;\n      } else {\n        details.push(`Found at least one binary from: ${requires.anyBins.join(', ')}`);\n      }\n    }\n\n    // Check install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Available installers: ${installSpecs.map(s => s.kind).join(', ')}`);\n      \n      // Validate install specs\n      for (const spec of installSpecs) {\n        const installCheck = this.validateInstallSpec(spec);\n        if (installCheck.status === 'fail') {\n          details.push(installCheck.message);\n          hasWarnings = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Dependencies',\n      status: hasFailures ? 'fail' : hasWarnings ? 'warn' : 'pass',\n      message: hasFailures ? 'Missing dependencies' : hasWarnings ? 'Dependency warnings' : 'All dependencies satisfied',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test security\n   */\n  async testSecurity(skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n\n    try {\n      const summary = await scanSkillDirectory(skillDir);\n\n      const details: string[] = [\n        `Critical: ${summary.critical}`,\n        `Warnings: ${summary.warn}`,\n        `Info: ${summary.info}`,\n      ];\n\n      if (summary.critical > 0) {\n        return {\n          name: 'Security',\n          status: 'fail',\n          message: 'Critical security issues found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'critical')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      if (summary.warn > 0) {\n        return {\n          name: 'Security',\n          status: 'warn',\n          message: 'Security warnings found',\n          details: [\n            ...details,\n            ...summary.findings\n              .filter(f => f.severity === 'warning')\n              .map(f => `${f.message} at ${relative(skillDir, f.file)}:${f.line}`),\n          ],\n          duration: Date.now() - startTime,\n        };\n      }\n\n      return {\n        name: 'Security',\n        status: 'pass',\n        message: 'No security issues',\n        details,\n        duration: Date.now() - startTime,\n      };\n    } catch (err) {\n      return {\n        name: 'Security',\n        status: 'fail',\n        message: err instanceof Error ? err.message : 'Security scan failed',\n        duration: Date.now() - startTime,\n      };\n    }\n  }\n\n  /**\n   * Test metadata\n   */\n  testMetadata(metadata: SkillMetadata, _skillDir: string): TestResult {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasWarnings = false;\n\n    // Check for emoji\n    const emoji = metadata.xopc?.emoji;\n    if (emoji) {\n      details.push(`Emoji: ${emoji}`);\n    } else {\n      details.push('No emoji defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for homepage\n    if (metadata.homepage) {\n      details.push(`Homepage: ${metadata.homepage}`);\n    } else {\n      details.push('No homepage defined (recommended)');\n      hasWarnings = true;\n    }\n\n    // Check for OS restrictions\n    const os = metadata.xopc?.os;\n    if (os) {\n      details.push(`Supported OS: ${os.join(', ')}`);\n    }\n\n    // Check for install specs\n    const installSpecs = metadata.xopc?.install;\n    if (installSpecs && installSpecs.length > 0) {\n      details.push(`Installers: ${installSpecs.length} defined`);\n    }\n\n    return {\n      name: 'Metadata',\n      status: hasWarnings ? 'warn' : 'pass',\n      message: hasWarnings ? 'Metadata could be improved' : 'Complete metadata',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Test code examples\n   */\n  async testExamples(content: string, _skillDir: string): Promise<TestResult> {\n    const startTime = Date.now();\n    const details: string[] = [];\n    let hasFailures = false;\n\n    // Extract code blocks\n    const codeBlocks = this.extractCodeBlocks(content);\n    \n    if (codeBlocks.length === 0) {\n      return {\n        name: 'Examples',\n        status: 'warn',\n        message: 'No code examples found',\n        details: ['Consider adding usage examples'],\n        duration: Date.now() - startTime,\n      };\n    }\n\n    details.push(`Found ${codeBlocks.length} code block(s)`);\n\n    // Test shell command examples (basic validation)\n    const shellCommands = codeBlocks.filter(block => {\n      const lang = block.language?.toLowerCase();\n      return lang === 'bash' || lang === 'sh' || lang === 'shell';\n    });\n\n    if (shellCommands.length > 0) {\n      details.push(`Shell examples: ${shellCommands.length}`);\n      \n      // Validate command syntax (basic check)\n      for (const cmd of shellCommands) {\n        const syntaxCheck = this.validateShellSyntax(cmd.code);\n        if (!syntaxCheck.valid) {\n          details.push(`Invalid syntax: ${syntaxCheck.error}`);\n          hasFailures = true;\n        }\n      }\n    }\n\n    return {\n      name: 'Examples',\n      status: hasFailures ? 'fail' : 'pass',\n      message: hasFailures ? 'Invalid examples found' : 'Examples validated',\n      details,\n      duration: Date.now() - startTime,\n    };\n  }\n\n  // ============================================================================\n  // Helper Methods\n  // ============================================================================\n\n  private validateInstallSpec(spec: SkillInstallSpec): TestResult {\n    switch (spec.kind) {\n      case 'brew':\n        if (!spec.formula) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Brew installer missing \"formula\" field',\n          };\n        }\n        break;\n      case 'pnpm':\n      case 'npm':\n      case 'yarn':\n      case 'bun':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Node installer missing \"package\" field',\n          };\n        }\n        break;\n      case 'go':\n        if (!spec.module) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'Go installer missing \"module\" field',\n          };\n        }\n        break;\n      case 'uv':\n        if (!spec.package) {\n          return {\n            name: 'Install spec',\n            status: 'fail',\n            message: 'UV installer missing \"package\" field',\n          };\n        }\n        break;\n    }\n    return { name: 'Install spec', status: 'pass' };\n  }\n\n  private extractCodeBlocks(content: string): Array<{ language: string; code: string }> {\n    const blocks: Array<{ language: string; code: string }> = [];\n    const regex = /```(\\w+)?\\n([\\s\\S]*?)```/g;\n    let match;\n\n    while ((match = regex.exec(content)) !== null) {\n      blocks.push({\n        language: match[1] || 'text',\n        code: match[2].trim(),\n      });\n    }\n\n    return blocks;\n  }\n\n  private validateShellSyntax(code: string): { valid: boolean; error?: string } {\n    // Basic validation - check for common syntax errors\n    const lines = code.split('\\n').filter(line => line.trim() && !line.trim().startsWith('#'));\n    \n    for (const line of lines) {\n      // Check for unclosed quotes\n      const singleQuotes = (line.match(/'/g) || []).length;\n      const doubleQuotes = (line.match(/\"/g) || []).length;\n      \n      if (singleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed single quote' };\n      }\n      if (doubleQuotes % 2 !== 0) {\n        return { valid: false, error: 'Unclosed double quote' };\n      }\n      \n      // Check for unclosed parentheses/brackets\n      const openParens = (line.match(/\\(/g) || []).length;\n      const closeParens = (line.match(/\\)/g) || []).length;\n      if (openParens !== closeParens) {\n        return { valid: false, error: 'Mismatched parentheses' };\n      }\n    }\n\n    return { valid: true };\n  }\n\n  private createReport(skillDir: string, results: TestResult[]): SkillTestReport {\n    const summary = {\n      total: results.length,\n      passed: results.filter(r => r.status === 'pass').length,\n      failed: results.filter(r => r.status === 'fail').length,\n      warnings: results.filter(r => r.status === 'warn').length,\n      skipped: results.filter(r => r.status === 'skip').length,\n    };\n\n    const passed = summary.failed === 0 && (this.options.strict ? summary.warnings === 0 : true);\n\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results,\n      summary,\n      passed,\n    };\n  }\n\n  private createFailureReport(skillDir: string, message: string): SkillTestReport {\n    return {\n      skillName: basename(skillDir),\n      skillPath: skillDir,\n      timestamp: Date.now(),\n      results: [{\n        name: 'Validation',\n        status: 'fail',\n        message,\n      }],\n      summary: {\n        total: 1,\n        passed: 0,\n        failed: 1,\n        warnings: 0,\n        skipped: 0,\n      },\n      passed: false,\n    };\n  }\n}\n\n// ============================================================================\n// Test Runner\n// ============================================================================\n\nexport interface TestRunnerOptions extends TestOptions {\n  /** Skills directory to test */\n  skillsDir: string;\n  /** Output format */\n  format?: 'text' | 'json' | 'tap';\n  /** Verbose output */\n  verbose?: boolean;\n}\n\nexport class SkillTestRunner {\n  private options: TestRunnerOptions;\n  private framework: SkillTestFramework;\n\n  constructor(options: TestRunnerOptions) {\n    this.options = options;\n    this.framework = new SkillTestFramework(options);\n  }\n\n  async run(): Promise<{ reports: SkillTestReport[]; passed: boolean }> {\n    const reports: SkillTestReport[] = [];\n    const skillsDir = this.options.skillsDir;\n\n    log.info({ skillsDir }, 'Running skill tests');\n\n    // Find all skill directories\n    const skillDirs = this.findSkillDirectories(skillsDir);\n\n    for (const skillDir of skillDirs) {\n      const report = await this.framework.testSkill(skillDir);\n      reports.push(report);\n    }\n\n    const allPassed = reports.every(r => r.passed);\n\n    return { reports, passed: allPassed };\n  }\n\n  private findSkillDirectories(skillsDir: string): string[] {\n    const dirs: string[] = [];\n\n    try {\n      const entries = readdirSync(skillsDir, { withFileTypes: true });\n      \n      for (const entry of entries) {\n        if (entry.isDirectory() && !entry.name.startsWith('.')) {\n          const skillDir = join(skillsDir, entry.name);\n          const skillMdPath = join(skillDir, 'SKILL.md');\n          \n          if (existsSync(skillMdPath)) {\n            dirs.push(skillDir);\n          }\n        }\n      }\n    } catch (err) {\n      log.warn({ error: err }, 'Failed to scan skills directory');\n    }\n\n    return dirs;\n  }\n}\n\n/**\n * Format test results as text\n */\nexport function formatTestResults(reports: SkillTestReport[], verbose = false): string {\n  const lines: string[] = [];\n  \n  for (const report of reports) {\n    const icon = report.passed ? '✅' : '❌';\n    lines.push(`\\n${icon} ${report.skillName}`);\n    lines.push('─'.repeat(50));\n\n    for (const result of report.results) {\n      const statusIcon = result.status === 'pass' ? '✓' : result.status === 'fail' ? '✗' : result.status === 'warn' ? '⚠' : '○';\n      lines.push(`  ${statusIcon} ${result.name}: ${result.message || ''}`);\n      \n      if (verbose && result.details) {\n        for (const detail of result.details) {\n          lines.push(`     ${detail}`);\n        }\n      }\n    }\n\n    lines.push(`  Summary: ${report.summary.passed}/${report.summary.total} passed`);\n    if (report.summary.failed > 0) {\n      lines.push(`  Failed: ${report.summary.failed}`);\n    }\n    if (report.summary.warnings > 0) {\n      lines.push(`  Warnings: ${report.summary.warnings}`);\n    }\n  }\n\n  const totalTests = reports.reduce((sum, r) => sum + r.summary.total, 0);\n  const totalPassed = reports.reduce((sum, r) => sum + r.summary.passed, 0);\n  const totalFailed = reports.reduce((sum, r) => sum + r.summary.failed, 0);\n  const totalWarnings = reports.reduce((sum, r) => sum + r.summary.warnings, 0);\n\n  lines.push('\\n' + '='.repeat(50));\n  lines.push(`Total: ${totalTests} tests, ${totalPassed} passed, ${totalFailed} failed, ${totalWarnings} warnings`);\n  \n  const allPassed = reports.every(r => r.passed);\n  lines.push(`Result: ${allPassed ? '✅ PASSED' : '❌ FAILED'}`);\n\n  return lines.join('\\n');\n}\n\n/**\n * Format test results as JSON\n */\nexport function formatTestResultsJson(reports: SkillTestReport[]): string {\n  return JSON.stringify({\n    timestamp: new Date().toISOString(),\n    totalSkills: reports.length,\n    passedSkills: reports.filter(r => r.passed).length,\n    reports,\n  }, null, 2);\n}\n\n/**\n * Format test results as TAP (Test Anything Protocol)\n */\nexport function formatTestResultsTap(reports: SkillTestReport[]): string {\n  const lines: string[] = [];\n  let testNum = 1;\n\n  lines.push(`TAP version 13`);\n  lines.push(`1..${reports.reduce((sum, r) => sum + r.results.length, 0)}`);\n\n  for (const report of reports) {\n    for (const result of report.results) {\n      const status = result.status === 'pass' ? 'ok' : 'not ok';\n      const testId = testNum++;\n      lines.push(`${status} ${testId} - ${report.skillName}: ${result.name}`);\n      \n      if (result.status === 'fail' && result.message) {\n        lines.push(`  ---`);\n        lines.push(`  message: ${result.message}`);\n        lines.push(`  ...`);\n      }\n    }\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/src/agent/skills/types.d.ts

@@ -98,13 +98,7 @@ export interface SkillsLimitsConfig {
     /** Max size (bytes) for SKILL.md file */
     maxSkillFileBytes?: number;
 }
-export type SkillsPromptStyle = 'metadata-only' | 'legacy-with-paths';
 export interface SkillsConfig {
-    /**
-     * How `<available_skills>` is rendered. Default: metadata-only (Hermes-style: no disk paths;
-     * use `skills_list` / `skill_view`). Legacy mode exposes SKILL.md paths for `read_file`.
-     */
-    promptStyle?: SkillsPromptStyle;
     /** Bundled skill allowlist */
     allowBundled?: string[];
     /** Load configuration */
@@ -130,6 +124,8 @@ export interface Skill {
     name: string;
     /** Skill description */
     description: string;
+    /** Category derived from parent directory (e.g. skills/creative/algorithmic-art → 'creative') */
+    category?: string;
     /** Path to SKILL.md file */
     filePath: string;
     /** Base directory of the skill */
@@ -149,6 +145,16 @@ export interface Skill {
     /** Raw content of SKILL.md */
     content: string;
 }
+/** GET /api/skills/:name/content — body without YAML frontmatter plus parsed metadata for the gateway console. */
+export interface SkillMarkdownPreviewPayload {
+    name: string;
+    description: string;
+    bodyMarkdown: string;
+    disableModelInvocation: boolean;
+    metadata: SkillMetadata;
+    toolConditions?: SkillToolConditions;
+    requiredEnvVarNames?: string[];
+}
 export interface SkillEntry {
     skill: Skill;
     metadata: SkillMetadata;

package/dist/src/agent/tools/dreaming-tool.js

@@ -4,8 +4,8 @@ import { SHORT_TERM_PROMOTION_LOCK_RELATIVE, SHORT_TERM_RECALL_STORE_RELATIVE }
 import { loadDreamingStore, saveDreamingStore } from "../memory/dreaming/short-term-store.js";
 import { resolveDreamingConfig } from "../memory/dreaming/config.js";
 import path from "node:path";
-import { Type } from "@sinclair/typebox";
 import fs from "node:fs/promises";
+import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/dreaming-tool.ts
 init_logger();
 const log = createLogger("DreamingTool");

package/dist/src/agent/tools/image-generate-tool.js

@@ -3,9 +3,9 @@ import { applyImageGenerationModelConfigDefaults } from "../image/image-helpers.
 import { DASHSCOPE_DEFAULT_IMAGE_MODEL, OPENAI_DEFAULT_IMAGE_MODEL } from "../image/generation/constants.js";
 import { generateImage, listImageGenerationProvidersSummary } from "../image/generation/runtime.js";
 import path from "node:path";
-import { Type } from "@sinclair/typebox";
-import { mkdir, writeFile } from "node:fs/promises";
 import { randomBytes } from "node:crypto";
+import { mkdir, writeFile } from "node:fs/promises";
+import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/image-generate-tool.ts
 const DEFAULT_COUNT = 1;
 const MAX_COUNT = 4;

package/dist/src/auth/credentials.js

@@ -2,9 +2,10 @@ import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveAgentAuthProfilesPath, resolveAuthProfilesPath, resolveCredentialsDir, resolveOAuthPath } from "../config/paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { getApiKeyFromEnv, init_env_keys } from "../providers/env-keys.js";
 import { dirname, join } from "path";
-import { mkdir, readFile, writeFile } from "fs/promises";
+import { mkdir, readFile } from "fs/promises";
 //#region src/auth/credentials.ts
 function getCredentialResolver(options) {
 	return new CredentialResolver(options);
@@ -17,6 +18,7 @@ async function hasCredentials(provider, options) {
 }
 var log, CredentialResolver;
 var init_credentials = __esmMin((() => {
+	init_write_file_atomic();
 	init_logger();
 	init_env_keys();
 	init_paths();
@@ -179,7 +181,7 @@ var init_credentials = __esmMin((() => {
 				provider: normalizedProvider,
 				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 			};
-			await writeFile(oauthPath, JSON.stringify(fullToken, null, 2), "utf-8");
+			await writeTextAtomic(oauthPath, JSON.stringify(fullToken, null, 2));
 			log.info({ provider }, "Saved OAuth token");
 		}
 		async loadFromAgentCredentials(provider) {
@@ -246,7 +248,7 @@ var init_credentials = __esmMin((() => {
 			await mkdir(dirname(path), { recursive: true });
 			const file = await this.loadAuthProfilesFile();
 			file.profiles[profileId] = profile;
-			await writeFile(path, JSON.stringify(file, null, 2), "utf-8");
+			await writeTextAtomic(path, JSON.stringify(file, null, 2));
 		}
 		async saveAgentAuthProfile(profileId, profile) {
 			if (!this.agentId || !this.appConfig) throw new Error("Agent ID and appConfig required for agent-private profiles");
@@ -254,20 +256,20 @@ var init_credentials = __esmMin((() => {
 			await mkdir(dirname(path), { recursive: true });
 			const file = await this.loadAgentAuthProfilesFile();
 			file.profiles[profileId] = profile;
-			await writeFile(path, JSON.stringify(file, null, 2), "utf-8");
+			await writeTextAtomic(path, JSON.stringify(file, null, 2));
 		}
 		async deleteGlobalAuthProfile(profileId) {
 			const path = resolveAuthProfilesPath();
 			const file = await this.loadAuthProfilesFile();
 			delete file.profiles[profileId];
-			await writeFile(path, JSON.stringify(file, null, 2), "utf-8");
+			await writeTextAtomic(path, JSON.stringify(file, null, 2));
 		}
 		async deleteAgentAuthProfile(profileId) {
 			if (!this.agentId || !this.appConfig) throw new Error("Agent ID and appConfig required for agent-private profiles");
 			const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);
 			const file = await this.loadAgentAuthProfilesFile();
 			delete file.profiles[profileId];
-			await writeFile(path, JSON.stringify(file, null, 2), "utf-8");
+			await writeTextAtomic(path, JSON.stringify(file, null, 2));
 		}
 	};
 }));

package/dist/src/auth/credentials.js.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.js","names":[],"sources":["../../../src/auth/credentials.ts"],"sourcesContent":["import { readFile, writeFile, mkdir } from 'fs/promises';\nimport { join, dirname } from 'path';\nimport { createLogger } from '../utils/logger.js';\nimport { getApiKeyFromEnv } from '../providers/env-keys.js';\nimport {\n  resolveCredentialsDir,\n  resolveAuthProfilesPath,\n  resolveAgentAuthProfilesPath,\n  resolveOAuthPath,\n} from '../config/paths.js';\nimport type { Config } from '../config/schema.js';\n\nconst log = createLogger('Credentials');\n\n// ============================================\n// Types\n// ============================================\n\nexport type CredentialType = 'api_key' | 'oauth';\n\nexport interface ApiKeyProfile {\n  type: 'api_key';\n  provider: string;\n  profileName?: string;\n  envVar?: string | null;\n  key: string | null;\n}\n\nexport interface OAuthToken {\n  type: 'oauth';\n  provider: string;\n  access: string;\n  refresh?: string;\n  expiresAt?: number;\n  scope?: string[];\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport type CredentialProfile = ApiKeyProfile;\n\nexport interface AuthProfilesFile {\n  version: number;\n  profiles: Record<string, ApiKeyProfile>;\n}\n\n// ============================================\n// Credential Resolver\n// ============================================\n\nexport interface CredentialResolverOptions {\n  stateDir?: string;\n  /** When set, per-agent auth profiles are read from `resolveAgentAuthProfilesPath(appConfig, agentId)`. */\n  agentId?: string;\n  /** Required when `agentId` is set. */\n  appConfig?: Config;\n}\n\nexport class CredentialResolver {\n  private readonly credentialsDir: string;\n  private readonly agentId?: string;\n  private readonly appConfig?: Config;\n\n  constructor(options: CredentialResolverOptions = {}) {\n    this.credentialsDir = options.stateDir\n      ? join(options.stateDir, 'credentials')\n      : resolveCredentialsDir();\n    this.agentId = options.agentId;\n    this.appConfig = options.appConfig;\n    if (this.agentId && !this.appConfig) {\n      throw new Error('CredentialResolver: appConfig is required when agentId is set');\n    }\n  }\n\n  /**\n   * Resolve API key for a provider\n   * Priority: Agent private > Global > OAuth > Environment\n   */\n  async resolveApiKey(provider: string): Promise<string | null> {\n    const normalizedProvider = provider.toLowerCase();\n\n    // 1. Try agent private credentials\n    if (this.agentId) {\n      const agentKey = await this.loadFromAgentCredentials(normalizedProvider);\n      if (agentKey) {\n        log.debug({ provider, source: 'agent' }, 'Resolved API key from agent credentials');\n        return agentKey;\n      }\n    }\n\n    // 2. Try global credentials\n    const globalKey = await this.loadFromGlobalCredentials(normalizedProvider);\n    if (globalKey) {\n      log.debug({ provider, source: 'global' }, 'Resolved API key from global credentials');\n      return globalKey;\n    }\n\n    // 3. Try OAuth token (convert to Bearer)\n    const oauthToken = await this.loadOAuthToken(normalizedProvider);\n    if (oauthToken) {\n      log.debug({ provider, source: 'oauth' }, 'Resolved API key from OAuth token');\n      return oauthToken.access;\n    }\n\n    // 4. Environment variables (see `src/providers/env-keys.ts`)\n    const envKey = getApiKeyFromEnv(normalizedProvider);\n    if (envKey) {\n      log.debug({ provider, source: 'env' }, 'Resolved API key from environment');\n      return envKey;\n    }\n\n    log.debug({ provider }, 'No API key found');\n    return null;\n  }\n\n  /**\n   * Check if a provider has credentials configured\n   */\n  async hasCredentials(provider: string): Promise<boolean> {\n    const key = await this.resolveApiKey(provider);\n    return key !== null;\n  }\n\n  /**\n   * Which step in {@link resolveApiKey} would supply the key (no secret material).\n   */\n  async resolveApiKeySource(\n    provider: string,\n  ): Promise<'agent' | 'global' | 'oauth' | 'env' | null> {\n    const normalizedProvider = provider.toLowerCase();\n\n    if (this.agentId) {\n      const agentKey = await this.loadFromAgentCredentials(normalizedProvider);\n      if (agentKey) return 'agent';\n    }\n\n    const globalKey = await this.loadFromGlobalCredentials(normalizedProvider);\n    if (globalKey) return 'global';\n\n    const oauthToken = await this.loadOAuthToken(normalizedProvider);\n    if (oauthToken) return 'oauth';\n\n    if (getApiKeyFromEnv(normalizedProvider)) return 'env';\n\n    return null;\n  }\n\n  /**\n   * List all available credential profiles\n   */\n  async listProfiles(): Promise<Array<ApiKeyProfile & { id: string; source: 'agent' | 'global' }>> {\n    const profiles: Array<ApiKeyProfile & { id: string; source: 'agent' | 'global' }> = [];\n\n    // Global profiles\n    const globalProfiles = await this.loadAuthProfilesFile();\n    for (const [id, profile] of Object.entries(globalProfiles.profiles)) {\n      profiles.push({ ...profile, id, source: 'global' });\n    }\n\n    // Agent private profiles\n    if (this.agentId) {\n      const agentProfiles = await this.loadAgentAuthProfilesFile();\n      for (const [id, profile] of Object.entries(agentProfiles.profiles)) {\n        profiles.push({ ...profile, id, source: 'agent' });\n      }\n    }\n\n    return profiles;\n  }\n\n  /**\n   * Save an API key profile\n   */\n  async saveApiKey(\n    provider: string,\n    key: string,\n    options: {\n      profileName?: string;\n      envVar?: string | null;\n      agentPrivate?: boolean;\n    } = {}\n  ): Promise<void> {\n    const normalizedProvider = provider.toLowerCase();\n    const profileId = options.profileName\n      ? `${normalizedProvider}:${options.profileName}`\n      : `${normalizedProvider}:default`;\n\n    const profile: ApiKeyProfile = {\n      type: 'api_key',\n      provider: normalizedProvider,\n      profileName: options.profileName,\n      envVar: options.envVar ?? null,\n      key,\n    };\n\n    if (options.agentPrivate && this.agentId) {\n      await this.saveAgentAuthProfile(profileId, profile);\n    } else {\n      await this.saveGlobalAuthProfile(profileId, profile);\n    }\n\n    log.info({ provider, profileId, agentPrivate: options.agentPrivate }, 'Saved API key');\n  }\n\n  /**\n   * Delete a credential profile\n   */\n  async deleteProfile(profileId: string, options: { agentPrivate?: boolean } = {}): Promise<void> {\n    if (options.agentPrivate && this.agentId) {\n      await this.deleteAgentAuthProfile(profileId);\n    } else {\n      await this.deleteGlobalAuthProfile(profileId);\n    }\n\n    log.info({ profileId, agentPrivate: options.agentPrivate }, 'Deleted credential profile');\n  }\n\n  /**\n   * Load OAuth token for a provider\n   */\n  async loadOAuthToken(provider: string): Promise<OAuthToken | null> {\n    const normalizedProvider = provider.toLowerCase();\n    const oauthPath = resolveOAuthPath(normalizedProvider);\n\n    try {\n      const content = await readFile(oauthPath, 'utf-8');\n      const token = JSON.parse(content) as OAuthToken;\n\n      // Check if token is expired\n      if (token.expiresAt && token.expiresAt < Date.now()) {\n        log.warn({ provider, expiresAt: token.expiresAt }, 'OAuth token is expired');\n        // TODO: Implement token refresh\n        return null;\n      }\n\n      return token;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Save OAuth token for a provider\n   */\n  async saveOAuthToken(provider: string, token: Omit<OAuthToken, 'type' | 'provider' | 'updatedAt'>): Promise<void> {\n    const normalizedProvider = provider.toLowerCase();\n    const oauthPath = resolveOAuthPath(normalizedProvider);\n\n    await mkdir(dirname(oauthPath), { recursive: true });\n\n    const fullToken: OAuthToken = {\n      ...token,\n      type: 'oauth',\n      provider: normalizedProvider,\n      updatedAt: new Date().toISOString(),\n    };\n\n    await writeFile(oauthPath, JSON.stringify(fullToken, null, 2), 'utf-8');\n    log.info({ provider }, 'Saved OAuth token');\n  }\n\n  // ============================================\n  // Private Methods\n  // ============================================\n\n  private async loadFromAgentCredentials(provider: string): Promise<string | null> {\n    if (!this.agentId) return null;\n\n    const profiles = await this.loadAgentAuthProfilesFile();\n    const profile = this.findProfileForProvider(profiles, provider);\n\n    if (!profile) return null;\n    if (profile.envVar) return this.loadFromEnv(profile.envVar) ?? profile.key;\n    return profile.key;\n  }\n\n  private async loadFromGlobalCredentials(provider: string): Promise<string | null> {\n    const profiles = await this.loadAuthProfilesFile();\n    const profile = this.findProfileForProvider(profiles, provider);\n\n    if (!profile) return null;\n    if (profile.envVar) return this.loadFromEnv(profile.envVar) ?? profile.key;\n    return profile.key;\n  }\n\n  private loadFromEnv(envVarName: string): string | null {\n    return process.env[envVarName] || null;\n  }\n\n  private findProfileForProvider(\n    file: AuthProfilesFile,\n    provider: string\n  ): ApiKeyProfile | null {\n    const normalizedProvider = provider.toLowerCase();\n\n    // Look for exact match first\n    for (const [, profile] of Object.entries(file.profiles)) {\n      if (profile.provider === normalizedProvider) {\n        return profile;\n      }\n    }\n\n    return null;\n  }\n\n  private async loadAuthProfilesFile(): Promise<AuthProfilesFile> {\n    const path = resolveAuthProfilesPath();\n\n    try {\n      const content = await readFile(path, 'utf-8');\n      const data = JSON.parse(content);\n      return {\n        version: data.version || 1,\n        profiles: data.profiles || {},\n      };\n    } catch {\n      return { version: 2, profiles: {} };\n    }\n  }\n\n  private async loadAgentAuthProfilesFile(): Promise<AuthProfilesFile> {\n    if (!this.agentId || !this.appConfig) return { version: 2, profiles: {} };\n\n    const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);\n\n    try {\n      const content = await readFile(path, 'utf-8');\n      const data = JSON.parse(content);\n      return {\n        version: data.version || 1,\n        profiles: data.profiles || {},\n      };\n    } catch {\n      return { version: 2, profiles: {} };\n    }\n  }\n\n  private async saveGlobalAuthProfile(profileId: string, profile: ApiKeyProfile): Promise<void> {\n    const path = resolveAuthProfilesPath();\n    await mkdir(dirname(path), { recursive: true });\n\n    const file = await this.loadAuthProfilesFile();\n    file.profiles[profileId] = profile;\n\n    await writeFile(path, JSON.stringify(file, null, 2), 'utf-8');\n  }\n\n  private async saveAgentAuthProfile(profileId: string, profile: ApiKeyProfile): Promise<void> {\n    if (!this.agentId || !this.appConfig) throw new Error('Agent ID and appConfig required for agent-private profiles');\n\n    const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);\n    await mkdir(dirname(path), { recursive: true });\n\n    const file = await this.loadAgentAuthProfilesFile();\n    file.profiles[profileId] = profile;\n\n    await writeFile(path, JSON.stringify(file, null, 2), 'utf-8');\n  }\n\n  private async deleteGlobalAuthProfile(profileId: string): Promise<void> {\n    const path = resolveAuthProfilesPath();\n    const file = await this.loadAuthProfilesFile();\n\n    delete file.profiles[profileId];\n\n    await writeFile(path, JSON.stringify(file, null, 2), 'utf-8');\n  }\n\n  private async deleteAgentAuthProfile(profileId: string): Promise<void> {\n    if (!this.agentId || !this.appConfig) throw new Error('Agent ID and appConfig required for agent-private profiles');\n\n    const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);\n    const file = await this.loadAgentAuthProfilesFile();\n\n    delete file.profiles[profileId];\n\n    await writeFile(path, JSON.stringify(file, null, 2), 'utf-8');\n  }\n}\n\n// ============================================\n// Convenience Functions\n// ============================================\n\nlet defaultResolver: CredentialResolver | null = null;\n\nexport function getCredentialResolver(options?: CredentialResolverOptions): CredentialResolver {\n  if (!defaultResolver || options) {\n    return new CredentialResolver(options);\n  }\n  return defaultResolver;\n}\n\nexport async function resolveApiKey(provider: string, options?: CredentialResolverOptions): Promise<string | null> {\n  const resolver = getCredentialResolver(options);\n  return resolver.resolveApiKey(provider);\n}\n\nexport async function hasCredentials(provider: string, options?: CredentialResolverOptions): Promise<boolean> {\n  const resolver = getCredentialResolver(options);\n  return resolver.hasCredentials(provider);\n}\n"],"mappings":"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"}
+{"version":3,"file":"credentials.js","names":[],"sources":["../../../src/auth/credentials.ts"],"sourcesContent":["import { readFile, mkdir } from 'fs/promises';\nimport { writeTextAtomic } from '../infra/write-file-atomic.js';\nimport { join, dirname } from 'path';\nimport { createLogger } from '../utils/logger.js';\nimport { getApiKeyFromEnv } from '../providers/env-keys.js';\nimport {\n  resolveCredentialsDir,\n  resolveAuthProfilesPath,\n  resolveAgentAuthProfilesPath,\n  resolveOAuthPath,\n} from '../config/paths.js';\nimport type { Config } from '../config/schema.js';\n\nconst log = createLogger('Credentials');\n\n// ============================================\n// Types\n// ============================================\n\nexport type CredentialType = 'api_key' | 'oauth';\n\nexport interface ApiKeyProfile {\n  type: 'api_key';\n  provider: string;\n  profileName?: string;\n  envVar?: string | null;\n  key: string | null;\n}\n\nexport interface OAuthToken {\n  type: 'oauth';\n  provider: string;\n  access: string;\n  refresh?: string;\n  expiresAt?: number;\n  scope?: string[];\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport type CredentialProfile = ApiKeyProfile;\n\nexport interface AuthProfilesFile {\n  version: number;\n  profiles: Record<string, ApiKeyProfile>;\n}\n\n// ============================================\n// Credential Resolver\n// ============================================\n\nexport interface CredentialResolverOptions {\n  stateDir?: string;\n  /** When set, per-agent auth profiles are read from `resolveAgentAuthProfilesPath(appConfig, agentId)`. */\n  agentId?: string;\n  /** Required when `agentId` is set. */\n  appConfig?: Config;\n}\n\nexport class CredentialResolver {\n  private readonly credentialsDir: string;\n  private readonly agentId?: string;\n  private readonly appConfig?: Config;\n\n  constructor(options: CredentialResolverOptions = {}) {\n    this.credentialsDir = options.stateDir\n      ? join(options.stateDir, 'credentials')\n      : resolveCredentialsDir();\n    this.agentId = options.agentId;\n    this.appConfig = options.appConfig;\n    if (this.agentId && !this.appConfig) {\n      throw new Error('CredentialResolver: appConfig is required when agentId is set');\n    }\n  }\n\n  /**\n   * Resolve API key for a provider\n   * Priority: Agent private > Global > OAuth > Environment\n   */\n  async resolveApiKey(provider: string): Promise<string | null> {\n    const normalizedProvider = provider.toLowerCase();\n\n    // 1. Try agent private credentials\n    if (this.agentId) {\n      const agentKey = await this.loadFromAgentCredentials(normalizedProvider);\n      if (agentKey) {\n        log.debug({ provider, source: 'agent' }, 'Resolved API key from agent credentials');\n        return agentKey;\n      }\n    }\n\n    // 2. Try global credentials\n    const globalKey = await this.loadFromGlobalCredentials(normalizedProvider);\n    if (globalKey) {\n      log.debug({ provider, source: 'global' }, 'Resolved API key from global credentials');\n      return globalKey;\n    }\n\n    // 3. Try OAuth token (convert to Bearer)\n    const oauthToken = await this.loadOAuthToken(normalizedProvider);\n    if (oauthToken) {\n      log.debug({ provider, source: 'oauth' }, 'Resolved API key from OAuth token');\n      return oauthToken.access;\n    }\n\n    // 4. Environment variables (see `src/providers/env-keys.ts`)\n    const envKey = getApiKeyFromEnv(normalizedProvider);\n    if (envKey) {\n      log.debug({ provider, source: 'env' }, 'Resolved API key from environment');\n      return envKey;\n    }\n\n    log.debug({ provider }, 'No API key found');\n    return null;\n  }\n\n  /**\n   * Check if a provider has credentials configured\n   */\n  async hasCredentials(provider: string): Promise<boolean> {\n    const key = await this.resolveApiKey(provider);\n    return key !== null;\n  }\n\n  /**\n   * Which step in {@link resolveApiKey} would supply the key (no secret material).\n   */\n  async resolveApiKeySource(\n    provider: string,\n  ): Promise<'agent' | 'global' | 'oauth' | 'env' | null> {\n    const normalizedProvider = provider.toLowerCase();\n\n    if (this.agentId) {\n      const agentKey = await this.loadFromAgentCredentials(normalizedProvider);\n      if (agentKey) return 'agent';\n    }\n\n    const globalKey = await this.loadFromGlobalCredentials(normalizedProvider);\n    if (globalKey) return 'global';\n\n    const oauthToken = await this.loadOAuthToken(normalizedProvider);\n    if (oauthToken) return 'oauth';\n\n    if (getApiKeyFromEnv(normalizedProvider)) return 'env';\n\n    return null;\n  }\n\n  /**\n   * List all available credential profiles\n   */\n  async listProfiles(): Promise<Array<ApiKeyProfile & { id: string; source: 'agent' | 'global' }>> {\n    const profiles: Array<ApiKeyProfile & { id: string; source: 'agent' | 'global' }> = [];\n\n    // Global profiles\n    const globalProfiles = await this.loadAuthProfilesFile();\n    for (const [id, profile] of Object.entries(globalProfiles.profiles)) {\n      profiles.push({ ...profile, id, source: 'global' });\n    }\n\n    // Agent private profiles\n    if (this.agentId) {\n      const agentProfiles = await this.loadAgentAuthProfilesFile();\n      for (const [id, profile] of Object.entries(agentProfiles.profiles)) {\n        profiles.push({ ...profile, id, source: 'agent' });\n      }\n    }\n\n    return profiles;\n  }\n\n  /**\n   * Save an API key profile\n   */\n  async saveApiKey(\n    provider: string,\n    key: string,\n    options: {\n      profileName?: string;\n      envVar?: string | null;\n      agentPrivate?: boolean;\n    } = {}\n  ): Promise<void> {\n    const normalizedProvider = provider.toLowerCase();\n    const profileId = options.profileName\n      ? `${normalizedProvider}:${options.profileName}`\n      : `${normalizedProvider}:default`;\n\n    const profile: ApiKeyProfile = {\n      type: 'api_key',\n      provider: normalizedProvider,\n      profileName: options.profileName,\n      envVar: options.envVar ?? null,\n      key,\n    };\n\n    if (options.agentPrivate && this.agentId) {\n      await this.saveAgentAuthProfile(profileId, profile);\n    } else {\n      await this.saveGlobalAuthProfile(profileId, profile);\n    }\n\n    log.info({ provider, profileId, agentPrivate: options.agentPrivate }, 'Saved API key');\n  }\n\n  /**\n   * Delete a credential profile\n   */\n  async deleteProfile(profileId: string, options: { agentPrivate?: boolean } = {}): Promise<void> {\n    if (options.agentPrivate && this.agentId) {\n      await this.deleteAgentAuthProfile(profileId);\n    } else {\n      await this.deleteGlobalAuthProfile(profileId);\n    }\n\n    log.info({ profileId, agentPrivate: options.agentPrivate }, 'Deleted credential profile');\n  }\n\n  /**\n   * Load OAuth token for a provider\n   */\n  async loadOAuthToken(provider: string): Promise<OAuthToken | null> {\n    const normalizedProvider = provider.toLowerCase();\n    const oauthPath = resolveOAuthPath(normalizedProvider);\n\n    try {\n      const content = await readFile(oauthPath, 'utf-8');\n      const token = JSON.parse(content) as OAuthToken;\n\n      // Check if token is expired\n      if (token.expiresAt && token.expiresAt < Date.now()) {\n        log.warn({ provider, expiresAt: token.expiresAt }, 'OAuth token is expired');\n        // TODO: Implement token refresh\n        return null;\n      }\n\n      return token;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Save OAuth token for a provider\n   */\n  async saveOAuthToken(provider: string, token: Omit<OAuthToken, 'type' | 'provider' | 'updatedAt'>): Promise<void> {\n    const normalizedProvider = provider.toLowerCase();\n    const oauthPath = resolveOAuthPath(normalizedProvider);\n\n    await mkdir(dirname(oauthPath), { recursive: true });\n\n    const fullToken: OAuthToken = {\n      ...token,\n      type: 'oauth',\n      provider: normalizedProvider,\n      updatedAt: new Date().toISOString(),\n    };\n\n    await writeTextAtomic(oauthPath, JSON.stringify(fullToken, null, 2));\n    log.info({ provider }, 'Saved OAuth token');\n  }\n\n  // ============================================\n  // Private Methods\n  // ============================================\n\n  private async loadFromAgentCredentials(provider: string): Promise<string | null> {\n    if (!this.agentId) return null;\n\n    const profiles = await this.loadAgentAuthProfilesFile();\n    const profile = this.findProfileForProvider(profiles, provider);\n\n    if (!profile) return null;\n    if (profile.envVar) return this.loadFromEnv(profile.envVar) ?? profile.key;\n    return profile.key;\n  }\n\n  private async loadFromGlobalCredentials(provider: string): Promise<string | null> {\n    const profiles = await this.loadAuthProfilesFile();\n    const profile = this.findProfileForProvider(profiles, provider);\n\n    if (!profile) return null;\n    if (profile.envVar) return this.loadFromEnv(profile.envVar) ?? profile.key;\n    return profile.key;\n  }\n\n  private loadFromEnv(envVarName: string): string | null {\n    return process.env[envVarName] || null;\n  }\n\n  private findProfileForProvider(\n    file: AuthProfilesFile,\n    provider: string\n  ): ApiKeyProfile | null {\n    const normalizedProvider = provider.toLowerCase();\n\n    // Look for exact match first\n    for (const [, profile] of Object.entries(file.profiles)) {\n      if (profile.provider === normalizedProvider) {\n        return profile;\n      }\n    }\n\n    return null;\n  }\n\n  private async loadAuthProfilesFile(): Promise<AuthProfilesFile> {\n    const path = resolveAuthProfilesPath();\n\n    try {\n      const content = await readFile(path, 'utf-8');\n      const data = JSON.parse(content);\n      return {\n        version: data.version || 1,\n        profiles: data.profiles || {},\n      };\n    } catch {\n      return { version: 2, profiles: {} };\n    }\n  }\n\n  private async loadAgentAuthProfilesFile(): Promise<AuthProfilesFile> {\n    if (!this.agentId || !this.appConfig) return { version: 2, profiles: {} };\n\n    const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);\n\n    try {\n      const content = await readFile(path, 'utf-8');\n      const data = JSON.parse(content);\n      return {\n        version: data.version || 1,\n        profiles: data.profiles || {},\n      };\n    } catch {\n      return { version: 2, profiles: {} };\n    }\n  }\n\n  private async saveGlobalAuthProfile(profileId: string, profile: ApiKeyProfile): Promise<void> {\n    const path = resolveAuthProfilesPath();\n    await mkdir(dirname(path), { recursive: true });\n\n    const file = await this.loadAuthProfilesFile();\n    file.profiles[profileId] = profile;\n\n    await writeTextAtomic(path, JSON.stringify(file, null, 2));\n  }\n\n  private async saveAgentAuthProfile(profileId: string, profile: ApiKeyProfile): Promise<void> {\n    if (!this.agentId || !this.appConfig) throw new Error('Agent ID and appConfig required for agent-private profiles');\n\n    const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);\n    await mkdir(dirname(path), { recursive: true });\n\n    const file = await this.loadAgentAuthProfilesFile();\n    file.profiles[profileId] = profile;\n\n    await writeTextAtomic(path, JSON.stringify(file, null, 2));\n  }\n\n  private async deleteGlobalAuthProfile(profileId: string): Promise<void> {\n    const path = resolveAuthProfilesPath();\n    const file = await this.loadAuthProfilesFile();\n\n    delete file.profiles[profileId];\n\n    await writeTextAtomic(path, JSON.stringify(file, null, 2));\n  }\n\n  private async deleteAgentAuthProfile(profileId: string): Promise<void> {\n    if (!this.agentId || !this.appConfig) throw new Error('Agent ID and appConfig required for agent-private profiles');\n\n    const path = resolveAgentAuthProfilesPath(this.appConfig, this.agentId);\n    const file = await this.loadAgentAuthProfilesFile();\n\n    delete file.profiles[profileId];\n\n    await writeTextAtomic(path, JSON.stringify(file, null, 2));\n  }\n}\n\n// ============================================\n// Convenience Functions\n// ============================================\n\nlet defaultResolver: CredentialResolver | null = null;\n\nexport function getCredentialResolver(options?: CredentialResolverOptions): CredentialResolver {\n  if (!defaultResolver || options) {\n    return new CredentialResolver(options);\n  }\n  return defaultResolver;\n}\n\nexport async function resolveApiKey(provider: string, options?: CredentialResolverOptions): Promise<string | null> {\n  const resolver = getCredentialResolver(options);\n  return resolver.resolveApiKey(provider);\n}\n\nexport async function hasCredentials(provider: string, options?: CredentialResolverOptions): Promise<boolean> {\n  const resolver = getCredentialResolver(options);\n  return resolver.hasCredentials(provider);\n}\n"],"mappings":"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"}