libfx 0.0.10-dev.1208.g8578e5771980 → 0.0.10-dev.1210.gf651bb13ae4d

package/README.md

@@ -73,12 +73,14 @@ blocks. It returns an async iterable of normalized events:
 
 - `text_delta`
 - `reasoning_delta` when supplied by the provider
-- `tool_start`
+- `tool_start` with `id`, `name`, and the tool's `input` object. Inputs over
+  64 KiB of JSON arrive as an `inputPreview` string prefix plus
+  `inputTruncated: true` instead; the tool still receives complete arguments.
 - `tool_end`
 
-Consume the turn while it runs, then await `turn.result`. Output is lossless and
-backpressured: a slow reader pauses production instead of growing an unlimited
-event queue. Awaiting only `turn.result` can wait for an unread stream to drain.
+Consume the turn while it runs, then await `turn.result`. Streamed text and
+tool results are lossless and backpressured: a slow reader pauses production
+instead of growing an unlimited event queue. Awaiting only `turn.result` can wait for an unread stream to drain.
 If you only need the result, explicitly discard events:
 
 ```js

package/fx-sdk.js

@@ -28,6 +28,9 @@ const maxPromptImagesBytes = 8 * 1024 * 1024;
 // envelope allowance covers the method key and request id.
 const maxPromptFrameBytes = 8 * 1024 * 1024;
 const promptFrameEnvelopeBytes = 128;
+// tool_start events carry a bounded preview of the tool input; larger inputs
+// are marked truncated instead of dropped or sent whole.
+const maxToolStartInputBytes = 64 * 1024;
 
 function boundedString(value, name, maxBytes, required) {
   if (value === undefined && !required) return undefined;
@@ -1611,6 +1614,7 @@ export async function createFxAgent(options = {}) {
           type: "tool_start",
           id: update.toolCallId,
           name: toolNames.get(update.toolCallId),
+          ...toolStartInput(update.rawInput),
         };
       }
       if (update.sessionUpdate === "tool_call_update" &&
@@ -1661,6 +1665,17 @@ export async function createFxAgent(options = {}) {
     return result;
   }
 
+  // The input object rides the event when it fits the preview budget; larger
+  // inputs become a bounded JSON prefix plus an explicit marker.
+  function toolStartInput(rawInput) {
+    if (rawInput === undefined || rawInput === null) return {};
+    const serialized = JSON.stringify(rawInput);
+    if (serialized === undefined) return {};
+    const bytes = encoder.encode(serialized);
+    if (bytes.length <= maxToolStartInputBytes) return { input: rawInput };
+    return { inputTruncated: true, inputPreview: decoder.decode(utf8Prefix(bytes, maxToolStartInputBytes)) };
+  }
+
   function startTurn(input, promptOptions) {
     const prompt = normalizePromptInput(input);
     if (encoder.encode(JSON.stringify({ sessionId: "", prompt })).length + promptFrameEnvelopeBytes > maxPromptFrameBytes) {

package/node.cjs

@@ -200,6 +200,7 @@ var maxPromptImageDataBytes = 5 * 1024 * 1024;
 var maxPromptImagesBytes = 8 * 1024 * 1024;
 var maxPromptFrameBytes = 8 * 1024 * 1024;
 var promptFrameEnvelopeBytes = 128;
+var maxToolStartInputBytes = 64 * 1024;
 function boundedString(value, name, maxBytes, required) {
   if (value === undefined && !required)
     return;
@@ -2015,7 +2016,8 @@ async function createFxAgent(options = {}) {
         return {
           type: "tool_start",
           id: update.toolCallId,
-          name: toolNames.get(update.toolCallId)
+          name: toolNames.get(update.toolCallId),
+          ...toolStartInput(update.rawInput)
         };
       }
       if (update.sessionUpdate === "tool_call_update" && (update.status === "completed" || update.status === "failed")) {
@@ -2081,6 +2083,17 @@ async function createFxAgent(options = {}) {
       result.reasoningTokens = usage.reasoningTokens;
     return result;
   }
+  function toolStartInput(rawInput) {
+    if (rawInput === undefined || rawInput === null)
+      return {};
+    const serialized = JSON.stringify(rawInput);
+    if (serialized === undefined)
+      return {};
+    const bytes = encoder.encode(serialized);
+    if (bytes.length <= maxToolStartInputBytes)
+      return { input: rawInput };
+    return { inputTruncated: true, inputPreview: decoder.decode(utf8Prefix(bytes, maxToolStartInputBytes)) };
+  }
   function startTurn(input, promptOptions) {
     const prompt = normalizePromptInput(input);
     if (encoder.encode(JSON.stringify({ sessionId: "", prompt })).length + promptFrameEnvelopeBytes > maxPromptFrameBytes) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libfx",
-  "version": "0.0.10-dev.1208.g8578e5771980",
+  "version": "0.0.10-dev.1210.gf651bb13ae4d",
   "description": "Embed fx agents and terminals in JavaScript hosts",
   "type": "module",
   "repository": {