@frockbot/kernel-agent-loop 0.3.1 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frockbot/kernel-agent-loop",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "private": false,
   "type": "module",
   "exports": {
@@ -12,13 +12,13 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@frockbot/kernel-contracts": "0.3.1",
+    "@frockbot/kernel-contracts": "0.3.3",
     "cordis": "4.0.0-rc.8"
   },
   "devDependencies": {
-    "@frockbot/plugin-models": "0.3.1",
-    "@frockbot/plugin-prompt": "0.3.1",
-    "@frockbot/plugin-tools": "0.3.1",
+    "@frockbot/plugin-models": "0.3.3",
+    "@frockbot/plugin-prompt": "0.3.3",
+    "@frockbot/plugin-tools": "0.3.3",
     "@types/bun": "1.4.0",
     "@types/node": "26.2.0",
     "typescript": "^7.0.2"

package/src/agent.ts

@@ -70,7 +70,7 @@ export interface Agent extends LoopAgentRuntimeV1 {
   readonly status: AgentStatus;
   send(input: string | AgentSendV1): string;
   resume(): void;
-  cancel(reason?: "user" | "shutdown"): void;
+  cancel(reason?: "user" | "shutdown", detail?: string): void;
   whenIdle(): Promise<void>;
 }
 

package/src/index.test.ts

@@ -512,6 +512,8 @@ describe("AgentLoop", () => {
     if (request?.type !== "model/request") throw new Error("request missing");
     expect(request.request.tools.map((schema) => schema.name)).toEqual([
       "work",
+      "get_dynamic_tools",
+      "call_dynamic_tool",
     ]);
   });
 
@@ -556,6 +558,8 @@ describe("AgentLoop", () => {
     if (request?.type !== "model/request") throw new Error("request missing");
     expect(request.request.tools.map((schema) => schema.name)).toEqual([
       "send_to_user",
+      "get_dynamic_tools",
+      "call_dynamic_tool",
     ]);
     expect(
       handle.agent.session.events.some(
@@ -1664,7 +1668,11 @@ describe("AgentLoop", () => {
         provider: "scripted",
         model: "test-model",
         system: "You are the FrockBot test agent.",
-        tools: [{ name: "echo" }],
+        tools: expect.arrayContaining([
+          expect.objectContaining({ name: "echo" }),
+          expect.objectContaining({ name: "get_dynamic_tools" }),
+          expect.objectContaining({ name: "call_dynamic_tool" }),
+        ]),
       },
     });
     expect(events.at(-1)).toMatchObject({

package/src/index.ts

@@ -149,6 +149,13 @@ class LoopAgent implements Agent {
   #inbox: AgentInput[] = [];
   #activity: Promise<void> = Promise.resolve();
   #controller: AbortController | undefined;
+  /**
+   * Why the current cancellation happened, as an opaque bounded string the
+   * caller supplied. The loop never reads it: it records it on the `turn/end`
+   * it writes, so the durable log says what interrupted the Turn rather than
+   * only that something did.
+   */
+  #cancelDetail: string | undefined;
   #disposeRequested = false;
   #resumeRequested = false;
 
@@ -216,8 +223,9 @@ class LoopAgent implements Agent {
     this.#wake();
   }
 
-  cancel(reason: "user" | "shutdown" = "user"): void {
+  cancel(reason: "user" | "shutdown" = "user", detail?: string): void {
     if (this.#status === "disposed") return;
+    this.#cancelDetail = turnEndReason(detail);
     this.#ctx.emit("agent/cancel-requested", this, reason);
     const queued = this.#inbox.splice(0);
     if (queued.length > 0) {
@@ -587,6 +595,7 @@ class LoopAgent implements Agent {
         signal.aborted
       ) {
         turnOutcome = "cancelled";
+        turnReason = this.#cancelDetail;
       } else {
         turnOutcome = "model-error";
         turnReason = turnEndReason(modelFailureMessage(error));
@@ -746,6 +755,7 @@ class LoopAgent implements Agent {
         signal.aborted
       ) {
         turnOutcome = "cancelled";
+        turnReason = this.#cancelDetail;
       } else {
         turnOutcome = "model-error";
         turnReason = turnEndReason(modelFailureMessage(error));