@hera-al/server 1.6.1

package/installationPkg/config.example.yaml

@@ -0,0 +1,291 @@
+# GrabMeABeer Configuration
+# Copy to config.yaml and fill in your values.
+# Environment variables can be referenced as ${VAR_NAME}
+
+gmabPath: "~/gmab"                        # root data directory (expanded at runtime)
+host: "127.0.0.1"                         # bind address for HTTP servers
+logLevel: "info"                          # debug | info | warn | error
+verboseDebugLogs: true                    # show full prompt/response text in debug logs (false = truncate to 15 chars)
+timezone: ""                              # auto-detected on first boot (e.g. Europe/Rome, America/New_York)
+fastProxyUrl: "http://localhost:4181"     # URL of the fast proxy server for proxied external models
+
+channels:
+  telegram:
+    enabled: false
+    accounts:
+      default:
+        botToken: ""
+        # dmPolicy: "open" | "token" | "allowlist"
+        #   open     - anyone can message (no auth)
+        #   token    - sender must have a valid token in the DB
+        #   allowlist - only Telegram IDs listed in allowFrom
+        dmPolicy: "allowlist"
+        allowFrom: []                # telegram user IDs allowed (for allowlist policy)
+
+  # whatsapp:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       authDir: "./data/whatsapp"
+  #       dmPolicy: "token"
+  #       allowFrom: []
+
+  # discord:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       token: "${DISCORD_TOKEN}"
+
+  # slack:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       botToken: "${SLACK_BOT_TOKEN}"
+  #       appToken: "${SLACK_APP_TOKEN}"
+
+  # signal:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       apiUrl: "http://localhost:8080"
+  #       phoneNumber: ""
+
+  # msteams:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       appId: ""
+  #       appSecret: ""
+
+  # googlechat:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       credentialsFile: ""
+  #       spaceId: ""
+
+  # line:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       channelAccessToken: ""
+  #       channelSecret: ""
+
+  # matrix:
+  #   enabled: false
+  #   accounts:
+  #     default:
+  #       homeserverUrl: ""
+  #       userId: ""
+  #       accessToken: ""
+
+  responses:
+    enabled: true
+    port: 3000
+
+models:                                    # model registry
+  - id: "claude-opus-4-6"
+    name: "Claude Opus"
+    types: [internal]                      # internal | external
+  - id: openai
+    name: OpenAI
+    types:
+      - external
+    proxy: "not-used"                      # not-used | direct | proxied
+    fastUrl: ""                            # OpenAI-compatible proxy URL (used when proxy is direct or proxied)
+    fastProxyApiKey: ""                    # API key for the proxy endpoint (sk-...)
+    apiKey: ""
+    baseURL: https://api.openai.com/v1
+    useEnvVar: ""
+
+stt:
+  enabled: false
+  provider: openai-whisper                 # openai-whisper | local-whisper
+  openai-whisper:
+    modelRef: "OpenAI"                     # references a model name in the models registry (for API key)
+    model: "whisper-1"                     # actual model ID sent to the OpenAI API
+    language: ""                           # empty = auto-detect, or ISO 639-1 code (en, it, de, ...)
+  local-whisper:
+    binaryPath: "whisper"
+    model: "base"
+
+tts:
+  enabled: false
+  provider: openai                         # openai | edge | elevenlabs
+  maxTextLength: 4096
+  timeoutMs: 30000
+  edge:
+    voice: en-US-MichelleNeural
+    lang: en-US                            # BCP-47 language tag
+    outputFormat: audio-24khz-48kbitrate-mono-mp3
+  openai:
+    modelRef: "OpenAI"                     # references a model name in the models registry (for API key)
+    model: gpt-4o-mini-tts                 # actual model ID sent to the OpenAI API
+    voice: alloy
+  elevenlabs:
+    modelRef: ""
+    voiceId: pMsXgVXv3BLzUgSXRplE
+    modelId: eleven_multilingual_v2
+
+memory:
+  enabled: true
+  recallStrategy: "builtin-only"           # builtin-only | search
+  search:
+    enabled: false                         # enable hybrid BM25 + semantic search over memory
+    modelRef: ""                           # references a model in the models registry (for API key + base URL)
+    embeddingModel: "text-embedding-3-small"
+    embeddingDimensions: 1536              # 512, 768, or 1536 (native) — lower = faster, higher = more precise
+    updateDebounceMs: 3000                 # debounce for fs.watch before re-indexing
+    embedIntervalMs: 300000                # interval (ms) between embedding cycles (5 min)
+    maxResults: 10                         # default max results returned by memory_search
+    maxSnippetChars: 700                   # max chars per snippet in results
+    maxInjectedChars: 4000                 # max total chars injected into context from search results
+    rrfK: 60                               # RRF fusion constant (higher = smoother blending)
+
+agent:
+  model: "Claude Opus"                     # model name or ID from the models registry
+  mainFallback: ""                         # fallback model if primary fails (name or ID)
+  maxTurns: 30
+  permissionMode: "bypassPermissions"
+  sessionTTL: 3600
+  workspacePath: "./workspace"             # agent's working directory
+  # queueMode: "queue" | "collect" | "steer"
+  #   queue   - simple FIFO, one message = one response
+  #   collect - batch messages while agent is busy
+  #   steer   - new message interrupts the current one
+  queueMode: "steer"
+  queueDebounceMs: 1500                    # quiet period (ms) after last collected message before flushing (collect mode)
+  queueCap: 20                             # max buffered messages (0 = unlimited)
+  # queueDropPolicy: "old" | "new" | "summarize"
+  #   old       - drop oldest buffered message
+  #   new       - reject incoming message
+  #   summarize - drop oldest but keep a truncated summary for context
+  queueDropPolicy: "summarize"
+  allowedTools:
+    - "Read"
+    - "Grep"
+    - "Bash"
+    - "WebSearch"
+    - "Glob"
+    - "Write"
+    - "Edit"
+    - "WebFetch"
+    - "Task"
+    - "Skill"
+  disallowedTools: []
+  mcpServers: {}
+  builtinCoderSkill: false                 # enable coder skill in system prompt (toggle at runtime with /coder on|off)
+  settingSources: project                  # SDK settings to load: nothing | user | project | both
+  # Custom subagents — configurable via Nostromo UI (toggle at runtime with /customsubagents on|off)
+  # description: tells Claude when to use this subagent
+  # prompt: defines the subagent's behavior and expertise
+  # tools: which SDK tools the subagent can use
+  # model: override model (sonnet, opus, haiku, inherit)
+  # expandContext: prepend main system prompt to subagent prompt (default: false)
+  customSubAgents:
+    - name: code-reviewer
+      description: "Expert code review specialist. Use for quality, security, and maintainability reviews."
+      prompt: |
+        You are a code review specialist with expertise in security, performance, and best practices.
+
+        When reviewing code:
+        - Identify security vulnerabilities
+        - Check for performance issues
+        - Verify adherence to coding standards
+        - Suggest specific improvements
+
+        Be thorough but concise in your feedback.
+      model: inherit
+      tools: [Read, Grep, Glob, WebSearch, WebFetch]
+      expandContext: false
+      enabled: false
+
+    - name: test-runner
+      description: "Runs and analyzes test suites. Use for test execution and coverage analysis."
+      prompt: |
+        You are a test execution specialist. Run tests and provide clear analysis of results.
+
+        Focus on:
+        - Running test commands
+        - Analyzing test output
+        - Identifying failing tests
+        - Suggesting fixes for failures
+      model: inherit
+      tools: [Bash, Read, Grep, Glob, WebSearch, WebFetch]
+      expandContext: false
+      enabled: false
+
+    - name: security-reviewer
+      description: "Security-focused code reviewer. Use for vulnerability detection and security audits."
+      prompt: |
+        You are a strict security reviewer. Analyze code for vulnerabilities, injection risks, authentication flaws, and data exposure.
+
+        For each finding:
+        - Classify severity (critical, high, medium, low)
+        - Explain the attack vector
+        - Provide a concrete fix
+
+        Prioritize OWASP Top 10 and CWE categories.
+      model: inherit
+      tools: [Read, Grep, Glob, WebSearch, WebFetch]
+      expandContext: false
+      enabled: false
+
+    - name: code-analyzer
+      description: "Static code analysis and architecture review. Use for understanding structure and patterns."
+      prompt: |
+        You are a code architecture analyst. Analyze code structure, identify patterns, and suggest improvements without making changes.
+
+        Focus on:
+        - Architecture and design patterns
+        - Code organization and modularity
+        - Dependency analysis
+        - Complexity assessment
+      model: inherit
+      tools: [Read, Grep, Glob, WebSearch, WebFetch]
+      expandContext: false
+      enabled: false
+
+    - name: research-assistant
+      description: "General-purpose research and writing assistant. Use for information gathering, summarization, and document drafting."
+      prompt: |
+        You are a versatile research assistant. Gather information, analyze data, and produce clear written output.
+
+        Capabilities:
+        - Web research and fact-checking
+        - Summarizing documents and codebases
+        - Drafting reports, documentation, and notes
+        - Answering complex multi-step questions
+
+        Always cite sources and distinguish facts from inferences.
+      model: inherit
+      tools: [Read, Edit, Write, Grep, Glob, WebSearch, WebFetch]
+      expandContext: false
+      enabled: false
+  plugins: []                              # local plugins, configurable via Nostromo UI
+  inflightTyping: true                     # keep typing indicator active when multiple messages are in-flight
+  autoApproveTools: true                   # auto-approve SDK tool permissions; when false, asks user via channel buttons
+
+cron:
+  enabled: true
+  isolated: true                           # jobs run in their own session (cron:name) instead of sharing user chat context
+  broadcastEvents: false                   # deliver cron responses to all known chats across all active channels
+  # storePath: ""                          # leave empty for default (data/cron/jobs.json)
+  heartbeat:
+    enabled: false
+    every: 1800000
+    channel: ""
+    chatId: ""
+    message: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK."
+    ackMaxChars: 300
+
+nostromo:
+  enabled: true
+  port: 3001
+  basePath: "/nostromo"                    # base URL path for the admin UI (e.g. /nostromo → http://host:port/nostromo)
+  configCheckInterval: 5                   # seconds between config file checks
+  autoRestart: true                        # auto-restart server when config.yaml changes
+
+browser:
+    enabled: false
+    controlPort: 3003

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@hera-al/server",
+  "version": "1.6.1",
+  "private": false,
+  "description": "Hera Artificial Life — Multi-channel AI agent gateway with autonomous capabilities",
+  "license": "MIT",
+  "author": "TGP <heralife.dev@gmail.com>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "workspaces": [
+    "browser-server",
+    "standardnode"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hera-artificial-life/hera-al.git"
+  },
+  "homepage": "https://github.com/hera-artificial-life/hera-al",
+  "keywords": [
+    "ai-agent",
+    "chatbot-gateway",
+    "telegram",
+    "discord",
+    "whatsapp",
+    "multi-channel",
+    "claude-ai",
+    "agent-sdk",
+    "hera"
+  ],
+  "files": [
+    "dist",
+    "!dist/**/*.map",
+    "!dist/**/*.d.ts.map",
+    "bundled",
+    "installationPkg"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "hera": "./dist/heracli/index.js",
+    "hera-install": "./dist/installer/hera.js",
+    "heraserver": "./dist/index.js"
+  },
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "minify": "find dist -name '*.map' -delete && find dist -name '*.js' -exec terser {} --module --compress --mangle -o {} \\;",
+    "build:prod": "rm -rf dist && npm run build && npm run minify",
+    "typecheck": "tsc --noEmit",
+    "installer": "tsx src/installer/hera.ts",
+    "up": "npx pm2 start npm --name hera -- run start",
+    "down": "npx pm2 stop hera",
+    "restart": "npx pm2 restart hera",
+    "logs": "npx pm2 logs hera",
+    "status": "npx pm2 status hera",
+    "hera": "node dist/heracli/index.js",
+    "prepublishOnly": "npm run build:prod",
+    "prepare-publish": "./scripts/prepare-publish.sh",
+    "restore-workspace": "./scripts/restore-workspace.sh"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "latest",
+    "@clack/prompts": "^1.0.0",
+    "@grammyjs/runner": "^2.0.3",
+    "@hera-al/browser-server": "^1.0.4",
+    "@hono/node-server": "^1.13.8",
+    "@types/markdown-it": "^14.1.2",
+    "@whiskeysockets/baileys": "^7.0.0-rc.9",
+    "better-sqlite3": "^11.7.0",
+    "croner": "^9.1.0",
+    "dotenv": "^17.2.4",
+    "grammy": "^1.35.0",
+    "hnswlib-node": "^3.0.0",
+    "hono": "^4.7.4",
+    "markdown-it": "^14.1.0",
+    "node-edge-tts": "^1.2.10",
+    "openai": "^6.0.0",
+    "playwright-core": "^1.58.2",
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.18.0",
+    "yaml": "^2.7.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.13.4",
+    "@types/ws": "^8.5.13",
+    "terser": "^5.46.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3"
+  }
+}