@hera-al/server 1.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TGP (The Good Programmer)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,325 @@
+# 💎 Hera Artificial Life
+
+**The AI that doesn't just chat — it acts, evolves, and thinks ahead.**
+
+Hera is not another chatbot wrapper. It's an autonomous AI platform that combines state-of-the-art language models with unprecedented levels of autonomy, action, and self-evolution. Built on Claude Agent SDK, Hera connects to multiple communication channels while maintaining context, learning from interactions, and proactively managing tasks without constant supervision.
+
+---
+
+## 🌟 What Makes Hera Different
+
+### Beyond Chat: True Autonomy
+- **Proactive Actions**: Schedules its own tasks, monitors events, reaches out when needed
+- **Self-Programming**: Creates and modifies its own skills, adapts workflows
+- **Memory Evolution**: Nightly consolidation transforms daily interactions into long-term knowledge with RDF concept mapping
+- **Multi-Modal Intelligence**: Voice (TTS/STT), vision, document processing, web search
+
+### Production-Ready Architecture
+- **Multi-Channel Gateway**: Telegram, WhatsApp, Discord, WebChat — unified interface, consistent experience
+- **Nostromo Control Center**: Advanced admin panel for real-time monitoring, configuration, and orchestration
+- **Distributed Execution**: Remote nodes for browser automation, shell execution, cross-platform actions
+- **Extensible by Design**: Skills, MCP tools, plugins — choose your level of integration
+
+### Built for Developers
+- **MIT Licensed Components**: Core libraries available as `@hera-al/*` packages on npm
+- **Claude Agent SDK Native**: Full toolkit access, streaming, artifacts, permissions
+- **TypeScript Throughout**: Type-safe, maintainable, modern codebase
+- **Docker Ready**: One command to production
+
+---
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     COMMUNICATION LAYER                      │
+│  Telegram • WhatsApp • Discord • WebChat • Voice • Browser  │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+┌────────────────────────▼────────────────────────────────────┐
+│                      HERA GATEWAY                            │
+│  • Session Management      • Multi-format rendering         │
+│  • Permission System       • Cron Scheduler                  │
+│  • Memory Pipeline         • Nostromo Admin Panel            │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+┌────────────────────────▼────────────────────────────────────┐
+│                  CLAUDE AGENT SDK                            │
+│  Claude Sonnet 4.5 • Tool orchestration • Streaming         │
+└────────────────────────┬────────────────────────────────────┘
+                         │
+         ┌───────────────┴───────────────┬─────────────────┐
+         │                               │                 │
+┌────────▼────────┐           ┌─────────▼──────┐  ┌───────▼────────┐
+│  SKILLS         │           │  MCP SERVERS   │  │  REMOTE NODES  │
+│  • Google WS    │           │  • Custom      │  │  • OSXNode     │
+│  • xAI Search   │           │  • Community   │  │  • Browser CDP │
+│  • Apple Notes  │           │  • External    │  │  • Shell Exec  │
+│  • Dreaming     │           │                │  │                │
+│  • Custom...    │           │                │  │                │
+└─────────────────┘           └────────────────┘  └────────────────┘
+```
+
+---
+
+## 🎯 Core Components
+
+### Nostromo — The Command Center
+Real-time admin panel providing:
+- **Live Session Monitoring**: Active conversations, context windows, tool usage
+- **Skill Management**: Install, update, configure, and publish skills
+- **Cron Orchestration**: Schedule autonomous tasks, view execution history
+- **Model Registry**: Switch between Claude, GPT-4, local models on the fly
+- **Permission Dashboard**: Approve/deny tool executions, set policies
+- **System Health**: Memory usage, API quotas, node connectivity
+
+### The Memory System
+Three-tier memory architecture:
+1. **Session Memory**: Real-time context during conversations
+2. **Daily Logs**: Markdown files with full conversation history
+3. **Long-Term Memory**: Consolidated knowledge with semantic search and RDF Turtle concept maps
+
+The `dreaming` skill runs nightly, identifying patterns, extracting insights, and updating the concept graph — Hera literally learns while you sleep.
+
+### Skills — Extensibility at Scale
+Skills are self-contained capabilities that extend Hera's reach:
+
+**Bundled Skills:**
+- `google-workspace` — Gmail, Drive, Docs, Sheets, Slides (OAuth2 integrated)
+- `xai-search` — Web and X (Twitter) search via Grok Responses API
+- `apple-notes` & `apple-reminders` — Native macOS integration
+- `weather` — Current conditions and forecasts
+- `ssh` — Remote server management
+- `dreaming` — Nightly memory consolidation and concept mapping
+- `the-skill-guardian` — Security scanner for third-party skills (90+ malicious pattern detection)
+- `skill-creator` — Meta-skill for creating and packaging new skills
+
+**Create Your Own:**
+```bash
+# Skills live in .claude/skills/<name>/
+# SKILL.md defines capabilities
+# scripts/ subfolder contains executables
+# Full access to Hera's toolkit
+```
+
+### MCP Integration
+Model Context Protocol (MCP) support allows:
+- Connecting to external data sources (databases, APIs, SaaS)
+- Using community MCP servers (Notion, Linear, GitHub, etc.)
+- Building custom MCP servers for proprietary systems
+
+### Remote Nodes
+WebSocket-based execution nodes for distributed actions:
+- **StandardNode**: Shell execution on any machine (npm package: `@hera-al/standardnode`)
+- **OSXNode**: Native macOS app with SwiftUI interface, markdown rendering, notifications
+- **Browser Nodes**: Chrome DevTools Protocol (CDP) automation for web scraping, testing, interaction
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+- Node.js 18+
+- Anthropic API key
+- (Optional) Telegram bot token, OpenAI API key for voice
+
+### Installation
+
+```bash
+# Clone or install
+npm install -g @hera-al/server
+```
+
+### Configuration
+
+Create `.env`:
+```env
+# Required
+ANTHROPIC_API_KEY=sk-ant-...
+DATA_FOLDER=/path/to/data
+
+# Channels (optional)
+TELEGRAM_BOT_TOKEN=123456789:ABC...
+WHATSAPP_ENABLED=true
+
+# Voice (optional)
+OPENAI_API_KEY=sk-...
+TTS_PROVIDER=openai
+TTS_VOICE=echo
+
+# Nostromo (optional)
+NOSTROMO_PORT=3030
+NOSTROMO_ENABLED=true
+```
+
+See `.env.example` for all options.
+
+### Launch
+
+```bash
+# Start the gateway
+npm start
+
+# Or with Nostromo
+npm run server:with-nostromo
+
+# CLI tools
+hera             # Interactive management CLI
+heraserver       # Start server programmatically
+hera-install      # Installation wizard
+```
+
+Access Nostromo at `http://localhost:3030` (default).
+
+---
+
+## 📚 Use Cases
+
+### Personal AI Assistant
+- Manages emails, calendar, reminders across platforms
+- Proactively surfaces relevant information
+- Learns preferences and adapts over time
+
+### Team Collaboration Hub
+- Multi-channel presence (Slack, Discord, Telegram simultaneously)
+- Skill-based workflows (CI/CD triggers, code reviews, deployments)
+- Shared memory and knowledge base
+
+### Autonomous Automation
+- Scheduled tasks via cron (data scraping, report generation, monitoring)
+- Self-healing workflows (detect failures, retry with exponential backoff)
+- Cross-platform orchestration (Mac → Linux → Cloud)
+
+### Research & Development
+- Memory consolidation identifies patterns in conversations
+- Concept mapping reveals hidden connections
+- Export knowledge graphs for analysis
+
+---
+
+## 🧩 Ecosystem
+
+### Published Packages
+
+| Package | Description | npm |
+|---------|-------------|-----|
+| `@hera-al/server` | Core gateway (coming soon) | — |
+| `@hera-al/browser-server` | WebChat UI component | [📦](https://www.npmjs.com/package/@hera-al/browser-server) |
+| `@hera-al/standardnode` | Remote execution node client | (coming soon) |
+
+### GitHub Organization
+- **Main repo**: [hera-artificial-life/hera-al](https://github.com/hera-artificial-life/hera-al)
+- **Skill repositories**: Skills developed by the community
+- **OSXNode**: [hera-artificial-life/osxnode](https://github.com/hera-artificial-life/osxnode)
+
+---
+
+## 🔐 Security
+
+### The Skill Guardian
+Before installing any third-party skill, run:
+```bash
+hera skill-scan <path-to-skill>
+```
+
+Detects 90+ malicious patterns including:
+- Code execution & shell injection
+- Data exfiltration & credential theft
+- Persistence mechanisms
+- Prompt injection attacks
+
+### Permission System
+Fine-grained control over:
+- Tool execution (approve/deny on demand or via policy)
+- File system access (read/write boundaries)
+- Network requests (allowlist/blocklist domains)
+- Skill capabilities (sandbox mode)
+
+---
+
+## 🌱 Philosophy: Hera vs. OpenClaw
+
+**OpenClaw** is the open-source framework — maximum flexibility, community-driven, all options on the table.
+
+**Hera** is the opinionated product — curated experience, cohesive design, decisions made for you. Think Rails vs. Express, or macOS vs. Linux.
+
+Both are valid. Hera makes choices so you don't have to. The building blocks (npm packages) are MIT licensed. The product (gateway + curated skills + Nostromo) is the Hera experience.
+
+---
+
+## 🛠️ Development
+
+### Project Structure
+```
+grabmeabeer/
+├── src/                 # Gateway source code
+│   ├── channels/        # Telegram, WhatsApp, Discord, WebChat
+│   ├── agent/           # Claude SDK integration
+│   ├── memory/          # Semantic search, RDF concept map
+│   ├── cron/            # Scheduler & job management
+│   └── tools/           # Built-in tools (node_exec, TTS, etc.)
+├── browser-server/      # WebChat UI (published to npm)
+├── standardnode/        # Remote node client (published to npm)
+├── .claude/skills/      # Skill directory
+├── bundled/             # Pre-installed skills
+├── installationPkg/     # Installation wizard assets
+└── nostromo/            # Admin panel source
+```
+
+### Contributing
+1. Fork the repo
+2. Create a feature branch
+3. Write tests (when applicable)
+4. Submit a pull request
+
+**Skill contributions welcome!** See `.claude/skills/skill-creator/SKILL.md` for the template.
+
+---
+
+## 📖 Documentation
+
+- **Installation Guide**: `docs/installation.md` (coming soon)
+- **Skill Development**: `.claude/skills/skill-creator/SKILL.md`
+- **API Reference**: `docs/api.md` (coming soon)
+- **Nostromo Manual**: `docs/nostromo.md` (coming soon)
+
+---
+
+## 🙏 Credits
+
+### Built With
+- [Claude Agent SDK](https://github.com/anthropics/anthropic-sdk-typescript) — Anthropic
+- [grammY](https://grammy.dev) — Telegram bot framework
+- [Hono](https://hono.dev) — Lightweight web framework
+- [Zod](https://zod.dev) — TypeScript-first schema validation
+- [better-sqlite3](https://github.com/WiseLibs/better-sqlite3) — Fast SQLite bindings
+
+### Inspiration
+Standing on the shoulders of giants: OpenClaw, AutoGPT, LangChain, and the entire open-source AI community.
+
+---
+
+## 📄 License
+
+**MIT License** — see [LICENSE](./LICENSE) for details.
+
+Core components (`@hera-al/*` packages) are free and open source. Build, fork, modify, deploy commercially — it's yours.
+
+The Hera product (curated gateway + skills + Nostromo) represents our vision of what an AI agent should be. Use the components freely; experience Hera as intended.
+
+---
+
+## 🔗 Links
+
+- **Website**: Coming soon
+- **npm**: [@hera-al](https://www.npmjs.com/org/hera-al)
+- **GitHub**: [hera-artificial-life](https://github.com/hera-artificial-life)
+- **Author**: TGP (The Good Programmer)
+- **Email**: heralife.dev@gmail.com
+
+---
+
+<p align="center">
+  <strong>💎 Hera Artificial Life</strong><br>
+  <em>Opinionated AI. Curated experience. Unprecedented autonomy.</em>
+</p>

package/bundled/apple-notes/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: apple-notes
+description: Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
+homepage: https://github.com/antoniorodr/memo
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📝",
+        "os": ["darwin"],
+        "requires": { "bins": ["memo"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "antoniorodr/memo/memo",
+              "bins": ["memo"],
+              "label": "Install memo via Homebrew",
+            },
+          ],
+      },
+  }
+---
+
+# Apple Notes CLI
+
+Use `memo notes` to manage Apple Notes directly from the terminal. Create, view, edit, delete, search, move notes between folders, and export to HTML/Markdown.
+
+Setup
+
+- Install (Homebrew): `brew tap antoniorodr/memo && brew install antoniorodr/memo/memo`
+- Manual (pip): `pip install .` (after cloning the repo)
+- macOS-only; if prompted, grant Automation access to Notes.app.
+
+View Notes
+
+- List all notes: `memo notes`
+- Filter by folder: `memo notes -f "Folder Name"`
+- Search notes (fuzzy): `memo notes -s "query"`
+
+Create Notes
+
+- Add a new note: `memo notes -a`
+  - Opens an interactive editor to compose the note.
+- Quick add with title: `memo notes -a "Note Title"`
+
+Edit Notes
+
+- Edit existing note: `memo notes -e`
+  - Interactive selection of note to edit.
+
+Delete Notes
+
+- Delete a note: `memo notes -d`
+  - Interactive selection of note to delete.
+
+Move Notes
+
+- Move note to folder: `memo notes -m`
+  - Interactive selection of note and destination folder.
+
+Export Notes
+
+- Export to HTML/Markdown: `memo notes -ex`
+  - Exports selected note; uses Mistune for markdown processing.
+
+Limitations
+
+- Cannot edit notes containing images or attachments.
+- Interactive prompts may require terminal access.
+
+Notes
+
+- macOS-only.
+- Requires Apple Notes.app to be accessible.
+- For automation, grant permissions in System Settings > Privacy & Security > Automation.

package/bundled/apple-reminders/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: apple-reminders
+description: Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
+homepage: https://github.com/steipete/remindctl
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "⏰",
+        "os": ["darwin"],
+        "requires": { "bins": ["remindctl"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/remindctl",
+              "bins": ["remindctl"],
+              "label": "Install remindctl via Homebrew",
+            },
+          ],
+      },
+  }
+---
+
+# Apple Reminders CLI (remindctl)
+
+Use `remindctl` to manage Apple Reminders directly from the terminal. It supports list filtering, date-based views, and scripting output.
+
+Setup
+
+- Install (Homebrew): `brew install steipete/tap/remindctl`
+- From source: `pnpm install && pnpm build` (binary at `./bin/remindctl`)
+- macOS-only; grant Reminders permission when prompted.
+
+Permissions
+
+- Check status: `remindctl status`
+- Request access: `remindctl authorize`
+
+View Reminders
+
+- Default (today): `remindctl`
+- Today: `remindctl today`
+- Tomorrow: `remindctl tomorrow`
+- Week: `remindctl week`
+- Overdue: `remindctl overdue`
+- Upcoming: `remindctl upcoming`
+- Completed: `remindctl completed`
+- All: `remindctl all`
+- Specific date: `remindctl 2026-01-04`
+
+Manage Lists
+
+- List all lists: `remindctl list`
+- Show list: `remindctl list Work`
+- Create list: `remindctl list Projects --create`
+- Rename list: `remindctl list Work --rename Office`
+- Delete list: `remindctl list Work --delete`
+
+Create Reminders
+
+- Quick add: `remindctl add "Buy milk"`
+- With list + due: `remindctl add --title "Call mom" --list Personal --due tomorrow`
+
+Edit Reminders
+
+- Edit title/due: `remindctl edit 1 --title "New title" --due 2026-01-04`
+
+Complete Reminders
+
+- Complete by id: `remindctl complete 1 2 3`
+
+Delete Reminders
+
+- Delete by id: `remindctl delete 4A83 --force`
+
+Output Formats
+
+- JSON (scripting): `remindctl today --json`
+- Plain TSV: `remindctl today --plain`
+- Counts only: `remindctl today --quiet`
+
+Date Formats
+Accepted by `--due` and date filters:
+
+- `today`, `tomorrow`, `yesterday`
+- `YYYY-MM-DD`
+- `YYYY-MM-DD HH:mm`
+- ISO 8601 (`2026-01-04T12:34:56Z`)
+
+Notes
+
+- macOS-only.
+- If access is denied, enable Terminal/remindctl in System Settings → Privacy & Security → Reminders.
+- If running over SSH, grant access on the Mac that runs the command.

package/bundled/blogwatcher/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: blogwatcher
+description: Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
+homepage: https://github.com/Hyaxia/blogwatcher
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📰",
+        "requires": { "bins": ["blogwatcher"] },
+        "install":
+          [
+            {
+              "id": "go",
+              "kind": "go",
+              "module": "github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest",
+              "bins": ["blogwatcher"],
+              "label": "Install blogwatcher (go)",
+            },
+          ],
+      },
+  }
+---
+
+# blogwatcher
+
+Track blog and RSS/Atom feed updates with the `blogwatcher` CLI.
+
+Install
+
+- Go: `go install github.com/Hyaxia/blogwatcher/cmd/blogwatcher@latest`
+
+Quick start
+
+- `blogwatcher --help`
+
+Common commands
+
+- Add a blog: `blogwatcher add "My Blog" https://example.com`
+- List blogs: `blogwatcher blogs`
+- Scan for updates: `blogwatcher scan`
+- List articles: `blogwatcher articles`
+- Mark an article read: `blogwatcher read 1`
+- Mark all articles read: `blogwatcher read-all`
+- Remove a blog: `blogwatcher remove "My Blog"`
+
+Example output
+
+```
+$ blogwatcher blogs
+Tracked blogs (1):
+
+  xkcd
+    URL: https://xkcd.com
+```
+
+```
+$ blogwatcher scan
+Scanning 1 blog(s)...
+
+  xkcd
+    Source: RSS | Found: 4 | New: 4
+
+Found 4 new article(s) total!
+```
+
+Notes
+
+- Use `blogwatcher <command> --help` to discover flags and options.

package/bundled/camsnap/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: camsnap
+description: Capture frames or clips from RTSP/ONVIF cameras.
+homepage: https://camsnap.ai
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "📸",
+        "requires": { "bins": ["camsnap"] },
+        "install":
+          [
+            {
+              "id": "brew",
+              "kind": "brew",
+              "formula": "steipete/tap/camsnap",
+              "bins": ["camsnap"],
+              "label": "Install camsnap (brew)",
+            },
+          ],
+      },
+  }
+---
+
+# camsnap
+
+Use `camsnap` to grab snapshots, clips, or motion events from configured cameras.
+
+Setup
+
+- Config file: `~/.config/camsnap/config.yaml`
+- Add camera: `camsnap add --name kitchen --host 192.168.0.10 --user user --pass pass`
+
+Common commands
+
+- Discover: `camsnap discover --info`
+- Snapshot: `camsnap snap kitchen --out shot.jpg`
+- Clip: `camsnap clip kitchen --dur 5s --out clip.mp4`
+- Motion watch: `camsnap watch kitchen --threshold 0.2 --action '...'`
+- Doctor: `camsnap doctor --probe`
+
+Notes
+
+- Requires `ffmpeg` on PATH.
+- Prefer a short test capture before longer clips.