@deepagents/context 4.2.1 → 4.3.0

package/README.md

@@ -300,15 +300,16 @@ const ranges = getReminderRanges(message.metadata).filter(
   (range) => range.partIndex === partIndex,
 );
 const visibleText = stripTextByRanges(message.parts[partIndex].text, ranges);
+const firedOnceIds = getReminderOnceIds(message);
 const messageWithoutReminders = stripReminders(message);
 ```
 
 - `getReminderRanges(metadata)` returns `metadata.reminders` as offset ranges (or `[]` when missing).
+- `getReminderOnceIds(message)` returns durable `once(id)` latch ids stored on a user message.
 
 Conditional reminders are registered on the engine, not inside `user(...)`.
 They can react to turn cadence, classifier matches, tool activity, assistant
-history, token usage, idle time, live tool output, and mid-loop streamed step
-boundaries:
+history, token usage, idle time, live tool output, and mid-loop steer points:
 
 For `target: 'tool-output'`, gate on `ctx.executingTool` to inspect the live
 tool call being wrapped. Assistant-history predicates such as `toolCalled(...)`
@@ -317,10 +318,10 @@ only describe already persisted calls.
 ```ts
 import {
   anyToolCalled,
+  elapsedExceeds,
   everyOfLastN,
   not,
   reminder,
-  streamStepsExceed,
   toolCalled,
   usageExceeds,
   user,
@@ -337,8 +338,8 @@ engine.set(
   reminder('Pause and summarize if the thread is getting expensive', {
     when: usageExceeds(20_000),
   }),
-  reminder('Checkpoint before taking another streamed tool step', {
-    when: streamStepsExceed(2),
+  reminder('Checkpoint before a long-running streamed turn continues', {
+    when: elapsedExceeds(40 * 60_000),
     target: 'steer',
   }),
   reminder('If no tools were needed for three turns, keep the answer brief', {
@@ -350,8 +351,7 @@ engine.set(
 
 Other exported helpers include `toolCallCount(...)`,
 `lastAssistantLength(...)`, `withinLastN(...)`, `everyOfLastN(...)`, and
-`elapsedExceeds(...)`. Streamed-turn helpers include `streamStepsExceed(...)`,
-`streamToolCallsExceed(...)`, and `streamUsageExceeds(...)`. See the
+`elapsedExceeds(...)`. See the
 [Predicates](https://januarylabs.github.io/deepagents/docs/context/predicates)
 page for the full catalog.
 

package/dist/browser.d.ts

@@ -10,6 +10,8 @@ export * from './lib/estimate.ts';
 export * from './lib/fragments.ts';
 export * from './lib/fragments/domain.ts';
 export * from './lib/fragments/message/user.ts';
+export * from './lib/fragments/reminders/src/reminders.ts';
+export type { BaseWhenCtx, ConditionalReminder, CountSpec, ReminderContext, ReminderFragment, ReminderOptions, ReminderRange, ReminderResolution, ReminderTarget, ReminderText, SyncReminderText, SyntheticSteerMetadata, UserReminderMetadata, WhenContext, WhenPredicate, } from './lib/fragments/reminders/src/types.ts';
 export * from './lib/fragments/user.ts';
 export * from './lib/guardrail.ts';
 export * from './lib/models.generated.ts';

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qCAAqC,CAAC;AACpD,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4CAA4C,CAAC;AAC3D,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,WAAW,EACX,aAAa,GACd,MAAM,wCAAwC,CAAC;AAChD,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iBAAiB,CAAC;AAChC,cAAc,sCAAsC,CAAC;AACrD,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/browser.js

@@ -912,8 +912,32 @@ async function estimate(modelId, renderer, ...fragments) {
 }
 
 // packages/context/src/lib/fragments/message/user.ts
+import { generateId as generateId2 } from "ai";
+function user(content) {
+  const message2 = typeof content === "string" ? {
+    id: generateId2(),
+    role: "user",
+    parts: [{ type: "text", text: content }]
+  } : { ...content, role: "user", parts: [...content.parts] };
+  return {
+    id: message2.id,
+    name: "user",
+    type: "message",
+    persist: true,
+    codec: {
+      decode() {
+        return message2;
+      },
+      encode() {
+        return message2;
+      }
+    }
+  };
+}
+
+// packages/context/src/lib/fragments/reminders/src/reminders.ts
 import {
-  generateId as generateId2,
+  generateId as generateId3,
   isStaticToolUIPart
 } from "ai";
 
@@ -1802,7 +1826,7 @@ function extractPlainText(message2) {
   return getTextParts(message2).join(" ");
 }
 
-// packages/context/src/lib/fragments/message/user.ts
+// packages/context/src/lib/fragments/reminders/src/reminders.ts
 function isConditionalReminder(fragment2) {
   return fragment2.name === "reminder" && !!fragment2.metadata?.reminder;
 }
@@ -1953,7 +1977,7 @@ function applyInlineReminder(message2, value) {
   const updatedText = `${textPart.text}${reminderText}`;
   message2.parts[partIndex] = { ...textPart, text: updatedText };
   return {
-    id: generateId2(),
+    id: generateId3(),
     text: value,
     target: "user",
     partIndex,
@@ -1968,7 +1992,7 @@ function applyPartReminder(message2, value) {
   message2.parts.push(part);
   const partIndex = message2.parts.length - 1;
   return {
-    id: generateId2(),
+    id: generateId3(),
     text: value,
     target: "user",
     partIndex,
@@ -2071,27 +2095,6 @@ function reminder(textOrFragment, options) {
     }
   };
 }
-function user(content) {
-  const message2 = typeof content === "string" ? {
-    id: generateId2(),
-    role: "user",
-    parts: [{ type: "text", text: content }]
-  } : { ...content, role: "user", parts: [...content.parts] };
-  return {
-    id: message2.id,
-    name: "user",
-    type: "message",
-    persist: true,
-    codec: {
-      decode() {
-        return message2;
-      },
-      encode() {
-        return message2;
-      }
-    }
-  };
-}
 function applyUserRemindersToMessage(message2, reminders) {
   if (reminders.length === 0) return;
   const plainText = extractPlainText(message2);
@@ -2106,7 +2109,7 @@ function synthesizeSteerUserMessage(text, firedAt, onceIds = []) {
   const texts = Array.isArray(text) ? text : [text];
   for (const value of texts) assertReminderText(value);
   return {
-    id: generateId2(),
+    id: generateId3(),
     role: "user",
     parts: texts.map((value) => ({
       type: "text",