veryfront 0.1.209 → 0.1.211

package/esm/cli/mcp/advanced-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advanced-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/advanced-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA4B1C,eAAO,MAAM,aAAa,EAAE,OAAO,EAsBlC,CAAC"}
+{"version":3,"file":"advanced-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/advanced-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA+B1C,eAAO,MAAM,aAAa,EAAE,OAAO,EAyBlC,CAAC"}

package/esm/cli/mcp/advanced-tools.js

@@ -1,6 +1,9 @@
 import { vfCreateProject, vfListExamples, vfListIntegrations, vfListTemplates, vfListUsecases, } from "./tools/catalog-tools.js";
 import { vfGetDebugContext, vfGetFlywheelStatus, vfHotReload, vfPreviewRoute, vfTriggerHmr, vfWaitForReady, } from "./tools/dev-tools.js";
 import { vfGetComponentTree, vfGetProjectContext, vfListLocalProjects, vfListRoutes, } from "./tools/project-tools.js";
+import { vfBuild } from "./tools/build-tool.js";
+import { vfRunLint } from "./tools/run-lint-tool.js";
+import { vfRunTests } from "./tools/run-tests-tool.js";
 import { vfGetConventions, vfScaffold } from "./tools/scaffold-tools.js";
 import { vfGetSkillReference, vfGetSkills } from "./tools/skill-tools.js";
 import { cicdTools } from "./tools/cicd-tools.js";
@@ -23,8 +26,11 @@ export const advancedTools = [
     vfPreviewRoute,
     vfGetDebugContext,
     vfGetComponentTree,
+    vfBuild,
     vfHotReload,
     vfTriggerHmr,
     vfWaitForReady,
+    vfRunLint,
     vfGetFlywheelStatus,
+    vfRunTests,
 ];

package/esm/cli/mcp/standalone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/standalone.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,mBAAwB;IAM5C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAME,aAAa;IAW3B,OAAO,CAAC,cAAc;YAgCR,eAAe;IAqB7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;YAyBb,mBAAmB;IA6CjC,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;IAwB9B,OAAO,CAAC,WAAW;IAgKnB,OAAO,CAAC,mBAAmB;CA0F5B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,mBAAmB,CAI/F"}
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/standalone.ts"],"names":[],"mappings":"AAsCA,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,mBAAwB;IAM5C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAME,aAAa;IAW3B,OAAO,CAAC,cAAc;YAgCR,eAAe;IAqB7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,mBAAmB;YAyBb,mBAAmB;IA6CjC,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;IAwB9B,OAAO,CAAC,WAAW;IAwNnB,OAAO,CAAC,mBAAmB;CA0F5B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,mBAAmB,CAI/F"}

package/esm/cli/mcp/standalone.js

@@ -350,6 +350,59 @@ export class StandaloneMCPServer {
                     }
                 },
             },
+            {
+                name: "vf_run_tests",
+                description: "Run the project's test suite and get structured pass/fail results. " +
+                    "Returns a summary with total, passed, failed, skipped counts and failure details " +
+                    "including file path, test name, error message, and line number. " +
+                    "Do not use for lint checks — use vf_run_lint instead.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        filter: {
+                            type: "string",
+                            description: "Filter tests by name pattern",
+                        },
+                        parallel: {
+                            type: "boolean",
+                            description: "Run tests in parallel",
+                        },
+                        timeout: {
+                            type: "number",
+                            description: "Maximum time to wait for test completion in milliseconds (default: 300000)",
+                        },
+                    },
+                },
+                async execute(args) {
+                    const { executeTests } = await import("./tools/run-tests-tool.js");
+                    return executeTests({
+                        filter: args.filter,
+                        parallel: args.parallel,
+                        timeout: args.timeout,
+                    });
+                },
+            },
+            {
+                name: "vf_run_lint",
+                description: "Run the linter. Returns structured diagnostics with file, line, column, rule code, and message. " +
+                    "Do not use for test results — use vf_run_tests instead. " +
+                    "Do not use for compile/runtime errors — use vf_get_errors instead.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        timeout: {
+                            type: "number",
+                            description: "Maximum time to wait for lint completion in milliseconds (default: 120000)",
+                        },
+                    },
+                },
+                async execute(args) {
+                    const { executeLint } = await import("./tools/run-lint-tool.js");
+                    return executeLint({
+                        timeout: args.timeout,
+                    });
+                },
+            },
             ...this.createContext7Tools(),
         ];
     }

package/esm/cli/mcp/tools/build-tool.d.ts

@@ -0,0 +1,28 @@
+/**
+ * MCP tool for production builds.
+ */
+import { z } from "zod";
+import type { MCPTool } from "../tools.js";
+declare const buildInput: z.ZodObject<{
+    outputDir: z.ZodOptional<z.ZodString>;
+    splitting: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    compress: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    ssg: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+type BuildInput = z.infer<typeof buildInput>;
+interface BuildResult {
+    success: boolean;
+    pages?: number;
+    chunks?: number;
+    assets?: number;
+    totalSize?: number;
+    duration_ms?: number;
+    outputDir?: string;
+    dryRun?: boolean;
+    ssgPaths?: string[];
+    error?: string;
+}
+export declare const vfBuild: MCPTool<BuildInput, BuildResult>;
+export {};
+//# sourceMappingURL=build-tool.d.ts.map

package/esm/cli/mcp/tools/build-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/build-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAM3C,QAAA,MAAM,UAAU;;;;;;iBAyBd,CAAC;AAEH,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE7C,UAAU,WAAW;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,WAAW,CAyDpD,CAAC"}

package/esm/cli/mcp/tools/build-tool.js

@@ -0,0 +1,88 @@
+/**
+ * MCP tool for production builds.
+ */
+import { z } from "zod";
+import { cwd } from "../../../src/platform/index.js";
+import { join } from "../../../src/platform/compat/path/index.js";
+import { buildProduction } from "../../../src/build/index.js";
+import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
+// ============================================================================
+// Tool: vf_build
+// ============================================================================
+const buildInput = z.object({
+    outputDir: z
+        .string()
+        .optional()
+        .describe("Output directory for the build. Defaults to '<projectDir>/dist'."),
+    splitting: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Enable code splitting. Defaults to true."),
+    compress: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Enable compression (gzip/brotli). Defaults to true."),
+    ssg: z
+        .boolean()
+        .optional()
+        .default(true)
+        .describe("Enable static site generation. Defaults to true."),
+    dryRun: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("Preview the build without writing files to disk. Defaults to false."),
+});
+export const vfBuild = {
+    name: "vf_build",
+    title: "Production Build",
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    description: "Use this when you need to run a production build for the current project. " +
+        "Bundles, optimises, and writes output to the dist directory. " +
+        "Use dryRun=true to preview the build without writing files. " +
+        "Do not use for development — use the dev server tools instead. " +
+        "Do not use for lint checks — use vf_run_lint instead.",
+    inputSchema: buildInput,
+    execute: (input) => withSpan("cli.mcp.tool.vf_build", async () => {
+        const projectDir = cwd();
+        const outputDir = input.outputDir ?? join(projectDir, "dist");
+        const startTime = Date.now();
+        try {
+            const stats = await buildProduction({
+                projectDir,
+                outputDir,
+                enableSplitting: input.splitting,
+                enableCompression: input.compress,
+                ssg: input.ssg,
+                dryRun: input.dryRun,
+            });
+            const duration_ms = Date.now() - startTime;
+            return {
+                success: true,
+                pages: stats.pages,
+                chunks: stats.chunks,
+                assets: stats.assets,
+                totalSize: stats.totalSize,
+                duration_ms,
+                outputDir,
+                dryRun: input.dryRun,
+                ssgPaths: stats.ssgPaths,
+            };
+        }
+        catch (error) {
+            const duration_ms = Date.now() - startTime;
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                duration_ms,
+            };
+        }
+    }, { "tool.dryRun": input.dryRun }),
+};

package/esm/cli/mcp/tools/run-lint-tool.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import type { MCPTool } from "../tools.js";
+import { type LintResult } from "../../commands/lint/command.js";
+declare const runLintInput: z.ZodObject<{
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+type RunLintInput = z.infer<typeof runLintInput>;
+/** Spawn deno lint and return structured results. Exported for standalone reuse. */
+export declare function executeLint(input?: {
+    timeout?: number;
+}): Promise<LintResult>;
+export declare const vfRunLint: MCPTool<RunLintInput, LintResult>;
+export {};
+//# sourceMappingURL=run-lint-tool.d.ts.map

package/esm/cli/mcp/tools/run-lint-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-lint-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/run-lint-tool.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,UAAU,EAAuB,MAAM,gCAAgC,CAAC;AAEtF,QAAA,MAAM,YAAY;;iBAIhB,CAAC;AAEH,KAAK,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEjD,oFAAoF;AACpF,wBAAsB,WAAW,CAC/B,KAAK,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,UAAU,CAAC,CA2BrB;AAED,eAAO,MAAM,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,CAevD,CAAC"}

package/esm/cli/mcp/tools/run-lint-tool.js

@@ -0,0 +1,55 @@
+/**
+ * MCP tool: vf_run_lint
+ *
+ * Runs the linter via subprocess and returns structured diagnostics.
+ * Reuses parseLintJsonOutput from the CLI lint command.
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import { z } from "zod";
+import { parseLintJsonOutput } from "../../commands/lint/command.js";
+const runLintInput = z.object({
+    timeout: z.number().optional().default(120000).describe("Maximum time to wait for lint completion in milliseconds. Defaults to 120000 (2 minutes)."),
+});
+/** Spawn deno lint and return structured results. Exported for standalone reuse. */
+export async function executeLint(input = {}) {
+    const cmd = new dntShim.Deno.Command("deno", {
+        args: ["lint", "--json"],
+        stdout: "piped",
+        stderr: "piped",
+    });
+    const child = cmd.spawn();
+    const timeoutMs = input.timeout ?? 120000;
+    const result = await Promise.race([
+        child.output(),
+        new Promise((_, reject) => {
+            const timer = dntShim.setTimeout(() => {
+                try {
+                    child.kill();
+                }
+                catch {
+                    // Process may have already exited
+                }
+                reject(new Error(`Lint execution timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            dntShim.Deno.unrefTimer(timer);
+        }),
+    ]);
+    const stdout = new TextDecoder().decode(result.stdout);
+    return parseLintJsonOutput(stdout, result.code);
+}
+export const vfRunLint = {
+    name: "vf_run_lint",
+    title: "Run Lint",
+    annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    description: "Use this when you need to check for lint issues in the project. " +
+        "Returns structured diagnostics with file path, line, column, rule code, and message for each issue. " +
+        "Do not use for test results — use vf_run_tests instead. " +
+        "Do not use for compile/runtime errors — use vf_get_errors instead.",
+    inputSchema: runLintInput,
+    execute: (input) => executeLint(input),
+};

package/esm/cli/mcp/tools/run-tests-tool.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import type { MCPTool } from "../../../src/mcp/index.js";
+import { type TestResult } from "../../commands/test/command.js";
+declare const runTestsInput: z.ZodObject<{
+    filter: z.ZodOptional<z.ZodString>;
+    parallel: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+type RunTestsInput = z.infer<typeof runTestsInput>;
+/** Build the deno test command args from input options. */
+export declare function buildTestArgs(input: {
+    filter?: string;
+    parallel?: boolean;
+}): string[];
+/** Env vars required for deterministic test runs. */
+export declare const TEST_ENV: Record<string, string>;
+/** Spawn deno test and return structured results. Exported for standalone reuse. */
+export declare function executeTests(input: {
+    filter?: string;
+    parallel?: boolean;
+    timeout?: number;
+}): Promise<TestResult>;
+export declare const vfRunTests: MCPTool<RunTestsInput, TestResult>;
+export {};
+//# sourceMappingURL=run-tests-tool.d.ts.map

package/esm/cli/mcp/tools/run-tests-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tests-tool.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/run-tests-tool.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAElF,QAAA,MAAM,aAAa;;;;iBAUjB,CAAC;AAEH,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEnD,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAUtF;AAED,qDAAqD;AACrD,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM3C,CAAC;AAEF,oFAAoF;AACpF,wBAAsB,YAAY,CAChC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,UAAU,CAAC,CA8BrB;AAED,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,aAAa,EAAE,UAAU,CAgBzD,CAAC"}

package/esm/cli/mcp/tools/run-tests-tool.js

@@ -0,0 +1,80 @@
+/**
+ * MCP tool: vf_run_tests
+ *
+ * Runs the project test suite via subprocess and returns structured results.
+ * Reuses parseTestOutput from the CLI test command.
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import { z } from "zod";
+import { parseTestOutput } from "../../commands/test/command.js";
+const runTestsInput = z.object({
+    filter: z.string().optional().describe("Filter tests by name pattern. Example: 'router' to run only tests matching 'router'."),
+    parallel: z.boolean().optional().default(false).describe("Run tests in parallel. Defaults to false."),
+    timeout: z.number().optional().default(300000).describe("Maximum time to wait for test completion in milliseconds. Defaults to 300000 (5 minutes)."),
+});
+/** Build the deno test command args from input options. */
+export function buildTestArgs(input) {
+    return [
+        "test",
+        "--no-check",
+        "--allow-all",
+        "--unstable-worker-options",
+        "--unstable-net",
+        ...(input.parallel ? ["--parallel"] : []),
+        ...(input.filter ? [`--filter=${input.filter}`] : []),
+    ];
+}
+/** Env vars required for deterministic test runs. */
+export const TEST_ENV = {
+    VF_DISABLE_LRU_INTERVAL: "1",
+    SSR_TRANSFORM_PER_PROJECT_LIMIT: "0",
+    REVALIDATION_PER_PROJECT_LIMIT: "0",
+    NODE_ENV: "production",
+    LOG_FORMAT: "text",
+};
+/** Spawn deno test and return structured results. Exported for standalone reuse. */
+export async function executeTests(input) {
+    const cmd = new dntShim.Deno.Command("deno", {
+        args: buildTestArgs(input),
+        stdout: "piped",
+        stderr: "piped",
+        env: TEST_ENV,
+    });
+    const child = cmd.spawn();
+    const timeoutMs = input.timeout ?? 300000;
+    const result = await Promise.race([
+        child.output(),
+        new Promise((_, reject) => {
+            const timer = dntShim.setTimeout(() => {
+                try {
+                    child.kill();
+                }
+                catch {
+                    // Process may have already exited
+                }
+                reject(new Error(`Test execution timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            // Don't prevent process exit while waiting
+            dntShim.Deno.unrefTimer(timer);
+        }),
+    ]);
+    const stdout = new TextDecoder().decode(result.stdout);
+    const stderr = new TextDecoder().decode(result.stderr);
+    return parseTestOutput(stdout + "\n" + stderr, result.code);
+}
+export const vfRunTests = {
+    name: "vf_run_tests",
+    title: "Run Tests",
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+    description: "Use this when you need to run the project's test suite and get structured pass/fail results. " +
+        "Returns a summary with total, passed, failed, skipped counts and failure details including " +
+        "file path, test name, error message, and line number. " +
+        "Do not use for lint checks — use vf_run_lint instead.",
+    inputSchema: runTestsInput,
+    execute: (input) => executeTests(input),
+};

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.209",
+    "version": "0.1.211",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "exclude": [

package/esm/src/agent/data-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-stream.d.ts","sourceRoot":"","sources":["../../../src/src/agent/data-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAMzE,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmB1E;AAED,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAavF;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CActF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB5E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG;IACvD,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,CAoBA;AAED,wBAAuB,sBAAsB,CAC3C,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,cAAc,CAAC,sBAAsB,CAAC,CAkCxC"}
+{"version":3,"file":"data-stream.d.ts","sourceRoot":"","sources":["../../../src/src/agent/data-stream.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAMzE,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAmB1E;AAED,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAwCvF;AAED,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CActF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiB5E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG;IACvD,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,CAoBA;AAED,wBAAuB,sBAAsB,CAC3C,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,cAAc,CAAC,sBAAsB,CAAC,CAkCxC"}

package/esm/src/agent/data-stream.js

@@ -18,13 +18,35 @@ export function stripLeadingEmptyObjectPlaceholder(rawArgs) {
     return normalized;
 }
 export function mergeToolInputDelta(currentArguments, nextDelta) {
+    const normalizedDelta = nextDelta.trimStart();
+    const candidateDeltas = normalizedDelta.startsWith('"')
+        ? [normalizedDelta, `{${normalizedDelta}`]
+        : [normalizedDelta];
     if (currentArguments === "{}") {
-        const normalizedDelta = nextDelta.trimStart();
-        if (normalizedDelta.startsWith("{")) {
-            return normalizedDelta;
+        for (const candidate of candidateDeltas) {
+            if (candidate.startsWith("{")) {
+                return candidate;
+            }
         }
-        if (normalizedDelta.startsWith('"')) {
-            return `{${normalizedDelta}`;
+    }
+    if (nextDelta.length === 0) {
+        return currentArguments;
+    }
+    if (currentArguments.length === 0) {
+        return nextDelta;
+    }
+    for (const candidate of candidateDeltas) {
+        if (candidate === currentArguments || currentArguments.includes(candidate)) {
+            return currentArguments;
+        }
+        if (candidate.startsWith(currentArguments)) {
+            return candidate;
+        }
+        const maxOverlap = Math.min(currentArguments.length, candidate.length);
+        for (let overlap = maxOverlap; overlap > 0; overlap--) {
+            if (currentArguments.endsWith(candidate.slice(0, overlap))) {
+                return currentArguments + candidate.slice(overlap);
+            }
         }
     }
     return currentArguments + nextDelta;

package/esm/src/agent/runtime/index.d.ts

@@ -10,7 +10,7 @@
  *
  * @module ai/agent/runtime
  */
-import { type AgentConfig, type AgentResponse, type Message, type ToolCall, type ToolResultPart } from "../types.js";
+import { type AgentConfig, type AgentResponse, type Message, type MessagePart, type ToolCall, type ToolResultPart } from "../types.js";
 import { type Memory } from "../memory/index.js";
 import { type ChatStreamState, type StreamingToolCall, type StreamingToolResult } from "./chat-stream-handler.js";
 export { closeSSEStream, generateMessageId, sendSSE } from "./sse-utils.js";
@@ -31,6 +31,57 @@ export declare function captureStreamedToolCallInput(toolCall: Pick<StreamingToo
     inputText?: string;
     parseError?: string;
 };
+/**
+ * A streamed tool call is "incomplete" when the provider stream terminated
+ * (abort, stall, timeout, transport error) before the SDK emitted the
+ * finalizing `tool-call` event that sets `inputAvailable: true`. In that state
+ * `arguments` only holds partial JSON fragments from `tool-input-delta` events,
+ * so the tool call is NOT a committed model choice and must not be parsed or
+ * executed. This is semantically distinct from a parse failure on a finalized
+ * tool call (`inputAvailable: true` but malformed JSON — which only happens on
+ * genuine provider bugs) and needs to be reported as a stream-termination
+ * error rather than a tool-argument error.
+ */
+export declare function isStreamedToolCallIncomplete(toolCall: Pick<StreamingToolCall, "inputAvailable">): boolean;
+/**
+ * Classification of a streamed tool call when we reach end-of-stream and need
+ * to persist it into the assistant message. Three distinct cases, each with
+ * different semantics downstream:
+ *
+ * - `complete`: provider emitted the finalizing `tool-call` event and the
+ *   arguments parsed cleanly. Execute the tool normally.
+ * - `parse-error`: provider emitted the finalizing `tool-call` event but the
+ *   arguments are not valid JSON. This is a provider/SDK bug; record it as a
+ *   tool-argument error so the step can recover.
+ * - `incomplete`: stream terminated before the finalizing event fired. The
+ *   model never committed this tool use; record it as a stream-termination
+ *   error so the parent (e.g. child-fork watchdog) can decide whether to
+ *   retry the step cleanly instead of seeing a malformed tool call.
+ */
+export type StreamedToolCallMaterialization = {
+    readonly kind: "complete";
+    readonly part: MessagePart;
+} | {
+    readonly kind: "parse-error";
+    readonly part: MessagePart;
+    readonly parseError: string;
+} | {
+    readonly kind: "incomplete";
+    readonly part: MessagePart;
+    readonly partialArgumentsLength: number;
+    readonly partialArgumentsPreview: string;
+};
+/**
+ * Classify and build the persisted `MessagePart` for a single streamed tool
+ * call. Pure function — no logging, no SSE, no memory. Callers decide what to
+ * do with the result so this stays unit-testable.
+ *
+ * The resulting `part` is always pushed into the assistant message so the
+ * conversation history is transparent: even incomplete tool calls leave a
+ * visible trace with their partial `inputText`. What differs is the caller's
+ * error-surfacing behavior (log warning, SSE event, tool-result error).
+ */
+export declare function materializeStreamedToolCall(tc: StreamingToolCall): StreamedToolCallMaterialization;
 /**
  * Extract and validate the skill policy from a load-skill tool result.
  * Returns `[]` (no tools allowed) for invalid/missing policies instead of

package/esm/src/agent/runtime/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/index.ts"],"names":[],"mappings":"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"}