veryfront 0.1.132 → 0.1.136

package/esm/src/agent/runtime/ai-stream-handler.js

@@ -12,6 +12,32 @@ import { isDynamicTool } from "./tool-helpers.js";
 import { serverLogger } from "../../utils/index.js";
 import { setActiveSpanAttributes, withSpan } from "../../observability/tracing/otlp-setup.js";
 const logger = serverLogger.component("agent");
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeToolInputString(input) {
+    if (typeof input === "string") {
+        return input;
+    }
+    return JSON.stringify(input ?? null) ?? "null";
+}
+function normalizeToolInputObject(input) {
+    if (isRecord(input)) {
+        return input;
+    }
+    if (typeof input === "string") {
+        try {
+            const parsed = JSON.parse(input);
+            if (isRecord(parsed)) {
+                return parsed;
+            }
+        }
+        catch {
+            return {};
+        }
+    }
+    return {};
+}
 function createAbortError(reason) {
     if (reason instanceof Error) {
         return reason;
@@ -23,6 +49,17 @@ function throwIfAborted(abortSignal) {
         throw createAbortError(abortSignal.reason);
     }
 }
+function stringifyToolError(output) {
+    if (typeof output === "string" && output.length > 0) {
+        return output;
+    }
+    try {
+        return JSON.stringify(output);
+    }
+    catch {
+        return String(output);
+    }
+}
 export function createStreamState() {
     return {
         accumulatedText: "",
@@ -91,17 +128,14 @@ export function processStream(result, state, controller, encoder, textPartId, ca
                 case "tool-call": {
                     // tool-call fires when the full tool call is available
                     const toolId = part.toolCallId;
-                    const inputStr = JSON.stringify(part.input);
+                    const inputStr = normalizeToolInputString(part.input);
                     state.toolCalls.set(toolId, {
                         id: toolId,
                         name: part.toolName,
                         arguments: inputStr,
                     });
                     const dynamic = isDynamicTool(part.toolName);
-                    // part.input is already a parsed object — pass directly to avoid double serialization
-                    const inputObj = (part.input && typeof part.input === "object" && !Array.isArray(part.input))
-                        ? part.input
-                        : {};
+                    const inputObj = normalizeToolInputObject(part.input);
                     sendSSE(controller, encoder, {
                         type: "tool-input-available",
                         toolCallId: toolId,
@@ -111,6 +145,23 @@ export function processStream(result, state, controller, encoder, textPartId, ca
                     });
                     break;
                 }
+                case "tool-result": {
+                    const isError = "isError" in part && part.isError === true;
+                    if (isError) {
+                        sendSSE(controller, encoder, {
+                            type: "tool-output-error",
+                            toolCallId: part.toolCallId,
+                            errorText: stringifyToolError(part.output),
+                        });
+                        break;
+                    }
+                    sendSSE(controller, encoder, {
+                        type: "tool-output-available",
+                        toolCallId: part.toolCallId,
+                        output: part.output,
+                    });
+                    break;
+                }
                 case "finish": {
                     state.finishReason = part.finishReason;
                     if (part.totalUsage) {

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":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAGlB,KAAK,OAAO,EAEZ,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAgB/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC1E,YAAY,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAuDxB;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CA6BxE;AAED,gEAAgE;AAChE,KAAK,iBAAiB,GAClB;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,EACvC,kBAAkB,EAAE,OAAO,GAC1B,iBAAiB,CAiBnB;AA0BD,qBAAa,YAAY;IACvB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW;IAS3C;;OAEG;IACG,QAAQ,CACZ,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,aAAa,CAAC,EAAE,MAAM,EACtB,uBAAuB,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,aAAa,CAAC;IA2CzB;;;OAGG;IACG,MAAM,CACV,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;QAC1C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QAClC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;KAC9C,EACD,aAAa,CAAC,EAAE,MAAM,EACtB,uBAAuB,CAAC,EAAE,MAAM,EAChC,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAsHtC;;OAEG;YACW,gBAAgB;IAuO9B;;;;OAIG;YACW,yBAAyB;IA8OvC;;OAEG;YACW,eAAe;IAqC7B;;OAEG;YACW,mBAAmB;IAOjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,sBAAsB;IAY9B;;OAEG;IACH,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC;IAI5B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAC9B,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAIF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;CAGnC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/index.ts"],"names":[],"mappings":"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"}

package/esm/src/agent/runtime/index.js

@@ -502,7 +502,10 @@ export class AgentRuntime {
                 model: languageModel,
                 system: systemPrompt,
                 messages: convertToModelMessages(currentMessages),
-                tools: convertToolsToAISDK(tools),
+                tools: convertToolsToAISDK(tools, {
+                    model: effectiveModel,
+                    allowedToolNames: allowedRemoteToolNames,
+                }),
                 maxOutputTokens: this.resolveMaxOutputTokens(maxOutputTokensOverride),
                 temperature: DEFAULT_TEMPERATURE,
                 abortSignal,

package/esm/src/agent/runtime/model-tool-converter.d.ts

@@ -8,11 +8,15 @@
  */
 import type { ToolSet } from "ai";
 import type { ToolDefinition } from "../../tool/index.js";
+export interface ConvertToolsToAISDKOptions {
+    model?: string;
+    allowedToolNames?: string[];
+}
 /**
  * Convert veryfront tool definitions to AI SDK ToolSet.
  *
  * The AI SDK tool() function wraps each tool with its schema.
  * We don't provide `execute` — the agent runtime handles execution.
  */
-export declare function convertToolsToAISDK(tools: ToolDefinition[]): ToolSet | undefined;
+export declare function convertToolsToAISDK(tools: ToolDefinition[], options?: ConvertToolsToAISDKOptions): ToolSet | undefined;
 //# sourceMappingURL=model-tool-converter.d.ts.map

package/esm/src/agent/runtime/model-tool-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-tool-converter.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/model-tool-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EAAE,GACtB,OAAO,GAAG,SAAS,CAarB"}
+{"version":3,"file":"model-tool-converter.d.ts","sourceRoot":"","sources":["../../../../src/src/agent/runtime/model-tool-converter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAgCD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,GAAG,SAAS,CAoBrB"}

package/esm/src/agent/runtime/model-tool-converter.js

@@ -7,15 +7,38 @@
  * @module ai/agent/runtime/model-tool-converter
  */
 import { jsonSchema, tool } from "ai";
+import { anthropic } from "@ai-sdk/anthropic";
+function resolveHostedProvider(model) {
+    if (!model)
+        return undefined;
+    const [provider, second] = model.split("/", 3);
+    if (!provider)
+        return undefined;
+    if (provider === "veryfront-cloud") {
+        return second || undefined;
+    }
+    return provider;
+}
+function resolveProviderNativeTools(options) {
+    if (!options?.allowedToolNames?.includes("web_search")) {
+        return undefined;
+    }
+    if (resolveHostedProvider(options.model) !== "anthropic") {
+        return undefined;
+    }
+    return {
+        web_search: anthropic.tools.webSearch_20250305({
+            maxUses: 5,
+        }),
+    };
+}
 /**
  * Convert veryfront tool definitions to AI SDK ToolSet.
  *
  * The AI SDK tool() function wraps each tool with its schema.
  * We don't provide `execute` — the agent runtime handles execution.
  */
-export function convertToolsToAISDK(tools) {
-    if (!tools.length)
-        return undefined;
+export function convertToolsToAISDK(tools, options) {
     const toolSet = {};
     for (const def of tools) {
         toolSet[def.name] = tool({
@@ -23,5 +46,13 @@ export function convertToolsToAISDK(tools) {
             inputSchema: jsonSchema(def.parameters),
         });
     }
-    return toolSet;
+    const providerNativeTools = resolveProviderNativeTools(options);
+    if (providerNativeTools) {
+        for (const [name, providerTool] of Object.entries(providerNativeTools)) {
+            if (!Object.hasOwn(toolSet, name)) {
+                toolSet[name] = providerTool;
+            }
+        }
+    }
+    return Object.keys(toolSet).length > 0 ? toolSet : undefined;
 }

package/esm/src/agent/types.d.ts

@@ -12,6 +12,24 @@ import type { Message, MessagePart, ToolCall, ToolCallPart, ToolCallPartWithArgs
  */
 export type ModelString = string;
 import type { EdgeConfig, MemoryConfig } from "./schemas/index.js";
+export type AgentSuggestion = {
+    id: string;
+    type: "prompt";
+    title: string;
+    description?: string;
+    prompt: string;
+} | {
+    id: string;
+    type: "task";
+    title: string;
+    description?: string;
+    task: string;
+    prompt?: string;
+};
+export interface AgentSuggestions {
+    welcomeMessage?: string;
+    suggestions: AgentSuggestion[];
+}
 export interface AgentConfig {
     id?: string;
     /**
@@ -45,6 +63,7 @@ export interface AgentConfig {
      * and registers the skill tools.
      */
     skills?: true | string[];
+    suggestions?: AgentSuggestions;
     /** Set to false to disable the default security middleware */
     security?: false;
 }

package/esm/src/agent/types.d.ts.map

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

package/esm/src/channels/control-plane.d.ts

@@ -24,6 +24,37 @@ export declare const RuntimeAgentSkillSchema: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
+export declare const RuntimeAgentSuggestionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"prompt">;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"task">;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    task: z.ZodString;
+    prompt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+export declare const RuntimeAgentSuggestionsSchema: z.ZodObject<{
+    welcomeMessage: z.ZodOptional<z.ZodString>;
+    suggestions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"prompt">;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        prompt: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodLiteral<"task">;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        task: z.ZodString;
+        prompt: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>;
+}, z.core.$strip>;
 export declare const RuntimeAgentSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
@@ -37,6 +68,23 @@ export declare const RuntimeAgentSchema: z.ZodObject<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
         examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>>;
+    suggestions: z.ZodOptional<z.ZodObject<{
+        welcomeMessage: z.ZodOptional<z.ZodString>;
+        suggestions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"prompt">;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodLiteral<"task">;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            task: z.ZodString;
+            prompt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>], "type">>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export declare const RuntimeAgentListResponseSchema: z.ZodObject<{
     agents: z.ZodArray<z.ZodObject<{
@@ -52,6 +100,23 @@ export declare const RuntimeAgentListResponseSchema: z.ZodObject<{
             tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
             examples: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>>;
+        suggestions: z.ZodOptional<z.ZodObject<{
+            welcomeMessage: z.ZodOptional<z.ZodString>;
+            suggestions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"prompt">;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                prompt: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                id: z.ZodString;
+                type: z.ZodLiteral<"task">;
+                title: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                task: z.ZodString;
+                prompt: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>], "type">>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 declare const dispatchClaimsSchema: z.ZodObject<{
@@ -82,6 +147,8 @@ declare const controlPlaneClaimsSchema: z.ZodObject<{
 export type ControlPlaneSurface = z.infer<typeof ControlPlaneSurfaceSchema>;
 export type ControlPlaneAgentsListRequest = z.infer<typeof ControlPlaneAgentsListRequestSchema>;
 export type RuntimeAgentSkill = z.infer<typeof RuntimeAgentSkillSchema>;
+export type RuntimeAgentSuggestion = z.infer<typeof RuntimeAgentSuggestionSchema>;
+export type RuntimeAgentSuggestions = z.infer<typeof RuntimeAgentSuggestionsSchema>;
 export type RuntimeAgent = z.infer<typeof RuntimeAgentSchema>;
 export type RuntimeAgentListResponse = z.infer<typeof RuntimeAgentListResponseSchema>;
 export type DispatchClaims = z.infer<typeof dispatchClaimsSchema>;

package/esm/src/channels/control-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../../src/src/channels/control-plane.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,yBAAyB;;;;;EAA+C,CAAC;AAEtF,eAAO,MAAM,mCAAmC;;;;;;;;;iBAI9C,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;iBAEzC,CAAC;AAEH,QAAA,MAAM,oBAAoB;;;;;;;;;iBASxB,CAAC;AAEH,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;iBAS5B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mCAAmC,CAAC,CAAC;AAChG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AACtF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,KAAK,GAAG,SAAS,CAAC;IAC5C,cAAc,EAAE,MAAM,MAAM,EAAE,CAAC;CAChC;AA4KD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,wBAAwB,CAAC,CAUnC;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,cAAc,CAAC,CAmBzB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAmB7B"}
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../../src/src/channels/control-plane.ts"],"names":[],"mappings":"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"}

package/esm/src/channels/control-plane.js

@@ -21,6 +21,27 @@ export const RuntimeAgentSkillSchema = z.object({
     tags: z.array(z.string()).optional(),
     examples: z.array(z.string()).optional(),
 });
+export const RuntimeAgentSuggestionSchema = z.discriminatedUnion("type", [
+    z.object({
+        id: z.string().min(1),
+        type: z.literal("prompt"),
+        title: z.string().min(1),
+        description: z.string().optional(),
+        prompt: z.string().min(1),
+    }),
+    z.object({
+        id: z.string().min(1),
+        type: z.literal("task"),
+        title: z.string().min(1),
+        description: z.string().optional(),
+        task: z.string().min(1),
+        prompt: z.string().min(1).optional(),
+    }),
+]);
+export const RuntimeAgentSuggestionsSchema = z.object({
+    welcomeMessage: z.string().min(1).optional(),
+    suggestions: z.array(RuntimeAgentSuggestionSchema),
+});
 export const RuntimeAgentSchema = z.object({
     id: z.string().min(1),
     name: z.string().min(1),
@@ -28,6 +49,7 @@ export const RuntimeAgentSchema = z.object({
     model: z.string().nullable().optional(),
     version: z.string().nullable().optional(),
     skills: z.array(RuntimeAgentSkillSchema).optional(),
+    suggestions: RuntimeAgentSuggestionsSchema.optional(),
 });
 export const RuntimeAgentListResponseSchema = z.object({
     agents: z.array(RuntimeAgentSchema),
@@ -150,6 +172,10 @@ function resolveAgentSkills(agent) {
 }
 function getRuntimeAgentMetadata(id, agent) {
     const rawConfig = agent.config;
+    const suggestionsParseResult = rawConfig.suggestions === undefined
+        ? null
+        : RuntimeAgentSuggestionsSchema.safeParse(rawConfig.suggestions);
+    const suggestions = suggestionsParseResult?.success ? suggestionsParseResult.data : undefined;
     return RuntimeAgentSchema.parse({
         id,
         name: typeof rawConfig.name === "string" && rawConfig.name.trim().length > 0
@@ -159,6 +185,7 @@ function getRuntimeAgentMetadata(id, agent) {
         model: agent.config.model ?? null,
         version: typeof rawConfig.version === "string" ? rawConfig.version : null,
         skills: resolveAgentSkills(agent),
+        ...(suggestions === undefined ? {} : { suggestions }),
     });
 }
 export async function listRuntimeAgents(ctx, deps) {

package/esm/src/discovery/handlers/tool-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/tool-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAW9C,CAAC"}
+{"version":3,"file":"tool-handler.d.ts","sourceRoot":"","sources":["../../../../src/src/discovery/handlers/tool-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQpD,eAAO,MAAM,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAiB9C,CAAC"}

package/esm/src/discovery/handlers/tool-handler.js

@@ -3,12 +3,22 @@
  */
 import { registerTool } from "../../mcp/index.js";
 import { filenameToId } from "../discovery-utils.js";
+function hasGeneratedToolId(tool) {
+    return typeof tool.__veryfrontGeneratedId === "string" &&
+        tool.id === tool.__veryfrontGeneratedId;
+}
 export const toolHandler = {
     typeName: "tool",
     validate: (item) => item !== null && typeof item === "object" && typeof item.execute === "function",
-    getId: (_item, file) => filenameToId(file),
+    getId: (tool, file) => {
+        return typeof tool.id === "string" &&
+            tool.id.trim().length > 0 &&
+            !hasGeneratedToolId(tool)
+            ? tool.id
+            : filenameToId(file);
+    },
     register: (id, tool) => {
-        const toolWithId = { ...tool, id };
+        const toolWithId = tool.id === id ? tool : { ...tool, id };
         registerTool(id, toolWithId);
         return toolWithId;
     },

package/esm/src/html/html-injection.d.ts

@@ -27,6 +27,8 @@ export interface InjectHTMLContentOptions {
     yjsGuid?: string;
     /** Pre-built import map JSON for ESM module resolution (injected into <head>) */
     importMapJson?: string;
+    /** Framework-generated project stylesheet for production shells */
+    projectStylesheetHref?: string;
 }
 export declare function injectHTMLContent(template: string, content: string, metadata: HTMLMetadata, options: InjectHTMLContentOptions): string;
 //# sourceMappingURL=html-injection.d.ts.map

package/esm/src/html/html-injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-injection.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAkB/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACvC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgBD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAmGR"}
+{"version":3,"file":"html-injection.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-injection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAkB/D,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IACvC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAgBD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,wBAAwB,GAChC,MAAM,CAwGR"}

package/esm/src/html/html-injection.js

@@ -37,6 +37,10 @@ export function injectHTMLContent(template, content, metadata, options) {
         const importMapTag = `<script type="importmap"${nonceAttr}>\n${options.importMapJson}\n</script>`;
         html = html.replace(/<\/head>/i, `${importMapTag}\n</head>`);
     }
+    if (options.projectStylesheetHref && /<\/head>/i.test(html) && !hasProjectStylesheet(html)) {
+        const projectStylesheetTag = `<link rel="stylesheet" href="${options.projectStylesheetHref}">`;
+        html = html.replace(/<\/head>/i, `${projectStylesheetTag}\n</head>`);
+    }
     const shouldUsePreviewStylesheet = options.mode === "development" ||
         options.environment === "preview";
     if (shouldUsePreviewStylesheet && /<\/head>/i.test(html) && !hasProjectStylesheet(html)) {

package/esm/src/html/nonce-injection.d.ts

@@ -1,2 +1,3 @@
 export declare function addNonceToHtmlTags(html: string, nonce?: string): string;
+export declare function addNonceToHtmlStream(stream: ReadableStream<Uint8Array>, nonce?: string): ReadableStream<Uint8Array>;
 //# sourceMappingURL=nonce-injection.d.ts.map

package/esm/src/html/nonce-injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nonce-injection.d.ts","sourceRoot":"","sources":["../../../src/src/html/nonce-injection.ts"],"names":[],"mappings":"AAmEA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA6DvE"}
+{"version":3,"file":"nonce-injection.d.ts","sourceRoot":"","sources":["../../../src/src/html/nonce-injection.ts"],"names":[],"mappings":"AAgIA,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CA6DvE;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,KAAK,CAAC,EAAE,MAAM,GACb,cAAc,CAAC,UAAU,CAAC,CAyG5B"}

package/esm/src/html/nonce-injection.js

@@ -41,9 +41,62 @@ function findRawTextClosingTagStart(lowerHtml, tagName, fromIndex) {
     }
     return -1;
 }
+function findAttribute(tag, attributeName) {
+    const closeIndex = tag.lastIndexOf(">");
+    if (closeIndex <= 0)
+        return undefined;
+    let index = 1;
+    while (index < closeIndex && !/\s|\/|>/u.test(tag[index] ?? ""))
+        index++;
+    while (index < closeIndex) {
+        while (index < closeIndex && /\s/u.test(tag[index] ?? ""))
+            index++;
+        if (index >= closeIndex)
+            break;
+        const char = tag[index];
+        if (char === "/" || char === ">")
+            break;
+        const start = index;
+        while (index < closeIndex && !/[\s=/>]/u.test(tag[index] ?? ""))
+            index++;
+        const name = tag.slice(start, index);
+        while (index < closeIndex && /\s/u.test(tag[index] ?? ""))
+            index++;
+        let value = null;
+        if (tag[index] === "=") {
+            index++;
+            while (index < closeIndex && /\s/u.test(tag[index] ?? ""))
+                index++;
+            const quote = tag[index];
+            if (quote === '"' || quote === "'") {
+                index++;
+                const valueStart = index;
+                while (index < closeIndex && tag[index] !== quote)
+                    index++;
+                value = tag.slice(valueStart, index);
+                if (index < closeIndex)
+                    index++;
+            }
+            else {
+                const valueStart = index;
+                while (index < closeIndex && !/[\s>]/u.test(tag[index] ?? ""))
+                    index++;
+                value = tag.slice(valueStart, index);
+            }
+        }
+        if (name.toLowerCase() === attributeName) {
+            return { name, start, end: index, value };
+        }
+    }
+    return undefined;
+}
 function injectNonceIntoOpeningTag(tag, escapedNonce) {
-    if (/(?:\s|<)nonce\s*=/iu.test(tag))
-        return tag;
+    const existingNonce = findAttribute(tag, "nonce");
+    if (existingNonce) {
+        if (existingNonce.value?.trim())
+            return tag;
+        return `${tag.slice(0, existingNonce.start)}nonce="${escapedNonce}"${tag.slice(existingNonce.end)}`;
+    }
     const closeIndex = tag.lastIndexOf(">");
     if (closeIndex === -1)
         return tag;
@@ -102,3 +155,95 @@ export function addNonceToHtmlTags(html, nonce) {
     }
     return result;
 }
+export function addNonceToHtmlStream(stream, nonce) {
+    if (!nonce)
+        return stream;
+    const escapedNonce = escapeHtml(nonce);
+    const decoder = new TextDecoder();
+    const encoder = new TextEncoder();
+    let buffer = "";
+    let rawTextTag = null;
+    function transformBuffer(flush) {
+        let result = "";
+        let index = 0;
+        const lowerBuffer = buffer.toLowerCase();
+        while (index < buffer.length) {
+            if (rawTextTag) {
+                const closingIndex = findRawTextClosingTagStart(lowerBuffer, rawTextTag, index);
+                if (closingIndex === -1) {
+                    if (flush) {
+                        result += buffer.slice(index);
+                        index = buffer.length;
+                        break;
+                    }
+                    const retainLength = `</${rawTextTag}`.length;
+                    const safeEnd = Math.max(index, buffer.length - retainLength);
+                    result += buffer.slice(index, safeEnd);
+                    index = safeEnd;
+                    break;
+                }
+                result += buffer.slice(index, closingIndex);
+                index = closingIndex;
+                rawTextTag = null;
+                continue;
+            }
+            if (buffer.startsWith("<!--", index)) {
+                const commentEnd = buffer.indexOf("-->", index + 4);
+                if (commentEnd === -1) {
+                    if (flush) {
+                        result += buffer.slice(index);
+                        index = buffer.length;
+                    }
+                    break;
+                }
+                const endIndex = commentEnd + 3;
+                result += buffer.slice(index, endIndex);
+                index = endIndex;
+                continue;
+            }
+            if (buffer[index] !== "<") {
+                const nextTagIndex = buffer.indexOf("<", index);
+                const endIndex = nextTagIndex === -1 ? buffer.length : nextTagIndex;
+                result += buffer.slice(index, endIndex);
+                index = endIndex;
+                continue;
+            }
+            const tagEnd = findTagEnd(buffer, index);
+            if (tagEnd === -1) {
+                if (flush) {
+                    result += buffer.slice(index);
+                    index = buffer.length;
+                }
+                break;
+            }
+            const tag = buffer.slice(index, tagEnd + 1);
+            const tagName = getOpeningTagName(tag);
+            if (!tagName) {
+                result += tag;
+                index = tagEnd + 1;
+                continue;
+            }
+            result += injectNonceIntoOpeningTag(tag, escapedNonce);
+            index = tagEnd + 1;
+            if (!/\/\s*>$/u.test(tag)) {
+                rawTextTag = tagName;
+            }
+        }
+        buffer = buffer.slice(index);
+        return result;
+    }
+    return stream.pipeThrough(new TransformStream({
+        transform(chunk, controller) {
+            buffer += decoder.decode(chunk, { stream: true });
+            const transformed = transformBuffer(false);
+            if (transformed)
+                controller.enqueue(encoder.encode(transformed));
+        },
+        flush(controller) {
+            buffer += decoder.decode();
+            const transformed = transformBuffer(true);
+            if (transformed)
+                controller.enqueue(encoder.encode(transformed));
+        },
+    }));
+}

package/esm/src/internal-agents/ag-ui-sse.d.ts

@@ -13,6 +13,7 @@ export interface RunFinishedMetadata {
 export interface StreamTransformState {
     messageId: string | null;
     textOpen: boolean;
+    sawVisibleOutput: boolean;
     sawTerminalError: boolean;
     metadata: RunFinishedMetadata;
 }