@elizaos/ui 2.0.0-alpha.25 → 2.0.0-alpha.334

package/packages/typescript/src/features/advanced-capabilities/form/extraction.js

@@ -0,0 +1,319 @@
+/**
+ * @module extraction
+ * @description LLM-based field extraction from natural language
+ *
+ * Unlike traditional forms where users fill in specific fields, agent-native
+ * forms let users provide information naturally. This module extracts
+ * structured data from natural language using LLM.
+ */
+import { ModelType, parseKeyValueXml } from "../../../types/index.js";
+import { resolveControlTemplates } from "./template.js";
+import { getTypeHandler, parseValue, validateField } from "./validation.js";
+// ============================================================================
+// LLM-BASED EXTRACTION
+// ============================================================================
+/**
+ * Extract field values and detect intent from user message using LLM.
+ */
+export async function llmIntentAndExtract(runtime, text, form, controls, templateValues) {
+    const resolvedControls = templateValues
+        ? controls.map((control) => resolveControlTemplates(control, templateValues))
+        : controls;
+    const fieldsDescription = resolvedControls
+        .filter((c) => !c.hidden)
+        .map((c) => {
+        const handler = getTypeHandler(c.type);
+        const typeHint = handler?.extractionPrompt || c.type;
+        const hints = c.extractHints?.join(", ") || "";
+        const options = c.options?.map((o) => o.value).join(", ") || "";
+        return `- ${c.key} (${c.label}): ${c.description || typeHint}${hints ? ` [hints: ${hints}]` : ""}${options ? ` [options: ${options}]` : ""}`;
+    })
+        .join("\n");
+    const prompt = `You are extracting structured data from a user's natural language message.
+
+FORM: ${form.name}
+${form.description ? `DESCRIPTION: ${form.description}` : ""}
+
+FIELDS TO EXTRACT:
+${fieldsDescription}
+
+USER MESSAGE:
+"${text}"
+
+INSTRUCTIONS:
+1. Determine the user's intent:
+   - fill_form: They are providing information for form fields
+   - submit: They want to submit/complete the form ("done", "submit", "finish", "that's all")
+   - stash: They want to save for later ("save for later", "pause", "hold on")
+   - restore: They want to resume a saved form ("resume", "continue", "pick up where")
+   - cancel: They want to cancel ("cancel", "abort", "nevermind", "forget it")
+   - undo: They want to undo last change ("undo", "go back", "wait no")
+   - skip: They want to skip current field ("skip", "pass", "don't know")
+   - explain: They want explanation ("why?", "what's that for?")
+   - example: They want an example ("example?", "like what?")
+   - progress: They want progress update ("how far?", "status")
+   - autofill: They want to use saved values ("same as last time")
+   - other: None of the above
+
+2. For fill_form intent, extract all field values mentioned.
+   - For each extracted value, provide a confidence score (0.0-1.0)
+   - Note if this appears to be a correction to a previous value
+
+Respond using TOON like this:
+intent: fill_form, submit, stash, restore, cancel, undo, skip, explain, example, progress, autofill, or other
+extractions[N]{key,value,confidence,reasoning,is_correction}:
+  field_key,extracted_value,0.9,why this value,false
+
+Example:
+intent: fill_form
+extractions[2]{key,value,confidence,reasoning,is_correction}:
+  name,Jane Doe,0.95,User said their name is Jane,false
+  email,jane@example.com,0.9,Email mentioned in message,false
+
+IMPORTANT: Your response must ONLY contain the TOON document above. No preamble or explanation.`;
+    try {
+        const runModel = runtime.useModel.bind(runtime);
+        const response = await runModel(ModelType.TEXT_SMALL, {
+            prompt,
+            temperature: 0.1,
+        });
+        const parsed = parseExtractionResponse(response);
+        for (const extraction of parsed.extractions) {
+            const control = resolvedControls.find((c) => c.key === extraction.field);
+            if (control) {
+                if (typeof extraction.value === "string") {
+                    extraction.value = parseValue(extraction.value, control);
+                }
+                const validation = validateField(extraction.value, control);
+                if (!validation.valid) {
+                    extraction.confidence = Math.min(extraction.confidence, 0.3);
+                    extraction.reasoning = `${extraction.reasoning || ""} (Validation failed: ${validation.error})`;
+                }
+            }
+        }
+        if (form.debug) {
+            runtime.logger.debug("[FormExtraction] LLM extraction result:", JSON.stringify(parsed));
+        }
+        return parsed;
+    }
+    catch (error) {
+        runtime.logger.error("[FormExtraction] LLM extraction failed:", String(error));
+        return { intent: "other", extractions: [] };
+    }
+}
+/**
+ * Parse the structured extraction response (TOON-first, XML fallback).
+ */
+function parseExtractionResponse(response) {
+    const result = {
+        intent: "other",
+        extractions: [],
+    };
+    try {
+        const parsed = parseKeyValueXml(response);
+        if (parsed) {
+            const intentStr = parsed.intent?.toLowerCase() ?? "other";
+            result.intent = isValidIntent(intentStr) ? intentStr : "other";
+            if (parsed.extractions) {
+                const fields = Array.isArray(parsed.extractions)
+                    ? parsed.extractions
+                    : parsed.extractions.field
+                        ? Array.isArray(parsed.extractions.field)
+                            ? parsed.extractions.field
+                            : [parsed.extractions.field]
+                        : [];
+                for (const field of fields) {
+                    if (field?.key) {
+                        const extraction = {
+                            field: String(field.key),
+                            value: field.value ?? null,
+                            confidence: parseFloat(String(field.confidence ?? "")) || 0.5,
+                            reasoning: field.reasoning ? String(field.reasoning) : undefined,
+                            isCorrection: field.is_correction === "true" || field.is_correction === true,
+                        };
+                        result.extractions.push(extraction);
+                    }
+                }
+            }
+        }
+    }
+    catch (_error) {
+        // Fallback: try regex extraction
+        const intentMatch = response.match(/<intent>([^<]+)<\/intent>/);
+        if (intentMatch) {
+            const intentStr = intentMatch[1].toLowerCase().trim();
+            result.intent = isValidIntent(intentStr) ? intentStr : "other";
+        }
+        const fieldMatches = response.matchAll(/<field>\s*<key>([^<]+)<\/key>\s*<value>([^<]*)<\/value>\s*<confidence>([^<]+)<\/confidence>/g);
+        for (const match of fieldMatches) {
+            result.extractions.push({
+                field: match[1].trim(),
+                value: match[2].trim(),
+                confidence: parseFloat(match[3]) || 0.5,
+            });
+        }
+    }
+    return result;
+}
+function isValidIntent(str) {
+    const validIntents = [
+        "fill_form",
+        "submit",
+        "stash",
+        "restore",
+        "cancel",
+        "undo",
+        "skip",
+        "explain",
+        "example",
+        "progress",
+        "autofill",
+        "other",
+    ];
+    return validIntents.includes(str);
+}
+// ============================================================================
+// SIMPLE EXTRACTION (for single-field targeted extraction)
+// ============================================================================
+/**
+ * Extract a specific field value from user message.
+ */
+export async function extractSingleField(runtime, text, control, debug, templateValues) {
+    const resolvedControl = templateValues
+        ? resolveControlTemplates(control, templateValues)
+        : control;
+    const handler = getTypeHandler(resolvedControl.type);
+    const typeHint = handler?.extractionPrompt || resolvedControl.type;
+    const prompt = `Extract the ${resolvedControl.label} (${typeHint}) from this message:
+
+"${text}"
+
+${resolvedControl.description ? `Context: ${resolvedControl.description}` : ""}
+${resolvedControl.extractHints?.length ? `Look for: ${resolvedControl.extractHints.join(", ")}` : ""}
+${resolvedControl.options?.length ? `Valid options: ${resolvedControl.options.map((o) => o.value).join(", ")}` : ""}
+${resolvedControl.example ? `Example: ${resolvedControl.example}` : ""}
+
+Respond using TOON like this:
+found: true or false
+value: extracted value or empty if not found
+confidence: 0.0 to 1.0
+reasoning: brief explanation
+
+  IMPORTANT: Your response must ONLY contain the TOON document above. No preamble or explanation.`;
+    try {
+        const runModel = runtime.useModel.bind(runtime);
+        const response = await runModel(ModelType.TEXT_SMALL, {
+            prompt,
+            temperature: 0.1,
+        });
+        const parsed = parseKeyValueXml(response);
+        const found = parsed?.found === true || parsed?.found === "true";
+        if (found) {
+            let value = parsed.value;
+            if (typeof value === "string") {
+                value = parseValue(value, resolvedControl);
+            }
+            const confidence = typeof parsed?.confidence === "number"
+                ? parsed.confidence
+                : parseFloat(String(parsed?.confidence ?? ""));
+            const result = {
+                field: resolvedControl.key,
+                value: value ?? null,
+                confidence: Number.isFinite(confidence) ? confidence : 0.5,
+                reasoning: parsed.reasoning ? String(parsed.reasoning) : undefined,
+            };
+            if (debug) {
+                runtime.logger.debug("[FormExtraction] Single field extraction:", JSON.stringify(result));
+            }
+            return result;
+        }
+        return null;
+    }
+    catch (error) {
+        runtime.logger.error("[FormExtraction] Single field extraction failed:", String(error));
+        return null;
+    }
+}
+// ============================================================================
+// CORRECTION DETECTION
+// ============================================================================
+/**
+ * Detect if user is correcting a previous value.
+ */
+export async function detectCorrection(runtime, text, currentValues, controls, templateValues) {
+    const resolvedControls = templateValues
+        ? controls.map((control) => resolveControlTemplates(control, templateValues))
+        : controls;
+    const currentValuesStr = resolvedControls
+        .filter((c) => currentValues[c.key] !== undefined)
+        .map((c) => `- ${c.label}: ${currentValues[c.key]}`)
+        .join("\n");
+    if (!currentValuesStr) {
+        return [];
+    }
+    const prompt = `Is the user correcting any of these previously provided values?
+
+Current values:
+${currentValuesStr}
+
+User message:
+"${text}"
+
+If they are correcting a value, extract the new value. Otherwise respond with no corrections.
+
+Respond using TOON like this:
+has_correction: true or false
+corrections[N]{field,old_value,new_value,confidence}:
+  field_label,previous value,corrected value,0.9
+
+If no corrections:
+has_correction: false
+
+IMPORTANT: Your response must ONLY contain the TOON document above. No preamble or explanation.`;
+    try {
+        const runModel = runtime.useModel.bind(runtime);
+        const response = await runModel(ModelType.TEXT_SMALL, {
+            prompt,
+            temperature: 0.1,
+        });
+        const parsed = parseKeyValueXml(response);
+        const hasCorrection = parsed?.has_correction === true || parsed?.has_correction === "true";
+        if (parsed && hasCorrection && parsed.corrections) {
+            const corrections = [];
+            const correctionList = Array.isArray(parsed.corrections)
+                ? parsed.corrections
+                : parsed.corrections.correction
+                    ? Array.isArray(parsed.corrections.correction)
+                        ? parsed.corrections.correction
+                        : [parsed.corrections.correction]
+                    : [];
+            for (const correction of correctionList) {
+                const fieldName = correction.field ? String(correction.field) : "";
+                const control = resolvedControls.find((c) => c.label.toLowerCase() === fieldName.toLowerCase() ||
+                    c.key.toLowerCase() === fieldName.toLowerCase());
+                if (control) {
+                    let value = correction.new_value;
+                    if (typeof value === "string") {
+                        value = parseValue(value, control);
+                    }
+                    const confidence = typeof correction.confidence === "number"
+                        ? correction.confidence
+                        : parseFloat(String(correction.confidence ?? ""));
+                    const extraction = {
+                        field: control.key,
+                        value: value ?? null,
+                        confidence: Number.isFinite(confidence) ? confidence : 0.8,
+                        isCorrection: true,
+                    };
+                    corrections.push(extraction);
+                }
+            }
+            return corrections;
+        }
+        return [];
+    }
+    catch (error) {
+        runtime.logger.error("[FormExtraction] Correction detection failed:", String(error));
+        return [];
+    }
+}

package/packages/typescript/src/features/advanced-capabilities/form/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module form
+ * @description Guardrails for agent-guided user journeys
+ *
+ * Conversational forms for data collection in elizaOS.
+ */
+export * from "./types.ts";
+export { BUILTIN_TYPE_MAP, BUILTIN_TYPES, getBuiltinType, isBuiltinType, registerBuiltinTypes, } from "./builtins.ts";
+export { clearTypeHandlers, formatValue, getTypeHandler, matchesMimeType, parseValue, registerTypeHandler, validateField, } from "./validation.ts";
+export { hasDataToExtract, isLifecycleIntent, isUXIntent, quickIntentDetect, } from "./intent.ts";
+export { deleteSession, getActiveSession, getAllActiveSessions, getAutofillData, getStashedSessions, getSubmissions, saveAutofillData, saveSession, saveSubmission, } from "./storage.ts";
+export { detectCorrection, extractSingleField, llmIntentAndExtract, } from "./extraction.ts";
+export { calculateTTL, formatEffort, formatTimeRemaining, isExpired, isExpiringSoon, shouldConfirmCancel, shouldNudge, } from "./ttl.ts";
+export { applyControlDefaults, applyFormDefaults, prettify, } from "./defaults.ts";
+export type { TemplateValues } from "./template.ts";
+export { buildTemplateValues, renderTemplate, resolveControlTemplates, } from "./template.ts";
+export { C, ControlBuilder, Form, FormBuilder } from "./builder.ts";
+export type { FormService } from "./service.ts";
+export { formRestoreAction } from "./actions/restore.ts";
+export { formEvaluator } from "./evaluators/extractor.ts";
+export { formContextProvider } from "./providers/context.ts";
+//# sourceMappingURL=index.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/form/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,cAAc,YAAY,CAAC;AAM3B,OAAO,EACN,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,oBAAoB,GACpB,MAAM,eAAe,CAAC;AAMvB,OAAO,EACN,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,aAAa,GACb,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,iBAAiB,GACjB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACN,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,cAAc,GACd,MAAM,cAAc,CAAC;AAMtB,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACnB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACN,YAAY,EACZ,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,WAAW,GACX,MAAM,UAAU,CAAC;AAMlB,OAAO,EACN,oBAAoB,EACpB,iBAAiB,EACjB,QAAQ,GACR,MAAM,eAAe,CAAC;AAMvB,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACN,mBAAmB,EACnB,cAAc,EACd,uBAAuB,GACvB,MAAM,eAAe,CAAC;AAMvB,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQpE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/packages/typescript/src/features/advanced-capabilities/form/index.js

@@ -0,0 +1,52 @@
+/**
+ * @module form
+ * @description Guardrails for agent-guided user journeys
+ *
+ * Conversational forms for data collection in elizaOS.
+ */
+// ============================================================================
+// TYPE EXPORTS
+// ============================================================================
+export * from "./types.js";
+// ============================================================================
+// BUILT-IN TYPES EXPORTS
+// ============================================================================
+export { BUILTIN_TYPE_MAP, BUILTIN_TYPES, getBuiltinType, isBuiltinType, registerBuiltinTypes, } from "./builtins.js";
+// ============================================================================
+// VALIDATION EXPORTS
+// ============================================================================
+export { clearTypeHandlers, formatValue, getTypeHandler, matchesMimeType, parseValue, registerTypeHandler, validateField, } from "./validation.js";
+// ============================================================================
+// INTENT DETECTION EXPORTS
+// ============================================================================
+export { hasDataToExtract, isLifecycleIntent, isUXIntent, quickIntentDetect, } from "./intent.js";
+// ============================================================================
+// STORAGE EXPORTS
+// ============================================================================
+export { deleteSession, getActiveSession, getAllActiveSessions, getAutofillData, getStashedSessions, getSubmissions, saveAutofillData, saveSession, saveSubmission, } from "./storage.js";
+// ============================================================================
+// EXTRACTION EXPORTS
+// ============================================================================
+export { detectCorrection, extractSingleField, llmIntentAndExtract, } from "./extraction.js";
+// ============================================================================
+// TTL & EFFORT EXPORTS
+// ============================================================================
+export { calculateTTL, formatEffort, formatTimeRemaining, isExpired, isExpiringSoon, shouldConfirmCancel, shouldNudge, } from "./ttl.js";
+// ============================================================================
+// DEFAULTS EXPORTS
+// ============================================================================
+export { applyControlDefaults, applyFormDefaults, prettify, } from "./defaults.js";
+export { buildTemplateValues, renderTemplate, resolveControlTemplates, } from "./template.js";
+// ============================================================================
+// BUILDER API EXPORTS
+// ============================================================================
+export { C, ControlBuilder, Form, FormBuilder } from "./builder.js";
+// ============================================================================
+// COMPONENT EXPORTS
+// ============================================================================
+// Action - fast-path restore for stashed forms
+export { formRestoreAction } from "./actions/restore.js";
+// Evaluator - extracts fields and handles intents
+export { formEvaluator } from "./evaluators/extractor.js";
+// Provider - injects form context into agent state
+export { formContextProvider } from "./providers/context.js";

package/packages/typescript/src/features/advanced-capabilities/form/intent.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @module intent
+ * @description Two-tier intent detection for form interactions
+ *
+ * ## Design Rationale
+ *
+ * Intent detection determines what the user wants to do:
+ * - Fill form fields? Submit? Cancel? Undo?
+ *
+ * We use a two-tier approach:
+ *
+ * ### Tier 1: Fast Path (English Keywords)
+ * Simple regex matching for common English phrases.
+ *
+ * ### Tier 2: LLM Fallback
+ * When fast path returns null, we use LLM for non-English, ambiguous, or complex messages.
+ */
+import type { FormIntent } from "./types.ts";
+/**
+ * Quick intent detection using English keywords.
+ *
+ * Fast path for common English phrases - avoids LLM call for obvious intents.
+ * Returns null if no match found, triggering LLM fallback.
+ *
+ * @param text - User message text
+ * @returns Detected intent or null if no fast-path match
+ */
+export declare function quickIntentDetect(text: string): FormIntent | null;
+/**
+ * Check if intent is a lifecycle intent (affects session state).
+ */
+export declare function isLifecycleIntent(intent: FormIntent): boolean;
+/**
+ * Check if intent is a UX intent (doesn't directly provide data).
+ */
+export declare function isUXIntent(intent: FormIntent): boolean;
+/**
+ * Check if intent likely contains data to extract.
+ */
+export declare function hasDataToExtract(intent: FormIntent): boolean;
+//# sourceMappingURL=intent.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/form/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../../../../../../typescript/src/features/advanced-capabilities/form/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAkHjE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAStD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAE5D"}

package/packages/typescript/src/features/advanced-capabilities/form/intent.js

@@ -0,0 +1,119 @@
+/**
+ * @module intent
+ * @description Two-tier intent detection for form interactions
+ *
+ * ## Design Rationale
+ *
+ * Intent detection determines what the user wants to do:
+ * - Fill form fields? Submit? Cancel? Undo?
+ *
+ * We use a two-tier approach:
+ *
+ * ### Tier 1: Fast Path (English Keywords)
+ * Simple regex matching for common English phrases.
+ *
+ * ### Tier 2: LLM Fallback
+ * When fast path returns null, we use LLM for non-English, ambiguous, or complex messages.
+ */
+/**
+ * Quick intent detection using English keywords.
+ *
+ * Fast path for common English phrases - avoids LLM call for obvious intents.
+ * Returns null if no match found, triggering LLM fallback.
+ *
+ * @param text - User message text
+ * @returns Detected intent or null if no fast-path match
+ */
+export function quickIntentDetect(text) {
+    const lower = text.toLowerCase().trim();
+    // Empty or too short - probably not a command
+    if (lower.length < 2) {
+        return null;
+    }
+    // ═══ LIFECYCLE INTENTS ═══
+    // Restore - resume a saved form
+    if (/\b(resume|continue|pick up where|go back to|get back to)\b/.test(lower)) {
+        return "restore";
+    }
+    // Submit - complete and submit the form
+    if (/\b(submit|done|finish|send it|that'?s all|i'?m done|complete|all set)\b/.test(lower)) {
+        return "submit";
+    }
+    // Stash - save for later without submitting
+    if (/\b(save|stash|later|hold on|pause|save for later|come back|save this)\b/.test(lower)) {
+        // But not "save" in context of submitting
+        if (!/\b(save and submit|save and send)\b/.test(lower)) {
+            return "stash";
+        }
+    }
+    // Cancel - abandon the form
+    if (/\b(cancel|abort|nevermind|never mind|forget it|stop|quit|exit)\b/.test(lower)) {
+        return "cancel";
+    }
+    // ═══ UX MAGIC INTENTS ═══
+    // Undo - revert the last change
+    if (/\b(undo|go back|wait no|change that|oops|that'?s wrong|wrong|not right)\b/.test(lower)) {
+        return "undo";
+    }
+    // Skip - skip the current optional field
+    if (/\b(skip|pass|don'?t know|next one|next|don'?t have|no idea)\b/.test(lower)) {
+        // But not "skip to" (navigation)
+        if (!/\bskip to\b/.test(lower)) {
+            return "skip";
+        }
+    }
+    // Explain - "why do you need this?"
+    if (/\b(why|what'?s that for|explain|what do you mean|what is|purpose|reason)\b\??$/i.test(lower)) {
+        return "explain";
+    }
+    // Also match standalone "why?"
+    if (/^why\??$/i.test(lower)) {
+        return "explain";
+    }
+    // Example - "give me an example"
+    if (/\b(example|like what|show me|such as|for instance|sample)\b\??$/i.test(lower)) {
+        return "example";
+    }
+    // Also match standalone "example?" or "e.g.?"
+    if (/^(example|e\.?g\.?)\??$/i.test(lower)) {
+        return "example";
+    }
+    // Progress - "how far am I?"
+    if (/\b(how far|how many left|progress|status|how much more|where are we)\b/.test(lower)) {
+        return "progress";
+    }
+    // Autofill - "use my usual values"
+    if (/\b(same as|last time|use my usual|like before|previous|from before)\b/.test(lower)) {
+        return "autofill";
+    }
+    // No match - let LLM handle it
+    return null;
+}
+// ============================================================================
+// INTENT HELPERS
+// ============================================================================
+/**
+ * Check if intent is a lifecycle intent (affects session state).
+ */
+export function isLifecycleIntent(intent) {
+    return ["submit", "stash", "restore", "cancel"].includes(intent);
+}
+/**
+ * Check if intent is a UX intent (doesn't directly provide data).
+ */
+export function isUXIntent(intent) {
+    return [
+        "undo",
+        "skip",
+        "explain",
+        "example",
+        "progress",
+        "autofill",
+    ].includes(intent);
+}
+/**
+ * Check if intent likely contains data to extract.
+ */
+export function hasDataToExtract(intent) {
+    return intent === "fill_form" || intent === "other";
+}

package/packages/typescript/src/features/advanced-capabilities/form/providers/context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module providers/context
+ * @description Form context provider for agent awareness
+ *
+ * This provider injects form state into the agent's context BEFORE
+ * the agent generates a response.
+ */
+import type { Provider } from "../../../../types/index.ts";
+export declare const formContextProvider: Provider;
+export default formContextProvider;
+//# sourceMappingURL=context.d.ts.map

package/packages/typescript/src/features/advanced-capabilities/form/providers/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../../../../../typescript/src/features/advanced-capabilities/form/providers/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAIX,QAAQ,EAIR,MAAM,4BAA4B,CAAC;AAUpC,eAAO,MAAM,mBAAmB,EAAE,QAuLjC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}