@borgee/agents-host 0.1.4 → 0.1.5

package/README.md

@@ -2,7 +2,7 @@
 
 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`)
+[`@borgee/plugin-sdk`](../sdk/plugin-ts) — the same BPP (`/ws/plugin`)
 protocol the official OpenClaw plugin uses.
 
 ## What this is (and isn't)
@@ -19,8 +19,8 @@ Borgee channel message
   → 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
+**In scope:** one agent per process, per-channel conversation memory via each
+CLI's own native session resume
 (Claude `--resume`, Copilot `--session-id`), and dispatching to a local CLI
 provider.
 
@@ -51,11 +51,10 @@ pnpm --filter @borgee/agents-host dev
 | --- | --- | --- | --- |
 | `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 |
+| `BORGEE_AGENT_NAME` | no | `Assistant` | Display name used in 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
 

package/dist/agents-host.d.ts

@@ -14,6 +14,10 @@ import type { AgentsHostConfig } from './types.js';
  * node provisioning, multi-agent discovery, systemd install, and scheduled
  * (periodic) prompts. Running several agents means running several
  * processes, each with its own `BORGEE_AGENT_API_KEY`.
+ *
+ * Message gating (mention-only / DM rules) is NOT done here: the server
+ * enforces per-agent + per-channel `require_mention` at BPP fan-out, so this
+ * host simply replies to every message it is handed (minus its own).
  */
 export declare class AgentsHost {
     private readonly config;
@@ -28,20 +32,4 @@ export declare class AgentsHost {
     start(): Promise<void>;
     stop(): Promise<void>;
     private handleMessage;
-    /**
-     * Whether `msg` mentions this agent: either via the SDK's structured
-     * mention event kind, or a plain-text substring match on the configured
-     * agent name.
-     */
-    isLikelyMention(message: {
-        type?: string;
-        mentions?: string[];
-    }, content: string): boolean;
-    /**
-     * Channel-type check, based solely on the `channel_type` hint the SDK
-     * derives from the inbound BPP event. There is no REST fallback here (that
-     * would require the excluded control-plane SDK) — an absent hint is
-     * treated as "not a DM".
-     */
-    private isDirectMessage;
 }

package/dist/agents-host.js

@@ -13,6 +13,10 @@ import { createProvider } from './providers/create-provider.js';
  * node provisioning, multi-agent discovery, systemd install, and scheduled
  * (periodic) prompts. Running several agents means running several
  * processes, each with its own `BORGEE_AGENT_API_KEY`.
+ *
+ * Message gating (mention-only / DM rules) is NOT done here: the server
+ * enforces per-agent + per-channel `require_mention` at BPP fan-out, so this
+ * host simply replies to every message it is handed (minus its own).
  */
 export class AgentsHost {
     config;
@@ -70,11 +74,10 @@ export class AgentsHost {
         const content = String(msg.content ?? msg.body ?? '').trim();
         if (!content)
             return;
-        const isDm = this.isDirectMessage(msg.channel_type);
-        if (this.config.agent.respondOnMentionOnly && !isDm) {
-            if (!this.isLikelyMention(msg, content))
-                return;
-        }
+        // No client-side mention/DM gating here: the server already decides which
+        // messages an agent receives (per-agent + per-channel require_mention is
+        // enforced at BPP fan-out via AgentReceivesChannelMessage). If a channel
+        // message reaches this host at all, the agent is meant to handle it.
         try {
             const reply = await this.provider.generateReply({
                 agentName: this.config.agent.agentName,
@@ -93,30 +96,4 @@ export class AgentsHost {
             });
         }
     }
-    /**
-     * Whether `msg` mentions this agent: either via the SDK's structured
-     * mention event kind, or a plain-text substring match on the configured
-     * agent name.
-     */
-    isLikelyMention(message, content) {
-        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());
-    }
-    /**
-     * Channel-type check, based solely on the `channel_type` hint the SDK
-     * derives from the inbound BPP event. There is no REST fallback here (that
-     * would require the excluded control-plane SDK) — an absent hint is
-     * treated as "not a DM".
-     */
-    isDirectMessage(hintedType) {
-        return hintedType === 'dm';
-    }
 }

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

@@ -65,7 +65,6 @@ 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.d.ts

@@ -19,4 +19,4 @@ export declare class CliUsageError extends Error {
  * process, so callers (and tests) can decide how to report it.
  */
 export declare function parseStartArgs(argv: string[]): ParsedStartArgs;
-export declare const USAGE = "Usage: agents-host start <serverUrl> <apiKey> [options]\n\nOptions:\n  --name <name>                 Display name (default: Assistant)\n  --provider <claude|copilot>   Runtime provider (default: claude)\n  --claude-command <cmd>        Local Claude CLI command (default: claude)\n  --claude-args <args>          Local Claude CLI args (default: --print)\n  --copilot-command <cmd>       Local Copilot CLI command (default: copilot)\n  --copilot-args <args>         Local Copilot CLI args\n  --mention-only <true|false>   Reply only when @mentioned outside DMs (default: true)\n\nExample:\n  agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot\n";
+export declare const USAGE = "Usage: agents-host start <serverUrl> <apiKey> [options]\n\nOptions:\n  --name <name>                 Display name (default: Assistant)\n  --provider <claude|copilot>   Runtime provider (default: claude)\n  --claude-command <cmd>        Local Claude CLI command (default: claude)\n  --claude-args <args>          Local Claude CLI args (default: --print)\n  --copilot-command <cmd>        Local Copilot CLI command (default: copilot)\n  --copilot-args <args>          Local Copilot CLI args\n\nExample:\n  agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot\n";

package/dist/cli-args.js

@@ -11,7 +11,6 @@ export const CLI_FLAG_TO_ENV = {
     'claude-args': 'CLAUDE_ARGS',
     'copilot-command': 'COPILOT_COMMAND',
     'copilot-args': 'COPILOT_ARGS',
-    'mention-only': 'RESPOND_ON_MENTION_ONLY',
 };
 export class CliUsageError extends Error {
 }
@@ -59,9 +58,8 @@ Options:
   --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)
+  --copilot-command <cmd>        Local Copilot CLI command (default: copilot)
+  --copilot-args <args>          Local Copilot CLI args
 
 Example:
   agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot

package/dist/config.js

@@ -9,12 +9,6 @@ function envOr(name, fallback) {
     const value = process.env[name];
     return value && value.trim().length > 0 ? value.trim() : fallback;
 }
-function envBoolOr(name, fallback) {
-    const value = process.env[name];
-    if (value === undefined || value.trim().length === 0)
-        return fallback;
-    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
-}
 function parseArgs(value) {
     return value.trim().length > 0 ? value.trim().split(/\s+/) : [];
 }
@@ -39,7 +33,6 @@ export function loadConfigFromEnv() {
         agent: {
             agentApiKey: requireEnv('BORGEE_AGENT_API_KEY'),
             agentName: envOr('BORGEE_AGENT_NAME', 'Assistant'),
-            respondOnMentionOnly: envBoolOr('RESPOND_ON_MENTION_ONLY', true),
             provider: resolveProvider(),
         },
     };

package/dist/types.d.ts

@@ -16,7 +16,6 @@ export interface ProviderRuntimeConfig extends ProviderCommandConfig {
 export interface HostedAgentConfig {
     agentApiKey: string;
     agentName: string;
-    respondOnMentionOnly: boolean;
     provider: ProviderKind;
 }
 export interface AgentsHostConfig extends ProviderCommandConfig {
@@ -34,7 +33,6 @@ 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.4",
+  "version": "0.1.5",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -17,11 +17,31 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/codetreker/borgee.git",
-    "directory": "packages/runtimes/agents-host"
+    "directory": "packages/agents-host"
   },
   "license": "MIT",
   "dependencies": {
-    "@borgee/plugin-sdk": "0.1.1",
-    "cross-spawn": "^7.0.6"
+    "cross-spawn": "^7.0.6",
+    "@borgee/plugin-sdk": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
+    "@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"
   }
-}
+}