npm - @xopcai/xopc - Versions diffs - 0.0.103 → 0.0.104 - Mend

@xopcai/xopc 0.0.103 → 0.0.104

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (930) hide show

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

@@ -1,13 +1,8 @@
-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";
+import { resolve, sep } from "path";
+import { existsSync, 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",
@@ -71,65 +66,7 @@ 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 { resolveLocalizedSkillMarkdown, resolveLocalizedSkillMeta, resolveSkillReadablePath };
+export { resolveSkillReadablePath };
 //# sourceMappingURL=skill-view-path.js.map

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

	@@ -1 +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 * 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":"~~;;;;;;;;;;;AAcA~~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"}
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"}

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

@@ -1,9 +1,9 @@
 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 { hasBinary } from "./installer.js";
 import { scanSkillDirectory } from "./scanner.js";
+import { parseSkillMetadata } from "./parse-skill-metadata.js";
 import { basename, join, relative } from "path";
 import { existsSync, readFileSync, readdirSync } from "fs";
 //#region src/agent/skills/test-framework.ts
@@ -14,7 +14,6 @@ import { existsSync, readFileSync, readdirSync } from "fs";
 * Validates SKILL.md format, dependencies, security, and examples.
 */
 init_logger();
-init_installer();
 const log = createLogger("SkillTestFramework");
 var SkillTestFramework = class {
 	options;

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

	@@ -1 +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 { 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":";;;;;;;;;;;;;;;aASqD;gBAIV;AAG3C,MAAM,MAAM,aAAa,qBAAqB;AAkD9C,IAAa,qBAAb,MAAgC;CAC9B;CAEA,YAAY,UAAuB,EAAE,EAAE;AACrC,OAAK,UAAU;GACb,cAAc;GACd,UAAU;GACV,cAAc;GACd,QAAQ;GACR,gBAAgB;GAChB,KAAK,QAAQ,KAAK;GAClB,GAAG;GACJ;;;;;CAMH,MAAM,UAAU,UAA4C;EAC1D,MAAM,UAAwB,EAAE;AAEhC,MAAI,KAAK,EAAE,UAAU,EAAE,gBAAgB;AAGvC,MAAI,CAAC,WAAW,SAAS,CACvB,QAAO,KAAK,oBAAoB,UAAU,4BAA4B;EAGxE,MAAM,cAAc,KAAK,UAAU,WAAW;AAC9C,MAAI,CAAC,WAAW,YAAY,CAC1B,QAAO,KAAK,oBAAoB,UAAU,qBAAqB;EAIjE,MAAM,cAAc,KAAK,kBAAkB,YAAY;AACvD,UAAQ,KAAK,YAAY;AAEzB,MAAI,YAAY,WAAW,OACzB,QAAO,KAAK,aAAa,UAAU,QAAQ;EAG7C,MAAM,EAAE,gBAAgB,iBAAiB,aAAa,aAAa,QAAQ,CAAC;EAC5E,MAAM,WAAW,mBAAmB,YAAY;AAGhD,MAAI,CAAC,KAAK,QAAQ,UAAU;GAC1B,MAAM,aAAa,MAAM,KAAK,iBAAiB,SAAS;AACxD,WAAQ,KAAK,WAAW;;AAI1B,MAAI,CAAC,KAAK,QAAQ,cAAc;GAC9B,MAAM,iBAAiB,MAAM,KAAK,aAAa,SAAS;AACxD,WAAQ,KAAK,eAAe;;EAI9B,MAAM,iBAAiB,KAAK,aAAa,UAAU,SAAS;AAC5D,UAAQ,KAAK,eAAe;AAG5B,MAAI,CAAC,KAAK,QAAQ,cAAc;GAC9B,MAAM,UAAU,aAAa,aAAa,QAAQ;GAClD,MAAM,iBAAiB,MAAM,KAAK,aAAa,SAAS,SAAS;AACjE,WAAQ,KAAK,eAAe;;AAG9B,SAAO,KAAK,aAAa,UAAU,QAAQ;;;;;CAM7C,kBAAkB,UAA8B;EAC9C,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,UAAoB,EAAE;AAE5B,MAAI;GACF,MAAM,UAAU,aAAa,UAAU,QAAQ;AAG/C,OAAI,CAAC,QAAQ,WAAW,MAAM,CAC5B,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU,KAAK,KAAK,GAAG;IACxB;GAGH,MAAM,EAAE,gBAAgB,iBAAiB,QAAQ;AAIjD,QAAK,MAAM,SAAS,CADI,QAAQ,cACE,CAChC,KAAI,CAAC,YAAY,OACf,SAAQ,KAAK,2BAA2B,QAAQ;AAIpD,OAAI,QAAQ,SAAS,EACnB,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT;IACA,UAAU,KAAK,KAAK,GAAG;IACxB;AAIH,OAAI,OAAO,YAAY,SAAS,SAC9B,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU,KAAK,KAAK,GAAG;IACxB;AAGH,OAAI,OAAO,YAAY,gBAAgB,SACrC,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU,KAAK,KAAK,GAAG;IACxB;GAIH,MAAM,EAAE,SAAS,gBAAgB,iBAAiB,QAAQ;AAC1D,OAAI,CAAC,eAAe,YAAY,SAAS,GACvC,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS,CAAC,8CAA8C;IACxD,UAAU,KAAK,KAAK,GAAG;IACxB;AAGH,UAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,UAAU,KAAK,KAAK,GAAG;IACxB;WACM,KAAK;AACZ,UAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS,eAAe,QAAQ,IAAI,UAAU;IAC9C,UAAU,KAAK,KAAK,GAAG;IACxB;;;;;;CAOL,MAAM,iBAAiB,UAA8C;EACnE,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,UAAoB,EAAE;EAC5B,IAAI,cAAc;EAClB,IAAI,cAAc;EAElB,MAAM,WAAW,SAAS,MAAM;AAEhC,MAAI,CAAC,SACH,QAAO;GACL,MAAM;GACN,QAAQ;GACR,SAAS;GACT,UAAU,KAAK,KAAK,GAAG;GACxB;AAIH,MAAI,SAAS,KACX,MAAK,MAAM,OAAO,SAAS,KAEzB,KAAI,CADc,UAAU,IACd,EAAE;AACd,WAAQ,KAAK,4BAA4B,MAAM;AAC/C,iBAAc;QAEd,SAAQ,KAAK,iBAAiB,MAAM;AAM1C,MAAI,SAAS,QAEX,KAAI,CADW,SAAS,QAAQ,MAAK,QAAO,UAAU,IAAI,CAC/C,EAAE;AACX,WAAQ,KAAK,mCAAmC,SAAS,QAAQ,KAAK,KAAK,GAAG;AAC9E,iBAAc;QAEd,SAAQ,KAAK,mCAAmC,SAAS,QAAQ,KAAK,KAAK,GAAG;EAKlF,MAAM,eAAe,SAAS,MAAM;AACpC,MAAI,gBAAgB,aAAa,SAAS,GAAG;AAC3C,WAAQ,KAAK,yBAAyB,aAAa,KAAI,MAAK,EAAE,KAAK,CAAC,KAAK,KAAK,GAAG;AAGjF,QAAK,MAAM,QAAQ,cAAc;IAC/B,MAAM,eAAe,KAAK,oBAAoB,KAAK;AACnD,QAAI,aAAa,WAAW,QAAQ;AAClC,aAAQ,KAAK,aAAa,QAAQ;AAClC,mBAAc;;;;AAKpB,SAAO;GACL,MAAM;GACN,QAAQ,cAAc,SAAS,cAAc,SAAS;GACtD,SAAS,cAAc,yBAAyB,cAAc,wBAAwB;GACtF;GACA,UAAU,KAAK,KAAK,GAAG;GACxB;;;;;CAMH,MAAM,aAAa,UAAuC;EACxD,MAAM,YAAY,KAAK,KAAK;AAE5B,MAAI;GACF,MAAM,UAAU,MAAM,mBAAmB,SAAS;GAElD,MAAM,UAAoB;IACxB,aAAa,QAAQ;IACrB,aAAa,QAAQ;IACrB,SAAS,QAAQ;IAClB;AAED,OAAI,QAAQ,WAAW,EACrB,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS,CACP,GAAG,SACH,GAAG,QAAQ,SACR,QAAO,MAAK,EAAE,aAAa,WAAW,CACtC,KAAI,MAAK,GAAG,EAAE,QAAQ,MAAM,SAAS,UAAU,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,CACvE;IACD,UAAU,KAAK,KAAK,GAAG;IACxB;AAGH,OAAI,QAAQ,OAAO,EACjB,QAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT,SAAS,CACP,GAAG,SACH,GAAG,QAAQ,SACR,QAAO,MAAK,EAAE,aAAa,UAAU,CACrC,KAAI,MAAK,GAAG,EAAE,QAAQ,MAAM,SAAS,UAAU,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,CACvE;IACD,UAAU,KAAK,KAAK,GAAG;IACxB;AAGH,UAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS;IACT;IACA,UAAU,KAAK,KAAK,GAAG;IACxB;WACM,KAAK;AACZ,UAAO;IACL,MAAM;IACN,QAAQ;IACR,SAAS,eAAe,QAAQ,IAAI,UAAU;IAC9C,UAAU,KAAK,KAAK,GAAG;IACxB;;;;;;CAOL,aAAa,UAAyB,WAA+B;EACnE,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,UAAoB,EAAE;EAC5B,IAAI,cAAc;EAGlB,MAAM,QAAQ,SAAS,MAAM;AAC7B,MAAI,MACF,SAAQ,KAAK,UAAU,QAAQ;OAC1B;AACL,WAAQ,KAAK,iCAAiC;AAC9C,iBAAc;;AAIhB,MAAI,SAAS,SACX,SAAQ,KAAK,aAAa,SAAS,WAAW;OACzC;AACL,WAAQ,KAAK,oCAAoC;AACjD,iBAAc;;EAIhB,MAAM,KAAK,SAAS,MAAM;AAC1B,MAAI,GACF,SAAQ,KAAK,iBAAiB,GAAG,KAAK,KAAK,GAAG;EAIhD,MAAM,eAAe,SAAS,MAAM;AACpC,MAAI,gBAAgB,aAAa,SAAS,EACxC,SAAQ,KAAK,eAAe,aAAa,OAAO,UAAU;AAG5D,SAAO;GACL,MAAM;GACN,QAAQ,cAAc,SAAS;GAC/B,SAAS,cAAc,+BAA+B;GACtD;GACA,UAAU,KAAK,KAAK,GAAG;GACxB;;;;;CAMH,MAAM,aAAa,SAAiB,WAAwC;EAC1E,MAAM,YAAY,KAAK,KAAK;EAC5B,MAAM,UAAoB,EAAE;EAC5B,IAAI,cAAc;EAGlB,MAAM,aAAa,KAAK,kBAAkB,QAAQ;AAElD,MAAI,WAAW,WAAW,EACxB,QAAO;GACL,MAAM;GACN,QAAQ;GACR,SAAS;GACT,SAAS,CAAC,iCAAiC;GAC3C,UAAU,KAAK,KAAK,GAAG;GACxB;AAGH,UAAQ,KAAK,SAAS,WAAW,OAAO,gBAAgB;EAGxD,MAAM,gBAAgB,WAAW,QAAO,UAAS;GAC/C,MAAM,OAAO,MAAM,UAAU,aAAa;AAC1C,UAAO,SAAS,UAAU,SAAS,QAAQ,SAAS;IACpD;AAEF,MAAI,cAAc,SAAS,GAAG;AAC5B,WAAQ,KAAK,mBAAmB,cAAc,SAAS;AAGvD,QAAK,MAAM,OAAO,eAAe;IAC/B,MAAM,cAAc,KAAK,oBAAoB,IAAI,KAAK;AACtD,QAAI,CAAC,YAAY,OAAO;AACtB,aAAQ,KAAK,mBAAmB,YAAY,QAAQ;AACpD,mBAAc;;;;AAKpB,SAAO;GACL,MAAM;GACN,QAAQ,cAAc,SAAS;GAC/B,SAAS,cAAc,2BAA2B;GAClD;GACA,UAAU,KAAK,KAAK,GAAG;GACxB;;CAOH,oBAA4B,MAAoC;AAC9D,UAAQ,KAAK,MAAb;GACE,KAAK;AACH,QAAI,CAAC,KAAK,QACR,QAAO;KACL,MAAM;KACN,QAAQ;KACR,SAAS;KACV;AAEH;GACF,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;AACH,QAAI,CAAC,KAAK,QACR,QAAO;KACL,MAAM;KACN,QAAQ;KACR,SAAS;KACV;AAEH;GACF,KAAK;AACH,QAAI,CAAC,KAAK,OACR,QAAO;KACL,MAAM;KACN,QAAQ;KACR,SAAS;KACV;AAEH;GACF,KAAK;AACH,QAAI,CAAC,KAAK,QACR,QAAO;KACL,MAAM;KACN,QAAQ;KACR,SAAS;KACV;AAEH;;AAEJ,SAAO;GAAE,MAAM;GAAgB,QAAQ;GAAQ;;CAGjD,kBAA0B,SAA4D;EACpF,MAAM,SAAoD,EAAE;EAC5D,MAAM,QAAQ;EACd,IAAI;AAEJ,UAAQ,QAAQ,MAAM,KAAK,QAAQ,MAAM,KACvC,QAAO,KAAK;GACV,UAAU,MAAM,MAAM;GACtB,MAAM,MAAM,GAAG,MAAM;GACtB,CAAC;AAGJ,SAAO;;CAGT,oBAA4B,MAAkD;EAE5E,MAAM,QAAQ,KAAK,MAAM,KAAK,CAAC,QAAO,SAAQ,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC;AAE1F,OAAK,MAAM,QAAQ,OAAO;GAExB,MAAM,gBAAgB,KAAK,MAAM,KAAK,IAAI,EAAE,EAAE;GAC9C,MAAM,gBAAgB,KAAK,MAAM,KAAK,IAAI,EAAE,EAAE;AAE9C,OAAI,eAAe,MAAM,EACvB,QAAO;IAAE,OAAO;IAAO,OAAO;IAAyB;AAEzD,OAAI,eAAe,MAAM,EACvB,QAAO;IAAE,OAAO;IAAO,OAAO;IAAyB;AAMzD,QAFoB,KAAK,MAAM,MAAM,IAAI,EAAE,EAAE,YACxB,KAAK,MAAM,MAAM,IAAI,EAAE,EAAE,OAE5C,QAAO;IAAE,OAAO;IAAO,OAAO;IAA0B;;AAI5D,SAAO,EAAE,OAAO,MAAM;;CAGxB,aAAqB,UAAkB,SAAwC;EAC7E,MAAM,UAAU;GACd,OAAO,QAAQ;GACf,QAAQ,QAAQ,QAAO,MAAK,EAAE,WAAW,OAAO,CAAC;GACjD,QAAQ,QAAQ,QAAO,MAAK,EAAE,WAAW,OAAO,CAAC;GACjD,UAAU,QAAQ,QAAO,MAAK,EAAE,WAAW,OAAO,CAAC;GACnD,SAAS,QAAQ,QAAO,MAAK,EAAE,WAAW,OAAO,CAAC;GACnD;EAED,MAAM,SAAS,QAAQ,WAAW,MAAM,KAAK,QAAQ,SAAS,QAAQ,aAAa,IAAI;AAEvF,SAAO;GACL,WAAW,SAAS,SAAS;GAC7B,WAAW;GACX,WAAW,KAAK,KAAK;GACrB;GACA;GACA;GACD;;CAGH,oBAA4B,UAAkB,SAAkC;AAC9E,SAAO;GACL,WAAW,SAAS,SAAS;GAC7B,WAAW;GACX,WAAW,KAAK,KAAK;GACrB,SAAS,CAAC;IACR,MAAM;IACN,QAAQ;IACR;IACD,CAAC;GACF,SAAS;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACV;GACD,QAAQ;GACT;;;AAiBL,IAAa,kBAAb,MAA6B;CAC3B;CACA;CAEA,YAAY,SAA4B;AACtC,OAAK,UAAU;AACf,OAAK,YAAY,IAAI,mBAAmB,QAAQ;;CAGlD,MAAM,MAAgE;EACpE,MAAM,UAA6B,EAAE;EACrC,MAAM,YAAY,KAAK,QAAQ;AAE/B,MAAI,KAAK,EAAE,WAAW,EAAE,sBAAsB;EAG9C,MAAM,YAAY,KAAK,qBAAqB,UAAU;AAEtD,OAAK,MAAM,YAAY,WAAW;GAChC,MAAM,SAAS,MAAM,KAAK,UAAU,UAAU,SAAS;AACvD,WAAQ,KAAK,OAAO;;AAKtB,SAAO;GAAE;GAAS,QAFA,QAAQ,OAAM,MAAK,EAAE,OAEJ;GAAE;;CAGvC,qBAA6B,WAA6B;EACxD,MAAM,OAAiB,EAAE;AAEzB,MAAI;GACF,MAAM,UAAU,YAAY,WAAW,EAAE,eAAe,MAAM,CAAC;AAE/D,QAAK,MAAM,SAAS,QAClB,KAAI,MAAM,aAAa,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,EAAE;IACtD,MAAM,WAAW,KAAK,WAAW,MAAM,KAAK;AAG5C,QAAI,WAFgB,KAAK,UAAU,WAET,CAAC,CACzB,MAAK,KAAK,SAAS;;WAIlB,KAAK;AACZ,OAAI,KAAK,EAAE,OAAO,KAAK,EAAE,kCAAkC;;AAG7D,SAAO;;;;;;AAOX,SAAgB,kBAAkB,SAA4B,UAAU,OAAe;CACrF,MAAM,QAAkB,EAAE;AAE1B,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,OAAO,OAAO,SAAS,MAAM;AACnC,QAAM,KAAK,KAAK,KAAK,GAAG,OAAO,YAAY;AAC3C,QAAM,KAAK,IAAI,OAAO,GAAG,CAAC;AAE1B,OAAK,MAAM,UAAU,OAAO,SAAS;GACnC,MAAM,aAAa,OAAO,WAAW,SAAS,MAAM,OAAO,WAAW,SAAS,MAAM,OAAO,WAAW,SAAS,MAAM;AACtH,SAAM,KAAK,KAAK,WAAW,GAAG,OAAO,KAAK,IAAI,OAAO,WAAW,KAAK;AAErE,OAAI,WAAW,OAAO,QACpB,MAAK,MAAM,UAAU,OAAO,QAC1B,OAAM,KAAK,QAAQ,SAAS;;AAKlC,QAAM,KAAK,cAAc,OAAO,QAAQ,OAAO,GAAG,OAAO,QAAQ,MAAM,SAAS;AAChF,MAAI,OAAO,QAAQ,SAAS,EAC1B,OAAM,KAAK,aAAa,OAAO,QAAQ,SAAS;AAElD,MAAI,OAAO,QAAQ,WAAW,EAC5B,OAAM,KAAK,eAAe,OAAO,QAAQ,WAAW;;CAIxD,MAAM,aAAa,QAAQ,QAAQ,KAAK,MAAM,MAAM,EAAE,QAAQ,OAAO,EAAE;CACvE,MAAM,cAAc,QAAQ,QAAQ,KAAK,MAAM,MAAM,EAAE,QAAQ,QAAQ,EAAE;CACzE,MAAM,cAAc,QAAQ,QAAQ,KAAK,MAAM,MAAM,EAAE,QAAQ,QAAQ,EAAE;CACzE,MAAM,gBAAgB,QAAQ,QAAQ,KAAK,MAAM,MAAM,EAAE,QAAQ,UAAU,EAAE;AAE7E,OAAM,KAAK,OAAO,IAAI,OAAO,GAAG,CAAC;AACjC,OAAM,KAAK,UAAU,WAAW,UAAU,YAAY,WAAW,YAAY,WAAW,cAAc,WAAW;CAEjH,MAAM,YAAY,QAAQ,OAAM,MAAK,EAAE,OAAO;AAC9C,OAAM,KAAK,WAAW,YAAY,aAAa,aAAa;AAE5D,QAAO,MAAM,KAAK,KAAK;;;;;AAMzB,SAAgB,sBAAsB,SAAoC;AACxE,QAAO,KAAK,UAAU;EACpB,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,aAAa,QAAQ;EACrB,cAAc,QAAQ,QAAO,MAAK,EAAE,OAAO,CAAC;EAC5C;EACD,EAAE,MAAM,EAAE;;;;;AAMb,SAAgB,qBAAqB,SAAoC;CACvE,MAAM,QAAkB,EAAE;CAC1B,IAAI,UAAU;AAEd,OAAM,KAAK,iBAAiB;AAC5B,OAAM,KAAK,MAAM,QAAQ,QAAQ,KAAK,MAAM,MAAM,EAAE,QAAQ,QAAQ,EAAE,GAAG;AAEzE,MAAK,MAAM,UAAU,QACnB,MAAK,MAAM,UAAU,OAAO,SAAS;EACnC,MAAM,SAAS,OAAO,WAAW,SAAS,OAAO;EACjD,MAAM,SAAS;AACf,QAAM,KAAK,GAAG,OAAO,GAAG,OAAO,KAAK,OAAO,UAAU,IAAI,OAAO,OAAO;AAEvE,MAAI,OAAO,WAAW,UAAU,OAAO,SAAS;AAC9C,SAAM,KAAK,QAAQ;AACnB,SAAM,KAAK,cAAc,OAAO,UAAU;AAC1C,SAAM,KAAK,QAAQ;;;AAKzB,QAAO,MAAM,KAAK,KAAK"}
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 { 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/streaming/reasoning-visibility-sse.js CHANGED Viewed

@@ -5,6 +5,7 @@
 function applyReasoningVisibilityToSseEvent(event, reasoningLevel) {
 	if (reasoningLevel !== "off") return event;
 	if (event.type === "thinking") return null;
+	if (event.type === "message_update" && event.assistantMessageEvent?.type === "thinking_delta") return null;
 	if (event.type === "progress" && event.stage === "thinking") return null;
 	return event;
 }

package/dist/src/agent/streaming/reasoning-visibility-sse.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"reasoning-visibility-sse.js","names":[],"sources":["../../../../src/agent/streaming/reasoning-visibility-sse.ts"],"sourcesContent":["/*\n Outbound SSE visibility for session `reasoningLevel`.\n * Single choke point: call from the queue push path so agent subscribe stays free of policy branches.\n \n Note: Does not alter persisted messages or agent state; history/UI may still strip thinking separately.\n /\n\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\n\nexport type SseStreamEvent = { type: string; [key: string]: unknown };\n\n/\n @returns `null` to drop the event; unchanged `event` otherwise.\n */\nexport function applyReasoningVisibilityToSseEvent(\n event: SseStreamEvent,\n reasoningLevel: ReasoningLevel,\n): SseStreamEvent \| null {\n if (reasoningLevel !== 'off') {\n return event;\n }\n if (event.type === 'thinking') {\n return null;\n }\n if (event.type === 'progress' && event.stage === 'thinking') {\n return null;\n }\n return event;\n}\n"],"mappings":";;;;AAcA,SAAgB,mCACd,OACA,gBACuB;AACvB,KAAI,mBAAmB,MACrB,QAAO;AAET,KAAI,MAAM,SAAS,WACjB,QAAO;AAET,KAAI,MAAM,SAAS,cAAc,MAAM,UAAU,WAC/C,QAAO;AAET,QAAO"}
1	+ {"version":3,"file":"reasoning-visibility-sse.js","names":[],"sources":["../../../../src/agent/streaming/reasoning-visibility-sse.ts"],"sourcesContent":["/*\n Outbound SSE visibility for session `reasoningLevel`.\n * Single choke point: call from the queue push path so agent subscribe stays free of policy branches.\n \n Note: Does not alter persisted messages or agent state; history/UI may still strip thinking separately.\n /\n\nimport type { ReasoningLevel } from '../transcript/thinking-types.js';\n\nexport type SseStreamEvent = { type: string; [key: string]: unknown };\n\n/\n @returns `null` to drop the event; unchanged `event` otherwise.\n */\nexport function applyReasoningVisibilityToSseEvent(\n event: SseStreamEvent,\n reasoningLevel: ReasoningLevel,\n): SseStreamEvent \| null {\n if (reasoningLevel !== 'off') {\n return event;\n }\n if (event.type === 'thinking') {\n return null;\n }\n if (\n event.type === 'message_update' &&\n (event.assistantMessageEvent as { type?: unknown } \| undefined)?.type === 'thinking_delta'\n ) {\n return null;\n }\n if (event.type === 'progress' && event.stage === 'thinking') {\n return null;\n }\n return event;\n}\n"],"mappings":";;;;AAcA,SAAgB,mCACd,OACA,gBACuB;AACvB,KAAI,mBAAmB,MACrB,QAAO;AAET,KAAI,MAAM,SAAS,WACjB,QAAO;AAET,KACE,MAAM,SAAS,oBACd,MAAM,uBAA0D,SAAS,iBAE1E,QAAO;AAET,KAAI,MAAM,SAAS,cAAc,MAAM,UAAU,WAC/C,QAAO;AAET,QAAO"}

package/dist/src/agent/tool-manuals/browser.d.ts ADDED Viewed

@@ -0,0 +1 @@

+ export declare const browserUseManual = "# Browser Tool Manual\n\n## Overview\n\n`browser_use` is XOPC's unified browser tool. It supports four modes:\n\n| Mode | Purpose |\n|------|---------|\n| `command` | Run a single browser action |\n| `pipeline` | Run a multi-step YAML flow |\n| `inspect` | Read current page state |\n| `close` | Close the browser session |\n\n## When to use\n\n- Open pages, click controls, fill forms\n- Capture screenshots or page content\n- Run multi-step automation flows\n- Extract data from pages\n\n## Command mode\n\n### Basic shape\n\n```json\n{\n \"mode\": \"command\",\n \"command\": \"<action>\",\n \"args\": { ... }\n}\n```\n\n### Available commands\n\n| Command | Description | Key arguments |\n|---------|-------------|---------------|\n| `open` / `navigate` | Open a URL | `url`, `wait_until` |\n| `state` / `snapshot` | ARIA snapshot of the page | `selector`, `maxLength` |\n| `click` | Click an element | `selector` / `text` / `role` |\n| `type` / `input` | Type text | `selector` / `label`, `text`, `pressEnter` |\n| `scroll` | Scroll the page | `direction`, `amount` |\n| `screenshot` | Screenshot | `selector`, `full_page`, `path` |\n| `back` | Go back | `waitFor` |\n| `keys` / `press` | Keyboard input | `key` |\n| `console` / `eval` | Run JavaScript | `javascript` |\n| `images` | Collect images on the page | `selector`, `maxImages` |\n| `wait` | Wait for element/time | `selector` / `text` / `ms`, `timeout_ms` |\n| `dialog` | Handle dialogs | `action` (accept/dismiss) |\n| `close` | Close the current page | \u2014 |\n\n### Element targeting\n\nPrefer, in order:\n\n1. **ARIA role**: most stable, e.g. `\"role\": \"button:Submit\"`\n2. **Visible text**, e.g. `\"text\": \"Sign In\"`\n3. **CSS selector**, e.g. `\"selector\": \"#login-btn\"`\n\nGuidelines:\n\n- Use `inspect` or `state` first to get a snapshot\n- Pick locators from ARIA info in the snapshot\n- Avoid dynamic class names when possible\n\n## Inspect mode\n\nBefore acting, understand the current page:\n\n```json\n{ \"mode\": \"inspect\" }\n```\n\nReturns: current URL, title, ARIA snapshot.\n\n**Best practice**: after each navigation, inspect, then choose the next step.\n\n## Pipeline mode\n\nFor multi-step, reusable flows. Uses a brocli-style YAML DSL.\n\n### Run from file\n\n```json\n{\n \"mode\": \"pipeline\",\n \"pipeline\": {\n \"path\": \"./browser-flow.yaml\",\n \"args\": { \"url\": \"https://example.com\" }\n }\n}\n```\n\n### Run inline YAML\n\n```json\n{\n \"mode\": \"pipeline\",\n \"pipeline\": {\n \"yaml\": \"name: quick-check\\npipeline:\\n - navigate:\\n url: https://example.com\\n - screenshot:\\n full_page: true\",\n \"dryRun\": false\n }\n}\n```\n\n### YAML layout\n\n```yaml\nname: pipeline-name\ndescription: What this flow does\nargs:\n url:\n type: string\n required: true\n query:\n type: string\n default: \"hello\"\npipeline:\n - navigate:\n url: ${{ args.url }}\n wait_until: domcontentloaded\n - wait:\n selector: input[name=\"q\"]\n - type:\n selector: input[name=\"q\"]\n text: ${{ args.query }}\n - press:\n key: Enter\n - wait:\n selector: body\n timeout_ms: 10000\n - screenshot:\n path: ./artifacts/result.png\n full_page: true\n - output:\n value:\n screenshot: ./artifacts/result.png\non_error:\n - screenshot:\n path: ./artifacts/error.png\n full_page: true\n```\n\n### Authoring rules\n\n1. One action per step\n2. Use `${{ args.xxx }}` for parameters\n3. Use `${{ data }}` or `${{ data | json }}` for the previous step's result\n4. Use `on_error` to collect diagnostics after failure\n\n### Validate without running\n\n```json\n{\n \"mode\": \"pipeline\",\n \"pipeline\": {\n \"yaml\": \"...\",\n \"dryRun\": true\n }\n}\n```\n\n## Recovery when something fails\n\n1. `inspect` to see current state\n2. Confirm the URL (redirects may have changed it)\n3. Use the snapshot to see if the page finished loading\n4. `screenshot` for visual debugging\n5. `wait` for elements, then retry\n\n## Safety\n\n- Do not put API keys or tokens in URLs\n- Do not target private IPs / localhost unless configuration allows it\n- Cloud metadata endpoints are always blocked\n- For destructive actions (submit forms, delete data), confirm intent with the user first\n";

package/{skills/browser/SKILL.md → dist/src/agent/tool-manuals/browser.js} RENAMED Viewed

@@ -1,24 +1,16 @@
----
-name: browser
-description: Use browser_use for web navigation, page inspection, UI interaction, screenshots, network capture, and reusable browser pipelines. Load this skill before complex browser tasks.
-metadata:
-  xopc:
-    requires_tools:
-      - browser_use
----
-# Browser Skill
+//#region src/agent/tool-manuals/browser.ts
+const browserUseManual = `# Browser Tool Manual
 ## Overview
-`browser_use` is XOPC’s unified browser tool. It supports four modes:
+\`browser_use\` is XOPC's unified browser tool. It supports four modes:
 | Mode | Purpose |
 |------|---------|
-| `command` | Run a single browser action |
-| `pipeline` | Run a multi-step YAML flow |
-| `inspect` | Read current page state |
-| `close` | Close the browser session |
+| \`command\` | Run a single browser action |
+| \`pipeline\` | Run a multi-step YAML flow |
+| \`inspect\` | Read current page state |
+| \`close\` | Close the browser session |
 ## When to use
@@ -31,43 +23,43 @@ metadata:
 ### Basic shape
-```json
+\`\`\`json
 {
   "mode": "command",
   "command": "<action>",
   "args": { ... }
 }
-```
+\`\`\`
 ### Available commands
 | Command | Description | Key arguments |
-|---------|-------------|----------------|
-| `open` / `navigate` | Open a URL | `url`, `wait_until` |
-| `state` / `snapshot` | ARIA snapshot of the page | `selector`, `maxLength` |
-| `click` | Click an element | `selector` / `text` / `role` |
-| `type` / `input` | Type text | `selector` / `label`, `text`, `pressEnter` |
-| `scroll` | Scroll the page | `direction`, `amount` |
-| `screenshot` | Screenshot | `selector`, `full_page`, `path` |
-| `back` | Go back | `waitFor` |
-| `keys` / `press` | Keyboard input | `key` |
-| `console` / `eval` | Run JavaScript | `javascript` |
-| `images` | Collect images on the page | `selector`, `maxImages` |
-| `wait` | Wait for element/time | `selector` / `text` / `ms`, `timeout_ms` |
-| `dialog` | Handle dialogs | `action` (accept/dismiss) |
-| `close` | Close the current page | — |
+|---------|-------------|---------------|
+| \`open\` / \`navigate\` | Open a URL | \`url\`, \`wait_until\` |
+| \`state\` / \`snapshot\` | ARIA snapshot of the page | \`selector\`, \`maxLength\` |
+| \`click\` | Click an element | \`selector\` / \`text\` / \`role\` |
+| \`type\` / \`input\` | Type text | \`selector\` / \`label\`, \`text\`, \`pressEnter\` |
+| \`scroll\` | Scroll the page | \`direction\`, \`amount\` |
+| \`screenshot\` | Screenshot | \`selector\`, \`full_page\`, \`path\` |
+| \`back\` | Go back | \`waitFor\` |
+| \`keys\` / \`press\` | Keyboard input | \`key\` |
+| \`console\` / \`eval\` | Run JavaScript | \`javascript\` |
+| \`images\` | Collect images on the page | \`selector\`, \`maxImages\` |
+| \`wait\` | Wait for element/time | \`selector\` / \`text\` / \`ms\`, \`timeout_ms\` |
+| \`dialog\` | Handle dialogs | \`action\` (accept/dismiss) |
+| \`close\` | Close the current page | — |
 ### Element targeting
 Prefer, in order:
-1. **ARIA role**: most stable, e.g. `"role": "button:Submit"`
-2. **Visible text**, e.g. `"text": "Sign In"`
-3. **CSS selector**, e.g. `"selector": "#login-btn"`
+1. **ARIA role**: most stable, e.g. \`"role": "button:Submit"\`
+2. **Visible text**, e.g. \`"text": "Sign In"\`
+3. **CSS selector**, e.g. \`"selector": "#login-btn"\`
 Guidelines:
-- Use `inspect` or `state` first to get a snapshot
+- Use \`inspect\` or \`state\` first to get a snapshot
 - Pick locators from ARIA info in the snapshot
 - Avoid dynamic class names when possible
@@ -75,9 +67,9 @@ Guidelines:
 Before acting, understand the current page:
-```json
+\`\`\`json
 { "mode": "inspect" }
-```
+\`\`\`
 Returns: current URL, title, ARIA snapshot.
@@ -89,7 +81,7 @@ For multi-step, reusable flows. Uses a brocli-style YAML DSL.
 ### Run from file
-```json
+\`\`\`json
 {
   "mode": "pipeline",
   "pipeline": {
@@ -97,23 +89,23 @@ For multi-step, reusable flows. Uses a brocli-style YAML DSL.
     "args": { "url": "https://example.com" }
   }
 }
-```
+\`\`\`
 ### Run inline YAML
-```json
+\`\`\`json
 {
   "mode": "pipeline",
   "pipeline": {
-    "yaml": "name: quick-check\npipeline:\n  - navigate:\n      url: https://example.com\n  - screenshot:\n      full_page: true",
+    "yaml": "name: quick-check\\npipeline:\\n  - navigate:\\n      url: https://example.com\\n  - screenshot:\\n      full_page: true",
     "dryRun": false
   }
 }
-```
+\`\`\`
 ### YAML layout
-```yaml
+\`\`\`yaml
 name: pipeline-name
 description: What this flow does
 args:
@@ -125,13 +117,13 @@ args:
     default: "hello"
 pipeline:
   - navigate:
-      url: ${{ args.url }}
+      url: \${{ args.url }}
       wait_until: domcontentloaded
   - wait:
       selector: input[name="q"]
   - type:
       selector: input[name="q"]
-      text: ${{ args.query }}
+      text: \${{ args.query }}
   - press:
       key: Enter
   - wait:
@@ -147,18 +139,18 @@ on_error:
   - screenshot:
       path: ./artifacts/error.png
       full_page: true
-```
+\`\`\`
 ### Authoring rules
 1. One action per step
-2. Use `${{ args.xxx }}` for parameters
-3. Use `${{ data }}` or `${{ data | json }}` for the previous step’s result
-4. Use `on_error` to collect diagnostics after failure
+2. Use \`\${{ args.xxx }}\` for parameters
+3. Use \`\${{ data }}\` or \`\${{ data | json }}\` for the previous step's result
+4. Use \`on_error\` to collect diagnostics after failure
 ### Validate without running
-```json
+\`\`\`json
 {
   "mode": "pipeline",
   "pipeline": {
@@ -166,15 +158,15 @@ on_error:
     "dryRun": true
   }
 }
-```
+\`\`\`
 ## Recovery when something fails
-1. `inspect` to see current state
+1. \`inspect\` to see current state
 2. Confirm the URL (redirects may have changed it)
 3. Use the snapshot to see if the page finished loading
-4. `screenshot` for visual debugging
-5. `wait` for elements, then retry
+4. \`screenshot\` for visual debugging
+5. \`wait\` for elements, then retry
 ## Safety
@@ -182,3 +174,8 @@ on_error:
 - Do not target private IPs / localhost unless configuration allows it
 - Cloud metadata endpoints are always blocked
 - For destructive actions (submit forms, delete data), confirm intent with the user first
+`;
+//#endregion
+export { browserUseManual };
+//# sourceMappingURL=browser.js.map

package/dist/src/agent/tool-manuals/browser.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"browser.js","names":[],"sources":["../../../../src/agent/tool-manuals/browser.ts"],"sourcesContent":["export const browserUseManual = `# Browser Tool Manual\n\n## Overview\n\n\\`browser_use\\` is XOPC's unified browser tool. It supports four modes:\n\n| Mode | Purpose |\n|------|---------|\n| \\`command\\` | Run a single browser action |\n| \\`pipeline\\` | Run a multi-step YAML flow |\n| \\`inspect\\` | Read current page state |\n| \\`close\\` | Close the browser session |\n\n## When to use\n\n- Open pages, click controls, fill forms\n- Capture screenshots or page content\n- Run multi-step automation flows\n- Extract data from pages\n\n## Command mode\n\n### Basic shape\n\n\\`\\`\\`json\n{\n \"mode\": \"command\",\n \"command\": \"<action>\",\n \"args\": { ... }\n}\n\\`\\`\\`\n\n### Available commands\n\n| Command | Description | Key arguments |\n|---------|-------------|---------------|\n| \\`open\\` / \\`navigate\\` | Open a URL | \\`url\\`, \\`wait_until\\` |\n| \\`state\\` / \\`snapshot\\` | ARIA snapshot of the page | \\`selector\\`, \\`maxLength\\` |\n| \\`click\\` | Click an element | \\`selector\\` / \\`text\\` / \\`role\\` |\n| \\`type\\` / \\`input\\` | Type text | \\`selector\\` / \\`label\\`, \\`text\\`, \\`pressEnter\\` |\n| \\`scroll\\` | Scroll the page | \\`direction\\`, \\`amount\\` |\n| \\`screenshot\\` | Screenshot | \\`selector\\`, \\`full_page\\`, \\`path\\` |\n| \\`back\\` | Go back | \\`waitFor\\` |\n| \\`keys\\` / \\`press\\` | Keyboard input | \\`key\\` |\n| \\`console\\` / \\`eval\\` | Run JavaScript | \\`javascript\\` |\n| \\`images\\` | Collect images on the page | \\`selector\\`, \\`maxImages\\` |\n| \\`wait\\` | Wait for element/time | \\`selector\\` / \\`text\\` / \\`ms\\`, \\`timeout_ms\\` |\n| \\`dialog\\` | Handle dialogs | \\`action\\` (accept/dismiss) |\n| \\`close\\` | Close the current page | — |\n\n### Element targeting\n\nPrefer, in order:\n\n1. **ARIA role**: most stable, e.g. \\`\"role\": \"button:Submit\"\\`\n2. **Visible text**, e.g. \\`\"text\": \"Sign In\"\\`\n3. **CSS selector**, e.g. \\`\"selector\": \"#login-btn\"\\`\n\nGuidelines:\n\n- Use \\`inspect\\` or \\`state\\` first to get a snapshot\n- Pick locators from ARIA info in the snapshot\n- Avoid dynamic class names when possible\n\n## Inspect mode\n\nBefore acting, understand the current page:\n\n\\`\\`\\`json\n{ \"mode\": \"inspect\" }\n\\`\\`\\`\n\nReturns: current URL, title, ARIA snapshot.\n\n**Best practice**: after each navigation, inspect, then choose the next step.\n\n## Pipeline mode\n\nFor multi-step, reusable flows. Uses a brocli-style YAML DSL.\n\n### Run from file\n\n\\`\\`\\`json\n{\n \"mode\": \"pipeline\",\n \"pipeline\": {\n \"path\": \"./browser-flow.yaml\",\n \"args\": { \"url\": \"https://example.com\" }\n }\n}\n\\`\\`\\`\n\n### Run inline YAML\n\n\\`\\`\\`json\n{\n \"mode\": \"pipeline\",\n \"pipeline\": {\n \"yaml\": \"name: quick-check\\\\npipeline:\\\\n - navigate:\\\\n url: https://example.com\\\\n - screenshot:\\\\n full_page: true\",\n \"dryRun\": false\n }\n}\n\\`\\`\\`\n\n### YAML layout\n\n\\`\\`\\`yaml\nname: pipeline-name\ndescription: What this flow does\nargs:\n url:\n type: string\n required: true\n query:\n type: string\n default: \"hello\"\npipeline:\n - navigate:\n url: \\${{ args.url }}\n wait_until: domcontentloaded\n - wait:\n selector: input[name=\"q\"]\n - type:\n selector: input[name=\"q\"]\n text: \\${{ args.query }}\n - press:\n key: Enter\n - wait:\n selector: body\n timeout_ms: 10000\n - screenshot:\n path: ./artifacts/result.png\n full_page: true\n - output:\n value:\n screenshot: ./artifacts/result.png\non_error:\n - screenshot:\n path: ./artifacts/error.png\n full_page: true\n\\`\\`\\`\n\n### Authoring rules\n\n1. One action per step\n2. Use \\`\\${{ args.xxx }}\\` for parameters\n3. Use \\`\\${{ data }}\\` or \\`\\${{ data | json }}\\` for the previous step's result\n4. Use \\`on_error\\` to collect diagnostics after failure\n\n### Validate without running\n\n\\`\\`\\`json\n{\n \"mode\": \"pipeline\",\n \"pipeline\": {\n \"yaml\": \"...\",\n \"dryRun\": true\n }\n}\n\\`\\`\\`\n\n## Recovery when something fails\n\n1. \\`inspect\\` to see current state\n2. Confirm the URL (redirects may have changed it)\n3. Use the snapshot to see if the page finished loading\n4. \\`screenshot\\` for visual debugging\n5. \\`wait\\` for elements, then retry\n\n## Safety\n\n- Do not put API keys or tokens in URLs\n- Do not target private IPs / localhost unless configuration allows it\n- Cloud metadata endpoints are always blocked\n- For destructive actions (submit forms, delete data), confirm intent with the user first\n`;\n"],"mappings":";AAAA,MAAa,mBAAmB"}

package/dist/src/agent/tool-manuals/index.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+export interface ToolManual {
+    toolName: string;
+    title: string;
+    description: string;
+    content: string;
+}
+export type ToolManualSummary = Omit<ToolManual, 'content'>;
+export declare function getToolManual(toolName: string): ToolManual | null;
+export declare function hasToolManual(toolName: string): boolean;
+export declare function listToolManuals(): ToolManualSummary[];

package/dist/src/agent/tool-manuals/index.js ADDED Viewed

@@ -0,0 +1,28 @@
+import { browserUseManual } from "./browser.js";
+//#region src/agent/tool-manuals/index.ts
+const TOOL_MANUALS = { browser_use: {
+	toolName: "browser_use",
+	title: "Browser Tool Manual",
+	description: "Usage guide for browser navigation, inspection, interaction, screenshots, and pipelines.",
+	content: browserUseManual
+} };
+function normalizeToolName(toolName) {
+	return toolName.trim().toLowerCase();
+}
+function getToolManual(toolName) {
+	return TOOL_MANUALS[normalizeToolName(toolName)] ?? null;
+}
+function hasToolManual(toolName) {
+	return getToolManual(toolName) !== null;
+}
+function listToolManuals() {
+	return Object.values(TOOL_MANUALS).map(({ toolName, title, description }) => ({
+		toolName,
+		title,
+		description
+	})).sort((a, b) => a.toolName.localeCompare(b.toolName));
+}
+//#endregion
+export { getToolManual, hasToolManual, listToolManuals };
+//# sourceMappingURL=index.js.map

package/dist/src/agent/tool-manuals/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","names":[],"sources":["../../../../src/agent/tool-manuals/index.ts"],"sourcesContent":["import { browserUseManual } from './browser.js';\n\nexport interface ToolManual {\n toolName: string;\n title: string;\n description: string;\n content: string;\n}\n\nexport type ToolManualSummary = Omit<ToolManual, 'content'>;\n\nconst TOOL_MANUALS: Record<string, ToolManual> = {\n browser_use: {\n toolName: 'browser_use',\n title: 'Browser Tool Manual',\n description: 'Usage guide for browser navigation, inspection, interaction, screenshots, and pipelines.',\n content: browserUseManual,\n },\n};\n\nfunction normalizeToolName(toolName: string): string {\n return toolName.trim().toLowerCase();\n}\n\nexport function getToolManual(toolName: string): ToolManual | null {\n return TOOL_MANUALS[normalizeToolName(toolName)] ?? null;\n}\n\nexport function hasToolManual(toolName: string): boolean {\n return getToolManual(toolName) !== null;\n}\n\nexport function listToolManuals(): ToolManualSummary[] {\n return Object.values(TOOL_MANUALS)\n .map(({ toolName, title, description }) => ({ toolName, title, description }))\n .sort((a, b) => a.toolName.localeCompare(b.toolName));\n}\n"],"mappings":";;AAWA,MAAM,eAA2C,EAC/C,aAAa;CACX,UAAU;CACV,OAAO;CACP,aAAa;CACb,SAAS;CACV,EACF;AAED,SAAS,kBAAkB,UAA0B;AACnD,QAAO,SAAS,MAAM,CAAC,aAAa;;AAGtC,SAAgB,cAAc,UAAqC;AACjE,QAAO,aAAa,kBAAkB,SAAS,KAAK;;AAGtD,SAAgB,cAAc,UAA2B;AACvD,QAAO,cAAc,SAAS,KAAK;;AAGrC,SAAgB,kBAAuC;AACrD,QAAO,OAAO,OAAO,aAAa,CAC/B,KAAK,EAAE,UAAU,OAAO,mBAAmB;EAAE;EAAU;EAAO;EAAa,EAAE,CAC7E,MAAM,GAAG,MAAM,EAAE,SAAS,cAAc,EAAE,SAAS,CAAC"}

package/dist/src/agent/tools/browser/tool/browser-use-tool.js CHANGED Viewed

@@ -85,7 +85,7 @@ function createBrowserUseTool(deps) {
 	return {
 		name: "browser_use",
 		label: "🌐 Browser",
-		description: "Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the \"browser\" skill first with skill_view.",
+		description: "Use a persistent browser for web navigation, page inspection, interaction, screenshots, network capture, and scripted browser pipelines. For non-trivial browser tasks, load the built-in manual first with tool_manual({ tool: \"browser_use\" }).",
 		parameters: BrowserUseSchema,
 		async execute(_toolCallId, params, signal, _onUpdate) {
 			const { mode, command, args: cmdArgs, pipeline: pipelineParams, options: _options } = params;