wave-agent-sdk 1.0.7 → 1.0.9

package/dist/utils/encoding.js

@@ -0,0 +1,99 @@
+/**
+ * Streaming byte-to-text decoder for bash tool output on Windows.
+ *
+ * Git Bash (MSYS) tools emit UTF-8, but native Windows programs (taskkill,
+ * powershell, ping, ...) write the system OEM code page — GBK (cp936) on
+ * zh-CN systems. Node's default `data.toString()` decodes every stream as
+ * UTF-8, so GBK bytes turn into U+FFFD mojibake (issue #1753).
+ *
+ * Strategy (per-chunk buffering, decide-once):
+ * - Accumulate raw bytes; try strict UTF-8 (`fatal: true`) over everything
+ *   buffered so far. If it decodes cleanly, emit the text.
+ * - If strict UTF-8 fails, hold back up to 3 trailing bytes (a UTF-8
+ *   character split across chunk boundaries) and retry on the next chunk.
+ * - Once even the head is not valid UTF-8, the stream is GBK: re-decode all
+ *   buffered bytes with GBK and switch to GBK for every subsequent chunk.
+ * - `flush()` decodes any leftover buffered bytes (leniently) at stream end.
+ */
+export class WindowsStreamDecoder {
+    constructor() {
+        this.pending = Buffer.alloc(0);
+        this.gbkDecoder = null;
+    }
+    push(data) {
+        // Already determined GBK: decode each chunk as it arrives.
+        if (this.gbkDecoder) {
+            return this.gbkDecoder.decode(data);
+        }
+        this.pending = Buffer.concat([this.pending, data]);
+        try {
+            const text = new TextDecoder("utf-8", { fatal: true }).decode(this.pending);
+            this.pending = Buffer.alloc(0);
+            return text;
+        }
+        catch {
+            // Strict UTF-8 failed. The trailing bytes may be a UTF-8 sequence split
+            // across chunks: hold only the trailing run of non-ASCII bytes (max 3,
+            // the longest incomplete UTF-8 tail). Everything before it is already
+            // decodable and is emitted immediately.
+            const n = this.pending.length;
+            let keep = 0;
+            while (keep < WindowsStreamDecoder.MAX_UTF8_TRAIL_BYTES &&
+                keep < n &&
+                this.pending[n - 1 - keep] >= 0x80) {
+                keep++;
+            }
+            const head = this.pending.subarray(0, n - keep);
+            if (head.length > 0) {
+                try {
+                    const text = new TextDecoder("utf-8", { fatal: true }).decode(head);
+                    this.pending = Buffer.from(this.pending.subarray(n - keep));
+                    return text;
+                }
+                catch {
+                    // Head is not valid UTF-8 → the whole stream is GBK. Re-decode
+                    // everything accumulated so far and commit to GBK.
+                    this.gbkDecoder = new TextDecoder("gbk");
+                    const text = this.gbkDecoder.decode(this.pending);
+                    this.pending = Buffer.alloc(0);
+                    return text;
+                }
+            }
+            // Only the trailing bytes are suspect: hold them for the next chunk.
+            return "";
+        }
+    }
+    /** Decode any bytes still held at stream end (lenient UTF-8, else GBK). */
+    flush() {
+        if (this.pending.length === 0)
+            return "";
+        const rest = this.pending;
+        this.pending = Buffer.alloc(0);
+        if (this.gbkDecoder) {
+            return this.gbkDecoder.decode(rest);
+        }
+        const utf8 = rest.toString("utf-8");
+        if (!utf8.includes("\uFFFD"))
+            return utf8;
+        try {
+            return new TextDecoder("gbk").decode(rest);
+        }
+        catch {
+            return utf8;
+        }
+    }
+}
+/** Longest possible incomplete UTF-8 tail at a chunk boundary is 3 bytes. */
+WindowsStreamDecoder.MAX_UTF8_TRAIL_BYTES = 3;
+/** Decode a single complete byte sequence (used for non-streaming reads). */
+export function decodeBytes(buf) {
+    const utf8 = buf.toString("utf-8");
+    if (!utf8.includes("\uFFFD"))
+        return utf8;
+    try {
+        return new TextDecoder("gbk").decode(buf);
+    }
+    catch {
+        return utf8;
+    }
+}

package/dist/utils/messageOperations.d.ts

@@ -40,7 +40,9 @@ export interface UpdateToolBlockParams {
     }>;
     compactParams?: string;
     parametersChunk?: string;
-    isManuallyBackgrounded?: boolean;
+    backgroundTaskId?: string;
+    backgroundedByUser?: boolean;
+    assistantAutoBackgrounded?: boolean;
     timestamp?: number;
 }
 export type AgentToolBlockUpdateParams = Omit<UpdateToolBlockParams, "messages">;
@@ -86,7 +88,7 @@ export declare const addToolBlockToMessageInMessages: (messages: Message[], mess
     messages: Message[];
     toolBlockId: string;
 };
-export declare const updateToolBlockInMessage: ({ messages, id, messageId, parameters, result, success, error, stage, name, shortResult, startLineNumber, images, compactParams, parametersChunk, isManuallyBackgrounded, }: UpdateToolBlockParams) => {
+export declare const updateToolBlockInMessage: ({ messages, id, messageId, parameters, result, success, error, stage, name, shortResult, startLineNumber, images, compactParams, parametersChunk, backgroundTaskId, backgroundedByUser, assistantAutoBackgrounded, }: UpdateToolBlockParams) => {
     messages: Message[];
     messageId?: string;
 };

package/dist/utils/messageOperations.js

@@ -158,7 +158,7 @@ export const addToolBlockToMessageInMessages = (messages, messageId, params) =>
     return { messages: newMessages, toolBlockId };
 };
 // Update Tool Block of the last assistant or user message
-export const updateToolBlockInMessage = ({ messages, id, messageId, parameters, result, success, error, stage, name, shortResult, startLineNumber, images, compactParams, parametersChunk, isManuallyBackgrounded, }) => {
+export const updateToolBlockInMessage = ({ messages, id, messageId, parameters, result, success, error, stage, name, shortResult, startLineNumber, images, compactParams, parametersChunk, backgroundTaskId, backgroundedByUser, assistantAutoBackgrounded, }) => {
     const newMessages = [...messages];
     // If messageId is provided, target that specific message
     if (messageId) {
@@ -170,6 +170,9 @@ export const updateToolBlockInMessage = ({ messages, id, messageId, parameters,
                 if (toolBlock.type === "tool") {
                     if (parameters !== undefined)
                         toolBlock.parameters = parameters;
+                    else if (parametersChunk !== undefined)
+                        toolBlock.parameters =
+                            (toolBlock.parameters || "") + parametersChunk;
                     if (result !== undefined)
                         toolBlock.result = result;
                     if (shortResult !== undefined)
@@ -188,8 +191,12 @@ export const updateToolBlockInMessage = ({ messages, id, messageId, parameters,
                         toolBlock.compactParams = compactParams;
                     if (parametersChunk !== undefined)
                         toolBlock.parametersChunk = parametersChunk;
-                    if (isManuallyBackgrounded !== undefined)
-                        toolBlock.isManuallyBackgrounded = isManuallyBackgrounded;
+                    if (backgroundTaskId !== undefined)
+                        toolBlock.backgroundTaskId = backgroundTaskId;
+                    if (backgroundedByUser !== undefined)
+                        toolBlock.backgroundedByUser = backgroundedByUser;
+                    if (assistantAutoBackgrounded !== undefined)
+                        toolBlock.assistantAutoBackgrounded = assistantAutoBackgrounded;
                 }
             }
         }
@@ -204,6 +211,9 @@ export const updateToolBlockInMessage = ({ messages, id, messageId, parameters,
                 if (toolBlock.type === "tool") {
                     if (parameters !== undefined)
                         toolBlock.parameters = parameters;
+                    else if (parametersChunk !== undefined)
+                        toolBlock.parameters =
+                            (toolBlock.parameters || "") + parametersChunk;
                     if (result !== undefined)
                         toolBlock.result = result;
                     if (shortResult !== undefined)
@@ -222,8 +232,12 @@ export const updateToolBlockInMessage = ({ messages, id, messageId, parameters,
                         toolBlock.compactParams = compactParams;
                     if (parametersChunk !== undefined)
                         toolBlock.parametersChunk = parametersChunk;
-                    if (isManuallyBackgrounded !== undefined)
-                        toolBlock.isManuallyBackgrounded = isManuallyBackgrounded;
+                    if (backgroundTaskId !== undefined)
+                        toolBlock.backgroundTaskId = backgroundTaskId;
+                    if (backgroundedByUser !== undefined)
+                        toolBlock.backgroundedByUser = backgroundedByUser;
+                    if (assistantAutoBackgrounded !== undefined)
+                        toolBlock.assistantAutoBackgrounded = assistantAutoBackgrounded;
                 }
                 const foundMessageId = newMessages[i].id;
                 return { messages: newMessages, messageId: foundMessageId };
@@ -233,7 +247,7 @@ export const updateToolBlockInMessage = ({ messages, id, messageId, parameters,
                 // This handles cases where we're streaming tool parameters before execution
                 newMessages[i].blocks.push({
                     type: "tool",
-                    parameters: parameters,
+                    parameters: parameters !== undefined ? parameters : (parametersChunk ?? ""),
                     result: result || "",
                     shortResult: shortResult,
                     startLineNumber: startLineNumber,
@@ -245,7 +259,9 @@ export const updateToolBlockInMessage = ({ messages, id, messageId, parameters,
                     stage: stage ?? "start",
                     compactParams: compactParams,
                     parametersChunk: parametersChunk,
-                    isManuallyBackgrounded: isManuallyBackgrounded,
+                    backgroundTaskId: backgroundTaskId,
+                    backgroundedByUser: backgroundedByUser,
+                    assistantAutoBackgrounded: assistantAutoBackgrounded,
                 });
                 const foundMessageId = newMessages[i].id;
                 return { messages: newMessages, messageId: foundMessageId };

package/dist/utils/subagentParser.d.ts

@@ -17,9 +17,12 @@ export interface SubagentConfiguration {
 export declare function parseAgentFile(filePath: string, scope: "plugin", pluginRoot: string): SubagentConfiguration;
 /**
  * Load all subagent configurations from project and user directories, plus built-in subagents
+ * @param workdir - Working directory to scan for project-level subagents
+ * @param env - Merged environment (settings.json env over OS env). Defaults to process.env.
+ *              Used for conditional registration of builtin subagents (e.g. WAVE_VISION_MODEL).
  */
-export declare function loadSubagentConfigurations(workdir: string): Promise<SubagentConfiguration[]>;
+export declare function loadSubagentConfigurations(workdir: string, env?: Record<string, string>): Promise<SubagentConfiguration[]>;
 /**
  * Find subagent by exact name match
  */
-export declare function findSubagentByName(name: string, workdir: string): Promise<SubagentConfiguration | null>;
+export declare function findSubagentByName(name: string, workdir: string, env?: Record<string, string>): Promise<SubagentConfiguration | null>;

package/dist/utils/subagentParser.js

@@ -158,15 +158,25 @@ function scanSubagentDirectory(dirPath, scope) {
 }
 /**
  * Load all subagent configurations from project and user directories, plus built-in subagents
+ * @param workdir - Working directory to scan for project-level subagents
+ * @param env - Merged environment (settings.json env over OS env). Defaults to process.env.
+ *              Used for conditional registration of builtin subagents (e.g. WAVE_VISION_MODEL).
  */
-export async function loadSubagentConfigurations(workdir) {
+export async function loadSubagentConfigurations(workdir, env = process.env) {
     const projectWaveDir = join(workdir, ".wave", "agents");
     const projectClaudeDir = join(workdir, ".claude", "agents");
     const userWaveDir = join(process.env.HOME || "~", ".wave", "agents");
     const userClaudeDir = join(process.env.HOME || "~", ".claude", "agents");
     const builtinDir = getBuiltinSubagentsDir();
     // Load configurations from all sources
-    const builtinConfigs = scanSubagentDirectory(builtinDir, "builtin");
+    let builtinConfigs = scanSubagentDirectory(builtinDir, "builtin");
+    // Conditional registration: builtin subagents whose frontmatter requires the
+    // WAVE_VISION_MODEL env var (`model: visionModel`) are only loaded when it is
+    // set — otherwise the main model would delegate image recognition to a
+    // subagent that resolves to a non-vision model.
+    if (!env.WAVE_VISION_MODEL) {
+        builtinConfigs = builtinConfigs.filter((config) => config.model !== "visionModel");
+    }
     const userClaudeConfigs = scanSubagentDirectory(userClaudeDir, "user");
     const userWaveConfigs = scanSubagentDirectory(userWaveDir, "user");
     const projectClaudeConfigs = scanSubagentDirectory(projectClaudeDir, "project");
@@ -193,7 +203,7 @@ export async function loadSubagentConfigurations(workdir) {
 /**
  * Find subagent by exact name match
  */
-export async function findSubagentByName(name, workdir) {
-    const configurations = await loadSubagentConfigurations(workdir);
+export async function findSubagentByName(name, workdir, env) {
+    const configurations = await loadSubagentConfigurations(workdir, env);
     return configurations.find((config) => config.name === name) || null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wave-agent-sdk",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "SDK for building AI-powered development tools and agents",
   "keywords": [
     "ai",
@@ -55,6 +55,7 @@
     "fuzzysort": "^3.1.0",
     "glob": "^13.0.0",
     "lru-cache": "^11.3.5",
+    "marked": "^17.0.2",
     "minimatch": "^10.0.3",
     "openai": "^5.12.2",
     "turndown": "^7.2.2"