openkbs 0.0.52 → 0.0.55

package/templates/app/instructions.txt

@@ -1 +1,13 @@
-You are an AI assistant, assist users with their inquiries and tasks efficiently.
+You are an AI assistant, assist users with their inquiries and tasks efficiently.
+
+LIST OF AVAILABLE COMMANDS:
+To execute a command, output it as text message and wait for system response.
+
+<googleSearch>
+{
+  "query": "search query"
+}
+</googleSearch>
+Description: """
+Get results from Google Search API.
+"""

package/templates/app/settings.json

@@ -1,14 +1,13 @@
 {
-  "chatVendor": "anthropic",
+  "chatVendor": "google",
   "kbDescription": "{{{openkbsAppName}}}",
   "kbTitle": "{{{openkbsAppName}}}",
-  "model": "claude-sonnet-4-20250514",
+  "model": "gemini-3-pro",
   "inputTools": [
-    "imageToText",
     "speechToText"
   ],
-  "embeddingModel": "text-embedding-3-small",
-  "embeddingDimension": 1536,
-  "searchEngine": "IndexedDB",
+  "embeddingModel": "text-embedding-3-large",
+  "embeddingDimension": 3072,
+  "searchEngine": "VectorDB",
   "itemTypes": {}
 }

package/templates/src/Events/actions.js

@@ -1,16 +1,50 @@
-// This boilerplate code is a starting point for development.
-export const getActions = () => [
-    [/\/?googleSearch\("(.*?)"\)/, async (match) => {
-        const q = match[1];
+export const getActions = (meta, event) => [
+    // Google Search with JSON
+    // Usage: <googleSearch>{"query": "search terms"}</googleSearch>
+    [/<googleSearch>([\s\S]*?)<\/googleSearch>/s, async (match) => {
         try {
-            const response = await openkbs.googleSearch(q, {});
-            const data = response?.map(({ title, link, snippet, pagemap }) => ({
-                title, link, snippet, image: pagemap?.metatags?.[0]?.["og:image"]
+            const data = JSON.parse(match[1].trim());
+            const response = await openkbs.googleSearch(data.query);
+            const results = response?.map(({ title, link, snippet, pagemap }) => ({
+                title,
+                link,
+                snippet,
+                image: pagemap?.metatags?.[0]?.["og:image"]
             }));
-            return { data };
+            return { data: results, ...meta };
         } catch (e) {
-            return { error: e.message };
+            return { error: e.message, ...meta };
         }
     }],
+
+    // MCP (Model Context Protocol) Tool Handler
+    // Automatically handles all MCP tool calls: <mcp_{server}_{toolName}>{params}</mcp_{server}_{toolName}>
+    // Configure MCP servers in settings.json: { "options": { "mcpServers": { "github": {} } } }
+    // Add required secrets (e.g., GITHUB_PERSONAL_ACCESS_TOKEN) in KB secrets
+    [/<mcp_([a-z0-9-]+)_([a-z0-9_]+)>([\s\S]*?)<\/mcp_\1_\2>/s, async (match) => {
+        try {
+            const server = match[1];
+            const toolName = match[2];
+            const args = match[3].trim() ? JSON.parse(match[3].trim()) : {};
+
+            const result = await openkbs.mcp.callTool(server, toolName, args);
+            return {
+                type: 'MCP_RESULT',
+                server,
+                tool: toolName,
+                data: result?.content || [],
+                ...meta,
+                _meta_actions: ['REQUEST_CHAT_MODEL']
+            };
+        } catch (e) {
+            return {
+                type: 'MCP_ERROR',
+                error: e.message,
+                ...meta,
+                _meta_actions: ['REQUEST_CHAT_MODEL']
+            };
+        }
+    }],
+
     // add more actions here
 ];

package/templates/src/Events/handler.js

@@ -1,46 +1,45 @@
-import {getActions} from './actions.js';
+import { getActions } from './actions.js';
 
 export const backendHandler = async (event) => {
-    const maxSelfInvokeMessagesCount = 60;
+    const meta = { _meta_actions: ["REQUEST_CHAT_MODEL"] };
     const lastMessage = event.payload.messages[event.payload.messages.length - 1];
-    const actions = getActions();
+    const actions = getActions(meta, event);
 
-    const matchingActions = actions.reduce((acc, [regex, action]) => {
-        const matches = [...lastMessage.content.matchAll(new RegExp(regex, 'g'))];
+    const matchingActions = [];
+    actions.forEach(([regex, action]) => {
+        const matches = [...(lastMessage.content || '').matchAll(new RegExp(regex, 'g'))];
         matches.forEach(match => {
-            acc.push(action(match, event));
+            matchingActions.push(action(match, event));
         });
-        return acc;
-    }, []);
-
-    // IMPORTANT: Actions returning JOB_COMPLETED or JOB_FAILED stop agent execution and return final result
-    const isJobFinished = /"JOB_COMPLETED"|"JOB_FAILED"/.test(lastMessage.content);
-
-    const meta = {
-        _meta_actions:
-            (
-                event?.payload?.messages?.length > maxSelfInvokeMessagesCount ||
-                isJobFinished && lastMessage.role === 'system'
-            )
-                ? []
-                : ["REQUEST_CHAT_MODEL"]
-    }
+    });
 
     if (matchingActions.length > 0) {
         try {
             const results = await Promise.all(matchingActions);
 
-            if (results?.[0]?.data?.some?.(o => o?.type === 'image_url')) {
+            // Check if any result needs LLM callback
+            const needsChatModel = results.some(r =>
+                r?._meta_actions?.includes('REQUEST_CHAT_MODEL')
+            );
+
+            // Handle image data for LLM vision
+            if (results.some(r => r?.data?.some?.(item => item?.type === 'image_url'))) {
                 return {
                     ...results[0],
-                    ...meta
+                    _meta_actions: needsChatModel ? ["REQUEST_CHAT_MODEL"] : []
                 };
             }
 
+            // Single result - return as is
+            if (results.length === 1) {
+                return results[0];
+            }
+
+            // Multiple results
             return {
-                type: 'RESPONSE',
+                type: 'MULTI_RESPONSE',
                 data: results,
-                ...meta
+                _meta_actions: needsChatModel ? ["REQUEST_CHAT_MODEL"] : []
             };
         } catch (error) {
             return {

package/templates/webpack.contentRender.config.js

@@ -22,7 +22,7 @@ module.exports = {
           loader: 'babel-loader',
           options: {
             presets: ['@babel/preset-env', '@babel/preset-react'],
-            cacheDirectory: true, // Enable caching for faster rebuilds
+            cacheDirectory: true,
           },
         },
       },
@@ -42,7 +42,13 @@ module.exports = {
     },
     compress: true,
     port: 38592,
-    hot: true, // Enable Hot Module Replacement
+    hot: true,
+    headers: {
+      'Access-Control-Allow-Origin': '*',
+      'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, PATCH, OPTIONS',
+      'Access-Control-Allow-Headers': 'X-Requested-With, content-type, Authorization',
+    },
+    allowedHosts: 'all',
   },
   plugins: [
     new webpack.HotModuleReplacementPlugin(), // Enable HMR globally

package/version.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.52",
-  "releaseDate": "2025-08-27",
-  "releaseNotes": "OpenKBS CLI version 0.0.52"
+  "version": "0.0.55",
+  "releaseDate": "2025-12-28",
+  "releaseNotes": "OpenKBS CLI version 0.0.55"
 }

package/MODIFY.md

@@ -1,132 +0,0 @@
-#### USER-DEFINED REQUIREMENTS 
-
-Define any additional features, integrations, or behavior modifications
-
-#### USER-DEFINED REQUIREMENTS END
-
-# OpenKBS Framework Technical Guide (For AI Coding Agents)
-
-OpenKBS is claud AI platform designed to build, deploy and integrate AI agents and applications.
-This guide provides a brief overview of developing backend and frontend logic for your OpenKBS app/agent.
-
-## Project Structure Overview
-
-A typical OpenKBS project has the following key directories:
-
-*   **`src/`**: Contains your custom source code.
-    *   **`Events/`**: Houses backend LLM event handlers.
-        *   `actions.js`: Example file commonly used for shared backend logic/tools definitions.
-        *   `onRequest.js`: Handles incoming user messages before LLM processing.
-        *   `onRequest.json`: NPM dependencies for `onRequest.js`.
-        *   `onResponse.js`: Handles LLM responses before sending to the user.
-        *   `onResponse.json`: NPM dependencies for `onResponse.js`.
-        *   `onPublicAPIRequest.js`: Handles unauthenticated public API calls.
-        *   `onPublicAPIRequest.json`: Dependencies for `onPublicAPIRequest.js`.
-        *   `onAddMessages.js`: Handles messages added via the `chatAddMessages` API.
-        *   `onAddMessages.json`: Dependencies for `onAddMessages.js`.
-    *   **`Frontend/`**: Contains frontend customization logic.
-        *   `contentRender.js`: Custom UI rendering for chat messages, headers, etc.
-        *   `contentRender.json`: NPM dependencies for `contentRender.js`.
-*   **`app/`**: Application-level configuration.
-    *   `settings.json`: Core application settings (model, vendor, etc.).
-    *   `instructions.txt`: Instructions for the LLM.
-    *   `icon.png`: Application icon.
-
-#### Backend Handlers
-- Files with names starting with "on" (like onRequest.js) are called handler
-- Each handler functions as NodeJS execution entry point executed by the platform upon certain events.
-- use ES6, user import, do not use require()
-
-#### onRequest and onResponse Handlers
-
-The core of the OpenKBS backend framework revolves around the `onRequest` and `onResponse` Node.js backend event handlers.
-These handlers act as middleware, intercepting user messages and messages generated by the LLM.
-
-- onRequest handler is invoked every time a user sends a message to the chat. It provides an opportunity to process the user's input, extract commands and perform actions based on the user's message.
-- onResponse handler is invoked after the LLM generates a response. It allows processing of the LLM's output, execution of commands based on the LLM's message.
-
-#### NPM Dependencies for Backend Handlers
-
-1. If a file imports an NPM dependency and is then imported by a handler, this dependency must be defined in the handler's corresponding json file
-2. Example: If actions.js imports got and onRequest.js imports actions.js, then got must be in onRequest.json
-
-
-## Backend Dependencies
-
-To use external NPM packages in your backend event handlers, you must declare them in the corresponding `.json` file.
-
-**Example: Using https module with an API key**
-
-1. **Declare dependencies** in both `src/Events/onRequest.json` and `src/Events/onResponse.json` (as each handler have separate Node.js build):
-    ```json
-    {
-      "dependencies": {
-        "got": "^11.8.5"
-      }
-    }
-    ```
-
-2.  **Implement in any JavaScript file** (actions.js is just an example name):
-
-```javascript
-import got from 'got';
-export const getActions = (meta) => {
-    return [
-        [/\/?getNews\("(.*)"\)/, async (match) => {
-            const { body } = await got(`https://newsapi.org/v2/everything?q=${match[1]}&apiKey={{secrets.news_api_key}}`, 
-                { responseType: 'json' });
-            
-            return { result: body.articles, ...meta };
-        }],
-        // ... other actions
-    ];
-};
-```
-
-## Secrets Management
-OpenKBS provides a secure way to handle sensitive information using the `{{secrets.your_secret_name}}` syntax.
-Never hardcode secrets in the code, if any secrets are provided by the user replace them with placeholders syntax above.
-The user will later insert the secrets using the secrets manager
-
-#### LLM Instructions
-`app/instructions.txt`
-This file contains the instructions for the agent
-
-**Example Instructions:**
-
-```
-You are an AI assistant.
-
-You can execute the following commands:
-
-/getNews("query")
-Description: """
-Get the latest news
-"""
-```
-
-#### Important Coding guidelines
-- Organize new features across multiple files (like Events/utils.js) rather than adding everything to actions.js
-- Similar for Frontend: keep newly implemented React components outside contentRender.js for maintainability.
-- Keep in mind onRenderChatMessage is not a React component but simple JS function
-
-
-#### onRenderChatMessage injected functions
-These functions are automatically injected by the framework to onRenderChatMessage, providing access to system features
-```
-// Where functions are injected
-const onRenderChatMessage = async (params) => {
-    const { APIResponseComponent, theme, setBlockingLoading, setSystemAlert, RequestChatAPI,
-    kbUserData, generateMsgId, messages, msgIndex } = params;
-    ...
-}
-```
-
-```
-// Shows toast notifications in top-right corner
-setSystemAlert({
-    msg: 'Payment successful',
-    type: 'success', //'error'|'success'|'info'
-    duration: 5000
-});
-```