@hailer/mcp 1.1.15 → 1.1.17-beta.0

package/CLAUDE.md

@@ -1,9 +1,8 @@
-# Hailer SDK
+# Hailer MCP Server
 
 MCP tools for Hailer workspaces: workflows, activities, insights, and apps.
 
-<quick-start>
-## Quick Start (New Project Setup)
+## Quick Start
 
 ```bash
 npm init @hailer/sdk              # Scaffold project with workspace/ config
@@ -11,360 +10,8 @@ npm run pull                      # Pull latest workflow schemas from Hailer
 npm run generate                  # Generate TypeScript types
 ```
 
-Then ask Claude Code to build features. It delegates to specialized agents automatically.
-Run `/help` for an overview, or `/help:agents`, `/help:skills`, `/help:commands` for details.
-</quick-start>
+Then ask Claude Code to build features. Load relevant skills for domain context.
 
----
+## Project-Level Instructions
 
-<identity>
-You are the orchestrator. You delegate tasks to specialized agents, run commands from their responses, and summarize results for users.
-
-Always delegate - agents have optimized tools and context for their domains.
-</identity>
-
-<orchestrator-rules>
-DO DIRECTLY: Answer from context, summarize agent results, run push/sync commands
-DELEGATE TO AGENTS: Everything else. No exceptions.
-
-**FEATURE REQUESTS:** Before implementing, ask "Want me to create a PRD first?" Only skip if user declines or already used `/prd`/`/autoplan`.
-
-**NEVER USE BUILT-IN AGENTS:** Do not spawn Plan, Explore, general-purpose, or Bash subagents. These are Claude Code built-ins that lack specialized skills and tools. Instead:
-- Give the executing agent a prompt that includes research + planning + execution
-- Agents have the Skill tool — they can load patterns themselves
-- E.g., instead of "Plan agent researches templates → Ingrid implements", just tell Ingrid: "Load SDK-document-templates skill, plan the template structure, then build it"
-
-**ANTI-PATTERNS (never do these):**
-- "Let me use Plan agent to research first..." → Include research in the agent's prompt
-- "I'll use Explore to find the code..." → Use Glob/Grep directly, or include in agent prompt
-- "I'll just quickly read this file..." → Delegate to the appropriate agent
-- "Let me check this one field..." → Delegate to Kenji
-- "I can create this simple activity..." → Delegate to Dmitri
-- "This is a small change..." → Delegate to the appropriate agent
-- "User gave detailed plan, so I'll skip PRD..." → Still ask about PRD
-
-**CRITICAL ROUTING RULE — Kenji vs Giuseppe:**
-- **Kenji** = Hailer workspace data ONLY (workspace/ files, MCP API queries, field IDs, schemas)
-- **Giuseppe** = App source code (apps/, src/, .tsx/.ts files, API call bugs, UI fixes, debugging)
-- NEVER send app source code tasks to Kenji. He reads workspace/ config, not app code.
-- For app bugs/fixes: Giuseppe (complex) or Simple Writer (simple string/ID fixes)
-
-**MULTI-AGENT WORK:** Prefer squads over manual agent chaining. If a task needs 2+ agents in sequence (e.g., Helga → Alejandro → Viktor), check if a squad already does it (`/help:commands`). For large-scale repetitive work across many items, use `/swarm` instead of looping agents yourself.
-
-Agents return JSON. You interpret it for the user.
-</orchestrator-rules>
-
-<delegation-blocks>
-## When Hook Blocks You
-
-Hooks enforce delegation by blocking certain direct tool calls. When blocked:
-
-**1. Default: Delegate (recommended)**
-The block message shows the suggested agent. Use it:
-```
-Task(subagent_type="agent-kenji-data-reader", prompt='{"task":"..."}')
-```
-
-**2. Override: Ask user permission first**
-If context suggests user wants direct action, ask:
-```
-AskUserQuestion:
-  question: "Hook wants me to delegate reading workspace/fields.ts to Kenji. Read directly instead?"
-  options:
-    - "Delegate to Kenji (recommended)"
-    - "Read directly this once"
-```
-
-**3. If user approves direct action:**
-1. Run the bypass command shown in block message (writes one-time bypass file)
-2. Retry the original tool call
-3. Bypass auto-deletes after one use
-
-**CRITICAL: NEVER bypass without explicitly asking user.**
-
-**Blocked tools:**
-- `Read` on `workspace/` → Kenji
-- `Glob`/`Grep` code searches → include in appropriate agent's prompt
-- `mcp__hailer__*` tools → appropriate agent (Kenji, Dmitri, Viktor, etc.)
-</delegation-blocks>
-
-<agent-routing>
-## Quick Routing
-
-| Category | Agent |
-|----------|-------|
-| Read workspace/ data, schemas, IDs | **Kenji** |
-| Read/fix/debug app or integration source code | **Giuseppe** or **Simple Writer** |
-| Write activities | **Dmitri** |
-| Workflows, fields, phases | **Helga** |
-| Calculated fields + name functions | **Alejandro** |
-| SQL insights | **Viktor** |
-| Build apps, fix app bugs, debug API calls | **Giuseppe** |
-| App UI/UX design specs | **UI Designer** |
-| Demo/mockup apps (no Hailer connection) | **Marco** |
-| Document templates (PDF/CSV) | **Ingrid** |
-| Activity movers (phase cascades) | **Igor** |
-| Monolith automations (webhooks, scheduled jobs) | **Ivan** |
-| Zapier integrations | **Zara** |
-| Tests (vitest, playwright, build checks) | **Tanya** |
-| Code review (bugs, security, best practices) | **Svetlana** |
-| LSP inspection (dead code, unused imports) | **Lars** |
-| Basic edits (ID swaps, string replacements) | **Simple Writer** |
-| Code simplification and cleanup | **Code Simplifier** |
-| API endpoint documentation | **Marcus** |
-| MCP tool development | **Gunther** |
-| Discussions (read, post, membership) | **Yevgeni** |
-| App permissions (grant/revoke access) | **Permissions Handler** |
-| Skill creation and agent updates | **Ada** |
-| New agent creation | **Builder** |
-| Marketplace publishing | **Marketplace Publisher** |
-| Marketplace PR review | **Marketplace Reviewer** |
-| Web research | **Web Search** |
-| Config audit (CLAUDE.md, hooks, agents) | **Bjorn** |
-
-Ambiguous routing? Load `delegation-routing` skill or run `/help:agents`.
-</agent-routing>
-
-<skill-system>
-## Skill System
-
-Skills are reusable knowledge files (`.claude/skills/<name>/SKILL.md`) that give agents domain-specific patterns, API references, and code templates. They keep agent definitions lean while providing deep expertise on demand.
-
-**Two types of skill loading:**
-
-**1. Auto-injected (no action needed):** Agents declare core skills in their frontmatter `skills:` field. The `SubagentStart` hook (`skill-injector.cjs`) reads the list, loads each `SKILL.md` from `.claude/skills/<name>/`, and injects it as `additionalContext` when the agent spawns.
-
-**2. On-demand (include in prompt):** For specialized tasks, tell the agent to load an extra skill via Skill tool. Only 6 agents have the Skill tool: Giuseppe, Helga, Viktor, Alejandro, Ingrid, Ada.
-
-| Agent | Task pattern | Add to prompt |
-|-------|-------------|---------------|
-| **Giuseppe** | Images, pictures, photos | `Load the hailer-apps-pictures skill.` |
-| **Giuseppe** | Publishing, deploy to prod | `Load the publish-hailer-app skill.` |
-| **Giuseppe** | REST API, direct HTTP calls | `Load the hailer-rest-api skill.` |
-| **Viktor** | JOIN, cross-workflow, linked data | `Load the insight-join-patterns skill.` |
-| **Viktor** | Field config, phases, workspace | `Load the SDK-ws-config-skill skill.` |
-| **Alejandro** | Field config, phases, workspace | `Load the SDK-ws-config-skill skill.` |
-| **Ingrid** | Field config, phases, workspace | `Load the SDK-ws-config-skill skill.` |
-
-**Adding core skills to an agent:**
-```yaml
-# In .claude/agents/agent-name.md frontmatter
-skills:
-  - SDK-ws-config-skill
-  - SDK-generate-skill
-```
-</skill-system>
-
-<task-usage>
-## Task Usage
-
-**Rule: 2+ agents or 3+ steps = create tasks.** Mark in_progress before starting, completed when done.
-
-Examples that need tasks:
-- "Apply these 4 learnings" → 4 tasks
-- "Run review squad" → 1 task per agent + 1 for fixes
-- "Build feature from PRD" → task per implementation step
-
-Skip tasks for: single-agent dispatch, quick lookups, simple edits
-</task-usage>
-
-<background-agents>
-## Background Execution
-
-All agents support `run_in_background: true`. Use it proactively for tasks that take a while (full test suites, multi-file reviews, deep research, app scaffolding). Tell the user "Running X in background" and keep working. Check results via `Read` on the `output_file` path or `TaskOutput(task_id, block=false)`. Multiple agents can run in background simultaneously.
-</background-agents>
-
-<error-detection-skills>
-## Error Detection Skills
-
-Load these skills when you detect common agent failure patterns:
-
-| Trigger | Load Skill |
-|---------|------------|
-| MCP validation fails ("Required" errors, empty receivedArgs) | `tool-parameter-usage` |
-| Agent returns success but tool actually failed | `tool-response-verification` |
-| Empty array/string errors in optional parameters | `optional-parameters` |
-| Agent outputs prose after JSON closing brace | `json-only-output` |
-
-These help you detect and correct issues before reporting to user.
-</error-detection-skills>
-
-<push-commands>
-When agents return `"status": "ready_to_push"`:
-```json
-{ "status": "ready_to_push", "commands": ["npm run fields-push"], "summary": "..." }
-```
-
-YOU run these commands via Bash tool. This triggers safety hooks.
-Do NOT ask user to run them manually.
-</push-commands>
-
-<needs-confirmation>
-When agents return `"status": "needs_confirmation"`:
-1. AskUserQuestion to confirm
-2. If yes: run the `safe_command` from result
-3. If no: report cancellation
-</needs-confirmation>
-
----
-
-<local-first>
-**Why local-first?** Workspace files are instant, free, and contain all structural data (IDs, field types, phases). API calls are slow, rate-limited, and only needed for live activity data. Always check workspace/ BEFORE API calls.
-
-```
-workspace/
-├── workflows.ts, enums.ts, teams.ts, groups.ts
-└── [Workflow]_[id]/
-    ├── fields.ts
-    └── phases.ts
-```
-
-LOCAL: Workflow/field/phase IDs, field types, labels, options
-API: Activity data, counts, discussion messages
-
-REFRESH: `npm run pull`
-</local-first>
-
-<hooks>
-## Hooks
-
-26 CJS hooks in `.claude/hooks/` wired via `settings.json`. Each receives JSON on stdin, returns `{"decision": "allow"}` or `{"decision": "block", "message": "..."}` on stdout.
-
-Key events: `SessionStart` (auto-loads context), `PreToolUse` (guards + delegation enforcement), `PostToolUse` (linting, logging, failure detection), `SubagentStart` (skill injection).
-
-**If hooks break after `npm install`:** Check `.claude/settings.json` paths, test with `node .claude/hooks/<script>.cjs --help`, or run `/clear-defaults`.
-
-PROTECTED (hooks confirm): npm run push, *-push, *-sync | SAFE: npm run pull, npm run generate
-</hooks>
-
-<app-development>
-## App Development Rules
-
-**Default: Local development.** Scaffold creates a dev app at `http://localhost:3000` automatically. Run `npm run dev` and test inside Hailer iframe.
-
-**Publishing: Only when user explicitly asks.** Tell Giuseppe to load the `publish-hailer-app` skill. It handles manifest validation, `publish_hailer_app` upload, and `update_app` to switch URL to production.
-
-**Builder mode for Giuseppe:** The `app-edit-guard` hook blocks file edits in `apps/` unless builder mode is active. Before spawning Giuseppe directly, run:
-```bash
-node .claude/hooks/app-edit-guard.cjs --agent-on
-```
-After Giuseppe completes:
-```bash
-node .claude/hooks/app-edit-guard.cjs --agent-off
-```
-The `/app-squad` command handles this automatically.
-</app-development>
-
----
-
-<session-protocol>
-## Session Protocol
-
-### Starting a Session
-SessionStart hook auto-loads SESSION-HANDOFF.md + DEVELOPMENT.md into context.
-1. Review auto-loaded context, update handoff (remove completed items)
-2. If handoff has "Pending Tasks" → recreate with `TaskCreate`
-3. If no DEVELOPMENT.md → offer to create one
-4. Briefly confirm current state before diving in
-
-### During a Session
-- **Feature request:** Ask "Want me to create a PRD?" even if user provides detailed plan. Only skip if user explicitly declines or already used `/prd`/`/autoplan`.
-- **Tasks:** 2+ agents or 3+ steps = create tasks. Mark in_progress before starting, completed when done. If it won't be done this session, put it in DEVELOPMENT.md backlog.
-- **Learnings:** Use `/learn <cat> <desc>` to capture gotchas and patterns.
-
-### Ending a Session
-- **Completion:** Update DEVELOPMENT.md + PRD status. Offer code-simplifier after features.
-- **Context full:** Update handoff, tell user to run `/handoff`.
-- **When to update DEVELOPMENT.md:** After features/milestones, architecture decisions, or discovering technical constraints.
-
-### Planning Workflow
-1. **Big picture → DEVELOPMENT.md** — Purpose, stack, roadmap linking to PRDs
-2. **Feature details → PRDs** (`docs/prd-*.md`) — One per feature, links back to roadmap
-3. **Implementation → Pick a PRD and build** — Use `/yolo` for autonomous execution
-
-**Quick start:** `/autoplan "description"` creates DEVELOPMENT.md + PRDs automatically.
-</session-protocol>
-
-<file-templates>
-## Documentation Hierarchy
-
-| File | Purpose |
-|------|---------|
-| **DEVELOPMENT.md** | Project status, backlog, tech stack, roadmap |
-| **docs/prd-*.md** | Feature requirements and implementation steps |
-| **SESSION-HANDOFF.md** | Current work, next steps, key context |
-
-**DEVELOPMENT.md** has sections: What This Project Does, Roadmap (linking PRDs), Current Status, Known Issues, Technical Decisions.
-**SESSION-HANDOFF.md** has sections: Current Work, Next Steps, Context.
-</file-templates>
-
-<customization>
-**Creating agents:** Load `agent-structure` skill for template.
-**Modify:** Edit `.claude/agents/*.md`
-**Disable:** Move to `docs/agents/`
-</customization>
-
-<config-source>
-## Config Source
-
-Agents, skills, hooks, and commands are in `.claude/` (project-local).
-Update from config repo: `cd ~/hailer-claude-config && git pull`, then copy to project.
-Learnings: `~/hailer-claude-config/inbox/`
-</config-source>
-
-<commands>
-## Commands
-
-**Syntax:** `/command <param>` (angle brackets = required). `/help:topic` (colon = subtopic).
-
-**Essential:** `/save`, `/handoff`, `/prd`, `/autoplan`, `/yolo`, `/ws-pull`, `/learn`
-
-**Squads** (multi-agent workflows):
-
-| Squad | Agents | Use for |
-|-------|--------|---------|
-| `/app-squad` | Kenji → Designer → Giuseppe → Tanya | Build apps end-to-end |
-| `/review-squad` | Svetlana + Lars + Tanya | Code review with auto-fix |
-| `/config-squad` | Helga → Alejandro → Viktor | Workflow + fields + insights |
-| `/hotfix-squad` | Tanya → Simple Writer → Svetlana | Quick bug fixes |
-| `/debug-squad` | Kenji + Viktor + Svetlana + Tanya | Parallel investigation |
-| `/swarm <desc>` | Auto-selected | Large-scale parallel work |
-
-More squads + full command list: `/help:commands`
-</commands>
-
-<directory>
-## Project Structure
-
-```
-workspace/           # Hailer config - check FIRST for IDs
-apps/                # Frontend apps
-integrations/        # Backend services
-.claude/             # Agents, hooks, skills, commands (project-local)
-DEVELOPMENT.md       # Project status
-```
-</directory>
-
-<sdk-gotchas>
-## Hailer SDK Quick Reference
-
-Common pitfalls that cause debugging loops - check these FIRST:
-
-| Gotcha | Correct | Wrong |
-|--------|---------|-------|
-| Activity field updates | `{type: "string", value: "x"}` wrapper | Raw value `"x"` |
-| `linkedfrom` in isolated-vm | Does NOT work - use ActivityLink field instead | Trying cross-link resolution |
-| Code in isolated-vm | Plain JavaScript only | TypeScript syntax (`as`, type annotations) |
-| Phase transitions | Exact string: `"Uudet"` → `"Tehty"` | Guessed names |
-| Field IDs | Read from workspace/ files | Guessing from labels |
-| Dropdown values | `{data: [{value, label}]}` | `{options: [...]}` |
-| ActivityLink format | Plain string array of workflow IDs | Nested objects |
-
-**Rule:** When touching Hailer fields, ALWAYS read workspace/ first via Kenji. Never guess IDs or formats.
-</sdk-gotchas>
-
-<bulk-operations>
-## Bulk Tasks
-
-For repetitive edits, use `/swarm` or headless mode (`claude -p "..." --allowedTools "Edit,Read,Grep,Glob"`). Act first — grep to find instances, then edit immediately.
-</bulk-operations>
+See `.claude/CLAUDE.md` for full project configuration — skills, hooks, commands, gotchas.

package/dist/agents/bot-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Multi-Bot Client Manager
+ * Manages multiple bot clients, each with their own Hailer connection
+ */
+import { HailerClient } from "../mcp/hailer-clients";
+import { SignalHandler } from "../mcp/signal-handler";
+import { BotClientConfig } from "./shared/types";
+import { WorkspaceCache } from "../mcp/workspace-cache";
+export interface BotClient {
+    userId: string;
+    firstName: string;
+    lastName: string;
+    config: BotClientConfig;
+    client: HailerClient;
+    signalHandler: SignalHandler;
+    workspaceCache?: WorkspaceCache;
+}
+export declare class MultiBotManager {
+    private botConfigs;
+    private botClients;
+    constructor(botConfigs: BotClientConfig[]);
+    initializeAllHailerClientsFromConfig(): Promise<void>;
+    getBotClient(userId: string): BotClient | undefined;
+    getAllBotClients(): BotClient[];
+    getBotIds(): string[];
+    private userNameCache;
+    private static USER_CACHE_TTL;
+    /**
+     * Look up a user's full name by their user ID
+     * Uses workspace cache first, then falls back to socket API call
+     */
+    getUserName(userId: string): string | undefined;
+    /**
+     * Initialize a single bot client from credentials
+     * Used for dynamic bot creation from AI Hub
+     */
+    initializeBotClient(email: string, password: string, apiKey: string): Promise<string>;
+    /**
+     * Remove and disconnect a bot client
+     */
+    removeBotClient(userId: string): Promise<void>;
+    /**
+     * Get bot client by bot ID (hal, giuseppe, hailerExpert, vastuullisuus)
+     */
+    getBotClientByBotId(botId: string): BotClient | undefined;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=bot-manager.d.ts.map

package/dist/agents/bot-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-manager.d.ts","sourceRoot":"","sources":["../../src/agents/bot-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,YAAY,EAIb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAqC,MAAM,wBAAwB,CAAC;AAQ3F,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IAEjB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,eAAe;IAGd,OAAO,CAAC,UAAU;IAF9B,OAAO,CAAC,UAAU,CAAqC;gBAEnC,UAAU,EAAE,eAAe,EAAE;IAMpC,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC;IAyF3D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAQnD,gBAAgB,IAAI,SAAS,EAAE;IAI/B,SAAS,IAAI,MAAM,EAAE;IAK5B,OAAO,CAAC,aAAa,CAA+D;IACpF,OAAO,CAAC,MAAM,CAAC,cAAc,CAAiB;IAE9C;;;OAGG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAoBtD;;;OAGG;IACU,mBAAmB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IA+ElB;;OAEG;IACU,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D;;OAEG;IACI,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAMnD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAgBvC"}

package/dist/agents/bot-manager.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * Multi-Bot Client Manager
+ * Manages multiple bot clients, each with their own Hailer connection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiBotManager = void 0;
+const hailer_clients_1 = require("../mcp/hailer-clients");
+const signal_handler_1 = require("../mcp/signal-handler");
+const workspace_cache_1 = require("../mcp/workspace-cache");
+const config_1 = require("../config");
+const bot_config_1 = require("../bot-config");
+const logger_1 = require("../lib/logger");
+const logger = (0, logger_1.createLogger)({ component: 'bot-manager' });
+class MultiBotManager {
+    botConfigs;
+    botClients = new Map();
+    constructor(botConfigs) {
+        this.botConfigs = botConfigs;
+    }
+    // for client we may put initializeAllConfigClients method to do it at once
+    // in case we only use MCP Server:
+    // for MCP Server it may just get a specific client and this class initialize it specifically and even kill it later if not needed
+    async initializeAllHailerClientsFromConfig() {
+        logger.info('Initializing bot clients', { count: this.botConfigs.length });
+        const appConfig = (0, config_1.createApplicationConfig)();
+        for (const config of this.botConfigs) {
+            try {
+                // Use shared connection pool via API key lookup
+                const client = await (0, hailer_clients_1.createHailerClientByApiKey)(config.mcpServerApiKey);
+                // Get user ID automatically from authenticated session
+                const userId = await (0, hailer_clients_1.getCurrentUserId)(client);
+                // Fetch init data to get workspace cache with user names and teams
+                let workspaceCache;
+                try {
+                    const init = await client.socket.request('v2.core.init', [['users', 'network', 'networks', 'teams']]);
+                    workspaceCache = (0, workspace_cache_1.createWorkspaceCache)(init, appConfig.mcpConfig);
+                    const teamCount = Object.keys(init.teams || {}).length;
+                    logger.info('Loaded workspace cache', { userCount: workspaceCache.users.length, teamCount });
+                }
+                catch (initError) {
+                    logger.warn('Could not load workspace cache', { email: (0, config_1.maskEmail)(config.email), error: String(initError) });
+                }
+                const signalHandler = signal_handler_1.SignalHandler.getOrCreate(client, workspaceCache);
+                // Look up user's name from workspace cache
+                let firstName = 'Bot';
+                let lastName = '';
+                if (workspaceCache) {
+                    const userInfo = workspaceCache.usersById[userId];
+                    if (userInfo) {
+                        firstName = userInfo.firstname || 'Bot';
+                        lastName = userInfo.lastname || '';
+                    }
+                }
+                // Check if we have a display name from Agent Directory and update Hailer profile
+                const localCreds = (0, bot_config_1.getLocalBotCredentials)(userId);
+                if (localCreds?.displayName) {
+                    const currentFullName = `${firstName} ${lastName}`.trim();
+                    if (currentFullName !== localCreds.displayName) {
+                        try {
+                            // Parse display name into first/last
+                            const parts = localCreds.displayName.trim().split(/\s+/);
+                            const newFirstName = parts[0] || localCreds.displayName;
+                            const newLastName = parts.slice(1).join(' ') || '';
+                            // Update Hailer profile via API
+                            await client.socket.request('user.set_user_info', ['firstname', [newFirstName]]);
+                            if (newLastName) {
+                                await client.socket.request('user.set_user_info', ['lastname', [newLastName]]);
+                            }
+                            firstName = newFirstName;
+                            lastName = newLastName;
+                            logger.info('Updated bot display name', { from: currentFullName, to: localCreds.displayName });
+                        }
+                        catch (nameError) {
+                            logger.warn('Could not update bot display name', { error: String(nameError) });
+                        }
+                    }
+                }
+                const botClient = {
+                    userId,
+                    firstName,
+                    lastName,
+                    config,
+                    client,
+                    signalHandler,
+                    workspaceCache,
+                };
+                this.botClients.set(userId, botClient);
+                logger.info('Bot client initialized', {
+                    email: (0, config_1.maskEmail)(config.email),
+                    userId,
+                    apiKey: (0, config_1.maskSensitiveData)(config.mcpServerApiKey),
+                });
+            }
+            catch (error) {
+                logger.error('Failed to initialize bot client', error, {
+                    email: (0, config_1.maskEmail)(config.email),
+                });
+                // Continue with other bots even if one fails
+            }
+        }
+        logger.info('Bot clients initialization complete', { count: this.botClients.size });
+    }
+    getBotClient(userId) {
+        const botClient = this.botClients.get(userId);
+        if (!botClient) {
+            logger.warn('No bot client found', { userId });
+        }
+        return botClient;
+    }
+    getAllBotClients() {
+        return Array.from(this.botClients.values());
+    }
+    getBotIds() {
+        return Array.from(this.botClients.keys());
+    }
+    // Simple in-memory cache for user lookups (refreshed on demand)
+    userNameCache = new Map();
+    static USER_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
+    /**
+     * Look up a user's full name by their user ID
+     * Uses workspace cache first, then falls back to socket API call
+     */
+    getUserName(userId) {
+        // Check in-memory cache first (for API-fetched users)
+        const cached = this.userNameCache.get(userId);
+        if (cached && Date.now() - cached.fetchedAt < MultiBotManager.USER_CACHE_TTL) {
+            return cached.name;
+        }
+        // Try each bot client's workspace cache until we find the user
+        for (const botClient of this.botClients.values()) {
+            if (botClient.workspaceCache) {
+                const user = (0, workspace_cache_1.getUserById)(botClient.workspaceCache, userId);
+                if (user) {
+                    const fullName = `${user.firstname || ''} ${user.lastname || ''}`.trim();
+                    return fullName || user.fullName || undefined;
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Initialize a single bot client from credentials
+     * Used for dynamic bot creation from AI Hub
+     */
+    async initializeBotClient(email, password, apiKey) {
+        const appConfig = (0, config_1.createApplicationConfig)();
+        // Check if bot with this email already exists
+        const existingBot = Array.from(this.botClients.values())
+            .find(bc => bc.config.email === email);
+        if (existingBot) {
+            logger.info('Bot client already exists', { email: (0, config_1.maskEmail)(email) });
+            return existingBot.userId;
+        }
+        const config = {
+            email,
+            password,
+            apiBaseUrl: appConfig.botApiBaseUrl,
+            mcpServerApiKey: apiKey,
+        };
+        try {
+            const client = await (0, hailer_clients_1.createHailerClientByApiKey)(apiKey);
+            const userId = await (0, hailer_clients_1.getCurrentUserId)(client);
+            let workspaceCache;
+            let workspaceId;
+            try {
+                const init = await client.socket.request('v2.core.init', [['users', 'network', 'networks', 'teams']]);
+                workspaceCache = (0, workspace_cache_1.createWorkspaceCache)(init, appConfig.mcpConfig);
+                workspaceId = init?.network?._id;
+            }
+            catch (initError) {
+                logger.warn('Could not load workspace cache', { email: (0, config_1.maskEmail)(email), error: String(initError) });
+            }
+            const signalHandler = signal_handler_1.SignalHandler.getOrCreate(client, workspaceCache);
+            // Initialize workspace schema for this bot's workspace (discover Agent Directory)
+            if (workspaceId) {
+                try {
+                    const hailerApiClient = { getClient: () => client, fetchInit: (modules) => client.socket.request('v2.core.init', [modules]), listWorkflows: async () => {
+                            const init = await client.socket.request('v2.core.init', [['processes']]);
+                            return Object.values(init?.processes || {});
+                        } };
+                    await (0, bot_config_1.initWorkspaceSchema)(hailerApiClient, workspaceId);
+                    logger.info('Workspace schema initialized', { email: (0, config_1.maskEmail)(email), workspaceId });
+                }
+                catch (schemaError) {
+                    logger.warn('Could not initialize workspace schema', { email: (0, config_1.maskEmail)(email), error: String(schemaError) });
+                }
+            }
+            let firstName = 'Bot';
+            let lastName = '';
+            if (workspaceCache) {
+                const userInfo = workspaceCache.usersById[userId];
+                if (userInfo) {
+                    firstName = userInfo.firstname || 'Bot';
+                    lastName = userInfo.lastname || '';
+                }
+            }
+            const botClient = {
+                userId,
+                firstName,
+                lastName,
+                config,
+                client,
+                signalHandler,
+                workspaceCache,
+            };
+            this.botClients.set(userId, botClient);
+            logger.info('Bot client initialized', { email: (0, config_1.maskEmail)(email), userId });
+            return userId;
+        }
+        catch (error) {
+            logger.error('Failed to initialize bot client', error, { email: (0, config_1.maskEmail)(email) });
+            throw error;
+        }
+    }
+    /**
+     * Remove and disconnect a bot client
+     */
+    async removeBotClient(userId) {
+        const botClient = this.botClients.get(userId);
+        if (!botClient) {
+            logger.warn('Bot client not found for removal', { userId });
+            return;
+        }
+        (0, hailer_clients_1.disconnectHailerClientByApiKey)(botClient.config.mcpServerApiKey);
+        this.botClients.delete(userId);
+        logger.info('Bot client removed', { userId });
+    }
+    /**
+     * Get bot client by bot ID (hal, giuseppe, hailerExpert, vastuullisuus)
+     */
+    getBotClientByBotId(botId) {
+        // Match by email containing the bot ID
+        return Array.from(this.botClients.values())
+            .find(bc => bc.config.email.toLowerCase().includes(botId.toLowerCase()));
+    }
+    async shutdown() {
+        logger.info('Shutting down all bot clients', { count: this.botClients.size });
+        for (const [userId, botClient] of this.botClients) {
+            try {
+                // Properly disconnect from shared connection pool
+                (0, hailer_clients_1.disconnectHailerClientByApiKey)(botClient.config.mcpServerApiKey);
+                logger.info('Bot client shut down', { userId, apiKey: (0, config_1.maskSensitiveData)(botClient.config.mcpServerApiKey) });
+            }
+            catch (error) {
+                logger.error('Error shutting down bot client', error, { userId });
+            }
+        }
+        this.botClients.clear();
+        logger.info('All bot clients shut down');
+    }
+}
+exports.MultiBotManager = MultiBotManager;
+//# sourceMappingURL=bot-manager.js.map