@borgee/agents-host 0.1.0 → 0.1.3

package/README.md

@@ -1,91 +1,91 @@
-# @borgee/agents-host
-
-Minimal local runtime host: connects a local **Claude Code CLI** (`claude`) or
-**GitHub Copilot CLI** (`copilot`) process to a single Borgee agent over
-[`@borgee/plugin-sdk`](../../sdk/plugin-ts) — the same BPP (`/ws/plugin`)
-protocol the official OpenClaw plugin uses.
-
-## What this is (and isn't)
-
-This package is intentionally the *smallest* slice that proves the full loop:
-
-```
-Borgee channel message
-  → /ws/plugin (BPP)
-  → @borgee/plugin-sdk
-  → AgentsHost.handleMessage
-  → local `claude`/`copilot` CLI subprocess
-  → BPP reply
-  → Borgee channel
-```
-
-**In scope:** one agent per process, mention-only gating (with a DM bypass),
-per-channel conversation memory via each CLI's own native session resume
-(Claude `--resume`, Copilot `--session-id`), and dispatching to a local CLI
-provider.
-
-**Out of scope** (see the larger `feat/multi-agent-runtime-host` work for
-these): remote command execution / shell dispatch, node provisioning,
-multi-agent discovery/sync, systemd service install, and scheduled/periodic
-prompts. To run several agents, run several processes with different
-`BORGEE_AGENT_API_KEY` values.
-
-## Setup
-
-1. In the Borgee web UI, create an Agent and reveal its API key.
-2. Install the Claude Code CLI (`claude`) or GitHub Copilot CLI (`copilot`)
-   locally and make sure it works standalone.
-3. Run this package with the environment variables below.
-
-```bash
-BORGEE_BASE_URL=https://your-borgee-server \
-BORGEE_AGENT_API_KEY=bgr_xxxxxxxx \
-BORGEE_AGENT_NAME="My Agent" \
-RUNTIME_PROVIDER=claude \
-pnpm --filter @borgee/agents-host dev
-```
-
-## Environment variables
-
-| Variable | Required | Default | Description |
-| --- | --- | --- | --- |
-| `BORGEE_BASE_URL` | yes | — | Borgee server base URL (e.g. `https://borgee.example.com`) |
-| `BORGEE_AGENT_API_KEY` | yes | — | The agent's API key, revealed from the web UI |
-| `BORGEE_AGENT_NAME` | no | `Assistant` | Display name used for mention matching and prompts |
-| `RUNTIME_PROVIDER` | no | `claude` | `claude` or `copilot` |
-| `CLAUDE_COMMAND` / `CLAUDE_ARGS` | no | `claude` / `--print` | Local Claude CLI command + args |
-| `COPILOT_COMMAND` / `COPILOT_ARGS` | no | `copilot` / `-s --no-color --allow-all-tools --output-format text` | Local Copilot CLI command + args |
-| `RESPOND_ON_MENTION_ONLY` | no | `true` | If `true`, only replies in non-DM channels when @mentioned; DMs always get a reply |
-
-## Conversation memory
-
-Each Borgee channel is mapped 1:1 to a native CLI session, keyed by a
-generated UUID kept in memory for the process's lifetime:
-
-- **Claude**: first turn for a channel uses `--session-id <uuid>`; every
-  turn after uses `-r/--resume <uuid>` (Claude treats these as distinct
-  operations).
-- **Copilot**: every turn uses `--session-id=<uuid>` — Copilot's CLI treats
-  that flag as create-or-resume for the same UUID.
-
-There is no separate history/context store on our side; if the runtime host
-process restarts, each channel starts a fresh CLI session (no session-id
-persistence across restarts in this minimal version).
-
-## Running
-
-```bash
-pnpm --filter @borgee/agents-host dev     # tsx, no build step
-pnpm --filter @borgee/agents-host build   # tsc -> dist/
-pnpm --filter @borgee/agents-host start   # node dist/index.js
-```
-
-There is no systemd/service installer here — run it as a plain foreground
-process (or wrap it with your own process manager) and stop it with
-`Ctrl+C`/`SIGTERM`.
-
-## Testing
-
-```bash
-pnpm --filter @borgee/agents-host test
-```
+# @borgee/agents-host
+
+Minimal local runtime host: connects a local **Claude Code CLI** (`claude`) or
+**GitHub Copilot CLI** (`copilot`) process to a single Borgee agent over
+[`@borgee/plugin-sdk`](../../sdk/plugin-ts) — the same BPP (`/ws/plugin`)
+protocol the official OpenClaw plugin uses.
+
+## What this is (and isn't)
+
+This package is intentionally the *smallest* slice that proves the full loop:
+
+```
+Borgee channel message
+  → /ws/plugin (BPP)
+  → @borgee/plugin-sdk
+  → AgentsHost.handleMessage
+  → local `claude`/`copilot` CLI subprocess
+  → BPP reply
+  → Borgee channel
+```
+
+**In scope:** one agent per process, mention-only gating (with a DM bypass),
+per-channel conversation memory via each CLI's own native session resume
+(Claude `--resume`, Copilot `--session-id`), and dispatching to a local CLI
+provider.
+
+**Out of scope** (see the larger `feat/multi-agent-runtime-host` work for
+these): remote command execution / shell dispatch, node provisioning,
+multi-agent discovery/sync, systemd service install, and scheduled/periodic
+prompts. To run several agents, run several processes with different
+`BORGEE_AGENT_API_KEY` values.
+
+## Setup
+
+1. In the Borgee web UI, create an Agent and reveal its API key.
+2. Install the Claude Code CLI (`claude`) or GitHub Copilot CLI (`copilot`)
+   locally and make sure it works standalone.
+3. Run this package with the environment variables below.
+
+```bash
+BORGEE_BASE_URL=https://your-borgee-server \
+BORGEE_AGENT_API_KEY=bgr_xxxxxxxx \
+BORGEE_AGENT_NAME="My Agent" \
+RUNTIME_PROVIDER=claude \
+pnpm --filter @borgee/agents-host dev
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+| --- | --- | --- | --- |
+| `BORGEE_BASE_URL` | yes | — | Borgee server base URL (e.g. `https://borgee.example.com`) |
+| `BORGEE_AGENT_API_KEY` | yes | — | The agent's API key, revealed from the web UI |
+| `BORGEE_AGENT_NAME` | no | `Assistant` | Display name used for mention matching and prompts |
+| `RUNTIME_PROVIDER` | no | `claude` | `claude` or `copilot` |
+| `CLAUDE_COMMAND` / `CLAUDE_ARGS` | no | `claude` / `--print` | Local Claude CLI command + args |
+| `COPILOT_COMMAND` / `COPILOT_ARGS` | no | `copilot` / `-s --no-color --allow-all-tools --output-format text` | Local Copilot CLI command + args |
+| `RESPOND_ON_MENTION_ONLY` | no | `true` | If `true`, only replies in non-DM channels when @mentioned; DMs always get a reply |
+
+## Conversation memory
+
+Each Borgee channel is mapped 1:1 to a native CLI session, keyed by a
+generated UUID kept in memory for the process's lifetime:
+
+- **Claude**: first turn for a channel uses `--session-id <uuid>`; every
+  turn after uses `-r/--resume <uuid>` (Claude treats these as distinct
+  operations).
+- **Copilot**: every turn uses `--session-id=<uuid>` — Copilot's CLI treats
+  that flag as create-or-resume for the same UUID.
+
+There is no separate history/context store on our side; if the runtime host
+process restarts, each channel starts a fresh CLI session (no session-id
+persistence across restarts in this minimal version).
+
+## Running
+
+```bash
+pnpm --filter @borgee/agents-host dev     # tsx, no build step
+pnpm --filter @borgee/agents-host build   # tsc -> dist/
+pnpm --filter @borgee/agents-host start   # node dist/index.js
+```
+
+There is no systemd/service installer here — run it as a plain foreground
+process (or wrap it with your own process manager) and stop it with
+`Ctrl+C`/`SIGTERM`.
+
+## Testing
+
+```bash
+pnpm --filter @borgee/agents-host test
+```

package/dist/agents-host.d.ts

@@ -35,6 +35,7 @@ export declare class AgentsHost {
      */
     isLikelyMention(message: {
         type?: string;
+        mentions?: string[];
     }, content: string): boolean;
     /**
      * Channel-type check, based solely on the `channel_type` hint the SDK

package/dist/agents-host.js

@@ -102,6 +102,11 @@ export class AgentsHost {
         if (message.type === 'mention') {
             return true;
         }
+        if (Array.isArray(message.mentions) && this.selfAgentId) {
+            if (message.mentions.some((mention) => mention === this.selfAgentId)) {
+                return true;
+            }
+        }
         return this.config.agent.agentName.trim().length > 0
             && content.toLowerCase().includes(this.config.agent.agentName.toLowerCase());
     }

package/dist/chat/sdk-chat-control-plane.js

@@ -65,6 +65,7 @@ export function mapInboundToChannelMessage(event) {
         sender_id: event.message?.authorId ?? event.reaction?.userId,
         content: event.message?.body,
         body: event.message?.body,
+        mentions: event.message?.mentions,
         content_type: event.message?.contentType,
         created_at: event.createdAt,
     };

package/dist/cli-args.js

@@ -52,17 +52,17 @@ export function parseStartArgs(argv) {
         throw new CliUsageError(`Unexpected argument: ${extra[0]}`);
     return { serverUrl, apiKey, env };
 }
-export const USAGE = `Usage: agents-host start <serverUrl> <apiKey> [options]
-
-Options:
-  --name <name>                 Display name (default: Assistant)
-  --provider <claude|copilot>   Runtime provider (default: claude)
-  --claude-command <cmd>        Local Claude CLI command (default: claude)
-  --claude-args <args>          Local Claude CLI args (default: --print)
-  --copilot-command <cmd>       Local Copilot CLI command (default: copilot)
-  --copilot-args <args>         Local Copilot CLI args
-  --mention-only <true|false>   Reply only when @mentioned outside DMs (default: true)
-
-Example:
-  agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot
+export const USAGE = `Usage: agents-host start <serverUrl> <apiKey> [options]
+
+Options:
+  --name <name>                 Display name (default: Assistant)
+  --provider <claude|copilot>   Runtime provider (default: claude)
+  --claude-command <cmd>        Local Claude CLI command (default: claude)
+  --claude-args <args>          Local Claude CLI args (default: --print)
+  --copilot-command <cmd>       Local Copilot CLI command (default: copilot)
+  --copilot-args <args>         Local Copilot CLI args
+  --mention-only <true|false>   Reply only when @mentioned outside DMs (default: true)
+
+Example:
+  agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot
 `;

package/dist/providers/claude/cli-client.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { spawn } from 'node:child_process';
+import spawn from 'cross-spawn';
 /**
  * CLI client for the Claude Code CLI (`claude`) non-interactive mode, with
  * native per-channel session continuity.

package/dist/providers/copilot/cli-client.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { spawn } from 'node:child_process';
+import spawn from 'cross-spawn';
 /**
  * CLI client for the GitHub Copilot CLI (`copilot`) non-interactive mode,
  * with native per-channel session continuity.

package/dist/types.d.ts

@@ -34,6 +34,7 @@ export interface ChannelMessageEvent {
     body?: string;
     content_type?: string;
     created_at?: number;
+    mentions?: string[];
     [key: string]: unknown;
 }
 export interface MeResponseUser {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@borgee/agents-host",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -21,25 +21,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@borgee/plugin-sdk": "0.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.3.0",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.5"
-  },
-  "scripts": {
-    "predev": "pnpm --filter @borgee/plugin-sdk build",
-    "dev": "tsx src/index.ts",
-    "precli": "pnpm --filter @borgee/plugin-sdk build",
-    "cli": "tsx src/cli.ts",
-    "prestart": "pnpm --filter @borgee/plugin-sdk build",
-    "start": "node dist/index.js",
-    "prebuild": "pnpm --filter @borgee/plugin-sdk build",
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "pretest": "pnpm --filter @borgee/plugin-sdk build",
-    "test": "vitest run"
+    "@borgee/plugin-sdk": "0.1.0",
+    "cross-spawn": "^7.0.6"
   }
-}
+}