@aigne/agent-runtime 1.12.0-beta.5

package/dist/program/tool-discovery/ash-frontmatter.cjs

@@ -0,0 +1,83 @@
+let js_yaml = require("js-yaml");
+
+//#region src/program/tool-discovery/ash-frontmatter.ts
+/**
+* ASH frontmatter parser (S13).
+*
+* Extracts tool schemas from `# ---` YAML blocks in .ash files.
+* All file I/O goes through AFS (never `fs.readFile`).
+*/
+/**
+* Parse the `# ---` YAML frontmatter from an .ash file.
+* Returns ToolSchema on success, FrontmatterError on failure.
+*/
+async function parseFrontmatter(afs, filePath) {
+	let content;
+	try {
+		content = await afs.read(filePath);
+	} catch {
+		return {
+			error: `Failed to read file: ${filePath}`,
+			file: filePath
+		};
+	}
+	if (!content || !content.trim()) return {
+		error: "Empty file",
+		file: filePath
+	};
+	const yamlBlock = extractYamlBlock(content);
+	if (!yamlBlock) return {
+		error: "No valid frontmatter block found (missing # --- delimiters)",
+		file: filePath
+	};
+	let parsed;
+	try {
+		parsed = (0, js_yaml.load)(yamlBlock);
+	} catch (e) {
+		return {
+			error: `YAML parse error: ${e instanceof Error ? e.message : String(e)}`,
+			file: filePath
+		};
+	}
+	if (!parsed || typeof parsed !== "object") return {
+		error: "Frontmatter must be a YAML mapping",
+		file: filePath
+	};
+	const name = parsed.name;
+	if (!name || typeof name !== "string" || !name.trim()) return {
+		error: "Missing or empty 'name' field in frontmatter",
+		file: filePath
+	};
+	const description = typeof parsed.description === "string" ? parsed.description.trim() : "";
+	const input = typeof parsed.input === "object" && parsed.input !== null ? parsed.input : void 0;
+	const output = typeof parsed.output === "object" && parsed.output !== null ? parsed.output : void 0;
+	return {
+		name: name.trim(),
+		description,
+		filePath,
+		input,
+		output
+	};
+}
+function extractYamlBlock(content) {
+	const lines = content.split("\n");
+	let startIdx = -1;
+	let endIdx = -1;
+	for (let i = 0; i < lines.length; i++) if (lines[i].trim() === "# ---") if (startIdx === -1) startIdx = i;
+	else {
+		endIdx = i;
+		break;
+	}
+	if (startIdx === -1 || endIdx === -1) return null;
+	const yamlLines = [];
+	for (let i = startIdx + 1; i < endIdx; i++) {
+		const line = lines[i];
+		if (line.startsWith("# ")) yamlLines.push(line.slice(2));
+		else if (line.startsWith("#")) yamlLines.push(line.slice(1));
+		else yamlLines.push(line);
+	}
+	return yamlLines.join("\n");
+}
+
+//#endregion
+exports.parseFrontmatter = parseFrontmatter;

package/dist/program/tool-discovery/ash-frontmatter.d.cts

@@ -0,0 +1,21 @@
+//#region src/program/tool-discovery/ash-frontmatter.d.ts
+/**
+ * ASH frontmatter parser (S13).
+ *
+ * Extracts tool schemas from `# ---` YAML blocks in .ash files.
+ * All file I/O goes through AFS (never `fs.readFile`).
+ */
+interface ToolSchema {
+  name: string;
+  description: string;
+  filePath: string;
+  input?: Record<string, {
+    type?: string;
+    required?: boolean;
+    description?: string;
+  }>;
+  output?: Record<string, unknown>;
+}
+//#endregion
+export { ToolSchema };
+//# sourceMappingURL=ash-frontmatter.d.cts.map

package/dist/program/tool-discovery/ash-frontmatter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-frontmatter.d.cts","names":[],"sources":["../../../src/program/tool-discovery/ash-frontmatter.ts"],"mappings":";;AASA;;;;;UAAiB,UAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,KAAA,GAAQ,MAAA;IAAiB,IAAA;IAAe,QAAA;IAAoB,WAAA;EAAA;EAC5D,MAAA,GAAS,MAAA;AAAA"}

package/dist/program/tool-discovery/ash-frontmatter.d.mts

@@ -0,0 +1,21 @@
+//#region src/program/tool-discovery/ash-frontmatter.d.ts
+/**
+ * ASH frontmatter parser (S13).
+ *
+ * Extracts tool schemas from `# ---` YAML blocks in .ash files.
+ * All file I/O goes through AFS (never `fs.readFile`).
+ */
+interface ToolSchema {
+  name: string;
+  description: string;
+  filePath: string;
+  input?: Record<string, {
+    type?: string;
+    required?: boolean;
+    description?: string;
+  }>;
+  output?: Record<string, unknown>;
+}
+//#endregion
+export { ToolSchema };
+//# sourceMappingURL=ash-frontmatter.d.mts.map

package/dist/program/tool-discovery/ash-frontmatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-frontmatter.d.mts","names":[],"sources":["../../../src/program/tool-discovery/ash-frontmatter.ts"],"mappings":";;AASA;;;;;UAAiB,UAAA;EACf,IAAA;EACA,WAAA;EACA,QAAA;EACA,KAAA,GAAQ,MAAA;IAAiB,IAAA;IAAe,QAAA;IAAoB,WAAA;EAAA;EAC5D,MAAA,GAAS,MAAA;AAAA"}

package/dist/program/tool-discovery/ash-frontmatter.mjs

@@ -0,0 +1,84 @@
+import { load } from "js-yaml";
+
+//#region src/program/tool-discovery/ash-frontmatter.ts
+/**
+* ASH frontmatter parser (S13).
+*
+* Extracts tool schemas from `# ---` YAML blocks in .ash files.
+* All file I/O goes through AFS (never `fs.readFile`).
+*/
+/**
+* Parse the `# ---` YAML frontmatter from an .ash file.
+* Returns ToolSchema on success, FrontmatterError on failure.
+*/
+async function parseFrontmatter(afs, filePath) {
+	let content;
+	try {
+		content = await afs.read(filePath);
+	} catch {
+		return {
+			error: `Failed to read file: ${filePath}`,
+			file: filePath
+		};
+	}
+	if (!content || !content.trim()) return {
+		error: "Empty file",
+		file: filePath
+	};
+	const yamlBlock = extractYamlBlock(content);
+	if (!yamlBlock) return {
+		error: "No valid frontmatter block found (missing # --- delimiters)",
+		file: filePath
+	};
+	let parsed;
+	try {
+		parsed = load(yamlBlock);
+	} catch (e) {
+		return {
+			error: `YAML parse error: ${e instanceof Error ? e.message : String(e)}`,
+			file: filePath
+		};
+	}
+	if (!parsed || typeof parsed !== "object") return {
+		error: "Frontmatter must be a YAML mapping",
+		file: filePath
+	};
+	const name = parsed.name;
+	if (!name || typeof name !== "string" || !name.trim()) return {
+		error: "Missing or empty 'name' field in frontmatter",
+		file: filePath
+	};
+	const description = typeof parsed.description === "string" ? parsed.description.trim() : "";
+	const input = typeof parsed.input === "object" && parsed.input !== null ? parsed.input : void 0;
+	const output = typeof parsed.output === "object" && parsed.output !== null ? parsed.output : void 0;
+	return {
+		name: name.trim(),
+		description,
+		filePath,
+		input,
+		output
+	};
+}
+function extractYamlBlock(content) {
+	const lines = content.split("\n");
+	let startIdx = -1;
+	let endIdx = -1;
+	for (let i = 0; i < lines.length; i++) if (lines[i].trim() === "# ---") if (startIdx === -1) startIdx = i;
+	else {
+		endIdx = i;
+		break;
+	}
+	if (startIdx === -1 || endIdx === -1) return null;
+	const yamlLines = [];
+	for (let i = startIdx + 1; i < endIdx; i++) {
+		const line = lines[i];
+		if (line.startsWith("# ")) yamlLines.push(line.slice(2));
+		else if (line.startsWith("#")) yamlLines.push(line.slice(1));
+		else yamlLines.push(line);
+	}
+	return yamlLines.join("\n");
+}
+
+//#endregion
+export { parseFrontmatter };
+//# sourceMappingURL=ash-frontmatter.mjs.map

package/dist/program/tool-discovery/ash-frontmatter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ash-frontmatter.mjs","names":["parseYAML"],"sources":["../../../src/program/tool-discovery/ash-frontmatter.ts"],"sourcesContent":["/**\n * ASH frontmatter parser (S13).\n *\n * Extracts tool schemas from `# ---` YAML blocks in .ash files.\n * All file I/O goes through AFS (never `fs.readFile`).\n */\n\nimport { load as parseYAML } from \"js-yaml\";\n\nexport interface ToolSchema {\n  name: string;\n  description: string;\n  filePath: string;\n  input?: Record<string, { type?: string; required?: boolean; description?: string }>;\n  output?: Record<string, unknown>;\n}\n\nexport interface FrontmatterError {\n  error: string;\n  file: string;\n}\n\ninterface AFSReader {\n  read(path: string): Promise<string>;\n}\n\n/**\n * Parse the `# ---` YAML frontmatter from an .ash file.\n * Returns ToolSchema on success, FrontmatterError on failure.\n */\nexport async function parseFrontmatter(\n  afs: AFSReader,\n  filePath: string,\n): Promise<ToolSchema | FrontmatterError> {\n  let content: string;\n  try {\n    content = await afs.read(filePath);\n  } catch {\n    return { error: `Failed to read file: ${filePath}`, file: filePath };\n  }\n\n  if (!content || !content.trim()) {\n    return { error: \"Empty file\", file: filePath };\n  }\n\n  const yamlBlock = extractYamlBlock(content);\n  if (!yamlBlock) {\n    return { error: \"No valid frontmatter block found (missing # --- delimiters)\", file: filePath };\n  }\n\n  let parsed: Record<string, unknown>;\n  try {\n    parsed = parseYAML(yamlBlock) as Record<string, unknown>;\n  } catch (e) {\n    const msg = e instanceof Error ? e.message : String(e);\n    return { error: `YAML parse error: ${msg}`, file: filePath };\n  }\n\n  if (!parsed || typeof parsed !== \"object\") {\n    return { error: \"Frontmatter must be a YAML mapping\", file: filePath };\n  }\n\n  const name = parsed.name;\n  if (!name || typeof name !== \"string\" || !name.trim()) {\n    return { error: \"Missing or empty 'name' field in frontmatter\", file: filePath };\n  }\n\n  const description = typeof parsed.description === \"string\" ? parsed.description.trim() : \"\";\n  const input =\n    typeof parsed.input === \"object\" && parsed.input !== null\n      ? (parsed.input as Record<\n          string,\n          { type?: string; required?: boolean; description?: string }\n        >)\n      : undefined;\n  const output =\n    typeof parsed.output === \"object\" && parsed.output !== null\n      ? (parsed.output as Record<string, unknown>)\n      : undefined;\n\n  return { name: name.trim(), description, filePath, input, output };\n}\n\nfunction extractYamlBlock(content: string): string | null {\n  const lines = content.split(\"\\n\");\n\n  let startIdx = -1;\n  let endIdx = -1;\n\n  for (let i = 0; i < lines.length; i++) {\n    const trimmed = lines[i]!.trim();\n    if (trimmed === \"# ---\") {\n      if (startIdx === -1) {\n        startIdx = i;\n      } else {\n        endIdx = i;\n        break;\n      }\n    }\n  }\n\n  if (startIdx === -1 || endIdx === -1) return null;\n\n  const yamlLines: string[] = [];\n  for (let i = startIdx + 1; i < endIdx; i++) {\n    const line = lines[i]!;\n    // Strip leading \"# \" or \"#\" prefix\n    if (line.startsWith(\"# \")) {\n      yamlLines.push(line.slice(2));\n    } else if (line.startsWith(\"#\")) {\n      yamlLines.push(line.slice(1));\n    } else {\n      yamlLines.push(line);\n    }\n  }\n\n  return yamlLines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,eAAsB,iBACpB,KACA,UACwC;CACxC,IAAI;AACJ,KAAI;AACF,YAAU,MAAM,IAAI,KAAK,SAAS;SAC5B;AACN,SAAO;GAAE,OAAO,wBAAwB;GAAY,MAAM;GAAU;;AAGtE,KAAI,CAAC,WAAW,CAAC,QAAQ,MAAM,CAC7B,QAAO;EAAE,OAAO;EAAc,MAAM;EAAU;CAGhD,MAAM,YAAY,iBAAiB,QAAQ;AAC3C,KAAI,CAAC,UACH,QAAO;EAAE,OAAO;EAA+D,MAAM;EAAU;CAGjG,IAAI;AACJ,KAAI;AACF,WAASA,KAAU,UAAU;UACtB,GAAG;AAEV,SAAO;GAAE,OAAO,qBADJ,aAAa,QAAQ,EAAE,UAAU,OAAO,EAAE;GACV,MAAM;GAAU;;AAG9D,KAAI,CAAC,UAAU,OAAO,WAAW,SAC/B,QAAO;EAAE,OAAO;EAAsC,MAAM;EAAU;CAGxE,MAAM,OAAO,OAAO;AACpB,KAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,CAAC,KAAK,MAAM,CACnD,QAAO;EAAE,OAAO;EAAgD,MAAM;EAAU;CAGlF,MAAM,cAAc,OAAO,OAAO,gBAAgB,WAAW,OAAO,YAAY,MAAM,GAAG;CACzF,MAAM,QACJ,OAAO,OAAO,UAAU,YAAY,OAAO,UAAU,OAChD,OAAO,QAIR;CACN,MAAM,SACJ,OAAO,OAAO,WAAW,YAAY,OAAO,WAAW,OAClD,OAAO,SACR;AAEN,QAAO;EAAE,MAAM,KAAK,MAAM;EAAE;EAAa;EAAU;EAAO;EAAQ;;AAGpE,SAAS,iBAAiB,SAAgC;CACxD,MAAM,QAAQ,QAAQ,MAAM,KAAK;CAEjC,IAAI,WAAW;CACf,IAAI,SAAS;AAEb,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,IAEhC,KADgB,MAAM,GAAI,MAAM,KAChB,QACd,KAAI,aAAa,GACf,YAAW;MACN;AACL,WAAS;AACT;;AAKN,KAAI,aAAa,MAAM,WAAW,GAAI,QAAO;CAE7C,MAAM,YAAsB,EAAE;AAC9B,MAAK,IAAI,IAAI,WAAW,GAAG,IAAI,QAAQ,KAAK;EAC1C,MAAM,OAAO,MAAM;AAEnB,MAAI,KAAK,WAAW,KAAK,CACvB,WAAU,KAAK,KAAK,MAAM,EAAE,CAAC;WACpB,KAAK,WAAW,IAAI,CAC7B,WAAU,KAAK,KAAK,MAAM,EAAE,CAAC;MAE7B,WAAU,KAAK,KAAK;;AAIxB,QAAO,UAAU,KAAK,KAAK"}

package/dist/program/tool-discovery/dot-path-resolver.cjs

@@ -0,0 +1,60 @@
+let ufo = require("ufo");
+
+//#region src/program/tool-discovery/dot-path-resolver.ts
+const DEFAULT_OPS = [
+	"read",
+	"list",
+	"search",
+	"query"
+];
+const DEFAULT_MAX_DEPTH = 5;
+/**
+* Resolve bare dot-paths (e.g. `./knowledge/`, `./tools/`) to absolute
+* blocklet-scoped whitelist entries.
+*
+* Directories (trailing `/` or `/**`) become glob patterns with maxDepth.
+* File paths resolve to exact entries without maxDepth.
+*/
+function resolveDotPaths(paths, blockletRoot) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const raw of paths) {
+		if (!raw) continue;
+		if (raw.includes("\0")) throw new Error("TOOL_PATH_OUTSIDE_BLOCKLET: null bytes disallowed");
+		const normalized = normalizeDotPath(raw, blockletRoot);
+		if (seen.has(normalized.path)) continue;
+		seen.add(normalized.path);
+		result.push(normalized);
+	}
+	return result;
+}
+function normalizeDotPath(raw, blockletRoot) {
+	if (!raw.startsWith("./") && !raw.startsWith("../") && raw.startsWith("/")) throw new Error(`TOOL_PATH_OUTSIDE_BLOCKLET: absolute path '${raw}' outside blocklet root`);
+	const stripped = raw.replace(/\/?\*\*\/?$/, "").replace(/\/$/, "");
+	const isDir = raw.endsWith("/") || raw.endsWith("/**") || raw.endsWith("/**/");
+	const absolute = (0, ufo.joinURL)(blockletRoot, ...resolveSegments(stripped));
+	if (isDir) return {
+		path: `${absolute}/**`,
+		ops: DEFAULT_OPS,
+		maxDepth: DEFAULT_MAX_DEPTH
+	};
+	return {
+		path: absolute,
+		ops: DEFAULT_OPS
+	};
+}
+function resolveSegments(dotPath) {
+	const parts = dotPath.split("/").filter(Boolean);
+	const resolved = [];
+	for (const part of parts) {
+		if (part === ".") continue;
+		if (part === "..") {
+			if (resolved.length === 0) throw new Error(`TOOL_PATH_OUTSIDE_BLOCKLET: path '${dotPath}' escapes outside blocklet root`);
+			resolved.pop();
+		} else resolved.push(part);
+	}
+	return resolved;
+}
+
+//#endregion
+exports.resolveDotPaths = resolveDotPaths;

package/dist/program/tool-discovery/dot-path-resolver.mjs

@@ -0,0 +1,61 @@
+import { joinURL } from "ufo";
+
+//#region src/program/tool-discovery/dot-path-resolver.ts
+const DEFAULT_OPS = [
+	"read",
+	"list",
+	"search",
+	"query"
+];
+const DEFAULT_MAX_DEPTH = 5;
+/**
+* Resolve bare dot-paths (e.g. `./knowledge/`, `./tools/`) to absolute
+* blocklet-scoped whitelist entries.
+*
+* Directories (trailing `/` or `/**`) become glob patterns with maxDepth.
+* File paths resolve to exact entries without maxDepth.
+*/
+function resolveDotPaths(paths, blockletRoot) {
+	const seen = /* @__PURE__ */ new Set();
+	const result = [];
+	for (const raw of paths) {
+		if (!raw) continue;
+		if (raw.includes("\0")) throw new Error("TOOL_PATH_OUTSIDE_BLOCKLET: null bytes disallowed");
+		const normalized = normalizeDotPath(raw, blockletRoot);
+		if (seen.has(normalized.path)) continue;
+		seen.add(normalized.path);
+		result.push(normalized);
+	}
+	return result;
+}
+function normalizeDotPath(raw, blockletRoot) {
+	if (!raw.startsWith("./") && !raw.startsWith("../") && raw.startsWith("/")) throw new Error(`TOOL_PATH_OUTSIDE_BLOCKLET: absolute path '${raw}' outside blocklet root`);
+	const stripped = raw.replace(/\/?\*\*\/?$/, "").replace(/\/$/, "");
+	const isDir = raw.endsWith("/") || raw.endsWith("/**") || raw.endsWith("/**/");
+	const absolute = joinURL(blockletRoot, ...resolveSegments(stripped));
+	if (isDir) return {
+		path: `${absolute}/**`,
+		ops: DEFAULT_OPS,
+		maxDepth: DEFAULT_MAX_DEPTH
+	};
+	return {
+		path: absolute,
+		ops: DEFAULT_OPS
+	};
+}
+function resolveSegments(dotPath) {
+	const parts = dotPath.split("/").filter(Boolean);
+	const resolved = [];
+	for (const part of parts) {
+		if (part === ".") continue;
+		if (part === "..") {
+			if (resolved.length === 0) throw new Error(`TOOL_PATH_OUTSIDE_BLOCKLET: path '${dotPath}' escapes outside blocklet root`);
+			resolved.pop();
+		} else resolved.push(part);
+	}
+	return resolved;
+}
+
+//#endregion
+export { resolveDotPaths };
+//# sourceMappingURL=dot-path-resolver.mjs.map

package/dist/program/tool-discovery/dot-path-resolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dot-path-resolver.mjs","names":[],"sources":["../../../src/program/tool-discovery/dot-path-resolver.ts"],"sourcesContent":["/**\n * Dot-protocol bare-path resolver (S13).\n *\n * Resolves relative paths from manifest `tools:` into absolute blocklet-scoped\n * ToolEntry[] for the path-validator whitelist. Pure function; no I/O.\n */\n\nimport type { ToolEntry } from \"@aigne/afs-ash\";\nimport { joinURL } from \"ufo\";\n\n// `query` pairs with `list` (read-class collection view, design §3.1b).\nconst DEFAULT_OPS: string[] = [\"read\", \"list\", \"search\", \"query\"];\nconst DEFAULT_MAX_DEPTH = 5;\n\n/**\n * Resolve bare dot-paths (e.g. `./knowledge/`, `./tools/`) to absolute\n * blocklet-scoped whitelist entries.\n *\n * Directories (trailing `/` or `/**`) become glob patterns with maxDepth.\n * File paths resolve to exact entries without maxDepth.\n */\nexport function resolveDotPaths(paths: string[], blockletRoot: string): ToolEntry[] {\n  const seen = new Set<string>();\n  const result: ToolEntry[] = [];\n\n  for (const raw of paths) {\n    if (!raw) continue;\n\n    if (raw.includes(\"\\0\")) {\n      throw new Error(\"TOOL_PATH_OUTSIDE_BLOCKLET: null bytes disallowed\");\n    }\n\n    const normalized = normalizeDotPath(raw, blockletRoot);\n    if (seen.has(normalized.path)) continue;\n    seen.add(normalized.path);\n    result.push(normalized);\n  }\n\n  return result;\n}\n\nfunction normalizeDotPath(raw: string, blockletRoot: string): ToolEntry {\n  if (!raw.startsWith(\"./\") && !raw.startsWith(\"../\") && raw.startsWith(\"/\")) {\n    throw new Error(`TOOL_PATH_OUTSIDE_BLOCKLET: absolute path '${raw}' outside blocklet root`);\n  }\n\n  const stripped = raw.replace(/\\/?\\*\\*\\/?$/, \"\").replace(/\\/$/, \"\");\n  const isDir = raw.endsWith(\"/\") || raw.endsWith(\"/**\") || raw.endsWith(\"/**/\");\n\n  const cleanSegments = resolveSegments(stripped);\n  const absolute = joinURL(blockletRoot, ...cleanSegments);\n\n  if (isDir) {\n    return {\n      path: `${absolute}/**`,\n      ops: DEFAULT_OPS,\n      maxDepth: DEFAULT_MAX_DEPTH,\n    };\n  }\n\n  return { path: absolute, ops: DEFAULT_OPS };\n}\n\nfunction resolveSegments(dotPath: string): string[] {\n  const parts = dotPath.split(\"/\").filter(Boolean);\n  const resolved: string[] = [];\n\n  for (const part of parts) {\n    if (part === \".\") continue;\n    if (part === \"..\") {\n      if (resolved.length === 0) {\n        throw new Error(\n          `TOOL_PATH_OUTSIDE_BLOCKLET: path '${dotPath}' escapes outside blocklet root`,\n        );\n      }\n      resolved.pop();\n    } else {\n      resolved.push(part);\n    }\n  }\n\n  return resolved;\n}\n"],"mappings":";;;AAWA,MAAM,cAAwB;CAAC;CAAQ;CAAQ;CAAU;CAAQ;AACjE,MAAM,oBAAoB;;;;;;;;AAS1B,SAAgB,gBAAgB,OAAiB,cAAmC;CAClF,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,SAAsB,EAAE;AAE9B,MAAK,MAAM,OAAO,OAAO;AACvB,MAAI,CAAC,IAAK;AAEV,MAAI,IAAI,SAAS,KAAK,CACpB,OAAM,IAAI,MAAM,oDAAoD;EAGtE,MAAM,aAAa,iBAAiB,KAAK,aAAa;AACtD,MAAI,KAAK,IAAI,WAAW,KAAK,CAAE;AAC/B,OAAK,IAAI,WAAW,KAAK;AACzB,SAAO,KAAK,WAAW;;AAGzB,QAAO;;AAGT,SAAS,iBAAiB,KAAa,cAAiC;AACtE,KAAI,CAAC,IAAI,WAAW,KAAK,IAAI,CAAC,IAAI,WAAW,MAAM,IAAI,IAAI,WAAW,IAAI,CACxE,OAAM,IAAI,MAAM,8CAA8C,IAAI,yBAAyB;CAG7F,MAAM,WAAW,IAAI,QAAQ,eAAe,GAAG,CAAC,QAAQ,OAAO,GAAG;CAClE,MAAM,QAAQ,IAAI,SAAS,IAAI,IAAI,IAAI,SAAS,MAAM,IAAI,IAAI,SAAS,OAAO;CAG9E,MAAM,WAAW,QAAQ,cAAc,GADjB,gBAAgB,SAAS,CACS;AAExD,KAAI,MACF,QAAO;EACL,MAAM,GAAG,SAAS;EAClB,KAAK;EACL,UAAU;EACX;AAGH,QAAO;EAAE,MAAM;EAAU,KAAK;EAAa;;AAG7C,SAAS,gBAAgB,SAA2B;CAClD,MAAM,QAAQ,QAAQ,MAAM,IAAI,CAAC,OAAO,QAAQ;CAChD,MAAM,WAAqB,EAAE;AAE7B,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,SAAS,IAAK;AAClB,MAAI,SAAS,MAAM;AACjB,OAAI,SAAS,WAAW,EACtB,OAAM,IAAI,MACR,qCAAqC,QAAQ,iCAC9C;AAEH,YAAS,KAAK;QAEd,UAAS,KAAK,KAAK;;AAIvB,QAAO"}

package/dist/program/tool-discovery/skill-gate.cjs

@@ -0,0 +1,36 @@
+
+//#region src/program/tool-discovery/skill-gate.ts
+/**
+* Return only the ToolSchemas whose gating skill is in the active set.
+* Must be called on every tool call (not just catalog build) so mid-run
+* skill removal disables helpers immediately.
+*/
+function filterByActiveSkills(helpers, activeSkills) {
+	return helpers.filter((h) => activeSkills.has(h.skill)).map((h) => h.schema);
+}
+/**
+* Merge local tools with active skill helpers. When a skill helper has the
+* same name as a local tool, the helper wins (shadow) and a warning is emitted.
+*/
+function mergeWithShadowing(tools, activeHelpers) {
+	const warnings = [];
+	const helperNames = new Set(activeHelpers.map((h) => h.name));
+	const merged = [];
+	for (const tool of tools) {
+		if (helperNames.has(tool.name)) {
+			const helper = activeHelpers.find((h) => h.name === tool.name);
+			warnings.push(`tool_shadow: "${tool.name}" from ${tool.filePath} shadowed by skill helper ${helper.filePath}`);
+			continue;
+		}
+		merged.push(tool);
+	}
+	merged.push(...activeHelpers);
+	return {
+		merged,
+		warnings
+	};
+}
+
+//#endregion
+exports.filterByActiveSkills = filterByActiveSkills;
+exports.mergeWithShadowing = mergeWithShadowing;

package/dist/program/tool-discovery/skill-gate.d.cts

@@ -0,0 +1,10 @@
+import { ToolSchema } from "./ash-frontmatter.cjs";
+
+//#region src/program/tool-discovery/skill-gate.d.ts
+interface SkillHelper {
+  skill: string;
+  schema: ToolSchema;
+}
+//#endregion
+export { SkillHelper };
+//# sourceMappingURL=skill-gate.d.cts.map

package/dist/program/tool-discovery/skill-gate.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-gate.d.cts","names":[],"sources":["../../../src/program/tool-discovery/skill-gate.ts"],"mappings":";;;UASiB,WAAA;EACf,KAAA;EACA,MAAA,EAAQ,UAAA;AAAA"}

package/dist/program/tool-discovery/skill-gate.d.mts

@@ -0,0 +1,10 @@
+import { ToolSchema } from "./ash-frontmatter.mjs";
+
+//#region src/program/tool-discovery/skill-gate.d.ts
+interface SkillHelper {
+  skill: string;
+  schema: ToolSchema;
+}
+//#endregion
+export { SkillHelper };
+//# sourceMappingURL=skill-gate.d.mts.map

package/dist/program/tool-discovery/skill-gate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-gate.d.mts","names":[],"sources":["../../../src/program/tool-discovery/skill-gate.ts"],"mappings":";;;UASiB,WAAA;EACf,KAAA;EACA,MAAA,EAAQ,UAAA;AAAA"}

package/dist/program/tool-discovery/skill-gate.mjs

@@ -0,0 +1,35 @@
+//#region src/program/tool-discovery/skill-gate.ts
+/**
+* Return only the ToolSchemas whose gating skill is in the active set.
+* Must be called on every tool call (not just catalog build) so mid-run
+* skill removal disables helpers immediately.
+*/
+function filterByActiveSkills(helpers, activeSkills) {
+	return helpers.filter((h) => activeSkills.has(h.skill)).map((h) => h.schema);
+}
+/**
+* Merge local tools with active skill helpers. When a skill helper has the
+* same name as a local tool, the helper wins (shadow) and a warning is emitted.
+*/
+function mergeWithShadowing(tools, activeHelpers) {
+	const warnings = [];
+	const helperNames = new Set(activeHelpers.map((h) => h.name));
+	const merged = [];
+	for (const tool of tools) {
+		if (helperNames.has(tool.name)) {
+			const helper = activeHelpers.find((h) => h.name === tool.name);
+			warnings.push(`tool_shadow: "${tool.name}" from ${tool.filePath} shadowed by skill helper ${helper.filePath}`);
+			continue;
+		}
+		merged.push(tool);
+	}
+	merged.push(...activeHelpers);
+	return {
+		merged,
+		warnings
+	};
+}
+
+//#endregion
+export { filterByActiveSkills, mergeWithShadowing };
+//# sourceMappingURL=skill-gate.mjs.map

package/dist/program/tool-discovery/skill-gate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-gate.mjs","names":[],"sources":["../../../src/program/tool-discovery/skill-gate.ts"],"sourcesContent":["/**\n * Skill-gated helper filter (S13).\n *\n * Runtime filter that intersects the full helper catalog with the active $skills set.\n * Pure function; no I/O.\n */\n\nimport type { ToolSchema } from \"./ash-frontmatter.js\";\n\nexport interface SkillHelper {\n  skill: string;\n  schema: ToolSchema;\n}\n\n/**\n * Return only the ToolSchemas whose gating skill is in the active set.\n * Must be called on every tool call (not just catalog build) so mid-run\n * skill removal disables helpers immediately.\n */\nexport function filterByActiveSkills(\n  helpers: SkillHelper[],\n  activeSkills: Set<string>,\n): ToolSchema[] {\n  return helpers.filter((h) => activeSkills.has(h.skill)).map((h) => h.schema);\n}\n\n/**\n * Merge local tools with active skill helpers. When a skill helper has the\n * same name as a local tool, the helper wins (shadow) and a warning is emitted.\n */\nexport function mergeWithShadowing(\n  tools: ToolSchema[],\n  activeHelpers: ToolSchema[],\n): { merged: ToolSchema[]; warnings: string[] } {\n  const warnings: string[] = [];\n  const helperNames = new Set(activeHelpers.map((h) => h.name));\n  const merged: ToolSchema[] = [];\n\n  for (const tool of tools) {\n    if (helperNames.has(tool.name)) {\n      const helper = activeHelpers.find((h) => h.name === tool.name)!;\n      warnings.push(\n        `tool_shadow: \"${tool.name}\" from ${tool.filePath} shadowed by skill helper ${helper.filePath}`,\n      );\n      continue;\n    }\n    merged.push(tool);\n  }\n\n  merged.push(...activeHelpers);\n  return { merged, warnings };\n}\n"],"mappings":";;;;;;AAmBA,SAAgB,qBACd,SACA,cACc;AACd,QAAO,QAAQ,QAAQ,MAAM,aAAa,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,MAAM,EAAE,OAAO;;;;;;AAO9E,SAAgB,mBACd,OACA,eAC8C;CAC9C,MAAM,WAAqB,EAAE;CAC7B,MAAM,cAAc,IAAI,IAAI,cAAc,KAAK,MAAM,EAAE,KAAK,CAAC;CAC7D,MAAM,SAAuB,EAAE;AAE/B,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,YAAY,IAAI,KAAK,KAAK,EAAE;GAC9B,MAAM,SAAS,cAAc,MAAM,MAAM,EAAE,SAAS,KAAK,KAAK;AAC9D,YAAS,KACP,iBAAiB,KAAK,KAAK,SAAS,KAAK,SAAS,4BAA4B,OAAO,WACtF;AACD;;AAEF,SAAO,KAAK,KAAK;;AAGnB,QAAO,KAAK,GAAG,cAAc;AAC7B,QAAO;EAAE;EAAQ;EAAU"}