agent-orcha 0.0.7 → 0.0.8

package/dist/templates/llm.json

@@ -1,21 +1,84 @@
 {
+  "version": "1.0",
   "models": {
-    "default": {
+    "default": "llama-cpp",
+    "mlx-serve": {
+      "provider": "local",
+      "engine": "mlx-serve",
+      "model": "Qwen3.5-4B-4bit",
+      "contextSize": 32768,
+      "reasoningBudget": 0
+    },
+    "llama-cpp": {
+      "provider": "local",
+      "engine": "llama-cpp",
+      "model": "Qwen3.5-4B-IQ4_NL",
+      "contextSize": 32768,
+      "reasoningBudget": 0
+    },
+    "lmstudio": {
+      "provider": "local",
+      "engine": "lmstudio",
+      "baseUrl": "http://localhost:1234/v1",
+      "model": "qwen3.5-9b",
+      "reasoningBudget": 0
+    },
+    "ollama": {
+      "provider": "local",
+      "engine": "ollama",
+      "baseUrl": "http://localhost:11434/v1",
+      "model": "qwen3.5:latest",
+      "reasoningBudget": 0
+    },
+    "openai": {
       "provider": "openai",
-      "baseUrl": "http://host.docker.internal:1234/v1",
       "apiKey": "${OPENAI_API_KEY}",
-      "model": "default",
-      "temperature": 0.6,
-      "maxTokens": 4096
+      "model": "gpt-5.4"
+    },
+    "anthropic": {
+      "provider": "anthropic",
+      "apiKey": "${ANTHROPIC_API_KEY}",
+      "model": "claude-sonnet-4-6"
+    },
+    "gemini": {
+      "provider": "gemini",
+      "apiKey": "${GOOGLE_API_KEY}",
+      "model": "gemini-3.1-pro-preview"
     }
   },
   "embeddings": {
-    "default": {
+    "default": "llama-cpp",
+    "llama-cpp": {
+      "provider": "local",
+      "engine": "llama-cpp",
+      "model": "nomic-embed-text-v1.5.Q4_K_M"
+    },
+    "mlx-serve": {
+      "provider": "local",
+      "engine": "mlx-serve",
+      "model": "all-MiniLM-L6-v2-4bit"
+    },
+    "lmstudio": {
+      "provider": "local",
+      "engine": "lmstudio",
+      "baseUrl": "http://192.168.2.61:1234/v1",
+      "model": "nomic-ai/text-embedding-nomic-embed-text-v1.5"
+    },
+    "ollama": {
+      "provider": "local",
+      "engine": "ollama",
+      "baseUrl": "http://localhost:11434/v1",
+      "model": "nomic-embed-text:v1.5"
+    },
+    "openai": {
       "provider": "openai",
-      "baseUrl": "http://host.docker.internal:1234/v1",
       "apiKey": "${OPENAI_API_KEY}",
-      "model": "text-embedding-nomic-embed-text-v1.5",
-      "eosToken": " "
+      "model": "text-embedding-3-small"
+    },
+    "gemini": {
+      "provider": "gemini",
+      "apiKey": "${GOOGLE_API_KEY}",
+      "model": "gemini-embedding-001"
     }
   }
-}
+}

package/dist/templates/skills/orcha-builder/SKILL.md

@@ -19,9 +19,17 @@ prompt:
   inputVariables:
     - query
 tools:                                # mcp:<server> | knowledge:<store> | function:<name>
-  - mcp:server-name                   # builtin:<name> | sandbox:<tool> | project:<tool>
-  - knowledge:store-name              # sandbox: exec, shell, web_fetch, web_search, browser_*
-  - sandbox:browser_navigate          # project: read, write, delete, list, list_resources
+  - mcp:server-name                   # builtin:<name> | sandbox:<tool> | workspace:<tool>
+  - knowledge:store-name              # workspace: read, write, delete, list, list_resources, diagnostics
+  - sandbox:browser_navigate          # sandbox: exec, shell, web_fetch, web_search
+                                      # sandbox: browser_navigate, browser_observe, browser_screenshot,
+                                      #   browser_content, browser_click, browser_type, browser_evaluate
+                                      # sandbox: vision_screenshot, vision_navigate, vision_click,
+                                      #   vision_type, vision_scroll, vision_key, vision_drag
+                                      #   (requires EXPERIMENTAL_VISION=true)
+                                      # sandbox: file_read, file_write, file_edit, file_insert, file_replace_lines
+                                      # builtin: ask_user, save_memory
+                                      #   (conditional: integration_post, integration_context, email_send)
 skills:
   - skill-name                        # or use mode: all to attach all skills
 output:
@@ -103,6 +111,9 @@ config:
   onError: stop                       # stop | continue | retry
 output:
   result: "{{step_two_result}}"
+chatOutputFormat: text                  # text | json
+sampleQuestions:
+  - "Run the pipeline"
 ```
 
 ## ReAct Workflows (`workflows/<name>.workflow.yaml`)
@@ -140,6 +151,9 @@ graph:
   timeout: 300000
 output:
   result: "{{result}}"
+chatOutputFormat: text                  # text | json
+sampleQuestions:
+  - "What can you do?"
 ```
 
 ## Knowledge Stores (`knowledge/<name>.knowledge.yaml`)
@@ -197,6 +211,8 @@ export default async function({ input }) {
 }
 ```
 
+Function parameters support automatic type coercion — if an LLM passes a number as a string, it is auto-coerced to the declared type.
+
 ## Skills (`skills/<name>/SKILL.md`)
 
 Markdown files with YAML frontmatter (`name`, `description`). Content is injected into the agent's system prompt. Add `sandbox: true` if the skill requires sandbox tools.
@@ -209,6 +225,43 @@ Markdown files with YAML frontmatter (`name`, `description`). Content is injecte
 
 Remote: `url`. Local: `command` + `args`. Optional: `headers`, `env`, `timeout`, `transport`, `description`. Transport is auto-detected. To add a server: read `mcp.json`, add entry, write back, then reference as `mcp:<name>` in agent tools.
 
+## LLM Configuration (`llm.json`)
+
+```json
+{
+  "default": "llama-cpp",
+  "llama-cpp": {
+    "engine": "llama-cpp",
+    "model": "qwen3-8b",
+    "temperature": 0.7,
+    "reasoningBudget": 4096,
+    "thinkingBudget": 4096
+  },
+  "ollama-model": {
+    "engine": "ollama",
+    "model": "llama3",
+    "temperature": 0.5
+  },
+  "embeddings": {
+    "engine": "llama-cpp",
+    "model": "nomic-embed",
+    "type": "embedding"
+  },
+  "engineUrls": {
+    "llama-cpp": "http://localhost:8080",
+    "mlx-serve": "http://localhost:8081",
+    "ollama": "http://localhost:11434",
+    "lmstudio": "http://localhost:1234"
+  }
+}
+```
+
+The `"default"` key is a string pointer to another config name. Engines: `llama-cpp`, `mlx-serve`, `ollama`, `lmstudio`. Use `reasoningBudget`/`thinkingBudget` for thinking models. Values support `${ENV_VAR}` substitution.
+
+## Environment Variable Substitution
+
+All YAML and JSON config files support `${ENV_VAR}` and `${ENV_VAR:-default}` syntax. Use this for secrets, URLs, and any values that differ between environments.
+
 ## Best Practices
 
 - Use kebab-case for all resource names

package/dist/templates/workflows/example.workflow.yaml

@@ -1,7 +1,8 @@
 name: research-pipeline
-description: Multi-step research pipeline that searches knowledge bases and produces a friendly summary
+description: Research pipeline that searches knowledge bases and publishes findings as a live HTML page
 version: "1.0.0"
 type: steps
+chatOutputFormat: text
 
 input:
   schema:
@@ -12,52 +13,43 @@ input:
 
 steps:
 
-  # Step 1: Search web knowledge for background information
-  - id: web-research
-    agent: knowledge-broker
+  # Step 1: Search corporate knowledge for relevant info
+  - id: research
+    agent: corporate
     input:
       query: "Find information about {{input.topic}}"
     output:
-      key: web_findings
+      key: findings
 
-  # Step 2: Search org chart to find relevant people in the company
-  - id: find-experts
-    agent: knowledge-broker
-    input:
-      query: "Who in the company has expertise related to {{input.topic}}?"
-    output:
-      key: expert_findings
-
-  # Step 3: Summarize everything into a friendly report
-  - id: summarize
-    agent: chatbot
+  # Step 2: Build a minimal HTML report and publish it
+  - id: publish
+    agent: web-engineer
     input:
       query: |
-        Write a brief research summary on: {{input.topic}}
+        Create a minimalistic, clean HTML page that presents the following research findings about "{{input.topic}}".
 
-        Background Research:
-        {{steps.web-research.output}}
+        Research findings:
+        {{steps.research.output}}
 
-        Internal Experts:
-        {{steps.find-experts.output}}
+        Requirements:
+        - Single-page, clean design with Tailwind CSS
+        - Minimal and elegant — white background, good typography, subtle accents
+        - Structure the content with clear headings and sections
+        - Add a small footer: "Generated by Agent Orcha"
+        - Deploy via htmlhost and share the live URL
 
-        Combine these into a clear, concise report with sections for background context and recommended contacts.
+        Do NOT ask the user any questions, just build and deploy it.
     output:
-      key: final_report
+      key: report
 
 config:
   timeout: 300000
-  onError: stop
+  onError: continue
 
 output:
-  research: "{{steps.web-research.output}}"
-  experts: "{{steps.find-experts.output}}"
-  summary: "{{steps.summarize.output}}"
-
-metadata:
-  category: example
-  tags:
-    - demo
-    - workflow
-    - multi-agent
-    - knowledge-search
+  report: "{{steps.publish.output}}"
+
+sampleQuestions:
+  - "Who reports to the VP of Engineering and what are their roles?"
+  - "How is Sarah doing in her recent calls? Any coaching opportunities?"
+  - "Show me the org structure for the Sales department"

package/dist/templates/workflows/react-example.workflow.yaml

@@ -1,7 +1,8 @@
-name: react-research
-description: Autonomous research workflow that discovers and uses all available tools and knowledge bases
+name: tool-explorer
+description: Autonomous ReAct workflow that discovers and uses all available tools and knowledge bases
 version: "1.0.0"
 type: react
+chatOutputFormat: text
 
 input:
   schema:
@@ -12,15 +13,14 @@ input:
 
 prompt:
   system: |
-    You are a research assistant with access to knowledge bases, tools, and other agents.
-
-    Available knowledge bases include company org charts, product inventories, web content, and more.
-    You also have access to calculator functions and other utility tools.
+    You are a research assistant with access to knowledge bases, tools, and utility functions.
 
     Research process:
     1. Identify which knowledge bases and tools are relevant to the topic
-    2. Search multiple sources in parallel when possible
-    3. Synthesize the results into a comprehensive, well-structured answer
+    2. Search multiple sources to gather comprehensive information
+    3. Synthesize the results into a clear, well-structured answer
+
+    When searching knowledge bases, use k=5 or fewer to keep results focused.
 
     If you need clarification from the user, use the ask_user tool.
   goal: "Research and answer: {{input.topic}}"
@@ -32,10 +32,8 @@ graph:
     mode: all
     sources: [knowledge, function, builtin]
   agents:
-    mode: all
-    exclude:
-      - architect
-  maxIterations: 10
+    mode: none
+  maxIterations: 100
   timeout: 300000
 
 output:
@@ -44,10 +42,7 @@ output:
 config:
   onError: stop
 
-metadata:
-  category: example
-  tags:
-    - demo
-    - react
-    - autonomous
-    - tool-discovery
+sampleQuestions:
+  - "Do we have any security incidents affecting our transport communication systems?"
+  - "Cross-reference our OT infrastructure with recent CVEs and tell me what's at risk"
+  - "Who are the top performers in the sales team based on their call transcripts?"

package/dist/templates/workflows/team-chat.workflow.yaml

@@ -0,0 +1,47 @@
+name: team-chat
+description: ReAct workflow that delegates tasks to specialized agents for collaborative problem-solving
+version: "1.0.0"
+type: react
+chatOutputFormat: text
+
+input:
+  schema:
+    topic:
+      type: string
+      required: true
+      description: The task or question to solve
+
+prompt:
+  system: |
+    You are a coordinator that delegates tasks to specialized agents.
+
+    Your role:
+    1. Understand the user's request
+    2. Identify which agents are best suited for each part of the task
+    3. Delegate to agents and combine their responses
+    4. Present a unified, coherent answer
+
+    If you need clarification from the user, use the ask_user tool.
+  goal: "Coordinate agents to answer: {{input.topic}}"
+
+graph:
+  model: default
+  executionMode: react
+  tools:
+    mode: include
+    sources: [builtin]
+    include: [ask_user]
+  agents:
+    mode: all
+  maxIterations: 100
+  timeout: 300000
+
+output:
+  result: "{{state.messages[-1].content}}"
+
+config:
+  onError: stop
+
+sampleQuestions:
+  - "Ask each agent to introduce themselves and their capabilities"
+  - "Get a security assessment from the network security agent"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-orcha",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "TypeScript Agentic Orchestration http server and framework for building multi-agent workflows with MCP tools and vector stores",
   "keywords": [
     "ai",
@@ -34,17 +34,20 @@
     "LICENSE"
   ],
   "scripts": {
-    "dev": "WORKSPACE=${WORKSPACE:-./templates} node --watch src/index.ts",
+    "dev": "node --watch src/index.ts",
     "build": "tsc && npm run copy-assets",
-    "copy-assets": "mkdir -p dist && cp -r public dist/ && cp -r templates dist/",
+    "copy-assets": "node -e \"const fs=require('fs');fs.cpSync('public','dist/public',{recursive:true});fs.cpSync('templates','dist/templates',{recursive:true})\"",
     "start": "node dist/src/index.js",
     "prepublishOnly": "npm run build",
     "lint": "eslint src lib --ext .ts",
     "typecheck": "tsc --noEmit",
-    "test": "node --test --test-force-exit 'test/**/*.test.ts'",
-    "test:coverage": "node --test --test-force-exit --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=lcov.info --test-reporter=spec --test-reporter-destination=stdout 'test/**/*.test.ts'",
+    "test": "node --experimental-test-module-mocks --test --test-force-exit 'test/**/*.test.ts'",
+    "test:coverage": "node --experimental-test-module-mocks --test --test-force-exit --experimental-test-coverage --test-reporter=lcov --test-reporter-destination=lcov.info --test-reporter=spec --test-reporter-destination=stdout 'test/**/*.test.ts'",
     "docker": "docker compose up --build --watch",
-    "docker:auth": "AUTH_PASSWORD=${AUTH_PASSWORD:-password} docker compose up --build --watch"
+    "build:binary": "node scripts/build-sea.mjs",
+    "sea": "node scripts/build-sea.mjs && ./dist/sea/agent-orcha",
+    "test:e2e": "npx playwright test",
+    "prepare": "./scripts/install-hooks.sh"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.76.0",
@@ -54,15 +57,18 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "cheerio": "^1.0.0",
     "dotenv": "^16.4.7",
+    "exceljs": "^4.4.0",
     "fastify": "^5.2.0",
     "fastify-plugin": "^5.1.0",
     "glob": "^11.0.0",
     "imapflow": "^1.2.10",
     "jsdom": "^28.1.0",
+    "mammoth": "^1.11.0",
     "mysql2": "^3.12.0",
     "node-cron": "^4.2.1",
     "nodemailer": "^8.0.1",
     "openai": "^6.22.0",
+    "pdf-parse": "^1.1.4",
     "pg": "^8.13.2",
     "pino": "^10.2.1",
     "pino-pretty": "^13.1.3",
@@ -73,12 +79,14 @@
     "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
+    "@playwright/test": "^1.58.2",
     "@types/jsdom": "^27.0.0",
     "@types/node": "^22.10.5",
     "@types/node-cron": "^3.0.11",
     "@types/nodemailer": "^7.0.11",
     "@types/pg": "^8.11.10",
     "@types/ws": "^8.18.1",
+    "esbuild": "^0.25.12",
     "eslint": "^9.17.0",
     "typescript": "^5.7.2"
   },

package/dist/public/src/components/SkillsView.js

@@ -1,137 +0,0 @@
-
-import { Component } from '../utils/Component.js';
-import { api } from '../services/ApiService.js';
-
-export class SkillsView extends Component {
-    constructor() {
-        super();
-        this.selectedSkill = null;
-    }
-
-    async connectedCallback() {
-        super.connectedCallback();
-        this.loadSkills();
-    }
-
-    async loadSkills() {
-        const container = this.querySelector('#skillsListContainer');
-        container.innerHTML = '<div class="text-gray-500 text-center py-8">Loading...</div>';
-
-        try {
-            const skills = await api.getSkills();
-            this.renderSkillsList(skills);
-        } catch (e) {
-            container.innerHTML = `<div class="text-red-400 text-center">Error: ${e.message}</div>`;
-        }
-    }
-
-    renderSkillsList(skills) {
-        const container = this.querySelector('#skillsListContainer');
-
-        if (!skills.length) {
-            container.innerHTML = `
-                <div class="text-gray-500 text-center py-12">
-                    <i class="fas fa-wand-magic-sparkles text-4xl mb-4 block text-gray-600"></i>
-                    <p class="text-lg mb-2">No skills found</p>
-                    <p class="text-sm">Create a <code class="bg-dark-surface px-2 py-1 rounded">skills/my-skill/SKILL.md</code> file to get started.</p>
-                </div>`;
-            return;
-        }
-
-        container.innerHTML = `
-            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
-                ${skills.map(skill => `
-                    <div class="skill-card bg-dark-surface border border-dark-border hover:border-teal-500 rounded-lg p-4 cursor-pointer transition-colors"
-                         data-skill-name="${skill.name}">
-                        <div class="flex items-center gap-2 mb-2">
-                            <i class="fas fa-wand-magic-sparkles text-teal-400 text-sm"></i>
-                            <span class="font-medium text-teal-400">${skill.name}</span>
-                        </div>
-                        <div class="text-xs text-gray-500 line-clamp-3">${skill.description || 'No description'}</div>
-                    </div>
-                `).join('')}
-            </div>`;
-
-        container.querySelectorAll('.skill-card').forEach(card => {
-            card.addEventListener('click', () => {
-                this.selectSkill(card.dataset.skillName);
-            });
-        });
-    }
-
-    async selectSkill(name) {
-        const detailArea = this.querySelector('#skillDetailArea');
-        detailArea.classList.remove('hidden');
-
-        this.querySelector('#skillDetailName').textContent = name;
-        this.querySelector('#skillDetailContent').textContent = 'Loading...';
-
-        // Highlight selected card
-        this.querySelectorAll('.skill-card').forEach(el => {
-            el.classList.remove('border-teal-500', 'bg-teal-500/10');
-            el.classList.add('border-dark-border');
-        });
-        const activeCard = this.querySelector(`[data-skill-name="${name}"]`);
-        if (activeCard) {
-            activeCard.classList.remove('border-dark-border');
-            activeCard.classList.add('border-teal-500', 'bg-teal-500/10');
-        }
-
-        try {
-            const skill = await api.getSkill(name);
-            this.selectedSkill = skill;
-            this.querySelector('#skillDetailDesc').textContent = skill.description || 'No description';
-            this.querySelector('#skillDetailContent').textContent = skill.content;
-        } catch (e) {
-            this.querySelector('#skillDetailContent').textContent = 'Error loading skill: ' + e.message;
-            this.querySelector('#skillDetailContent').classList.add('text-red-400');
-        }
-    }
-
-    postRender() {
-        this.querySelector('#closeDetailBtn').addEventListener('click', () => {
-            this.querySelector('#skillDetailArea').classList.add('hidden');
-            this.querySelectorAll('.skill-card').forEach(el => {
-                el.classList.remove('border-teal-500', 'bg-teal-500/10');
-                el.classList.add('border-dark-border');
-            });
-            this.selectedSkill = null;
-        });
-    }
-
-    template() {
-        return `
-            <div class="space-y-6 h-full overflow-y-auto pb-8 custom-scrollbar">
-                <div class="flex items-center justify-between border-b border-dark-border pb-4">
-                    <div>
-                        <h2 class="text-lg font-semibold text-gray-200">Skills</h2>
-                        <p class="text-xs text-gray-500 mt-1">Prompt augmentation units that expand agent capabilities</p>
-                    </div>
-                </div>
-
-                <div id="skillsListContainer"></div>
-
-                <div id="skillDetailArea" class="hidden border-t border-dark-border pt-6">
-                    <div class="bg-dark-surface/50 border border-dark-border rounded-lg p-4 mb-4">
-                        <div class="flex items-center justify-between">
-                            <div>
-                                <div class="font-medium text-teal-400" id="skillDetailName"></div>
-                                <div class="text-xs text-gray-500 mt-1" id="skillDetailDesc"></div>
-                            </div>
-                            <button id="closeDetailBtn" class="text-gray-500 hover:text-gray-300 transition-colors">
-                                <i class="fas fa-times"></i>
-                            </button>
-                        </div>
-                    </div>
-
-                    <div>
-                        <label class="block text-sm font-medium text-gray-300 mb-2">Skill Content</label>
-                        <pre id="skillDetailContent" class="bg-dark-surface border border-dark-border rounded-lg p-4 min-h-[200px] font-mono text-sm text-gray-300 whitespace-pre-wrap overflow-x-auto"></pre>
-                    </div>
-                </div>
-            </div>
-        `;
-    }
-}
-
-customElements.define('skills-view', SkillsView);