openkbs 0.0.66 → 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

@@ -0,0 +1,35 @@
+# {{APP_NAME}}
+
+OpenKBS full-stack platform with Postgres, Storage+CloudFront, and Pulse.
+
+## Structure
+
+```
+{{APP_NAME}}/
+├── openkbs.json        # Elastic services config
+├── agents/             # AI agents (optional)
+├── functions/
+│   └── api/            # Serverless function
+└── site/
+    └── index.html      # Static site
+```
+
+## Deploy
+
+```bash
+# Deploy elastic services
+openkbs deploy
+
+# Deploy function
+openkbs fn push api
+
+# Deploy site
+openkbs site push
+```
+
+## Elastic Services
+
+- **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

@@ -0,0 +1,13 @@
+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/platform/agents/assistant/app/settings.json

@@ -0,0 +1,13 @@
+{
+  "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

@@ -0,0 +1,50 @@
+export const getActions = (meta, event) => [
+    // 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 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: results, ...meta };
+        } catch (e) {
+            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/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

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

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

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

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

@@ -0,0 +1,27 @@
+import React, {useEffect} from 'react';
+
+const onRenderChatMessage = async (params) => {
+    const { content } = params.messages[params.msgIndex];
+}
+
+const Header = ({ setRenderSettings}) => {
+    useEffect(() => {
+        setRenderSettings({
+            disableShareButton: true,
+            disableBalanceView: true,
+            disableSentLabel: false,
+            disableChatAvatar: false,
+            disableChatModelsSelect: false,
+            disableContextItems: false,
+            disableCopyButton: false,
+            disableEmojiButton: false,
+            disableTextToSpeechButton: false,
+            disableMobileLeftButton: false,
+        });
+    }, [setRenderSettings]);
+
+}
+
+const exports = { onRenderChatMessage, Header };
+window.contentRender = exports;
+export default exports;

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

@@ -0,0 +1,10 @@
+{
+  "dependencies": {
+    "react": "^18.2.0 (fixed)",
+    "react-dom": "^18.2.0 (fixed)",
+    "@mui/material": "^5.16.1 (fixed)",
+    "@mui/icons-material": "^5.16.1 (fixed)",
+    "@emotion/react": "^11.10.6 (fixed)",
+    "@emotion/styled": "^11.10.6 (fixed)"
+  }
+}

package/templates/platform/functions/api/index.mjs

@@ -0,0 +1,63 @@
+/**
+ * {{APP_NAME}} API
+ *
+ * Endpoint: https://yourdomain.com/api
+ *
+ * Environment variables:
+ * - DATABASE_URL (Postgres connection string)
+ * - STORAGE_BUCKET (S3 bucket name)
+ * - OPENKBS_KB_ID (your kbId)
+ */
+
+export const handler = async (event) => {
+    const headers = {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Headers': 'Content-Type'
+    };
+
+    if (event.requestContext?.http?.method === 'OPTIONS') {
+        return { statusCode: 200, headers, body: '' };
+    }
+
+    try {
+        const body = JSON.parse(event.body || '{}');
+        const { action } = body;
+
+        switch (action) {
+            case 'hello':
+                return {
+                    statusCode: 200,
+                    headers,
+                    body: JSON.stringify({
+                        message: 'Hello from {{APP_NAME}}!',
+                        timestamp: new Date().toISOString()
+                    })
+                };
+
+            case 'status':
+                return {
+                    statusCode: 200,
+                    headers,
+                    body: JSON.stringify({
+                        postgres: !!process.env.DATABASE_URL,
+                        storage: !!process.env.STORAGE_BUCKET,
+                        kbId: process.env.OPENKBS_KB_ID
+                    })
+                };
+
+            default:
+                return {
+                    statusCode: 400,
+                    headers,
+                    body: JSON.stringify({ error: 'Unknown action', available: ['hello', 'status'] })
+                };
+        }
+    } catch (error) {
+        return {
+            statusCode: 500,
+            headers,
+            body: JSON.stringify({ error: error.message })
+        };
+    }
+};

package/templates/platform/functions/api/package.json

@@ -0,0 +1,4 @@
+{
+  "type": "module",
+  "dependencies": {}
+}

package/templates/platform/openkbs.json

@@ -0,0 +1,19 @@
+{
+  "name": "{{APP_NAME}}",
+  "region": "us-east-1",
+
+  "elastic": {
+    "postgres": true,
+    "storage": {
+      "cloudfront": "media"
+    },
+    "pulse": true,
+    "functions": {
+      "api": {
+        "runtime": "nodejs24.x",
+        "memory": 512,
+        "timeout": 30
+      }
+    }
+  }
+}

package/templates/platform/site/index.html

@@ -0,0 +1,75 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>{{APP_NAME}}</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            min-height: 100vh;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+        }
+        .container {
+            background: white;
+            padding: 3rem;
+            border-radius: 16px;
+            box-shadow: 0 20px 60px rgba(0,0,0,0.3);
+            text-align: center;
+            max-width: 500px;
+        }
+        h1 { color: #333; margin-bottom: 1rem; }
+        p { color: #666; margin-bottom: 2rem; line-height: 1.6; }
+        .btn {
+            display: inline-block;
+            padding: 12px 24px;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            text-decoration: none;
+            border-radius: 8px;
+            border: none;
+            font-weight: 600;
+            cursor: pointer;
+        }
+        .btn:hover { opacity: 0.9; }
+        pre {
+            margin-top: 2rem;
+            text-align: left;
+            background: #f5f5f5;
+            padding: 1rem;
+            border-radius: 8px;
+            display: none;
+            overflow: auto;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>{{APP_NAME}}</h1>
+        <p>Your OpenKBS platform is ready.</p>
+        <button class="btn" onclick="testAPI()">Test API</button>
+        <pre id="result"></pre>
+    </div>
+    <script>
+        async function testAPI() {
+            const result = document.getElementById('result');
+            result.style.display = 'block';
+            result.textContent = 'Loading...';
+            try {
+                const res = await fetch('/api', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ action: 'hello' })
+                });
+                result.textContent = JSON.stringify(await res.json(), null, 2);
+            } catch (e) {
+                result.textContent = 'Error: ' + e.message;
+            }
+        }
+    </script>
+</body>
+</html>

package/version.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.66",
-  "releaseDate": "2026-01-04",
-  "releaseNotes": "OpenKBS CLI version 0.0.66"
+  "version": "0.0.70",
+  "releaseDate": "2026-01-07",
+  "releaseNotes": "OpenKBS CLI version 0.0.70"
 }

package/templates/.claude/skills/openkbs/examples/ai-copywriter-agent/scripts/run_job.js

@@ -1,26 +0,0 @@
-// This boilerplate code is a starting point for development.
-
-const OpenKBSAgentClient = require('./utils/agent_client');
-
-async function main() {
-    const client = new OpenKBSAgentClient();
-    
-    const message = `Today's Date: ${new Date().toLocaleDateString()}
-
-PROCESS_PRODUCT:
-    Product Name: iPhone 14 Pro Max
-    Product Code: MQ9X3RX/A
-    ID: 97649
-    
-    find at least 2 images and 2 videos
-`;
-
-    try {
-        const result = await client.runJob(message);
-        console.log('Job completed:', result);
-    } catch (error) {
-        console.error('Job failed:', error.message);
-    }
-}
-
-main();