markform 0.1.2 → 0.1.3

package/README.md

@@ -41,7 +41,7 @@ npx markform examples
 This walks you through an example form interactively, with optional AI agent filling.
 You’ll need at least one [API key](#supported-providers) to have LLMs fill in forms.
 
-### A Simple Form
+### A Minimal Form
 
 A `.form.md` file is simply a Markdoc file.
 It combines YAML frontmatter with Markdoc-tagged content:
@@ -50,39 +50,38 @@ It combines YAML frontmatter with Markdoc-tagged content:
 ---
 markform:
   spec: MF/0.1
-  title: Movie Research (Simple)
-  roles:              # Who can fill fields
+  title: Movie Research (Minimal)
+  description: Quick movie lookup with just the essentials (title, year, ratings, summary).
+  roles:
     - user
     - agent
-  role_instructions:  # Instructions shown to each role
+  role_instructions:
     user: "Enter the movie title."
-    agent: "Research the movie and fill in the details from IMDB."
+    agent: |
+      Quickly identify the movie and fill in basic info from IMDB.
+      This is a minimal lookup - just get the core facts.
 ---
+{% form id="movie_research_minimal" title="Movie Research (Minimal)" %}
 
-{% form id="movie_research" title="Movie Research" %}
+<!-- The first field group is filled in by the user (role="user"): -->
 
-{% field-group id="input" title="Input" %}
-
-<!-- User fills this field -->
+{% field-group id="movie_input" title="Movie Identification" %}
 
 {% string-field id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /string-field %}
-
-{% instructions ref="movie" %}
-
-<!-- Guidance for filling the field -->
-
-Enter the movie title (add any details to help identify, like "Barbie 2023" or "the Batman movie with Robert Pattinson").
-{% /instructions %}
+{% instructions ref="movie" %}Enter the movie title (add year or details for disambiguation).{% /instructions %}
 
 {% /field-group %}
 
-{% field-group id="details" title="Movie Details" %}
+<!-- Everything else is filled in by the agent (role="agent"): -->
 
-<!-- Agent researches and fills these fields -->
+{% field-group id="about_the_movie" title="About the Movie" %}
 
 {% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
+{% instructions ref="full_title" %}Official title including subtitle if any.{% /instructions %}
 
-{% number-field id="year" label="Release Year" role="agent" min=1888 max=2030 %}{% /number-field %}
+{% number-field id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /number-field %}
+
+{% url-field id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /url-field %}
 
 {% single-select id="mpaa_rating" label="MPAA Rating" role="agent" %}
 - [ ] G {% #g %}
@@ -93,21 +92,22 @@ Enter the movie title (add any details to help identify, like "Barbie 2023" or "
 - [ ] NR/Unrated {% #nr %}
 {% /single-select %}
 
-{% url-field id="imdb_url" label="IMDB URL" role="agent" %}{% /url-field %}
-
 {% number-field id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /number-field %}
+{% instructions ref="imdb_rating" %}IMDB user rating (1.0-10.0 scale).{% /instructions %}
 
-{% string-field id="logline" label="Summary" role="agent" maxLength=200 %}{% /string-field %}
+{% string-field id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /string-field %}
+{% instructions ref="logline" %}Brief plot summary in 1-2 sentences, no spoilers.{% /instructions %}
 
 {% /field-group %}
 
 {% /form %}
 ```
 
-This is a simplified version of the [full movie research
-form](https://github.com/jlevy/markform/blob/main/packages/markform/examples/movie-research/movie-research.form.md),
-which includes multiple rating sources (IMDB, Rotten Tomatoes, Metacritic), detailed
-instructions, and harness configuration.
+This is the minimal movie research form.
+See the
+[examples/](https://github.com/jlevy/markform/tree/main/packages/markform/examples)
+directory for forms with more fields, including multiple rating sources (IMDB, Rotten
+Tomatoes, Metacritic) and comprehensive analysis.
 
 **Key concepts:**
 
@@ -282,7 +282,9 @@ flowchart LR
         subgraph L4["<b>LAYER 4: TOOL API & INTERFACES</b><br/>Abstract API for agents and humans (TypeScript and AI SDK integration)"]
         end
 
-        L4 --> L3 --> L2 --> L1
+        L4 -->
+
+L3 --> L2 --> L1
     end
 
     subgraph IMPL["<b>THIS IMPLEMENTATION</b>"]

package/dist/ai-sdk.mjs

@@ -1,5 +1,5 @@
 import { N as PatchSchema } from "./coreTypes-Dful87E0.mjs";
-import { r as inspect, t as applyPatches, u as serialize } from "./apply-BfAGTHMh.mjs";
+import { r as inspect, t as applyPatches, u as serialize } from "./apply-00UmzDKL.mjs";
 import { z } from "zod";
 
 //#region src/integrations/ai-sdk.ts

package/dist/{apply-BfAGTHMh.mjs → apply-00UmzDKL.mjs}

@@ -233,6 +233,18 @@ function deriveExportPath(basePath, format) {
 	}
 	return base + EXPORT_EXTENSIONS[format];
 }
+/**
+* Derive report path from any markform file path.
+* Strips known extensions and appends .report.md.
+*/
+function deriveReportPath(basePath) {
+	let base = basePath;
+	for (const ext of Object.values(ALL_EXTENSIONS)) if (base.endsWith(ext)) {
+		base = base.slice(0, -ext.length);
+		break;
+	}
+	return base + REPORT_EXTENSION;
+}
 
 //#endregion
 //#region src/engine/serialize.ts
@@ -2467,4 +2479,4 @@ function applyPatches(form, patches) {
 }
 
 //#endregion
-export { SUGGESTED_LLMS as A, DEFAULT_ROLE_INSTRUCTIONS as C, detectFileType as D, deriveExportPath as E, formatSuggestedLlms as M, getWebSearchConfig as N, getFormsDir as O, hasWebSearchSupport as P, DEFAULT_ROLES as S, USER_ROLE as T, DEFAULT_MAX_TURNS as _, computeAllSummaries as a, DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN as b, computeStructureSummary as c, serializeRawMarkdown as d, serializeReportMarkdown as f, DEFAULT_MAX_PATCHES_PER_TURN as g, DEFAULT_MAX_ISSUES_PER_TURN as h, validate as i, WEB_SEARCH_CONFIG as j, parseRolesFlag as k, isFormComplete as l, DEFAULT_FORMS_DIR as m, getFieldsForRoles as n, computeFormState as o, AGENT_ROLE as p, inspect as r, computeProgressSummary as s, applyPatches as t, serialize as u, DEFAULT_PORT as v, REPORT_EXTENSION as w, DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN as x, DEFAULT_PRIORITY as y };
+export { parseRolesFlag as A, DEFAULT_ROLE_INSTRUCTIONS as C, deriveReportPath as D, deriveExportPath as E, hasWebSearchSupport as F, WEB_SEARCH_CONFIG as M, formatSuggestedLlms as N, detectFileType as O, getWebSearchConfig as P, DEFAULT_ROLES as S, USER_ROLE as T, DEFAULT_MAX_TURNS as _, computeAllSummaries as a, DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN as b, computeStructureSummary as c, serializeRawMarkdown as d, serializeReportMarkdown as f, DEFAULT_MAX_PATCHES_PER_TURN as g, DEFAULT_MAX_ISSUES_PER_TURN as h, validate as i, SUGGESTED_LLMS as j, getFormsDir as k, isFormComplete as l, DEFAULT_FORMS_DIR as m, getFieldsForRoles as n, computeFormState as o, AGENT_ROLE as p, inspect as r, computeProgressSummary as s, applyPatches as t, serialize as u, DEFAULT_PORT as v, REPORT_EXTENSION as w, DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN as x, DEFAULT_PRIORITY as y };

package/dist/bin.mjs

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import "./coreTypes-Dful87E0.mjs";
-import "./apply-BfAGTHMh.mjs";
-import "./src-BXRkGFpG.mjs";
+import "./apply-00UmzDKL.mjs";
+import "./src-Dm8jZ5dl.mjs";
 import "./session-Bqnwi9wp.mjs";
 import "./shared-N_s1M-_K.mjs";
-import { t as runCli } from "./cli-B3NVm6zL.mjs";
+import { t as runCli } from "./cli-D--Lel-e.mjs";
 import { resolve } from "node:path";
 import { existsSync } from "node:fs";
 import { config } from "dotenv";

package/dist/{cli-B3NVm6zL.mjs → cli-D--Lel-e.mjs}

@@ -1,6 +1,6 @@
 import { N as PatchSchema } from "./coreTypes-Dful87E0.mjs";
-import { A as SUGGESTED_LLMS, D as detectFileType, E as deriveExportPath, M as formatSuggestedLlms, O as getFormsDir, P as hasWebSearchSupport, T as USER_ROLE, _ as DEFAULT_MAX_TURNS, b as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, d as serializeRawMarkdown, f as serializeReportMarkdown, g as DEFAULT_MAX_PATCHES_PER_TURN, h as DEFAULT_MAX_ISSUES_PER_TURN, j as WEB_SEARCH_CONFIG, k as parseRolesFlag, m as DEFAULT_FORMS_DIR, p as AGENT_ROLE, r as inspect, t as applyPatches, u as serialize, v as DEFAULT_PORT, w as REPORT_EXTENSION, x as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN } from "./apply-BfAGTHMh.mjs";
-import { a as resolveHarnessConfig, c as getProviderNames, f as createMockAgent, i as runResearch, l as resolveModel, m as createHarness, s as getProviderInfo, t as VERSION, u as createLiveAgent, v as parseForm } from "./src-BXRkGFpG.mjs";
+import { A as parseRolesFlag, D as deriveReportPath, E as deriveExportPath, F as hasWebSearchSupport, M as WEB_SEARCH_CONFIG, N as formatSuggestedLlms, O as detectFileType, T as USER_ROLE, _ as DEFAULT_MAX_TURNS, b as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, d as serializeRawMarkdown, f as serializeReportMarkdown, g as DEFAULT_MAX_PATCHES_PER_TURN, h as DEFAULT_MAX_ISSUES_PER_TURN, j as SUGGESTED_LLMS, k as getFormsDir, m as DEFAULT_FORMS_DIR, p as AGENT_ROLE, r as inspect, t as applyPatches, u as serialize, v as DEFAULT_PORT, w as REPORT_EXTENSION, x as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN } from "./apply-00UmzDKL.mjs";
+import { a as resolveHarnessConfig, c as getProviderNames, f as createMockAgent, i as runResearch, l as resolveModel, m as createHarness, s as getProviderInfo, t as VERSION, u as createLiveAgent, v as parseForm } from "./src-Dm8jZ5dl.mjs";
 import { n as serializeSession } from "./session-Bqnwi9wp.mjs";
 import { a as getCommandContext, c as logInfo, d as logVerbose, f as logWarn, h as writeFile, i as formatPath, l as logSuccess, n as ensureFormsDir, o as logDryRun, p as readFile$1, r as formatOutput, s as logError, t as OUTPUT_FORMATS, u as logTiming } from "./shared-N_s1M-_K.mjs";
 import YAML from "yaml";
@@ -334,23 +334,29 @@ function toNotesArray(form) {
 * Derive export paths from a base form path.
 * Uses centralized extension constants from settings.ts.
 *
+* Standard exports: report, values (yaml), form.
+* Raw markdown is available via CLI but not in standard exports.
+*
 * @param basePath - Path to the .form.md file
 * @returns Object with paths for all export formats
 */
 function deriveExportPaths(basePath) {
 	return {
-		formPath: deriveExportPath(basePath, "form"),
-		rawPath: deriveExportPath(basePath, "raw"),
-		yamlPath: deriveExportPath(basePath, "yaml")
+		reportPath: deriveReportPath(basePath),
+		yamlPath: deriveExportPath(basePath, "yaml"),
+		formPath: deriveExportPath(basePath, "form")
 	};
 }
 /**
 * Export form to multiple formats.
 *
-* Writes:
+* Standard exports:
+* - Report format (.report.md) - filtered markdown (excludes instructions, report=false)
+* - YAML values (.yml) - structured format with state and notes
 * - Markform format (.form.md) - canonical form with directives
-* - Raw markdown (.raw.md) - plain readable markdown (no directives)
-* - YAML values (.yml) - structured format with state and notes (markform-218, markform-219)
+*
+* Note: Raw markdown (.raw.md) is available via CLI `markform export --raw`
+* but is not included in standard multi-format export.
 *
 * @param form - The parsed form to export
 * @param basePath - Base path for the .form.md file (other paths are derived)
@@ -358,10 +364,8 @@ function deriveExportPaths(basePath) {
 */
 async function exportMultiFormat(form, basePath) {
 	const paths = deriveExportPaths(basePath);
-	const formContent = serialize(form);
-	await writeFile(paths.formPath, formContent);
-	const rawContent = serializeRawMarkdown(form);
-	await writeFile(paths.rawPath, rawContent);
+	const reportContent = serializeReportMarkdown(form);
+	await writeFile(paths.reportPath, reportContent);
 	const values = toStructuredValues(form);
 	const notes = toNotesArray(form);
 	const exportData = {
@@ -370,6 +374,8 @@ async function exportMultiFormat(form, basePath) {
 	};
 	const yamlContent = YAML.stringify(exportData);
 	await writeFile(paths.yamlPath, yamlContent);
+	const formContent = serialize(form);
+	await writeFile(paths.formPath, formContent);
 	return paths;
 }
 
@@ -1380,29 +1386,42 @@ async function viewFile(filePath) {
 /**
 * Show an interactive file viewer chooser.
 *
-* Presents a list of files to view with descriptions, plus a Skip option.
-* Loops until the user selects Skip.
+* Presents a list of files to view:
+* - "Show report:" for the report output (.report.md) at the top
+* - "Show source:" for other files (.form.md, .raw.md, .yml)
+* - "Quit" at the bottom
+*
+* Loops until the user selects Quit.
 *
 * @param files Array of file options to display
 */
 async function showFileViewerChooser(files) {
 	if (!isInteractive$2()) return;
 	console.log("");
+	const reportFile = files.find((f) => f.path.endsWith(".report.md"));
+	const sourceFiles = files.filter((f) => !f.path.endsWith(".report.md"));
 	while (true) {
-		const options = [...files.map((file) => ({
+		const options = [];
+		if (reportFile) options.push({
+			value: reportFile.path,
+			label: `Show report: ${pc.green(basename(reportFile.path))}`,
+			hint: reportFile.hint ?? ""
+		});
+		for (const file of sourceFiles) options.push({
 			value: file.path,
-			label: pc.green(basename(file.path)),
+			label: `Show source: ${pc.green(basename(file.path))}`,
 			hint: file.hint ?? ""
-		})), {
-			value: "skip",
-			label: "Done viewing",
-			hint: "exit file viewer"
-		}];
+		});
+		options.push({
+			value: "quit",
+			label: "Quit",
+			hint: ""
+		});
 		const selection = await p.select({
-			message: "View an output file?",
+			message: "View files:",
 			options
 		});
-		if (p.isCancel(selection) || selection === "skip") break;
+		if (p.isCancel(selection) || selection === "quit") break;
 		await viewFile(selection);
 		console.log("");
 	}
@@ -1682,9 +1701,9 @@ async function runInteractiveFlow(preselectedId, formsDirOverride) {
 		showInteractiveOutro(patches.length, false);
 		console.log("");
 		p.log.success("Outputs:");
-		console.log(`  ${formatPath(userFillOutputs.formPath)}  ${pc.dim("(markform)")}`);
-		console.log(`  ${formatPath(userFillOutputs.rawPath)}  ${pc.dim("(plain markdown)")}`);
-		console.log(`  ${formatPath(userFillOutputs.yamlPath)}  ${pc.dim("(values as YAML)")}`);
+		console.log(`  ${formatPath(userFillOutputs.reportPath)}  ${pc.dim("(output report)")}`);
+		console.log(`  ${formatPath(userFillOutputs.yamlPath)}  ${pc.dim("(output values)")}`);
+		console.log(`  ${formatPath(userFillOutputs.formPath)}  ${pc.dim("(filled markform source)")}`);
 		logTiming({
 			verbose: false,
 			format: "console",
@@ -1710,19 +1729,19 @@ async function runInteractiveFlow(preselectedId, formsDirOverride) {
 			console.log(cliCommand);
 			if (userFillOutputs) await showFileViewerChooser([
 				{
-					path: userFillOutputs.formPath,
-					label: "Markform",
-					hint: "form with tags"
+					path: userFillOutputs.reportPath,
+					label: "Report",
+					hint: "output report"
 				},
 				{
-					path: userFillOutputs.rawPath,
-					label: "Plain Markdown",
-					hint: "rendered output"
+					path: userFillOutputs.yamlPath,
+					label: "Values",
+					hint: "output values"
 				},
 				{
-					path: userFillOutputs.yamlPath,
-					label: "YAML",
-					hint: "extracted values"
+					path: userFillOutputs.formPath,
+					label: "Form",
+					hint: "filled markform source"
 				}
 			]);
 			p.outro("Happy form filling!");
@@ -1760,29 +1779,29 @@ async function runInteractiveFlow(preselectedId, formsDirOverride) {
 				dryRun: false,
 				quiet: false
 			}, timingLabel, Date.now() - agentStartTime);
-			const { formPath, rawPath, yamlPath } = await exportMultiFormat(form, agentOutputPath);
+			const { reportPath, yamlPath, formPath } = await exportMultiFormat(form, agentOutputPath);
 			console.log("");
 			const successMessage = isResearchExample ? "Research complete. Outputs:" : "Agent fill complete. Outputs:";
 			p.log.success(successMessage);
-			console.log(`  ${formatPath(formPath)}  (markform)`);
-			console.log(`  ${formatPath(rawPath)}  (plain markdown)`);
-			console.log(`  ${formatPath(yamlPath)}  (values as YAML)`);
+			console.log(`  ${formatPath(reportPath)}  ${pc.dim("(output report)")}`);
+			console.log(`  ${formatPath(yamlPath)}  ${pc.dim("(output values)")}`);
+			console.log(`  ${formatPath(formPath)}  ${pc.dim("(filled markform source)")}`);
 			if (!success) p.log.warn("Agent did not complete all fields. You may need to run it again.");
 			await showFileViewerChooser([
 				{
-					path: formPath,
-					label: "Markform",
-					hint: "form with tags"
+					path: reportPath,
+					label: "Report",
+					hint: "output report"
 				},
 				{
-					path: rawPath,
-					label: "Plain Markdown",
-					hint: "rendered output"
+					path: yamlPath,
+					label: "Values",
+					hint: "output values"
 				},
 				{
-					path: yamlPath,
-					label: "YAML",
-					hint: "extracted values"
+					path: formPath,
+					label: "Form",
+					hint: "filled markform source"
 				}
 			]);
 		} catch (error) {
@@ -1987,13 +2006,13 @@ function registerFillCommand(program) {
 					logInfo(ctx, `[DRY RUN] Would write form to: ${outputPath$1}`);
 					showInteractiveOutro(patches.length, false);
 				} else {
-					const { formPath, rawPath, yamlPath } = await exportMultiFormat(form, outputPath$1);
+					const { reportPath, yamlPath, formPath } = await exportMultiFormat(form, outputPath$1);
 					showInteractiveOutro(patches.length, false);
 					console.log("");
 					p.log.success("Outputs:");
-					console.log(`  ${formatPath(formPath)}  ${pc.dim("(markform)")}`);
-					console.log(`  ${formatPath(rawPath)}  ${pc.dim("(plain markdown)")}`);
-					console.log(`  ${formatPath(yamlPath)}  ${pc.dim("(values as YAML)")}`);
+					console.log(`  ${formatPath(reportPath)}  ${pc.dim("(output report)")}`);
+					console.log(`  ${formatPath(yamlPath)}  ${pc.dim("(output values)")}`);
+					console.log(`  ${formatPath(formPath)}  ${pc.dim("(filled markform source)")}`);
 				}
 				logTiming(ctx, "Fill time", durationMs$1);
 				if (patches.length > 0) {
@@ -3721,11 +3740,11 @@ function registerResearchCommand(program) {
 			logInfo(ctx, `Status: ${(result.status === "completed" ? pc.green : result.status === "max_turns_reached" ? pc.yellow : pc.red)(result.status)}`);
 			logInfo(ctx, `Turns: ${result.totalTurns}`);
 			if (result.inputTokens || result.outputTokens) logVerbose(ctx, `Tokens: ${result.inputTokens ?? 0} in, ${result.outputTokens ?? 0} out`);
-			const { formPath, rawPath, yamlPath } = await exportMultiFormat(result.form, outputPath);
+			const { reportPath, yamlPath, formPath } = await exportMultiFormat(result.form, outputPath);
 			logSuccess(ctx, "Outputs:");
-			console.log(`  ${formPath}  ${pc.dim("(markform)")}`);
-			console.log(`  ${rawPath}  ${pc.dim("(plain markdown)")}`);
-			console.log(`  ${yamlPath}  ${pc.dim("(values as YAML)")}`);
+			console.log(`  ${reportPath}  ${pc.dim("(output report)")}`);
+			console.log(`  ${yamlPath}  ${pc.dim("(output values)")}`);
+			console.log(`  ${formPath}  ${pc.dim("(filled markform source)")}`);
 			if (options.transcript && result.transcript) {
 				const { serializeSession: serializeSession$1 } = await import("./session-DdAtY2Ni.mjs");
 				const transcriptPath = outputPath.replace(/\.form\.md$/, ".session.yaml");

package/dist/cli.mjs

@@ -1,8 +1,8 @@
 import "./coreTypes-Dful87E0.mjs";
-import "./apply-BfAGTHMh.mjs";
-import "./src-BXRkGFpG.mjs";
+import "./apply-00UmzDKL.mjs";
+import "./src-Dm8jZ5dl.mjs";
 import "./session-Bqnwi9wp.mjs";
 import "./shared-N_s1M-_K.mjs";
-import { t as runCli } from "./cli-B3NVm6zL.mjs";
+import { t as runCli } from "./cli-D--Lel-e.mjs";
 
 export { runCli };

package/dist/index.d.mts

@@ -593,12 +593,12 @@ interface ResearchResult {
   outputTokens?: number;
   /** Tools available to the agent */
   availableTools?: string[];
-  /** Path to saved .form.md file */
-  formPath?: string;
-  /** Path to saved .raw.md file */
-  rawPath?: string;
+  /** Path to saved .report.md file */
+  reportPath?: string;
   /** Path to saved .yaml file */
   yamlPath?: string;
+  /** Path to saved .form.md file */
+  formPath?: string;
 }
 //#endregion
 //#region src/research/runResearch.d.ts

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { $ as StringFieldSchema, A as NumberValueSchema, B as SetCheckboxesPatchSchema, C as IssueReasonSchema, D as MultiSelectFieldSchema, E as MultiCheckboxStateSchema, F as ProgressStateSchema, G as SetStringPatchSchema, H as SetNumberPatchSchema, I as ProgressSummarySchema, J as SingleSelectFieldSchema, K as SeveritySchema, L as SessionFinalSchema, M as OptionSchema, N as PatchSchema, O as MultiSelectValueSchema, P as ProgressCountsSchema, Q as StepResultSchema, R as SessionTranscriptSchema, S as InspectResultSchema, T as MarkformFrontmatterSchema, U as SetSingleSelectPatchSchema, V as SetMultiSelectPatchSchema, W as SetStringListPatchSchema, X as SourcePositionSchema, Y as SingleSelectValueSchema, Z as SourceRangeSchema, _ as FieldValueSchema, a as CheckboxValueSchema, at as ValidatorRefSchema, b as IdSchema, c as ClearFieldPatchSchema, d as ExplicitCheckboxValueSchema, et as StringListFieldSchema, f as FieldGroupSchema, g as FieldSchema, h as FieldResponseSchema, i as CheckboxProgressCountsSchema, it as ValidationIssueSchema, j as OptionIdSchema, k as NumberFieldSchema, l as DocumentationBlockSchema, m as FieldProgressSchema, n as ApplyResultSchema, nt as StringValueSchema, o as CheckboxesFieldSchema, p as FieldKindSchema, q as SimpleCheckboxStateSchema, r as CheckboxModeSchema, rt as StructureSummarySchema, s as CheckboxesValueSchema, t as AnswerStateSchema, tt as StringListValueSchema, u as DocumentationTagSchema, v as FormSchemaSchema, w as IssueScopeSchema, x as InspectIssueSchema, y as HarnessConfigSchema, z as SessionTurnSchema } from "./coreTypes-Dful87E0.mjs";
-import { a as computeAllSummaries, c as computeStructureSummary, i as validate, l as isFormComplete, o as computeFormState, r as inspect, s as computeProgressSummary, t as applyPatches, u as serialize } from "./apply-BfAGTHMh.mjs";
-import { _ as findFieldById, a as resolveHarnessConfig, d as MockAgent, f as createMockAgent, g as coerceToFieldPatch, h as coerceInputContext, i as runResearch, m as createHarness, n as isResearchForm, o as fillForm, p as FormHarness, r as validateResearchForm, t as VERSION, v as parseForm, y as ParseError } from "./src-BXRkGFpG.mjs";
+import { a as computeAllSummaries, c as computeStructureSummary, i as validate, l as isFormComplete, o as computeFormState, r as inspect, s as computeProgressSummary, t as applyPatches, u as serialize } from "./apply-00UmzDKL.mjs";
+import { _ as findFieldById, a as resolveHarnessConfig, d as MockAgent, f as createMockAgent, g as coerceToFieldPatch, h as coerceInputContext, i as runResearch, m as createHarness, n as isResearchForm, o as fillForm, p as FormHarness, r as validateResearchForm, t as VERSION, v as parseForm, y as ParseError } from "./src-Dm8jZ5dl.mjs";
 import { n as serializeSession, t as parseSession } from "./session-Bqnwi9wp.mjs";
 
 export { AnswerStateSchema, ApplyResultSchema, CheckboxModeSchema, CheckboxProgressCountsSchema, CheckboxValueSchema, CheckboxesFieldSchema, CheckboxesValueSchema, ClearFieldPatchSchema, DocumentationBlockSchema, DocumentationTagSchema, ExplicitCheckboxValueSchema, FieldGroupSchema, FieldKindSchema, FieldProgressSchema, FieldResponseSchema, FieldSchema, FieldValueSchema, FormHarness, FormSchemaSchema, HarnessConfigSchema, IdSchema, InspectIssueSchema, InspectResultSchema, IssueReasonSchema, IssueScopeSchema, MarkformFrontmatterSchema, MockAgent, MultiCheckboxStateSchema, MultiSelectFieldSchema, MultiSelectValueSchema, NumberFieldSchema, NumberValueSchema, OptionIdSchema, OptionSchema, ParseError, PatchSchema, ProgressCountsSchema, ProgressStateSchema, ProgressSummarySchema, SessionFinalSchema, SessionTranscriptSchema, SessionTurnSchema, SetCheckboxesPatchSchema, SetMultiSelectPatchSchema, SetNumberPatchSchema, SetSingleSelectPatchSchema, SetStringListPatchSchema, SetStringPatchSchema, SeveritySchema, SimpleCheckboxStateSchema, SingleSelectFieldSchema, SingleSelectValueSchema, SourcePositionSchema, SourceRangeSchema, StepResultSchema, StringFieldSchema, StringListFieldSchema, StringListValueSchema, StringValueSchema, StructureSummarySchema, VERSION, ValidationIssueSchema, ValidatorRefSchema, applyPatches, coerceInputContext, coerceToFieldPatch, computeAllSummaries, computeFormState, computeProgressSummary, computeStructureSummary, createHarness, createMockAgent, fillForm, findFieldById, inspect, isFormComplete, isResearchForm, parseForm, parseSession, resolveHarnessConfig, runResearch, serialize, serializeSession, validate, validateResearchForm };

package/dist/{src-BXRkGFpG.mjs → src-Dm8jZ5dl.mjs}

@@ -1,5 +1,5 @@
 import { N as PatchSchema } from "./coreTypes-Dful87E0.mjs";
-import { C as DEFAULT_ROLE_INSTRUCTIONS, N as getWebSearchConfig, S as DEFAULT_ROLES, _ as DEFAULT_MAX_TURNS, b as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, g as DEFAULT_MAX_PATCHES_PER_TURN, h as DEFAULT_MAX_ISSUES_PER_TURN, n as getFieldsForRoles, p as AGENT_ROLE, r as inspect, t as applyPatches, u as serialize, x as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN, y as DEFAULT_PRIORITY } from "./apply-BfAGTHMh.mjs";
+import { C as DEFAULT_ROLE_INSTRUCTIONS, P as getWebSearchConfig, S as DEFAULT_ROLES, _ as DEFAULT_MAX_TURNS, b as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, g as DEFAULT_MAX_PATCHES_PER_TURN, h as DEFAULT_MAX_ISSUES_PER_TURN, n as getFieldsForRoles, p as AGENT_ROLE, r as inspect, t as applyPatches, u as serialize, x as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN, y as DEFAULT_PRIORITY } from "./apply-00UmzDKL.mjs";
 import { z } from "zod";
 import Markdoc from "@markdoc/markdoc";
 import YAML from "yaml";

package/examples/movie-research/movie-research-minimal.form.md

@@ -2,7 +2,7 @@
 markform:
   spec: MF/0.1
   title: Movie Research (Minimal)
-  description: Quick movie lookup - just the essentials (title, year, rating, summary).
+  description: Quick movie lookup with just the essentials (title, year, ratings, summary).
   roles:
     - user
     - agent
@@ -11,62 +11,43 @@ markform:
     agent: |
       Quickly identify the movie and fill in basic info from IMDB.
       This is a minimal lookup - just get the core facts.
-  harness_config:
-    max_issues_per_turn: 3
-    max_patches_per_turn: 8
 ---
-
 {% form id="movie_research_minimal" title="Movie Research (Minimal)" %}
 
-{% description ref="movie_research_minimal" %}
-A quick movie lookup for essential info: title, year, rating, and a brief summary.
-{% /description %}
+<!-- The first field group is filled in by the user (role="user"): -->
 
 {% field-group id="movie_input" title="Movie Identification" %}
 
 {% string-field id="movie" label="Movie" role="user" required=true minLength=1 maxLength=300 %}{% /string-field %}
-
-{% instructions ref="movie" %}
-Enter the movie title (add year or details if needed for disambiguation).
-{% /instructions %}
+{% instructions ref="movie" %}Enter the movie title (add year or details for disambiguation).{% /instructions %}
 
 {% /field-group %}
 
-{% field-group id="title_identification" title="Title Identification" %}
+<!-- Everything else is filled in by the agent (role="agent"): -->
 
-{% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
+{% field-group id="about_the_movie" title="About the Movie" %}
 
-{% instructions ref="full_title" %}
-Official title including subtitle if any.
-{% /instructions %}
+{% string-field id="full_title" label="Full Title" role="agent" required=true %}{% /string-field %}
+{% instructions ref="full_title" %}Official title including subtitle if any.{% /instructions %}
 
 {% number-field id="year" label="Release Year" role="agent" required=true min=1888 max=2030 %}{% /number-field %}
 
-{% /field-group %}
-
-{% field-group id="primary_sources" title="Source" %}
-
 {% url-field id="imdb_url" label="IMDB URL" role="agent" required=true %}{% /url-field %}
 
-{% /field-group %}
-
-{% field-group id="ratings" title="Rating" %}
+{% single-select id="mpaa_rating" label="MPAA Rating" role="agent" %}
+- [ ] G {% #g %}
+- [ ] PG {% #pg %}
+- [ ] PG-13 {% #pg_13 %}
+- [ ] R {% #r %}
+- [ ] NC-17 {% #nc_17 %}
+- [ ] NR/Unrated {% #nr %}
+{% /single-select %}
 
 {% number-field id="imdb_rating" label="IMDB Rating" role="agent" min=1.0 max=10.0 %}{% /number-field %}
-
-{% instructions ref="imdb_rating" %}
-IMDB user rating (1.0-10.0 scale).
-{% /instructions %}
-
-{% /field-group %}
-
-{% field-group id="summary" title="Summary" %}
+{% instructions ref="imdb_rating" %}IMDB user rating (1.0-10.0 scale).{% /instructions %}
 
 {% string-field id="logline" label="One-Line Summary" role="agent" maxLength=300 %}{% /string-field %}
-
-{% instructions ref="logline" %}
-Brief plot summary in 1-2 sentences, no spoilers.
-{% /instructions %}
+{% instructions ref="logline" %}Brief plot summary in 1-2 sentences, no spoilers.{% /instructions %}
 
 {% /field-group %}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Markdown forms for token-friendly workflows",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",
@@ -62,6 +62,7 @@
     "@ai-sdk/xai": "^3.0.1",
     "@clack/prompts": "^0.9.0",
     "@markdoc/markdoc": "^0.5.0",
+    "ai": "^6.0.0",
     "atomically": "^2.0.0",
     "commander": "^13.0.0",
     "dotenv": "^17.2.3",
@@ -71,19 +72,10 @@
     "yaml": "^2.7.0",
     "zod": "^3.24.0"
   },
-  "peerDependencies": {
-    "ai": "^6.0.0"
-  },
-  "peerDependenciesMeta": {
-    "ai": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.1",
     "@types/node": "^24.0.0",
     "@vitest/coverage-v8": "^3.2.4",
-    "ai": "^6.0.3",
     "publint": "^0.3.0",
     "tsdown": "^0.16.0",
     "typescript": "^5.0.0",