markform 0.1.18 → 0.1.19

package/README.md

@@ -1,7 +1,7 @@
 # Markform
 
-[![CI](https://github.com/jlevy/markform/actions/workflows/ci.yml/badge.svg)](https://github.com/jlevy/markform/actions/runs/21430430567)
-[![Coverage](https://raw.githubusercontent.com/jlevy/markform/main/badges/packages/markform/coverage-total.svg)](https://github.com/jlevy/markform/actions/runs/21430430567)
+[![CI](https://github.com/jlevy/markform/actions/workflows/ci.yml/badge.svg)](https://github.com/jlevy/markform/actions/runs/21506874671)
+[![Coverage](https://raw.githubusercontent.com/jlevy/markform/main/badges/packages/markform/coverage-total.svg)](https://github.com/jlevy/markform/actions/runs/21506874671)
 [![npm version](https://img.shields.io/npm/v/markform)](https://www.npmjs.com/package/markform)
 [![X Follow](https://img.shields.io/twitter/follow/ojoshe)](https://x.com/ojoshe)
 
@@ -467,6 +467,8 @@ markform fill my-form.form.md --interactive
 markform fill my-form.form.md --model=anthropic/claude-sonnet-4-5
 # Mock agent for testing (uses pre-filled form as source)
 markform fill my-form.form.md --mock --mock-source filled.form.md
+# Record fill session to JSON sidecar (tokens, timing, tool calls)
+markform fill my-form.form.md --model=openai/gpt-5-mini --record-fill
 ```
 
 ### Export and Transform
@@ -565,6 +567,29 @@ console.log(form.responsesByFieldId);
 const output = serialize(form);
 ```
 
+### High-Level Fill API
+
+The simplest way to fill a form programmatically:
+
+```typescript
+import { fillForm } from "markform";
+
+const result = await fillForm({
+  form: markdownContent,
+  model: "anthropic/claude-sonnet-4-5",
+  enableWebSearch: true,
+  recordFill: true, // Capture tokens, timing, tool calls
+});
+
+if (result.status.ok) {
+  console.log("Values:", result.values);
+  console.log("Tokens used:", result.record?.llm.inputTokens);
+}
+```
+
+See the [API documentation](https://github.com/jlevy/markform/blob/main/docs/markform-apis.md)
+for options like parallel execution, callbacks, and checkpointing.
+
 ### AI SDK Integration
 
 Markform provides tools compatible with the [Vercel AI SDK](https://sdk.vercel.ai/):

package/dist/ai-sdk.d.mts

@@ -1,9 +1,8 @@
 
-import { At as Patch, Mt as PatchSchema, U as FieldResponse, Y as FormSchema, at as InspectResult, et as Id, kt as ParsedForm, mr as ValidatorRegistry, r as ApplyResult } from "./coreTypes-BMEs8h_2.mjs";
+import { At as Patch, Mt as PatchSchema, U as FieldResponse, Y as FormSchema, at as InspectResult, et as Id, kt as ParsedForm, mr as ValidatorRegistry, r as ApplyResult } from "./coreTypes-CkxML8g2.mjs";
 import { z } from "zod";
 
 //#region src/integrations/toolTypes.d.ts
-
 /**
  * Result from markform_inspect tool.
  */

package/dist/ai-sdk.mjs

@@ -1,6 +1,6 @@
 
-import { L as PatchSchema } from "./coreTypes-SDB3KRRJ.mjs";
-import { d as serializeForm, i as inspect, t as applyPatches } from "./apply-BYgtU64w.mjs";
+import { L as PatchSchema } from "./coreTypes-CPKXf2dc.mjs";
+import { d as serializeForm, i as inspect, t as applyPatches } from "./apply-Dalpt-D6.mjs";
 import { z } from "zod";
 
 //#region src/integrations/vercelAiSdkTools.ts

package/dist/ai-sdk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ai-sdk.mjs","names":["toolset: MarkformToolSet"],"sources":["../src/integrations/vercelAiSdkTools.ts"],"sourcesContent":["/**\n * AI SDK Integration for Markform.\n *\n * Provides Vercel AI SDK compatible tools for agent-driven form filling.\n * Use createMarkformTools() to create a toolset that wraps the Markform engine.\n *\n * @example\n * ```typescript\n * import { createMarkformTools, MarkformSessionStore } from 'markform/ai-sdk';\n * import { generateText } from 'ai';\n *\n * const store = new MarkformSessionStore(parsedForm);\n * const tools = createMarkformTools({ sessionStore: store });\n *\n * const { text } = await generateText({\n *   model: openai('gpt-4'),\n *   prompt: 'Fill out this form...',\n *   tools,\n * });\n * ```\n */\n\nimport { z } from 'zod';\nimport type { ParsedForm, Patch, ValidatorRegistry } from '../engine/coreTypes.js';\nimport { inspect } from '../engine/inspect.js';\nimport { applyPatches } from '../engine/apply.js';\nimport { serializeForm } from '../engine/serialize.js';\nimport { PatchSchema } from '../engine/coreTypes.js';\n\n// =============================================================================\n// Session Store\n// =============================================================================\n\n/**\n * Session store for managing form state during AI interactions.\n *\n * The AI SDK tools operate on a shared form instance through this store.\n * Create one store per form-filling session.\n */\nexport class MarkformSessionStore {\n  private form: ParsedForm;\n  private validatorRegistry: ValidatorRegistry;\n\n  constructor(form: ParsedForm, validatorRegistry?: ValidatorRegistry) {\n    this.form = form;\n    this.validatorRegistry = validatorRegistry ?? {};\n  }\n\n  /**\n   * Get the current form.\n   */\n  getForm(): ParsedForm {\n    return this.form;\n  }\n\n  /**\n   * Get the validator registry.\n   */\n  getValidatorRegistry(): ValidatorRegistry {\n    return this.validatorRegistry;\n  }\n\n  /**\n   * Update the form values.\n   */\n  updateForm(form: ParsedForm): void {\n    this.form = form;\n  }\n}\n\n// =============================================================================\n// Tool Creation Options\n// =============================================================================\n\n/**\n * Options for creating Markform AI SDK tools.\n */\nexport interface CreateMarkformToolsOptions {\n  /**\n   * Session store managing the form state.\n   */\n  sessionStore: MarkformSessionStore;\n\n  /**\n   * Whether to include the markform_get_markdown tool.\n   * Defaults to true.\n   */\n  includeGetMarkdown?: boolean;\n}\n\n// =============================================================================\n// Tool Types (imported from toolTypes.ts)\n// =============================================================================\n\nimport type {\n  ApplyToolResult,\n  ExportToolResult,\n  GetMarkdownToolResult,\n  InspectToolResult,\n  MarkformTool,\n  MarkformToolSet,\n} from './toolTypes.js';\n\n// Re-export types for backwards compatibility\nexport type {\n  ApplyToolResult,\n  ExportToolResult,\n  GetMarkdownToolResult,\n  InspectToolResult,\n  MarkformTool,\n  MarkformToolSet,\n} from './toolTypes.js';\n\n// =============================================================================\n// Zod Schemas for Tool Inputs\n// =============================================================================\n\n/**\n * Input schema for markform_inspect tool (no parameters).\n */\nconst InspectInputSchema = z\n  .object({})\n  .describe('No input parameters required. Call this tool to inspect the current form state.');\n\n/**\n * Input schema for markform_apply tool.\n */\nconst ApplyInputSchema = z\n  .object({\n    patches: z\n      .array(PatchSchema)\n      .min(1)\n      .max(20)\n      .describe(\n        'Array of patches to apply to the form. Each patch sets or clears a field value. ' +\n          'Operations: set_string, set_number, set_string_list, set_single_select, set_multi_select, ' +\n          'set_checkboxes, set_url, set_url_list, set_date, set_year, set_table, clear_field, skip_field, abort_field. ' +\n          'Example: [{ \"op\": \"set_string\", \"fieldId\": \"name\", \"value\": \"Alice\" }]',\n      ),\n  })\n  .describe('Apply patches to update form field values.');\n\n/**\n * Input schema for markform_export tool (no parameters).\n */\nconst ExportInputSchema = z\n  .object({})\n  .describe(\n    'No input parameters required. Call this tool to export the form schema and current values as JSON.',\n  );\n\n/**\n * Input schema for markform_get_markdown tool (no parameters).\n */\nconst GetMarkdownInputSchema = z\n  .object({})\n  .describe(\n    'No input parameters required. Call this tool to get the canonical Markdown representation of the current form.',\n  );\n\n// =============================================================================\n// Tool Factory\n// =============================================================================\n\n/**\n * Create Markform AI SDK tools for agent-driven form filling.\n *\n * Returns a toolset compatible with Vercel AI SDK's generateText and streamText.\n *\n * @param options - Tool creation options including session store\n * @returns MarkformToolSet containing all tools\n *\n * @example\n * ```typescript\n * import { parseForm } from 'markform';\n * import { createMarkformTools, MarkformSessionStore } from 'markform/ai-sdk';\n *\n * const form = parseForm(markdownContent);\n * const store = new MarkformSessionStore(form);\n * const tools = createMarkformTools({ sessionStore: store });\n *\n * // Use with AI SDK\n * const result = await generateText({\n *   model: yourModel,\n *   tools,\n *   prompt: 'Fill out this form based on the user information...',\n * });\n * ```\n */\nexport function createMarkformTools(options: CreateMarkformToolsOptions): MarkformToolSet {\n  const { sessionStore, includeGetMarkdown = true } = options;\n\n  // markform_inspect - Get current form state with issues\n  const markform_inspect: MarkformTool<Record<string, never>, InspectToolResult> = {\n    description:\n      'Inspect the current form state. Returns structure summary, progress summary, validation issues, ' +\n      'and completion status. Use this to understand what fields need to be filled and what issues exist. ' +\n      \"Issues are sorted by priority (1 = highest). Focus on 'required' severity issues first.\",\n    inputSchema: InspectInputSchema,\n    execute: () => {\n      const form = sessionStore.getForm();\n      const result = inspect(form);\n\n      const requiredCount = result.issues.filter((i) => i.severity === 'required').length;\n      const message = result.isComplete\n        ? 'Form is complete. All required fields are filled.'\n        : `Form has ${requiredCount} required issue(s) to resolve.`;\n\n      return Promise.resolve({\n        success: true,\n        data: result,\n        message,\n      });\n    },\n  };\n\n  // markform_apply - Apply patches to update form values\n  const markform_apply: MarkformTool<{ patches: Patch[] }, ApplyToolResult> = {\n    description:\n      'Apply patches to update form field values. Valid patches are applied even if some fail. ' +\n      'Single values are automatically coerced to arrays for list fields. ' +\n      'Returns applied patches, warnings for coerced values, and rejected patches separately. ' +\n      'Patch operations: set_string, set_number, set_string_list, set_single_select, set_multi_select, ' +\n      'set_checkboxes, set_url, set_url_list, set_date, set_year, set_table, clear_field, skip_field, abort_field.',\n    inputSchema: ApplyInputSchema,\n    execute: ({ patches }) => {\n      const form = sessionStore.getForm();\n      const result = applyPatches(form, patches);\n\n      // Update the store with the modified form\n      sessionStore.updateForm(form);\n\n      const warningNote = result.warnings.length > 0 ? ` (${result.warnings.length} coerced)` : '';\n      const remaining = result.issues.filter((i) => i.severity === 'required').length;\n\n      const message =\n        result.applyStatus === 'applied'\n          ? `Applied ${patches.length} patch(es)${warningNote}. ${\n              result.isComplete\n                ? 'Form is now complete!'\n                : `${remaining} required issue(s) remaining.`\n            }`\n          : result.applyStatus === 'partial'\n            ? `Applied ${result.appliedPatches.length}/${patches.length} patches${warningNote}. ` +\n              `${result.rejectedPatches.length} rejected.`\n            : `All patches rejected. Check field IDs and value types.`;\n\n      return Promise.resolve({\n        success: result.applyStatus !== 'rejected',\n        data: result,\n        message,\n      });\n    },\n  };\n\n  // markform_export - Export schema and values as JSON\n  const markform_export: MarkformTool<Record<string, never>, ExportToolResult> = {\n    description:\n      'Export the form schema and current values as JSON. Use this to get a machine-readable ' +\n      'representation of the form structure and all field values. Useful for processing or analysis.',\n    inputSchema: ExportInputSchema,\n    execute: () => {\n      const form = sessionStore.getForm();\n\n      // Count answered fields\n      const answeredCount = Object.values(form.responsesByFieldId).filter(\n        (response) => response.state === 'answered',\n      ).length;\n\n      return Promise.resolve({\n        success: true,\n        data: {\n          schema: form.schema,\n          values: form.responsesByFieldId,\n        },\n        message: `Exported form with ${form.schema.groups.length} group(s) and ${answeredCount} answered field(s).`,\n      });\n    },\n  };\n\n  // Build the toolset\n  const toolset: MarkformToolSet = {\n    markform_inspect,\n    markform_apply,\n    markform_export,\n  };\n\n  // Optionally include markform_get_markdown\n  if (includeGetMarkdown) {\n    const markform_get_markdown: MarkformTool<Record<string, never>, GetMarkdownToolResult> = {\n      description:\n        'Get the canonical Markdown representation of the current form. ' +\n        'Use this to see the complete form with all current values in Markform format. ' +\n        'The output is deterministic and round-trip safe.',\n      inputSchema: GetMarkdownInputSchema,\n      execute: () => {\n        const form = sessionStore.getForm();\n        const markdown = serializeForm(form);\n\n        return Promise.resolve({\n          success: true,\n          data: {\n            markdown,\n          },\n          message: `Generated Markdown (${markdown.length} characters).`,\n        });\n      },\n    };\n\n    toolset.markform_get_markdown = markform_get_markdown;\n  }\n\n  return toolset;\n}\n\n// =============================================================================\n// Convenience Exports\n// =============================================================================\n\nexport { PatchSchema } from '../engine/coreTypes.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,uBAAb,MAAkC;CAChC,AAAQ;CACR,AAAQ;CAER,YAAY,MAAkB,mBAAuC;AACnE,OAAK,OAAO;AACZ,OAAK,oBAAoB,qBAAqB,EAAE;;;;;CAMlD,UAAsB;AACpB,SAAO,KAAK;;;;;CAMd,uBAA0C;AACxC,SAAO,KAAK;;;;;CAMd,WAAW,MAAwB;AACjC,OAAK,OAAO;;;;;;AAsDhB,MAAM,qBAAqB,EACxB,OAAO,EAAE,CAAC,CACV,SAAS,kFAAkF;;;;AAK9F,MAAM,mBAAmB,EACtB,OAAO,EACN,SAAS,EACN,MAAM,YAAY,CAClB,IAAI,EAAE,CACN,IAAI,GAAG,CACP,SACC,2WAID,EACJ,CAAC,CACD,SAAS,6CAA6C;;;;AAKzD,MAAM,oBAAoB,EACvB,OAAO,EAAE,CAAC,CACV,SACC,qGACD;;;;AAKH,MAAM,yBAAyB,EAC5B,OAAO,EAAE,CAAC,CACV,SACC,iHACD;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BH,SAAgB,oBAAoB,SAAsD;CACxF,MAAM,EAAE,cAAc,qBAAqB,SAAS;CA2FpD,MAAMA,UAA2B;EAC/B,kBAzF+E;GAC/E,aACE;GAGF,aAAa;GACb,eAAe;IAEb,MAAM,SAAS,QADF,aAAa,SAAS,CACP;IAE5B,MAAM,gBAAgB,OAAO,OAAO,QAAQ,MAAM,EAAE,aAAa,WAAW,CAAC;IAC7E,MAAM,UAAU,OAAO,aACnB,sDACA,YAAY,cAAc;AAE9B,WAAO,QAAQ,QAAQ;KACrB,SAAS;KACT,MAAM;KACN;KACD,CAAC;;GAEL;EAqEC,gBAlE0E;GAC1E,aACE;GAKF,aAAa;GACb,UAAU,EAAE,cAAc;IACxB,MAAM,OAAO,aAAa,SAAS;IACnC,MAAM,SAAS,aAAa,MAAM,QAAQ;AAG1C,iBAAa,WAAW,KAAK;IAE7B,MAAM,cAAc,OAAO,SAAS,SAAS,IAAI,KAAK,OAAO,SAAS,OAAO,aAAa;IAC1F,MAAM,YAAY,OAAO,OAAO,QAAQ,MAAM,EAAE,aAAa,WAAW,CAAC;IAEzE,MAAM,UACJ,OAAO,gBAAgB,YACnB,WAAW,QAAQ,OAAO,YAAY,YAAY,IAChD,OAAO,aACH,0BACA,GAAG,UAAU,mCAEnB,OAAO,gBAAgB,YACrB,WAAW,OAAO,eAAe,OAAO,GAAG,QAAQ,OAAO,UAAU,YAAY,IAC7E,OAAO,gBAAgB,OAAO,cACjC;AAER,WAAO,QAAQ,QAAQ;KACrB,SAAS,OAAO,gBAAgB;KAChC,MAAM;KACN;KACD,CAAC;;GAEL;EA+BC,iBA5B6E;GAC7E,aACE;GAEF,aAAa;GACb,eAAe;IACb,MAAM,OAAO,aAAa,SAAS;IAGnC,MAAM,gBAAgB,OAAO,OAAO,KAAK,mBAAmB,CAAC,QAC1D,aAAa,SAAS,UAAU,WAClC,CAAC;AAEF,WAAO,QAAQ,QAAQ;KACrB,SAAS;KACT,MAAM;MACJ,QAAQ,KAAK;MACb,QAAQ,KAAK;MACd;KACD,SAAS,sBAAsB,KAAK,OAAO,OAAO,OAAO,gBAAgB,cAAc;KACxF,CAAC;;GAEL;EAOA;AAGD,KAAI,mBAqBF,SAAQ,wBApBkF;EACxF,aACE;EAGF,aAAa;EACb,eAAe;GAEb,MAAM,WAAW,cADJ,aAAa,SAAS,CACC;AAEpC,UAAO,QAAQ,QAAQ;IACrB,SAAS;IACT,MAAM,EACJ,UACD;IACD,SAAS,uBAAuB,SAAS,OAAO;IACjD,CAAC;;EAEL;AAKH,QAAO"}
+{"version":3,"file":"ai-sdk.mjs","names":[],"sources":["../src/integrations/vercelAiSdkTools.ts"],"sourcesContent":["/**\n * AI SDK Integration for Markform.\n *\n * Provides Vercel AI SDK compatible tools for agent-driven form filling.\n * Use createMarkformTools() to create a toolset that wraps the Markform engine.\n *\n * @example\n * ```typescript\n * import { createMarkformTools, MarkformSessionStore } from 'markform/ai-sdk';\n * import { generateText } from 'ai';\n *\n * const store = new MarkformSessionStore(parsedForm);\n * const tools = createMarkformTools({ sessionStore: store });\n *\n * const { text } = await generateText({\n *   model: openai('gpt-4'),\n *   prompt: 'Fill out this form...',\n *   tools,\n * });\n * ```\n */\n\nimport { z } from 'zod';\nimport type { ParsedForm, Patch, ValidatorRegistry } from '../engine/coreTypes.js';\nimport { inspect } from '../engine/inspect.js';\nimport { applyPatches } from '../engine/apply.js';\nimport { serializeForm } from '../engine/serialize.js';\nimport { PatchSchema } from '../engine/coreTypes.js';\n\n// =============================================================================\n// Session Store\n// =============================================================================\n\n/**\n * Session store for managing form state during AI interactions.\n *\n * The AI SDK tools operate on a shared form instance through this store.\n * Create one store per form-filling session.\n */\nexport class MarkformSessionStore {\n  private form: ParsedForm;\n  private validatorRegistry: ValidatorRegistry;\n\n  constructor(form: ParsedForm, validatorRegistry?: ValidatorRegistry) {\n    this.form = form;\n    this.validatorRegistry = validatorRegistry ?? {};\n  }\n\n  /**\n   * Get the current form.\n   */\n  getForm(): ParsedForm {\n    return this.form;\n  }\n\n  /**\n   * Get the validator registry.\n   */\n  getValidatorRegistry(): ValidatorRegistry {\n    return this.validatorRegistry;\n  }\n\n  /**\n   * Update the form values.\n   */\n  updateForm(form: ParsedForm): void {\n    this.form = form;\n  }\n}\n\n// =============================================================================\n// Tool Creation Options\n// =============================================================================\n\n/**\n * Options for creating Markform AI SDK tools.\n */\nexport interface CreateMarkformToolsOptions {\n  /**\n   * Session store managing the form state.\n   */\n  sessionStore: MarkformSessionStore;\n\n  /**\n   * Whether to include the markform_get_markdown tool.\n   * Defaults to true.\n   */\n  includeGetMarkdown?: boolean;\n}\n\n// =============================================================================\n// Tool Types (imported from toolTypes.ts)\n// =============================================================================\n\nimport type {\n  ApplyToolResult,\n  ExportToolResult,\n  GetMarkdownToolResult,\n  InspectToolResult,\n  MarkformTool,\n  MarkformToolSet,\n} from './toolTypes.js';\n\n// Re-export types for backwards compatibility\nexport type {\n  ApplyToolResult,\n  ExportToolResult,\n  GetMarkdownToolResult,\n  InspectToolResult,\n  MarkformTool,\n  MarkformToolSet,\n} from './toolTypes.js';\n\n// =============================================================================\n// Zod Schemas for Tool Inputs\n// =============================================================================\n\n/**\n * Input schema for markform_inspect tool (no parameters).\n */\nconst InspectInputSchema = z\n  .object({})\n  .describe('No input parameters required. Call this tool to inspect the current form state.');\n\n/**\n * Input schema for markform_apply tool.\n */\nconst ApplyInputSchema = z\n  .object({\n    patches: z\n      .array(PatchSchema)\n      .min(1)\n      .max(20)\n      .describe(\n        'Array of patches to apply to the form. Each patch sets or clears a field value. ' +\n          'Operations: set_string, set_number, set_string_list, set_single_select, set_multi_select, ' +\n          'set_checkboxes, set_url, set_url_list, set_date, set_year, set_table, clear_field, skip_field, abort_field. ' +\n          'Example: [{ \"op\": \"set_string\", \"fieldId\": \"name\", \"value\": \"Alice\" }]',\n      ),\n  })\n  .describe('Apply patches to update form field values.');\n\n/**\n * Input schema for markform_export tool (no parameters).\n */\nconst ExportInputSchema = z\n  .object({})\n  .describe(\n    'No input parameters required. Call this tool to export the form schema and current values as JSON.',\n  );\n\n/**\n * Input schema for markform_get_markdown tool (no parameters).\n */\nconst GetMarkdownInputSchema = z\n  .object({})\n  .describe(\n    'No input parameters required. Call this tool to get the canonical Markdown representation of the current form.',\n  );\n\n// =============================================================================\n// Tool Factory\n// =============================================================================\n\n/**\n * Create Markform AI SDK tools for agent-driven form filling.\n *\n * Returns a toolset compatible with Vercel AI SDK's generateText and streamText.\n *\n * @param options - Tool creation options including session store\n * @returns MarkformToolSet containing all tools\n *\n * @example\n * ```typescript\n * import { parseForm } from 'markform';\n * import { createMarkformTools, MarkformSessionStore } from 'markform/ai-sdk';\n *\n * const form = parseForm(markdownContent);\n * const store = new MarkformSessionStore(form);\n * const tools = createMarkformTools({ sessionStore: store });\n *\n * // Use with AI SDK\n * const result = await generateText({\n *   model: yourModel,\n *   tools,\n *   prompt: 'Fill out this form based on the user information...',\n * });\n * ```\n */\nexport function createMarkformTools(options: CreateMarkformToolsOptions): MarkformToolSet {\n  const { sessionStore, includeGetMarkdown = true } = options;\n\n  // markform_inspect - Get current form state with issues\n  const markform_inspect: MarkformTool<Record<string, never>, InspectToolResult> = {\n    description:\n      'Inspect the current form state. Returns structure summary, progress summary, validation issues, ' +\n      'and completion status. Use this to understand what fields need to be filled and what issues exist. ' +\n      \"Issues are sorted by priority (1 = highest). Focus on 'required' severity issues first.\",\n    inputSchema: InspectInputSchema,\n    execute: () => {\n      const form = sessionStore.getForm();\n      const result = inspect(form);\n\n      const requiredCount = result.issues.filter((i) => i.severity === 'required').length;\n      const message = result.isComplete\n        ? 'Form is complete. All required fields are filled.'\n        : `Form has ${requiredCount} required issue(s) to resolve.`;\n\n      return Promise.resolve({\n        success: true,\n        data: result,\n        message,\n      });\n    },\n  };\n\n  // markform_apply - Apply patches to update form values\n  const markform_apply: MarkformTool<{ patches: Patch[] }, ApplyToolResult> = {\n    description:\n      'Apply patches to update form field values. Valid patches are applied even if some fail. ' +\n      'Single values are automatically coerced to arrays for list fields. ' +\n      'Returns applied patches, warnings for coerced values, and rejected patches separately. ' +\n      'Patch operations: set_string, set_number, set_string_list, set_single_select, set_multi_select, ' +\n      'set_checkboxes, set_url, set_url_list, set_date, set_year, set_table, clear_field, skip_field, abort_field.',\n    inputSchema: ApplyInputSchema,\n    execute: ({ patches }) => {\n      const form = sessionStore.getForm();\n      const result = applyPatches(form, patches);\n\n      // Update the store with the modified form\n      sessionStore.updateForm(form);\n\n      const warningNote = result.warnings.length > 0 ? ` (${result.warnings.length} coerced)` : '';\n      const remaining = result.issues.filter((i) => i.severity === 'required').length;\n\n      const message =\n        result.applyStatus === 'applied'\n          ? `Applied ${patches.length} patch(es)${warningNote}. ${\n              result.isComplete\n                ? 'Form is now complete!'\n                : `${remaining} required issue(s) remaining.`\n            }`\n          : result.applyStatus === 'partial'\n            ? `Applied ${result.appliedPatches.length}/${patches.length} patches${warningNote}. ` +\n              `${result.rejectedPatches.length} rejected.`\n            : `All patches rejected. Check field IDs and value types.`;\n\n      return Promise.resolve({\n        success: result.applyStatus !== 'rejected',\n        data: result,\n        message,\n      });\n    },\n  };\n\n  // markform_export - Export schema and values as JSON\n  const markform_export: MarkformTool<Record<string, never>, ExportToolResult> = {\n    description:\n      'Export the form schema and current values as JSON. Use this to get a machine-readable ' +\n      'representation of the form structure and all field values. Useful for processing or analysis.',\n    inputSchema: ExportInputSchema,\n    execute: () => {\n      const form = sessionStore.getForm();\n\n      // Count answered fields\n      const answeredCount = Object.values(form.responsesByFieldId).filter(\n        (response) => response.state === 'answered',\n      ).length;\n\n      return Promise.resolve({\n        success: true,\n        data: {\n          schema: form.schema,\n          values: form.responsesByFieldId,\n        },\n        message: `Exported form with ${form.schema.groups.length} group(s) and ${answeredCount} answered field(s).`,\n      });\n    },\n  };\n\n  // Build the toolset\n  const toolset: MarkformToolSet = {\n    markform_inspect,\n    markform_apply,\n    markform_export,\n  };\n\n  // Optionally include markform_get_markdown\n  if (includeGetMarkdown) {\n    const markform_get_markdown: MarkformTool<Record<string, never>, GetMarkdownToolResult> = {\n      description:\n        'Get the canonical Markdown representation of the current form. ' +\n        'Use this to see the complete form with all current values in Markform format. ' +\n        'The output is deterministic and round-trip safe.',\n      inputSchema: GetMarkdownInputSchema,\n      execute: () => {\n        const form = sessionStore.getForm();\n        const markdown = serializeForm(form);\n\n        return Promise.resolve({\n          success: true,\n          data: {\n            markdown,\n          },\n          message: `Generated Markdown (${markdown.length} characters).`,\n        });\n      },\n    };\n\n    toolset.markform_get_markdown = markform_get_markdown;\n  }\n\n  return toolset;\n}\n\n// =============================================================================\n// Convenience Exports\n// =============================================================================\n\nexport { PatchSchema } from '../engine/coreTypes.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,IAAa,uBAAb,MAAkC;CAChC,AAAQ;CACR,AAAQ;CAER,YAAY,MAAkB,mBAAuC;AACnE,OAAK,OAAO;AACZ,OAAK,oBAAoB,qBAAqB,EAAE;;;;;CAMlD,UAAsB;AACpB,SAAO,KAAK;;;;;CAMd,uBAA0C;AACxC,SAAO,KAAK;;;;;CAMd,WAAW,MAAwB;AACjC,OAAK,OAAO;;;;;;AAsDhB,MAAM,qBAAqB,EACxB,OAAO,EAAE,CAAC,CACV,SAAS,kFAAkF;;;;AAK9F,MAAM,mBAAmB,EACtB,OAAO,EACN,SAAS,EACN,MAAM,YAAY,CAClB,IAAI,EAAE,CACN,IAAI,GAAG,CACP,SACC,2WAID,EACJ,CAAC,CACD,SAAS,6CAA6C;;;;AAKzD,MAAM,oBAAoB,EACvB,OAAO,EAAE,CAAC,CACV,SACC,qGACD;;;;AAKH,MAAM,yBAAyB,EAC5B,OAAO,EAAE,CAAC,CACV,SACC,iHACD;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BH,SAAgB,oBAAoB,SAAsD;CACxF,MAAM,EAAE,cAAc,qBAAqB,SAAS;CA2FpD,MAAM,UAA2B;EAC/B,kBAzF+E;GAC/E,aACE;GAGF,aAAa;GACb,eAAe;IAEb,MAAM,SAAS,QADF,aAAa,SAAS,CACP;IAE5B,MAAM,gBAAgB,OAAO,OAAO,QAAQ,MAAM,EAAE,aAAa,WAAW,CAAC;IAC7E,MAAM,UAAU,OAAO,aACnB,sDACA,YAAY,cAAc;AAE9B,WAAO,QAAQ,QAAQ;KACrB,SAAS;KACT,MAAM;KACN;KACD,CAAC;;GAEL;EAqEC,gBAlE0E;GAC1E,aACE;GAKF,aAAa;GACb,UAAU,EAAE,cAAc;IACxB,MAAM,OAAO,aAAa,SAAS;IACnC,MAAM,SAAS,aAAa,MAAM,QAAQ;AAG1C,iBAAa,WAAW,KAAK;IAE7B,MAAM,cAAc,OAAO,SAAS,SAAS,IAAI,KAAK,OAAO,SAAS,OAAO,aAAa;IAC1F,MAAM,YAAY,OAAO,OAAO,QAAQ,MAAM,EAAE,aAAa,WAAW,CAAC;IAEzE,MAAM,UACJ,OAAO,gBAAgB,YACnB,WAAW,QAAQ,OAAO,YAAY,YAAY,IAChD,OAAO,aACH,0BACA,GAAG,UAAU,mCAEnB,OAAO,gBAAgB,YACrB,WAAW,OAAO,eAAe,OAAO,GAAG,QAAQ,OAAO,UAAU,YAAY,IAC7E,OAAO,gBAAgB,OAAO,cACjC;AAER,WAAO,QAAQ,QAAQ;KACrB,SAAS,OAAO,gBAAgB;KAChC,MAAM;KACN;KACD,CAAC;;GAEL;EA+BC,iBA5B6E;GAC7E,aACE;GAEF,aAAa;GACb,eAAe;IACb,MAAM,OAAO,aAAa,SAAS;IAGnC,MAAM,gBAAgB,OAAO,OAAO,KAAK,mBAAmB,CAAC,QAC1D,aAAa,SAAS,UAAU,WAClC,CAAC;AAEF,WAAO,QAAQ,QAAQ;KACrB,SAAS;KACT,MAAM;MACJ,QAAQ,KAAK;MACb,QAAQ,KAAK;MACd;KACD,SAAS,sBAAsB,KAAK,OAAO,OAAO,OAAO,gBAAgB,cAAc;KACxF,CAAC;;GAEL;EAOA;AAGD,KAAI,mBAqBF,SAAQ,wBApBkF;EACxF,aACE;EAGF,aAAa;EACb,eAAe;GAEb,MAAM,WAAW,cADJ,aAAa,SAAS,CACC;AAEpC,UAAO,QAAQ,QAAQ;IACrB,SAAS;IACT,MAAM,EACJ,UACD;IACD,SAAS,uBAAuB,SAAS,OAAO;IACjD,CAAC;;EAEL;AAKH,QAAO"}

package/dist/{apply-BYgtU64w.mjs → apply-Dalpt-D6.mjs}

@@ -2,7 +2,7 @@
 import YAML from "yaml";
 
 //#region src/errors.ts
-const VERSION = "0.1.18";
+const VERSION = "0.1.19";
 /**
 * Base error class for all markform errors.
 * Consumers can catch this to handle any markform error.
@@ -472,6 +472,327 @@ function deriveSchemaPath(basePath) {
 	return base + SCHEMA_EXTENSION;
 }
 
+//#endregion
+//#region src/engine/parseHelpers.ts
+/** Map checkbox marker to state value */
+const CHECKBOX_MARKERS = {
+	"[ ]": "todo",
+	"[x]": "done",
+	"[X]": "done",
+	"[/]": "incomplete",
+	"[*]": "active",
+	"[-]": "na",
+	"[y]": "yes",
+	"[Y]": "yes",
+	"[n]": "no",
+	"[N]": "no"
+};
+const OPTION_TEXT_PATTERN = /^(\[[^\]]\])\s*(.*?)\s*$/;
+/**
+* Parse option text to extract marker and label.
+* Text is like "[ ] Label" or "[x] Label".
+*/
+function parseOptionText(text) {
+	const match = OPTION_TEXT_PATTERN.exec(text);
+	if (!match) return null;
+	return {
+		marker: match[1] ?? "",
+		label: (match[2] ?? "").trim()
+	};
+}
+/**
+* Check if a node is a tag node with specific name.
+* Works with raw AST nodes (not transformed Tags).
+*/
+function isTagNode(node, name) {
+	if (typeof node !== "object" || node === null) return false;
+	if (node.type === "tag" && node.tag) return name === void 0 || node.tag === name;
+	return false;
+}
+/**
+* Get string attribute value or undefined.
+*/
+function getStringAttr(node, name) {
+	const value = node.attributes?.[name];
+	return typeof value === "string" ? value : void 0;
+}
+/**
+* Get number attribute value or undefined.
+*/
+function getNumberAttr(node, name) {
+	const value = node.attributes?.[name];
+	return typeof value === "number" ? value : void 0;
+}
+/**
+* Get boolean attribute value or undefined.
+*/
+function getBooleanAttr(node, name) {
+	const value = node.attributes?.[name];
+	return typeof value === "boolean" ? value : void 0;
+}
+/**
+* Get validator references from validate attribute.
+* Handles both single string and array formats.
+*/
+function getValidateAttr(node) {
+	const value = node.attributes?.validate;
+	if (value === void 0 || value === null) return;
+	if (Array.isArray(value)) return value;
+	if (typeof value === "string") return [value];
+	if (typeof value === "object") return [value];
+}
+/**
+* Get string array attribute value or undefined.
+* Handles both single string (converts to array) and array formats.
+*/
+function getStringArrayAttr(node, name) {
+	const value = node.attributes?.[name];
+	if (value === void 0 || value === null) return;
+	if (Array.isArray(value)) {
+		const strings = value.filter((v) => typeof v === "string");
+		return strings.length > 0 ? strings : void 0;
+	}
+	if (typeof value === "string") return [value];
+}
+/**
+* Extract option items from node children (for option lists).
+* Works with raw AST nodes. Collects text and ID from list items.
+*/
+function extractOptionItems(node) {
+	const items = [];
+	/**
+	* Collect all text content from a node tree into a single string.
+	*/
+	function collectText(n) {
+		let text = "";
+		if (n.type === "text" && typeof n.attributes?.content === "string") text += n.attributes.content;
+		if (n.type === "softbreak") text += "\n";
+		if (n.children && Array.isArray(n.children)) for (const c of n.children) text += collectText(c);
+		return text;
+	}
+	/**
+	* Traverse to find list items and extract their content.
+	*/
+	function traverse(child) {
+		if (!child || typeof child !== "object") return;
+		if (child.type === "item") {
+			const text = collectText(child);
+			let id = null;
+			if (typeof child.attributes?.id === "string") id = child.attributes.id;
+			else if (child.children && Array.isArray(child.children) && child.children.length > 0 && typeof child.children[0]?.attributes?.id === "string") id = child.children[0].attributes.id;
+			if (text.trim()) items.push({
+				id,
+				text: text.trim()
+			});
+			return;
+		}
+		if (child.children && Array.isArray(child.children)) for (const c of child.children) traverse(c);
+	}
+	if (node.children && Array.isArray(node.children)) for (const child of node.children) traverse(child);
+	return items;
+}
+/**
+* Extract fence value from node children.
+* Looks for ```value code blocks.
+*/
+function extractFenceValue(node) {
+	function traverse(child) {
+		if (!child || typeof child !== "object") return null;
+		if (child.type === "fence") {
+			if (child.attributes?.language === "value") return typeof child.attributes?.content === "string" ? child.attributes.content : null;
+		}
+		if (child.children && Array.isArray(child.children)) for (const c of child.children) {
+			const result = traverse(c);
+			if (result !== null) return result;
+		}
+		return null;
+	}
+	if (node.children && Array.isArray(node.children)) for (const child of node.children) {
+		const result = traverse(child);
+		if (result !== null) return result;
+	}
+	return null;
+}
+/**
+* Extract table content from node children.
+* Handles both raw text and Markdoc-parsed table nodes.
+* Reconstructs markdown table format from the AST.
+*/
+function extractTableContent(node) {
+	const lines = [];
+	function extractTextFromNode(n) {
+		if (!n || typeof n !== "object") return "";
+		if (n.type === "text" && typeof n.attributes?.content === "string") return n.attributes.content;
+		if (n.children && Array.isArray(n.children)) return n.children.map(extractTextFromNode).join("");
+		return "";
+	}
+	function extractTableRow(trNode) {
+		if (!trNode.children || !Array.isArray(trNode.children)) return "";
+		return `| ${trNode.children.filter((c) => c.type === "th" || c.type === "td").map((c) => extractTextFromNode(c).trim()).join(" | ")} |`;
+	}
+	function processNode(child) {
+		if (!child || typeof child !== "object") return;
+		if (child.type === "paragraph" || child.type === "inline") {
+			const text = extractTextFromNode(child).trim();
+			if (text) lines.push(text);
+			return;
+		}
+		if (child.type === "text" && typeof child.attributes?.content === "string") {
+			const text = child.attributes.content.trim();
+			if (text) lines.push(text);
+			return;
+		}
+		if (child.type === "table") {
+			const thead = child.children?.find((c) => c.type === "thead");
+			if (thead?.children) for (const tr of thead.children.filter((c) => c.type === "tr")) lines.push(extractTableRow(tr));
+			if (thead?.children?.length) {
+				const firstTr = thead.children.find((c) => c.type === "tr");
+				if (firstTr?.children) {
+					const colCount = firstTr.children.filter((c) => c.type === "th" || c.type === "td").length;
+					const separatorCells = Array(colCount).fill("----");
+					lines.push(`| ${separatorCells.join(" | ")} |`);
+				}
+			}
+			const tbody = child.children?.find((c) => c.type === "tbody");
+			if (tbody?.children) for (const tr of tbody.children.filter((c) => c.type === "tr")) lines.push(extractTableRow(tr));
+			return;
+		}
+		if (child.children && Array.isArray(child.children)) for (const c of child.children) processNode(c);
+	}
+	if (node.children && Array.isArray(node.children)) for (const child of node.children) processNode(child);
+	return lines.join("\n").trim() || null;
+}
+
+//#endregion
+//#region src/engine/parseSentinels.ts
+/** Sentinel values for text fields */
+const SENTINEL_SKIP = "%SKIP%";
+const SENTINEL_ABORT = "%ABORT%";
+/**
+* Detect if a value contains a sentinel pattern (%SKIP% or %ABORT%).
+*
+* This is the shared low-level detection function used for:
+* - Form parsing validation (strict format)
+* - Patch value validation (reject embedded sentinels)
+* - Table cell parsing (convert to skipped/aborted state)
+*
+* Supports multiple formats that LLMs might generate:
+* - `%SKIP%` or `%skip%` (case-insensitive)
+* - `%SKIP% (reason)` - canonical format
+* - `%SKIP:reason%` or `%SKIP(reason)%` - compact formats
+*
+* @param value - The value to check (returns null for non-strings)
+* @returns Detected sentinel type and optional reason, or null if no sentinel
+*/
+function detectSentinel(value) {
+	if (value == null || typeof value !== "string") return null;
+	const trimmed = value.trim();
+	const compactSkipMatch = /^%SKIP(?:[:(](.*?))?[)]?%$/i.exec(trimmed);
+	if (compactSkipMatch) {
+		const reason = compactSkipMatch[1]?.trim();
+		return {
+			type: "skip",
+			...reason && { reason }
+		};
+	}
+	const compactAbortMatch = /^%ABORT(?:[:(](.*?))?[)]?%$/i.exec(trimmed);
+	if (compactAbortMatch) {
+		const reason = compactAbortMatch[1]?.trim();
+		return {
+			type: "abort",
+			...reason && { reason }
+		};
+	}
+	const upper = trimmed.toUpperCase();
+	if (upper.startsWith("%SKIP%")) {
+		const rest = trimmed.slice(6).trim();
+		if (rest === "") return { type: "skip" };
+		const reasonMatch = /^\((.+)\)$/s.exec(rest);
+		if (reasonMatch?.[1]) return {
+			type: "skip",
+			reason: reasonMatch[1].trim()
+		};
+		return { type: "skip" };
+	}
+	if (upper.startsWith("%ABORT%")) {
+		const rest = trimmed.slice(7).trim();
+		if (rest === "") return { type: "abort" };
+		const reasonMatch = /^\((.+)\)$/s.exec(rest);
+		if (reasonMatch?.[1]) return {
+			type: "abort",
+			reason: reasonMatch[1].trim()
+		};
+		return { type: "abort" };
+	}
+	return null;
+}
+/**
+* Parse a sentinel value with optional parenthesized reason (strict format).
+*
+* This is the strict parser used during form parsing, where we want to
+* validate the exact format. For patch validation, use detectSentinel().
+*
+* Formats: `%SKIP%`, `%SKIP% (reason text)`, `%ABORT%`, `%ABORT% (reason text)`
+* Returns null if the content is not a valid sentinel format.
+*/
+function parseSentinel(content) {
+	if (!content) return null;
+	const trimmed = content.trim();
+	const reasonPattern = /^\((.+)\)$/s;
+	if (trimmed.startsWith(SENTINEL_SKIP)) {
+		const rest = trimmed.slice(6).trim();
+		if (rest === "") return { type: "skip" };
+		const match = reasonPattern.exec(rest);
+		if (match?.[1]) return {
+			type: "skip",
+			reason: match[1].trim()
+		};
+		return null;
+	}
+	if (trimmed.startsWith(SENTINEL_ABORT)) {
+		const rest = trimmed.slice(7).trim();
+		if (rest === "") return { type: "abort" };
+		const match = reasonPattern.exec(rest);
+		if (match?.[1]) return {
+			type: "abort",
+			reason: match[1].trim()
+		};
+		return null;
+	}
+	return null;
+}
+/**
+* Check for sentinel values in fence content and validate against state attribute.
+* Handles the common pattern of checking for %SKIP% and %ABORT% sentinels in field values.
+*
+* @param node - The field node to check
+* @param fieldId - The field ID for error messages
+* @param required - Whether the field is required (skip not allowed on required fields)
+* @returns A FieldResponse if a sentinel is found, null otherwise
+*/
+function tryParseSentinelResponse(node, fieldId, required) {
+	const fenceContent = extractFenceValue(node);
+	const stateAttr = getStringAttr(node, "state");
+	const sentinel = parseSentinel(fenceContent);
+	if (!sentinel) return null;
+	if (sentinel.type === "skip") {
+		if (stateAttr !== void 0 && stateAttr !== "skipped") throw new MarkformParseError(`Field '${fieldId}' has conflicting state='${stateAttr}' with %SKIP% sentinel`);
+		if (required) throw new MarkformParseError(`Field '${fieldId}' is required but has %SKIP% sentinel. Cannot skip required fields.`);
+		return {
+			state: "skipped",
+			...sentinel.reason && { reason: sentinel.reason }
+		};
+	}
+	if (sentinel.type === "abort") {
+		if (stateAttr !== void 0 && stateAttr !== "aborted") throw new MarkformParseError(`Field '${fieldId}' has conflicting state='${stateAttr}' with %ABORT% sentinel`);
+		return {
+			state: "aborted",
+			...sentinel.reason && { reason: sentinel.reason }
+		};
+	}
+	return null;
+}
+
 //#endregion
 //#region src/engine/preprocess.ts
 const MARKFORM_TAGS = new Set([
@@ -508,10 +829,10 @@ function isValidFormTag(content) {
 	return trimmed.includes("=") && /\bid\s*=/.test(trimmed);
 }
 /** Parser state for tracking code blocks */
-var State = /* @__PURE__ */ function(State$1) {
-	State$1[State$1["NORMAL"] = 0] = "NORMAL";
-	State$1[State$1["FENCED_CODE"] = 1] = "FENCED_CODE";
-	return State$1;
+var State = /* @__PURE__ */ function(State) {
+	State[State["NORMAL"] = 0] = "NORMAL";
+	State[State["FENCED_CODE"] = 1] = "FENCED_CODE";
+	return State;
 }(State || {});
 /**
 * Check if position is at the start of a line (or at position 0).
@@ -992,6 +1313,33 @@ function friendlyUrlAbbrev(url, maxPathChars = 12) {
 function formatUrlAsMarkdownLink(url) {
 	return `[${friendlyUrlAbbrev(url)}](${url})`;
 }
+/**
+* Format bare URLs in text as HTML links with abbreviated display text.
+* Also handles markdown-style links [text](url) for consistency.
+*
+* Processing order:
+* 1. Escape all HTML to prevent XSS
+* 2. Convert markdown links [text](url) to <a> tags
+* 3. Convert bare URLs (not already in links) to <a> tags with abbreviated display
+*
+* @param text - The raw text containing URLs (will be HTML-escaped)
+* @param escapeHtml - Function to escape HTML entities
+* @returns HTML-safe text with URLs converted to <a> tags
+*/
+function formatBareUrlsAsHtmlLinks(text, escapeHtml) {
+	let result = escapeHtml(text);
+	result = result.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, linkText, url) => {
+		const cleanUrl = url.replace(/&amp;/g, "&");
+		return `<a href="${escapeHtml(cleanUrl)}" target="_blank" class="url-link" data-url="${escapeHtml(cleanUrl)}">${linkText}</a>`;
+	});
+	result = result.replace(/(?<!href="|data-url="|">)(?:https?:\/\/|www\.)[^\s<>"]+(?<![.,;:!?'")])/g, (url) => {
+		const cleanUrl = url.replace(/&amp;/g, "&");
+		const fullUrl = cleanUrl.startsWith("www.") ? `https://${cleanUrl}` : cleanUrl;
+		const display = friendlyUrlAbbrev(fullUrl);
+		return `<a href="${escapeHtml(fullUrl)}" target="_blank" class="url-link" data-url="${escapeHtml(fullUrl)}">${escapeHtml(display)}</a>`;
+	});
+	return result;
+}
 
 //#endregion
 //#region src/engine/serialize.ts
@@ -3549,6 +3897,16 @@ function typeMismatchError(index, op, field) {
 	};
 }
 /**
+* Create an error for embedded sentinel in patch value.
+*/
+function embeddedSentinelError(index, fieldId, sentinelType) {
+	return {
+		patchIndex: index,
+		message: `Value contains ${sentinelType === "skip" ? "%SKIP%" : "%ABORT%"} sentinel for field "${fieldId}". Use ${sentinelType === "skip" ? "skip_field" : "abort_field"} operation instead of embedding sentinel in value.`,
+		fieldId
+	};
+}
+/**
 * Validate a single patch against the form schema.
 */
 function validatePatch(form, patch, index) {
@@ -3573,6 +3931,10 @@ function validatePatch(form, patch, index) {
 	};
 	const expectedKind = PATCH_OP_TO_FIELD_KIND[patch.op];
 	if (expectedKind && field.kind !== expectedKind) return typeMismatchError(index, patch.op, field);
+	if (patch.op === "set_string" || patch.op === "set_url" || patch.op === "set_date") {
+		const sentinel = detectSentinel(patch.value);
+		if (sentinel) return embeddedSentinelError(index, field.id, sentinel.type);
+	}
 	if (patch.op === "set_string_list" && field.kind === "string_list") {
 		if (!Array.isArray(patch.value)) return {
 			patchIndex: index,
@@ -3580,6 +3942,10 @@ function validatePatch(form, patch, index) {
 			fieldId: field.id,
 			fieldKind: field.kind
 		};
+		for (const item of patch.value) {
+			const sentinel = detectSentinel(item);
+			if (sentinel) return embeddedSentinelError(index, field.id, sentinel.type);
+		}
 	} else if (patch.op === "set_single_select" && field.kind === "single_select") {
 		if (patch.value !== null) {
 			if (!new Set(field.options.map((o) => o.id)).has(patch.value)) return {
@@ -3618,6 +3984,10 @@ function validatePatch(form, patch, index) {
 			fieldId: field.id,
 			fieldKind: field.kind
 		};
+		for (const item of patch.value) {
+			const sentinel = detectSentinel(item);
+			if (sentinel) return embeddedSentinelError(index, field.id, sentinel.type);
+		}
 	} else if (patch.op === "set_table" && field.kind === "table") {
 		const columnIds = field.columns.map((c) => c.id);
 		if (!Array.isArray(patch.value)) return {
@@ -3702,23 +4072,18 @@ function setMultiSelectValue(responses, fieldId, selected) {
 */
 function patchValueToCell(value) {
 	if (value === null || value === void 0) return { state: "skipped" };
-	if (typeof value === "string") {
-		const trimmed = value.trim();
-		const skipMatch = /^%SKIP(?:[:(](.*))?[)]?%$/i.exec(trimmed);
-		if (skipMatch) return {
-			state: "skipped",
-			reason: skipMatch[1]
-		};
-		const abortMatch = /^%ABORT(?:[:(](.*))?[)]?%$/i.exec(trimmed);
-		if (abortMatch) return {
-			state: "aborted",
-			reason: abortMatch[1]
-		};
-		return {
-			state: "answered",
-			value: trimmed
-		};
-	}
+	const sentinel = detectSentinel(value);
+	if (sentinel) return sentinel.type === "skip" ? {
+		state: "skipped",
+		...sentinel.reason && { reason: sentinel.reason }
+	} : {
+		state: "aborted",
+		...sentinel.reason && { reason: sentinel.reason }
+	};
+	if (typeof value === "string") return {
+		state: "answered",
+		value: value.trim()
+	};
 	return {
 		state: "answered",
 		value
@@ -3859,15 +4224,15 @@ function applyPatches(form, patches) {
 		}
 	}
 	if (validPatches.length === 0 && errors.length > 0) {
-		const issues$1 = convertToInspectIssues(form);
-		const summaries$1 = computeAllSummaries(form.schema, form.responsesByFieldId, form.notes, issues$1);
+		const issues = convertToInspectIssues(form);
+		const summaries = computeAllSummaries(form.schema, form.responsesByFieldId, form.notes, issues);
 		return {
 			applyStatus: "rejected",
-			structureSummary: summaries$1.structureSummary,
-			progressSummary: summaries$1.progressSummary,
-			issues: issues$1,
-			isComplete: summaries$1.isComplete,
-			formState: summaries$1.formState,
+			structureSummary: summaries.structureSummary,
+			progressSummary: summaries.progressSummary,
+			issues,
+			isComplete: summaries.isComplete,
+			formState: summaries.formState,
 			appliedPatches: [],
 			rejectedPatches: errors,
 			warnings: []
@@ -3894,5 +4259,5 @@ function applyPatches(form, patches) {
 }
 
 //#endregion
-export { isAbortError as $, DEFAULT_ROLE_INSTRUCTIONS as A, WEB_SEARCH_CONFIG as B, DEFAULT_MAX_STEPS_PER_TURN as C, DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN as D, DEFAULT_PRIORITY as E, deriveReportPath as F, MarkformAbortError as G, getWebSearchConfig as H, deriveSchemaPath as I, MarkformLlmError as J, MarkformConfigError as K, detectFileType as L, REPORT_EXTENSION as M, USER_ROLE as N, DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN as O, deriveExportPath as P, ParseError as Q, parseRolesFlag as R, DEFAULT_MAX_PATCHES_PER_TURN as S, DEFAULT_PORT as T, hasWebSearchSupport as U, formatSuggestedLlms as V, parseModelIdForDisplay as W, MarkformPatchError as X, MarkformParseError as Y, MarkformValidationError as Z, validateSyntaxConsistency as _, validate as a, isRetryableError as at, DEFAULT_MAX_ISSUES_PER_TURN as b, computeProgressSummary as c, serializeForm as d, isConfigError as et, serializeRawMarkdown as f, preprocessCommentSyntax as g, detectSyntaxStyle as h, inspect as i, isPatchError as it, MAX_FORMS_IN_MENU as j, DEFAULT_ROLES as k, computeStructureSummary as l, friendlyUrlAbbrev as m, getAllFields as n, isMarkformError as nt, computeAllSummaries as o, isValidationError as ot, serializeReport as p, MarkformError as q, getFieldsForRoles as r, isParseError as rt, computeFormState as s, applyPatches as t, isLlmError as tt, isFormComplete as u, AGENT_ROLE as v, DEFAULT_MAX_TURNS as w, DEFAULT_MAX_PARALLEL_AGENTS as x, DEFAULT_FORMS_DIR as y, SUGGESTED_LLMS as z };
-//# sourceMappingURL=apply-BYgtU64w.mjs.map
+export { WEB_SEARCH_CONFIG as $, parseOptionText as A, DEFAULT_RESEARCH_MAX_ISSUES_PER_TURN as B, extractTableContent as C, getStringAttr as D, getStringArrayAttr as E, DEFAULT_MAX_PATCHES_PER_TURN as F, REPORT_EXTENSION as G, DEFAULT_ROLES as H, DEFAULT_MAX_STEPS_PER_TURN as I, deriveReportPath as J, USER_ROLE as K, DEFAULT_MAX_TURNS as L, DEFAULT_FORMS_DIR as M, DEFAULT_MAX_ISSUES_PER_TURN as N, getValidateAttr as O, DEFAULT_MAX_PARALLEL_AGENTS as P, SUGGESTED_LLMS as Q, DEFAULT_PORT as R, extractOptionItems as S, getNumberAttr as T, DEFAULT_ROLE_INSTRUCTIONS as U, DEFAULT_RESEARCH_MAX_PATCHES_PER_TURN as V, MAX_FORMS_IN_MENU as W, detectFileType as X, deriveSchemaPath as Y, parseRolesFlag as Z, preprocessCommentSyntax as _, isPatchError as _t, validate as a, MarkformConfigError as at, CHECKBOX_MARKERS as b, computeProgressSummary as c, MarkformParseError as ct, serializeForm as d, ParseError as dt, formatSuggestedLlms as et, serializeRawMarkdown as f, isAbortError as ft, detectSyntaxStyle as g, isParseError as gt, friendlyUrlAbbrev as h, isMarkformError as ht, inspect as i, MarkformAbortError as it, AGENT_ROLE as j, isTagNode as k, computeStructureSummary as l, MarkformPatchError as lt, formatBareUrlsAsHtmlLinks as m, isLlmError as mt, getAllFields as n, hasWebSearchSupport as nt, computeAllSummaries as o, MarkformError as ot, serializeReport as p, isConfigError as pt, deriveExportPath as q, getFieldsForRoles as r, parseModelIdForDisplay as rt, computeFormState as s, MarkformLlmError as st, applyPatches as t, getWebSearchConfig as tt, isFormComplete as u, MarkformValidationError as ut, validateSyntaxConsistency as v, isRetryableError as vt, getBooleanAttr as w, extractFenceValue as x, tryParseSentinelResponse as y, isValidationError as yt, DEFAULT_PRIORITY as z };
+//# sourceMappingURL=apply-Dalpt-D6.mjs.map