@deepagents/context 0.34.0 → 0.35.0

package/dist/browser.js

@@ -902,373 +902,6 @@ async function estimate(modelId, renderer, ...fragments) {
 // packages/context/src/lib/fragments/message/user.ts
 import { generateId as generateId2 } from "ai";
 
-// packages/context/src/lib/text.ts
-import { isTextUIPart } from "ai";
-function getTextParts(message2) {
-  return message2.parts.filter(isTextUIPart).map((part) => part.text);
-}
-function extractPlainText(message2) {
-  return getTextParts(message2).join(" ");
-}
-
-// packages/context/src/lib/fragments/message/user.ts
-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 (ctx) => predicates.every((p) => p(ctx));
-}
-function or(...predicates) {
-  return (ctx) => predicates.some((p) => p(ctx));
-}
-function not(predicate) {
-  return (ctx) => !predicate(ctx);
-}
-function contentIncludes(keywords) {
-  const lower = keywords.map((k) => k.toLowerCase());
-  return (ctx) => {
-    const text = ctx.content.toLowerCase();
-    return lower.some((kw) => text.includes(kw));
-  };
-}
-function contentPattern(pattern) {
-  return (ctx) => {
-    pattern.lastIndex = 0;
-    return pattern.test(ctx.content);
-  };
-}
-function toDateParts(date, tz) {
-  const parts = new Intl.DateTimeFormat("en-CA", {
-    timeZone: tz,
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit",
-    hour: "2-digit",
-    hourCycle: "h23"
-  }).formatToParts(date);
-  const get = (type) => parts.find((p) => p.type === type).value;
-  return {
-    year: get("year"),
-    month: get("month"),
-    day: get("day"),
-    hour: get("hour")
-  };
-}
-function temporalChanged(ctx, tz, getKey) {
-  if (ctx.lastMessageAt === void 0) return true;
-  const nowParts = toDateParts(/* @__PURE__ */ new Date(), tz);
-  const prevParts = toDateParts(new Date(ctx.lastMessageAt), tz);
-  return getKey(nowParts) !== getKey(prevParts);
-}
-function getSeason(month) {
-  if (month >= 2 && month <= 4) return "Spring";
-  if (month >= 5 && month <= 7) return "Summer";
-  if (month >= 8 && month <= 10) return "Fall";
-  return "Winter";
-}
-function isoWeekKey(parts) {
-  const d = new Date(
-    Date.UTC(
-      parseInt(parts.year),
-      parseInt(parts.month) - 1,
-      parseInt(parts.day)
-    )
-  );
-  d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
-  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
-  const weekNo = Math.ceil(
-    ((d.getTime() - yearStart.getTime()) / 864e5 + 1) / 7
-  );
-  return `${d.getUTCFullYear()}-W${String(weekNo).padStart(2, "0")}`;
-}
-function dayChanged(tz = "UTC") {
-  return (ctx) => temporalChanged(ctx, tz, (p) => `${p.year}-${p.month}-${p.day}`);
-}
-function hourChanged(tz = "UTC") {
-  return (ctx) => temporalChanged(ctx, tz, (p) => `${p.year}-${p.month}-${p.day}-${p.hour}`);
-}
-function monthChanged(tz = "UTC") {
-  return (ctx) => temporalChanged(ctx, tz, (p) => `${p.year}-${p.month}`);
-}
-function yearChanged(tz = "UTC") {
-  return (ctx) => temporalChanged(ctx, tz, (p) => p.year);
-}
-function seasonChanged(tz = "UTC") {
-  return (ctx) => temporalChanged(ctx, tz, (p) => getSeason(parseInt(p.month) - 1));
-}
-function weekChanged(tz = "UTC") {
-  return (ctx) => temporalChanged(ctx, tz, isoWeekKey);
-}
-function isConditionalReminder(fragment2) {
-  return fragment2.name === "reminder" && !!fragment2.metadata?.reminder;
-}
-function getConditionalReminder(fragment2) {
-  return fragment2.metadata.reminder;
-}
-var SYSTEM_REMINDER_OPEN_TAG = "<system-reminder>";
-var SYSTEM_REMINDER_CLOSE_TAG = "</system-reminder>";
-function getReminderRanges(metadata) {
-  return metadata?.reminders ?? [];
-}
-function stripTextByRanges(text, ranges) {
-  if (ranges.length === 0) {
-    return text;
-  }
-  const normalized = ranges.map((range) => ({
-    start: Math.max(0, Math.min(text.length, range.start)),
-    end: Math.max(0, Math.min(text.length, range.end))
-  })).filter((range) => range.end > range.start).sort((a, b) => a.start - b.start);
-  if (normalized.length === 0) {
-    return text;
-  }
-  let cursor = 0;
-  let output = "";
-  for (const range of normalized) {
-    if (range.start < cursor) {
-      if (range.end > cursor) {
-        cursor = range.end;
-      }
-      continue;
-    }
-    output += text.slice(cursor, range.start);
-    cursor = range.end;
-  }
-  output += text.slice(cursor);
-  return output.trimEnd();
-}
-function stripReminders(message2) {
-  const reminderRanges = getReminderRanges(
-    isRecord(message2.metadata) ? message2.metadata : void 0
-  );
-  const rangesByPartIndex = /* @__PURE__ */ new Map();
-  for (const range of reminderRanges) {
-    const partRanges = rangesByPartIndex.get(range.partIndex) ?? [];
-    partRanges.push({ start: range.start, end: range.end });
-    rangesByPartIndex.set(range.partIndex, partRanges);
-  }
-  const strippedParts = message2.parts.flatMap((part, partIndex) => {
-    const clonedPart = { ...part };
-    const ranges = rangesByPartIndex.get(partIndex);
-    if (clonedPart.type !== "text" || ranges === void 0) {
-      return [clonedPart];
-    }
-    const strippedText = stripTextByRanges(clonedPart.text, ranges);
-    if (strippedText.length === 0) {
-      return [];
-    }
-    return [{ ...clonedPart, text: strippedText }];
-  });
-  const nextMessage = {
-    ...message2,
-    parts: strippedParts
-  };
-  if (isRecord(message2.metadata)) {
-    const metadata = { ...message2.metadata };
-    delete metadata.reminders;
-    if (Object.keys(metadata).length > 0) {
-      nextMessage.metadata = metadata;
-    } else {
-      delete nextMessage.metadata;
-    }
-  }
-  return nextMessage;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function assertReminderText(text) {
-  if (text.trim().length === 0) {
-    throw new Error("Reminder text must not be empty");
-  }
-}
-function formatTaggedReminder(text) {
-  return `${SYSTEM_REMINDER_OPEN_TAG}${text}${SYSTEM_REMINDER_CLOSE_TAG}`;
-}
-function findLastTextPartIndex(message2) {
-  for (let i = message2.parts.length - 1; i >= 0; i--) {
-    if (message2.parts[i].type === "text") {
-      return i;
-    }
-  }
-  return void 0;
-}
-function ensureTextPart(message2) {
-  const existingIndex = findLastTextPartIndex(message2);
-  if (existingIndex !== void 0) {
-    return existingIndex;
-  }
-  const reminderPart = {
-    type: "text",
-    text: ""
-  };
-  message2.parts.push(reminderPart);
-  return message2.parts.length - 1;
-}
-function applyInlineReminder(message2, value) {
-  const partIndex = ensureTextPart(message2);
-  const textPart = message2.parts[partIndex];
-  if (textPart.type !== "text") {
-    throw new Error("Failed to resolve text part for inline reminder");
-  }
-  const reminderText = formatTaggedReminder(value);
-  const start = textPart.text.length;
-  const updatedText = `${textPart.text}${reminderText}`;
-  message2.parts[partIndex] = { ...textPart, text: updatedText };
-  return {
-    id: generateId2(),
-    text: value,
-    partIndex,
-    start,
-    end: start + reminderText.length,
-    mode: "inline"
-  };
-}
-function applyPartReminder(message2, value) {
-  const part = { type: "text", text: value };
-  message2.parts.push(part);
-  const partIndex = message2.parts.length - 1;
-  return {
-    id: generateId2(),
-    text: value,
-    partIndex,
-    start: 0,
-    end: value.length,
-    mode: "part"
-  };
-}
-function resolveReminderText(item, ctx) {
-  return resolveReminder(item, ctx)?.text ?? "";
-}
-function normalizeReminderResolution(value) {
-  if (typeof value === "string") {
-    return value.trim().length === 0 ? null : { text: value };
-  }
-  if (value.text.trim().length === 0) {
-    return null;
-  }
-  return value;
-}
-function resolveReminder(item, ctx) {
-  const resolvedText = typeof item.text === "function" ? item.text(ctx) : item.text;
-  const resolved = normalizeReminderResolution(resolvedText);
-  if (!resolved) {
-    return null;
-  }
-  const metadata = item.metadata || resolved.metadata ? {
-    ...item.metadata ?? {},
-    ...resolved.metadata ?? {}
-  } : void 0;
-  return metadata ? { ...resolved, metadata } : resolved;
-}
-function mergeMessageMetadata(message2, addedMetadata) {
-  if (Object.keys(addedMetadata).length === 0) {
-    return;
-  }
-  const metadata = isRecord(message2.metadata) ? { ...message2.metadata } : {};
-  message2.metadata = { ...metadata, ...addedMetadata };
-}
-function applyReminderToMessage(message2, item, ctx) {
-  const resolved = resolveReminder(item, ctx);
-  if (!resolved) {
-    return null;
-  }
-  if (resolved.metadata) {
-    mergeMessageMetadata(message2, resolved.metadata);
-  }
-  return item.asPart ? applyPartReminder(message2, resolved.text) : applyInlineReminder(message2, resolved.text);
-}
-function mergeReminderMetadata(message2, addedReminders) {
-  if (addedReminders.length === 0) return;
-  const metadata = isRecord(message2.metadata) ? { ...message2.metadata } : {};
-  const existing = Array.isArray(metadata.reminders) ? metadata.reminders : [];
-  metadata.reminders = [...existing, ...addedReminders];
-  message2.metadata = metadata;
-}
-function reminder(text, options) {
-  if (typeof text === "string") {
-    assertReminderText(text);
-  }
-  if (options && "when" in options && options.when) {
-    return {
-      name: "reminder",
-      metadata: {
-        reminder: {
-          text,
-          when: options.when,
-          asPart: options.asPart ?? false
-        }
-      }
-    };
-  }
-  return {
-    text,
-    asPart: options?.asPart ?? false
-  };
-}
-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 plainText = extractPlainText(message2);
-    const added = [];
-    for (const item of reminders) {
-      const meta = applyReminderToMessage(message2, item, {
-        content: plainText
-      });
-      if (meta) added.push(meta);
-    }
-    mergeReminderMetadata(message2, added);
-  }
-  return {
-    id: message2.id,
-    name: "user",
-    type: "message",
-    persist: true,
-    codec: {
-      decode() {
-        return message2;
-      },
-      encode() {
-        return message2;
-      }
-    }
-  };
-}
-
-// packages/context/src/lib/guardrail.ts
-function pass(part) {
-  return { type: "pass", part };
-}
-function fail(feedback) {
-  return { type: "fail", feedback };
-}
-function stop(part) {
-  return { type: "stop", part };
-}
-function runGuardrailChain(part, guardrails, context) {
-  let currentPart = part;
-  for (const guardrail2 of guardrails) {
-    const result = guardrail2.handle(currentPart, context);
-    if (result.type === "fail" || result.type === "stop") {
-      return result;
-    }
-    currentPart = result.part;
-  }
-  return pass(currentPart);
-}
-
 // packages/context/src/lib/renderers/abstract.renderer.ts
 import pluralize from "pluralize";
 import { titlecase } from "stringcase";
@@ -2076,74 +1709,460 @@ ${nested}`);
     if (this.isPrimitive(data)) {
       return `${this.#pad(ctx.depth)}${fragment2.name}: ${this.#formatValue(data)}`;
     }
-    if (isFragment(data)) {
-      const child = this.renderFragment(data, {
-        ...ctx,
-        depth: ctx.depth + 1
-      });
-      return `${this.#pad(ctx.depth)}${fragment2.name}:
-${child}`;
+    if (isFragment(data)) {
+      const child = this.renderFragment(data, {
+        ...ctx,
+        depth: ctx.depth + 1
+      });
+      return `${this.#pad(ctx.depth)}${fragment2.name}:
+${child}`;
+    }
+    if (Array.isArray(data)) {
+      return this.#renderArrayField(fragment2.name, data, ctx.depth);
+    }
+    if (isFragmentObject(data)) {
+      const entries = this.#renderObjectEntries(data, ctx.depth + 1);
+      if (!entries) {
+        return `${this.#pad(ctx.depth)}${fragment2.name}:`;
+      }
+      return `${this.#pad(ctx.depth)}${fragment2.name}:
+${entries}`;
+    }
+    return `${this.#pad(ctx.depth)}${fragment2.name}:`;
+  }
+  renderPrimitive(key, value, ctx) {
+    return `${this.#pad(ctx.depth)}${key}: ${this.#formatValue(value)}`;
+  }
+  renderArray(key, items, ctx) {
+    return this.#renderArrayField(key, items, ctx.depth);
+  }
+  renderObject(key, obj, ctx) {
+    const entries = this.#renderObjectEntries(obj, ctx.depth + 1);
+    if (!entries) {
+      return `${this.#pad(ctx.depth)}${key}:`;
+    }
+    return `${this.#pad(ctx.depth)}${key}:
+${entries}`;
+  }
+  #pad(depth) {
+    return "  ".repeat(depth);
+  }
+  #needsQuoting(value) {
+    if (value === "") return true;
+    if (value !== value.trim()) return true;
+    if (["true", "false", "null"].includes(value.toLowerCase())) return true;
+    if (/^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?$/i.test(value)) return true;
+    if (/[:\\"'[\]{}|,\t\n\r]/.test(value)) return true;
+    if (value.startsWith("-")) return true;
+    return false;
+  }
+  #escape(value) {
+    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+  }
+  #canonicalizeNumber(n) {
+    if (!Number.isFinite(n)) return "null";
+    if (Object.is(n, -0)) return "0";
+    return String(n);
+  }
+  #formatValue(value) {
+    if (value === null) return "null";
+    if (typeof value === "boolean") return String(value);
+    if (typeof value === "number") return this.#canonicalizeNumber(value);
+    if (typeof value === "string") {
+      if (this.#needsQuoting(value)) {
+        return `"${this.#escape(value)}"`;
+      }
+      return value;
+    }
+    return `"${this.#escape(JSON.stringify(value))}"`;
+  }
+};
+
+// packages/context/src/lib/text.ts
+import { isTextUIPart } from "ai";
+function getTextParts(message2) {
+  return message2.parts.filter(isTextUIPart).map((part) => part.text);
+}
+function extractPlainText(message2) {
+  return getTextParts(message2).join(" ");
+}
+
+// packages/context/src/lib/fragments/message/user.ts
+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 async (ctx) => {
+    for (const it of predicates) {
+      if (!await it(ctx)) return false;
+    }
+    return true;
+  };
+}
+function or(...predicates) {
+  return async (ctx) => {
+    for (const it of predicates) {
+      if (await it(ctx)) return true;
+    }
+    return false;
+  };
+}
+function not(predicate) {
+  return async (ctx) => !await predicate(ctx);
+}
+function contentIncludes(keywords) {
+  const lower = keywords.map((k) => k.toLowerCase());
+  return (ctx) => {
+    const text = ctx.content.toLowerCase();
+    return lower.some((kw) => text.includes(kw));
+  };
+}
+function contentPattern(pattern) {
+  return (ctx) => {
+    pattern.lastIndex = 0;
+    return pattern.test(ctx.content);
+  };
+}
+function toDateParts(date, tz) {
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    hourCycle: "h23"
+  }).formatToParts(date);
+  const get = (type) => parts.find((p) => p.type === type).value;
+  return {
+    year: get("year"),
+    month: get("month"),
+    day: get("day"),
+    hour: get("hour")
+  };
+}
+function temporalChanged(ctx, tz, getKey) {
+  if (ctx.lastMessageAt === void 0) return true;
+  const nowParts = toDateParts(/* @__PURE__ */ new Date(), tz);
+  const prevParts = toDateParts(new Date(ctx.lastMessageAt), tz);
+  return getKey(nowParts) !== getKey(prevParts);
+}
+function getSeason(month) {
+  if (month >= 2 && month <= 4) return "Spring";
+  if (month >= 5 && month <= 7) return "Summer";
+  if (month >= 8 && month <= 10) return "Fall";
+  return "Winter";
+}
+function isoWeekKey(parts) {
+  const d = new Date(
+    Date.UTC(
+      parseInt(parts.year),
+      parseInt(parts.month) - 1,
+      parseInt(parts.day)
+    )
+  );
+  d.setUTCDate(d.getUTCDate() + 4 - (d.getUTCDay() || 7));
+  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
+  const weekNo = Math.ceil(
+    ((d.getTime() - yearStart.getTime()) / 864e5 + 1) / 7
+  );
+  return `${d.getUTCFullYear()}-W${String(weekNo).padStart(2, "0")}`;
+}
+function dayChanged(tz = "UTC") {
+  return (ctx) => temporalChanged(ctx, tz, (p) => `${p.year}-${p.month}-${p.day}`);
+}
+function hourChanged(tz = "UTC") {
+  return (ctx) => temporalChanged(ctx, tz, (p) => `${p.year}-${p.month}-${p.day}-${p.hour}`);
+}
+function monthChanged(tz = "UTC") {
+  return (ctx) => temporalChanged(ctx, tz, (p) => `${p.year}-${p.month}`);
+}
+function yearChanged(tz = "UTC") {
+  return (ctx) => temporalChanged(ctx, tz, (p) => p.year);
+}
+function seasonChanged(tz = "UTC") {
+  return (ctx) => temporalChanged(ctx, tz, (p) => getSeason(parseInt(p.month) - 1));
+}
+function weekChanged(tz = "UTC") {
+  return (ctx) => temporalChanged(ctx, tz, isoWeekKey);
+}
+function isConditionalReminder(fragment2) {
+  return fragment2.name === "reminder" && !!fragment2.metadata?.reminder;
+}
+function getConditionalReminder(fragment2) {
+  return fragment2.metadata.reminder;
+}
+var SYSTEM_REMINDER_OPEN_TAG = "<system-reminder>";
+var SYSTEM_REMINDER_CLOSE_TAG = "</system-reminder>";
+function getReminderRanges(metadata) {
+  return metadata?.reminders ?? [];
+}
+function stripTextByRanges(text, ranges) {
+  if (ranges.length === 0) {
+    return text;
+  }
+  const normalized = ranges.map((range) => ({
+    start: Math.max(0, Math.min(text.length, range.start)),
+    end: Math.max(0, Math.min(text.length, range.end))
+  })).filter((range) => range.end > range.start).sort((a, b) => a.start - b.start);
+  if (normalized.length === 0) {
+    return text;
+  }
+  let cursor = 0;
+  let output = "";
+  for (const range of normalized) {
+    if (range.start < cursor) {
+      if (range.end > cursor) {
+        cursor = range.end;
+      }
+      continue;
+    }
+    output += text.slice(cursor, range.start);
+    cursor = range.end;
+  }
+  output += text.slice(cursor);
+  return output.trimEnd();
+}
+function stripReminders(message2) {
+  const reminderRanges = getReminderRanges(
+    isRecord(message2.metadata) ? message2.metadata : void 0
+  );
+  const rangesByPartIndex = /* @__PURE__ */ new Map();
+  for (const range of reminderRanges) {
+    const partRanges = rangesByPartIndex.get(range.partIndex) ?? [];
+    partRanges.push({ start: range.start, end: range.end });
+    rangesByPartIndex.set(range.partIndex, partRanges);
+  }
+  const strippedParts = message2.parts.flatMap((part, partIndex) => {
+    const clonedPart = { ...part };
+    const ranges = rangesByPartIndex.get(partIndex);
+    if (clonedPart.type !== "text" || ranges === void 0) {
+      return [clonedPart];
+    }
+    const strippedText = stripTextByRanges(clonedPart.text, ranges);
+    if (strippedText.length === 0) {
+      return [];
     }
-    if (Array.isArray(data)) {
-      return this.#renderArrayField(fragment2.name, data, ctx.depth);
+    return [{ ...clonedPart, text: strippedText }];
+  });
+  const nextMessage = {
+    ...message2,
+    parts: strippedParts
+  };
+  if (isRecord(message2.metadata)) {
+    const metadata = { ...message2.metadata };
+    delete metadata.reminders;
+    if (Object.keys(metadata).length > 0) {
+      nextMessage.metadata = metadata;
+    } else {
+      delete nextMessage.metadata;
     }
-    if (isFragmentObject(data)) {
-      const entries = this.#renderObjectEntries(data, ctx.depth + 1);
-      if (!entries) {
-        return `${this.#pad(ctx.depth)}${fragment2.name}:`;
-      }
-      return `${this.#pad(ctx.depth)}${fragment2.name}:
-${entries}`;
+  }
+  return nextMessage;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function assertReminderText(text) {
+  if (text.trim().length === 0) {
+    throw new Error("Reminder text must not be empty");
+  }
+}
+function formatTaggedReminder(text) {
+  return `${SYSTEM_REMINDER_OPEN_TAG}${text}${SYSTEM_REMINDER_CLOSE_TAG}`;
+}
+function findLastTextPartIndex(message2) {
+  for (let i = message2.parts.length - 1; i >= 0; i--) {
+    if (message2.parts[i].type === "text") {
+      return i;
     }
-    return `${this.#pad(ctx.depth)}${fragment2.name}:`;
   }
-  renderPrimitive(key, value, ctx) {
-    return `${this.#pad(ctx.depth)}${key}: ${this.#formatValue(value)}`;
+  return void 0;
+}
+function ensureTextPart(message2) {
+  const existingIndex = findLastTextPartIndex(message2);
+  if (existingIndex !== void 0) {
+    return existingIndex;
   }
-  renderArray(key, items, ctx) {
-    return this.#renderArrayField(key, items, ctx.depth);
+  const reminderPart = {
+    type: "text",
+    text: ""
+  };
+  message2.parts.push(reminderPart);
+  return message2.parts.length - 1;
+}
+function applyInlineReminder(message2, value) {
+  const partIndex = ensureTextPart(message2);
+  const textPart = message2.parts[partIndex];
+  if (textPart.type !== "text") {
+    throw new Error("Failed to resolve text part for inline reminder");
   }
-  renderObject(key, obj, ctx) {
-    const entries = this.#renderObjectEntries(obj, ctx.depth + 1);
-    if (!entries) {
-      return `${this.#pad(ctx.depth)}${key}:`;
-    }
-    return `${this.#pad(ctx.depth)}${key}:
-${entries}`;
+  const reminderText = formatTaggedReminder(value);
+  const start = textPart.text.length;
+  const updatedText = `${textPart.text}${reminderText}`;
+  message2.parts[partIndex] = { ...textPart, text: updatedText };
+  return {
+    id: generateId2(),
+    text: value,
+    partIndex,
+    start,
+    end: start + reminderText.length,
+    mode: "inline"
+  };
+}
+function applyPartReminder(message2, value) {
+  const part = { type: "text", text: value };
+  message2.parts.push(part);
+  const partIndex = message2.parts.length - 1;
+  return {
+    id: generateId2(),
+    text: value,
+    partIndex,
+    start: 0,
+    end: value.length,
+    mode: "part"
+  };
+}
+function resolveReminderText(item, ctx) {
+  return resolveReminder(item, ctx)?.text ?? "";
+}
+function normalizeReminderResolution(value) {
+  if (typeof value === "string") {
+    return value.trim().length === 0 ? null : { text: value };
   }
-  #pad(depth) {
-    return "  ".repeat(depth);
+  if (value.text.trim().length === 0) {
+    return null;
   }
-  #needsQuoting(value) {
-    if (value === "") return true;
-    if (value !== value.trim()) return true;
-    if (["true", "false", "null"].includes(value.toLowerCase())) return true;
-    if (/^-?\d+(?:\.\d+)?(?:e[+-]?\d+)?$/i.test(value)) return true;
-    if (/[:\\"'[\]{}|,\t\n\r]/.test(value)) return true;
-    if (value.startsWith("-")) return true;
-    return false;
+  return value;
+}
+function resolveReminder(item, ctx) {
+  const resolvedText = typeof item.text === "function" ? item.text(ctx) : item.text;
+  const resolved = normalizeReminderResolution(resolvedText);
+  if (!resolved) {
+    return null;
   }
-  #escape(value) {
-    return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t");
+  const metadata = item.metadata || resolved.metadata ? {
+    ...item.metadata ?? {},
+    ...resolved.metadata ?? {}
+  } : void 0;
+  return metadata ? { ...resolved, metadata } : resolved;
+}
+async function resolveReminderAsync(item, ctx) {
+  const text = await (typeof item.text === "function" ? item.text(ctx) : item.text);
+  const resolved = normalizeReminderResolution(text);
+  if (!resolved) return null;
+  const metadata = item.metadata || resolved.metadata ? { ...item.metadata ?? {}, ...resolved.metadata ?? {} } : void 0;
+  return metadata ? { ...resolved, metadata } : resolved;
+}
+function mergeMessageMetadata(message2, addedMetadata) {
+  if (Object.keys(addedMetadata).length === 0) {
+    return;
   }
-  #canonicalizeNumber(n) {
-    if (!Number.isFinite(n)) return "null";
-    if (Object.is(n, -0)) return "0";
-    return String(n);
+  const metadata = isRecord(message2.metadata) ? { ...message2.metadata } : {};
+  message2.metadata = { ...metadata, ...addedMetadata };
+}
+function applyReminderToMessage(message2, item, ctx) {
+  const resolved = resolveReminder(item, ctx);
+  if (!resolved) {
+    return null;
   }
-  #formatValue(value) {
-    if (value === null) return "null";
-    if (typeof value === "boolean") return String(value);
-    if (typeof value === "number") return this.#canonicalizeNumber(value);
-    if (typeof value === "string") {
-      if (this.#needsQuoting(value)) {
-        return `"${this.#escape(value)}"`;
+  if (resolved.metadata) {
+    mergeMessageMetadata(message2, resolved.metadata);
+  }
+  return item.asPart ? applyPartReminder(message2, resolved.text) : applyInlineReminder(message2, resolved.text);
+}
+function mergeReminderMetadata(message2, addedReminders) {
+  if (addedReminders.length === 0) return;
+  const metadata = isRecord(message2.metadata) ? { ...message2.metadata } : {};
+  const existing = Array.isArray(metadata.reminders) ? metadata.reminders : [];
+  metadata.reminders = [...existing, ...addedReminders];
+  message2.metadata = metadata;
+}
+function reminder(textOrFragment, options) {
+  const text = isFragment(textOrFragment) ? new XmlRenderer().render([textOrFragment]) : textOrFragment;
+  if (typeof text === "string") {
+    assertReminderText(text);
+  }
+  if (options && "when" in options && options.when) {
+    return {
+      name: "reminder",
+      data: null,
+      metadata: {
+        reminder: {
+          text,
+          when: options.when,
+          asPart: options.asPart ?? false
+        }
       }
-      return value;
+    };
+  }
+  return {
+    text,
+    asPart: options?.asPart ?? false
+  };
+}
+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 plainText = extractPlainText(message2);
+    const added = [];
+    for (const item of reminders) {
+      const meta = applyReminderToMessage(message2, item, {
+        content: plainText
+      });
+      if (meta) added.push(meta);
     }
-    return `"${this.#escape(JSON.stringify(value))}"`;
+    mergeReminderMetadata(message2, added);
   }
-};
+  return {
+    id: message2.id,
+    name: "user",
+    type: "message",
+    persist: true,
+    codec: {
+      decode() {
+        return message2;
+      },
+      encode() {
+        return message2;
+      }
+    }
+  };
+}
+
+// packages/context/src/lib/guardrail.ts
+function pass(part) {
+  return { type: "pass", part };
+}
+function fail(feedback) {
+  return { type: "fail", feedback };
+}
+function stop(part) {
+  return { type: "stop", part };
+}
+function runGuardrailChain(part, guardrails, context) {
+  let currentPart = part;
+  for (const guardrail2 of guardrails) {
+    const result = guardrail2.handle(currentPart, context);
+    if (result.type === "fail" || result.type === "stop") {
+      return result;
+    }
+    currentPart = result.part;
+  }
+  return pass(currentPart);
+}
 
 // packages/context/src/lib/render.ts
 function render(tag, ...fragments) {
@@ -2366,6 +2385,7 @@ export {
   reminder,
   render,
   resolveReminder,
+  resolveReminderAsync,
   resolveReminderText,
   role,
   runGuardrailChain,