@hailer/mcp 1.2.1 → 2.0.0-beta.10

package/dist/bot/bot.d.ts

@@ -10,11 +10,28 @@
  */
 import { ToolRegistry } from '../mcp/tool-registry';
 import { ResponseMode } from './services/types';
-import { BotAccessLevel } from '../bot-config';
+import { BotConfig } from '../bot-config';
 /** Minimal interface to avoid circular import with BotManager */
 interface BotManagerRef {
     getBotUserIdsForWorkspace(workspaceId: string): Set<string>;
 }
+/** Runtime deps that aren't part of the bot's persisted config. */
+export interface BotRuntime {
+    anthropicApiKey: string;
+    toolRegistry: ToolRegistry;
+    botManager?: BotManagerRef;
+}
+/**
+ * Thrown by Bot.start() when the bot's own Agent Directory activity has been
+ * deleted in Hailer. BotManager catches this and discards the bot without
+ * adding it to the running set; the entry has already been removed from
+ * .bot-config/{workspaceId}.json by the time this is thrown.
+ */
+export declare class ActivityGoneError extends Error {
+    activityId: string;
+    workspaceId: string;
+    constructor(activityId: string, workspaceId: string);
+}
 export declare class Bot {
     private logger;
     private clientManager;
@@ -46,22 +63,9 @@ export declare class Bot {
     private cacheInvalidateHandler;
     private _connected;
     private config;
+    private anthropicApiKey;
     private botManager;
-    constructor(config: {
-        email: string;
-        password: string;
-        apiHost: string;
-        anthropicApiKey: string;
-        model?: string;
-        toolRegistry: ToolRegistry;
-        workspaceId?: string;
-        systemPrompt?: string;
-        responseMode?: ResponseMode;
-        botManager?: BotManagerRef;
-        accessLevel?: BotAccessLevel;
-        allowedWorkflows?: string[];
-        allowBotMessages?: boolean;
-    });
+    constructor(config: BotConfig, runtime: BotRuntime);
     get email(): string;
     get password(): string;
     get accessLevel(): string;
@@ -70,7 +74,46 @@ export declare class Bot {
     get botUserId(): string;
     updateSystemPrompt(prompt: string | undefined): void;
     updateResponseMode(mode: ResponseMode | undefined): void;
+    updateHelperMode(helperMode: boolean | undefined): void;
     start(): Promise<void>;
+    /**
+   * Re-join the bot's own activity discussion if (and only if) the bot has
+   * drifted out of it. Runs every startup so bots that lost their follow
+   * state (e.g. via the pre-51254a2 raw activities.follow toggle) recover.
+   *
+   * Reads the activity's `followers` list and skips the join when the bot's
+   * userId is already there. activities.follow is a toggle that emits a
+   * leave/join event on every call — even toggle-toggle pairs — so calling
+   * unconditionally pollutes the discussion with "left / joined" pairs on
+   * every restart (visible in the timeline after deploy → retire → deploy).
+   */
+    private ensureFollowingOwnDiscussion;
+    /**
+   * Post a one-time greeting in the bot's own activity discussion explaining
+   * what users can ask the bot to change about itself (system prompt, etc.).
+   * Marks the entry's `introPosted` flag in `.bot-config` so subsequent
+   * restarts don't repeat the message.
+   *
+   * Follow state is handled separately by ensureFollowingOwnDiscussion()
+   * which runs on every startup. We don't flip `introPosted` until the send
+   * succeeds, so a permission failure on first start retries on the next
+   * start instead of silently giving up.
+   */
+    private introduceSelfIfNeeded;
+    /**
+   * Teardown: stop the bot's websocket and live state. We intentionally do
+   * NOT delete the Hailer user account from here — that was previously a
+   * source of mass user-account deletion when the gone-classifier fired on
+   * transient permission errors. Orphaned bot users are reaped out-of-band
+   * by Hailer's inactive-user prune.
+   */
+    destroy(): Promise<void>;
+    /**
+   * Remove this bot's entry from .bot-config/{workspaceId}.json. Called when
+   * the bot's own activity has been deleted in Hailer (detected via the
+   * self-probe in start()). Idempotent — safe if the entry is already gone.
+   */
+    private pruneSelfFromConfig;
     stop(): Promise<void>;
     private handleSignal;
     private processDiscussion;

package/dist/bot/bot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../src/bot/bot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../src/bot/bot.ts"],"names":[],"mappings":"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"}