@deepagents/context 0.36.0 → 0.37.1

package/README.md

@@ -1,10 +1,10 @@
 # @deepagents/context
 
-A domain-agnostic context management system for formatting context fragments into different prompt styles.
+A domain-agnostic context system for LLM applications, including fragment rendering, persistence, chat orchestration, and portable sandbox tooling.
 
 ## Overview
 
-This package provides a flexible way to compose and render context in multiple formats (XML, Markdown, TOML, TOON). Context fragments are structured units that can be transformed into different prompt representations for different LLM styles.
+This package provides a flexible way to compose and render context in multiple formats (XML, Markdown, TOML, TOON), persist conversations, orchestrate chat flows, and expose portable host-side command surfaces. Context fragments are structured units that can be transformed into different prompt representations for different LLM styles.
 
 ## Installation
 
@@ -23,6 +23,23 @@ import { identity, reminder, term, user } from '@deepagents/context/browser';
 `@deepagents/context/browser` intentionally excludes server-only modules
 like store implementations, sandbox tooling, and filesystem-based skill loading.
 
+## Sandbox Tooling
+
+The server-side package also ships the sandbox primitives used by
+`@deepagents/text2sql` and other tool-driven agents. Use
+`createRoutingSandbox({ backend, hostExtensions })` to run the same host
+commands across virtual, Docker, or Agent OS backends.
+
+If an upstream service already has an OpenAPI description,
+`createOpenAPIExtension({ name, openapi, ... })` turns it into a portable
+`SandboxExtension` with validated subcommands and a built-in `schema`
+introspection command.
+
+See the docs for the full API surface:
+
+- [Routing Sandbox](https://januarylabs.github.io/deepagents/docs/context/routing-sandbox)
+- [Sandbox](https://januarylabs.github.io/deepagents/docs/context/sandbox)
+
 ## Basic Usage
 
 ```typescript
@@ -65,6 +82,54 @@ console.log(renderer.render(fragments));
 </guardrails>
 ```
 
+## Agent Helpers
+
+If you use the built-in agent wrapper from `@deepagents/context`, the same
+`ContextEngine` can power sub-agents and advisor tools without mutating the
+parent thread.
+
+```typescript
+import { openai } from '@ai-sdk/openai';
+
+import {
+  ContextEngine,
+  InMemoryContextStore,
+  agent,
+  role,
+} from '@deepagents/context';
+
+const context = new ContextEngine({
+  store: new InMemoryContextStore(),
+  chatId: 'chat-001',
+  userId: 'user-001',
+}).set(role('You are a product analyst.'));
+
+const analyst = agent({
+  name: 'analyst',
+  context,
+  model: openai('gpt-5.4-mini'),
+});
+
+const { tool: advisor } = analyst.asAdvisor({ concise: true });
+
+const coordinator = agent({
+  name: 'coordinator',
+  context,
+  model: openai('gpt-5.4'),
+  tools: {
+    analyze: analyst.asTool({
+      toolDescription: 'Return a short analysis brief',
+    }),
+    advisor,
+  },
+});
+```
+
+`asTool()` forks the context so the child run sees the parent's system fragments
+without persisting new messages into the parent chat. `asAdvisor()` exposes a
+no-input reviewer tool and `usage()` reports successful calls plus token usage
+for that advisor instance.
+
 ## Fragment Builders
 
 ### Domain Fragments

package/dist/browser.js

@@ -1772,118 +1772,9 @@ function extractPlainText(message2) {
 }
 
 // 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) {
@@ -2071,10 +1962,12 @@ function mergeReminderMetadata(message2, addedReminders) {
   message2.metadata = metadata;
 }
 function reminder(textOrFragment, options) {
-  const text = isFragment(textOrFragment) ? new XmlRenderer().render([textOrFragment]) : textOrFragment;
+  const fromFragment2 = isFragment(textOrFragment);
+  const text = fromFragment2 ? new XmlRenderer().render([textOrFragment]) : textOrFragment;
   if (typeof text === "string") {
     assertReminderText(text);
   }
+  const asPart = options?.asPart ?? fromFragment2;
   if (options && "when" in options && options.when) {
     return {
       name: "reminder",
@@ -2083,14 +1976,14 @@ function reminder(textOrFragment, options) {
         reminder: {
           text,
           when: options.when,
-          asPart: options.asPart ?? false
+          asPart
         }
       }
     };
   }
   return {
     text,
-    asPart: options?.asPart ?? false
+    asPart
   };
 }
 function user(content, ...reminders) {
@@ -2311,38 +2204,28 @@ export {
   TomlRenderer,
   ToonRenderer,
   XmlRenderer,
-  afterTurn,
   alias,
   analogy,
-  and,
   applyInlineReminder,
   applyPartReminder,
   applyReminderToMessage,
   assistant,
   assistantText,
   clarification,
-  contentIncludes,
-  contentPattern,
   correction,
-  dayChanged,
   defaultTokenizer,
   estimate,
-  everyNTurns,
   example,
   explain,
   fail,
-  firstN,
   fragment,
   fromFragment,
-  getConditionalReminder,
   getFragmentData,
   getModelsRegistry,
   getReminderRanges,
-  getSeason,
   glossary,
   guardrail,
   hint,
-  hourChanged,
   identity,
   isConditionalReminder,
   isFragment,
@@ -2352,10 +2235,6 @@ export {
   mergeMessageMetadata,
   mergeReminderMetadata,
   message,
-  monthChanged,
-  not,
-  once,
-  or,
   pass,
   persistedWriter,
   persona,
@@ -2370,7 +2249,6 @@ export {
   resolveReminderText,
   role,
   runGuardrailChain,
-  seasonChanged,
   soul,
   stop,
   stripReminders,
@@ -2380,8 +2258,6 @@ export {
   toFragment,
   user,
   visualizeGraph,
-  weekChanged,
-  workflow,
-  yearChanged
+  workflow
 };
 //# sourceMappingURL=browser.js.map