openkbs 0.0.66 → 0.0.67

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openkbs",
-  "version": "0.0.66",
+  "version": "0.0.67",
   "description": "OpenKBS - Command Line Interface",
   "main": "src/index.js",
   "scripts": {

package/src/actions.js

@@ -2413,6 +2413,14 @@ async function elasticStatusAction() {
  */
 async function stackAction(subCommand, args = []) {
     switch (subCommand) {
+        case 'create':
+            const stackName = args[0];
+            if (!stackName) {
+                console.red('Error: Stack name is required');
+                console.log('Usage: openkbs stack create <name>');
+                process.exit(1);
+            }
+            return await stackCreateAction(stackName);
         case 'deploy':
             return await elasticDeployAction();
         case 'destroy':
@@ -2425,10 +2433,54 @@ async function stackAction(subCommand, args = []) {
             console.log('Commands:');
             console.log('  deploy     Deploy all resources from openkbs.json');
             console.log('  destroy    Delete all resources (DANGEROUS)');
+            console.log('  create     Create new platform stack');
             console.log('  status     Show status of all resources');
     }
 }
 
+/**
+ * Create a new platform stack from template
+ */
+async function stackCreateAction(name) {
+    try {
+        // Download templates from S3 first
+        await downloadTemplates();
+
+        const platformTemplateDir = path.join(TEMPLATE_DIR, 'platform');
+        const targetDir = path.join(process.cwd(), name);
+
+        if (!fs.existsSync(platformTemplateDir)) {
+            console.red('Error: Platform template not found. Run "openkbs update" first.');
+            process.exit(1);
+        }
+
+        if (fs.existsSync(targetDir)) {
+            console.red(`Error: Directory ${name} already exists.`);
+            process.exit(1);
+        }
+
+        // Copy platform template
+        fs.copySync(platformTemplateDir, targetDir);
+
+        // Replace placeholders in all files
+        replacePlaceholderInFiles(targetDir, name);
+
+        console.green(`\nPlatform stack "${name}" created successfully!\n`);
+        console.log('Structure:');
+        console.log(`  ${name}/`);
+        console.log('  ├── agents/           # AI agents (each with app/ and src/)');
+        console.log('  ├── functions/        # Serverless Lambda functions');
+        console.log('  ├── site/             # Static site for whitelabel');
+        console.log('  └── openkbs.json      # Elastic services config\n');
+        console.log('Next steps:');
+        console.log(`  cd ${name}`);
+        console.log('  openkbs deploy        # Deploy elastic services');
+        console.log('  openkbs fn push api   # Deploy the API function');
+    } catch (error) {
+        console.red(`Error during stack create:`, error.message);
+    }
+}
+
 module.exports = {
     signAction,
     loginAction,

package/src/index.js

@@ -143,16 +143,18 @@ Reads openkbs.json and deletes:
 `);
 
 program
-    .command('stack <subcommand>')
-    .description('Manage stack resources (deploy, destroy, status)')
-    .action((subCommand) => stackAction(subCommand))
+    .command('stack <subcommand> [args...]')
+    .description('Manage stack resources (create, deploy, destroy, status)')
+    .action((subCommand, args) => stackAction(subCommand, args))
     .addHelpText('after', `
 Commands:
-  deploy     Deploy all resources from openkbs.json
-  destroy    Delete all resources (DANGEROUS)
-  status     Show status of all resources
+  create <name>  Create new platform stack from template
+  deploy         Deploy all resources from openkbs.json
+  destroy        Delete all resources (DANGEROUS)
+  status         Show status of all resources
 
 Examples:
+  $ openkbs stack create my-platform
   $ openkbs stack deploy
   $ openkbs stack status
   $ openkbs stack destroy

package/templates/platform/README.md

@@ -0,0 +1,70 @@
+# {{APP_NAME}} Platform
+
+OpenKBS full-stack platform with AI agents, serverless functions, and static site.
+
+## 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
+```
+
+## Deploy
+
+```bash
+# Deploy elastic services (postgres, storage, pulse)
+openkbs deploy
+
+# Deploy the API function
+openkbs fn push api
+
+# Deploy static 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`

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

@@ -0,0 +1,25 @@
+You are an AI assistant for {{APP_NAME}}.
+
+## Available Commands
+
+<googleSearch>
+{"query": "search terms"}
+</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

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

@@ -0,0 +1,17 @@
+{
+  "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 }]
+  }
+}

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

@@ -0,0 +1,81 @@
+/**
+ * Command actions for {{APP_NAME}} Assistant
+ */
+
+export const getActions = (meta, event) => [
+    // Google Search
+    [/<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
+            }));
+
+            return {
+                type: 'SEARCH_RESULTS',
+                data: formatted,
+                ...meta,
+                _meta_actions: ["REQUEST_CHAT_MODEL"]
+            };
+        } catch (e) {
+            return { error: e.message, ...meta, _meta_actions: ["REQUEST_CHAT_MODEL"] };
+        }
+    }],
+
+    // Set Memory
+    [/<setMemory>([\s\S]*?)<\/setMemory>/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() }
+                });
+            }
+
+            return {
+                type: "MEMORY_SAVED",
+                itemId: data.itemId,
+                ...meta,
+                _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,
+                ...meta,
+                _meta_actions: ["REQUEST_CHAT_MODEL"]
+            };
+        } catch (e) {
+            return { error: e.message, ...meta, _meta_actions: ["REQUEST_CHAT_MODEL"] };
+        }
+    }]
+];

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

@@ -0,0 +1,41 @@
+import { getActions } from './actions.js';
+
+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"]
+            : []
+    };
+};

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

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

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

@@ -0,0 +1,26 @@
+import React from 'react';
+
+const onRenderChatMessage = async (params) => {
+    const { content, role } = 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(() => {
+        setRenderSettings({
+            disableBalanceView: true
+        });
+    }, [setRenderSettings]);
+
+    return null;
+};
+
+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,69 @@
+/**
+ * Example API function for {{APP_NAME}} platform
+ *
+ * Endpoint: https://fn.openkbs.com/YOUR_KB_ID/api
+ *
+ * This function has access to:
+ * - process.env.POSTGRES_URL (if postgres enabled)
+ * - process.env.KB_ID (your whitelabel kbId)
+ */
+
+export const handler = async (event) => {
+    const body = JSON.parse(event.body || '{}');
+    const { action, data } = body;
+
+    // CORS headers
+    const headers = {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type'
+    };
+
+    // Handle preflight
+    if (event.httpMethod === 'OPTIONS') {
+        return { statusCode: 200, headers, body: '' };
+    }
+
+    try {
+        switch (action) {
+            case 'hello':
+                return {
+                    statusCode: 200,
+                    headers,
+                    body: JSON.stringify({
+                        message: 'Hello from {{APP_NAME}} API!',
+                        timestamp: new Date().toISOString(),
+                        input: data
+                    })
+                };
+
+            case 'health':
+                return {
+                    statusCode: 200,
+                    headers,
+                    body: JSON.stringify({
+                        status: 'healthy',
+                        kbId: process.env.KB_ID,
+                        hasPostgres: !!process.env.POSTGRES_URL
+                    })
+                };
+
+            default:
+                return {
+                    statusCode: 400,
+                    headers,
+                    body: JSON.stringify({
+                        error: 'Unknown action',
+                        availableActions: ['hello', 'health']
+                    })
+                };
+        }
+    } catch (error) {
+        return {
+            statusCode: 500,
+            headers,
+            body: JSON.stringify({ error: error.message })
+        };
+    }
+};

package/templates/platform/openkbs.json

@@ -0,0 +1,14 @@
+{
+  "elastic": {
+    "postgres": true,
+    "storage": true,
+    "pulse": true,
+    "functions": {
+      "api": {
+        "runtime": "nodejs22.x",
+        "memory": 512,
+        "timeout": 30
+      }
+    }
+  }
+}

package/templates/platform/site/index.html

@@ -0,0 +1,76 @@
+<!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;
+            font-weight: 600;
+            transition: transform 0.2s, box-shadow 0.2s;
+        }
+        .btn:hover {
+            transform: translateY(-2px);
+            box-shadow: 0 10px 30px rgba(102, 126, 234, 0.4);
+        }
+        .links { margin-top: 2rem; }
+        .links a { color: #667eea; margin: 0 10px; }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <h1>{{APP_NAME}}</h1>
+        <p>Your OpenKBS platform is ready. Deploy agents, functions, and build your AI-powered application.</p>
+        <a href="#" class="btn" onclick="testAPI()">Test API</a>
+        <div class="links">
+            <a href="https://openkbs.com/docs">Documentation</a>
+            <a href="https://github.com/open-kbs/openkbs">GitHub</a>
+        </div>
+        <pre id="result" style="margin-top: 2rem; text-align: left; background: #f5f5f5; padding: 1rem; border-radius: 8px; display: none;"></pre>
+    </div>
+    <script>
+        async function testAPI() {
+            const result = document.getElementById('result');
+            result.style.display = 'block';
+            result.textContent = 'Loading...';
+            try {
+                // Replace YOUR_KB_ID with actual kbId after deployment
+                const response = await fetch('/api', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ action: 'hello', data: { test: true } })
+                });
+                const data = await response.json();
+                result.textContent = JSON.stringify(data, null, 2);
+            } catch (e) {
+                result.textContent = 'Error: ' + e.message + '\n\nMake sure to deploy the API function first:\nopenkbs fn push api';
+            }
+        }
+    </script>
+</body>
+</html>

package/version.json

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