@hybridaione/hybridclaw 0.1.24 → 0.2.2

package/CHANGELOG.md

@@ -8,6 +8,69 @@
 
 ### Fixed
 
+## [0.2.2](https://github.com/HybridAIOne/hybridclaw/tree/v0.2.2)
+
+### Added
+
+- **Discord image attachment ingest/cache**: Added receive-time image ingest with local cache under `data/discord-media-cache`, preserving attachment order and carrying `path`, `mimeType`, `sizeBytes`, and `originalUrl` per media item.
+- **Structured media context pipeline**: Added typed media payload (`MediaPaths`/`MediaUrls`/`MediaTypes` equivalents) from Discord runtime through gateway/container request boundaries.
+- **Attachment vision tools**: Added `vision_analyze` (and `image` alias) for Discord-uploaded image analysis using local cached paths first, with Discord CDN URL fallback.
+- **Native multimodal injection**: Added direct image-part injection for vision-capable models, with automatic retry without image parts if the model rejects multimodal payloads.
+- **Scoped Vitest test configs**: Added dedicated `vitest.{unit,integration,e2e,live}.config.ts` files and matching npm scripts (`test:unit`, `test:integration`, `test:e2e`, `test:live`, `test:watch`) for explicit suite boundaries.
+
+### Changed
+
+- **Discord channel module layout**: Completed migration of Discord runtime internals into `src/channels/discord/*`, including `runtime.ts` and `stream.ts`, and removed legacy root-level `src/discord.ts` shim.
+- **Image-question tool routing**: Discord image questions now prioritize attachment vision (`vision_analyze`) and block `browser_vision` unless the user explicitly asks about the active browser tab/page.
+- **Browser vision scope guidance**: Updated `browser_vision` tool description to clarify it is for browser-page tasks only, not Discord-uploaded files.
+- **Test runner strategy**: Switched from compiled test artifacts (`dist-tests` + `tsconfig.tests.json`) to direct TypeScript execution via Vitest.
+- **Test file location and conventions**: Moved basic test files from `src/*.test.ts` to `tests/` and aligned naming/scoping conventions for unit/integration/e2e/live suites.
+
+### Fixed
+
+- **Discord image analysis fallback behavior**: Added safer cache/CDN fallback handling and guardrails (Discord CDN allowlist, size/type limits, per-image success/failure logging) to avoid brittle image-analysis failures.
+- **Regression coverage for wrong vision tool selection**: Added basic regression test coverage that Discord image questions should not route to browser screenshot vision.
+
+## [0.2.1](https://github.com/HybridAIOne/hybridclaw/tree/v0.2.1)
+
+### Added
+
+- **Discord `message` tool actions**: Added OpenClaw-style `message` tool support in the container with `read`, `member-info`, and `channel-info` actions, routed via the gateway API.
+- **Gateway Discord action endpoint**: Added `POST /api/discord/action` to execute Discord context actions for tools and automated runs.
+
+### Changed
+
+- **Discord presence handling**: Switched from prompt-injected presence snapshots to cache-backed presence data returned by `member-info` (`status` + `activities`) when available.
+- **Discord context guidance**: Updated safety prompt policy to explicitly route recap/member lookup questions through `message` tool actions instead of guessing.
+- **Tool allowlists**: Enabled `message` in heartbeat and base subagent allowed tool sets for delegated and automated workflows.
+- **Container gateway auth context**: Container input now carries gateway base URL/token and maps loopback hosts to `host.docker.internal` for in-container API reachability.
+- **Gateway token fallback**: Runtime now generates an internal gateway API token when no explicit token is configured, while preserving env/config overrides.
+
+### Fixed
+
+
+## [0.2.0](https://github.com/HybridAIOne/hybridclaw/tree/v0.2.0)
+
+### Added
+
+- **Personality switcher skill**: Added `skills/personality/SKILL.md` with `/personality` command workflow (`list`, `set`, `reset`) and a 25-profile persona set (including expert, style, and role personas like `pirate`, `noir`, `german`, `coach`, `doctor`, `soldier`, and `lawyer`).
+- **Ralph loop runtime mode**: Added configurable autonomous iteration (`proactive.ralph.maxIterations`) in the container tool loop. When enabled, turns continue automatically until the model emits `<choice>STOP</choice>` (or the configured loop budget is reached).
+- **Ralph command controls**: Added gateway/TUI command support for `ralph on|off|set <n>|info`, with immediate current-session container restart to apply loop settings without waiting for idle recycle.
+- **Skill creator authoring toolkit**: Added bundled `skills/skill-creator/` (invocable skill, references, and helper scripts) for initializing, validating, packaging, and generating `agents/openai.yaml` metadata for new skills.
+- **Discord context enrichment pipeline**: Added pending guild-history context, participant alias memory, `@name` mention-to-ID rewrite support, and optional per-channel presence snapshots for better grounded Discord replies.
+
+### Changed
+
+- **Personality persistence contract**: Standardized the managed `SOUL.md` personality block to `Name`, `Definition`, and `Rules`, so active persona behavior is fully file-driven.
+- **Personality style policy**: Updated persona rules so style signals are explicitly visible for the active personality (instead of only a subset).
+- **Personality skill prompt mode**: Set personality switching to command-only behavior (`always: false`, `disable-model-invocation: true`) to avoid per-turn prompt overhead while keeping `/personality` invocations available.
+- **Workspace AGENTS template behavior**: Updated `templates/AGENTS.md` group-chat guidance with explicit "Quality > quantity" speaking rules and emoji-reaction social-signal policy (`React Like a Human`, one reaction per message).
+- **Runtime self-awareness hook**: Prompt assembly now always injects runtime metadata (`version`, UTC date, model/default model, chatbot/channel/guild IDs, node/OS/host/workspace) and keeps it active in `minimal` mode.
+- **Discord runtime controls**: Added and hot-wired `discord.{guildMembersIntent,presenceIntent,respondToAllMessages,commandsOnly,commandUserId}` config behavior for intent selection, trigger policy, and command-user authorization.
+- **Gateway status reporting**: `status` command output now includes the running HybridClaw version line.
+
+### Fixed
+
 ## [0.1.24](https://github.com/HybridAIOne/hybridclaw/tree/v0.1.24)
 
 ### Added

package/README.md

@@ -11,7 +11,17 @@ npm install -g @hybridaione/hybridclaw
 hybridclaw onboarding
 ```
 
-Latest release: [v0.1.24](https://github.com/HybridAIOne/hybridclaw/releases/tag/v0.1.24)
+Latest release: [v0.2.2](https://github.com/HybridAIOne/hybridclaw/releases/tag/v0.2.2)
+
+## What's new in v0.2.2
+
+- Added Discord attachment ingest/cache with structured media context (`path`, `mime`, `size`, `original_url`) passed into the agent pipeline
+- Added `vision_analyze`/`image` tools for Discord-uploaded image analysis (local cached path first, Discord CDN fallback)
+- Added native model vision image-part injection for vision-capable models, with safe fallback if multimodal input is rejected
+- Routed Discord image questions away from `browser_vision` (unless explicitly about the active browser tab/page)
+- Completed Discord runtime migration into `src/channels/discord/*` and removed the legacy root-level `src/discord.ts` shim
+- Switched tests from compiled `dist-tests` artifacts to direct TypeScript execution via Vitest
+- Moved basic tests to `tests/` with explicit scope naming conventions
 
 ## HybridAI Advantage
 
@@ -79,6 +89,7 @@ HybridClaw best-in-class capabilities:
 - formal prompt hook orchestration (`bootstrap`, `memory`, `safety`)
 - Discord conversational UX: edit-in-place streaming responses, fence-safe chunking beyond Discord's 2000-char limit, typing keepalive, debounce batching, reply-chain-aware context, and concise attachment-first screenshot replies
 - token-efficient context assembly: per-message history truncation, hard history budgets with head/tail preservation, and head/tail truncation for oversized bootstrap files
+- runtime self-awareness in prompts: exact HybridClaw version/date, model, and runtime host metadata injected each turn for reliable "what version/model are you?" answers
 - proactive runtime layer with active-hours gating, push delegation (`single`/`parallel`/`chain`), depth-aware tool policy, and retry controls
 - structured audit trail: append-only hash-chained wire logs (`data/audit/<session>/wire.jsonl`) with tamper-evident immutability, normalized SQLite audit tables, and verification/search CLI commands
 - observability export: incremental `events:batch` forwarding with durable cursor tracking and bot-scoped ingest token lifecycle via `ingest-token:ensure`
@@ -92,11 +103,18 @@ HybridClaw uses typed runtime config in `config.json` (auto-created on first run
 
 - Start from `config.example.json` (reference)
 - Runtime watches `config.json` and hot-reloads most settings (model defaults, heartbeat, prompt hooks, limits, etc.)
+- `discord.guildMembersIntent` enables richer guild member context and better `@name` mention resolution in replies (requires enabling **Server Members Intent** in Discord Developer Portal)
+- `discord.presenceIntent` enables Discord presence events (requires enabling **Presence Intent** in Discord Developer Portal)
+- `discord.respondToAllMessages` changes guild trigger behavior: `false` (default) replies only on mention/`!claw`; `true` replies to every user message in the channel
+- `discord.commandUserId` restricts `!claw <command>` admin commands to a single Discord user ID (all other messages still use normal chat handling)
+- `discord.commandsOnly` optional hard mode: if `true`, the bot ignores non-`!claw` messages and only accepts prefixed commands (optionally limited by `discord.commandUserId`)
 - `skills.extraDirs` adds additional enterprise/shared skill roots (lowest precedence tier)
-- `proactive.*` controls autonomous behavior (`activeHours`, `delegation`, `autoRetry`)
+- `proactive.*` controls autonomous behavior (`activeHours`, `delegation`, `autoRetry`, `ralph`)
+- `proactive.ralph.maxIterations` enables Ralph loop (`0` off, `-1` unlimited, `>0` extra autonomous iterations before forcing completion)
+- TUI/Gateway command: `ralph on|off|set <n>|info` (`0` off, `-1` unlimited, `1-64` extra iterations)
 - `observability.*` controls push ingest into HybridAI (`events:batch` endpoint, batching, identity metadata)
 - Some settings require restart to fully apply (for example HTTP bind host/port)
-- Default bot is configured via `hybridai.defaultChatbotId` in `config.json` (legacy `HYBRIDAI_CHATBOT_ID` values are auto-migrated on startup)
+- Default bot is configured via `hybridai.defaultChatbotId` in `config.json`
 
 Secrets remain in `.env`:
 
@@ -258,6 +276,29 @@ Explicit invocation is supported via:
 Example skill in this repo:
 
 - `skills/repo-orientation/SKILL.md`
+- `skills/current-time/SKILL.md`
+- `skills/personality/SKILL.md`
+- `skills/skill-creator/SKILL.md`
+
+### Personality switching skill
+
+HybridClaw includes a command-only personality skill that updates the active persona contract in `SOUL.md`.
+
+- List current/available persona: `/personality` (or `/personality list`)
+- Activate persona: `/personality <name>`
+- Reset to default persona: `/personality reset`
+
+The skill writes/updates a managed block in `SOUL.md`:
+
+- `## Active personality`
+- `Name: ...`
+- `Definition: ...` (copied from the selected profile in `skills/personality/SKILL.md`)
+- `Rules: ...` (runtime style/behavior constraints)
+
+Notes:
+
+- The personality skill is intentionally command-only (`always: false`, `disable-model-invocation: true`) to avoid adding per-turn prompt overhead.
+- Profiles are defined in `skills/personality/SKILL.md` and currently include 25 switchable personas (expert, style, and role personas).
 
 ## Agent tools
 
@@ -310,6 +351,34 @@ System prompt assembly is handled by a formal hook pipeline:
 
 Hook toggles live in `config.json` under `promptHooks`.
 
+## Testing
+
+Run checks locally:
+
+```bash
+# Typecheck only (no emit)
+npm run typecheck
+
+# Strict TS lint gate (unused locals/params)
+npm run lint
+
+# Unit tests (default `npm test`)
+npm run test:unit
+
+# Scoped suites (ready for dedicated tests)
+npm run test:integration
+npm run test:e2e
+npm run test:live
+```
+
+Test layout and scopes:
+
+- tests live under `tests/` (not `src/`)
+- unit tests: `tests/**/*.test.ts` (excluding `*.integration|*.e2e|*.live`)
+- integration tests: `tests/**/*.integration.test.ts`
+- e2e tests: `tests/**/*.e2e.test.ts`
+- live tests: `tests/**/*.live.test.ts`
+
 ## Commands
 
 CLI runtime commands:
@@ -321,6 +390,7 @@ CLI runtime commands:
 - `hybridclaw gateway <command...>` — Send a command to a running gateway (for example `sessions`, `bot info`)
 - `hybridclaw tui` — Start terminal client connected to gateway
 - `hybridclaw onboarding` — Run HybridAI account/API key onboarding
+- `hybridclaw update [status|--check] [--yes]` — Check for updates and upgrade global npm installs (source checkouts get git-based update instructions)
 - `hybridclaw audit ...` — Verify and inspect structured audit trail (`recent`, `search`, `approvals`, `verify`, `instructions`)
 
 In Discord, use `!claw help` to see all commands. Key ones:
@@ -339,12 +409,14 @@ In Discord, use `!claw help` to see all commands. Key ones:
 ## Project structure
 
 ```
-src/gateway.ts          Core runtime entrypoint (DB, scheduler, heartbeat, HTTP API)
-src/tui.ts              Terminal adapter (thin client to gateway)
-src/discord.ts          Discord integration and message transport
-src/gateway-service.ts  Core shared agent/session logic used by gateway API
-src/gateway-client.ts   HTTP client used by thin clients (e.g. TUI)
-container/src/          Agent code (tools, HybridAI client, IPC)
-templates/              Workspace bootstrap files
-data/                   Runtime data (gitignored): SQLite DB, sessions, agent workspaces
+src/gateway.ts                    Core runtime entrypoint (DB, scheduler, heartbeat, HTTP API)
+src/tui.ts                        Terminal adapter (thin client to gateway)
+src/channels/discord/runtime.ts   Discord runtime integration and message transport
+src/channels/discord/*.ts         Discord responsibility modules (inbound, delivery, mentions, attachments, tools, stream)
+src/gateway-service.ts            Core shared agent/session logic used by gateway API
+src/gateway-client.ts             HTTP client used by thin clients (e.g. TUI)
+tests/                            Vitest suites (unit/integration/e2e/live scopes)
+container/src/                    Agent code (tools, HybridAI client, IPC)
+templates/                        Workspace bootstrap files
+data/                             Runtime data (gitignored): SQLite DB, sessions, agent workspaces
 ```

package/config.example.json

@@ -1,5 +1,5 @@
 {
-  "version": 2,
+  "version": 3,
   "security": {
     "trustModelAccepted": false,
     "trustModelAcceptedAt": "",
@@ -10,7 +10,12 @@
     "extraDirs": []
   },
   "discord": {
-    "prefix": "!claw"
+    "prefix": "!claw",
+    "guildMembersIntent": false,
+    "presenceIntent": false,
+    "respondToAllMessages": false,
+    "commandsOnly": false,
+    "commandUserId": ""
   },
   "hybridai": {
     "baseUrl": "https://hybridai.one",
@@ -94,6 +99,9 @@
       "maxAttempts": 3,
       "baseDelayMs": 2000,
       "maxDelayMs": 8000
+    },
+    "ralph": {
+      "maxIterations": 0
     }
   }
 }

package/container/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "hybridclaw-agent",
-  "version": "0.1.24",
+  "version": "0.2.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "hybridclaw-agent",
-      "version": "0.1.24",
+      "version": "0.2.2",
       "dependencies": {
         "@mozilla/readability": "^0.6.0",
         "agent-browser": "^0.15.1",

package/container/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hybridclaw-agent",
-  "version": "0.1.24",
+  "version": "0.2.2",
   "type": "module",
   "scripts": {
     "build": "tsc",

package/container/src/browser-tools.ts

@@ -1199,7 +1199,7 @@ export const BROWSER_TOOL_DEFINITIONS: ToolDefinition[] = [
     function: {
       name: 'browser_vision',
       description:
-        'Capture a screenshot and analyze it with a vision model using the provided question.',
+        'Capture the current browser page screenshot and analyze it with a vision model. Use only for active browser-tab/page tasks, not for Discord-uploaded files.',
       parameters: {
         type: 'object',
         properties: {