@elizaos/plugin-form 2.0.0-alpha.1 → 2.0.0-alpha.10

package/dist/index.js

@@ -105,7 +105,7 @@ var init_builtins = __esm(() => {
         return { valid: true };
       }
       const num = typeof value === "number" ? value : parseFloat(String(value));
-      if (isNaN(num)) {
+      if (Number.isNaN(num)) {
         return { valid: false, error: "Must be a valid number" };
       }
       if (control.min !== undefined && num < control.min) {
@@ -124,7 +124,7 @@ var init_builtins = __esm(() => {
       if (value === null || value === undefined)
         return "";
       const num = typeof value === "number" ? value : parseFloat(String(value));
-      if (isNaN(num))
+      if (Number.isNaN(num))
         return String(value);
       return num.toLocaleString();
     },
@@ -218,14 +218,14 @@ var init_builtins = __esm(() => {
         return { valid: false, error: "Must be in YYYY-MM-DD format" };
       }
       const date = new Date(str);
-      if (isNaN(date.getTime())) {
+      if (Number.isNaN(date.getTime())) {
         return { valid: false, error: "Invalid date" };
       }
       return { valid: true };
     },
     parse: (value) => {
       const date = new Date(value);
-      if (!isNaN(date.getTime())) {
+      if (!Number.isNaN(date.getTime())) {
         return date.toISOString().split("T")[0];
       }
       return value.trim();
@@ -234,7 +234,7 @@ var init_builtins = __esm(() => {
       if (!value)
         return "";
       const date = new Date(String(value));
-      if (isNaN(date.getTime()))
+      if (Number.isNaN(date.getTime()))
         return String(value);
       return date.toLocaleDateString();
     },
@@ -243,7 +243,7 @@ var init_builtins = __esm(() => {
   fileType = {
     id: "file",
     builtin: true,
-    validate: (value, control) => {
+    validate: (value, _control) => {
       if (value === null || value === undefined) {
         return { valid: true };
       }
@@ -319,7 +319,6 @@ function validateField(value, control) {
       return validateSelect(value, control);
     case "file":
       return validateFile(value, control);
-    case "text":
     default:
       return validateText(value, control);
   }
@@ -370,7 +369,7 @@ function validateEmail(value, control) {
 }
 function validateNumber(value, control) {
   const numValue = typeof value === "number" ? value : parseFloat(String(value).replace(/[,$]/g, ""));
-  if (isNaN(numValue)) {
+  if (Number.isNaN(numValue)) {
     return {
       valid: false,
       error: `${control.label || control.key} must be a number`
@@ -414,7 +413,7 @@ function validateDate(value, control) {
       error: `${control.label || control.key} must be a valid date`
     };
   }
-  if (isNaN(dateValue.getTime())) {
+  if (Number.isNaN(dateValue.getTime())) {
     return {
       valid: false,
       error: `${control.label || control.key} must be a valid date`
@@ -515,9 +514,6 @@ function parseValue(value, control) {
       const timestamp = Date.parse(value);
       return Number.isFinite(timestamp) ? new Date(timestamp).toISOString() : value;
     }
-    case "text":
-    case "email":
-    case "select":
     default:
       return value;
   }
@@ -616,20 +612,13 @@ function isLifecycleIntent(intent) {
   return ["submit", "stash", "restore", "cancel"].includes(intent);
 }
 function isUXIntent(intent) {
-  return [
-    "undo",
-    "skip",
-    "explain",
-    "example",
-    "progress",
-    "autofill"
-  ].includes(intent);
+  return ["undo", "skip", "explain", "example", "progress", "autofill"].includes(intent);
 }
 function hasDataToExtract(intent) {
   return intent === "fill_form" || intent === "other";
 }
 
-// ../../node_modules/uuid/dist-node/stringify.js
+// node_modules/uuid/dist-node/stringify.js
 function unsafeStringify(arr, offset = 0) {
   return (byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]]).toLowerCase();
 }
@@ -641,7 +630,7 @@ var init_stringify = __esm(() => {
   }
 });
 
-// ../../node_modules/uuid/dist-node/rng.js
+// node_modules/uuid/dist-node/rng.js
 import { randomFillSync } from "node:crypto";
 function rng() {
   if (poolPtr > rnds8Pool.length - 16) {
@@ -656,14 +645,14 @@ var init_rng = __esm(() => {
   poolPtr = rnds8Pool.length;
 });
 
-// ../../node_modules/uuid/dist-node/native.js
+// node_modules/uuid/dist-node/native.js
 import { randomUUID } from "node:crypto";
 var native_default;
 var init_native = __esm(() => {
   native_default = { randomUUID };
 });
 
-// ../../node_modules/uuid/dist-node/v4.js
+// node_modules/uuid/dist-node/v4.js
 function _v4(options, buf, offset) {
   options = options || {};
   const rnds = options.random ?? options.rng?.() ?? rng();
@@ -698,7 +687,7 @@ var init_v4 = __esm(() => {
   v4_default = v4;
 });
 
-// ../../node_modules/uuid/dist-node/index.js
+// node_modules/uuid/dist-node/index.js
 var init_dist_node = __esm(() => {
   init_v4();
 });
@@ -1040,7 +1029,7 @@ function parseExtractionResponse(response) {
         }
       }
     }
-  } catch (error) {
+  } catch (_error) {
     const intentMatch = response.match(/<intent>([^<]+)<\/intent>/);
     if (intentMatch) {
       const intentStr = intentMatch[1].toLowerCase().trim();
@@ -1190,9 +1179,8 @@ Respond in XML:
   }
 }
 var init_extraction = __esm(() => {
-  init_validation();
-  init_validation();
   init_template();
+  init_validation();
 });
 
 // src/service.ts
@@ -1201,8 +1189,8 @@ __export(exports_service, {
   FormService: () => FormService
 });
 import {
-  Service,
-  logger
+  logger,
+  Service
 } from "@elizaos/core";
 function prettify3(key) {
   return key.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
@@ -1210,10 +1198,10 @@ function prettify3(key) {
 var FormService;
 var init_service = __esm(() => {
   init_dist_node();
-  init_types();
+  init_builtins();
   init_storage();
+  init_types();
   init_validation();
-  init_builtins();
   FormService = class FormService extends Service {
     static serviceType = "FORM";
     capabilityDescription = "Manages conversational forms for data collection";
@@ -1254,13 +1242,6 @@ var init_service = __esm(() => {
     listForms() {
       return Array.from(this.forms.values());
     }
-    registerType(type, handler) {
-      registerTypeHandler(type, handler);
-      logger.debug(`[FormService] Registered type handler: ${type}`);
-    }
-    getTypeHandler(type) {
-      return getTypeHandler(type);
-    }
     registerControlType(type, options) {
       const existing = this.controlTypes.get(type.id);
       if (existing) {
@@ -1689,7 +1670,7 @@ var init_service = __esm(() => {
           value,
           externalData
         });
-      } catch (error) {
+      } catch (_error) {
         logger.debug(`[FormService] No event handler for FORM_FIELD_CONFIRMED`);
       }
       logger.info(`[FormService] Confirmed external field ${field}`);
@@ -1732,7 +1713,7 @@ var init_service = __esm(() => {
           field,
           reason
         });
-      } catch (error) {
+      } catch (_error) {
         logger.debug(`[FormService] No event handler for FORM_FIELD_CANCELLED`);
       }
       logger.info(`[FormService] Cancelled external field ${field}: ${reason}`);
@@ -2024,7 +2005,8 @@ var init_service = __esm(() => {
           id: session.id,
           name: workerName,
           roomId: session.roomId,
-          entityId: session.entityId
+          entityId: session.entityId,
+          tags: ["form-hook", hookName]
         };
         await worker.execute(this.runtime, {
           session,
@@ -2049,218 +2031,180 @@ var init_service = __esm(() => {
   };
 });
 
-// src/providers/context.ts
-var exports_context = {};
-__export(exports_context, {
-  formContextProvider: () => formContextProvider,
-  default: () => context_default
+// src/actions/restore.ts
+var exports_restore = {};
+__export(exports_restore, {
+  formRestoreAction: () => formRestoreAction,
+  default: () => restore_default
 });
-import { logger as logger2 } from "@elizaos/core";
-var formContextProvider, context_default;
-var init_context = __esm(() => {
-  init_template();
-  formContextProvider = {
-    name: "FORM_CONTEXT",
-    description: "Provides context about active form sessions",
-    get: async (runtime, message, _state) => {
+import {
+  logger as logger2
+} from "@elizaos/core";
+var formRestoreAction, restore_default;
+var init_restore = __esm(() => {
+  formRestoreAction = {
+    name: "FORM_RESTORE",
+    similes: ["RESUME_FORM", "CONTINUE_FORM"],
+    description: "Restore a previously stashed form session",
+    validate: async (runtime, message, state, options) => {
+      const __avTextRaw = typeof message?.content?.text === "string" ? message.content.text : "";
+      const __avText = __avTextRaw.toLowerCase();
+      const __avKeywords = ["form", "restore"];
+      const __avKeywordOk = __avKeywords.length > 0 && __avKeywords.some((kw) => kw.length > 0 && __avText.includes(kw));
+      const __avRegex = /\b(?:form|restore)\b/i;
+      const __avRegexOk = Boolean(__avText.match(__avRegex));
+      const __avSource = String(message?.content?.source ?? message?.source ?? "");
+      const __avExpectedSource = "";
+      const __avSourceOk = __avExpectedSource ? __avSource === __avExpectedSource : Boolean(__avSource || state || runtime?.agentId || runtime?.getService);
+      const __avOptions = options && typeof options === "object" ? options : {};
+      const __avInputOk = __avText.trim().length > 0 || Object.keys(__avOptions).length > 0 || Boolean(message?.content && typeof message.content === "object");
+      if (!(__avKeywordOk && __avRegexOk && __avSourceOk && __avInputOk)) {
+        return false;
+      }
+      const __avLegacyValidate = async (runtime2, message2, _state) => {
+        try {
+          const text = message2.content?.text || "";
+          const intent = quickIntentDetect(text);
+          if (intent !== "restore") {
+            return false;
+          }
+          const formService = runtime2.getService("FORM");
+          if (!formService) {
+            return false;
+          }
+          const entityId = message2.entityId;
+          if (!entityId)
+            return false;
+          const stashed = await formService.getStashedSessions(entityId);
+          return stashed.length > 0;
+        } catch (error) {
+          logger2.error("[FormRestoreAction] Validation error:", String(error));
+          return false;
+        }
+      };
+      try {
+        return Boolean(await __avLegacyValidate(runtime, message, state, options));
+      } catch {
+        return false;
+      }
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
       try {
         const formService = runtime.getService("FORM");
         if (!formService) {
-          return {
-            data: { hasActiveForm: false },
-            values: { formContext: "" },
-            text: ""
-          };
+          await callback?.({
+            text: "Sorry, I couldn't find the form service."
+          });
+          return { success: false };
         }
         const entityId = message.entityId;
         const roomId = message.roomId;
         if (!entityId || !roomId) {
-          return {
-            data: { hasActiveForm: false },
-            values: { formContext: "" },
-            text: ""
-          };
+          await callback?.({
+            text: "Sorry, I couldn't identify you."
+          });
+          return { success: false };
+        }
+        const existing = await formService.getActiveSession(entityId, roomId);
+        if (existing) {
+          const form2 = formService.getForm(existing.formId);
+          await callback?.({
+            text: `You already have an active form: "${form2?.name || existing.formId}". Would you like to continue with that one, or should I save it and restore your other form?`
+          });
+          return { success: false };
         }
-        const session = await formService.getActiveSession(entityId, roomId);
         const stashed = await formService.getStashedSessions(entityId);
-        if (!session && stashed.length === 0) {
-          return {
-            data: { hasActiveForm: false, stashedCount: 0 },
-            values: { formContext: "" },
-            text: ""
-          };
+        if (stashed.length === 0) {
+          await callback?.({
+            text: "You don't have any saved forms to resume."
+          });
+          return { success: false };
         }
-        let contextText = "";
-        let contextState;
-        if (session) {
-          contextState = formService.getSessionContext(session);
-          const form = formService.getForm(session.formId);
-          const templateValues = buildTemplateValues(session);
-          const resolveText = (value) => renderTemplate(value, templateValues);
-          contextState = {
-            ...contextState,
-            filledFields: contextState.filledFields.map((field) => ({
-              ...field,
-              label: resolveText(field.label) ?? field.label
-            })),
-            missingRequired: contextState.missingRequired.map((field) => ({
-              ...field,
-              label: resolveText(field.label) ?? field.label,
-              description: resolveText(field.description),
-              askPrompt: resolveText(field.askPrompt)
-            })),
-            uncertainFields: contextState.uncertainFields.map((field) => ({
-              ...field,
-              label: resolveText(field.label) ?? field.label
-            })),
-            nextField: contextState.nextField ? resolveControlTemplates(contextState.nextField, templateValues) : null
-          };
-          contextText = `# Active Form: ${form?.name || session.formId}
-
-`;
-          contextText += `Progress: ${contextState.progress}%
+        const sessionToRestore = stashed.sort((a, b) => b.updatedAt - a.updatedAt)[0];
+        const session = await formService.restore(sessionToRestore.id, entityId);
+        const form = formService.getForm(session.formId);
+        const context = formService.getSessionContext(session);
+        let responseText = `I've restored your "${form?.name || session.formId}" form. `;
+        responseText += `You're ${context.progress}% complete. `;
+        if (context.filledFields.length > 0) {
+          responseText += `
 
+Here's what I have so far:
 `;
-          if (contextState.filledFields.length > 0) {
-            contextText += `## Collected Information
-`;
-            for (const field of contextState.filledFields) {
-              contextText += `- ${field.label}: ${field.displayValue}
-`;
-            }
-            contextText += `
+          for (const field of context.filledFields) {
+            responseText += `• ${field.label}: ${field.displayValue}
 `;
           }
-          if (contextState.missingRequired.length > 0) {
-            contextText += `## Still Needed
-`;
-            for (const field of contextState.missingRequired) {
-              contextText += `- ${field.label}${field.description ? ` (${field.description})` : ""}
-`;
-            }
-            contextText += `
-`;
+        }
+        if (context.nextField) {
+          responseText += `
+Let's continue with ${context.nextField.label}.`;
+          if (context.nextField.askPrompt) {
+            responseText += ` ${context.nextField.askPrompt}`;
           }
-          if (contextState.uncertainFields.length > 0) {
-            contextText += `## Needs Confirmation
-`;
-            for (const field of contextState.uncertainFields) {
-              contextText += `- ${field.label}: "${field.value}" (${Math.round(field.confidence * 100)}% confident)
-`;
-            }
-            contextText += `
-`;
+        } else if (context.status === "ready") {
+          responseText += `
+Everything looks complete! Ready to submit?`;
+        }
+        await callback?.({
+          text: responseText
+        });
+        return {
+          success: true,
+          data: {
+            sessionId: session.id,
+            formId: session.formId,
+            progress: context.progress
           }
-          if (contextState.pendingExternalFields.length > 0) {
-            contextText += `## Waiting For External Action
-`;
-            for (const field of contextState.pendingExternalFields) {
-              const ageMs = Date.now() - field.activatedAt;
-              const ageMin = Math.floor(ageMs / 60000);
-              const ageText = ageMin < 1 ? "just now" : `${ageMin}m ago`;
-              contextText += `- ${field.label}: ${field.instructions} (started ${ageText})
-`;
-              if (field.address) {
-                contextText += `  Address: ${field.address}
-`;
-              }
-            }
-            contextText += `
-`;
+        };
+      } catch (error) {
+        logger2.error("[FormRestoreAction] Handler error:", String(error));
+        await callback?.({
+          text: "Sorry, I couldn't restore your form. Please try again."
+        });
+        return { success: false };
+      }
+    },
+    examples: [
+      [
+        {
+          name: "{{user1}}",
+          content: { text: "Resume my form" }
+        },
+        {
+          name: "{{agentName}}",
+          content: {
+            text: "I've restored your form. Let's continue where you left off."
           }
-          contextText += `## Agent Guidance
-`;
-          if (contextState.pendingExternalFields.length > 0) {
-            const pending = contextState.pendingExternalFields[0];
-            contextText += `Waiting for external action. Remind user: "${pending.instructions}"
-`;
-          } else if (contextState.pendingCancelConfirmation) {
-            contextText += `User is trying to cancel. Confirm: "You've spent time on this. Are you sure you want to cancel?"
-`;
-          } else if (contextState.uncertainFields.length > 0) {
-            const uncertain = contextState.uncertainFields[0];
-            contextText += `Ask user to confirm: "I understood your ${uncertain.label} as '${uncertain.value}'. Is that correct?"
-`;
-          } else if (contextState.nextField) {
-            const next = contextState.nextField;
-            const prompt = next.askPrompt || `Ask for their ${next.label}`;
-            contextText += `Next: ${prompt}
-`;
-            if (next.example) {
-              contextText += `Example: "${next.example}"
-`;
-            }
-          } else if (contextState.status === "ready") {
-            contextText += `All fields collected! Nudge user to submit: "I have everything I need. Ready to submit?"
-`;
+        }
+      ],
+      [
+        {
+          name: "{{user1}}",
+          content: { text: "Continue with my registration" }
+        },
+        {
+          name: "{{agentName}}",
+          content: {
+            text: "I've restored your Registration form. You're 60% complete."
           }
-          contextText += `
-`;
-          contextText += `## User Can Say
-`;
-          contextText += `- Provide information for any field
-`;
-          contextText += `- "undo" or "go back" to revert last change
-`;
-          contextText += `- "skip" to skip optional fields
-`;
-          contextText += `- "why?" to get explanation about a field
-`;
-          contextText += `- "how far?" to check progress
-`;
-          contextText += `- "submit" or "done" when ready
-`;
-          contextText += `- "save for later" to stash the form
-`;
-          contextText += `- "cancel" to abandon the form
-`;
-        } else {
-          contextState = {
-            hasActiveForm: false,
-            progress: 0,
-            filledFields: [],
-            missingRequired: [],
-            uncertainFields: [],
-            nextField: null,
-            stashedCount: stashed.length,
-            pendingExternalFields: []
-          };
         }
-        if (stashed.length > 0) {
-          contextText += `
-## Saved Forms
-`;
-          contextText += `User has ${stashed.length} saved form(s). They can say "resume" or "continue" to restore one.
-`;
-          for (const s of stashed) {
-            const form = formService.getForm(s.formId);
-            const ctx = formService.getSessionContext(s);
-            contextText += `- ${form?.name || s.formId} (${ctx.progress}% complete)
-`;
+      ],
+      [
+        {
+          name: "{{user1}}",
+          content: { text: "Pick up where I left off" }
+        },
+        {
+          name: "{{agentName}}",
+          content: {
+            text: "I've restored your form. Here's what you have so far..."
           }
         }
-        return {
-          data: JSON.parse(JSON.stringify(contextState)),
-          values: {
-            formContext: contextText,
-            hasActiveForm: String(contextState.hasActiveForm),
-            formProgress: String(contextState.progress),
-            formStatus: contextState.status || "",
-            stashedCount: String(stashed.length)
-          },
-          text: contextText
-        };
-      } catch (error) {
-        logger2.error("[FormContextProvider] Error:", String(error));
-        return {
-          data: { hasActiveForm: false, error: true },
-          values: { formContext: "Error loading form context." },
-          text: "Error loading form context."
-        };
-      }
-    }
+      ]
+    ]
   };
-  context_default = formContextProvider;
+  restore_default = formRestoreAction;
 });
 
 // src/evaluators/extractor.ts
@@ -2397,7 +2341,7 @@ var init_extractor = __esm(() => {
         return false;
       }
     },
-    handler: async (runtime, message, state) => {
+    handler: async (runtime, message, _state) => {
       try {
         const formService = runtime.getService("FORM");
         if (!formService)
@@ -2460,7 +2404,6 @@ var init_extractor = __esm(() => {
           case "restore":
             logger3.debug("[FormEvaluator] Restore intent - deferring to action");
             break;
-          case "fill_form":
           default:
             await processExtractions(runtime, formService, session, form, entityId, extractions, message.id);
             break;
@@ -2480,165 +2423,224 @@ var init_extractor = __esm(() => {
   extractor_default = formEvaluator;
 });
 
-// src/actions/restore.ts
-var exports_restore = {};
-__export(exports_restore, {
-  formRestoreAction: () => formRestoreAction,
-  default: () => restore_default
+// src/providers/context.ts
+var exports_context = {};
+__export(exports_context, {
+  formContextProvider: () => formContextProvider,
+  default: () => context_default
 });
-import {
-  logger as logger4
-} from "@elizaos/core";
-var formRestoreAction, restore_default;
-var init_restore = __esm(() => {
-  formRestoreAction = {
-    name: "FORM_RESTORE",
-    similes: ["RESUME_FORM", "CONTINUE_FORM"],
-    description: "Restore a previously stashed form session",
-    validate: async (runtime, message, _state) => {
-      try {
-        const text = message.content?.text || "";
-        const intent = quickIntentDetect(text);
-        if (intent !== "restore") {
-          return false;
-        }
-        const formService = runtime.getService("FORM");
-        if (!formService) {
-          return false;
-        }
-        const entityId = message.entityId;
-        if (!entityId)
-          return false;
-        const stashed = await formService.getStashedSessions(entityId);
-        return stashed.length > 0;
-      } catch (error) {
-        logger4.error("[FormRestoreAction] Validation error:", String(error));
-        return false;
-      }
-    },
-    handler: async (runtime, message, _state, _options, callback) => {
+import { logger as logger4 } from "@elizaos/core";
+var formContextProvider, context_default;
+var init_context = __esm(() => {
+  init_template();
+  formContextProvider = {
+    name: "FORM_CONTEXT",
+    description: "Provides context about active form sessions",
+    dynamic: true,
+    get: async (runtime, message, _state) => {
       try {
         const formService = runtime.getService("FORM");
         if (!formService) {
-          await callback?.({
-            text: "Sorry, I couldn't find the form service."
-          });
-          return { success: false };
+          return {
+            data: { hasActiveForm: false },
+            values: { formContext: "" },
+            text: ""
+          };
         }
         const entityId = message.entityId;
         const roomId = message.roomId;
         if (!entityId || !roomId) {
-          await callback?.({
-            text: "Sorry, I couldn't identify you."
-          });
-          return { success: false };
-        }
-        const existing = await formService.getActiveSession(entityId, roomId);
-        if (existing) {
-          const form2 = formService.getForm(existing.formId);
-          await callback?.({
-            text: `You already have an active form: "${form2?.name || existing.formId}". Would you like to continue with that one, or should I save it and restore your other form?`
-          });
-          return { success: false };
+          return {
+            data: { hasActiveForm: false },
+            values: { formContext: "" },
+            text: ""
+          };
         }
+        const session = await formService.getActiveSession(entityId, roomId);
         const stashed = await formService.getStashedSessions(entityId);
-        if (stashed.length === 0) {
-          await callback?.({
-            text: "You don't have any saved forms to resume."
-          });
-          return { success: false };
+        if (!session && stashed.length === 0) {
+          return {
+            data: { hasActiveForm: false, stashedCount: 0 },
+            values: { formContext: "" },
+            text: ""
+          };
         }
-        const sessionToRestore = stashed.sort((a, b) => b.updatedAt - a.updatedAt)[0];
-        const session = await formService.restore(sessionToRestore.id, entityId);
-        const form = formService.getForm(session.formId);
-        const context = formService.getSessionContext(session);
-        let responseText = `I've restored your "${form?.name || session.formId}" form. `;
-        responseText += `You're ${context.progress}% complete. `;
-        if (context.filledFields.length > 0) {
-          responseText += `
+        let contextText = "";
+        let contextState;
+        if (session) {
+          contextState = formService.getSessionContext(session);
+          const form = formService.getForm(session.formId);
+          const templateValues = buildTemplateValues(session);
+          const resolveText = (value) => renderTemplate(value, templateValues);
+          contextState = {
+            ...contextState,
+            filledFields: contextState.filledFields.map((field) => ({
+              ...field,
+              label: resolveText(field.label) ?? field.label
+            })),
+            missingRequired: contextState.missingRequired.map((field) => ({
+              ...field,
+              label: resolveText(field.label) ?? field.label,
+              description: resolveText(field.description),
+              askPrompt: resolveText(field.askPrompt)
+            })),
+            uncertainFields: contextState.uncertainFields.map((field) => ({
+              ...field,
+              label: resolveText(field.label) ?? field.label
+            })),
+            nextField: contextState.nextField ? resolveControlTemplates(contextState.nextField, templateValues) : null
+          };
+          contextText = `# Active Form: ${form?.name || session.formId}
 
-Here's what I have so far:
 `;
-          for (const field of context.filledFields) {
-            responseText += `• ${field.label}: ${field.displayValue}
+          contextText += `Progress: ${contextState.progress}%
+
+`;
+          if (contextState.filledFields.length > 0) {
+            contextText += `## Collected Information
+`;
+            for (const field of contextState.filledFields) {
+              contextText += `- ${field.label}: ${field.displayValue}
+`;
+            }
+            contextText += `
 `;
           }
-        }
-        if (context.nextField) {
-          responseText += `
-Let's continue with ${context.nextField.label}.`;
-          if (context.nextField.askPrompt) {
-            responseText += ` ${context.nextField.askPrompt}`;
+          if (contextState.missingRequired.length > 0) {
+            contextText += `## Still Needed
+`;
+            for (const field of contextState.missingRequired) {
+              contextText += `- ${field.label}${field.description ? ` (${field.description})` : ""}
+`;
+            }
+            contextText += `
+`;
           }
-        } else if (context.status === "ready") {
-          responseText += `
-Everything looks complete! Ready to submit?`;
-        }
-        await callback?.({
-          text: responseText
-        });
-        return {
-          success: true,
-          data: {
-            sessionId: session.id,
-            formId: session.formId,
-            progress: context.progress
+          if (contextState.uncertainFields.length > 0) {
+            contextText += `## Needs Confirmation
+`;
+            for (const field of contextState.uncertainFields) {
+              contextText += `- ${field.label}: "${field.value}" (${Math.round(field.confidence * 100)}% confident)
+`;
+            }
+            contextText += `
+`;
           }
-        };
-      } catch (error) {
-        logger4.error("[FormRestoreAction] Handler error:", String(error));
-        await callback?.({
-          text: "Sorry, I couldn't restore your form. Please try again."
-        });
-        return { success: false };
-      }
-    },
-    examples: [
-      [
-        {
-          name: "{{user1}}",
-          content: { text: "Resume my form" }
-        },
-        {
-          name: "{{agentName}}",
-          content: {
-            text: "I've restored your form. Let's continue where you left off."
+          if (contextState.pendingExternalFields.length > 0) {
+            contextText += `## Waiting For External Action
+`;
+            for (const field of contextState.pendingExternalFields) {
+              const ageMs = Date.now() - field.activatedAt;
+              const ageMin = Math.floor(ageMs / 60000);
+              const ageText = ageMin < 1 ? "just now" : `${ageMin}m ago`;
+              contextText += `- ${field.label}: ${field.instructions} (started ${ageText})
+`;
+              if (field.address) {
+                contextText += `  Address: ${field.address}
+`;
+              }
+            }
+            contextText += `
+`;
           }
-        }
-      ],
-      [
-        {
-          name: "{{user1}}",
-          content: { text: "Continue with my registration" }
-        },
-        {
-          name: "{{agentName}}",
-          content: {
-            text: "I've restored your Registration form. You're 60% complete."
+          contextText += `## Agent Guidance
+`;
+          if (contextState.pendingExternalFields.length > 0) {
+            const pending = contextState.pendingExternalFields[0];
+            contextText += `Waiting for external action. Remind user: "${pending.instructions}"
+`;
+          } else if (contextState.pendingCancelConfirmation) {
+            contextText += `User is trying to cancel. Confirm: "You've spent time on this. Are you sure you want to cancel?"
+`;
+          } else if (contextState.uncertainFields.length > 0) {
+            const uncertain = contextState.uncertainFields[0];
+            contextText += `Ask user to confirm: "I understood your ${uncertain.label} as '${uncertain.value}'. Is that correct?"
+`;
+          } else if (contextState.nextField) {
+            const next = contextState.nextField;
+            const prompt = next.askPrompt || `Ask for their ${next.label}`;
+            contextText += `Next: ${prompt}
+`;
+            if (next.example) {
+              contextText += `Example: "${next.example}"
+`;
+            }
+          } else if (contextState.status === "ready") {
+            contextText += `All fields collected! Nudge user to submit: "I have everything I need. Ready to submit?"
+`;
           }
+          contextText += `
+`;
+          contextText += `## User Can Say
+`;
+          contextText += `- Provide information for any field
+`;
+          contextText += `- "undo" or "go back" to revert last change
+`;
+          contextText += `- "skip" to skip optional fields
+`;
+          contextText += `- "why?" to get explanation about a field
+`;
+          contextText += `- "how far?" to check progress
+`;
+          contextText += `- "submit" or "done" when ready
+`;
+          contextText += `- "save for later" to stash the form
+`;
+          contextText += `- "cancel" to abandon the form
+`;
+        } else {
+          contextState = {
+            hasActiveForm: false,
+            progress: 0,
+            filledFields: [],
+            missingRequired: [],
+            uncertainFields: [],
+            nextField: null,
+            stashedCount: stashed.length,
+            pendingExternalFields: []
+          };
         }
-      ],
-      [
-        {
-          name: "{{user1}}",
-          content: { text: "Pick up where I left off" }
-        },
-        {
-          name: "{{agentName}}",
-          content: {
-            text: "I've restored your form. Here's what you have so far..."
+        if (stashed.length > 0) {
+          contextText += `
+## Saved Forms
+`;
+          contextText += `User has ${stashed.length} saved form(s). They can say "resume" or "continue" to restore one.
+`;
+          for (const s of stashed) {
+            const form = formService.getForm(s.formId);
+            const ctx = formService.getSessionContext(s);
+            contextText += `- ${form?.name || s.formId} (${ctx.progress}% complete)
+`;
           }
         }
-      ]
-    ]
+        return {
+          data: JSON.parse(JSON.stringify(contextState)),
+          values: {
+            formContext: contextText,
+            hasActiveForm: String(contextState.hasActiveForm),
+            formProgress: String(contextState.progress),
+            formStatus: contextState.status || "",
+            stashedCount: String(stashed.length)
+          },
+          text: contextText
+        };
+      } catch (error) {
+        logger4.error("[FormContextProvider] Error:", String(error));
+        return {
+          data: { hasActiveForm: false, error: true },
+          values: { formContext: "Error loading form context." },
+          text: "Error loading form context."
+        };
+      }
+    }
   };
-  restore_default = formRestoreAction;
+  context_default = formContextProvider;
 });
 
-// src/index.ts
+// index.ts
 init_builtins();
 init_validation();
-init_validation();
 init_storage();
 init_extraction();
 init_types();
@@ -2963,7 +2965,7 @@ class FormBuilder {
   }
   control(builder) {
     const ctrl = builder instanceof ControlBuilder ? builder.build() : builder;
-    this.form.controls.push(ctrl);
+    this.form.controls?.push(ctrl);
     return this;
   }
   controls(...builders) {
@@ -3080,11 +3082,11 @@ function prettify2(key) {
   return key.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
 
-// src/index.ts
+// index.ts
 init_service();
-init_context();
-init_extractor();
 init_restore();
+init_extractor();
+init_context();
 
 // src/tasks/nudge.ts
 import { logger as logger5 } from "@elizaos/core";
@@ -3175,7 +3177,7 @@ async function sendExpirationWarning(runtime, session, form) {
   }
 }
 
-// src/index.ts
+// index.ts
 var formPlugin = {
   name: "form",
   description: "Agent-native conversational forms for data collection",
@@ -3192,6 +3194,7 @@ var formPlugin = {
     {
       name: "FORM_CONTEXT",
       description: "Provides context about active form sessions",
+      dynamic: true,
       get: async (runtime, message, state) => {
         const { formContextProvider: formContextProvider2 } = await Promise.resolve().then(() => (init_context(), exports_context));
         return formContextProvider2.get(runtime, message, state);
@@ -3244,7 +3247,7 @@ var formPlugin = {
     }
   ]
 };
-var src_default = formPlugin;
+var typescript_default = formPlugin;
 export {
   validateField,
   shouldNudge,
@@ -3284,7 +3287,7 @@ export {
   extractSingleField,
   detectCorrection,
   deleteSession,
-  src_default as default,
+  typescript_default as default,
   clearTypeHandlers,
   calculateTTL,
   applyFormDefaults,
@@ -3303,4 +3306,4 @@ export {
   BUILTIN_TYPES
 };
 
-//# debugId=11830BB10982F7F464756E2164756E21
+//# debugId=DC90FD3CDE2C7E4764756E2164756E21