markform 0.1.22 → 0.1.24

package/dist/{src-CbRnGzMK.mjs → src-C5OWf1dL.mjs}

@@ -1,6 +1,6 @@
 
-import { A as MarkformSectionInputSchema, R as PatchSchema, mt as StructureSummarySchema, z as ProgressCountsSchema } from "./coreTypes-CTLr-NGd.mjs";
-import { B as DEFAULT_ROLES, C as getNumberAttr, D as isTagNode, E as getValidateAttr, F as DEFAULT_MAX_TURNS, L as DEFAULT_PRIORITY, M as DEFAULT_MAX_PARALLEL_AGENTS, N as DEFAULT_MAX_PATCHES_PER_TURN, O as parseOptionText, P as DEFAULT_MAX_STEPS_PER_TURN, R as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, S as getBooleanAttr, T as getStringAttr, V as DEFAULT_ROLE_INSTRUCTIONS, Z as transformHarnessConfigToTs, _ as tryParseSentinelResponse, at as MarkformConfigError, b as extractOptionItems, bt as wrapApiError, c as computeProgressSummary, ct as MarkformParseError, d as serializeForm, h as preprocessCommentSyntax, i as inspect, j as DEFAULT_MAX_ISSUES_PER_TURN, k as AGENT_ROLE, l as computeStructureSummary, m as detectSyntaxStyle, r as getFieldsForRoles, t as applyPatches, tt as getWebSearchConfig, v as CHECKBOX_MARKERS, w as getStringArrayAttr, x as extractTableContent, y as extractFenceValue, z as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN } from "./apply-C7mO7VkZ.mjs";
+import { A as MarkformSectionInputSchema, B as ProgressCountsSchema, R as PatchSchema, ht as StructureSummarySchema, z as PatchWarningSchema } from "./coreTypes-CctFK6uE.mjs";
+import { $ as DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN, A as tryParseSentinelResponse, B as isTagNode, D as detectSyntaxStyle, F as getBooleanAttr, G as DEFAULT_MAX_PARALLEL_AGENTS, H as AGENT_ROLE, I as getNumberAttr, J as DEFAULT_MAX_STEPS_PER_TURN, K as DEFAULT_MAX_PATCHES_PER_TURN, L as getStringArrayAttr, M as extractFenceValue, N as extractOptionItems, O as preprocessCommentSyntax, P as extractTableContent, Pt as wrapApiError, Q as DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN, R as getStringAttr, S as computeStructureSummary, St as MarkformParseError, V as parseOptionText, W as DEFAULT_MAX_ISSUES_PER_TURN, Y as DEFAULT_MAX_TURNS, Z as DEFAULT_PRIORITY, _ as inspect, a as WEB_SEARCH_INSTRUCTIONS, c as filterIssuesByOrder, d as coerceInputContext, dt as transformHarnessConfigToTs, et as DEFAULT_ROLES, g as getFieldsForRoles, ht as getWebSearchConfig, i as SECTION_HEADERS, j as CHECKBOX_MARKERS, l as filterIssuesByScope, m as applyPatches, n as GENERAL_INSTRUCTIONS, o as getIssuesIntro, q as DEFAULT_MAX_RETRIES, r as ISSUES_HEADER, s as getPatchFormatHint, t as DEFAULT_SYSTEM_PROMPT, tt as DEFAULT_ROLE_INSTRUCTIONS, w as serializeForm, x as computeProgressSummary, yt as MarkformConfigError, z as getValidateAttr } from "./prompts-BCnYaH4_.mjs";
 import { z } from "zod";
 import Markdoc from "@markdoc/markdoc";
 import YAML from "yaml";
@@ -2154,549 +2154,6 @@ function getFieldId(ref) {
 	return ref.fieldId;
 }
 
-//#endregion
-//#region src/engine/valueCoercion.ts
-/**
-* Find a field by ID.
-*
-* Uses idIndex for O(1) validation that the ID exists and is a field,
-* then retrieves the Field object from the schema.
-*/
-function findFieldById(form, fieldId) {
-	if (form.idIndex.get(fieldId)?.nodeType !== "field") return;
-	for (const group of form.schema.groups) for (const field of group.children) if (field.id === fieldId) return field;
-}
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isStringArray(value) {
-	return Array.isArray(value) && value.every((item) => typeof item === "string");
-}
-function coerceToString(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_string",
-			fieldId,
-			value: null
-		}
-	};
-	if (typeof rawValue === "string") return {
-		ok: true,
-		patch: {
-			op: "set_string",
-			fieldId,
-			value: rawValue
-		}
-	};
-	if (typeof rawValue === "number") return {
-		ok: true,
-		patch: {
-			op: "set_string",
-			fieldId,
-			value: String(rawValue)
-		},
-		warning: `Coerced number ${rawValue} to string for field '${fieldId}'`
-	};
-	if (typeof rawValue === "boolean") return {
-		ok: true,
-		patch: {
-			op: "set_string",
-			fieldId,
-			value: String(rawValue)
-		},
-		warning: `Coerced boolean ${rawValue} to string for field '${fieldId}'`
-	};
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to string for field '${fieldId}'`
-	};
-}
-function coerceToNumber(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_number",
-			fieldId,
-			value: null
-		}
-	};
-	if (typeof rawValue === "number") return {
-		ok: true,
-		patch: {
-			op: "set_number",
-			fieldId,
-			value: rawValue
-		}
-	};
-	if (typeof rawValue === "string") {
-		const parsed = Number(rawValue);
-		if (!Number.isNaN(parsed)) return {
-			ok: true,
-			patch: {
-				op: "set_number",
-				fieldId,
-				value: parsed
-			},
-			warning: `Coerced string '${rawValue}' to number for field '${fieldId}'`
-		};
-		return {
-			ok: false,
-			error: `Cannot coerce non-numeric string '${rawValue}' to number for field '${fieldId}'`
-		};
-	}
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to number for field '${fieldId}'`
-	};
-}
-function coerceToStringList(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_string_list",
-			fieldId,
-			value: []
-		}
-	};
-	if (isStringArray(rawValue)) return {
-		ok: true,
-		patch: {
-			op: "set_string_list",
-			fieldId,
-			value: rawValue
-		}
-	};
-	if (typeof rawValue === "string") return {
-		ok: true,
-		patch: {
-			op: "set_string_list",
-			fieldId,
-			value: [rawValue]
-		},
-		warning: `Coerced single string to array for field '${fieldId}'`
-	};
-	if (Array.isArray(rawValue)) {
-		const items = [];
-		for (const item of rawValue) if (typeof item === "string") items.push(item);
-		else if (typeof item === "number" || typeof item === "boolean") items.push(String(item));
-		else return {
-			ok: false,
-			error: `Cannot coerce array with non-string items to string_list for field '${fieldId}'`
-		};
-		return {
-			ok: true,
-			patch: {
-				op: "set_string_list",
-				fieldId,
-				value: items
-			},
-			warning: `Coerced array items to strings for field '${fieldId}'`
-		};
-	}
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to string_list for field '${fieldId}'`
-	};
-}
-function coerceToSingleSelect(field, rawValue) {
-	if (field.kind !== "single_select") return {
-		ok: false,
-		error: `Field '${field.id}' is not a single_select field`
-	};
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_single_select",
-			fieldId: field.id,
-			value: null
-		}
-	};
-	if (typeof rawValue !== "string") return {
-		ok: false,
-		error: `single_select field '${field.id}' requires a string option ID, got ${typeof rawValue}`
-	};
-	const validOptions = new Set(field.options.map((o) => o.id));
-	if (!validOptions.has(rawValue)) return {
-		ok: false,
-		error: `Invalid option '${rawValue}' for single_select field '${field.id}'. Valid options: ${Array.from(validOptions).join(", ")}`
-	};
-	return {
-		ok: true,
-		patch: {
-			op: "set_single_select",
-			fieldId: field.id,
-			value: rawValue
-		}
-	};
-}
-function coerceToMultiSelect(field, rawValue) {
-	if (field.kind !== "multi_select") return {
-		ok: false,
-		error: `Field '${field.id}' is not a multi_select field`
-	};
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_multi_select",
-			fieldId: field.id,
-			value: []
-		}
-	};
-	const validOptions = new Set(field.options.map((o) => o.id));
-	let selected;
-	let warning;
-	if (typeof rawValue === "string") {
-		selected = [rawValue];
-		warning = `Coerced single string to array for multi_select field '${field.id}'`;
-	} else if (isStringArray(rawValue)) selected = rawValue;
-	else return {
-		ok: false,
-		error: `multi_select field '${field.id}' requires a string or string array, got ${typeof rawValue}`
-	};
-	for (const optId of selected) if (!validOptions.has(optId)) return {
-		ok: false,
-		error: `Invalid option '${optId}' for multi_select field '${field.id}'. Valid options: ${Array.from(validOptions).join(", ")}`
-	};
-	const patch = {
-		op: "set_multi_select",
-		fieldId: field.id,
-		value: selected
-	};
-	return warning ? {
-		ok: true,
-		patch,
-		warning
-	} : {
-		ok: true,
-		patch
-	};
-}
-function coerceToCheckboxes(field, rawValue) {
-	if (field.kind !== "checkboxes") return {
-		ok: false,
-		error: `Field '${field.id}' is not a checkboxes field`
-	};
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_checkboxes",
-			fieldId: field.id,
-			value: {}
-		}
-	};
-	const validOptions = new Set(field.options.map((o) => o.id));
-	const checkboxMode = field.checkboxMode;
-	if (Array.isArray(rawValue)) {
-		const defaultState = checkboxMode === "explicit" ? "yes" : "done";
-		const values = {};
-		for (const item of rawValue) {
-			if (typeof item !== "string") return {
-				ok: false,
-				error: `Array items for checkboxes field '${field.id}' must be strings (option IDs), got ${typeof item}`
-			};
-			if (!validOptions.has(item)) return {
-				ok: false,
-				error: `Invalid option '${item}' for checkboxes field '${field.id}'. Valid options: ${Array.from(validOptions).join(", ")}`
-			};
-			values[item] = defaultState;
-		}
-		const patch = {
-			op: "set_checkboxes",
-			fieldId: field.id,
-			value: values
-		};
-		if (rawValue.length === 0) return {
-			ok: true,
-			patch
-		};
-		return {
-			ok: true,
-			patch,
-			warning: `Coerced array to checkboxes object with '${defaultState}' state for field '${field.id}'`
-		};
-	}
-	if (!isPlainObject(rawValue)) return {
-		ok: false,
-		error: `checkboxes field '${field.id}' requires a Record<string, CheckboxValue> or array of option IDs, got ${typeof rawValue}`
-	};
-	const values = {};
-	let hadBooleanCoercion = false;
-	const validValues = new Set(checkboxMode === "explicit" ? [
-		"unfilled",
-		"yes",
-		"no"
-	] : checkboxMode === "simple" ? ["todo", "done"] : [
-		"todo",
-		"done",
-		"incomplete",
-		"active",
-		"na"
-	]);
-	for (const [optId, value] of Object.entries(rawValue)) {
-		if (!validOptions.has(optId)) return {
-			ok: false,
-			error: `Invalid option '${optId}' for checkboxes field '${field.id}'. Valid options: ${Array.from(validOptions).join(", ")}`
-		};
-		if (typeof value === "boolean") {
-			hadBooleanCoercion = true;
-			if (checkboxMode === "explicit") values[optId] = value ? "yes" : "no";
-			else values[optId] = value ? "done" : "todo";
-			continue;
-		}
-		if (typeof value !== "string" || !validValues.has(value)) return {
-			ok: false,
-			error: `Invalid checkbox value '${String(value)}' for option '${optId}' in field '${field.id}'. Valid values for ${checkboxMode} mode: ${Array.from(validValues).join(", ")} (or use true/false)`
-		};
-		values[optId] = value;
-	}
-	const patch = {
-		op: "set_checkboxes",
-		fieldId: field.id,
-		value: values
-	};
-	if (hadBooleanCoercion) return {
-		ok: true,
-		patch,
-		warning: `Coerced boolean values to checkbox strings for field '${field.id}'`
-	};
-	return {
-		ok: true,
-		patch
-	};
-}
-function coerceToUrl(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_url",
-			fieldId,
-			value: null
-		}
-	};
-	if (typeof rawValue === "string") return {
-		ok: true,
-		patch: {
-			op: "set_url",
-			fieldId,
-			value: rawValue
-		}
-	};
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to url for field '${fieldId}'`
-	};
-}
-function coerceToUrlList(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_url_list",
-			fieldId,
-			value: []
-		}
-	};
-	if (isStringArray(rawValue)) return {
-		ok: true,
-		patch: {
-			op: "set_url_list",
-			fieldId,
-			value: rawValue
-		}
-	};
-	if (typeof rawValue === "string") return {
-		ok: true,
-		patch: {
-			op: "set_url_list",
-			fieldId,
-			value: [rawValue]
-		},
-		warning: `Coerced single string to array for field '${fieldId}'`
-	};
-	if (Array.isArray(rawValue)) {
-		const items = [];
-		for (const item of rawValue) if (typeof item === "string") items.push(item);
-		else return {
-			ok: false,
-			error: `Cannot coerce array with non-string items to url_list for field '${fieldId}'`
-		};
-		return {
-			ok: true,
-			patch: {
-				op: "set_url_list",
-				fieldId,
-				value: items
-			}
-		};
-	}
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to url_list for field '${fieldId}'`
-	};
-}
-function coerceToDate(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_date",
-			fieldId,
-			value: null
-		}
-	};
-	if (typeof rawValue === "string") return {
-		ok: true,
-		patch: {
-			op: "set_date",
-			fieldId,
-			value: rawValue
-		}
-	};
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to date for field '${fieldId}'`
-	};
-}
-function coerceToYear(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_year",
-			fieldId,
-			value: null
-		}
-	};
-	if (typeof rawValue === "number") {
-		if (!Number.isInteger(rawValue)) return {
-			ok: false,
-			error: `Year must be an integer for field '${fieldId}', got ${rawValue}`
-		};
-		return {
-			ok: true,
-			patch: {
-				op: "set_year",
-				fieldId,
-				value: rawValue
-			}
-		};
-	}
-	if (typeof rawValue === "string") {
-		const parsed = Number.parseInt(rawValue, 10);
-		if (Number.isNaN(parsed)) return {
-			ok: false,
-			error: `Cannot coerce non-numeric string '${rawValue}' to year for field '${fieldId}'`
-		};
-		return {
-			ok: true,
-			patch: {
-				op: "set_year",
-				fieldId,
-				value: parsed
-			},
-			warning: `Coerced string '${rawValue}' to year for field '${fieldId}'`
-		};
-	}
-	return {
-		ok: false,
-		error: `Cannot coerce ${typeof rawValue} to year for field '${fieldId}'`
-	};
-}
-/**
-* Coerce raw value to SetTablePatch.
-* Accepts:
-* - Array of row objects: [{ col1: value1, col2: value2 }, ...]
-* - Empty array: [] (valid for optional tables or minRows=0)
-*/
-function coerceToTable(fieldId, rawValue) {
-	if (rawValue === null) return {
-		ok: true,
-		patch: {
-			op: "set_table",
-			fieldId,
-			value: []
-		}
-	};
-	if (!Array.isArray(rawValue)) return {
-		ok: false,
-		error: `Table value for field '${fieldId}' must be an array of rows, got ${typeof rawValue}`
-	};
-	if (rawValue.length === 0) return {
-		ok: true,
-		patch: {
-			op: "set_table",
-			fieldId,
-			value: []
-		}
-	};
-	const rows = [];
-	for (let i = 0; i < rawValue.length; i++) {
-		const row = rawValue[i];
-		if (typeof row !== "object" || row === null || Array.isArray(row)) return {
-			ok: false,
-			error: `Row ${i} for table field '${fieldId}' must be an object, got ${Array.isArray(row) ? "array" : typeof row}`
-		};
-		rows.push(row);
-	}
-	return {
-		ok: true,
-		patch: {
-			op: "set_table",
-			fieldId,
-			value: rows
-		}
-	};
-}
-/**
-* Coerce a raw value to a Patch for a specific field.
-*/
-function coerceToFieldPatch(form, fieldId, rawValue) {
-	const field = findFieldById(form, fieldId);
-	if (!field) return {
-		ok: false,
-		error: `Field '${fieldId}' not found`
-	};
-	switch (field.kind) {
-		case "string": return coerceToString(fieldId, rawValue);
-		case "number": return coerceToNumber(fieldId, rawValue);
-		case "string_list": return coerceToStringList(fieldId, rawValue);
-		case "single_select": return coerceToSingleSelect(field, rawValue);
-		case "multi_select": return coerceToMultiSelect(field, rawValue);
-		case "checkboxes": return coerceToCheckboxes(field, rawValue);
-		case "url": return coerceToUrl(fieldId, rawValue);
-		case "url_list": return coerceToUrlList(fieldId, rawValue);
-		case "date": return coerceToDate(fieldId, rawValue);
-		case "year": return coerceToYear(fieldId, rawValue);
-		case "table": return coerceToTable(fieldId, rawValue);
-		default: {
-			const _exhaustive = field;
-			throw new Error(`Unhandled field kind: ${_exhaustive.kind}`);
-		}
-	}
-}
-/**
-* Coerce an entire InputContext to patches.
-*
-* Returns patches for valid entries, collects warnings for coercions,
-* and errors for invalid entries.
-*/
-function coerceInputContext(form, inputContext) {
-	const patches = [];
-	const warnings = [];
-	const errors = [];
-	for (const [fieldId, rawValue] of Object.entries(inputContext)) {
-		if (rawValue === null) continue;
-		const result = coerceToFieldPatch(form, fieldId, rawValue);
-		if (result.ok) {
-			patches.push(result.patch);
-			if ("warning" in result && result.warning) warnings.push(result.warning);
-		} else errors.push(result.error);
-	}
-	return {
-		patches,
-		warnings,
-		errors
-	};
-}
-
 //#endregion
 //#region src/harness/harness.ts
 /**
@@ -2818,6 +2275,7 @@ var FormHarness = class {
 		const stepResult = this.computeStepResult(result);
 		stepResult.patchesApplied = patchesActuallyApplied;
 		stepResult.rejectedPatches = applyResult.rejectedPatches;
+		stepResult.coercionWarnings = applyResult.warnings;
 		this.recordTurn(issues, patches, result, llmStats, context, applyResult.rejectedPatches, applyResult.warnings, wire);
 		if (stepResult.issues.length === 0 || this.turnNumber >= this.config.maxTurns) this.state = "complete";
 		else this.state = "wait";
@@ -2828,8 +2286,7 @@ var FormHarness = class {
 	* Applies issue filtering and computes step budget.
 	*/
 	computeStepResult(result) {
-		const orderFiltered = this.filterIssuesByOrder(result.issues);
-		const limitedIssues = this.filterIssuesByScope(orderFiltered).slice(0, this.config.maxIssuesPerTurn);
+		const limitedIssues = filterIssuesByScope(filterIssuesByOrder(result.issues, this.form), this.form, this.config.maxFieldsPerTurn, this.config.maxGroupsPerTurn).slice(0, this.config.maxIssuesPerTurn);
 		const stepBudget = Math.min(this.config.maxPatchesPerTurn, limitedIssues.length);
 		return {
 			structureSummary: result.structureSummary,
@@ -2885,91 +2342,6 @@ var FormHarness = class {
 		return sha256(serializeForm(this.form));
 	}
 	/**
-	* Filter issues based on maxFieldsPerTurn and maxGroupsPerTurn limits.
-	*
-	* Issues are processed in priority order. An issue is included if:
-	* - Adding it doesn't exceed the field limit (for field/option scoped issues)
-	* - Adding it doesn't exceed the group limit
-	*
-	* Form-level issues are always included.
-	*/
-	filterIssuesByScope(issues) {
-		const maxFields = this.config.maxFieldsPerTurn;
-		const maxGroups = this.config.maxGroupsPerTurn;
-		if (maxFields === void 0 && maxGroups === void 0) return issues;
-		const result = [];
-		const seenFields = /* @__PURE__ */ new Set();
-		const seenGroups = /* @__PURE__ */ new Set();
-		for (const issue of issues) {
-			if (issue.scope === "form") {
-				result.push(issue);
-				continue;
-			}
-			const fieldId = this.getFieldIdFromRef(issue.ref, issue.scope);
-			const groupId = fieldId ? this.getGroupForField(fieldId) : void 0;
-			if (maxFields !== void 0 && fieldId) {
-				if (!seenFields.has(fieldId) && seenFields.size >= maxFields) continue;
-			}
-			if (maxGroups !== void 0 && groupId) {
-				if (!seenGroups.has(groupId) && seenGroups.size >= maxGroups) continue;
-			}
-			result.push(issue);
-			if (fieldId) seenFields.add(fieldId);
-			if (groupId) seenGroups.add(groupId);
-		}
-		return result;
-	}
-	/**
-	* Filter issues by order level.
-	*
-	* Only includes issues for fields at the current (lowest incomplete) order level.
-	* Fields at higher order levels are deferred until all lower-order fields are complete.
-	* If no order attributes are used, all issues pass through (all at order 0).
-	*/
-	filterIssuesByOrder(issues) {
-		const fieldOrderMap = /* @__PURE__ */ new Map();
-		for (const group of this.form.schema.groups) {
-			const groupOrder = group.order ?? 0;
-			for (const field of group.children) fieldOrderMap.set(field.id, field.order ?? groupOrder);
-		}
-		const openOrderLevels = /* @__PURE__ */ new Set();
-		for (const issue of issues) {
-			const fieldId = this.getFieldIdFromRef(issue.ref, issue.scope);
-			if (fieldId) {
-				const order = fieldOrderMap.get(fieldId) ?? 0;
-				openOrderLevels.add(order);
-			} else if (issue.scope === "form") openOrderLevels.add(0);
-		}
-		if (openOrderLevels.size <= 1) return issues;
-		const currentOrder = Math.min(...openOrderLevels);
-		return issues.filter((issue) => {
-			if (issue.scope === "form") return true;
-			const fieldId = this.getFieldIdFromRef(issue.ref, issue.scope);
-			if (!fieldId) return true;
-			return (fieldOrderMap.get(fieldId) ?? 0) === currentOrder;
-		});
-	}
-	/**
-	* Extract field ID from an issue ref.
-	*/
-	getFieldIdFromRef(ref, scope) {
-		if (scope === "field") return ref;
-		if (scope === "option") {
-			const dotIndex = ref.indexOf(".");
-			return dotIndex > 0 ? ref.slice(0, dotIndex) : void 0;
-		}
-	}
-	/**
-	* Get the parent group ID for a field.
-	*/
-	getGroupForField(fieldId) {
-		const entry = this.form.idIndex.get(fieldId);
-		if (!entry) return;
-		if (entry.parentId) {
-			if (this.form.idIndex.get(entry.parentId)?.nodeType === "group") return entry.parentId;
-		}
-	}
-	/**
 	* Clear all fields that match the target roles.
 	* Used when fillMode='overwrite' to re-fill already-filled fields.
 	*/
@@ -3310,6 +2682,7 @@ var FillRecordCollector = class {
 		});
 	}
 	onTurnComplete(progress) {
+		const warnings = progress.coercionWarnings;
 		this.events.push({
 			type: "turn_complete",
 			timestamp: currentTime(),
@@ -3317,6 +2690,7 @@ var FillRecordCollector = class {
 			patchesApplied: progress.patchesApplied,
 			patchesRejected: progress.rejectedPatches?.length ?? 0,
 			issuesAddressed: progress.issuesShown,
+			...warnings && warnings.length > 0 && { coercionWarnings: warnings },
 			executionId: progress.executionId
 		});
 	}
@@ -3524,7 +2898,8 @@ var FillRecordCollector = class {
 					patchesApplied: completeEvent.patchesApplied,
 					patchesRejected: completeEvent.patchesRejected,
 					tokens,
-					toolCalls
+					toolCalls,
+					...completeEvent.coercionWarnings && completeEvent.coercionWarnings.length > 0 && { coercionWarnings: completeEvent.coercionWarnings }
 				};
 				turns.set(key, entry);
 			}
@@ -8925,186 +8300,6 @@ function createAnthropic(options = {}) {
 }
 var anthropic = createAnthropic();
 
-//#endregion
-//#region src/harness/prompts.ts
-/**
-* Agent Prompts - Centralized prompt definitions for the live agent.
-*
-* All hardcoded prompts are defined here for easy review, modification,
-* and future configurability. This file serves as the single source of
-* truth for agent behavior instructions.
-*/
-/**
-* Default system prompt for the live agent.
-*
-* This is the base instruction set that defines the agent's core behavior
-* for form filling. It emphasizes accuracy over completeness and prohibits
-* fabrication of data.
-*/
-const DEFAULT_SYSTEM_PROMPT = `# Form Instructions
-
-Research and fill the form fields using all available tools. Focus on accuracy over completeness.
-
-## Guidelines
-1. Address required fields first (severity: "required"), then optional fields (severity: "recommended")
-2. NEVER fabricate or guess information - only use data you can verify
-3. If you cannot find verifiable information, use skip_field with a reason
-
-## Patch Format Examples
-
-Use the fill_form tool with patches in these formats:
-
-| Type | Example |
-|------|---------|
-| string | \`{ op: "set_string", fieldId: "name", value: "Acme Corp" }\` |
-| number | \`{ op: "set_number", fieldId: "age", value: 32 }\` |
-| string_list | \`{ op: "set_string_list", fieldId: "tags", value: ["ai", "ml"] }\` |
-| url | \`{ op: "set_url", fieldId: "website", value: "https://example.com" }\` |
-| url_list | \`{ op: "set_url_list", fieldId: "sources", value: ["https://a.com", "https://b.com"] }\` |
-| date | \`{ op: "set_date", fieldId: "event_date", value: "2024-06-15" }\` |
-| year | \`{ op: "set_year", fieldId: "founded", value: 2024 }\` |
-| single_select | \`{ op: "set_single_select", fieldId: "priority", value: "high" }\` |
-| multi_select | \`{ op: "set_multi_select", fieldId: "categories", value: ["frontend", "backend"] }\` |
-| checkboxes | \`{ op: "set_checkboxes", fieldId: "tasks", value: { "task1": "done", "task2": "todo" } }\` |
-| table | \`{ op: "set_table", fieldId: "team", value: [{ "name": "Alice", "role": "Engineer" }] }\` |
-
-## Important: checkboxes vs multi_select
-
-These two types look similar but have DIFFERENT value formats:
-
-- **multi_select** → array of option IDs: \`["opt1", "opt2"]\`
-- **checkboxes** → object mapping IDs to states: \`{ "opt1": "done", "opt2": "todo" }\`
-
-**Checkbox states by mode:**
-- Mode "simple": \`"done"\` or \`"todo"\`
-- Mode "multi": \`"done"\`, \`"todo"\`, \`"incomplete"\`, \`"active"\`, or \`"na"\`
-- Mode "explicit": \`"yes"\` or \`"no"\` (if unknown, use abort_field)
-
-**WRONG:** \`{ op: "set_checkboxes", value: ["task1", "task2"] }\`
-**RIGHT:** \`{ op: "set_checkboxes", value: { "task1": "done", "task2": "done" } }\`
-
-## Skipping Fields
-
-If you cannot find verifiable information:
-\`{ op: "skip_field", fieldId: "...", reason: "Could not find verified data" }\`
-`;
-/**
-* Web search instructions appended when web search tools are available.
-*
-* These instructions enforce that the agent must verify all information
-* through web search before filling fields.
-*/
-const WEB_SEARCH_INSTRUCTIONS = `# Web Search
-You have access to web search tools. You MUST use them to verify ALL information before filling fields.
-
-Guidelines:
-1. Search for official sources (company websites, Crunchbase, LinkedIn, press releases)
-2. Cross-reference information across multiple sources when possible
-3. Only fill fields with data you found and verified through search
-4. If a search returns no results or uncertain information, use skip_field with a reason explaining what you searched for
-5. NEVER fill fields with guessed or assumed information
-`;
-/**
-* Header for the issues section in the context prompt.
-*/
-const ISSUES_HEADER = "# Current Form Issues";
-/**
-* Template for the issues intro text.
-* @param issueCount - Actual number of issues shown
-*/
-function getIssuesIntro(issueCount) {
-	return `You need to address ${issueCount} issue${issueCount === 1 ? "" : "s"}. Here are the current issues:`;
-}
-/**
-* Patch format examples by field kind.
-*
-* This is the single source of truth for patch format documentation.
-* Used in PATCH_FORMAT_INSTRUCTIONS and rejection feedback hints.
-*/
-const PATCH_FORMATS = {
-	string: "{ op: \"set_string\", fieldId: \"...\", value: \"text here\" }",
-	number: "{ op: \"set_number\", fieldId: \"...\", value: 42 }",
-	string_list: "{ op: \"set_string_list\", fieldId: \"...\", value: [\"item1\", \"item2\"] }",
-	single_select: "{ op: \"set_single_select\", fieldId: \"...\", value: \"option_id\" }",
-	multi_select: "{ op: \"set_multi_select\", fieldId: \"...\", value: [\"opt1\", \"opt2\"] }",
-	checkboxes: "{ op: \"set_checkboxes\", fieldId: \"...\", value: { \"opt1\": \"done\", \"opt2\": \"todo\" } }",
-	url: "{ op: \"set_url\", fieldId: \"...\", value: \"https://example.com\" }",
-	url_list: "{ op: \"set_url_list\", fieldId: \"...\", value: [\"https://a.com\", \"https://b.com\"] }",
-	date: "{ op: \"set_date\", fieldId: \"...\", value: \"2024-06-15\" }",
-	year: "{ op: \"set_year\", fieldId: \"...\", value: 2024 }",
-	table: "{ op: \"set_table\", fieldId: \"...\", value: [{ col1: \"val1\", col2: \"val2\" }] }"
-};
-/**
-* Get the correct patch format for a field kind.
-*
-* @param fieldKind - The field kind (e.g., "table", "string")
-* @param options - Optional configuration for the hint
-* @returns The patch format example string
-*/
-function getPatchFormatHint(fieldKind, fieldIdOrOptions, columnIds) {
-	let options = {};
-	if (typeof fieldIdOrOptions === "string") options = {
-		fieldId: fieldIdOrOptions,
-		columnIds
-	};
-	else if (fieldIdOrOptions) options = fieldIdOrOptions;
-	let format = PATCH_FORMATS[fieldKind];
-	if (!format) return `Use the correct set_${fieldKind} operation for this field type.`;
-	if (options.fieldId) format = format.replace("fieldId: \"...\"", `fieldId: "${options.fieldId}"`);
-	if (fieldKind === "checkboxes") {
-		const mode = options.checkboxMode ?? "multi";
-		const optIds = options.optionIds ?? ["opt1", "opt2"];
-		const [state1, state2] = {
-			simple: ["done", "todo"],
-			multi: ["done", "todo"],
-			explicit: ["yes", "no"]
-		}[mode] ?? ["done", "todo"];
-		const valueExample = optIds.length >= 2 ? `{ "${optIds[0]}": "${state1}", "${optIds[1]}": "${state2}" }` : optIds.length === 1 ? `{ "${optIds[0]}": "${state1}" }` : `{ "opt1": "${state1}", "opt2": "${state2}" }`;
-		format = format.replace("{ \"opt1\": \"done\", \"opt2\": \"todo\" }", valueExample);
-	}
-	if (fieldKind === "table" && options.columnIds && options.columnIds.length > 0) {
-		const colExample = options.columnIds.map((id) => `"${id}": "..."`).join(", ");
-		format = format.replace("{ col1: \"val1\", col2: \"val2\" }", `{ ${colExample} }`);
-	}
-	return format;
-}
-/**
-* Instructions section for the context prompt.
-*
-* This explains the patch format for each field kind.
-* Generated from PATCH_FORMATS to ensure consistency.
-*/
-const PATCH_FORMAT_INSTRUCTIONS = `# Instructions
-
-Use the fill_form tool to submit patches for the fields above.
-Each patch should match the field kind:
-${Object.entries(PATCH_FORMATS).map(([kind, format]) => `- ${kind}: ${format}`).join("\n")}
-
-For table fields, use the column IDs shown in the field schema. Each row is an object with column ID keys.
-
-If you cannot find verifiable information for a field, skip it:
-- skip: { op: "skip_field", fieldId: "...", reason: "Information not available" }`;
-/**
-* Simplified general instructions for use with inline field instructions.
-*
-* When inline field instructions are shown after each issue, we only need
-* general guidance about using the fill_form tool.
-*/
-const GENERAL_INSTRUCTIONS = `# General Instructions
-
-Use the fill_form tool to submit patches for the fields above.
-For table fields, each row is an object with column ID keys.`;
-/**
-* Section headers used when building the composed system prompt.
-*/
-const SECTION_HEADERS = {
-	formInstructions: "# Form Instructions",
-	roleInstructions: (role) => `# Instructions for ${role} role`,
-	roleGuidance: "# Role guidance",
-	fieldInstructions: "# Field-specific instructions",
-	additionalContext: "# Additional Context"
-};
-
 //#endregion
 //#region src/harness/toolApi.ts
 /**
@@ -9135,6 +8330,7 @@ var LiveAgent = class {
 	callbacks;
 	executionId;
 	toolChoice;
+	maxRetries;
 	constructor(config) {
 		this.model = config.model;
 		this.maxStepsPerTurn = config.maxStepsPerTurn ?? DEFAULT_MAX_STEPS_PER_TURN;
@@ -9145,8 +8341,12 @@ var LiveAgent = class {
 		this.additionalTools = config.additionalTools ?? {};
 		this.callbacks = config.callbacks;
 		this.executionId = config.executionId ?? "0-serial";
+		this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
 		this.toolChoice = config.toolChoice ?? "required";
-		if (this.enableWebSearch && this.provider) this.webSearchTools = loadWebSearchTools(this.provider);
+		if (this.enableWebSearch) {
+			if (config.providerTools) this.webSearchTools = config.providerTools;
+			else if (this.provider) this.webSearchTools = loadWebSearchTools(this.provider);
+		}
 	}
 	/**
 	* Get list of available tool names for this agent.
@@ -9201,6 +8401,7 @@ var LiveAgent = class {
 				prompt: contextPrompt,
 				tools,
 				toolChoice: this.toolChoice,
+				maxRetries: this.maxRetries,
 				stopWhen: stepCountIs(this.maxStepsPerTurn)
 			});
 		} catch (error) {
@@ -9692,6 +8893,61 @@ const PROVIDERS = {
 	}
 };
 /**
+* Built-in providers available by default.
+* Exported so callers can inspect which providers are built-in.
+*/
+const BUILT_IN_PROVIDERS = Object.freeze({
+	anthropic: "anthropic",
+	openai: "openai",
+	google: "google",
+	xai: "xai",
+	deepseek: "deepseek"
+});
+/** Known web search tool names from AI SDK providers. */
+const KNOWN_WEB_SEARCH_TOOLS = [
+	"webSearch",
+	"webSearch_20250305",
+	"googleSearch",
+	"webSearchPreview"
+];
+/**
+* Extract web search tools from an AI SDK provider callable.
+* Duck-types the `.tools` property looking for known tool factory names.
+*/
+function extractToolsFromProvider(provider) {
+	const providerTools = provider.tools;
+	if (!providerTools || typeof providerTools !== "object") return void 0;
+	const extracted = {};
+	for (const toolName of KNOWN_WEB_SEARCH_TOOLS) {
+		const factory = providerTools[toolName];
+		if (typeof factory === "function") try {
+			const tool = factory({});
+			if (tool) {
+				const key = toolName === "googleSearch" ? "google_search" : "web_search";
+				extracted[key] = tool;
+				break;
+			}
+		} catch {}
+	}
+	return Object.keys(extracted).length > 0 ? extracted : void 0;
+}
+/**
+* Normalize a ProviderInput to a ProviderAdapter.
+* AI SDK provider callables are wrapped in an adapter shape.
+*/
+function normalizeProvider(input) {
+	if (typeof input === "function") return {
+		model: (id) => input(id),
+		tools: extractToolsFromProvider(input)
+	};
+	if ("model" in input && typeof input.model === "function") return input;
+	throw new MarkformConfigError("Invalid provider: must be a ProviderAdapter (with .model() method) or an AI SDK provider callable", {
+		option: "providers",
+		expectedType: "ProviderAdapter | callable",
+		receivedValue: typeof input
+	});
+}
+/**
 * Parse a model ID string into provider and model components.
 *
 * @param modelIdString - Model ID in format `provider/model-id`
@@ -9712,12 +8968,6 @@ function parseModelId(modelIdString) {
 		expectedType: "non-empty provider and model-id",
 		receivedValue: modelIdString
 	});
-	const supportedProviders = Object.keys(PROVIDERS);
-	if (!supportedProviders.includes(provider)) throw new MarkformConfigError(`Unknown provider: "${provider}". Supported providers: ${supportedProviders.join(", ")}`, {
-		option: "model",
-		expectedType: `one of: ${supportedProviders.join(", ")}`,
-		receivedValue: provider
-	});
 	return {
 		provider,
 		modelId
@@ -9732,9 +8982,31 @@ function parseModelId(modelIdString) {
 * @returns Resolved model with provider info
 * @throws Error if provider not installed or API key missing
 */
-async function resolveModel(modelIdString) {
+async function resolveModel(modelIdString, providers) {
 	const { provider, modelId } = parseModelId(modelIdString);
+	if (providers && provider in providers) {
+		const adapter = normalizeProvider(providers[provider]);
+		try {
+			return {
+				model: adapter.model(modelId),
+				provider,
+				modelId,
+				tools: adapter.tools
+			};
+		} catch (error) {
+			throw new MarkformConfigError(`Custom provider "${provider}" failed to resolve model "${modelId}": ${error instanceof Error ? error.message : String(error)}`, {
+				option: "model",
+				expectedType: "valid model ID",
+				receivedValue: modelIdString
+			});
+		}
+	}
 	const providerConfig = PROVIDERS[provider];
+	if (!providerConfig) throw new MarkformConfigError(`Unknown provider: "${provider}". Built-in providers: ${Object.keys(PROVIDERS).join(", ")}. To use a custom provider, pass it via the \`providers\` option.`, {
+		option: "model",
+		expectedType: "provider name or custom provider",
+		receivedValue: provider
+	});
 	const apiKey = process.env[providerConfig.envVar];
 	if (!apiKey) throw new MarkformConfigError(`Missing API key for "${provider}" provider (model: ${modelIdString}).\nSet the ${providerConfig.envVar} environment variable or add it to your .env file.`, {
 		option: providerConfig.envVar,
@@ -10264,11 +9536,13 @@ async function fillForm(options) {
 	}
 	let model;
 	let provider;
+	let providerTools;
 	if (!options._testAgent) try {
 		if (typeof options.model === "string") {
-			const resolved = await resolveModel(options.model);
+			const resolved = await resolveModel(options.model, options.providers);
 			model = resolved.model;
 			provider = resolved.provider;
+			providerTools = resolved.tools;
 		} else model = options.model;
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
@@ -10310,6 +9584,7 @@ async function fillForm(options) {
 		systemPromptAddition: options.systemPromptAddition,
 		targetRole: targetRoles[0] ?? AGENT_ROLE,
 		provider,
+		providerTools,
 		enableWebSearch: options.enableWebSearch,
 		additionalTools: options.additionalTools,
 		callbacks: mergedCallbacks,
@@ -10426,6 +9701,7 @@ async function fillForm(options) {
 				issues: turnIssues,
 				patches,
 				rejectedPatches: stepResult.rejectedPatches ?? [],
+				coercionWarnings: stepResult.coercionWarnings,
 				executionId: "0-serial"
 			});
 		} catch {}
@@ -10654,10 +9930,12 @@ async function runMultiTurnForItems(form, agent, items, targetRoles, maxPatchesP
 				}
 			};
 		}
+		let lastCoercionWarnings;
 		if (response.patches.length > 0) {
 			const applyResult = applyPatches(form, response.patches);
 			patchesApplied += applyResult.appliedPatches.length;
 			previousRejections = applyResult.rejectedPatches;
+			lastCoercionWarnings = applyResult.warnings;
 		} else previousRejections = void 0;
 		turnsUsed++;
 		try {
@@ -10673,6 +9951,7 @@ async function runMultiTurnForItems(form, agent, items, targetRoles, maxPatchesP
 				issues: scopedIssues,
 				patches: response.patches,
 				rejectedPatches: previousRejections ?? [],
+				coercionWarnings: lastCoercionWarnings,
 				executionId
 			});
 		} catch {}
@@ -10866,7 +10145,8 @@ const TimelineEntrySchema = z.object({
 		input: z.number().int().nonnegative(),
 		output: z.number().int().nonnegative()
 	}),
-	toolCalls: z.array(ToolCallRecordSchema)
+	toolCalls: z.array(ToolCallRecordSchema),
+	coercionWarnings: z.array(PatchWarningSchema).optional()
 });
 /**
 * Breakdown item for visualization.
@@ -10968,6 +10248,14 @@ const FillRecordSchema = z.object({
 * - toolSummary: call counts and success rates (without timing)
 * - execution: turn counts, parallel settings (deterministic)
 */
+/**
+* Check if a fill record represents an empty session with no actual work.
+* Returns true if the timeline has zero entries (no turns were executed).
+* Used to skip writing .fill.json when no form-filling work was done.
+*/
+function isEmptyFillRecord(record) {
+	return record.timeline.length === 0;
+}
 function stripUnstableFillRecordFields(record) {
 	const stableByTool = record.toolSummary.byTool.map((toolStats) => {
 		const { timing, ...rest } = toolStats;
@@ -11111,8 +10399,8 @@ function validateResearchForm(form) {
 //#endregion
 //#region src/index.ts
 /** Markform version (injected at build time). */
-const VERSION = "0.1.22";
+const VERSION = "0.1.24";
 
 //#endregion
-export { FormHarness as A, serializeScopeRef as B, resolveModel as C, computeExecutionPlan as D, FillRecordCollector as E, getFieldId as F, injectCheckboxIds as G, formToJsonSchema as H, isCellRef as I, findEnclosingHeadings as J, injectHeaderIds as K, isFieldRef as L, coerceInputContext as M, coerceToFieldPatch as N, MockAgent as O, findFieldById as P, isQualifiedRef as R, getProviderNames as S, createLiveAgent as T, parseForm as U, fieldToJsonSchema as V, findAllCheckboxes as W, parseMarkdownTable as X, parseCellValue as Y, parseRawTable as Z, fillForm as _, ExecutionMetadataSchema as a, scopeIssuesForItem as b, TimelineEntrySchema as c, ToolCallRecordSchema as d, ToolStatsSchema as f, resolveHarnessConfig as g, formatFillRecordSummary as h, runResearch as i, createHarness as j, createMockAgent as k, TimingBreakdownItemSchema as l, stripUnstableFillRecordFields as m, isResearchForm as n, FillRecordSchema as o, ToolSummarySchema as p, findAllHeadings as q, validateResearchForm as r, FillRecordStatusSchema as s, VERSION as t, TimingBreakdownSchema as u, ParallelHarness as v, buildMockWireFormat as w, getProviderInfo as x, createParallelHarness as y, parseScopeRef as z };
-//# sourceMappingURL=src-CbRnGzMK.mjs.map
+export { MockAgent as A, fieldToJsonSchema as B, getProviderInfo as C, createLiveAgent as D, buildMockWireFormat as E, isCellRef as F, injectHeaderIds as G, parseForm as H, isFieldRef as I, parseCellValue as J, findAllHeadings as K, isQualifiedRef as L, FormHarness as M, createHarness as N, FillRecordCollector as O, getFieldId as P, parseScopeRef as R, BUILT_IN_PROVIDERS as S, resolveModel as T, findAllCheckboxes as U, formToJsonSchema as V, injectCheckboxIds as W, parseRawTable as X, parseMarkdownTable as Y, resolveHarnessConfig as _, ExecutionMetadataSchema as a, createParallelHarness as b, TimelineEntrySchema as c, ToolCallRecordSchema as d, ToolStatsSchema as f, formatFillRecordSummary as g, stripUnstableFillRecordFields as h, runResearch as i, createMockAgent as j, computeExecutionPlan as k, TimingBreakdownItemSchema as l, isEmptyFillRecord as m, isResearchForm as n, FillRecordSchema as o, ToolSummarySchema as p, findEnclosingHeadings as q, validateResearchForm as r, FillRecordStatusSchema as s, VERSION as t, TimingBreakdownSchema as u, fillForm as v, getProviderNames as w, scopeIssuesForItem as x, ParallelHarness as y, serializeScopeRef as z };
+//# sourceMappingURL=src-C5OWf1dL.mjs.map