@aexhq/agentloop-pi 6.2.1 → 7.0.0

package/README.md

@@ -33,8 +33,13 @@ const session = await brain.sessions.create({
 The component is built by this package's publisher. Brain consumes the resulting Component and
 does not compile its JavaScript source.
 
-The loop reads paginated session Events before each turn and saves its observation cursor in
-kv after saving those observations in the transcript. For unanswered calls in the last saved
+The loop reads paginated session Events on user and background activations. After saving
+selected observations in the transcript, it acknowledges Brain's durable processed-through
+sequence (`brain.last_activation`). Return ends a Tool's synchronous part; explicit finish ends
+its whole execution. A dispatch reply presents the observed results and whether the Tool is
+still running. Later results and finish are presented as observations and wake a model call,
+without inserting a user prompt. An activation with no new actionable observations only
+acknowledges its cursor. Results already consumed during dispatch are not presented again. For unanswered calls in the last saved
 assistant message, it inserts error Tool results explaining that the turn was interrupted and
 the operation may have run. Saved results, media and native provider state are preserved.
 Interrupted turns and environment failures also enter the transcript as runtime observations.
@@ -62,8 +67,9 @@ siblings. For hosted applications, publish bytes with Aex's attachment API and r
 Compaction explicitly resets the response format and installs a summary only after `end_turn`;
 a truncated, refused, or unknown summary leaves the original saved context intact.
 
-Version 6.2 targets Brain SDK 0.25 and preserves the 0.23 WIT and URL-media contract. Existing sessions keep their
-immutable loop implementation; create new sessions to adopt the updated loop. Keep matching
+Version 7.0 targets Brain SDK 0.28 and `brain:agentloop@0.2.0`. The Tool return/completion
+contract is breaking. Existing sessions retain their immutable loop implementation; the
+server upgrade preflight refuses unclosed sessions from the previous contract. Keep matching
 server/artifacts for recovery. An upgrade does not migrate or delete session data.
 
 Image and PDF blocks remain native media in compaction requests. The JSON-length estimate used

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexhq/agentloop-pi",
-  "version": "6.2.1",
+  "version": "7.0.0",
   "description": "Pi-style parallel-Tool Brain extension",
   "license": "MIT",
   "repository": {
@@ -40,7 +40,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
-    "@aexhq/brain": "0.27.0",
+    "@aexhq/brain": "0.28.0",
     "ajv": "8.20.0",
     "ajv-formats": "3.0.1",
     "zod": "4.4.3"

package/src/component.mjs

@@ -1,4 +1,4 @@
-import * as host from "brain:agentloop/host@0.1.0";
+import * as host from "brain:agentloop/host@0.2.0";
 
 import { runPi } from "./logic.mjs";
 
@@ -18,6 +18,7 @@ export async function turn(input) {
   try {
     const output = await runPi({
       input: JSON.parse(input.inputJson),
+      kv: JSON.parse(input.kvJson),
       transcript: JSON.parse(input.transcriptJson),
       events: JSON.parse(input.eventsJson),
       configuration: JSON.parse(input.configurationJson),
@@ -33,6 +34,7 @@ export async function turn(input) {
         put: (key, value) => hosted(() => host.kvPut(key, JSON.stringify(value))),
         delete: (key) => hosted(() => host.kvDelete(key)),
       },
+      acknowledge: (through) => hosted(() => host.acknowledge(BigInt(through))),
       events: (after) => JSON.parse(hosted(() => host.events(BigInt(after)))),
       model: (request) => JSON.parse(hosted(() => host.model(JSON.stringify(request)))),
       dispatch: (calls) => JSON.parse(hosted(() => host.dispatch(JSON.stringify(calls)))),

package/src/logic.mjs

@@ -67,7 +67,7 @@ export async function runPi(input, context) {
   const placement = toolPlacement(input.tools, options);
   const output = structuredOutput(options.output);
   const transcript = cloneJson(input.transcript);
-  const observed_sequence = await observeEvents(context, transcript, (await context.kv.read("observed_sequence")) ?? 0);
+  let observed = await observeEvents(context, transcript, input.kv?.["brain.last_activation"] ?? 0);
   const saved = await context.kv.read("checkpoint");
   const checkpoint = saved === undefined ? { summary: null } : cloneJson(saved);
   const body = () => checkpoint.summary === null ? transcript : transcript.slice(1);
@@ -104,9 +104,10 @@ export async function runPi(input, context) {
       ...messages.slice(cut));
   };
 
-  transcript.push({ role: "user", content: [{ type: "text", text: input.input.message }, ...(input.input.media ?? [])] });
+  if (input.input != null) transcript.push({ role: "user", content: [{ type: "text", text: input.input.message }, ...(input.input.media ?? [])] });
   await context.setTranscript(transcript);
-  await context.kv.put("observed_sequence", observed_sequence);
+  await context.acknowledge(observed.through);
+  if (input.input == null && !observed.actionable) return {};
   for (;;) {
     if (shouldCompact()) {
       await compact();
@@ -145,7 +146,9 @@ export async function runPi(input, context) {
       role: "user",
       content: calls.map(({ call_id }) => toolResult(call_id, byCall.get(call_id))),
     });
+    observed = await observeEvents(context, transcript, observed.through, new Set(results.flatMap(result => result.events.map(event => event.sequence))));
     await context.setTranscript(transcript);
+    await context.acknowledge(observed.through);
   }
 }