@deepagents/context 0.27.0 → 0.28.0

package/dist/browser.js

@@ -581,44 +581,38 @@ function toFragmentData(value, options) {
 }
 var builtInSerializedRegistry = {
   term: {
-    toFragment: (input) => term(input.name, input.definition),
-    fromFragment: () => void 0
+    toFragment: (input) => term(input.name, input.definition)
   },
   hint: {
-    toFragment: (input) => hint(input.text),
-    fromFragment: () => void 0
+    toFragment: (input) => hint(input.text)
   },
   guardrail: {
     toFragment: (input) => guardrail({
       rule: input.rule,
       reason: input.reason,
       action: input.action
-    }),
-    fromFragment: () => void 0
+    })
   },
   explain: {
     toFragment: (input) => explain({
       concept: input.concept,
       explanation: input.explanation,
       therefore: input.therefore
-    }),
-    fromFragment: () => void 0
+    })
   },
   example: {
     toFragment: (input) => example({
       question: input.question,
       answer: input.answer,
       note: input.note
-    }),
-    fromFragment: () => void 0
+    })
   },
   clarification: {
     toFragment: (input) => clarification({
       when: input.when,
       ask: input.ask,
       reason: input.reason
-    }),
-    fromFragment: () => void 0
+    })
   },
   workflow: {
     toFragment: (input) => workflow({
@@ -626,23 +620,20 @@ var builtInSerializedRegistry = {
       steps: input.steps,
       triggers: input.triggers,
       notes: input.notes
-    }),
-    fromFragment: () => void 0
+    })
   },
   quirk: {
     toFragment: (input) => quirk({
       issue: input.issue,
       workaround: input.workaround
-    }),
-    fromFragment: () => void 0
+    })
   },
   styleGuide: {
     toFragment: (input) => styleGuide({
       prefer: input.prefer,
       never: input.never,
       always: input.always
-    }),
-    fromFragment: () => void 0
+    })
   },
   analogy: {
     toFragment: (input) => analogy({
@@ -651,24 +642,20 @@ var builtInSerializedRegistry = {
       insight: input.insight,
       therefore: input.therefore,
       pitfall: input.pitfall
-    }),
-    fromFragment: () => void 0
+    })
   },
   glossary: {
-    toFragment: (input) => glossary(input.entries),
-    fromFragment: () => void 0
+    toFragment: (input) => glossary(input.entries)
   },
   role: {
-    toFragment: (input) => role(input.content),
-    fromFragment: () => void 0
+    toFragment: (input) => role(input.content)
   },
   principle: {
     toFragment: (input, options) => principle({
       title: input.title,
       description: input.description,
       policies: input.policies?.map((item) => toFragmentData(item, options))
-    }),
-    fromFragment: () => void 0
+    })
   },
   policy: {
     toFragment: (input, options) => policy({
@@ -676,15 +663,13 @@ var builtInSerializedRegistry = {
       before: input.before,
       reason: input.reason,
       policies: input.policies?.map((item) => toFragmentData(item, options))
-    }),
-    fromFragment: () => void 0
+    })
   },
   identity: {
     toFragment: (input) => identity({
       name: input.name,
       role: input.role
-    }),
-    fromFragment: () => void 0
+    })
   },
   persona: {
     toFragment: (input) => persona({
@@ -692,20 +677,16 @@ var builtInSerializedRegistry = {
       role: input.role,
       objective: input.objective,
       tone: input.tone
-    }),
-    fromFragment: () => void 0
+    })
   },
   alias: {
-    toFragment: (input) => alias(input.term, input.meaning),
-    fromFragment: () => void 0
+    toFragment: (input) => alias(input.term, input.meaning)
   },
   preference: {
-    toFragment: (input) => preference(input.aspect, input.value),
-    fromFragment: () => void 0
+    toFragment: (input) => preference(input.aspect, input.value)
   },
   correction: {
-    toFragment: (input) => correction(input.subject, input.clarification),
-    fromFragment: () => void 0
+    toFragment: (input) => correction(input.subject, input.clarification)
   }
 };
 var messageLikeTypes = /* @__PURE__ */ new Set(["user", "assistant", "message"]);
@@ -714,7 +695,7 @@ function findCustomSerializedFragment(fragment2, options) {
     return void 0;
   }
   for (const entry of Object.values(options.registry)) {
-    const serialized = entry.fromFragment(fragment2, options);
+    const serialized = entry.fromFragment?.(fragment2, options);
     if (serialized !== void 0) {
       return serialized;
     }
@@ -1054,26 +1035,51 @@ function applyPartReminder(message2, value) {
     mode: "part"
   };
 }
+function hasSchedule(reminder2) {
+  return reminder2.everyNTurns !== void 0 || reminder2.once !== void 0 || reminder2.firstN !== void 0 || reminder2.afterTurn !== void 0 || reminder2.when !== void 0;
+}
+function shouldIncludeReminder(reminder2, turn) {
+  if (reminder2.once && turn !== 1) return false;
+  if (reminder2.firstN !== void 0 && turn > reminder2.firstN) return false;
+  if (reminder2.afterTurn !== void 0 && turn <= reminder2.afterTurn)
+    return false;
+  if (reminder2.everyNTurns !== void 0 && turn % reminder2.everyNTurns !== 0)
+    return false;
+  if (reminder2.when && !reminder2.when(turn)) return false;
+  return true;
+}
 function reminder(text, options) {
   if (typeof text === "string") {
     assertReminderText(text);
   }
   return {
     text,
-    asPart: options?.asPart ?? false
+    asPart: options?.asPart ?? false,
+    ...options?.everyNTurns !== void 0 && {
+      everyNTurns: options.everyNTurns
+    },
+    ...options?.once !== void 0 && { once: options.once },
+    ...options?.firstN !== void 0 && { firstN: options.firstN },
+    ...options?.afterTurn !== void 0 && { afterTurn: options.afterTurn },
+    ...options?.when !== void 0 && { when: options.when }
   };
 }
+function resolveReminderText(item, ctx) {
+  return typeof item.text === "function" ? item.text(ctx) : item.text;
+}
 function user(content, ...reminders) {
   const message2 = typeof content === "string" ? {
     id: generateId2(),
     role: "user",
     parts: [{ type: "text", text: content }]
   } : { ...content, role: "user", parts: [...content.parts] };
-  if (reminders.length > 0) {
+  const immediateReminders = reminders.filter((r) => !hasSchedule(r));
+  const scheduledReminders = reminders.filter((r) => hasSchedule(r));
+  if (immediateReminders.length > 0) {
     const addedReminders = [];
     const plainText = extractPlainText(message2);
-    for (const item of reminders) {
-      const resolvedText = typeof item.text === "function" ? item.text(plainText) : item.text;
+    for (const item of immediateReminders) {
+      const resolvedText = resolveReminderText(item, { content: plainText });
       if (resolvedText.trim().length === 0) {
         continue;
       }
@@ -1088,6 +1094,7 @@ function user(content, ...reminders) {
       message2.metadata = metadata;
     }
   }
+  const fragmentMetadata = scheduledReminders.length > 0 ? { scheduledReminders } : void 0;
   return {
     id: message2.id,
     name: "user",
@@ -1100,7 +1107,8 @@ function user(content, ...reminders) {
       encode() {
         return message2;
       }
-    }
+    },
+    metadata: fragmentMetadata
   };
 }
 
@@ -2168,6 +2176,8 @@ export {
   XmlRenderer,
   alias,
   analogy,
+  applyInlineReminder,
+  applyPartReminder,
   assistant,
   assistantText,
   clarification,
@@ -2184,6 +2194,7 @@ export {
   getReminderRanges,
   glossary,
   guardrail,
+  hasSchedule,
   hint,
   identity,
   isFragment,
@@ -2201,8 +2212,10 @@ export {
   quirk,
   reminder,
   render,
+  resolveReminderText,
   role,
   runGuardrailChain,
+  shouldIncludeReminder,
   soul,
   stop,
   stripReminders,