@borgee/agents-host 0.2.1 → 0.2.26

package/dist/chat/chat-control-plane.d.ts

@@ -1,10 +1,21 @@
-import type { ChannelMessageEvent, MeResponseUser, PostedMessage } from '../types.js';
+import type { ChannelSummary, ChannelHistoryEntry, ChannelMessageEvent, CreateTaskInput, DirectoryUser, MeResponseUser, PostMessageInput, PostedMessage, ReadChannelHistoryInput, Task, UpdateTaskInput } from '../types.js';
 export interface ChatControlPlane {
-    connect(onMessage: (message: ChannelMessageEvent) => void | Promise<void>): Promise<void>;
+    connect(onMessage: (message: ChannelMessageEvent) => void): Promise<void>;
     close(): Promise<void>;
-    postMessage(channelId: string, content: string): Promise<PostedMessage>;
+    postMessage(input: PostMessageInput): Promise<PostedMessage>;
     editMessage(messageId: string, content: string): Promise<void>;
     deleteMessage(messageId: string): Promise<void>;
     startTyping(channelId: string): () => void;
     getMe(): Promise<MeResponseUser>;
+    listUsers(): Promise<DirectoryUser[]>;
+    listChannels(): Promise<ChannelSummary[]>;
+    readChannelHistory(input: ReadChannelHistoryInput): Promise<ChannelHistoryEntry[]>;
+    createTask(input: CreateTaskInput): Promise<Task>;
+    listTasks(input: {
+        channelId: string;
+    }): Promise<Task[]>;
+    getTask(input: {
+        taskId: string;
+    }): Promise<Task>;
+    updateTask(input: UpdateTaskInput): Promise<Task>;
 }

package/dist/chat/sdk-chat-control-plane.d.ts

@@ -1,7 +1,7 @@
 import { type BorgeePluginClient, type BorgeePluginOptions, type InboundMessageEvent } from '@borgee/plugin-sdk';
-import type { ChannelMessageEvent, MeResponseUser, PostedMessage } from '../types.js';
+import type { ChannelSummary, ChannelHistoryEntry, ChannelMessageEvent, CreateTaskInput, DirectoryUser, MeResponseUser, PostMessageInput, PostedMessage, ReadChannelHistoryInput, Task, UpdateTaskInput } from '../types.js';
 import type { ChatControlPlane } from './chat-control-plane.js';
-type PluginClientLike = Pick<BorgeePluginClient, 'agentId' | 'close' | 'connect' | 'deleteMessage' | 'editMessage' | 'getMe' | 'on' | 'sendMessage' | 'startTyping'>;
+type PluginClientLike = Pick<BorgeePluginClient, 'agentId' | 'close' | 'connect' | 'createTask' | 'deleteMessage' | 'editMessage' | 'getMe' | 'getTask' | 'listChannels' | 'listTasks' | 'listUsers' | 'on' | 'readHistory' | 'sendMessage' | 'startTyping' | 'updateTask'>;
 type PluginClientFactory = (options: BorgeePluginOptions) => PluginClientLike;
 type SdkChatControlPlaneOptions = Pick<BorgeePluginOptions, 'cursorStore' | 'pluginId'>;
 /**
@@ -11,17 +11,29 @@ type SdkChatControlPlaneOptions = Pick<BorgeePluginOptions, 'cursorStore' | 'plu
  */
 export declare class SdkChatControlPlane implements ChatControlPlane {
     private readonly client;
+    private pendingMessages;
     private unsubscribe;
     private connected;
     private me;
     constructor(baseUrl: string, apiKey: string, createClient?: PluginClientFactory, options?: SdkChatControlPlaneOptions);
-    connect(onMessage: (message: ChannelMessageEvent) => void | Promise<void>): Promise<void>;
+    connect(onMessage: (message: ChannelMessageEvent) => void): Promise<void>;
     close(): Promise<void>;
-    postMessage(channelId: string, content: string): Promise<PostedMessage>;
+    postMessage(input: PostMessageInput): Promise<PostedMessage>;
     editMessage(messageId: string, content: string): Promise<void>;
     deleteMessage(messageId: string): Promise<void>;
     startTyping(channelId: string): () => void;
     getMe(): Promise<MeResponseUser>;
+    listUsers(): Promise<DirectoryUser[]>;
+    readChannelHistory(input: ReadChannelHistoryInput): Promise<ChannelHistoryEntry[]>;
+    listChannels(): Promise<ChannelSummary[]>;
+    createTask(input: CreateTaskInput): Promise<Task>;
+    listTasks(input: {
+        channelId: string;
+    }): Promise<Task[]>;
+    getTask(input: {
+        taskId: string;
+    }): Promise<Task>;
+    updateTask(input: UpdateTaskInput): Promise<Task>;
 }
 export declare function mapInboundToChannelMessage(event: InboundMessageEvent): ChannelMessageEvent;
 export {};

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

@@ -6,6 +6,7 @@ import { createBorgeePlugin, } from '@borgee/plugin-sdk';
  */
 export class SdkChatControlPlane {
     client;
+    pendingMessages = [];
     unsubscribe = null;
     connected = false;
     me = null;
@@ -13,34 +14,45 @@ export class SdkChatControlPlane {
         this.client = createClient({ baseUrl, apiKey, ...options });
     }
     async connect(onMessage) {
-        this.unsubscribe = this.client.on('message', async (event) => {
-            await onMessage(mapInboundToChannelMessage(event));
+        this.unsubscribe = this.client.on('message', (event) => {
+            const message = mapInboundToChannelMessage(event);
+            if (!this.connected) {
+                this.pendingMessages.push(message);
+                return;
+            }
+            onMessage(message);
         });
         try {
-            // The SDK resolves connect after session.resume_ack, before every replay
-            // frame necessarily runs. Mark the consumer ready first so replay ACKs
-            // wait for the real handler instead of acknowledging an in-memory buffer.
-            this.connected = true;
             await this.client.connect();
+            this.connected = true;
             if (this.client.agentId) {
                 this.me = { id: this.client.agentId };
             }
+            for (const message of this.pendingMessages) {
+                onMessage(message);
+            }
+            this.pendingMessages = [];
         }
         catch (error) {
-            this.connected = false;
             this.unsubscribe?.();
             this.unsubscribe = null;
+            this.pendingMessages = [];
             throw error;
         }
     }
     async close() {
         this.connected = false;
+        this.pendingMessages = [];
         this.unsubscribe?.();
         this.unsubscribe = null;
         await this.client.close();
     }
-    async postMessage(channelId, content) {
-        const sent = await this.client.sendMessage({ channelId, body: content });
+    async postMessage(input) {
+        const sent = await this.client.sendMessage({
+            channelId: input.channelId,
+            body: input.body,
+            replyToId: input.replyToId,
+        });
         return { messageId: sent.messageId };
     }
     async editMessage(messageId, content) {
@@ -64,10 +76,58 @@ export class SdkChatControlPlane {
         };
         return this.me;
     }
+    async listUsers() {
+        const users = await this.client.listUsers();
+        return users.map((user) => ({
+            id: user.id,
+            display_name: user.displayName,
+            kind: user.kind,
+        }));
+    }
+    async readChannelHistory(input) {
+        const messages = await this.client.readHistory({
+            channelId: input.channelId,
+            before: input.before,
+            after: input.after,
+            limit: input.limit,
+        });
+        return messages.map((message) => ({
+            id: message.id,
+            channelId: message.channelId,
+            authorId: message.authorId,
+            body: message.body,
+            contentType: message.contentType,
+            type: message.type,
+            replyToId: message.replyToId,
+            createdAt: message.createdAt,
+            editedAt: message.editedAt,
+        }));
+    }
+    async listChannels() {
+        const channels = await this.client.listChannels();
+        return channels.map((channel) => ({
+            id: channel.id,
+            name: channel.name,
+            kind: channel.kind,
+        }));
+    }
+    async createTask(input) {
+        return this.client.createTask(input);
+    }
+    async listTasks(input) {
+        return this.client.listTasks(input);
+    }
+    async getTask(input) {
+        return this.client.getTask(input);
+    }
+    async updateTask(input) {
+        return this.client.updateTask(input);
+    }
 }
 export function mapInboundToChannelMessage(event) {
     return {
         type: event.kind,
+        ...(event.message?.type != null ? { message_type: event.message.type } : {}),
         channel_id: event.channelId,
         channel_type: event.channelType,
         message_id: event.message?.id ?? event.messageId,

package/dist/cli-args.d.ts

@@ -1,8 +1,9 @@
 /**
- * Maps single-agent `agents-host start` CLI flags to the env vars `config.ts`
- * reads. Keeping this as a plain lookup table (rather than duplicating
- * `loadConfigFromEnv`'s parsing logic) means the CLI and the env-var entry
- * point (`index.ts`) always agree on defaults/validation.
+ * Maps `agents-host start` / `agents-host start-managed` agent flags to the env
+ * vars `config.ts` reads. Keeping this as a plain lookup table (rather than
+ * duplicating `loadConfigFromEnv`'s parsing logic) means the CLI and the
+ * standalone env-var entry point (`index.ts`) always agree on
+ * defaults/validation.
  */
 export declare const CLI_FLAG_TO_ENV: Record<string, string>;
 export type ParsedStartArgs = ParsedSingleAgentStartArgs | ParsedLocalConfigStartArgs;
@@ -10,11 +11,18 @@ export interface ParsedSingleAgentStartArgs {
     mode: 'single-agent';
     serverUrl: string;
     apiKey: string;
+    debug: boolean;
+    env: Record<string, string>;
+}
+export interface ParsedManagedStartArgs {
+    serverUrl: string;
+    apiKey?: string;
     env: Record<string, string>;
 }
 export interface ParsedLocalConfigStartArgs {
     mode: 'local-config';
     configPath: string;
+    debug: boolean;
 }
 export interface ParsedValidateArgs {
     configPath: string;
@@ -35,11 +43,44 @@ export interface ParsedGenerateConfigFromStdinArgs {
     input: 'stdin';
 }
 export type ParsedGenerateConfigArgs = ParsedGenerateConfigFromArgvArgs | ParsedGenerateConfigFromStdinArgs;
+export interface ParsedDaemonArgs {
+    rootPath: string;
+    debug: boolean;
+}
+export interface ParsedLogArgs {
+    serverUrl: string;
+    lines: number;
+    follow: boolean;
+    pathOnly: boolean;
+}
+export interface ParsedDescribeManagedArgs {
+    serverUrl: string;
+}
+export interface ParsedCleanupManagedArgs {
+    serverUrl: string;
+    purge: boolean;
+}
+export interface ParsedApplyManagedFromArgvArgs {
+    serverUrl: string;
+    input: 'argv';
+    specJson: string;
+}
+export interface ParsedApplyManagedFromStdinArgs {
+    serverUrl: string;
+    input: 'stdin';
+}
+export type ParsedApplyManagedArgs = ParsedApplyManagedFromArgvArgs | ParsedApplyManagedFromStdinArgs;
 export declare class CliUsageError extends Error {
 }
 export declare function parseStartArgs(argv: string[]): ParsedStartArgs;
+export declare function parseManagedStartArgs(argv: string[]): ParsedManagedStartArgs;
 export declare function parseValidateArgs(argv: string[]): ParsedValidateArgs;
 export declare function parseDescribeArgs(argv: string[]): ParsedDescribeArgs;
 export declare function parsePrintLayoutArgs(argv: string[]): ParsedPrintLayoutArgs;
 export declare function parseGenerateConfigArgs(argv: string[]): ParsedGenerateConfigArgs;
-export declare const USAGE = "Usage:\n  agents-host start <serverUrl> <apiKey> [options]\n  agents-host start --config <path-to-host-config>\n  agents-host validate --config <path-to-host-config>\n  agents-host describe --config <path-to-host-config>\n  agents-host print-layout --root <dir>\n  agents-host generate-config --root <dir> --stdin\n  agents-host generate-config --root <dir> --spec-json <json>\n\nSingle-agent options:\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>           Ignored by the Copilot ACP prototype\n  --copilot-session-ttl-minutes <minutes>\n                                   Idle session TTL for Copilot ACP sessions (default: 2880)\n\nLocal-config mode:\n  start --config <path>           Start agents + supervisor + watchers from a host config file\n  validate --config <path>        Validate local-config files without starting agents or watchers\n  describe --config <path>        Print the current managed full-set spec as JSON\n  print-layout --root <dir>       Print the canonical default local-config layout as JSON\n  generate-config --root <dir> --stdin  Materialize canonical local-config files from stdin\n  generate-config --root <dir> --spec-json <json>\n                                   Compatibility input; JSON is exposed in process arguments\n\nExamples:\n  agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot\n  agents-host start --config ./agents-host.yaml\n  agents-host validate --config ./agents-host.yaml\n  agents-host describe --config ./agents-host.yaml\n  agents-host print-layout --root ./runtime-root\n  printf '%s' '{\"host\":{\"borgeeBaseUrl\":\"https://borgee.example.com\"},\"agents\":[{\"key\":\"cp1\",\"name\":\"Copilot\",\"apiKey\":\"bgr_xxx\",\"provider\":\"copilot\"}]}' | agents-host generate-config --root ./runtime-root --stdin\n";
+export declare function parseDaemonArgs(argv: string[]): ParsedDaemonArgs;
+export declare function parseLogArgs(argv: string[]): ParsedLogArgs;
+export declare function parseDescribeManagedArgs(argv: string[]): ParsedDescribeManagedArgs;
+export declare function parseCleanupManagedArgs(argv: string[]): ParsedCleanupManagedArgs;
+export declare function parseApplyManagedArgs(argv: string[]): ParsedApplyManagedArgs;
+export declare const USAGE = "Usage:\n  agents-host start <serverUrl> <apiKey> [options]\n  agents-host start-managed <serverUrl>\n  agents-host start-managed <serverUrl> <apiKey> [agent-options]\n  agents-host describe-managed <serverUrl>\n  agents-host cleanup-managed <serverUrl> [--purge]\n  agents-host apply-managed <serverUrl> --stdin\n  agents-host apply-managed <serverUrl> --spec-json <json>\n  agents-host log <serverUrl> [--lines <n>] [--follow]\n  agents-host log <serverUrl> --path\n  agents-host start --config <path-to-host-config> [--debug]\n  agents-host validate --config <path-to-host-config>\n  agents-host describe --config <path-to-host-config>\n  agents-host print-layout --root <dir>\n  agents-host generate-config --root <dir> --stdin\n  agents-host generate-config --root <dir> --spec-json <json>\n\nForeground start options:\n  --debug                         Enable host/provider debug logs (or set AGENTS_HOST_DEBUG=1)\n\nSingle-agent agent options:\n  --name <name>                   Display name (default: Assistant)\n  --provider <claude|codex|copilot>\n                                   Runtime provider (default: claude)\n  --claude-command <cmd>          Local Claude CLI command (default: claude)\n  --claude-args <args>            Local Claude CLI args (default: --print --permission-mode bypassPermissions)\n  --codex-command <cmd>           Local Codex ACP adapter command (default: codex-acp)\n  --codex-args <args>             Local Codex ACP adapter args\n  --copilot-command <cmd>         Local Copilot CLI command (default: copilot)\n  --copilot-args <args>           Ignored by the Copilot ACP prototype\n  --copilot-session-ttl-minutes <minutes>\n                                   Idle session TTL for Copilot ACP sessions (default: 2880)\n\nCommand summary:\n  start <serverUrl> <apiKey>      Start one foreground hosted agent (legacy-compatible behavior)\n  start --config <path>           Start agents + supervisor + watchers from a host config file\n  start-managed <serverUrl>       Restart or resume an existing per-serverUrl managed daemon\n  start-managed <serverUrl> <apiKey>\n                                   Upsert one agent into the per-serverUrl local daemon and exit after reconcile\n  describe-managed <serverUrl>    Print managed-runtime spec JSON for machine callers\n  cleanup-managed <serverUrl>     Stop one managed-runtime daemon locally; --purge also removes its runtime root\n  apply-managed <serverUrl>       Apply one managed-runtime full-set spec for machine callers\n  log <serverUrl>                 Print the managed daemon log tail for one server runtime\n  validate --config <path>        Validate local-config files without starting agents or watchers\n  describe --config <path>        Print the current managed full-set spec as JSON\n  print-layout --root <dir>       Print the canonical default local-config layout as JSON\n  generate-config --root <dir> --stdin  Materialize canonical local-config files from stdin\n  generate-config --root <dir> --spec-json <json>\n                                   Compatibility input; JSON is exposed in process arguments\n\nExamples:\n  agents-host start https://borgee.example.com bgr_xxxxxxxx --provider copilot --debug\n  agents-host start-managed https://borgee.example.com\n  agents-host start-managed https://borgee.example.com bgr_xxxxxxxx --provider copilot\n  agents-host describe-managed https://borgee.example.com\n  agents-host cleanup-managed https://borgee.example.com --purge\n  printf '%s' '{\"host\":{\"borgeeBaseUrl\":\"https://borgee.example.com\"},\"agents\":[{\"key\":\"cp1\",\"name\":\"Copilot\",\"apiKey\":\"bgr_xxx\",\"provider\":\"copilot\"}]}' | agents-host apply-managed https://borgee.example.com --stdin\n  agents-host log https://borgee.example.com --lines 200 --follow\n  agents-host log https://borgee.example.com --path\n  agents-host start --config ./agents-host.yaml --debug\n  agents-host validate --config ./agents-host.yaml\n  agents-host describe --config ./agents-host.yaml\n  agents-host print-layout --root ./runtime-root\n  printf '%s' '{\"host\":{\"borgeeBaseUrl\":\"https://borgee.example.com\"},\"agents\":[{\"key\":\"cp1\",\"name\":\"Copilot\",\"apiKey\":\"bgr_xxx\",\"provider\":\"copilot\"}]}' | agents-host generate-config --root ./runtime-root --stdin\n";