@lowdefy/ai-utils 5.3.0 → 5.5.0

package/dist/AISDKAgentSchema.js

@@ -213,6 +213,13 @@
                 type: 'AISDKAgent agent property "repairToolCall" should be a boolean.'
             }
         },
+        generateTitle: {
+            type: 'boolean',
+            description: 'When true, generate a short conversation title on the first turn from the first user message. Emits a "data-chat-title" data part that fires the block\'s onTitleGenerated event. Off by default.',
+            errorMessage: {
+                type: 'AISDKAgent agent property "generateTitle" should be a boolean.'
+            }
+        },
         prepareStep: {
             type: 'array',
             items: {

package/dist/buildAgentTools.js

@@ -16,7 +16,7 @@
 import { createMCPClient } from '@ai-sdk/mcp';
 import { Experimental_StdioMCPTransport } from '@ai-sdk/mcp/mcp-stdio';
 import { ConfigError } from '@lowdefy/errors';
-import { serializer } from '@lowdefy/helpers';
+import { serializer, translate } from '@lowdefy/helpers';
 import listFiles from './fileSystem/listFiles.js';
 import readFile from './fileSystem/readFile.js';
 import searchFiles from './fileSystem/searchFiles.js';
@@ -30,22 +30,36 @@ import RESERVED_PLATFORM_TOOL_NAMES from './reservedToolNames.js';
 function cleanBuildArtifact(obj) {
     return JSON.parse(JSON.stringify(serializer.deserialize(obj)));
 }
-function assertNotReserved(name, kind) {
+function assertNotReserved(name, kind, i18n) {
     if (RESERVED_PLATFORM_TOOL_NAMES.includes(name)) {
-        throw new ConfigError(`${kind} "${name}" uses a reserved platform tool name. ` + `Rename it (e.g., to "${name}-app" or "custom-${name}"). ` + `Reserved: ${RESERVED_PLATFORM_TOOL_NAMES.join(', ')}.`);
+        throw new ConfigError(translate({
+            key: 'agent.runtime.reservedToolName',
+            values: {
+                kind,
+                name,
+                reserved: RESERVED_PLATFORM_TOOL_NAMES.join(', ')
+            },
+            i18n
+        }));
     }
 }
 async function buildAgentTools({ agent, context, depth = 0 }) {
     const MAX_DEPTH = 5;
     if (depth > MAX_DEPTH) {
-        throw new Error(`Sub-agent nesting exceeds maximum depth of ${MAX_DEPTH}.`);
+        throw new Error(translate({
+            key: 'agent.runtime.subAgentDepthExceeded',
+            values: {
+                max: MAX_DEPTH
+            },
+            i18n: context.i18n
+        }));
     }
     const tools = {};
     const mcpClients = [];
     // Build endpoint tools
     for (const toolConfig of agent.tools ?? []){
         const { endpointId, confirm } = toolConfig;
-        assertNotReserved(endpointId, 'Endpoint tool');
+        assertNotReserved(endpointId, 'Endpoint tool', context.i18n);
         const endpointConfig = await context.getEndpointConfig({
             endpointId
         });
@@ -62,7 +76,10 @@ async function buildAgentTools({ agent, context, depth = 0 }) {
                 });
                 if (!result.success) {
                     const err = serializer.deserialize(result.error);
-                    throw new Error(err?.message ?? 'Endpoint execution failed');
+                    throw new Error(err?.message ?? translate({
+                        key: 'agent.runtime.toolExecutionFailed',
+                        i18n: context.i18n
+                    }));
                 }
                 return cleanBuildArtifact(result.response);
             }
@@ -135,7 +152,7 @@ async function buildAgentTools({ agent, context, depth = 0 }) {
     }
     // Build sub-agent tools
     for (const subAgentRef of agent.agents ?? []){
-        assertNotReserved(subAgentRef.agentId, 'Sub-agent');
+        assertNotReserved(subAgentRef.agentId, 'Sub-agent', context.i18n);
         const subAgentConfig = await context.getAgentConfig({
             agentId: subAgentRef.agentId
         });

package/dist/handleAgentChat.js

@@ -12,7 +12,7 @@
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-*/ import { ToolLoopAgent, convertToModelMessages, createAgentUIStream, createUIMessageStream, createUIMessageStreamResponse, pruneMessages, stepCountIs, hasToolCall, validateUIMessages } from 'ai';
+*/ import { ToolLoopAgent, convertToModelMessages, createAgentUIStream, createUIMessageStream, createUIMessageStreamResponse, generateText, pruneMessages, stepCountIs, hasToolCall, validateUIMessages } from 'ai';
 import { serializer } from '@lowdefy/helpers';
 import buildAgentTools from './buildAgentTools.js';
 import buildPrepareStep from './buildPrepareStep.js';
@@ -69,14 +69,17 @@ const hookMapping = {
     onToolCallFinish: 'experimental_onToolCallFinish',
     onStepFinish: 'onStepFinish'
 };
-function createHookCallbacks({ hooks, callEndpoint }) {
+function createHookCallbacks({ hooks, callEndpoint, locale }) {
     if (!hooks) return {};
     const callbacks = {};
     for (const [yamlKey, sdkKey] of Object.entries(hookMapping)){
         const endpointIds = hooks[yamlKey];
         if (!endpointIds || endpointIds.length === 0) continue;
         callbacks[sdkKey] = (event)=>{
-            const payload = cleanHookEvent(event);
+            const payload = {
+                ...cleanHookEvent(event),
+                locale
+            };
             for (const endpointId of endpointIds){
                 callEndpoint(endpointId, {
                     payload
@@ -109,6 +112,13 @@ function convertDataUrlsToBase64(messages) {
         };
     });
 }
+// Concatenate the text parts of the first user message — used as the source
+// for generateTitle.
+function getFirstUserText(messages) {
+    const firstUser = messages.find((msg)=>msg.role === 'user');
+    if (!firstUser) return '';
+    return (firstUser.parts ?? []).filter((part)=>part.type === 'text').map((part)=>part.text).join('');
+}
 async function handleAgentChat({ connection, properties, context }) {
     const { agent, messages: rawMessages } = properties;
     const messages = convertDataUrlsToBase64(rawMessages);
@@ -124,9 +134,11 @@ async function handleAgentChat({ connection, properties, context }) {
         tools['update-page-state'] = updatePageStateTool;
     }
     const model = connection.provider(agent.properties.model);
+    const locale = context.i18n?.active;
     const hookCallbacks = createHookCallbacks({
         hooks: agent.hooks,
-        callEndpoint: context.callEndpoint
+        callEndpoint: context.callEndpoint,
+        locale
     });
     // Prepend page context to instructions when pageContext is enabled
     let instructions = agent.properties.instructions;
@@ -196,11 +208,16 @@ async function handleAgentChat({ connection, properties, context }) {
     const timeoutConfig = agent.properties.timeout != null ? {
         timeout: agent.properties.timeout
     } : {};
+    const titleEnabled = agent.properties.generateTitle === true;
     const stream = createUIMessageStream({
         execute: async ({ writer })=>{
             const usageAccumulator = createUsageAccumulator();
             const steps = [];
             let agentStream;
+            // The AI SDK delivers the full updated UI message list (input + generated
+            // assistant reply) to the stream-level onFinish. Capture it so onFinish
+            // hooks persist the complete conversation, not just the request input.
+            let capturedMessages;
             function collectStep(stepResult) {
                 usageAccumulator.add(stepResult);
                 steps.push({
@@ -211,6 +228,37 @@ async function handleAgentChat({ connection, properties, context }) {
                     finishReason: stepResult.finishReason
                 });
             }
+            function captureMessages({ messages: finalMessages }) {
+                capturedMessages = finalMessages;
+            }
+            // Generate a short conversation title from the first user message,
+            // concurrently with the agent stream. The data-chat-title part fires the
+            // block's onTitleGenerated event. Only on the first turn; failures are
+            // non-fatal.
+            let titlePromise;
+            const isFirstTurn = !messages.some((msg)=>msg.role === 'assistant');
+            if (titleEnabled && isFirstTurn) {
+                const firstUserText = getFirstUserText(messages);
+                if (firstUserText) {
+                    titlePromise = generateText({
+                        model,
+                        maxOutputTokens: 20,
+                        prompt: `Generate a concise 3-6 word title for a conversation that begins with this message. Reply with only the title, no quotes:\n\n${firstUserText}`
+                    }).then(({ text })=>{
+                        const title = text.trim();
+                        if (title) {
+                            writer.write({
+                                type: 'data-chat-title',
+                                data: {
+                                    title
+                                }
+                            });
+                        }
+                    }).catch((error)=>{
+                        console.warn(`generateTitle failed: ${error.message}`);
+                    });
+                }
+            }
             if (pruneConfig) {
                 // Decompose createAgentUIStream so we can insert pruneMessages
                 // between the UIMessage→ModelMessage conversion and agent execution.
@@ -231,7 +279,8 @@ async function handleAgentChat({ connection, properties, context }) {
                     onStepFinish: collectStep
                 });
                 agentStream = result.toUIMessageStream({
-                    originalMessages: validatedMessages
+                    originalMessages: validatedMessages,
+                    onFinish: captureMessages
                 });
             } else {
                 // createAgentUIStream validates UIMessages, converts to ModelMessages,
@@ -241,7 +290,8 @@ async function handleAgentChat({ connection, properties, context }) {
                     agent: agentInstance,
                     uiMessages: messages,
                     ...timeoutConfig,
-                    onStepFinish: collectStep
+                    onStepFinish: collectStep,
+                    onFinish: captureMessages
                 });
             }
             // Read the agent stream to completion before running onFinish hooks.
@@ -260,16 +310,21 @@ async function handleAgentChat({ connection, properties, context }) {
                     errorText: writer.onError(error)
                 });
             }
+            // Ensure the title (if any) is written before the stream closes.
+            if (titlePromise) {
+                await titlePromise;
+            }
             // Call onFinish hooks — awaited so dataParts can be written to stream.
             if (hasOnFinishHooks) {
                 const finishPayload = {
-                    messages,
+                    messages: capturedMessages ?? messages,
                     steps,
                     toolResults: steps.flatMap((s)=>s.toolResults ?? []),
                     finishReason: usageAccumulator.getFinishReason(),
                     isAborted: false,
                     ...context.agentContext ?? {},
-                    usage: usageAccumulator.usage
+                    usage: usageAccumulator.usage,
+                    locale
                 };
                 for (const endpointId of onFinishEndpointIds){
                     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/ai-utils",
-  "version": "5.3.0",
+  "version": "5.5.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -17,8 +17,8 @@
   ],
   "dependencies": {
     "@ai-sdk/mcp": "1.0.41",
-    "@lowdefy/errors": "5.3.0",
-    "@lowdefy/helpers": "5.3.0",
+    "@lowdefy/errors": "5.5.0",
+    "@lowdefy/helpers": "5.5.0",
     "ai": "6.0.176",
     "glob": "13.0.6"
   },