@hailer/mcp 1.0.29 → 1.1.3

package/.claude/skills/hailer-rest-api/hailer-messaging.md

@@ -0,0 +1,276 @@
+# Hailer Messaging API
+
+Execute Hailer discussion and messenger operations via REST API.
+
+## Base URL
+- **Production:** `https://api.hailer.com/api`
+- **Staging:** `https://api.hailer.biz/api`
+
+## Authentication
+All requests require `hlrkey` header with session key.
+
+---
+
+## Send Messages
+
+### Send Message to Discussion
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/send" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"discussionId": "DISCUSSION_ID", "text": "Hello world!", "files": []}]'
+```
+
+### Send with File Attachments
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/send" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"discussionId": "DISCUSSION_ID", "text": "See attachment", "files": ["FILE_ID_1", "FILE_ID_2"]}]'
+```
+
+---
+
+## Load Messages
+
+### Load Messages from Discussion
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/load_messages" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"discussionId": "DISCUSSION_ID", "limit": 50}]'
+```
+
+### Get Specific Message (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/message/get" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["MESSAGE_ID"]'
+```
+
+### Get Latest Messages (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/message/latest" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", {"limit": 20}]'
+```
+
+### Get Next/Previous Messages (v3)
+```bash
+# Next (newer)
+curl -X POST "https://api.hailer.com/api/v3/discussion/message/next" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", "AFTER_MESSAGE_ID", {"limit": 20}]'
+
+# Previous (older)
+curl -X POST "https://api.hailer.com/api/v3/discussion/message/previous" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", "BEFORE_MESSAGE_ID", {"limit": 20}]'
+```
+
+---
+
+## Edit & Delete Messages (v2)
+
+### Edit Message
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/message/edit" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["MESSAGE_ID", "Updated message text"]'
+```
+
+### Delete Message
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/message/delete" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["MESSAGE_ID"]'
+```
+
+### React to Message (v2)
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/message/react" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["MESSAGE_ID", "emoji_name"]'
+# Common reactions: thumbsup, heart, laugh, etc.
+```
+
+---
+
+## Discussion Management
+
+### Load All Discussions
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/load_discussions" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{}]'
+```
+
+### Find User Discussion (DM)
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/find_user_discussion" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["USER_ID"]'
+```
+
+### Sync Discussion (v2)
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/sync" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID"]'
+```
+
+### Get Discussion Files (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/files" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", {"limit": 50}]'
+```
+
+---
+
+## Discussion Participants
+
+### Invite Users to Discussion
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/invite_users" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"discussionId": "DISCUSSION_ID", "userIds": ["USER_ID_1", "USER_ID_2"]}]'
+```
+
+### Leave Discussion
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/leave_discussion" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID"]'
+```
+
+---
+
+## Stars & Bookmarks
+
+### Star/Unstar Discussion (v2)
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/star" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID"]'
+```
+
+### Star/Unstar Message (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/message/star" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["MESSAGE_ID"]'
+```
+
+### Get Starred Messages (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/message/stars" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID"]'
+```
+
+---
+
+## Read Status & Notifications
+
+### Mark as Read
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/set_discussion_last_seen" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", TIMESTAMP_MS]'
+```
+
+### Get Unread Count
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/get_unread_count" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[]'
+```
+
+### Mute/Unmute Discussion (v2)
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/mute" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", true]'
+# true = mute, false = unmute
+```
+
+---
+
+## Settings & Permissions
+
+### Save Discussion Settings
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/save_discussion_settings" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", {"name": "New Discussion Name"}]'
+```
+
+### Set Discussion Permission (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/setPermission" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", {"permission": "write", "target": {"userId": "USER_ID"}}]'
+```
+
+### Close Discussion (v3)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/discussion/close" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID"]'
+```
+
+---
+
+## Typing Indicator
+
+### Set Typing State
+```bash
+curl -X POST "https://api.hailer.com/api/messenger/set_discussion_typing_state" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID", true]'
+# true = typing, false = stopped
+```
+
+---
+
+## Video Meetings (v2)
+
+### Start Meet
+```bash
+curl -X POST "https://api.hailer.com/api/v2/discussion/meet/start" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["DISCUSSION_ID"]'
+```
+
+---
+
+## Notes
+- Every activity has an associated discussion (same ID)
+- Discussions can be standalone (group chats) or linked to activities
+- Timestamps are milliseconds since Unix epoch
+- Files must be uploaded first via `/upload` endpoint, then attached by ID

package/.claude/skills/hailer-rest-api/hailer-workflows.md

@@ -0,0 +1,283 @@
+# Hailer Workflows API
+
+Execute Hailer workflow (process/table) operations via REST API.
+
+## Base URL
+- **Production:** `https://api.hailer.com/api`
+- **Staging:** `https://api.hailer.biz/api`
+
+## Authentication
+All requests require `hlrkey` header with session key.
+
+---
+
+## Workflow CRUD
+
+### Create Workflow
+```bash
+curl -X POST "https://api.hailer.com/api/process/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"name": "My Workflow", "cid": "WORKSPACE_ID"}]'
+```
+
+### Get Workflow
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/get" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID"]'
+```
+
+### List Workflows
+```bash
+curl -X POST "https://api.hailer.com/api/process/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[]'
+```
+
+### Update Workflow Info
+```bash
+curl -X POST "https://api.hailer.com/api/process/set_info" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"name": "New Name", "description": "Updated description"}]'
+```
+
+### Remove Workflow
+```bash
+curl -X POST "https://api.hailer.com/api/process/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID"]'
+```
+
+### Copy Workflow
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/copy" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"processIds": ["WORKFLOW_ID"]}]'
+```
+
+### Star/Unstar Workflow
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/star" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID"]'
+```
+
+---
+
+## Field Operations
+
+### Create Field
+```bash
+curl -X POST "https://api.hailer.com/api/process/create_field" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"name": "Field Name", "type": "text", "order": 1}]'
+```
+
+Field types (from hailer.d.ts): `text`, `textarea`, `textunit`, `numeric`, `numericunit`, `date`, `datetime`, `daterange`, `datetimerange`, `time`, `timerange`, `textpredefinedoptions`, `users`, `teams`, `activitylink`, `linkedfrom`, `country`, `subheader`
+
+### Update Field
+```bash
+curl -X POST "https://api.hailer.com/api/process/update_field" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", "FIELD_ID", {"name": "Updated Name", "required": true}]'
+```
+
+### Remove Field
+```bash
+curl -X POST "https://api.hailer.com/api/process/remove_field" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", "FIELD_ID"]'
+```
+
+---
+
+## Phase Operations
+
+### Create Phase
+```bash
+curl -X POST "https://api.hailer.com/api/phase/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"processId": "WORKFLOW_ID", "name": "New Phase", "order": 1}]'
+```
+
+### Update Phase
+```bash
+curl -X POST "https://api.hailer.com/api/phase/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["PHASE_ID", {"name": "Updated Phase", "color": "#FF5733"}]'
+```
+
+### Remove Phase
+```bash
+curl -X POST "https://api.hailer.com/api/phase/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["PHASE_ID"]'
+```
+
+### Set Phase Info
+```bash
+curl -X POST "https://api.hailer.com/api/phase/set_info" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["PHASE_ID", {"description": "Phase description"}]'
+```
+
+---
+
+## Workflow Members & Permissions (v2)
+
+### List Members
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/member/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID"]'
+```
+
+### Add Member
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/member/add" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"userId": "USER_ID"}]'
+# Or for team: {"teamId": "TEAM_ID"}
+```
+
+### Remove Member
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/member/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"userId": "USER_ID"}]'
+```
+
+### Grant Permission
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/permissions/grant" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"userId": "USER_ID"}, "edit"]'
+# Permissions: view, edit, admin
+```
+
+### Deny Permission
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/permissions/deny" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"userId": "USER_ID"}, "edit"]'
+```
+
+---
+
+## Phase Members & Permissions (v2)
+
+### List Phase Members
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/phase/member/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["PHASE_ID"]'
+```
+
+### Add Phase Member
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/phase/member/add" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["PHASE_ID", {"userId": "USER_ID"}]'
+```
+
+### Grant Phase Permission
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/phase/permissions/grant" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["PHASE_ID", {"userId": "USER_ID"}, "edit"]'
+```
+
+---
+
+## Templates
+
+### Install Template
+```bash
+curl -X POST "https://api.hailer.com/api/process/install_template" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["TEMPLATE_ID"]'
+```
+
+### Create Activity Template
+```bash
+curl -X POST "https://api.hailer.com/api/v3/activity/template/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", "PHASE_ID"]'
+```
+
+---
+
+## Public Forms (v2)
+
+### Create Public Form
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/publicForm/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"processId": "WORKFLOW_ID", "phaseId": "PHASE_ID", "fields": ["FIELD_ID_1"]}]'
+```
+
+### Update Public Form
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/publicForm/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"formId": "FORM_ID", "enabled": true}]'
+```
+
+---
+
+## Document Templates
+
+### Set Document Templates
+```bash
+curl -X POST "https://api.hailer.com/api/process/set_documentTemplates" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", {"template1": {"name": "Invoice", "content": "..."}}]'
+```
+
+---
+
+## Translations (v2)
+
+### Create Translation
+```bash
+curl -X POST "https://api.hailer.com/api/v2/process/translation/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKFLOW_ID", "fi"]'
+# ISO language codes: en, fi, sv, de, etc.
+```
+
+---
+
+## Notes
+- workflowId = processId (legacy naming)
+- cid = companyId = workspaceId = networkId (all refer to workspace)
+- Phases are like columns in a Kanban or row states
+- Fields are columns in the workflow table

package/.claude/skills/insight-join-patterns/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: insight-join-patterns
 description: Correct JOIN syntax for Hailer insights with ActivityLink fields
+version: 1.0.0
 triggers: JOIN query errors, missing columns, NULL results in insight queries
 ---
 
+**Prerequisite:** Before using JOINs, review `SDK-insight-queries` skill for basic insight syntax and single-workflow queries.
+
 <problem>
 When joining workflows with ActivityLink fields in Hailer insights, you must:
 1. Include `_id` meta field in BOTH source definitions