@dot-agent/compiler 0.10.1 → 0.10.2

package/dist/core.cjs

@@ -1,13 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_zip_core = require("./zip-core-BjnIQMRA.cjs");
-exports.aboutmeToJson = require_zip_core.aboutmeToJson;
-exports.buildAboutme = require_zip_core.buildAboutme;
-exports.buildId = require_zip_core.buildId;
-exports.createZip = require_zip_core.createZip;
-exports.extractDigest = require_zip_core.extractDigest;
-exports.extractFiles = require_zip_core.extractFiles;
-exports.extractName = require_zip_core.extractName;
-exports.parseAboutme = require_zip_core.parseAboutme;
-exports.parseId = require_zip_core.parseId;
-exports.validateMagicBytes = require_zip_core.validateMagicBytes;
-exports.validateZipBomb = require_zip_core.validateZipBomb;
+const require_namespace = require("./namespace-0cuKn3-s.cjs");
+exports.CONTENT_NAMESPACES = require_namespace.CONTENT_NAMESPACES;
+exports.aboutmeToJson = require_namespace.aboutmeToJson;
+exports.buildAboutme = require_namespace.buildAboutme;
+exports.buildId = require_namespace.buildId;
+exports.classifyContentPath = require_namespace.classifyContentPath;
+exports.createZip = require_namespace.createZip;
+exports.extractDigest = require_namespace.extractDigest;
+exports.extractFiles = require_namespace.extractFiles;
+exports.extractName = require_namespace.extractName;
+exports.isInContentNamespace = require_namespace.isInContentNamespace;
+exports.parseAboutme = require_namespace.parseAboutme;
+exports.parseId = require_namespace.parseId;
+exports.validateMagicBytes = require_namespace.validateMagicBytes;
+exports.validateZipBomb = require_namespace.validateZipBomb;

package/dist/core.d.cts

@@ -1,2 +1,2 @@
-import { S as Integrity, a as buildId, b as DescriptionFile, c as parseId, d as parseAboutme, f as AboutMe, g as AnnotatedRef, h as AgentFiles, i as validateZipBomb, l as aboutmeToJson, n as extractFiles, o as extractDigest, p as AgentBundle, r as validateMagicBytes, s as extractName, t as createZip, u as buildAboutme, v as BuildAboutmeOptions, w as LintMessage, x as IdParts, y as Capability } from "./zip-core-BCiH0sUt.cjs";
-export { type AboutMe, type AgentBundle, type AgentFiles, type AnnotatedRef, type BuildAboutmeOptions, type Capability, type DescriptionFile, type IdParts, type Integrity, type LintMessage, aboutmeToJson, buildAboutme, buildId, createZip, extractDigest, extractFiles, extractName, parseAboutme, parseId, validateMagicBytes, validateZipBomb };
+import { C as Capability, E as Integrity, O as LintMessage, S as BuildAboutmeOptions, T as IdParts, _ as AgentBundle, a as createZip, b as AnnotatedRef, c as validateZipBomb, d as extractName, f as parseId, g as AboutMe, h as parseAboutme, i as isInContentNamespace, l as buildId, m as buildAboutme, n as ContentNamespace, o as extractFiles, p as aboutmeToJson, r as classifyContentPath, s as validateMagicBytes, t as CONTENT_NAMESPACES, u as extractDigest, w as DescriptionFile, y as AgentFiles } from "./namespace-DsoVSANe.cjs";
+export { type AboutMe, type AgentBundle, type AgentFiles, type AnnotatedRef, type BuildAboutmeOptions, CONTENT_NAMESPACES, type Capability, type ContentNamespace, type DescriptionFile, type IdParts, type Integrity, type LintMessage, aboutmeToJson, buildAboutme, buildId, classifyContentPath, createZip, extractDigest, extractFiles, extractName, isInContentNamespace, parseAboutme, parseId, validateMagicBytes, validateZipBomb };

package/dist/core.d.mts

@@ -1,2 +1,2 @@
-import { S as Integrity, a as buildId, b as DescriptionFile, c as parseId, d as parseAboutme, f as AboutMe, g as AnnotatedRef, h as AgentFiles, i as validateZipBomb, l as aboutmeToJson, n as extractFiles, o as extractDigest, p as AgentBundle, r as validateMagicBytes, s as extractName, t as createZip, u as buildAboutme, v as BuildAboutmeOptions, w as LintMessage, x as IdParts, y as Capability } from "./zip-core-BCiH0sUt.mjs";
-export { type AboutMe, type AgentBundle, type AgentFiles, type AnnotatedRef, type BuildAboutmeOptions, type Capability, type DescriptionFile, type IdParts, type Integrity, type LintMessage, aboutmeToJson, buildAboutme, buildId, createZip, extractDigest, extractFiles, extractName, parseAboutme, parseId, validateMagicBytes, validateZipBomb };
+import { C as Capability, E as Integrity, O as LintMessage, S as BuildAboutmeOptions, T as IdParts, _ as AgentBundle, a as createZip, b as AnnotatedRef, c as validateZipBomb, d as extractName, f as parseId, g as AboutMe, h as parseAboutme, i as isInContentNamespace, l as buildId, m as buildAboutme, n as ContentNamespace, o as extractFiles, p as aboutmeToJson, r as classifyContentPath, s as validateMagicBytes, t as CONTENT_NAMESPACES, u as extractDigest, w as DescriptionFile, y as AgentFiles } from "./namespace-DsoVSANe.mjs";
+export { type AboutMe, type AgentBundle, type AgentFiles, type AnnotatedRef, type BuildAboutmeOptions, CONTENT_NAMESPACES, type Capability, type ContentNamespace, type DescriptionFile, type IdParts, type Integrity, type LintMessage, aboutmeToJson, buildAboutme, buildId, classifyContentPath, createZip, extractDigest, extractFiles, extractName, isInContentNamespace, parseAboutme, parseId, validateMagicBytes, validateZipBomb };

package/dist/core.mjs

@@ -1,2 +1,2 @@
-import { a as buildId, d as aboutmeToJson, f as buildAboutme, i as validateZipBomb, l as parseId, n as extractFiles, o as extractDigest, p as parseAboutme, r as validateMagicBytes, s as extractName, t as createZip } from "./zip-core-Dw_OgIjV.mjs";
-export { aboutmeToJson, buildAboutme, buildId, createZip, extractDigest, extractFiles, extractName, parseAboutme, parseId, validateMagicBytes, validateZipBomb };
+import { a as extractFiles, c as buildId, f as parseId, g as parseAboutme, h as buildAboutme, i as createZip, l as extractDigest, m as aboutmeToJson, n as classifyContentPath, o as validateMagicBytes, r as isInContentNamespace, s as validateZipBomb, t as CONTENT_NAMESPACES, u as extractName } from "./namespace-CjeG5-7u.mjs";
+export { CONTENT_NAMESPACES, aboutmeToJson, buildAboutme, buildId, classifyContentPath, createZip, extractDigest, extractFiles, extractName, isInContentNamespace, parseAboutme, parseId, validateMagicBytes, validateZipBomb };

package/dist/index.cjs

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_zip_core = require("./zip-core-BjnIQMRA.cjs");
+const require_namespace = require("./namespace-0cuKn3-s.cjs");
 let module$1 = require("module");
 let web_tree_sitter = require("web-tree-sitter");
 let _dot_agent_parser_dsl = require("@dot-agent/parser-dsl");
 let fs = require("fs");
 let path = require("path");
 let jszip = require("jszip");
-jszip = require_zip_core.__toESM(jszip, 1);
+jszip = require_namespace.__toESM(jszip, 1);
 let fs_promises = require("fs/promises");
 let child_process = require("child_process");
 let crypto = require("crypto");
@@ -587,11 +587,11 @@ async function readZip(filePath) {
 }
 async function validateZipBomb(filePath) {
 	const data = await (0, fs_promises.readFile)(filePath);
-	require_zip_core.validateZipBomb(await jszip.default.loadAsync(data), data.length);
+	require_namespace.validateZipBomb(await jszip.default.loadAsync(data), data.length);
 	return true;
 }
 async function validateMagicBytes(filePath) {
-	require_zip_core.validateMagicBytes(await (0, fs_promises.readFile)(filePath));
+	require_namespace.validateMagicBytes(await (0, fs_promises.readFile)(filePath));
 	return true;
 }
 async function writeZip(zip, outPath) {
@@ -680,13 +680,13 @@ function recentTagCandidates(limit = 5) {
 			version,
 			label: atIdx === -1 ? tag : `${version}   (tag: ${tag})`
 		};
-	}).filter((c) => require_zip_core.isValidVersion(c.version));
+	}).filter((c) => require_namespace.isValidVersion(c.version));
 }
 const CUSTOM_VERSION = "__dot-agent-custom-version__";
 const BARE_VERSION = "__dot-agent-bare-version__";
 async function resolveVersionInteractive(explicit) {
 	if (explicit) {
-		if (!require_zip_core.isValidVersion(explicit)) throw new Error(`E019: Invalid version format '${explicit}' — expected vX.Y[.Z][-prerelease] or X.Y[.Z][-prerelease]`);
+		if (!require_namespace.isValidVersion(explicit)) throw new Error(`E019: Invalid version format '${explicit}' — expected vX.Y[.Z][-prerelease] or X.Y[.Z][-prerelease]`);
 		return explicit;
 	}
 	if (!process.stdin.isTTY || !process.stdout.isTTY) {
@@ -720,7 +720,7 @@ async function resolveVersionInteractive(explicit) {
 	if (choice === CUSTOM_VERSION) {
 		const typed = await clack.text({
 			message: "Version",
-			validate: (v) => v && require_zip_core.isValidVersion(v) ? void 0 : "Invalid version format — expected vX.Y[.Z][-prerelease] or X.Y[.Z][-prerelease]"
+			validate: (v) => v && require_namespace.isValidVersion(v) ? void 0 : "Invalid version format — expected vX.Y[.Z][-prerelease] or X.Y[.Z][-prerelease]"
 		});
 		if (clack.isCancel(typed)) {
 			clack.cancel("Pack cancelled.");
@@ -818,8 +818,8 @@ function collectFileRefs(stmts, out) {
 			break;
 	}
 }
-function namespaceOf(kind) {
-	return kind === "guide" ? "guides" : "knowledge";
+function normalizeRefPath(text) {
+	return text.replace(/\\/g, "/").replace(/^\.\//, "");
 }
 async function collectBehaviorFileRefs(mergedBehaviorText) {
 	await initBehaviorParser();
@@ -853,15 +853,33 @@ async function listContentFiles(dir, ns) {
 async function findOrphanContentFiles(dir, mergedBehaviorText) {
 	const refs = await collectBehaviorFileRefs(mergedBehaviorText);
 	const referenced = /* @__PURE__ */ new Set();
-	for (const { kind, text } of refs.values()) referenced.add(`${namespaceOf(kind)}/${text}`);
-	return [...await listContentFiles(dir, "guides"), ...await listContentFiles(dir, "knowledge")].filter((path$4) => !referenced.has(path$4)).map((path$5) => ({
+	const messages = [];
+	for (const { kind, text } of refs.values()) {
+		const bundlePath = normalizeRefPath(text);
+		referenced.add(bundlePath);
+		if (isExternalPath(dir, bundlePath) || require_namespace.isInContentNamespace(bundlePath)) continue;
+		try {
+			await (0, fs_promises.stat)((0, path.join)(dir, bundlePath));
+		} catch {
+			continue;
+		}
+		messages.push({
+			file: bundlePath,
+			line: 1,
+			col: 1,
+			severity: "warning",
+			code: "W016",
+			message: `'${kind}' reference '${text}' resolves outside guides/ or knowledge/ — it will be bundled but is unreachable at runtime; move it under knowledge/ (or guides/) and reference it there`
+		});
+	}
+	return [...[...await listContentFiles(dir, "guides"), ...await listContentFiles(dir, "knowledge")].filter((path$4) => !referenced.has(path$4)).map((path$5) => ({
 		file: path$5,
 		line: 1,
 		col: 1,
 		severity: "warning",
 		code: "W015",
 		message: `'${path$5}' is not referenced by any guide or teach statement — it will not be included in the bundle`
-	}));
+	})), ...messages];
 }
 async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSources, personaFile) {
 	const files = /* @__PURE__ */ new Map();
@@ -881,16 +899,16 @@ async function collectFiles(dir, descriptionFile, mergedBehaviorText, mergeSourc
 	}
 	const refs = await collectBehaviorFileRefs(mergedBehaviorText);
 	for (const { kind, text } of refs.values()) {
-		if (isExternalPath(dir, text)) throw new Error(`E014: '${kind}' path '${text}' is absolute or escapes the agent root`);
-		const ns = namespaceOf(kind);
-		const nsPath = `${ns}/${text}`;
+		const bundlePath = normalizeRefPath(text);
+		if (isExternalPath(dir, bundlePath)) throw new Error(`E014: '${kind}' path '${text}' is absolute or escapes the agent root`);
 		let content;
-		for (const candidate of [(0, path.join)(dir, ns, text), (0, path.join)(dir, text)]) try {
-			content = await (0, fs_promises.readFile)(candidate, "utf-8");
-			break;
-		} catch {}
-		if (content === void 0) throw new Error(`E018: '${kind}' file '${text}' referenced in agent.behavior not found in ${dir} — looked for '${nsPath}' and '${text}'`);
-		files.set(nsPath, content);
+		try {
+			content = await (0, fs_promises.readFile)((0, path.join)(dir, bundlePath), "utf-8");
+		} catch {
+			throw new Error(`E018: '${kind}' file '${text}' referenced in agent.behavior not found in ${dir} — looked for '${bundlePath}' relative to the agent root`);
+		}
+		if (files.has(bundlePath)) throw new Error(`E020: '${kind}' reference '${text}' resolves to '${bundlePath}', which collides with a reserved bundle path (the description file, agent.behavior, a merged behaviors/ file, or the persona) — reference a different path`);
+		files.set(bundlePath, content);
 	}
 	return files;
 }
@@ -926,9 +944,9 @@ async function pack(options = {}) {
 	const warnings = [...lintWarnings, ...await findOrphanContentFiles(dir, mergedText)];
 	const contentForHash = Array.from(allFiles.values()).join("");
 	const sha256 = (0, crypto.createHash)("sha256").update(contentForHash).digest("hex");
-	const id = require_zip_core.buildId({
+	const id = require_namespace.buildId({
 		namespace: df.agent.domain ?? "unknown",
-		name: require_zip_core.slugify(df.agent.name),
+		name: require_namespace.slugify(df.agent.name),
 		version,
 		digest: version ? commit : void 0
 	});
@@ -938,7 +956,7 @@ async function pack(options = {}) {
 		...typesJson ? { types: ".agent/types.json" } : {},
 		files: ".agent/files.json"
 	};
-	const aboutme = require_zip_core.buildAboutme({
+	const aboutme = require_namespace.buildAboutme({
 		id,
 		name: df.agent.name,
 		description: df.description ?? "",
@@ -947,7 +965,7 @@ async function pack(options = {}) {
 		license: df.agent.license ?? "",
 		persona: df.persona ?? void 0,
 		purpose: "unknown",
-		compiler: `dot-agent/${require_zip_core.COMPILER_VERSION}`,
+		compiler: `dot-agent/${require_namespace.COMPILER_VERSION}`,
 		commit,
 		capabilities: df.capabilities.map((c) => ({
 			id: c.name,
@@ -958,15 +976,15 @@ async function pack(options = {}) {
 	});
 	const zip = new jszip.default();
 	const agentFolder = zip.folder(".agent");
-	agentFolder.file("aboutme.json", require_zip_core.aboutmeToJson(aboutme));
+	agentFolder.file("aboutme.json", require_namespace.aboutmeToJson(aboutme));
 	if (typesJson) agentFolder.file("types.json", typesJson);
 	const filesJson = {
 		description: descriptionFileName,
 		behavior: "agent.behavior",
 		...df.persona ? { persona: df.persona } : {},
 		behaviors: Array.from(allFiles.keys()).filter((f) => f.startsWith("behaviors/")),
-		guides: Array.from(allFiles.keys()).filter((f) => f.startsWith("guides/")),
-		knowledge: Array.from(allFiles.keys()).filter((f) => f.startsWith("knowledge/"))
+		guides: Array.from(allFiles.keys()).filter((f) => require_namespace.classifyContentPath(f) === "guides"),
+		knowledge: Array.from(allFiles.keys()).filter((f) => require_namespace.classifyContentPath(f) === "knowledge")
 	};
 	agentFolder.file("files.json", JSON.stringify(filesJson, null, 2));
 	for (const [path$7, content] of allFiles) zip.file(path$7, content);
@@ -1007,14 +1025,14 @@ async function bundleFromDir(dir) {
 	for (const w of warnings) process.stderr.write(`\x1b[33m⚠\x1b[0m ${w.file}:${w.line}:${w.col} ${w.code} ${w.message}\n`);
 	const allFiles = await collectFiles(dir, descriptionFileName, mergedText, mergeSources, df.persona ?? void 0);
 	const sha256 = (0, crypto.createHash)("sha256").update(Array.from(allFiles.values()).join("")).digest("hex");
-	const id = require_zip_core.buildId({
+	const id = require_namespace.buildId({
 		namespace: df.agent.domain ?? "unknown",
-		name: require_zip_core.slugify(df.agent.name),
+		name: require_namespace.slugify(df.agent.name),
 		version: "dev"
 	});
 	return {
 		id,
-		aboutme: require_zip_core.buildAboutme({
+		aboutme: require_namespace.buildAboutme({
 			id,
 			name: df.agent.name,
 			description: df.description ?? "",
@@ -1023,7 +1041,7 @@ async function bundleFromDir(dir) {
 			license: df.agent.license ?? "",
 			persona: df.persona ?? void 0,
 			purpose: "development",
-			compiler: `dot-agent/${require_zip_core.COMPILER_VERSION}`,
+			compiler: `dot-agent/${require_namespace.COMPILER_VERSION}`,
 			capabilities: df.capabilities.map((c) => ({
 				id: c.name,
 				description: c.description ?? ""
@@ -1038,11 +1056,11 @@ async function bundleFromDir(dir) {
 			description: descriptionText,
 			behavior: allFiles.get("agent.behavior") ?? mergedText,
 			persona: df.persona ? allFiles.get(df.persona) : void 0,
-			guides: Array.from(allFiles.entries()).filter(([p]) => p.startsWith("guides/")).map(([path$1, content]) => ({
+			guides: Array.from(allFiles.entries()).filter(([p]) => require_namespace.classifyContentPath(p) === "guides").map(([path$1, content]) => ({
 				path: path$1,
 				content
 			})),
-			knowledge: Array.from(allFiles.entries()).filter(([p]) => p.startsWith("knowledge/")).map(([path$2, content]) => ({
+			knowledge: Array.from(allFiles.entries()).filter(([p]) => require_namespace.classifyContentPath(p) === "knowledge").map(([path$2, content]) => ({
 				path: path$2,
 				content
 			})),
@@ -1054,21 +1072,24 @@ async function bundleFromDir(dir) {
 	};
 }
 //#endregion
-exports.aboutmeToJson = require_zip_core.aboutmeToJson;
-exports.buildAboutme = require_zip_core.buildAboutme;
-exports.buildId = require_zip_core.buildId;
+exports.CONTENT_NAMESPACES = require_namespace.CONTENT_NAMESPACES;
+exports.aboutmeToJson = require_namespace.aboutmeToJson;
+exports.buildAboutme = require_namespace.buildAboutme;
+exports.buildId = require_namespace.buildId;
 exports.bundleFromDir = bundleFromDir;
+exports.classifyContentPath = require_namespace.classifyContentPath;
 exports.collectFiles = collectFiles;
 exports.consolidate = consolidate;
 exports.createLinter = createLinter;
-exports.createZip = require_zip_core.createZip;
-exports.extractDigest = require_zip_core.extractDigest;
-exports.extractFiles = require_zip_core.extractFiles;
-exports.extractName = require_zip_core.extractName;
+exports.createZip = require_namespace.createZip;
+exports.extractDigest = require_namespace.extractDigest;
+exports.extractFiles = require_namespace.extractFiles;
+exports.extractName = require_namespace.extractName;
 exports.getBehaviorScxml = getBehaviorScxml;
 exports.getContextNode = getContextNode;
 exports.initBehaviorParser = initBehaviorParser;
 exports.initParsers = initParsers;
+exports.isInContentNamespace = require_namespace.isInContentNamespace;
 exports.lintBehavior = lintBehavior;
 exports.lintDescription = lintDescription;
 exports.nodeAtOffset = nodeAtOffset;
@@ -1076,10 +1097,10 @@ exports.nodeToRange = nodeToRange;
 exports.nodesOfType = nodesOfType;
 exports.pack = pack;
 exports.parse = parse;
-exports.parseAboutme = require_zip_core.parseAboutme;
+exports.parseAboutme = require_namespace.parseAboutme;
 exports.parseBehaviorFile = parseBehaviorFile;
 exports.parseDescriptionFile = parseDescriptionFile;
-exports.parseId = require_zip_core.parseId;
+exports.parseId = require_namespace.parseId;
 exports.parseSync = parseSync;
 exports.positionToOffset = positionToOffset;
 exports.readZip = readZip;