@elizaos/plugin-form 2.0.0-alpha.3 → 2.0.0-alpha.4

package/dist/{node/index.node.js → 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/esm/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,8 +630,8 @@ var init_stringify = __esm(() => {
   }
 });
 
-// ../../../../node_modules/uuid/dist/esm/rng.js
-import { randomFillSync } from "crypto";
+// node_modules/uuid/dist-node/rng.js
+import { randomFillSync } from "node:crypto";
 function rng() {
   if (poolPtr > rnds8Pool.length - 16) {
     randomFillSync(rnds8Pool);
@@ -656,18 +645,15 @@ var init_rng = __esm(() => {
   poolPtr = rnds8Pool.length;
 });
 
-// ../../../../node_modules/uuid/dist/esm/native.js
-import { randomUUID } from "crypto";
+// 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/esm/v4.js
-function v4(options, buf, offset) {
-  if (native_default.randomUUID && !buf && !options) {
-    return native_default.randomUUID();
-  }
+// node_modules/uuid/dist-node/v4.js
+function _v4(options, buf, offset) {
   options = options || {};
   const rnds = options.random ?? options.rng?.() ?? rng();
   if (rnds.length < 16) {
@@ -687,6 +673,12 @@ function v4(options, buf, offset) {
   }
   return unsafeStringify(rnds);
 }
+function v4(options, buf, offset) {
+  if (native_default.randomUUID && !buf && !options) {
+    return native_default.randomUUID();
+  }
+  return _v4(options, buf, offset);
+}
 var v4_default;
 var init_v4 = __esm(() => {
   init_native();
@@ -695,8 +687,8 @@ var init_v4 = __esm(() => {
   v4_default = v4;
 });
 
-// ../../../../node_modules/uuid/dist/esm/index.js
-var init_esm = __esm(() => {
+// node_modules/uuid/dist-node/index.js
+var init_dist_node = __esm(() => {
   init_v4();
 });
 
@@ -868,7 +860,7 @@ var isRecord = (value) => typeof value === "object" && value !== null && !Array.
   return typeof data.formId === "string" && typeof data.updatedAt === "number" && typeof data.values === "object";
 };
 var init_storage = __esm(() => {
-  init_esm();
+  init_dist_node();
   init_types();
 });
 
@@ -1037,7 +1029,7 @@ function parseExtractionResponse(response) {
         }
       }
     }
-  } catch (error) {
+  } catch (_error) {
     const intentMatch = response.match(/<intent>([^<]+)<\/intent>/);
     if (intentMatch) {
       const intentStr = intentMatch[1].toLowerCase().trim();
@@ -1187,9 +1179,8 @@ Respond in XML:
   }
 }
 var init_extraction = __esm(() => {
-  init_validation();
-  init_validation();
   init_template();
+  init_validation();
 });
 
 // src/service.ts
@@ -1198,19 +1189,19 @@ __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());
 }
 var FormService;
 var init_service = __esm(() => {
-  init_esm();
-  init_types();
+  init_dist_node();
+  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";
@@ -1251,6 +1242,13 @@ 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) {
@@ -1679,7 +1677,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}`);
@@ -1722,7 +1720,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}`);
@@ -2039,218 +2037,159 @@ 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) => {
       try {
+        const text = message.content?.text || "";
+        const intent = quickIntentDetect(text);
+        if (intent !== "restore") {
+          return false;
+        }
         const formService = runtime.getService("FORM");
         if (!formService) {
-          return {
-            data: { hasActiveForm: false },
-            values: { formContext: "" },
-            text: ""
-          };
+          return false;
+        }
+        const entityId = message.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;
+      }
+    },
+    handler: async (runtime, message, _state, _options, callback) => {
+      try {
+        const formService = runtime.getService("FORM");
+        if (!formService) {
+          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
@@ -2387,7 +2326,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)
@@ -2450,7 +2389,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;
@@ -2470,165 +2408,223 @@ 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",
+    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();
@@ -2953,7 +2949,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) {
@@ -3070,11 +3066,102 @@ 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";
+var formNudgeWorker = {
+  name: "form_nudge_check",
+  validate: async (_runtime, _message, _state) => {
+    return true;
+  },
+  execute: async (runtime, _options, _task) => {
+    try {
+      const formService = runtime.getService("FORM");
+      if (!formService) {
+        logger5.debug("[FormNudge] Form service not available");
+        return;
+      }
+      logger5.debug("[FormNudge] Nudge check cycle completed");
+    } catch (error) {
+      logger5.error("[FormNudge] Error during nudge check:", String(error));
+    }
+  }
+};
+async function processEntityNudges(runtime, entityId) {
+  const formService = runtime.getService("FORM");
+  if (!formService)
+    return;
+  const activeSessions = await formService.getAllActiveSessions(entityId);
+  const stashedSessions = await formService.getStashedSessions(entityId);
+  const allSessions = [...activeSessions, ...stashedSessions];
+  const now = Date.now();
+  const expirationWarningMs = 24 * 60 * 60 * 1000;
+  for (const session of allSessions) {
+    const form = formService.getForm(session.formId);
+    if (session.expiresAt < now) {
+      session.status = "expired";
+      await formService.saveSession(session);
+      if (form?.hooks?.onExpire) {
+        const worker = runtime.getTaskWorker(form.hooks.onExpire);
+        if (worker) {
+          try {
+            await worker.execute(runtime, { session, form }, {});
+          } catch (error) {
+            logger5.error("[FormNudge] onExpire hook failed:", String(error));
+          }
+        }
+      }
+      logger5.debug(`[FormNudge] Session ${session.id} expired`);
+      continue;
+    }
+    if (isExpiringSoon(session, expirationWarningMs) && !session.expirationWarned) {
+      await sendExpirationWarning(runtime, session, form);
+      session.expirationWarned = true;
+      await formService.saveSession(session);
+      continue;
+    }
+    if (session.status === "stashed" && shouldNudge(session, form)) {
+      await sendNudge(runtime, session, form);
+      session.nudgeCount = (session.nudgeCount || 0) + 1;
+      session.lastNudgeAt = now;
+      await formService.saveSession(session);
+    }
+  }
+}
+async function sendNudge(runtime, session, form) {
+  const message = form?.nudge?.message || `You have an unfinished "${form?.name || "form"}". Would you like to continue?`;
+  try {
+    if (typeof runtime.sendMessageToRoom === "function") {
+      await runtime.sendMessageToRoom(session.roomId, {
+        text: message
+      });
+      logger5.debug(`[FormNudge] Sent nudge for session in room ${session.roomId}`);
+    }
+  } catch (error) {
+    logger5.error("[FormNudge] Failed to send nudge:", String(error));
+  }
+}
+async function sendExpirationWarning(runtime, session, form) {
+  const remaining = formatTimeRemaining(session);
+  const message = `Your "${form?.name || "form"}" form will expire in ${remaining}. Say "resume" to keep working on it.`;
+  try {
+    if (typeof runtime.sendMessageToRoom === "function") {
+      await runtime.sendMessageToRoom(session.roomId, {
+        text: message
+      });
+      logger5.debug(`[FormNudge] Sent expiration warning for session in room ${session.roomId}`);
+    }
+  } catch (error) {
+    logger5.error("[FormNudge] Failed to send expiration warning:", String(error));
+  }
+}
+
+// index.ts
 var formPlugin = {
   name: "form",
   description: "Agent-native conversational forms for data collection",
@@ -3143,7 +3230,7 @@ var formPlugin = {
     }
   ]
 };
-var src_default = formPlugin;
+var typescript_default = formPlugin;
 export {
   validateField,
   shouldNudge,
@@ -3154,6 +3241,7 @@ export {
   registerTypeHandler,
   registerBuiltinTypes,
   quickIntentDetect,
+  processEntityNudges,
   prettify,
   parseValue,
   matchesMimeType,
@@ -3176,12 +3264,13 @@ export {
   formatEffort,
   formRestoreAction,
   formPlugin,
+  formNudgeWorker,
   formEvaluator,
   formContextProvider,
   extractSingleField,
   detectCorrection,
   deleteSession,
-  src_default as default,
+  typescript_default as default,
   clearTypeHandlers,
   calculateTTL,
   applyFormDefaults,
@@ -3200,4 +3289,5 @@ export {
   BUILTIN_TYPES
 };
 
-//# debugId=6EC545854C3E8D8A64756E2164756E21
+//# debugId=D9CCEBB86B648A7B64756E2164756E21
+//# sourceMappingURL=index.js.map