@hailer/mcp 1.2.0 → 2.0.0-beta.1

package/.claude/skills/hailer-ui-guide/SKILL.md

@@ -0,0 +1,265 @@
+---
+name: hailer-ui-guide
+description: Hailer UI structure and navigation guide for AI Helper
+version: 1.0.0
+triggers:
+  - hailer ui
+  - hailer interface
+  - onboarding
+---
+
+# Hailer UI Guide
+
+Complete guide to Hailer's user interface for providing accurate navigation assistance.
+
+<layout>
+## Main Layout Structure
+
+Hailer uses a three-column layout:
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    Top Toolbar (mobile only)            │
+├────────┬────────────────────────────┬───────────────────┤
+│        │                            │                   │
+│  Left  │       Main Content         │     Sidenav       │
+│  Nav   │       (router-outlet)      │    (400px)        │
+│ (56px) │                            │                   │
+│        │                            │                   │
+├────────┴────────────────────────────┴───────────────────┤
+│                 Mobile Navigation (mobile only)         │
+└─────────────────────────────────────────────────────────┘
+```
+
+**Desktop (>600px):**
+- Left sidebar: 56px vertical icon menu
+- Main content: fills remaining space
+- Right sidenav: 400px panel for activity/discussion details
+
+**Mobile (<=600px):**
+- Top toolbar visible
+- Full-screen sidenav (100vw)
+- Bottom navigation bar
+</layout>
+
+<left-nav>
+## Left Navigation Menu
+
+Vertical icon menu on the left side (always visible on desktop).
+
+**Menu items from top to bottom:**
+1. **Discussions** (icon: hailer-discussion) - Chat and team discussions
+2. **Feed** (icon: hailer-feed) - Activity feed and updates
+3. **Calendar** (icon: hailer-calendar) - Events and schedules
+4. **Activities** (icon: hailer-activity) - Workflows and kanban boards
+5. **Apps** (icon: hailer-apps) - Custom applications
+6. **People** (icon: hailer-people) - User directory
+
+**Bottom section:**
+- **Settings** (icon: hailer-settings) - Workspace settings (admins only)
+- **User profile** - Opens user menu with:
+  - Profile settings
+  - Language selection
+  - Dark/light mode toggle
+  - Logout
+
+**Navigation instruction example:**
+"Click the 'Activities' icon in the left menu (4th from top, looks like a kanban board)"
+</left-nav>
+
+<activities-section>
+## Activities Section (Workflows)
+
+When user navigates to `/activities`:
+
+**Workflow List View:**
+- Shows all available workflows as cards
+- Each card shows workflow name and icon
+- Click a workflow to open it
+
+**Workflow View (Kanban):**
+URL: `/activities/{workflowId}`
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  Workflow Name                    [+ Add] [View Toggle] │
+├──────────┬──────────┬──────────┬──────────┬────────────┤
+│  Phase 1 │  Phase 2 │  Phase 3 │  Phase 4 │  Phase 5   │
+│  (New)   │ (Active) │(Review)  │ (Done)   │ (Archive)  │
+├──────────┼──────────┼──────────┼──────────┼────────────┤
+│ [Card]   │ [Card]   │ [Card]   │          │            │
+│ [Card]   │ [Card]   │          │          │            │
+│ [Card]   │          │          │          │            │
+└──────────┴──────────┴──────────┴──────────┴────────────┘
+```
+
+**View modes** (toggle in top-right):
+- **Kanban** - Cards in columns by phase (default)
+- **Table** - List view with sortable columns
+- **Calendar** - Timeline/calendar view
+- **Map** - Location-based view (if enabled)
+
+**Actions:**
+- **Create activity:** Click [+ Add] button top-right, or click empty area in phase column
+- **Open activity:** Click any card to open in sidenav
+- **Move activity:** Drag card to another phase column, OR open card and use phase selector
+- **Filter:** Use search bar or filter controls at top
+</activities-section>
+
+<activity-sidenav>
+## Activity Sidenav (Right Panel)
+
+Opens when user clicks an activity card. Width: 400px on desktop, fullscreen on mobile.
+
+**Header section:**
+- Activity name (large text)
+- Workspace badge (colored tag)
+- Workflow badge (colored tag, clickable - navigates to workflow)
+- Copy tag button (mentions activity in discussions)
+- Call button (if video calls enabled)
+
+**Tab bar** (icons below header):
+1. **Detail** (icon: hailer-activity) - Main fields and info
+2. **Participants** (icon: hailer-group) - Followers with badge count
+3. **Discussion** (icon: hailer-discussion) - Activity chat with unread badge
+4. **Files** (icon: hailer-attach) - Attachments with count badge
+5. **Location** (icon: hailer-location) - Map view (if enabled)
+6. **Linked** (icon: hailer-linked-activity) - Related activities with count
+7. **Options** (icon: hailer-settings) - Activity settings (if permitted)
+
+**Control buttons** (bottom, visible in edit/create mode):
+- **Cancel** - Discard changes
+- **Save** (with checkmark icon) - Save changes
+
+**Modes:**
+- **View mode:** Read-only display of activity
+- **Edit mode:** Fields become editable, Save/Cancel buttons appear
+- **Create mode:** Empty form for new activity
+
+**Instruction examples:**
+- "Click the 'Detail' tab (first icon) to see all fields"
+- "Click the 'Discussion' tab (chat bubble icon) to see comments"
+- "Click 'Save' in the bottom right to save your changes"
+</activity-sidenav>
+
+<phase-transitions>
+## Moving Activities Between Phases
+
+**Method 1: Drag and Drop (Kanban view)**
+"Drag the card from the '{current phase}' column and drop it in the '{target phase}' column"
+
+**Method 2: Phase Selector (in activity sidenav)**
+"Open the activity, click the phase dropdown near the top, and select '{target phase}'"
+
+**Phase order:**
+Phases are displayed left-to-right in the order defined by workflow.
+First phase = leftmost column (usually "New" or "Draft")
+Last phase = rightmost column (usually "Done" or "Archived")
+</phase-transitions>
+
+<discussions-section>
+## Discussions Section
+
+URL: `/discussions`
+
+**Discussion list:**
+- Shows all discussions user is part of
+- Unread count badges on each discussion
+- Search bar at top
+
+**Discussion view:**
+- Message list (chronological)
+- Input field at bottom
+- File attachment button
+- Emoji picker
+- @mention support
+
+**Activity discussions:**
+- Activities can have linked discussions
+- Access via "Discussion" tab in activity sidenav
+- Must "Join" discussion to see messages
+</discussions-section>
+
+<common-patterns>
+## Common UI Patterns
+
+**Buttons:**
+- Primary action: Blue filled button (e.g., "Save", "Create")
+- Secondary action: Outlined button (e.g., "Cancel")
+- Icon buttons: Small circular buttons with icons
+
+**Cards:**
+- White background (light mode) / Dark gray (dark mode)
+- Rounded corners
+- Subtle shadow
+- Click to select/open
+
+**Badges:**
+- Small colored pills showing counts or status
+- Red badge = requires attention
+- Gray badge = informational
+
+**Tooltips:**
+- Hover over icon buttons to see label
+- Useful for understanding unclear icons
+
+**Color coding:**
+- Phases have assigned colors (visible in kanban columns)
+- Workflow badges use workflow color
+- Workspace badges use workspace color
+</common-patterns>
+
+<context-to-instruction>
+## Translating Context to Instructions
+
+When you receive user context, use these patterns:
+
+**Context:** `section: 'activities', view.mode: 'kanban', view.workflowName: 'Sales'`
+**Know:** User is looking at Sales workflow kanban board
+
+**Context:** `sidenav.open: true, sidenav.type: 'activity', sidenav.activeTab: 'detail'`
+**Know:** User has an activity open and is viewing the detail tab
+
+**Context:** `sidenav.mode: 'edit', sidenav.buttons: ['save', 'cancel']`
+**Know:** User is editing an activity, Save and Cancel buttons are visible
+
+**Context:** `user.role: 'admin'`
+**Know:** User can access Settings and admin features
+
+**Instruction patterns by context:**
+
+| User location | They want to... | Say... |
+|--------------|-----------------|--------|
+| Kanban view | Create activity | "Click the '+ Add' button in the top right, or click the '+' at the bottom of any phase column" |
+| Kanban view | Open activity | "Click on the card you want to open" |
+| Activity sidenav | Edit fields | "Click the 'Edit' button (pencil icon) to enable editing, make your changes, then click 'Save'" |
+| Activity sidenav | See comments | "Click the 'Discussion' tab (speech bubble icon, 3rd from left)" |
+| Activity sidenav | Move to phase | "Click the phase badge at the top and select the new phase from the dropdown" |
+| Activity edit | Save changes | "Click the 'Save' button in the bottom right corner" |
+| Activity edit | Cancel changes | "Click 'Cancel' on the left to discard changes" |
+</context-to-instruction>
+
+<troubleshooting>
+## Common User Issues
+
+**"I can't see the workflow"**
+- Check if user has permission to the workflow
+- Admin may need to grant access in workflow settings
+
+**"I can't edit this activity"**
+- Check if user has edit permission for this phase
+- Some phases may be read-only for certain users
+
+**"I can't move the card"**
+- Phase transitions may be restricted
+- Check workflow settings for allowed transitions
+
+**"Where are my discussions?"**
+- User must be a member of the discussion
+- Check "Discussions" in left menu
+- For activity discussions, must "Join" first
+
+**"I can't see the Settings"**
+- Settings is admin-only
+- Regular users don't see this menu item
+</troubleshooting>

package/.env.example

@@ -81,6 +81,18 @@ MCP_SERVER_URL=http://localhost:3030/api/mcp
 # MCP Agent User IDs (required for agent tagging - get these from Hailer)
 MCP_CLIENT_AGENT_IDS='[]'
 
+# Hailer REST API base URL — every authenticated REST call (incl. the
+# public-chat graduation handler's apiKey validation via v2.core.init)
+# is sent to ${BOT_API_BASE_URL}/api/<dotted/method>. Defaults to
+# https://api.hailer.com.
+#
+# In local dev the Hailer API process typically listens on
+# http://localhost:1337 (NOT the frontend port — the frontend at 9443
+# doesn't expose /api/v2/* routes and will return Express's "Cannot POST"
+# 404 HTML which then bubbles up through the graduation popup as
+# "API key validation failed: REST API request failed: 404 …").
+# BOT_API_BASE_URL=http://localhost:1337
+
 # Bot Features (optional, defaults to true)
 TOKEN_USAGE_BOT_ENABLED=false
 AGENT_ACTIVITY_BOT_ENABLED=false
@@ -90,4 +102,41 @@ ADAPTIVE_DOCUMENTATION_BOT_ENABLED=false
 ADAPTIVE_AUTO_UPDATE=false
 ADAPTIVE_UPDATE_INTERVAL=60000
 ADAPTIVE_MIN_ERROR_COUNT=3
-ADAPTIVE_SKILL_GENERATION=false
+ADAPTIVE_SKILL_GENERATION=false
+
+# ==============================================
+# PUBLIC CHAT GRADUATION (Studio pre-warm)
+# ==============================================
+
+# Hailer frontend URL — origin the public-chat authorize popup is
+# redirected back to on success/error (e.g. https://<host>/#/authorize/complete).
+# Also used as the Origin header for the Studio prewarm.
+#
+# The /api/public-chat/authorize handler first tries the inbound
+# Origin/Referer header and only falls back to this value when the
+# browser sends `Origin: null` (cross-scheme form POSTs do this) or no
+# usable Referer. In local dev with the Hailer frontend on
+# https://localhost:9443, set this to https://localhost:9443 so the
+# popup closes itself instead of bouncing the user to app.hailer.com.
+# HAILER_APP_URL=https://app.hailer.com
+
+# Hailer Studio backend URL. When set, public-chat graduation pre-warms a
+# Studio session for the newly graduated user. Leave unset to disable.
+# STUDIO_URL=https://studio.hailer.com
+
+# Origin header sent on the Studio WS upgrade + HTTP POST. Must match one
+# of Studio's WHITELISTED_ORIGINS. Defaults to HAILER_APP_URL.
+# STUDIO_ORIGIN=https://app.hailer.com
+
+# Headless Studio session-create endpoint. When set, public-chat graduation
+# creates a one-shot Studio "builder" session for the new workspace via a
+# single server-to-server POST (apiKey + workspaceId required; systemMessage +
+# initialPrompt optional). This is what auto-builds the graduated user's
+# workflows + app and triggers the Hailer Helper tour handoff. Takes precedence
+# over the legacy STUDIO_URL WS prewarm.
+#
+# REQUIRED for the Studio build/tour flow to run — if unset, createStudioSession
+# silently skips and no workspace is built (the Helper then greets without
+# promising a build). Point it at the Studio sessions endpoint for THIS
+# environment, e.g. for next.k8s use the next proxy host:
+# STUDIO_SESSIONS_CREATE_URL=https://next.k8s.hailer.com/proxy/studio/api/sessions/create

package/CLAUDE.md

@@ -1,17 +1,143 @@
-# Hailer MCP Server
+# Hailer SDK + MCP Project
 
-MCP tools for Hailer workspaces: workflows, activities, insights, and apps.
+You're working in a project scaffolded by `@hailer/sdk`. The `workspace/` directory IS the source of truth for all workflow configuration; the MCP server (remote or local) exposes runtime tools.
 
-## Quick Start
+## The One Rule
 
-```bash
-npm init @hailer/sdk              # Scaffold project with workspace/ config
-npm run pull                      # Pull latest workflow schemas from Hailer
-npm run generate                  # Generate TypeScript types
+**If it can be done locally, do it locally. MCP tools are ONLY for things that require a server call.**
+
+Local = read `workspace/` files, run `npm run …` SDK commands, use `npx @hailer/create-app`, run vitest.
+Remote = MCP tools for activities, discussions, calendar, insights, files, permissions, marketplace.
+
+Before any MCP call, ask: "Is this answerable from `workspace/` files or a CLI?" If yes, do that instead. (SDK-profile connections don't even serve the shadowed tools; if you can see them, you're on a general connection — the rule still applies.)
+
+## What Goes Where
+
+| Need | Do this | Don't |
+|------|---------|-------|
+| Find workflow / field / phase IDs | Read `workspace/enums.ts` | `describe_workflows` |
+| See field types, labels, options | Read `workspace/<Name>_<id>/fields.ts` | `describe_workflows` |
+| See phases | Read `workspace/<Name>_<id>/phases.ts` | `describe_workflows` |
+| See all workflows | Read `workspace/workflows.ts` | `describe_workflows` |
+| Create / modify fields or phases | Edit `fields.ts` / `phases.ts` → `npm run fields-push:force` / `phases-push:force` | `update_workflow_structure` |
+| Create / modify workflows | Edit `workflows.ts` → `npm run workflows-sync:force` | `install_workflow` |
+| Create / modify teams / groups | Edit `teams.ts` / `groups.ts` → `npm run teams-push:force` / `groups-push:force` | — |
+| Create / modify insights config | Edit `insights.ts` → `npm run insights-push:force` | — (runtime `run_insight` is fine) |
+| Create / modify document templates | Edit `templates/` → `npm run templates-sync:force` | — |
+| Test function field code | vitest locally | `test_function_field` |
+| Scaffold an app | `npx @hailer/create-app` (fresh — never copy an existing app) | — (script-only; no MCP tool exists) |
+| Publish an app | `cd app && npm run publish-production` (`--market` for marketplace versions) | — (script-only; no MCP tool exists) |
+| Create / modify apps registry | Edit `workspace/apps.ts` → `npx hailer-sdk ws-config apps push --force` | `manage_app` |
+| Create / update activities | MCP `create_activity`, `update_activity` | — |
+| List / read / count activities | MCP `list_activities` (`countOnly: true` for counts), `show_activity_by_id` | — |
+| Query data (SQL reports) | MCP `run_insight`, `save_insight` | — |
+| Discussions, calendar, files, users | MCP runtime tools | — |
+| Workflow permissions | MCP `set_workflow_permission`, `list_workflow_permissions`, `check_user_permissions` | — |
+| Live activity counts / orientation | MCP `core_init` (once per session) | — |
+
+## How to Read workspace/ Files
+
+**Never read workspace/ files in main context** — they're large and fill context permanently.
+
+1. Spawn a fast sub-agent (haiku-class) to read the files
+2. It extracts what you need (IDs, field types, phase names) and returns a short summary
+3. Use that summary for MCP runtime calls
+
+Sub-agent habits: fast models read/search, capable models write code; load Skills in sub-agents, not main context; delegate anything beyond ~20 lines of code.
+
+## workspace/ Structure
+
+```
+workspace/
+├── enums.ts           # ALL IDs: WorkflowIds, FieldIds, PhaseIds, TeamIds, GroupIds
+├── workflows.ts       # Workflow registry
+├── teams.ts           # Team definitions
+├── groups.ts          # Group definitions
+├── insights.ts        # Insight definitions
+├── apps.ts            # App registry (name, url, image, members)
+├── templates/         # Document templates
+└── <WorkflowName>_<id>/
+    ├── fields.ts      # Field definitions (type, label, key, options, required)
+    ├── phases.ts      # Phases (name, key, isInitial, isEndpoint, nextPhases)
+    ├── main.ts        # Workflow config
+    └── functions/     # Function field code (one file per function)
 ```
 
-Then ask Claude Code to build features. Load relevant skills for domain context.
+`npm run pull` refreshes everything from Hailer → local files.
+
+## SDK Push Commands
+
+| Command | Effect |
+|---------|--------|
+| `npm run pull` | Pull latest from Hailer → local files |
+| `npm run push:force` | Push everything |
+| `npm run fields-push:force` | Fields only |
+| `npm run phases-push:force` | Phases only |
+| `npm run workflows-sync:force` | Workflow registry (create / delete) |
+| `npm run teams-push:force` | Teams |
+| `npm run groups-push:force` | Groups |
+| `npm run insights-push:force` | Insights |
+| `npm run templates-sync:force` | Document templates |
+| `npx hailer-sdk ws-config apps push --force` | App registry + members |
+
+Always use `:force` — the non-force variants prompt interactively.
+
+## Push / Pull Gotchas
+
+| Gotcha | Correct | Wrong |
+|--------|---------|-------|
+| New entities | Omit `_id` — server assigns it | Don't add `_id` manually |
+| After push | `npm run pull` to get server-assigned IDs | Don't assume local IDs are final |
+| Function fields | `npm run fields-push:force` only (non-force skips `functionVariables`) | Don't use non-force |
+| Enum imports | Verify after pull — identical hex suffixes can collide | Don't blindly trust auto-generated imports |
+| `linkedfrom` fields | Don't work in isolated-vm; use `<` backlink dependency | Don't use in function fields |
+| Function field code | Plain JavaScript only | Not TypeScript |
+| Phase transitions | Exact string match on phase name | Don't guess phase names |
+| Activity field values (MCP) | Date: Unix ms (`1730937600000`); Dropdown: exact string; ActivityLink: string ID; fields keyed by field ID, never label | Not ISO dates, not arrays, not field names |
+
+## App Lifecycle
+
+| Step | How |
+|------|-----|
+| Scaffold | `npx @hailer/create-app` — scaffold fresh, never copy an existing app |
+| Local dev | `cd app && npm run dev` |
+| Publish | `cd app && npm run publish-production` (`--market` for marketplace versions); then share via `manage_app` add_member |
+| Register / share | Edit `workspace/apps.ts` → `npx hailer-sdk ws-config apps push --force` |
+
+## When MCP Tools Are the Answer
+
+The MCP server exposes a curated runtime surface the SDK can't replicate locally:
+
+- **Activities**: `create_activity`, `update_activity`, `list_activities` (+ `countOnly`), `show_activity_by_id`
+- **Discussions**: `list_my_discussions`, `fetch_discussion_messages` (cursor + linked-activity lookup), `add_discussion_message`, `join_discussion`, `leave_discussion`, `invite_discussion_members`
+- **Calendar**: `query_events` (single / range / upcoming), `manage_calendar`, `create_event`, `update_event` (incl. attendee removal), `delete_event`, `respond_to_invite`
+- **Insights (runtime)**: `run_insight` (saved or ad-hoc SQL), `save_insight`, `list_insights`
+- **Files**: `upload_files`, `download_file`
+- **Workflow permissions**: `set_workflow_permission` (level `none` revokes), `list_workflow_permissions`, `check_user_permissions`
+- **Marketplace**: `browse_marketplace`, `install_marketplace`, `publish_marketplace`
+- **Server-only mutations**: `auto_set_keys` (transactional key generation), `core_init` (live activity counts)
+
+Tools not in this list are either SDK-shadowed (see matrix above) or admin/dangerous (handled outside this environment).
+
+## Skills
+
+Load in sub-agents via the Skill tool. Never in main context.
+
+| Skill | When |
+|-------|------|
+| `sdk-ws-config-skill` | Workflows, fields, phases, teams, groups |
+| `sdk-function-fields` | Calculated fields, nameFunction |
+| `sdk-activity-patterns` | Creating/updating activities via MCP |
+| `sdk-insight-queries` | SQL insight queries |
+| `hailer-app-builder` | Building Hailer apps (React/Chakra) |
+| `hailer-design-system` | Theme, colors, icons, layout |
+| `create-and-publish-app` | Scaffolding + publishing apps (dev/prod/marketplace) |
+| `testing-patterns` | Vitest/playwright tests |
+
+## Commands
+
+`/command <param>` — angle brackets = required
 
-## Project-Level Instructions
+**Essential:** `/save`, `/handoff`, `/prd`, `/autoplan`, `/ws-pull`
 
-See `.claude/CLAUDE.md` for full project configuration — skills, hooks, commands, gotchas.
+**Squads** (drive the native Workflow tool): `/app-squad "<desc>"`, `/review-squad [target]`, `/debug-squad "<bug>"`

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAO9B,QAAA,MAAM,IAAI,MAAa,CAAC;AAwBxB,eAAe,IAAI,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAQ9B,QAAA,MAAM,IAAI,MAAa,CAAC;AA2BxB,eAAe,IAAI,CAAC"}

package/dist/app.js

@@ -4,6 +4,7 @@ const core_1 = require("./core");
 const config_1 = require("./config");
 const logger_1 = require("./lib/logger");
 const tools_1 = require("./mcp/tools");
+const aliases_1 = require("./mcp/tools/aliases");
 const vipunen_1 = require("./plugins/vipunen");
 const logger = (0, logger_1.createLogger)({ component: 'app' });
 const core = new core_1.Core();
@@ -11,6 +12,8 @@ const core = new core_1.Core();
 for (const tool of tools_1.allTools) {
     core.addTool(tool);
 }
+// v1 → v2 deprecation aliases: old names execute but aren't listed
+core.addToolAliases(aliases_1.TOOL_ALIASES);
 // Register Vipunen tools (conditional on WEAVIATE_HOST)
 for (const tool of (0, vipunen_1.registerVipunenTools)({
     weaviateHost: config_1.environment.WEAVIATE_HOST,

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":";;AAAA,iCAA8B;AAC9B,qCAAuC;AACvC,yCAA4C;AAC5C,uCAAuC;AACvC,+CAAyD;AAEzD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,MAAM,IAAI,GAAG,IAAI,WAAI,EAAE,CAAC;AAExB,4BAA4B;AAC5B,KAAK,MAAM,IAAI,IAAI,gBAAQ,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,wDAAwD;AACxD,KAAK,MAAM,IAAI,IAAI,IAAA,8BAAoB,EAAC;IACtC,YAAY,EAAE,oBAAW,CAAC,aAAa;IACvC,cAAc,EAAE,oBAAW,CAAC,gBAAgB;IAC5C,cAAc,EAAE,oBAAW,CAAC,gBAAgB;CAC7C,CAAC,EAAE,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAErC,QAAQ;AACR,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC3B,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":";;AAAA,iCAA8B;AAC9B,qCAAuC;AACvC,yCAA4C;AAC5C,uCAAuC;AACvC,iDAAmD;AACnD,+CAAyD;AAEzD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAClD,MAAM,IAAI,GAAG,IAAI,WAAI,EAAE,CAAC;AAExB,4BAA4B;AAC5B,KAAK,MAAM,IAAI,IAAI,gBAAQ,EAAE,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,mEAAmE;AACnE,IAAI,CAAC,cAAc,CAAC,sBAAY,CAAC,CAAC;AAElC,wDAAwD;AACxD,KAAK,MAAM,IAAI,IAAI,IAAA,8BAAoB,EAAC;IACpC,YAAY,EAAE,oBAAW,CAAC,aAAa;IACvC,cAAc,EAAE,oBAAW,CAAC,gBAAgB;IAC5C,cAAc,EAAE,oBAAW,CAAC,gBAAgB;CAC/C,CAAC,EAAE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAErC,QAAQ;AACR,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACzB,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC;AAEH,kBAAe,IAAI,CAAC"}

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

@@ -1,12 +1,13 @@
 /**
  * BotManager - Manages lifecycle of Bot instances across workspaces.
  *
- * Loads configs from .bot-config/, starts one Bot per enabled workspace,
+ * Loads configs from .bot-config/ (created on runtime), starts one Bot per enabled workspace,
  * and provides start/stop/status operations.
  */
 import { ToolRegistry } from '../mcp/tool-registry';
 import { BotConfig } from '../bot-config';
 import type { BotEntry } from '../bot-config/types';
+import { type BotEventAction } from '../bot-config/events';
 export declare class BotManager {
     private toolRegistry;
     private anthropicApiKey;
@@ -16,9 +17,11 @@ export declare class BotManager {
     private workspaceBots;
     private apiHost;
     constructor(toolRegistry: ToolRegistry, anthropicApiKey: string);
+    private runtime;
     /** Get all bot userIds in a workspace (for self-message guard) */
     getBotUserIdsForWorkspace(workspaceId: string): Set<string>;
     startAll(): Promise<void>;
+    stopReconciliation(): void;
     startBot(config: BotConfig): Promise<void>;
     stopBot(botKey: string, workspaceId?: string): Promise<void>;
     stopAll(): Promise<void>;
@@ -30,10 +33,10 @@ export declare class BotManager {
     }>;
     getBotCount(): number;
     /**
-     * Handle hot reload from webhook updates.
-     * Supports all bot types. Routes by activityId so multiple bots
-     * can run in the same workspace independently.
-     */
-    handleBotUpdate(workspaceId: string, bot: BotEntry, action: 'add' | 'update' | 'remove'): Promise<void>;
+   * Handle hot reload from webhook updates.
+   * Supports all bot types. Routes by activityId so multiple bots
+   * can run in the same workspace independently.
+   */
+    handleBotUpdate(workspaceId: string, bot: BotEntry, action: BotEventAction): Promise<void>;
 }
 //# sourceMappingURL=bot-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bot-manager.d.ts","sourceRoot":"","sources":["../../src/bot/bot-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAsB,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,qBAAa,UAAU;IAQnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,eAAe;IARzB,qCAAqC;IACrC,OAAO,CAAC,IAAI,CAA0B;IACtC,sEAAsE;IACtE,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,OAAO,CAAS;gBAGd,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,MAAM;IAKjC,kEAAkE;IAClE,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAYrD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBzB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C1C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,SAAS,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IASxG,WAAW,IAAI,MAAM;IAIrB;;;;OAIG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAClC,OAAO,CAAC,IAAI,CAAC;CAwEjB"}
+{"version":3,"file":"bot-manager.d.ts","sourceRoot":"","sources":["../../src/bot/bot-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAsB,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAOpD,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAmCvE,qBAAa,UAAU;IAQnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,eAAe;IARvB,qCAAqC;IACrC,OAAO,CAAC,IAAI,CAA0B;IACtC,sEAAsE;IACtE,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,OAAO,CAAS;gBAGhB,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,MAAM;IAK/B,OAAO,CAAC,OAAO;IAQf,kEAAkE;IAClE,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAcrD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA0D/B,kBAAkB,IAAI,IAAI;IAIpB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA2C1C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B,SAAS,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IASxG,WAAW,IAAI,MAAM;IAIrB;;;;KAIC;IACK,eAAe,CACjB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;CA+GnB"}