@deepagents/context 6.1.0 → 7.0.0

package/README.md

@@ -177,14 +177,20 @@ parent thread.
 
 ```typescript
 import { openai } from '@ai-sdk/openai';
+import { InMemoryFs } from 'just-bash';
 
 import {
   ContextEngine,
   InMemoryContextStore,
   agent,
+  createBashTool,
+  createVirtualSandbox,
   role,
 } from '@deepagents/context';
 
+await using backend = await createVirtualSandbox({ fs: new InMemoryFs() });
+const sandbox = await createBashTool({ sandbox: backend });
+
 const context = new ContextEngine({
   store: new InMemoryContextStore(),
   chatId: 'chat-001',
@@ -194,14 +200,16 @@ const context = new ContextEngine({
 const analyst = agent({
   name: 'analyst',
   context,
+  sandbox,
   model: openai('gpt-5.4-mini'),
 });
 
-const { tool: advisor } = analyst.asAdvisor({ concise: true });
+const { tool: advisor } = analyst.asAdvisor();
 
 const coordinator = agent({
   name: 'coordinator',
   context,
+  sandbox,
   model: openai('gpt-5.4'),
   tools: {
     analyze: analyst.asTool({
@@ -317,8 +325,9 @@ points.
 For `target: 'tool-output'`, use `toolOutput(...)` or inspect
 `ctx.toolOutcome`. The outcome is available after a tool reaches
 `output-available`, `output-error`, or `output-denied`, but before the next model
-generation. Assistant-history predicates such as `toolCalled(...)` only
-describe already persisted calls.
+generation. Assistant-history predicates such as `toolCalled(...)` describe
+tool parts visible in the current assistant segment; use `toolOutput(...)` when
+you need the raw outcome currently being evaluated.
 
 ```ts
 import {
@@ -380,6 +389,23 @@ engine.set(
 );
 ```
 
+Use `socraticPlan.instructions()` when the work needs inquiry instead of a
+fixed checklist. It stores evidence-backed questions and answers in the same
+plan file, moves adaptively through domain, case, and bridge phases, and lets
+each review choose the highest-value unanswered question.
+
+```ts
+engine.set(
+  socraticPlan.instructions(),
+  socraticPlan.review({ when: everyNToolCalls(5) }),
+);
+```
+
+The agent answers from source and runtime evidence, and asks the user only when
+the answer requires missing information or authority. The standalone
+`socraticPrompting()` fragment shares the inquiry workflow but does not persist
+plan state.
+
 - `stripTextByRanges(text, ranges)` removes offset spans from text and returns the remaining visible content.
 - `stripReminders(message)` strips inline/part reminders and model-only synthetic reminder payloads from a `UIMessage`.
 - `isSyntheticReminderMessage(message)` identifies stored model-only reminder carriers so a UI can omit them entirely.

package/dist/browser.js

@@ -2244,6 +2244,7 @@ async function persistedWriter(options) {
   let seq = 0;
   let buffer = [];
   let failedByErrorChunk = false;
+  let abortedByChunk = false;
   async function flush() {
     if (buffer.length === 0) return;
     const batch = buffer;
@@ -2269,11 +2270,14 @@ async function persistedWriter(options) {
     }
   }
   async function persistChunk(chunk) {
+    if (chunk.data.type === "abort") {
+      abortedByChunk = true;
+    }
     if (strategy === "immediate") {
       await appendBatch([chunk]);
     } else {
       buffer.push(chunk);
-      if (buffer.length >= flushSize) {
+      if (buffer.length >= flushSize || chunk.data.type.startsWith("data-")) {
         await flush();
       }
     }
@@ -2301,7 +2305,10 @@ async function persistedWriter(options) {
     async complete() {
       await flush();
       if (failedByErrorChunk) return;
-      await store.updateStreamStatus(streamId, "completed");
+      await store.updateStreamStatus(
+        streamId,
+        abortedByChunk ? "cancelled" : "completed"
+      );
     },
     async fail(error) {
       await flush();