@aigne/aos 0.2.0-beta

package/dist/scaffold/workspace-dsl.mjs

@@ -0,0 +1,337 @@
+import { parseDeclaration, parseDslStringToken } from "../dsl-shared.mjs";
+import { scaffoldDslParseError } from "./dsl-error.mjs";
+
+//#region src/scaffold/workspace-dsl.ts
+const STRING = "\"((?:[^\"\\\\]|\\\\.)*)\"";
+function pathHasTraversal(path) {
+	let decoded = path;
+	try {
+		decoded = decodeURIComponent(path);
+	} catch {}
+	const re = /(^|\/)\.\.($|\/)/;
+	return re.test(path) || re.test(decoded);
+}
+/**
+* Project a parsed workspace definition onto the formalized convention
+* manifest — flattening sections to their folder roots and lifting the agent
+* and default content path.
+*/
+function workspaceManifestFromDefinition(definition) {
+	const roots = [];
+	for (const section of definition.sections ?? []) for (const root of section.roots ?? []) roots.push({
+		id: root.id,
+		title: root.title,
+		path: root.path,
+		...root.editable !== void 0 ? { editable: root.editable } : {}
+	});
+	return {
+		roots,
+		...definition.defaultPath ? { defaultPath: definition.defaultPath } : {},
+		...definition.agent?.module ? { agent: {
+			module: definition.agent.module,
+			...definition.agent.title ? { title: definition.agent.title } : {},
+			...definition.agent.placeholder ? { placeholder: definition.agent.placeholder } : {}
+		} } : {}
+	};
+}
+/**
+* Schema-validate a workspace convention manifest (strict: declare ⇒ execute,
+* never silently degrade to an empty workspace). Throws a
+* {@link ScaffoldDslCompileError} on any violation:
+* - no folder roots at all,
+* - a root `from` / `default` path that is relative or contains `..` traversal.
+*/
+function validateWorkspaceManifest(manifest) {
+	if (!manifest.roots || manifest.roots.length === 0) throw parseError(1, "Workspace manifest must declare at least one root");
+	for (const root of manifest.roots) {
+		if (!root.path.startsWith("/")) throw parseError(1, `Workspace root "${root.id}" path must be absolute: ${root.path}`);
+		if (pathHasTraversal(root.path)) throw parseError(1, `Workspace root "${root.id}" path must not contain traversal (..): ${root.path}`);
+	}
+	if (manifest.defaultPath !== void 0) {
+		if (!manifest.defaultPath.startsWith("/")) throw parseError(1, `Workspace default path must be absolute: ${manifest.defaultPath}`);
+		if (pathHasTraversal(manifest.defaultPath)) throw parseError(1, `Workspace default path must not contain traversal (..): ${manifest.defaultPath}`);
+	}
+}
+function compileWorkspaceDsl(source) {
+	const declaration = parseDeclaration(source, {
+		kind: "workspace",
+		allowQuotedId: true,
+		allowHeadValues: true,
+		expected: "Expected workspace \"Title\" {",
+		fieldKeywords: [
+			"description",
+			"default",
+			"detail",
+			"agent",
+			"rail",
+			"group",
+			"root"
+		],
+		fieldInlineContinuationKeywords: { root: ["description"] },
+		nestedFieldKeywords: ["group"],
+		error: parseSharedError
+	});
+	const variant = parseVariant(declaration.headValues ?? []);
+	const workspace = {
+		title: declaration.id,
+		...variant ? { variant } : {},
+		rail: [],
+		sections: []
+	};
+	let railOrder = 1;
+	const sections = [];
+	for (const field of declaration.fields) {
+		if (field.name.value === "description") {
+			workspace.description = parseSingleStringField(field, "Expected description \"<text>\"");
+			continue;
+		}
+		if (field.name.value === "default") {
+			workspace.defaultPath = parseSingleStringField(field, "Expected default \"<path>\"");
+			continue;
+		}
+		if (field.name.value === "detail") {
+			workspace.detail = parseDetailField(field);
+			continue;
+		}
+		if (field.name.value === "agent") {
+			workspace.agent = parseAgentField(field);
+			continue;
+		}
+		if (field.name.value === "rail") {
+			workspace.rail ??= [];
+			workspace.rail.push(parseRailField(field, railOrder++));
+			continue;
+		}
+		if (field.name.value === "group") {
+			sections.push(parseGroupField(field, sections.length + 1));
+			continue;
+		}
+		if (field.name.value === "root") {
+			const section = ensureDefaultSection(sections);
+			section.roots ??= [];
+			section.roots.push(parseRootField(field, section.roots.length + 1));
+			continue;
+		}
+		throw parseError(field.name.line, `Unsupported workspace DSL line: ${field.name.value}`, field.name.column);
+	}
+	workspace.sections = sections;
+	if (workspace.rail?.length === 0) delete workspace.rail;
+	if (workspace.sections.length === 0) throw parseError(1, "Workspace DSL must define at least one root");
+	return workspace;
+}
+function formatWorkspaceDsl(source) {
+	const workspace = compileWorkspaceDsl(source);
+	const lines = [`workspace ${quote(workspace.title ?? "Workspace")}${workspace.variant ? ` variant ${workspace.variant}` : ""} {`];
+	if (workspace.description) lines.push(`  description ${quote(workspace.description)}`);
+	if (workspace.defaultPath) lines.push(`  default ${quote(workspace.defaultPath)}`);
+	if (workspace.detail?.renderer) lines.push(`  detail ${workspace.detail.renderer}${workspace.detail.pattern ? ` pattern ${workspace.detail.pattern}` : ""}`);
+	if (workspace.agent?.module) lines.push(`  agent ${workspace.agent.module}${workspace.agent.title ? ` ${quote(workspace.agent.title)}` : ""}${workspace.agent.placeholder ? ` placeholder ${quote(workspace.agent.placeholder)}` : ""}`);
+	for (const item of workspace.rail ?? []) lines.push(`  rail ${quote(item.title)}${item.icon ? ` icon ${item.icon}` : ""}${item.href ? ` href ${quote(item.href)}` : ""}${item.active ? " active" : ""}`);
+	const sections = workspace.sections ?? [];
+	if (sections.length > 0) lines.push("");
+	sections.forEach((section, index) => {
+		if (index > 0) lines.push("");
+		const sectionId = section.id && section.id !== slugify(section.title) ? `${section.id} ` : "";
+		lines.push(`  group ${sectionId}${quote(section.title)} {`);
+		if (section.description) lines.push(`    description ${quote(section.description)}`);
+		for (const root of section.roots ?? []) {
+			const options = [
+				root.maxDepth !== void 0 ? `depth ${root.maxDepth}` : void 0,
+				root.itemStyle && root.itemStyle !== "compact" ? `style ${root.itemStyle}` : void 0,
+				...formatRootFilterOptions(root),
+				root.description ? `description ${quote(root.description)}` : void 0,
+				root.editable === true ? "editable" : root.editable === false ? "readonly" : void 0
+			].filter(Boolean).join(" ");
+			const rootId = root.id && root.id !== slugify(root.title) ? `${root.id} ` : "";
+			lines.push(`    root ${rootId}${quote(root.title)} from ${quote(root.path)}${options ? ` ${options}` : ""}`);
+		}
+		lines.push("  }");
+	});
+	lines.push("}");
+	return `${lines.join("\n")}\n`;
+}
+function ensureDefaultSection(sections) {
+	let section = sections[0];
+	if (!section) {
+		section = {
+			id: "workspace",
+			title: "Workspace",
+			order: 1,
+			roots: []
+		};
+		sections.push(section);
+	}
+	return section;
+}
+function parseVariant(tokens) {
+	if (tokens.length === 0) return void 0;
+	if (tokens.length === 2 && tokens[0]?.type === "word" && tokens[0].value === "variant") {
+		const variant = tokens[1];
+		if (variant?.type === "word") return variant.value;
+	}
+	const token = tokens[0];
+	throw parseError(token?.line ?? 1, "Expected workspace \"Title\" [variant name] {", token?.column);
+}
+function parseDetailField(field) {
+	const renderer = field.values[0];
+	if (renderer?.type !== "word" || renderer.value !== "surface" && renderer.value !== "auto-surface") throw parseError(renderer?.line ?? field.name.line, "Expected detail surface|auto-surface");
+	const patternKeyword = field.values[1];
+	const pattern = field.values[2];
+	if (!patternKeyword) return { renderer: renderer.value };
+	if (patternKeyword.type === "word" && patternKeyword.value === "pattern" && pattern?.type === "word") return {
+		renderer: renderer.value,
+		pattern: pattern.value
+	};
+	throw parseError(patternKeyword.line, "Expected detail surface|auto-surface [pattern name]");
+}
+function parseAgentField(field) {
+	const module = field.values[0];
+	if (module?.type !== "word") throw parseError(module?.line ?? field.name.line, "Expected agent <module> [\"Title\"]");
+	let index = 1;
+	let title;
+	if (field.values[index]?.type === "string") {
+		title = parseDslStringToken(field.values[index], parseSharedError);
+		index += 1;
+	}
+	let placeholder;
+	const placeholderKeyword = field.values[index];
+	if (placeholderKeyword) {
+		const value = field.values[index + 1];
+		if (placeholderKeyword.type !== "word" || placeholderKeyword.value !== "placeholder" || value?.type !== "string") throw parseError(placeholderKeyword.line, "Expected agent <module> [\"Title\"] [placeholder \"...\"]");
+		placeholder = parseDslStringToken(value, parseSharedError);
+		index += 2;
+	}
+	if (field.values.length !== index) {
+		const token = field.values[index];
+		throw parseError(token.line, "Expected agent <module> [\"Title\"] [placeholder \"...\"]", token.column);
+	}
+	return {
+		module: module.value,
+		...title ? { title } : {},
+		...placeholder ? { placeholder } : {}
+	};
+}
+function parseRailField(field, order) {
+	const titleToken = field.values[0];
+	if (titleToken?.type !== "string") throw parseError(titleToken?.line ?? field.name.line, "Expected rail \"Title\"");
+	const title = parseDslStringToken(titleToken, parseSharedError);
+	const rest = joinDslValues(field.values.slice(1));
+	const icon = rest.match(/\bicon\s+([A-Za-z0-9_-]+)/);
+	const href = rest.match(/* @__PURE__ */ new RegExp(`\\bhref\\s+${STRING}`));
+	return {
+		id: slugify(title),
+		title,
+		...icon?.[1] ? { icon: icon[1] } : {},
+		...href?.[1] ? { href: unescapeString(href[1]) } : {},
+		...rest.match(/\bactive\b/) ? { active: true } : {},
+		order
+	};
+}
+function parseGroupField(field, order) {
+	const parsed = parseOptionalIdTitleField(field, "Expected group [id] \"Title\" {");
+	const section = {
+		id: parsed.id ?? slugify(parsed.title),
+		title: parsed.title,
+		order,
+		roots: []
+	};
+	let rootOrder = 1;
+	for (const child of field.children ?? []) {
+		if (child.name.value === "description") {
+			section.description = parseSingleStringField(child, "Expected description \"<text>\"");
+			continue;
+		}
+		if (child.name.value === "root") {
+			section.roots?.push(parseRootField(child, rootOrder++));
+			continue;
+		}
+		throw parseError(child.name.line, `Unsupported workspace group DSL line: ${child.name.value}`, child.name.column);
+	}
+	return section;
+}
+function parseRootField(field, order) {
+	const parsed = parseOptionalIdTitleField(field, "Expected root [id] \"Title\" from \"<path>\"");
+	const from = field.values[parsed.nextIndex];
+	const path = field.values[parsed.nextIndex + 1];
+	if (from?.type !== "word" || from.value !== "from" || path?.type !== "string") throw parseError(from?.line ?? field.name.line, "Expected root [id] \"Title\" from \"<path>\"");
+	const rest = joinDslValues(field.values.slice(parsed.nextIndex + 2));
+	const depth = rest.match(/\bdepth\s+(\d+)/);
+	const style = rest.match(/\bstyle\s+([A-Za-z0-9_-]+)/);
+	const descriptionValue = rest.match(/* @__PURE__ */ new RegExp(`\\bdescription\\s+${STRING}`));
+	const excludes = parseStringListOption(rest, "exclude");
+	const filter = excludes.length > 0 ? { exclude: excludes } : rest.match(/\bfilter\s+none\b/) ? void 0 : { exclude: [".aup"] };
+	const editable = rest.match(/\beditable\b/) ? true : rest.match(/\breadonly\b/) ? false : void 0;
+	return {
+		id: parsed.id ?? slugify(parsed.title),
+		title: parsed.title,
+		path: parseDslStringToken(path, parseSharedError),
+		...descriptionValue?.[1] ? { description: unescapeString(descriptionValue[1]) } : {},
+		order,
+		maxDepth: depth ? Number(depth[1]) : 1,
+		layout: "grouped",
+		itemStyle: style?.[1] ?? "compact",
+		...filter ? { filter } : {},
+		sort: { field: "id" },
+		...editable !== void 0 ? { editable } : {}
+	};
+}
+function parseOptionalIdTitleField(field, message) {
+	const first = field.values[0];
+	const second = field.values[1];
+	if (first?.type === "string") return {
+		title: parseDslStringToken(first, parseSharedError),
+		nextIndex: 1
+	};
+	if (first?.type === "word" && second?.type === "string") return {
+		id: first.value,
+		title: parseDslStringToken(second, parseSharedError),
+		nextIndex: 2
+	};
+	throw parseError(first?.line ?? field.name.line, message, first?.column ?? field.name.column);
+}
+function parseSingleStringField(field, message) {
+	const value = field.values[0];
+	if (field.values.length !== 1 || value?.type !== "string") throw parseError(value?.line ?? field.name.line, message, value?.column ?? field.name.column);
+	return parseDslStringToken(value, parseSharedError);
+}
+function joinDslValues(tokens) {
+	return tokens.map((token) => token.value).join(" ");
+}
+function parseSharedError(message, line, column = 1) {
+	return parseError(line, message, column);
+}
+function unescapeString(value) {
+	return value.replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+}
+function quote(value) {
+	return JSON.stringify(value);
+}
+function parseStringListOption(rest, option) {
+	const optionMatch = rest.match(/* @__PURE__ */ new RegExp(`\\b${option}\\b`));
+	if (!optionMatch || optionMatch.index === void 0) return [];
+	const tail = rest.slice(optionMatch.index + option.length).trimStart();
+	const nextKeywordIndex = tail.search(/\s+(?:description|depth|style|editable|readonly|filter)\b/);
+	const valueSource = nextKeywordIndex >= 0 ? tail.slice(0, nextKeywordIndex) : tail;
+	const values = [];
+	for (const match of valueSource.matchAll(new RegExp(STRING, "g"))) values.push(unescapeString(match[1] ?? ""));
+	return values;
+}
+function formatRootFilterOptions(root) {
+	if (!root.filter) return ["filter none"];
+	if (typeof root.filter === "string") return [];
+	const exclude = root.filter.exclude;
+	if (!Array.isArray(exclude)) return [];
+	const values = exclude.filter((value) => typeof value === "string");
+	if (values.length === 1 && values[0] === ".aup") return [];
+	return [`exclude ${values.map((value) => quote(value)).join(" ")}`];
+}
+function slugify(value) {
+	return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "workspace";
+}
+function parseError(line, message, column = 1) {
+	return scaffoldDslParseError("workspace", line, message, column);
+}
+
+//#endregion
+export { compileWorkspaceDsl, formatWorkspaceDsl, validateWorkspaceManifest, workspaceManifestFromDefinition };
+//# sourceMappingURL=workspace-dsl.mjs.map

package/dist/scaffold/workspace-dsl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-dsl.mjs","names":[],"sources":["../../src/scaffold/workspace-dsl.ts"],"sourcesContent":["import {\n  type DslField,\n  type DslToken,\n  parseDeclaration,\n  parseDslStringToken,\n} from \"../dsl-shared.js\";\nimport { scaffoldDslParseError } from \"./dsl-error.js\";\nimport type {\n  ScaffoldWorkspaceDefinition,\n  ScaffoldWorkspaceRailItem,\n  ScaffoldWorkspaceRoot,\n  ScaffoldWorkspaceSection,\n} from \"./types.js\";\n\nconst STRING = '\"((?:[^\"\\\\\\\\]|\\\\\\\\.)*)\"';\n\n/**\n * Formalized `afs-workspace` convention contract (task 0.1).\n *\n * The `workspace.dsl` shell language parses into a {@link ScaffoldWorkspaceDefinition}\n * (rail/variant/sections/etc — the full shell). The *convention schema* is the\n * narrower contract the generalized wiring depends on: the folder roots (each a\n * select→content source), the agent, and the default content path. Extracting\n * it into a flat, validated manifest keeps the convention decoupled from the\n * particular DSL surface and gives one place to reject bad manifests.\n */\nexport interface WorkspaceManifestRoot {\n  id: string;\n  title: string;\n  /** Absolute AFS path to the folder this root projects. */\n  path: string;\n  editable?: boolean;\n}\n\nexport interface WorkspaceManifestAgent {\n  module: string;\n  title?: string;\n  placeholder?: string;\n}\n\nexport interface WorkspaceManifest {\n  roots: WorkspaceManifestRoot[];\n  defaultPath?: string;\n  agent?: WorkspaceManifestAgent;\n}\n\nfunction pathHasTraversal(path: string): boolean {\n  // Check both the raw and percent-decoded forms so an encoded `%2e%2e`\n  // traversal cannot slip past the literal `..` check.\n  let decoded = path;\n  try {\n    decoded = decodeURIComponent(path);\n  } catch {\n    // Malformed encoding — treat the raw form as the source of truth.\n  }\n  const re = /(^|\\/)\\.\\.($|\\/)/;\n  return re.test(path) || re.test(decoded);\n}\n\n/**\n * Project a parsed workspace definition onto the formalized convention\n * manifest — flattening sections to their folder roots and lifting the agent\n * and default content path.\n */\nexport function workspaceManifestFromDefinition(\n  definition: ScaffoldWorkspaceDefinition,\n): WorkspaceManifest {\n  const roots: WorkspaceManifestRoot[] = [];\n  for (const section of definition.sections ?? []) {\n    for (const root of section.roots ?? []) {\n      roots.push({\n        id: root.id,\n        title: root.title,\n        path: root.path,\n        ...(root.editable !== undefined ? { editable: root.editable } : {}),\n      });\n    }\n  }\n  return {\n    roots,\n    ...(definition.defaultPath ? { defaultPath: definition.defaultPath } : {}),\n    ...(definition.agent?.module\n      ? {\n          agent: {\n            module: definition.agent.module,\n            ...(definition.agent.title ? { title: definition.agent.title } : {}),\n            ...(definition.agent.placeholder ? { placeholder: definition.agent.placeholder } : {}),\n          },\n        }\n      : {}),\n  };\n}\n\n/**\n * Schema-validate a workspace convention manifest (strict: declare ⇒ execute,\n * never silently degrade to an empty workspace). Throws a\n * {@link ScaffoldDslCompileError} on any violation:\n * - no folder roots at all,\n * - a root `from` / `default` path that is relative or contains `..` traversal.\n */\nexport function validateWorkspaceManifest(manifest: WorkspaceManifest): void {\n  if (!manifest.roots || manifest.roots.length === 0) {\n    throw parseError(1, \"Workspace manifest must declare at least one root\");\n  }\n  for (const root of manifest.roots) {\n    if (!root.path.startsWith(\"/\")) {\n      throw parseError(1, `Workspace root \"${root.id}\" path must be absolute: ${root.path}`);\n    }\n    if (pathHasTraversal(root.path)) {\n      throw parseError(\n        1,\n        `Workspace root \"${root.id}\" path must not contain traversal (..): ${root.path}`,\n      );\n    }\n  }\n  if (manifest.defaultPath !== undefined) {\n    if (!manifest.defaultPath.startsWith(\"/\")) {\n      throw parseError(1, `Workspace default path must be absolute: ${manifest.defaultPath}`);\n    }\n    if (pathHasTraversal(manifest.defaultPath)) {\n      throw parseError(\n        1,\n        `Workspace default path must not contain traversal (..): ${manifest.defaultPath}`,\n      );\n    }\n  }\n}\n\nexport function compileWorkspaceDsl(source: string): ScaffoldWorkspaceDefinition {\n  const declaration = parseDeclaration(source, {\n    kind: \"workspace\",\n    allowQuotedId: true,\n    allowHeadValues: true,\n    expected: 'Expected workspace \"Title\" {',\n    fieldKeywords: [\"description\", \"default\", \"detail\", \"agent\", \"rail\", \"group\", \"root\"],\n    fieldInlineContinuationKeywords: { root: [\"description\"] },\n    nestedFieldKeywords: [\"group\"],\n    error: parseSharedError,\n  });\n\n  const variant = parseVariant(declaration.headValues ?? []);\n  const workspace: ScaffoldWorkspaceDefinition = {\n    title: declaration.id,\n    ...(variant ? { variant } : {}),\n    rail: [],\n    sections: [],\n  };\n\n  let railOrder = 1;\n  const sections: ScaffoldWorkspaceSection[] = [];\n  for (const field of declaration.fields) {\n    if (field.name.value === \"description\") {\n      workspace.description = parseSingleStringField(field, 'Expected description \"<text>\"');\n      continue;\n    }\n    if (field.name.value === \"default\") {\n      workspace.defaultPath = parseSingleStringField(field, 'Expected default \"<path>\"');\n      continue;\n    }\n    if (field.name.value === \"detail\") {\n      workspace.detail = parseDetailField(field);\n      continue;\n    }\n    if (field.name.value === \"agent\") {\n      workspace.agent = parseAgentField(field);\n      continue;\n    }\n    if (field.name.value === \"rail\") {\n      workspace.rail ??= [];\n      workspace.rail.push(parseRailField(field, railOrder++));\n      continue;\n    }\n    if (field.name.value === \"group\") {\n      sections.push(parseGroupField(field, sections.length + 1));\n      continue;\n    }\n    if (field.name.value === \"root\") {\n      const section = ensureDefaultSection(sections);\n      section.roots ??= [];\n      section.roots.push(parseRootField(field, section.roots.length + 1));\n      continue;\n    }\n\n    throw parseError(\n      field.name.line,\n      `Unsupported workspace DSL line: ${field.name.value}`,\n      field.name.column,\n    );\n  }\n\n  workspace.sections = sections;\n  if (workspace.rail?.length === 0) delete workspace.rail;\n  if (workspace.sections.length === 0) {\n    throw parseError(1, \"Workspace DSL must define at least one root\");\n  }\n  return workspace;\n}\n\nexport function formatWorkspaceDsl(source: string): string {\n  const workspace = compileWorkspaceDsl(source);\n  const lines = [\n    `workspace ${quote(workspace.title ?? \"Workspace\")}${\n      workspace.variant ? ` variant ${workspace.variant}` : \"\"\n    } {`,\n  ];\n  if (workspace.description) lines.push(`  description ${quote(workspace.description)}`);\n  if (workspace.defaultPath) lines.push(`  default ${quote(workspace.defaultPath)}`);\n  if (workspace.detail?.renderer) {\n    lines.push(\n      `  detail ${workspace.detail.renderer}${\n        workspace.detail.pattern ? ` pattern ${workspace.detail.pattern}` : \"\"\n      }`,\n    );\n  }\n  if (workspace.agent?.module) {\n    lines.push(\n      `  agent ${workspace.agent.module}${\n        workspace.agent.title ? ` ${quote(workspace.agent.title)}` : \"\"\n      }${workspace.agent.placeholder ? ` placeholder ${quote(workspace.agent.placeholder)}` : \"\"}`,\n    );\n  }\n  for (const item of workspace.rail ?? []) {\n    lines.push(\n      `  rail ${quote(item.title)}${item.icon ? ` icon ${item.icon}` : \"\"}${\n        item.href ? ` href ${quote(item.href)}` : \"\"\n      }${item.active ? \" active\" : \"\"}`,\n    );\n  }\n\n  const sections = workspace.sections ?? [];\n  if (sections.length > 0) lines.push(\"\");\n  sections.forEach((section, index) => {\n    if (index > 0) lines.push(\"\");\n    const sectionId = section.id && section.id !== slugify(section.title) ? `${section.id} ` : \"\";\n    lines.push(`  group ${sectionId}${quote(section.title)} {`);\n    if (section.description) lines.push(`    description ${quote(section.description)}`);\n    for (const root of section.roots ?? []) {\n      const options = [\n        root.maxDepth !== undefined ? `depth ${root.maxDepth}` : undefined,\n        root.itemStyle && root.itemStyle !== \"compact\" ? `style ${root.itemStyle}` : undefined,\n        ...formatRootFilterOptions(root),\n        root.description ? `description ${quote(root.description)}` : undefined,\n        root.editable === true ? \"editable\" : root.editable === false ? \"readonly\" : undefined,\n      ]\n        .filter(Boolean)\n        .join(\" \");\n      const rootId = root.id && root.id !== slugify(root.title) ? `${root.id} ` : \"\";\n      lines.push(\n        `    root ${rootId}${quote(root.title)} from ${quote(root.path)}${options ? ` ${options}` : \"\"}`,\n      );\n    }\n    lines.push(\"  }\");\n  });\n\n  lines.push(\"}\");\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction ensureDefaultSection(sections: ScaffoldWorkspaceSection[]): ScaffoldWorkspaceSection {\n  let section = sections[0];\n  if (!section) {\n    section = { id: \"workspace\", title: \"Workspace\", order: 1, roots: [] };\n    sections.push(section);\n  }\n  return section;\n}\n\nfunction parseVariant(tokens: DslToken[]): string | undefined {\n  if (tokens.length === 0) return undefined;\n  if (tokens.length === 2 && tokens[0]?.type === \"word\" && tokens[0].value === \"variant\") {\n    const variant = tokens[1];\n    if (variant?.type === \"word\") return variant.value;\n  }\n  const token = tokens[0];\n  throw parseError(token?.line ?? 1, 'Expected workspace \"Title\" [variant name] {', token?.column);\n}\n\nfunction parseDetailField(field: DslField): NonNullable<ScaffoldWorkspaceDefinition[\"detail\"]> {\n  const renderer = field.values[0];\n  if (\n    renderer?.type !== \"word\" ||\n    (renderer.value !== \"surface\" && renderer.value !== \"auto-surface\")\n  ) {\n    throw parseError(renderer?.line ?? field.name.line, \"Expected detail surface|auto-surface\");\n  }\n\n  const patternKeyword = field.values[1];\n  const pattern = field.values[2];\n  if (!patternKeyword) return { renderer: renderer.value };\n  if (\n    patternKeyword.type === \"word\" &&\n    patternKeyword.value === \"pattern\" &&\n    pattern?.type === \"word\"\n  ) {\n    return { renderer: renderer.value, pattern: pattern.value };\n  }\n  throw parseError(patternKeyword.line, \"Expected detail surface|auto-surface [pattern name]\");\n}\n\nfunction parseAgentField(field: DslField): NonNullable<ScaffoldWorkspaceDefinition[\"agent\"]> {\n  const module = field.values[0];\n  if (module?.type !== \"word\") {\n    throw parseError(module?.line ?? field.name.line, 'Expected agent <module> [\"Title\"]');\n  }\n\n  let index = 1;\n  let title: string | undefined;\n  if (field.values[index]?.type === \"string\") {\n    title = parseDslStringToken(field.values[index]!, parseSharedError);\n    index += 1;\n  }\n\n  let placeholder: string | undefined;\n  const placeholderKeyword = field.values[index];\n  if (placeholderKeyword) {\n    const value = field.values[index + 1];\n    if (\n      placeholderKeyword.type !== \"word\" ||\n      placeholderKeyword.value !== \"placeholder\" ||\n      value?.type !== \"string\"\n    ) {\n      throw parseError(\n        placeholderKeyword.line,\n        'Expected agent <module> [\"Title\"] [placeholder \"...\"]',\n      );\n    }\n    placeholder = parseDslStringToken(value, parseSharedError);\n    index += 2;\n  }\n  if (field.values.length !== index) {\n    const token = field.values[index]!;\n    throw parseError(\n      token.line,\n      'Expected agent <module> [\"Title\"] [placeholder \"...\"]',\n      token.column,\n    );\n  }\n\n  return {\n    module: module.value,\n    ...(title ? { title } : {}),\n    ...(placeholder ? { placeholder } : {}),\n  };\n}\n\nfunction parseRailField(field: DslField, order: number): ScaffoldWorkspaceRailItem {\n  const titleToken = field.values[0];\n  if (titleToken?.type !== \"string\") {\n    throw parseError(titleToken?.line ?? field.name.line, 'Expected rail \"Title\"');\n  }\n  const title = parseDslStringToken(titleToken, parseSharedError);\n  const rest = joinDslValues(field.values.slice(1));\n  const icon = rest.match(/\\bicon\\s+([A-Za-z0-9_-]+)/);\n  const href = rest.match(new RegExp(`\\\\bhref\\\\s+${STRING}`));\n  return {\n    id: slugify(title),\n    title,\n    ...(icon?.[1] ? { icon: icon[1] } : {}),\n    ...(href?.[1] ? { href: unescapeString(href[1]) } : {}),\n    ...(rest.match(/\\bactive\\b/) ? { active: true } : {}),\n    order,\n  };\n}\n\nfunction parseGroupField(field: DslField, order: number): ScaffoldWorkspaceSection {\n  const parsed = parseOptionalIdTitleField(field, 'Expected group [id] \"Title\" {');\n  const section: ScaffoldWorkspaceSection = {\n    id: parsed.id ?? slugify(parsed.title),\n    title: parsed.title,\n    order,\n    roots: [],\n  };\n  let rootOrder = 1;\n  for (const child of field.children ?? []) {\n    if (child.name.value === \"description\") {\n      section.description = parseSingleStringField(child, 'Expected description \"<text>\"');\n      continue;\n    }\n    if (child.name.value === \"root\") {\n      section.roots?.push(parseRootField(child, rootOrder++));\n      continue;\n    }\n    throw parseError(\n      child.name.line,\n      `Unsupported workspace group DSL line: ${child.name.value}`,\n      child.name.column,\n    );\n  }\n  return section;\n}\n\nfunction parseRootField(field: DslField, order: number): ScaffoldWorkspaceRoot {\n  const parsed = parseOptionalIdTitleField(field, 'Expected root [id] \"Title\" from \"<path>\"');\n  const from = field.values[parsed.nextIndex];\n  const path = field.values[parsed.nextIndex + 1];\n  if (from?.type !== \"word\" || from.value !== \"from\" || path?.type !== \"string\") {\n    throw parseError(from?.line ?? field.name.line, 'Expected root [id] \"Title\" from \"<path>\"');\n  }\n\n  const rest = joinDslValues(field.values.slice(parsed.nextIndex + 2));\n  const depth = rest.match(/\\bdepth\\s+(\\d+)/);\n  const style = rest.match(/\\bstyle\\s+([A-Za-z0-9_-]+)/);\n  const descriptionValue = rest.match(new RegExp(`\\\\bdescription\\\\s+${STRING}`));\n  const excludes = parseStringListOption(rest, \"exclude\");\n  const filter =\n    excludes.length > 0\n      ? { exclude: excludes }\n      : rest.match(/\\bfilter\\s+none\\b/)\n        ? undefined\n        : { exclude: [\".aup\"] };\n  const editable = rest.match(/\\beditable\\b/)\n    ? true\n    : rest.match(/\\breadonly\\b/)\n      ? false\n      : undefined;\n\n  return {\n    id: parsed.id ?? slugify(parsed.title),\n    title: parsed.title,\n    path: parseDslStringToken(path, parseSharedError),\n    ...(descriptionValue?.[1] ? { description: unescapeString(descriptionValue[1]) } : {}),\n    order,\n    maxDepth: depth ? Number(depth[1]) : 1,\n    layout: \"grouped\",\n    itemStyle: style?.[1] ?? \"compact\",\n    ...(filter ? { filter } : {}),\n    sort: { field: \"id\" },\n    ...(editable !== undefined ? { editable } : {}),\n  };\n}\n\nfunction parseOptionalIdTitleField(\n  field: DslField,\n  message: string,\n): { id?: string; nextIndex: number; title: string } {\n  const first = field.values[0];\n  const second = field.values[1];\n  if (first?.type === \"string\") {\n    return { title: parseDslStringToken(first, parseSharedError), nextIndex: 1 };\n  }\n  if (first?.type === \"word\" && second?.type === \"string\") {\n    return {\n      id: first.value,\n      title: parseDslStringToken(second, parseSharedError),\n      nextIndex: 2,\n    };\n  }\n  throw parseError(first?.line ?? field.name.line, message, first?.column ?? field.name.column);\n}\n\nfunction parseSingleStringField(field: DslField, message: string): string {\n  const value = field.values[0];\n  if (field.values.length !== 1 || value?.type !== \"string\") {\n    throw parseError(value?.line ?? field.name.line, message, value?.column ?? field.name.column);\n  }\n  return parseDslStringToken(value, parseSharedError);\n}\n\nfunction joinDslValues(tokens: DslToken[]): string {\n  return tokens.map((token) => token.value).join(\" \");\n}\n\nfunction parseSharedError(message: string, line: number, column = 1): Error {\n  return parseError(line, message, column);\n}\n\nfunction unescapeString(value: string): string {\n  return value.replace(/\\\\\"/g, '\"').replace(/\\\\\\\\/g, \"\\\\\");\n}\n\nfunction quote(value: string): string {\n  return JSON.stringify(value);\n}\n\nfunction parseStringListOption(rest: string, option: string): string[] {\n  const optionMatch = rest.match(new RegExp(`\\\\b${option}\\\\b`));\n  if (!optionMatch || optionMatch.index === undefined) return [];\n  const tail = rest.slice(optionMatch.index + option.length).trimStart();\n  const nextKeywordIndex = tail.search(/\\s+(?:description|depth|style|editable|readonly|filter)\\b/);\n  const valueSource = nextKeywordIndex >= 0 ? tail.slice(0, nextKeywordIndex) : tail;\n  const values: string[] = [];\n  for (const match of valueSource.matchAll(new RegExp(STRING, \"g\"))) {\n    values.push(unescapeString(match[1] ?? \"\"));\n  }\n  return values;\n}\n\nfunction formatRootFilterOptions(root: ScaffoldWorkspaceRoot): string[] {\n  if (!root.filter) return [\"filter none\"];\n  if (typeof root.filter === \"string\") return [];\n  const exclude = root.filter.exclude;\n  if (!Array.isArray(exclude)) return [];\n  const values = exclude.filter((value): value is string => typeof value === \"string\");\n  if (values.length === 1 && values[0] === \".aup\") return [];\n  return [`exclude ${values.map((value) => quote(value)).join(\" \")}`];\n}\n\nfunction slugify(value: string): string {\n  return (\n    value\n      .trim()\n      .toLowerCase()\n      .replace(/[^a-z0-9]+/g, \"-\")\n      .replace(/^-+|-+$/g, \"\") || \"workspace\"\n  );\n}\n\nfunction parseError(line: number, message: string, column = 1): Error {\n  return scaffoldDslParseError(\"workspace\", line, message, column);\n}\n"],"mappings":"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"}

package/dist/scope/index.d.mts

@@ -0,0 +1,3 @@
+import { BlockletScope, ResolveScopedAFSInput, ResolveScopedAFSResult, ScopeActivator } from "./types.mjs";
+import { readBlockletScope } from "./read-blocklet-scope.mjs";
+import { resolveScopedAFS } from "./resolve-scoped-afs.mjs";

package/dist/scope/read-blocklet-scope.cjs

@@ -0,0 +1,29 @@
+let ufo = require("ufo");
+let _aigne_afs = require("@aigne/afs");
+
+//#region src/scope/read-blocklet-scope.ts
+/**
+* Read /registry/blocklets/<name>/blocklet.yaml via globalAFS and return
+* the declared scope. Falls back to "app" on any error — never throws.
+*
+* Scope routing must always have a defined value, so any failure
+* (404, malformed YAML, invalid scope, unsafe blocklet name) collapses
+* to the safe default. Callers downstream then route through an activator.
+*/
+const REGISTRY_PATH = "/registry/blocklets";
+const MANIFEST_FILE = "blocklet.yaml";
+const UTF8_DECODER = new TextDecoder();
+async function readBlockletScope(globalAFS, blockletName) {
+	try {
+		if (typeof globalAFS.read !== "function") return "app";
+		const raw = ((await globalAFS.read((0, ufo.joinURL)(REGISTRY_PATH, blockletName, MANIFEST_FILE)))?.data)?.content;
+		const content = typeof raw === "string" ? raw : raw instanceof Uint8Array ? UTF8_DECODER.decode(raw) : null;
+		if (typeof content !== "string" || !content.trim()) return "app";
+		return (0, _aigne_afs.parseBlockletManifest)(content).scope ?? "app";
+	} catch {
+		return "app";
+	}
+}
+
+//#endregion
+exports.readBlockletScope = readBlockletScope;

package/dist/scope/read-blocklet-scope.d.cts

@@ -0,0 +1,8 @@
+import { BlockletScope } from "./types.cjs";
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/scope/read-blocklet-scope.d.ts
+declare function readBlockletScope(globalAFS: AFSRoot, blockletName: string): Promise<BlockletScope>;
+//#endregion
+export { readBlockletScope };
+//# sourceMappingURL=read-blocklet-scope.d.cts.map

package/dist/scope/read-blocklet-scope.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-blocklet-scope.d.cts","names":[],"sources":["../../src/scope/read-blocklet-scope.ts"],"mappings":";;;;iBAiBsB,iBAAA,CACpB,SAAA,EAAW,OAAA,EACX,YAAA,WACC,OAAA,CAAQ,aAAA"}

package/dist/scope/read-blocklet-scope.d.mts

@@ -0,0 +1,8 @@
+import { BlockletScope } from "./types.mjs";
+import { AFSRoot } from "@aigne/afs";
+
+//#region src/scope/read-blocklet-scope.d.ts
+declare function readBlockletScope(globalAFS: AFSRoot, blockletName: string): Promise<BlockletScope>;
+//#endregion
+export { readBlockletScope };
+//# sourceMappingURL=read-blocklet-scope.d.mts.map

package/dist/scope/read-blocklet-scope.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-blocklet-scope.d.mts","names":[],"sources":["../../src/scope/read-blocklet-scope.ts"],"mappings":";;;;iBAiBsB,iBAAA,CACpB,SAAA,EAAW,OAAA,EACX,YAAA,WACC,OAAA,CAAQ,aAAA"}

package/dist/scope/read-blocklet-scope.mjs

@@ -0,0 +1,30 @@
+import { joinURL } from "ufo";
+import { parseBlockletManifest } from "@aigne/afs";
+
+//#region src/scope/read-blocklet-scope.ts
+/**
+* Read /registry/blocklets/<name>/blocklet.yaml via globalAFS and return
+* the declared scope. Falls back to "app" on any error — never throws.
+*
+* Scope routing must always have a defined value, so any failure
+* (404, malformed YAML, invalid scope, unsafe blocklet name) collapses
+* to the safe default. Callers downstream then route through an activator.
+*/
+const REGISTRY_PATH = "/registry/blocklets";
+const MANIFEST_FILE = "blocklet.yaml";
+const UTF8_DECODER = new TextDecoder();
+async function readBlockletScope(globalAFS, blockletName) {
+	try {
+		if (typeof globalAFS.read !== "function") return "app";
+		const raw = ((await globalAFS.read(joinURL(REGISTRY_PATH, blockletName, MANIFEST_FILE)))?.data)?.content;
+		const content = typeof raw === "string" ? raw : raw instanceof Uint8Array ? UTF8_DECODER.decode(raw) : null;
+		if (typeof content !== "string" || !content.trim()) return "app";
+		return parseBlockletManifest(content).scope ?? "app";
+	} catch {
+		return "app";
+	}
+}
+
+//#endregion
+export { readBlockletScope };
+//# sourceMappingURL=read-blocklet-scope.mjs.map

package/dist/scope/read-blocklet-scope.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-blocklet-scope.mjs","names":[],"sources":["../../src/scope/read-blocklet-scope.ts"],"sourcesContent":["/**\n * Read /registry/blocklets/<name>/blocklet.yaml via globalAFS and return\n * the declared scope. Falls back to \"app\" on any error — never throws.\n *\n * Scope routing must always have a defined value, so any failure\n * (404, malformed YAML, invalid scope, unsafe blocklet name) collapses\n * to the safe default. Callers downstream then route through an activator.\n */\n\nimport { type AFSRoot, parseBlockletManifest } from \"@aigne/afs\";\nimport { joinURL } from \"ufo\";\nimport type { BlockletScope } from \"./types.js\";\n\nconst REGISTRY_PATH = \"/registry/blocklets\";\nconst MANIFEST_FILE = \"blocklet.yaml\";\nconst UTF8_DECODER = new TextDecoder();\n\nexport async function readBlockletScope(\n  globalAFS: AFSRoot,\n  blockletName: string,\n): Promise<BlockletScope> {\n  try {\n    if (typeof globalAFS.read !== \"function\") return \"app\";\n    const result = await globalAFS.read(joinURL(REGISTRY_PATH, blockletName, MANIFEST_FILE));\n    const raw = (result?.data as { content?: unknown } | undefined)?.content;\n    const content =\n      typeof raw === \"string\" ? raw : raw instanceof Uint8Array ? UTF8_DECODER.decode(raw) : null;\n    if (typeof content !== \"string\" || !content.trim()) return \"app\";\n    return parseBlockletManifest(content).scope ?? \"app\";\n  } catch {\n    return \"app\";\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAaA,MAAM,gBAAgB;AACtB,MAAM,gBAAgB;AACtB,MAAM,eAAe,IAAI,aAAa;AAEtC,eAAsB,kBACpB,WACA,cACwB;AACxB,KAAI;AACF,MAAI,OAAO,UAAU,SAAS,WAAY,QAAO;EAEjD,MAAM,QADS,MAAM,UAAU,KAAK,QAAQ,eAAe,cAAc,cAAc,CAAC,GACnE,OAA4C;EACjE,MAAM,UACJ,OAAO,QAAQ,WAAW,MAAM,eAAe,aAAa,aAAa,OAAO,IAAI,GAAG;AACzF,MAAI,OAAO,YAAY,YAAY,CAAC,QAAQ,MAAM,CAAE,QAAO;AAC3D,SAAO,sBAAsB,QAAQ,CAAC,SAAS;SACzC;AACN,SAAO"}

package/dist/scope/resolve-scoped-afs.cjs

@@ -0,0 +1,87 @@
+const require_read_blocklet_scope = require('./read-blocklet-scope.cjs');
+let _aigne_afs = require("@aigne/afs");
+
+//#region src/scope/resolve-scoped-afs.ts
+/**
+* Single source of truth for "given a blocklet, which AFS serves its requests?".
+*
+* Routing rules:
+*   scope: root  → globalAFS pass-through, no activation, no wrapping
+*   scope: app   → activator.ensureActivated() → runtime AFS
+*   scope: user  → same as app; caller data is overlaid per session by SessionUserAFS
+*   scope: agent → same as app
+*
+* Failure modes (graceful, never throw on activation failure):
+*   - Activator missing for non-root scope → log warn, fall back to globalAFS
+*   - Activator returns null → log warn, fall back to globalAFS
+*
+* Adversarial: invalid blocklet names (path traversal, separators, null bytes,
+* empty strings) reject synchronously before any I/O.
+*
+* Concurrency: parallel calls for the same (activator, blocklet) share a single
+* activation promise so the activator is invoked at most once under contention.
+*/
+const log = (0, _aigne_afs.makeNsLog)("aos");
+const BLOCKLET_NAME_RE = /^[A-Za-z0-9._-]+$/;
+function validateBlockletName(name) {
+	if (typeof name !== "string" || name.length === 0) throw new _aigne_afs.AFSValidationError("Invalid blocklet name: empty or non-string");
+	if (name.includes("/") || name.includes("\\") || name.includes("\0")) throw new _aigne_afs.AFSValidationError(`Invalid blocklet name: contains path separator or null byte (${JSON.stringify(name)})`);
+	if (name === "." || name === "..") throw new _aigne_afs.AFSValidationError(`Invalid blocklet name: reserved (${JSON.stringify(name)})`);
+	if (!BLOCKLET_NAME_RE.test(name)) throw new _aigne_afs.AFSValidationError(`Invalid blocklet name: must match ${BLOCKLET_NAME_RE} (${JSON.stringify(name)})`);
+}
+const activationLocks = /* @__PURE__ */ new WeakMap();
+function activateOnce(activator, blockletName) {
+	let perActivator = activationLocks.get(activator);
+	if (!perActivator) {
+		perActivator = /* @__PURE__ */ new Map();
+		activationLocks.set(activator, perActivator);
+	}
+	const inflight = perActivator.get(blockletName);
+	if (inflight) return inflight;
+	const promise = (async () => {
+		try {
+			return await activator.ensureActivated(blockletName);
+		} finally {
+			Promise.resolve().then(() => {
+				perActivator.delete(blockletName);
+			});
+		}
+	})();
+	perActivator.set(blockletName, promise);
+	return promise;
+}
+async function resolveScopedAFS(input) {
+	const { globalAFS, blockletName, activator } = input;
+	validateBlockletName(blockletName);
+	const scope = input.scope ?? await require_read_blocklet_scope.readBlockletScope(globalAFS, blockletName);
+	if (scope === "root") return {
+		afs: globalAFS,
+		scope: "root",
+		isGlobal: true
+	};
+	if (!activator) {
+		log.warn(`[resolveScopedAFS] no activator provided for blocklet=${blockletName} scope=${scope}; falling back to globalAFS`);
+		return {
+			afs: globalAFS,
+			scope,
+			isGlobal: true
+		};
+	}
+	const runtimeAFS = await activateOnce(activator, blockletName);
+	if (!runtimeAFS) {
+		log.warn(`[resolveScopedAFS] activator returned null for blocklet=${blockletName} scope=${scope}; falling back to globalAFS`);
+		return {
+			afs: globalAFS,
+			scope,
+			isGlobal: true
+		};
+	}
+	return {
+		afs: runtimeAFS,
+		scope,
+		isGlobal: false
+	};
+}
+
+//#endregion
+exports.resolveScopedAFS = resolveScopedAFS;

package/dist/scope/resolve-scoped-afs.d.cts

@@ -0,0 +1,7 @@
+import { ResolveScopedAFSInput, ResolveScopedAFSResult } from "./types.cjs";
+
+//#region src/scope/resolve-scoped-afs.d.ts
+declare function resolveScopedAFS(input: ResolveScopedAFSInput): Promise<ResolveScopedAFSResult>;
+//#endregion
+export { resolveScopedAFS };
+//# sourceMappingURL=resolve-scoped-afs.d.cts.map

package/dist/scope/resolve-scoped-afs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-scoped-afs.d.cts","names":[],"sources":["../../src/scope/resolve-scoped-afs.ts"],"mappings":";;;iBA4EsB,gBAAA,CACpB,KAAA,EAAO,qBAAA,GACN,OAAA,CAAQ,sBAAA"}

package/dist/scope/resolve-scoped-afs.d.mts

@@ -0,0 +1,7 @@
+import { ResolveScopedAFSInput, ResolveScopedAFSResult } from "./types.mjs";
+
+//#region src/scope/resolve-scoped-afs.d.ts
+declare function resolveScopedAFS(input: ResolveScopedAFSInput): Promise<ResolveScopedAFSResult>;
+//#endregion
+export { resolveScopedAFS };
+//# sourceMappingURL=resolve-scoped-afs.d.mts.map

package/dist/scope/resolve-scoped-afs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-scoped-afs.d.mts","names":[],"sources":["../../src/scope/resolve-scoped-afs.ts"],"mappings":";;;iBA4EsB,gBAAA,CACpB,KAAA,EAAO,qBAAA,GACN,OAAA,CAAQ,sBAAA"}