@deepagents/context 0.27.0 → 0.29.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;
     }
@@ -920,6 +901,27 @@ async function estimate(modelId, renderer, ...fragments) {
 
 // packages/context/src/lib/fragments/message/user.ts
 import { generateId as generateId2, isTextUIPart } from "ai";
+function everyNTurns(n) {
+  return (turn) => turn % n === 0;
+}
+function once() {
+  return (turn) => turn === 1;
+}
+function firstN(n) {
+  return (turn) => turn <= n;
+}
+function afterTurn(n) {
+  return (turn) => turn > n;
+}
+function and(...predicates) {
+  return (turn) => predicates.every((p) => p(turn));
+}
+function or(...predicates) {
+  return (turn) => predicates.some((p) => p(turn));
+}
+function not(predicate) {
+  return (turn) => !predicate(turn);
+}
 var SYSTEM_REMINDER_OPEN_TAG = "<system-reminder>";
 var SYSTEM_REMINDER_CLOSE_TAG = "</system-reminder>";
 function getReminderRanges(metadata) {
@@ -1054,26 +1056,39 @@ function applyPartReminder(message2, value) {
     mode: "part"
   };
 }
+function hasSchedule(reminder2) {
+  return reminder2.when !== void 0;
+}
+function shouldIncludeReminder(reminder2, turn) {
+  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?.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 +1103,7 @@ function user(content, ...reminders) {
       message2.metadata = metadata;
     }
   }
+  const fragmentMetadata = scheduledReminders.length > 0 ? { scheduledReminders } : void 0;
   return {
     id: message2.id,
     name: "user",
@@ -1100,7 +1116,8 @@ function user(content, ...reminders) {
       encode() {
         return message2;
       }
-    }
+    },
+    metadata: fragmentMetadata
   };
 }
 
@@ -2166,17 +2183,23 @@ export {
   TomlRenderer,
   ToonRenderer,
   XmlRenderer,
+  afterTurn,
   alias,
   analogy,
+  and,
+  applyInlineReminder,
+  applyPartReminder,
   assistant,
   assistantText,
   clarification,
   correction,
   defaultTokenizer,
   estimate,
+  everyNTurns,
   example,
   explain,
   fail,
+  firstN,
   fragment,
   fromFragment,
   getFragmentData,
@@ -2184,6 +2207,7 @@ export {
   getReminderRanges,
   glossary,
   guardrail,
+  hasSchedule,
   hint,
   identity,
   isFragment,
@@ -2192,6 +2216,9 @@ export {
   isMessageFragment,
   lastAssistantMessage,
   message,
+  not,
+  once,
+  or,
   pass,
   persistedWriter,
   persona,
@@ -2201,8 +2228,10 @@ export {
   quirk,
   reminder,
   render,
+  resolveReminderText,
   role,
   runGuardrailChain,
+  shouldIncludeReminder,
   soul,
   stop,
   stripReminders,