markform 0.0.1 → 0.1.1

package/examples/startup-research/startup-research-mock-filled.form.md

@@ -0,0 +1,307 @@
+---
+markform:
+  markform_version: "0.1.0"
+  roles:
+    - user
+    - agent
+  role_instructions:
+    user: "Enter the name of the startup company you want to research."
+    agent: |
+      Research and fill in all company information for the specified startup.
+      Guidelines:
+      1. Start with Crunchbase - The company's Crunchbase page is the primary source
+      2. Verify with company website and press releases
+      3. Use official formats - Dates as YYYY-MM-DD, funding as USD amounts
+      4. Fill funding rounds chronologically - Most recent first
+      5. Include all relevant URLs - Website, LinkedIn, press coverage
+      6. Leave unknown fields empty - Don't guess or fabricate information
+      7. Keep descriptions concise - Aim for 100-200 words max
+---
+
+{% form id="startup_research" title="Startup Research Form" %}
+
+{% description ref="startup_research" %}
+A comprehensive research form for startup companies. This form demonstrates URL field types
+for capturing company websites, funding sources, press coverage, and other web references.
+The user provides the company name, and the agent researches and fills all remaining fields.
+{% /description %}
+
+{% documentation ref="startup_research" %}
+**Workflow:**
+1. User enters the startup company name
+2. Agent researches and fills company information
+3. Agent includes all relevant URLs (website, LinkedIn, press, funding sources)
+4. Agent provides source citations
+
+**Data Sources:**
+- Crunchbase profiles
+- Company websites
+- Press releases
+- LinkedIn company pages
+- Tech news publications
+{% /documentation %}
+
+{% field-group id="basic_info" title="Company Information" %}
+
+{% string-field id="company_name" label="Company Name" role="user" required=true minLength=2 maxLength=200 %}
+```value
+Anthropic
+```
+{% /string-field %}
+
+{% instructions ref="company_name" %}
+Enter the official name of the startup company you want to research (e.g., "Stripe", "OpenAI").
+{% /instructions %}
+
+{% url-field id="company_website" label="Company Website" required=true %}
+```value
+https://www.anthropic.com
+```
+{% /url-field %}
+
+{% instructions ref="company_website" %}
+The official company website URL.
+{% /instructions %}
+
+{% url-field id="linkedin_page" label="LinkedIn Company Page" %}
+```value
+https://www.linkedin.com/company/anthropic
+```
+{% /url-field %}
+
+{% instructions ref="linkedin_page" %}
+LinkedIn company page URL if available.
+{% /instructions %}
+
+{% string-field id="founded_date" label="Founded Date" pattern="^\\d{4}(-\\d{2}(-\\d{2})?)?$" %}
+```value
+2021
+```
+{% /string-field %}
+
+{% instructions ref="founded_date" %}
+Format: YYYY, YYYY-MM, or YYYY-MM-DD (e.g., 2010, 2010-06, 2010-06-15)
+{% /instructions %}
+
+{% string-field id="headquarters" label="Headquarters Location" %}
+```value
+San Francisco, California
+```
+{% /string-field %}
+
+{% instructions ref="headquarters" %}
+Format: City, State/Country (e.g., "San Francisco, California")
+{% /instructions %}
+
+{% string-field id="company_description" label="Company Description" multiline=true maxLength=1000 %}
+```value
+Anthropic is an AI safety company focused on building reliable, interpretable, and steerable AI systems. Founded by former members of OpenAI, the company develops large language models with an emphasis on safety research and alignment. Their flagship product is Claude, an AI assistant designed to be helpful, harmless, and honest.
+```
+{% /string-field %}
+
+{% instructions ref="company_description" %}
+Brief description of what the company does. 100-200 words max.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="funding_info" title="Funding Information" %}
+
+{% string-field id="total_funding" label="Total Funding Raised" pattern="^\\$[0-9]+(\\.[0-9]+)?(K|M|B)?$" %}
+```value
+$7.6B
+```
+{% /string-field %}
+
+{% instructions ref="total_funding" %}
+Format: $X.XB, $XXM, or $XXK (e.g., "$1.5B", "$50M", "$500K")
+{% /instructions %}
+
+{% string-field id="latest_valuation" label="Latest Valuation" pattern="^\\$[0-9]+(\\.[0-9]+)?(K|M|B)?$" %}
+```value
+$18.4B
+```
+{% /string-field %}
+
+{% instructions ref="latest_valuation" %}
+Format: $X.XB, $XXM, or $XXK (e.g., "$10B")
+{% /instructions %}
+
+{% single-select id="funding_stage" label="Funding Stage" %}
+- [ ] Pre-seed {% #pre_seed %}
+- [ ] Seed {% #seed %}
+- [ ] Series A {% #series_a %}
+- [ ] Series B {% #series_b %}
+- [ ] Series C {% #series_c %}
+- [x] Series D+ {% #series_d_plus %}
+- [ ] Public {% #public %}
+{% /single-select %}
+
+{% string-list id="key_investors" label="Key Investors" maxItems=10 %}
+```value
+Google
+Spark Capital
+Salesforce Ventures
+Amazon
+Sound Ventures
+```
+{% /string-list %}
+
+{% instructions ref="key_investors" %}
+List notable investors (VCs, angels), one per line.
+{% /instructions %}
+
+{% url-list id="funding_announcements" label="Funding Announcement URLs" maxItems=5 uniqueItems=true %}
+```value
+https://www.anthropic.com/news/anthropic-raises-series-c
+https://techcrunch.com/2023/09/25/amazon-to-invest-up-to-4-billion-in-anthropic/
+```
+{% /url-list %}
+
+{% instructions ref="funding_announcements" %}
+URLs to press releases or articles about funding rounds.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="people" title="Key People" %}
+
+{% string-field id="ceo" label="CEO / Founder" %}
+```value
+Dario Amodei
+```
+{% /string-field %}
+
+{% instructions ref="ceo" %}
+Name of CEO or primary founder.
+{% /instructions %}
+
+{% url-field id="ceo_linkedin" label="CEO LinkedIn" %}
+```value
+https://www.linkedin.com/in/dario-amodei
+```
+{% /url-field %}
+
+{% instructions ref="ceo_linkedin" %}
+LinkedIn profile URL of the CEO/founder.
+{% /instructions %}
+
+{% string-list id="founders" label="Founders" maxItems=5 %}
+```value
+Dario Amodei
+Daniela Amodei
+Tom Brown
+Chris Olah
+Sam McCandlish
+```
+{% /string-list %}
+
+{% instructions ref="founders" %}
+List all founders, one per line.
+{% /instructions %}
+
+{% number-field id="employee_count" label="Employee Count" min=1 integer=true %}
+```value
+1000
+```
+{% /number-field %}
+
+{% instructions ref="employee_count" %}
+Approximate number of employees.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="market_info" title="Market & Industry" %}
+
+{% multi-select id="industry_sectors" label="Industry Sectors" minSelections=1 maxSelections=5 %}
+- [x] AI/ML {% #ai_ml %}
+- [ ] FinTech {% #fintech %}
+- [ ] HealthTech {% #healthtech %}
+- [ ] EdTech {% #edtech %}
+- [x] SaaS {% #saas %}
+- [ ] E-commerce {% #ecommerce %}
+- [x] Security {% #security %}
+- [x] Developer Tools {% #devtools %}
+- [ ] Climate Tech {% #climatetech %}
+- [ ] Other {% #other %}
+{% /multi-select %}
+
+{% string-list id="competitors" label="Competitors" maxItems=5 %}
+```value
+OpenAI
+Google DeepMind
+Cohere
+Mistral AI
+```
+{% /string-list %}
+
+{% instructions ref="competitors" %}
+List main competitors, one per line.
+{% /instructions %}
+
+{% url-list id="competitor_urls" label="Competitor Website URLs" maxItems=5 uniqueItems=true %}
+```value
+https://openai.com
+https://deepmind.google
+https://cohere.com
+https://mistral.ai
+```
+{% /url-list %}
+
+{% instructions ref="competitor_urls" %}
+Website URLs of main competitors.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="press_coverage" title="Press & Coverage" %}
+
+{% url-list id="press_articles" label="Press Coverage URLs" minItems=1 maxItems=10 uniqueItems=true %}
+```value
+https://www.wired.com/story/anthropic-ai-claude-chatgpt-rival/
+https://www.nytimes.com/2023/03/14/technology/anthropic-ai-chatbot.html
+https://www.forbes.com/sites/alexkonrad/2023/09/25/anthropic-ai-amazon-investment/
+```
+{% /url-list %}
+
+{% instructions ref="press_articles" %}
+URLs to major press articles, reviews, or coverage about the company.
+{% /instructions %}
+
+{% url-field id="crunchbase_url" label="Crunchbase Profile" %}
+```value
+https://www.crunchbase.com/organization/anthropic
+```
+{% /url-field %}
+
+{% instructions ref="crunchbase_url" %}
+Crunchbase company profile URL.
+{% /instructions %}
+
+{% url-field id="pitchbook_url" label="PitchBook Profile" %}{% /url-field %}
+
+{% instructions ref="pitchbook_url" %}
+PitchBook company profile URL if available.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="sources_section" title="Research Sources" %}
+
+{% url-list id="sources" label="Source URLs" minItems=1 uniqueItems=true %}
+```value
+https://www.crunchbase.com/organization/anthropic
+https://www.anthropic.com
+https://www.linkedin.com/company/anthropic
+https://en.wikipedia.org/wiki/Anthropic
+```
+{% /url-list %}
+
+{% instructions ref="sources" %}
+List all source URLs used for this research. Include Crunchbase, company website, and any additional sources consulted.
+{% /instructions %}
+
+{% /field-group %}
+
+{% /form %}

package/examples/startup-research/startup-research.form.md

@@ -0,0 +1,211 @@
+---
+markform:
+  markform_version: "0.1.0"
+  roles:
+    - user
+    - agent
+  role_instructions:
+    user: "Enter the name of the startup company you want to research."
+    agent: |
+      Research and fill in all company information for the specified startup.
+      Guidelines:
+      1. Start with Crunchbase - The company's Crunchbase page is the primary source
+      2. Verify with company website and press releases
+      3. Use official formats - Dates as YYYY-MM-DD, funding as USD amounts
+      4. Fill funding rounds chronologically - Most recent first
+      5. Include all relevant URLs - Website, LinkedIn, press coverage
+      6. Leave unknown fields empty - Don't guess or fabricate information
+      7. Keep descriptions concise - Aim for 100-200 words max
+---
+
+{% form id="startup_research" title="Startup Research Form" %}
+
+{% description ref="startup_research" %}
+A comprehensive research form for startup companies. This form demonstrates URL field types
+for capturing company websites, funding sources, press coverage, and other web references.
+The user provides the company name, and the agent researches and fills all remaining fields.
+{% /description %}
+
+{% documentation ref="startup_research" %}
+**Workflow:**
+1. User enters the startup company name
+2. Agent researches and fills company information
+3. Agent includes all relevant URLs (website, LinkedIn, press, funding sources)
+4. Agent provides source citations
+
+**Data Sources:**
+- Crunchbase profiles
+- Company websites
+- Press releases
+- LinkedIn company pages
+- Tech news publications
+{% /documentation %}
+
+{% field-group id="basic_info" title="Company Information" %}
+
+{% string-field id="company_name" label="Company Name" role="user" required=true minLength=2 maxLength=200 %}{% /string-field %}
+
+{% instructions ref="company_name" %}
+Enter the official name of the startup company you want to research (e.g., "Stripe", "OpenAI").
+{% /instructions %}
+
+{% url-field id="company_website" label="Company Website" required=true %}{% /url-field %}
+
+{% instructions ref="company_website" %}
+The official company website URL.
+{% /instructions %}
+
+{% url-field id="linkedin_page" label="LinkedIn Company Page" %}{% /url-field %}
+
+{% instructions ref="linkedin_page" %}
+LinkedIn company page URL if available.
+{% /instructions %}
+
+{% string-field id="founded_date" label="Founded Date" pattern="^\\d{4}(-\\d{2}(-\\d{2})?)?$" %}{% /string-field %}
+
+{% instructions ref="founded_date" %}
+Format: YYYY, YYYY-MM, or YYYY-MM-DD (e.g., 2010, 2010-06, 2010-06-15)
+{% /instructions %}
+
+{% string-field id="headquarters" label="Headquarters Location" %}{% /string-field %}
+
+{% instructions ref="headquarters" %}
+Format: City, State/Country (e.g., "San Francisco, California")
+{% /instructions %}
+
+{% string-field id="company_description" label="Company Description" multiline=true maxLength=1000 %}{% /string-field %}
+
+{% instructions ref="company_description" %}
+Brief description of what the company does. 100-200 words max.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="funding_info" title="Funding Information" %}
+
+{% string-field id="total_funding" label="Total Funding Raised" pattern="^\\$[0-9]+(\\.[0-9]+)?(K|M|B)?$" %}{% /string-field %}
+
+{% instructions ref="total_funding" %}
+Format: $X.XB, $XXM, or $XXK (e.g., "$1.5B", "$50M", "$500K")
+{% /instructions %}
+
+{% string-field id="latest_valuation" label="Latest Valuation" pattern="^\\$[0-9]+(\\.[0-9]+)?(K|M|B)?$" %}{% /string-field %}
+
+{% instructions ref="latest_valuation" %}
+Format: $X.XB, $XXM, or $XXK (e.g., "$10B")
+{% /instructions %}
+
+{% single-select id="funding_stage" label="Funding Stage" %}
+- [ ] Pre-seed {% #pre_seed %}
+- [ ] Seed {% #seed %}
+- [ ] Series A {% #series_a %}
+- [ ] Series B {% #series_b %}
+- [ ] Series C {% #series_c %}
+- [ ] Series D+ {% #series_d_plus %}
+- [ ] Public {% #public %}
+{% /single-select %}
+
+{% string-list id="key_investors" label="Key Investors" maxItems=10 %}{% /string-list %}
+
+{% instructions ref="key_investors" %}
+List notable investors (VCs, angels), one per line.
+{% /instructions %}
+
+{% url-list id="funding_announcements" label="Funding Announcement URLs" maxItems=5 uniqueItems=true %}{% /url-list %}
+
+{% instructions ref="funding_announcements" %}
+URLs to press releases or articles about funding rounds.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="people" title="Key People" %}
+
+{% string-field id="ceo" label="CEO / Founder" %}{% /string-field %}
+
+{% instructions ref="ceo" %}
+Name of CEO or primary founder.
+{% /instructions %}
+
+{% url-field id="ceo_linkedin" label="CEO LinkedIn" %}{% /url-field %}
+
+{% instructions ref="ceo_linkedin" %}
+LinkedIn profile URL of the CEO/founder.
+{% /instructions %}
+
+{% string-list id="founders" label="Founders" maxItems=5 %}{% /string-list %}
+
+{% instructions ref="founders" %}
+List all founders, one per line.
+{% /instructions %}
+
+{% number-field id="employee_count" label="Employee Count" min=1 integer=true %}{% /number-field %}
+
+{% instructions ref="employee_count" %}
+Approximate number of employees.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="market_info" title="Market & Industry" %}
+
+{% multi-select id="industry_sectors" label="Industry Sectors" minSelections=1 maxSelections=5 %}
+- [ ] AI/ML {% #ai_ml %}
+- [ ] FinTech {% #fintech %}
+- [ ] HealthTech {% #healthtech %}
+- [ ] EdTech {% #edtech %}
+- [ ] SaaS {% #saas %}
+- [ ] E-commerce {% #ecommerce %}
+- [ ] Security {% #security %}
+- [ ] Developer Tools {% #devtools %}
+- [ ] Climate Tech {% #climatetech %}
+- [ ] Other {% #other %}
+{% /multi-select %}
+
+{% string-list id="competitors" label="Competitors" maxItems=5 %}{% /string-list %}
+
+{% instructions ref="competitors" %}
+List main competitors, one per line.
+{% /instructions %}
+
+{% url-list id="competitor_urls" label="Competitor Website URLs" maxItems=5 uniqueItems=true %}{% /url-list %}
+
+{% instructions ref="competitor_urls" %}
+Website URLs of main competitors.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="press_coverage" title="Press & Coverage" %}
+
+{% url-list id="press_articles" label="Press Coverage URLs" minItems=1 maxItems=10 uniqueItems=true %}{% /url-list %}
+
+{% instructions ref="press_articles" %}
+URLs to major press articles, reviews, or coverage about the company.
+{% /instructions %}
+
+{% url-field id="crunchbase_url" label="Crunchbase Profile" %}{% /url-field %}
+
+{% instructions ref="crunchbase_url" %}
+Crunchbase company profile URL.
+{% /instructions %}
+
+{% url-field id="pitchbook_url" label="PitchBook Profile" %}{% /url-field %}
+
+{% instructions ref="pitchbook_url" %}
+PitchBook company profile URL if available.
+{% /instructions %}
+
+{% /field-group %}
+
+{% field-group id="sources_section" title="Research Sources" %}
+
+{% url-list id="sources" label="Source URLs" minItems=1 uniqueItems=true %}{% /url-list %}
+
+{% instructions ref="sources" %}
+List all source URLs used for this research. Include Crunchbase, company website, and any additional sources consulted.
+{% /instructions %}
+
+{% /field-group %}
+
+{% /form %}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "markform",
-  "version": "0.0.1",
+  "version": "0.1.1",
   "description": "Agent-friendly, human-readable, editable forms stored as .form.md files",
   "license": "AGPL-3.0-or-later",
   "author": "Joshua Levy",
@@ -47,24 +47,12 @@
   },
   "files": [
     "dist",
-    "examples"
+    "examples",
+    "README.md"
   ],
   "engines": {
     "node": ">=24"
   },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "prepare": "tsdown",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:unit": "vitest run tests/unit",
-    "test:golden": "vitest run tests/golden",
-    "test:coverage": "vitest run --coverage",
-    "test:coverage:html": "vitest run --coverage && open coverage/index.html",
-    "publint": "publint"
-  },
   "dependencies": {
     "@ai-sdk/deepseek": "^2.0.1",
     "@ai-sdk/google": "^3.0.1",
@@ -76,6 +64,7 @@
     "commander": "^13.0.0",
     "dotenv": "^17.2.3",
     "jiti": "^2.4.0",
+    "js-sha256": "^0.11.1",
     "picocolors": "^1.1.0",
     "yaml": "^2.7.0",
     "zod": "^3.24.0"
@@ -97,5 +86,17 @@
     "tsdown": "^0.16.0",
     "typescript": "^5.0.0",
     "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:golden": "vitest run tests/golden",
+    "test:coverage": "vitest run --coverage",
+    "test:coverage:html": "vitest run --coverage && open coverage/index.html",
+    "publint": "publint"
   }
-}
+}

package/dist/ai-sdk.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-sdk.mjs","names":["toolset: MarkformToolSet"],"sources":["../src/integrations/ai-sdk.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 { serialize } 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, set_checkboxes, clear_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(\n  options: CreateMarkformToolsOptions\n): MarkformToolSet {\n  const { sessionStore, includeGetMarkdown = true } = options;\n\n  // markform_inspect - Get current form state with issues\n  const markform_inspect: MarkformTool<\n    Record<string, never>,\n    InspectToolResult\n  > = {\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(\n        (i) => i.severity === \"required\"\n      ).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. Use this after inspecting the form to set values for \" +\n      \"fields that need to be filled. Patches are applied as a transaction - all succeed or all fail. \" +\n      \"Returns the updated form state and any remaining issues. \" +\n      \"Patch operations: set_string, set_number, set_string_list, set_single_select, set_multi_select, set_checkboxes, clear_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 message =\n        result.applyStatus === \"applied\"\n          ? `Applied ${patches.length} patch(es). ${\n              result.isComplete\n                ? \"Form is now complete!\"\n                : `${result.issues.filter((i) => i.severity === \"required\").length} required issue(s) remaining.`\n            }`\n          : `Patches rejected. Check field IDs and value types.`;\n\n      return Promise.resolve({\n        success: result.applyStatus === \"applied\",\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    {\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        return Promise.resolve({\n          success: true,\n          data: {\n            schema: form.schema,\n            values: form.valuesByFieldId,\n          },\n          message: `Exported form with ${form.schema.groups.length} group(s) and ${Object.keys(form.valuesByFieldId).length} value(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<\n      Record<string, never>,\n      GetMarkdownToolResult\n    > = {\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 = serialize(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,4RAGD,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,oBACd,SACiB;CACjB,MAAM,EAAE,cAAc,qBAAqB,SAAS;CAqFpD,MAAMA,UAA2B;EAC/B,kBAhFE;GACF,aACE;GAGF,aAAa;GACb,eAAe;IAEb,MAAM,SAAS,QADF,aAAa,SAAS,CACP;IAE5B,MAAM,gBAAgB,OAAO,OAAO,QACjC,MAAM,EAAE,aAAa,WACvB,CAAC;IACF,MAAM,UAAU,OAAO,aACnB,sDACA,YAAY,cAAc;AAE9B,WAAO,QAAQ,QAAQ;KACrB,SAAS;KACT,MAAM;KACN;KACD,CAAC;;GAEL;EA0DC,gBAvD0E;GAC1E,aACE;GAIF,aAAa;GACb,UAAU,EAAE,cAAc;IACxB,MAAM,OAAO,aAAa,SAAS;IACnC,MAAM,SAAS,aAAa,MAAM,QAAQ;AAG1C,iBAAa,WAAW,KAAK;IAE7B,MAAM,UACJ,OAAO,gBAAgB,YACnB,WAAW,QAAQ,OAAO,cACxB,OAAO,aACH,0BACA,GAAG,OAAO,OAAO,QAAQ,MAAM,EAAE,aAAa,WAAW,CAAC,OAAO,mCAEvE;AAEN,WAAO,QAAQ,QAAQ;KACrB,SAAS,OAAO,gBAAgB;KAChC,MAAM;KACN;KACD,CAAC;;GAEL;EA2BC,iBAvBA;GACE,aACE;GAEF,aAAa;GACb,eAAe;IACb,MAAM,OAAO,aAAa,SAAS;AAEnC,WAAO,QAAQ,QAAQ;KACrB,SAAS;KACT,MAAM;MACJ,QAAQ,KAAK;MACb,QAAQ,KAAK;MACd;KACD,SAAS,sBAAsB,KAAK,OAAO,OAAO,OAAO,gBAAgB,OAAO,KAAK,KAAK,gBAAgB,CAAC,OAAO;KACnH,CAAC;;GAEL;EAOF;AAGD,KAAI,mBAwBF,SAAQ,wBApBJ;EACF,aACE;EAGF,aAAa;EACb,eAAe;GAEb,MAAM,WAAW,UADJ,aAAa,SAAS,CACH;AAEhC,UAAO,QAAQ,QAAQ;IACrB,SAAS;IACT,MAAM,EACJ,UACD;IACD,SAAS,uBAAuB,SAAS,OAAO;IACjD,CAAC;;EAEL;AAKH,QAAO"}