chain-insights 0.2.16

package/dist/parser-DO0_SssG.mjs

@@ -0,0 +1,182 @@
+import * as z from "zod";
+//#region src/playbooks/schema.ts
+const ParamSpecSchema = z.object({
+	name: z.string(),
+	type: z.enum([
+		"string",
+		"number",
+		"boolean"
+	]).default("string"),
+	required: z.boolean().default(true),
+	default: z.string().optional()
+});
+const StepSchema = z.object({
+	index: z.number().int().positive(),
+	label: z.string(),
+	tool: z.string().min(1),
+	params: z.record(z.string(), z.string())
+});
+const PlaybookSchema = z.object({
+	name: z.string().min(1),
+	description: z.string().default(""),
+	version: z.string().default("1.0.0"),
+	params: z.array(ParamSpecSchema).default([]),
+	steps: z.array(StepSchema)
+});
+//#endregion
+//#region src/playbooks/parser.ts
+/**
+* Apply {{param}} template substitution to a string.
+* Missing keys are left as-is: {{missing}} remains {{missing}}.
+*/
+function applyTemplate(text, params) {
+	return text.replace(/\{\{(\w+)\}\}/g, (_, k) => params[k] ?? `{{${k}}}`);
+}
+/**
+* Extract content of a fenced code block by language tag.
+* Returns the trimmed content between the opening and closing fences, or null.
+*/
+function extractFencedBlock(section, lang) {
+	const match = new RegExp("```" + lang + "\\n([\\s\\S]*?)```", "m").exec(section);
+	return match ? match[1]?.trim() ?? null : null;
+}
+/**
+* Parse params block content into a Record<string, string>.
+* Each line is expected to be "key: value" format.
+*/
+function parseParamsBlock(content) {
+	const result = {};
+	for (const line of content.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const colonIdx = trimmed.indexOf(":");
+		if (colonIdx === -1) continue;
+		const key = trimmed.slice(0, colonIdx).trim();
+		const val = trimmed.slice(colonIdx + 1).trim();
+		if (key) result[key] = val;
+	}
+	return result;
+}
+/**
+* Parse flat YAML key: value frontmatter (without params arrays).
+* Skips lines starting with '-' (YAML array items — not supported here).
+*/
+function parseFlatFrontmatter(block) {
+	const result = {};
+	for (const line of block.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("-")) continue;
+		const colonIdx = trimmed.indexOf(":");
+		if (colonIdx === -1) continue;
+		const key = trimmed.slice(0, colonIdx).trim();
+		const val = trimmed.slice(colonIdx + 1).trim();
+		if (key && val !== void 0) result[key] = val;
+	}
+	return result;
+}
+/**
+* Parse the `params:` YAML array block from frontmatter.
+* Handles the multi-line format:
+*   params:
+*     - name: address
+*       type: string
+*       required: true
+*     - name: hops
+*       type: number
+*       required: false
+*       default: "2"
+*
+* Returns an array of raw param objects (strings, to be validated by Zod).
+*/
+function parseFrontmatterParamsArray(block) {
+	const results = [];
+	const lines = block.split("\n");
+	let inParams = false;
+	let current = null;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		if (!inParams && /^params\s*:/.test(trimmed)) {
+			inParams = true;
+			continue;
+		}
+		if (!inParams) continue;
+		if (!line.startsWith(" ") && !line.startsWith("	") && !trimmed.startsWith("-")) break;
+		if (trimmed.startsWith("- ")) {
+			if (current !== null) results.push(current);
+			current = {};
+			const rest = trimmed.slice(2).trim();
+			if (rest) {
+				const colonIdx = rest.indexOf(":");
+				if (colonIdx !== -1) {
+					const k = rest.slice(0, colonIdx).trim();
+					const v = rest.slice(colonIdx + 1).trim().replace(/^"(.*)"$/, "$1");
+					if (k) current[k] = v;
+				}
+			}
+			continue;
+		}
+		if (current !== null) {
+			const colonIdx = trimmed.indexOf(":");
+			if (colonIdx !== -1) {
+				const k = trimmed.slice(0, colonIdx).trim();
+				const v = trimmed.slice(colonIdx + 1).trim().replace(/^"(.*)"$/, "$1");
+				if (k) current[k] = v;
+			}
+		}
+	}
+	if (current !== null) results.push(current);
+	return results;
+}
+const PlaybookParser = { 
+/**
+* Parse a playbook markdown file into a validated PlaybookDefinition.
+*
+* @param markdown - Raw markdown content of the playbook file
+* @param resolvedParams - Key-value parameters for {{param}} substitution
+* @returns Validated PlaybookDefinition (throws ZodError on invalid data)
+*/
+parse(markdown, resolvedParams) {
+	const fmMatch = /^---\n([\s\S]*?)\n---/.exec(markdown);
+	const frontmatterBlock = fmMatch ? fmMatch[1] : "";
+	const frontmatter = parseFlatFrontmatter(frontmatterBlock);
+	const params = parseFrontmatterParamsArray(frontmatterBlock).map((raw) => {
+		const coerced = {
+			name: raw["name"] ?? "",
+			type: raw["type"] ?? "string",
+			required: raw["required"] !== void 0 ? raw["required"].toLowerCase() !== "false" : true
+		};
+		if (raw["default"] !== void 0) coerced["default"] = raw["default"];
+		return ParamSpecSchema.parse(coerced);
+	});
+	const templateParams = {};
+	for (const spec of params) if (spec.default !== void 0) templateParams[spec.name] = spec.default;
+	Object.assign(templateParams, resolvedParams);
+	let body = markdown;
+	if (fmMatch) body = markdown.slice(fmMatch.index + fmMatch[0].length);
+	const steps = body.split(/^## /m).slice(1).map((section, i) => {
+		const firstNewline = section.indexOf("\n");
+		const label = firstNewline === -1 ? section.trim() : section.slice(0, firstNewline).trim();
+		const tool = applyTemplate(extractFencedBlock(section, "tool") ?? "", templateParams);
+		const rawParams = parseParamsBlock(extractFencedBlock(section, "params") ?? "");
+		const params = {};
+		for (const [k, v] of Object.entries(rawParams)) params[applyTemplate(k, templateParams)] = applyTemplate(v, templateParams);
+		return {
+			index: i + 1,
+			label,
+			tool,
+			params
+		};
+	});
+	return PlaybookSchema.parse({
+		name: frontmatter["name"] ?? "",
+		description: frontmatter["description"] ?? "",
+		version: frontmatter["version"] ?? "1.0.0",
+		params,
+		steps
+	});
+} };
+//#endregion
+export { PlaybookParser };
+
+//# sourceMappingURL=parser-DO0_SssG.mjs.map

package/dist/parser-DO0_SssG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-DO0_SssG.mjs","names":[],"sources":["../src/playbooks/schema.ts","../src/playbooks/parser.ts"],"sourcesContent":["import * as z from 'zod'\n\nexport const ParamSpecSchema = z.object({\n  name:     z.string(),\n  type:     z.enum(['string', 'number', 'boolean']).default('string'),\n  required: z.boolean().default(true),\n  default:  z.string().optional(),\n})\n\nexport const StepSchema = z.object({\n  index:  z.number().int().positive(),\n  label:  z.string(),\n  tool:   z.string().min(1),\n  params: z.record(z.string(), z.string()),\n})\n\nexport const PlaybookSchema = z.object({\n  name:        z.string().min(1),\n  description: z.string().default(''),\n  version:     z.string().default('1.0.0'),\n  params:      z.array(ParamSpecSchema).default([]),\n  steps:       z.array(StepSchema),\n})\n\nexport type PlaybookDefinition = z.infer<typeof PlaybookSchema>\nexport type StepDefinition     = z.infer<typeof StepSchema>\nexport type ParamSpec          = z.infer<typeof ParamSpecSchema>\n","import { PlaybookSchema, ParamSpecSchema, type PlaybookDefinition } from './schema.js'\n\n/**\n * Apply {{param}} template substitution to a string.\n * Missing keys are left as-is: {{missing}} remains {{missing}}.\n */\nfunction applyTemplate(text: string, params: Record<string, string>): string {\n  return text.replace(/\\{\\{(\\w+)\\}\\}/g, (_, k: string) => params[k] ?? `{{${k}}}`)\n}\n\n/**\n * Extract content of a fenced code block by language tag.\n * Returns the trimmed content between the opening and closing fences, or null.\n */\nfunction extractFencedBlock(section: string, lang: string): string | null {\n  // Match ```lang\\n...\\n``` pattern\n  const re = new RegExp('```' + lang + '\\\\n([\\\\s\\\\S]*?)```', 'm')\n  const match = re.exec(section)\n  return match ? (match[1]?.trim() ?? null) : null\n}\n\n/**\n * Parse params block content into a Record<string, string>.\n * Each line is expected to be \"key: value\" format.\n */\nfunction parseParamsBlock(content: string): Record<string, string> {\n  const result: Record<string, string> = {}\n  for (const line of content.split('\\n')) {\n    const trimmed = line.trim()\n    if (!trimmed) continue\n    const colonIdx = trimmed.indexOf(':')\n    if (colonIdx === -1) continue\n    const key = trimmed.slice(0, colonIdx).trim()\n    const val = trimmed.slice(colonIdx + 1).trim()\n    if (key) result[key] = val\n  }\n  return result\n}\n\n/**\n * Parse flat YAML key: value frontmatter (without params arrays).\n * Skips lines starting with '-' (YAML array items — not supported here).\n */\nfunction parseFlatFrontmatter(block: string): Record<string, string> {\n  const result: Record<string, string> = {}\n  for (const line of block.split('\\n')) {\n    const trimmed = line.trim()\n    if (!trimmed || trimmed.startsWith('-')) continue\n    const colonIdx = trimmed.indexOf(':')\n    if (colonIdx === -1) continue\n    const key = trimmed.slice(0, colonIdx).trim()\n    const val = trimmed.slice(colonIdx + 1).trim()\n    if (key && val !== undefined) result[key] = val\n  }\n  return result\n}\n\n/**\n * Parse the `params:` YAML array block from frontmatter.\n * Handles the multi-line format:\n *   params:\n *     - name: address\n *       type: string\n *       required: true\n *     - name: hops\n *       type: number\n *       required: false\n *       default: \"2\"\n *\n * Returns an array of raw param objects (strings, to be validated by Zod).\n */\nfunction parseFrontmatterParamsArray(block: string): Array<Record<string, string>> {\n  const results: Array<Record<string, string>> = []\n\n  // Find the params: key\n  const lines = block.split('\\n')\n  let inParams = false\n  let current: Record<string, string> | null = null\n\n  for (const line of lines) {\n    const trimmed = line.trim()\n    if (!trimmed) continue\n\n    // Check for `params:` key (may or may not have value on same line)\n    if (!inParams && /^params\\s*:/.test(trimmed)) {\n      inParams = true\n      continue\n    }\n\n    if (!inParams) continue\n\n    // Stop at a top-level key (non-indented, non-list line that contains ':')\n    // This detects keys like `name:`, `version:`, etc. at root level\n    if (!line.startsWith(' ') && !line.startsWith('\\t') && !trimmed.startsWith('-')) {\n      break\n    }\n\n    // New list item\n    if (trimmed.startsWith('- ')) {\n      if (current !== null) results.push(current)\n      current = {}\n      const rest = trimmed.slice(2).trim()\n      if (rest) {\n        const colonIdx = rest.indexOf(':')\n        if (colonIdx !== -1) {\n          const k = rest.slice(0, colonIdx).trim()\n          const v = rest.slice(colonIdx + 1).trim().replace(/^\"(.*)\"$/, '$1')\n          if (k) current[k] = v\n        }\n      }\n      continue\n    }\n\n    // Key-value within a list item\n    if (current !== null) {\n      const colonIdx = trimmed.indexOf(':')\n      if (colonIdx !== -1) {\n        const k = trimmed.slice(0, colonIdx).trim()\n        const v = trimmed.slice(colonIdx + 1).trim().replace(/^\"(.*)\"$/, '$1')\n        if (k) current[k] = v\n      }\n    }\n  }\n\n  if (current !== null) results.push(current)\n  return results\n}\n\nexport const PlaybookParser = {\n  /**\n   * Parse a playbook markdown file into a validated PlaybookDefinition.\n   *\n   * @param markdown - Raw markdown content of the playbook file\n   * @param resolvedParams - Key-value parameters for {{param}} substitution\n   * @returns Validated PlaybookDefinition (throws ZodError on invalid data)\n   */\n  parse(markdown: string, resolvedParams: Record<string, string>): PlaybookDefinition {\n    // 1. Split on first and second --- fences to extract frontmatter block\n    const fmMatch = /^---\\n([\\s\\S]*?)\\n---/.exec(markdown)\n    const frontmatterBlock = fmMatch ? fmMatch[1]! : ''\n    const frontmatter = parseFlatFrontmatter(frontmatterBlock)\n\n    // 2. Parse params spec from frontmatter YAML array before step parsing so\n    // defaults are available for {{param}} substitution.\n    const rawParamItems = parseFrontmatterParamsArray(frontmatterBlock)\n    const params = rawParamItems.map(raw => {\n      // Coerce required/default fields\n      const coerced: Record<string, unknown> = {\n        name:     raw['name'] ?? '',\n        type:     raw['type'] ?? 'string',\n        required: raw['required'] !== undefined\n          ? raw['required'].toLowerCase() !== 'false'\n          : true,\n      }\n      if (raw['default'] !== undefined) coerced['default'] = raw['default']\n      return ParamSpecSchema.parse(coerced)\n    })\n\n    const templateParams: Record<string, string> = {}\n    for (const spec of params) {\n      if (spec.default !== undefined) templateParams[spec.name] = spec.default\n    }\n    Object.assign(templateParams, resolvedParams)\n\n    // 3. Extract body (everything after closing ---)\n    let body = markdown\n    if (fmMatch) {\n      body = markdown.slice(fmMatch.index + fmMatch[0].length)\n    }\n\n    // 4. Split body on H2 sections (## heading)\n    const sections = body.split(/^## /m)\n    // First element is content before first ##, skip it\n    const stepSections = sections.slice(1)\n\n    // 5. Parse each step section\n    const steps = stepSections.map((section, i) => {\n      // First line is the label (the H2 heading content)\n      const firstNewline = section.indexOf('\\n')\n      const label = firstNewline === -1\n        ? section.trim()\n        : section.slice(0, firstNewline).trim()\n\n      // Extract tool name from ```tool block\n      const rawTool = extractFencedBlock(section, 'tool') ?? ''\n      const tool = applyTemplate(rawTool, templateParams)\n\n      // Extract params from ```params block\n      const rawParamsBlock = extractFencedBlock(section, 'params') ?? ''\n      const rawParams = parseParamsBlock(rawParamsBlock)\n\n      // Apply template substitution to all param values\n      const params: Record<string, string> = {}\n      for (const [k, v] of Object.entries(rawParams)) {\n        params[applyTemplate(k, templateParams)] = applyTemplate(v, templateParams)\n      }\n\n      return {\n        index: i + 1,\n        label,\n        tool,\n        params,\n      }\n    })\n\n    // 6. Build and validate the playbook definition\n    return PlaybookSchema.parse({\n      name:        frontmatter['name'] ?? '',\n      description: frontmatter['description'] ?? '',\n      version:     frontmatter['version'] ?? '1.0.0',\n      params,\n      steps,\n    })\n  },\n}\n"],"mappings":"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"}