openkbs 0.0.67 → 0.0.70

package/templates/.claude/skills/openkbs/reference/elastic-services.md

@@ -18,7 +18,7 @@ OpenKBS provides managed cloud infrastructure that scales automatically.
   "elastic": {
     "functions": {
       "hello": {
-        "runtime": "nodejs22.x",
+        "runtime": "nodejs24.x",
         "memory": 512,
         "timeout": 30
       }
@@ -76,17 +76,25 @@ openkbs fn invoke hello '{"test": true}'  # Invoke function
 
 ### Supported Runtimes
 
-- `nodejs22.x`, `nodejs20.x`, `nodejs18.x`
-- `python3.12`, `python3.11`
-- `java21`, `java17`
+- `nodejs24.x`, `nodejs22.x`, `nodejs20.x`
+- `python3.14`, `python3.13`
+- `java25`, `java21`
 
-### Access from Agent
+### Access URLs
+
+Functions are accessible via CloudFront on your whitelabel domain:
+
+```
+https://yourdomain.com/functionName
+```
+
+From frontend (site/), use relative paths:
 
 ```javascript
-// In actions.js
-const response = await fetch('https://fn.openkbs.com/YOUR_KB_ID/hello', {
+const response = await fetch('/api', {
     method: 'POST',
-    body: JSON.stringify({ data: 'value' })
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ action: 'hello' })
 });
 ```
 
@@ -106,7 +114,7 @@ openkbs postgres status             # Show database info
 
 ### Access from Agent
 
-Connection string is available as `POSTGRES_URL` environment variable:
+Connection string is available as `DATABASE_URL` environment variable:
 
 ```javascript
 // In onRequest.js or actions.js
@@ -114,7 +122,7 @@ import pg from 'pg';
 const { Pool } = pg;
 
 const pool = new Pool({
-    connectionString: process.env.POSTGRES_URL,
+    connectionString: process.env.DATABASE_URL,
     ssl: { rejectUnauthorized: false }
 });
 
@@ -162,18 +170,20 @@ console.log(uploaded.url);  // Public URL
 
 // Get presigned URL for upload
 const presigned = await openkbs.kb({
-    action: 'getPresignedUploadUrl',
-    filename: 'document.pdf',
-    contentType: 'application/pdf'
+    action: 'createPresignedURL',
+    namespace: 'files',
+    fileName: 'document.pdf',
+    fileType: 'application/pdf',
+    presignedOperation: 'putObject'
 });
-// Returns: { uploadUrl, publicUrl }
+// Returns presigned URL string - upload with axios.put()
 ```
 
 ---
 
 ## Pulse (WebSocket)
 
-Real-time messaging and pub/sub.
+Real-time messaging and pub/sub via SDK.
 
 ### CLI Commands
 
@@ -182,21 +192,43 @@ openkbs pulse status   # Show Pulse status
 openkbs pulse channels # List channels
 ```
 
-### Access from Agent
+### Backend (Lambda functions)
 
 ```javascript
-// Publish message
-await openkbs.pulse.publish('channel-name', {
-    type: 'notification',
-    data: { message: 'Hello subscribers!' }
+import pulse from 'openkbs-pulse/server';
+
+// Get token for frontend
+const tokenData = await pulse.getToken(kbId, apiKey, userId);
+// Returns: { token, endpoint }
+
+// Publish to channel
+await pulse.publish('posts', 'new_post', { post }, { kbId, apiKey });
+
+// Get presence
+const presence = await pulse.presence('posts', { kbId, apiKey });
+```
+
+### Frontend (Browser)
+
+```html
+<script src="https://unpkg.com/openkbs-pulse/pulse.js"></script>
+```
+
+```javascript
+// Connect (token from backend)
+const realtime = new Pulse.Realtime({ kbId, token, endpoint, clientId });
+
+// Subscribe to channel
+const channel = realtime.channels.get('posts');
+channel.subscribe('new_post', (message) => {
+    console.log('New post:', message.data);
 });
 
-// Subscribe (frontend)
-const ws = new WebSocket(`wss://pulse.openkbs.com/${kbId}/channel-name`);
-ws.onmessage = (event) => {
-    const data = JSON.parse(event.data);
-    console.log('Received:', data);
-};
+// Presence
+channel.presence.enter({ name: 'Alice' });
+channel.presence.subscribe((members) => {
+    console.log('Online:', members.length);
+});
 ```
 
 ### Use Cases
@@ -218,7 +250,7 @@ Complete Node.js application with all services:
 {
   "elastic": {
     "functions": {
-      "api": { "runtime": "nodejs22.x", "memory": 512 }
+      "api": { "runtime": "nodejs24.x", "memory": 512 }
     },
     "postgres": true,
     "storage": true,
@@ -234,7 +266,7 @@ import pg from 'pg';
 const { Pool } = pg;
 
 const pool = new Pool({
-    connectionString: process.env.POSTGRES_URL,
+    connectionString: process.env.DATABASE_URL,
     ssl: { rejectUnauthorized: false }
 });
 
@@ -304,7 +336,7 @@ import psycopg2
 import os
 
 def handler(event, context):
-    conn = psycopg2.connect(os.environ['POSTGRES_URL'])
+    conn = psycopg2.connect(os.environ['DATABASE_URL'])
     cur = conn.cursor()
     cur.execute("SELECT * FROM items")
     rows = cur.fetchall()

package/templates/platform/README.md

@@ -1,70 +1,35 @@
-# {{APP_NAME}} Platform
+# {{APP_NAME}}
 
-OpenKBS full-stack platform with AI agents, serverless functions, and static site.
+OpenKBS full-stack platform with Postgres, Storage+CloudFront, and Pulse.
 
 ## Structure
 
 ```
 {{APP_NAME}}/
-├── agents/                 # AI agents
-│   └── assistant/          # Sample assistant agent
-│       ├── app/
-│       │   ├── settings.json
-│       │   └── instructions.txt
-│       └── src/
-│           ├── Events/
-│           └── Frontend/
-├── functions/              # Serverless Lambda functions
-│   └── api/
-│       └── index.mjs       # Sample API endpoint
-├── site/                   # Static site for whitelabel
-│   └── index.html
-├── openkbs.json            # Elastic services configuration
-└── README.md
+├── openkbs.json        # Elastic services config
+├── agents/             # AI agents (optional)
+├── functions/
+│   └── api/            # Serverless function
+└── site/
+    └── index.html      # Static site
 ```
 
 ## Deploy
 
 ```bash
-# Deploy elastic services (postgres, storage, pulse)
+# Deploy elastic services
 openkbs deploy
 
-# Deploy the API function
+# Deploy function
 openkbs fn push api
 
-# Deploy static site
+# Deploy site
 openkbs site push
-
-# Deploy an agent
-cd agents/assistant
-openkbs push
 ```
 
 ## Elastic Services
 
-Enabled in `openkbs.json`:
-
-- **Postgres**: `openkbs postgres shell` to connect
-- **Storage**: `openkbs storage ls` to list files
-- **Pulse**: `openkbs pulse status` for WebSocket info
-- **Functions**: `openkbs fn list` to see deployed functions
-
-## Development
-
-```bash
-# Check stack status
-openkbs stack status
-
-# View function logs
-openkbs fn logs api
-
-# Invoke function locally
-openkbs fn invoke api '{"action": "hello"}'
-```
-
-## URLs
-
-After deployment:
-- Site: `https://YOUR_DOMAIN/`
-- API: `https://fn.openkbs.com/YOUR_KB_ID/api`
-- Agent: `https://YOUR_KB_ID.apps.openkbs.com`
+- **Postgres**: `openkbs postgres shell`
+- **Storage**: `openkbs storage ls` (CDN at /media/*)
+- **Pulse**: `openkbs pulse status`
+- **Functions**: `openkbs fn list`

package/templates/platform/agents/assistant/app/instructions.txt

@@ -1,25 +1,13 @@
-You are an AI assistant for {{APP_NAME}}.
+You are an AI assistant, assist users with their inquiries and tasks efficiently.
 
-## Available Commands
+LIST OF AVAILABLE COMMANDS:
+To execute a command, output it as text message and wait for system response.
 
 <googleSearch>
-{"query": "search terms"}
+{
+  "query": "search query"
+}
 </googleSearch>
-Search the web for information.
-
-<setMemory>
-{"itemId": "memory_key", "value": "data to remember"}
-</setMemory>
-Save data to memory. The itemId must start with "memory_".
-
-<deleteItem>
-{"itemId": "memory_key"}
-</deleteItem>
-Delete a memory item.
-
-## Guidelines
-
-1. Be helpful and concise
-2. Use commands when needed to assist the user
-3. Remember important information using setMemory
-4. Search the web when you need current information
+Description: """
+Get results from Google Search API.
+"""

package/templates/platform/agents/assistant/app/settings.json

@@ -1,17 +1,13 @@
 {
-  "kbTitle": "{{APP_NAME}} Assistant",
-  "kbDescription": "AI assistant for {{APP_NAME}} platform",
-  "model": "anthropic/claude-sonnet-4-20250514",
-  "maxTokens": 16000,
-  "itemTypes": {
-    "memory": {
-      "attributes": [
-        { "attrName": "itemId", "attrType": "itemId", "encrypted": false },
-        { "attrName": "body", "attrType": "body", "encrypted": true }
-      ]
-    }
-  },
-  "options": {
-    "priorityItems": [{ "prefix": "memory_", "limit": 50 }]
-  }
+  "chatVendor": "google",
+  "kbDescription": "{{{openkbsAppName}}}",
+  "kbTitle": "{{{openkbsAppName}}}",
+  "model": "gemini-3-pro",
+  "inputTools": [
+    "speechToText"
+  ],
+  "embeddingModel": "text-embedding-3-large",
+  "embeddingDimension": 3072,
+  "searchEngine": "VectorDB",
+  "itemTypes": {}
 }

package/templates/platform/agents/assistant/src/Events/actions.js

@@ -1,81 +1,50 @@
-/**
- * Command actions for {{APP_NAME}} Assistant
- */
-
 export const getActions = (meta, event) => [
-    // Google Search
+    // Google Search with JSON
+    // Usage: <googleSearch>{"query": "search terms"}</googleSearch>
     [/<googleSearch>([\s\S]*?)<\/googleSearch>/s, async (match) => {
         try {
             const data = JSON.parse(match[1].trim());
-            const results = await openkbs.googleSearch(data.query);
-
-            const formatted = results?.slice(0, 5).map(({ title, link, snippet }) => ({
-                title, link, snippet
+            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 {
-                type: 'SEARCH_RESULTS',
-                data: formatted,
-                ...meta,
-                _meta_actions: ["REQUEST_CHAT_MODEL"]
-            };
+            return { data: results, ...meta };
         } catch (e) {
-            return { error: e.message, ...meta, _meta_actions: ["REQUEST_CHAT_MODEL"] };
+            return { error: e.message, ...meta };
         }
     }],
 
-    // Set Memory
-    [/<setMemory>([\s\S]*?)<\/setMemory>/s, async (match) => {
+    // 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 data = JSON.parse(match[1].trim());
-
-            if (!data.itemId?.startsWith('memory_')) {
-                return {
-                    type: "MEMORY_ERROR",
-                    error: "itemId must start with 'memory_'",
-                    _meta_actions: ["REQUEST_CHAT_MODEL"]
-                };
-            }
-
-            try {
-                await openkbs.updateItem({
-                    itemType: 'memory',
-                    itemId: data.itemId,
-                    body: { value: data.value, updatedAt: new Date().toISOString() }
-                });
-            } catch (e) {
-                await openkbs.createItem({
-                    itemType: 'memory',
-                    itemId: data.itemId,
-                    body: { value: data.value, updatedAt: new Date().toISOString() }
-                });
-            }
+            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: "MEMORY_SAVED",
-                itemId: data.itemId,
+                type: 'MCP_RESULT',
+                server,
+                tool: toolName,
+                data: result?.content || [],
                 ...meta,
-                _meta_actions: ["REQUEST_CHAT_MODEL"]
+                _meta_actions: ['REQUEST_CHAT_MODEL']
             };
         } catch (e) {
-            return { error: e.message, ...meta, _meta_actions: ["REQUEST_CHAT_MODEL"] };
-        }
-    }],
-
-    // Delete Item
-    [/<deleteItem>([\s\S]*?)<\/deleteItem>/s, async (match) => {
-        try {
-            const data = JSON.parse(match[1].trim());
-            await openkbs.deleteItem(data.itemId);
-
             return {
-                type: "ITEM_DELETED",
-                itemId: data.itemId,
+                type: 'MCP_ERROR',
+                error: e.message,
                 ...meta,
-                _meta_actions: ["REQUEST_CHAT_MODEL"]
+                _meta_actions: ['REQUEST_CHAT_MODEL']
             };
-        } catch (e) {
-            return { error: e.message, ...meta, _meta_actions: ["REQUEST_CHAT_MODEL"] };
         }
-    }]
-];
+    }],
+
+    // add more actions here
+];

package/templates/platform/agents/assistant/src/Events/handler.js

@@ -0,0 +1,54 @@
+import { getActions } from './actions.js';
+
+export const backendHandler = async (event) => {
+    const meta = { _meta_actions: ["REQUEST_CHAT_MODEL"] };
+    const lastMessage = event.payload.messages[event.payload.messages.length - 1];
+    const actions = getActions(meta, event);
+
+    const matchingActions = [];
+    actions.forEach(([regex, action]) => {
+        const matches = [...(lastMessage.content || '').matchAll(new RegExp(regex, 'g'))];
+        matches.forEach(match => {
+            matchingActions.push(action(match, event));
+        });
+    });
+
+    if (matchingActions.length > 0) {
+        try {
+            const results = await Promise.all(matchingActions);
+
+            // 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_actions: needsChatModel ? ["REQUEST_CHAT_MODEL"] : []
+                };
+            }
+
+            // Single result - return as is
+            if (results.length === 1) {
+                return results[0];
+            }
+
+            // Multiple results
+            return {
+                type: 'MULTI_RESPONSE',
+                data: results,
+                _meta_actions: needsChatModel ? ["REQUEST_CHAT_MODEL"] : []
+            };
+        } catch (error) {
+            return {
+                type: 'ERROR',
+                error: error.message,
+                ...meta
+            };
+        }
+    }
+
+    return { type: 'CONTINUE' };
+};

package/templates/platform/agents/assistant/src/Events/onRequest.js

@@ -0,0 +1,3 @@
+import {backendHandler} from './handler';
+
+export const handler = async (event) => backendHandler(event)

package/templates/platform/agents/assistant/src/Events/onRequest.json

@@ -0,0 +1,5 @@
+{
+    "dependencies": {
+
+    }
+}

package/templates/platform/agents/assistant/src/Events/onResponse.js

@@ -1,41 +1,3 @@
-import { getActions } from './actions.js';
+import {backendHandler} from './handler';
 
-export const handler = async (event) => {
-    const response = event?.payload?.response?.content ?? event?.payload?.response;
-    if (!response) return { type: 'EMPTY_RESPONSE' };
-
-    const meta = {
-        role: 'tool',
-        name: 'command_executor',
-        msgId: `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`
-    };
-
-    const actions = getActions(meta, event);
-    const results = [];
-
-    for (const [pattern, handler] of actions) {
-        const matches = response.matchAll(new RegExp(pattern.source, pattern.flags + 'g'));
-        for (const match of matches) {
-            results.push(handler(match));
-        }
-    }
-
-    if (results.length === 0) {
-        return { type: 'NO_COMMANDS', _meta_actions: [] };
-    }
-
-    const resolved = await Promise.all(results);
-
-    if (resolved.length === 1) {
-        return resolved[0];
-    }
-
-    return {
-        type: 'MULTI_COMMAND_RESULT',
-        results: resolved,
-        ...meta,
-        _meta_actions: resolved.some(r => r._meta_actions?.includes("REQUEST_CHAT_MODEL"))
-            ? ["REQUEST_CHAT_MODEL"]
-            : []
-    };
-};
+export const handler = async (event) => backendHandler(event)

package/templates/platform/agents/assistant/src/Events/onResponse.json

@@ -1,3 +1,5 @@
 {
-  "dependencies": {}
-}
+    "dependencies": {
+
+    }
+}

package/templates/platform/agents/assistant/src/Frontend/contentRender.js

@@ -1,26 +1,27 @@
-import React from 'react';
+import React, {useEffect} from 'react';
 
 const onRenderChatMessage = async (params) => {
-    const { content, role } = params.messages[params.msgIndex];
+    const { content } = params.messages[params.msgIndex];
+}
 
-    // Hide tool messages
-    if (role === 'tool') {
-        return JSON.stringify({ type: 'HIDDEN_MESSAGE' });
-    }
-
-    return null; // Default rendering
-};
-
-const Header = ({ setRenderSettings }) => {
-    React.useEffect(() => {
+const Header = ({ setRenderSettings}) => {
+    useEffect(() => {
         setRenderSettings({
-            disableBalanceView: true
+            disableShareButton: true,
+            disableBalanceView: true,
+            disableSentLabel: false,
+            disableChatAvatar: false,
+            disableChatModelsSelect: false,
+            disableContextItems: false,
+            disableCopyButton: false,
+            disableEmojiButton: false,
+            disableTextToSpeechButton: false,
+            disableMobileLeftButton: false,
         });
     }, [setRenderSettings]);
 
-    return null;
-};
+}
 
 const exports = { onRenderChatMessage, Header };
 window.contentRender = exports;
-export default exports;
+export default exports;

package/templates/platform/agents/assistant/src/Frontend/contentRender.json

@@ -7,4 +7,4 @@
     "@emotion/react": "^11.10.6 (fixed)",
     "@emotion/styled": "^11.10.6 (fixed)"
   }
-}
+}