@hailer/mcp 1.1.14 → 1.1.16

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

@@ -0,0 +1,256 @@
+# Hailer Calendar API
+
+Execute Hailer calendar and event 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.
+
+---
+
+## Calendars
+
+### List All Calendars
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/list_all" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{}]'
+```
+
+### Create Calendar
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/create_calendar" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"name": "My Calendar", "color": "#3498db", "cid": "WORKSPACE_ID"}]'
+```
+
+### Update Calendar
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/update_calendar" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"_id": "CALENDAR_ID", "name": "Updated Name", "color": "#e74c3c"}]'
+```
+
+### Remove Calendar
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/remove_calendar" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["CALENDAR_ID"]'
+```
+
+### Set Calendar Permissions
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/calendar_permission" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"calendarId": "CALENDAR_ID", "userId": "USER_ID", "permission": "edit"}]'
+```
+
+### Save Selected Calendars (user preference)
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/save_selected_calendars" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[["CALENDAR_ID_1", "CALENDAR_ID_2"]]'
+```
+
+---
+
+## Events
+
+### Create Event
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/create_event" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "calendarId": "CALENDAR_ID",
+    "subject": "Team Meeting",
+    "description": "Weekly sync",
+    "start": 1705400000000,
+    "end": 1705403600000,
+    "allDay": false,
+    "location": "Conference Room A",
+    "invites": ["USER_ID_1", "USER_ID_2"]
+  }]'
+```
+
+### Update Event
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/update_event" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "_id": "EVENT_ID",
+    "subject": "Updated Meeting Title",
+    "start": 1705410000000,
+    "end": 1705413600000
+  }]'
+```
+
+### Load Single Event
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/load_event" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"eventId": "EVENT_ID"}]'
+```
+
+### Load Events (date range)
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/load_events" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "start": 1704067200000,
+    "end": 1706745600000,
+    "calendarIds": ["CALENDAR_ID_1", "CALENDAR_ID_2"]
+  }]'
+```
+
+### Remove Event
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/remove_event" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["EVENT_ID"]'
+```
+
+### Get Upcoming Events
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/upcoming_events" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"limit": 10}]'
+```
+
+---
+
+## Recurring Events
+
+### Load Repeat Series
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/load_repeat_series" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["SERIES_ID"]'
+```
+
+### Create Recurring Event
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/create_event" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "calendarId": "CALENDAR_ID",
+    "subject": "Daily Standup",
+    "start": 1705395600000,
+    "end": 1705396500000,
+    "repeat": {
+      "frequency": "daily",
+      "interval": 1,
+      "until": 1707984000000
+    }
+  }]'
+```
+
+Repeat frequency options: `daily`, `weekly`, `monthly`, `yearly`
+
+---
+
+## Event Invitations
+
+### Invite User to Event
+Include `invites` array when creating/updating event:
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/update_event" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "_id": "EVENT_ID",
+    "invites": ["USER_ID_1", "USER_ID_2", "USER_ID_3"]
+  }]'
+```
+
+### Remove Invite
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/remove_invite" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["EVENT_ID", "USER_ID"]'
+```
+
+### Respond to Invite
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/invite_respond" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"EVENT_ID": true}]'
+# true = accept, false = decline, null = maybe
+```
+
+---
+
+## iCal Integration
+
+### Generate iCal Link
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/generate_ical_link" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["CALENDAR_ID"]'
+```
+Returns a URL that can be subscribed to in external calendar apps.
+
+### Remove iCal Link
+```bash
+curl -X POST "https://api.hailer.com/api/calendar/remove_ical_link" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["CALENDAR_ID", {}]'
+```
+
+---
+
+## Event Object Structure
+
+```json
+{
+  "_id": "event_id",
+  "calendarId": "calendar_id",
+  "subject": "Meeting Title",
+  "description": "Meeting description",
+  "start": 1705400000000,
+  "end": 1705403600000,
+  "allDay": false,
+  "location": "Room 101",
+  "invites": ["user_id_1", "user_id_2"],
+  "responses": {
+    "user_id_1": true,
+    "user_id_2": null
+  },
+  "repeat": {
+    "frequency": "weekly",
+    "interval": 1,
+    "until": 1707984000000
+  },
+  "created": 1705123456789,
+  "createdBy": "user_id"
+}
+```
+
+---
+
+## Notes
+- Timestamps are milliseconds since Unix epoch
+- `allDay: true` events ignore time portion of start/end
+- Each workspace can have multiple calendars
+- Events can be linked to activities via the activity's calendar field
+- Invite responses: `true` = accepted, `false` = declined, `null` = maybe/pending

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

@@ -0,0 +1,249 @@
+# Hailer Feed (Wall) API
+
+Execute Hailer feed/wall post 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.
+
+---
+
+## Posts
+
+### Create New Post
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/new_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "subject": "Announcement Title",
+    "text": "Post content goes here. Supports **markdown**.",
+    "files": ["FILE_ID_1", "FILE_ID_2"]
+  }]'
+```
+
+### Create Post to Specific Target
+```bash
+# Post to team
+curl -X POST "https://api.hailer.com/api/wall2/new_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[
+    {"subject": "Team Update", "text": "Content here"},
+    {"teamId": "TEAM_ID"}
+  ]'
+
+# Post to workspace
+curl -X POST "https://api.hailer.com/api/wall2/new_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[
+    {"subject": "Company Announcement", "text": "Content here"},
+    {"networkId": "WORKSPACE_ID"}
+  ]'
+
+# Post to group
+curl -X POST "https://api.hailer.com/api/wall2/new_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[
+    {"subject": "Group News", "text": "Content here"},
+    {"groupId": "GROUP_ID"}
+  ]'
+```
+
+### Edit Post
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/edit_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID", {
+    "subject": "Updated Title",
+    "text": "Updated content"
+  }]'
+```
+
+### Remove Post
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/remove_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID"]'
+```
+
+---
+
+## Loading Posts
+
+### Load Posts (Feed)
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/load_posts" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[null, {"limit": 20}]'
+```
+
+### Load More Posts (Pagination)
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/load_posts" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["LAST_POST_ID", {"limit": 20}]'
+```
+
+---
+
+## Comments
+
+### Add Comment
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/save_comment" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{
+    "text": "Great post!",
+    "files": []
+  }, "POST_ID"]'
+```
+
+### Load Comments
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/load_comments" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID"]'
+```
+
+### Load More Comments (Pagination)
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/load_comments" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID", "LAST_COMMENT_ID"]'
+```
+
+### Edit Comment
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/edit_comment" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID", "COMMENT_ID", {
+    "text": "Updated comment text"
+  }]'
+```
+
+### Remove Comment
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/remove_comment" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID", "COMMENT_ID"]'
+```
+
+---
+
+## Interactions
+
+### Like/Unlike Post
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/like_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID", {"like": true}]'
+# like: true = like, false = unlike
+```
+
+### Pin/Unpin Post
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/pin_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID", true]'
+# true = pin, false = unpin
+```
+
+### Follow Post (get notifications)
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/follow_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID"]'
+```
+
+### Unfollow Post
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/unfollow_post" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["POST_ID"]'
+```
+
+---
+
+## Read Status
+
+### Mark Posts as Seen
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/seen" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{"postIds": ["POST_ID_1", "POST_ID_2"]}]'
+```
+
+### Get Unread Posts
+```bash
+curl -X POST "https://api.hailer.com/api/wall2/unread" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '[{}]'
+```
+
+---
+
+## Post Object Structure
+
+```json
+{
+  "_id": "post_id",
+  "subject": "Post Title",
+  "text": "Post content with **markdown** support",
+  "files": ["file_id_1", "file_id_2"],
+  "target": {
+    "type": "network",
+    "id": "workspace_id"
+  },
+  "likes": ["user_id_1", "user_id_2"],
+  "likeCount": 2,
+  "commentCount": 5,
+  "pinned": false,
+  "created": 1705123456789,
+  "createdBy": "user_id",
+  "modified": 1705123456789
+}
+```
+
+## Comment Object Structure
+
+```json
+{
+  "_id": "comment_id",
+  "postId": "post_id",
+  "text": "Comment text",
+  "files": [],
+  "created": 1705123456789,
+  "createdBy": "user_id"
+}
+```
+
+---
+
+## Notes
+- Posts support markdown formatting in `text` field
+- Files must be uploaded first via `/upload` endpoint
+- Pinned posts appear at top of feed
+- Following a post triggers notifications for new comments
+- Target types: `user`, `team`, `network` (workspace), `group`
+- Default target is the user's primary workspace feed

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

@@ -0,0 +1,195 @@
+# Hailer Insights API (v3)
+
+Execute Hailer insight (SQL views/reports) 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.
+
+---
+
+## Insight CRUD
+
+### Create Insight
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/create" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"name": "My Report", "sql": "SELECT * FROM activities WHERE workflow_id = :workflowId"}]'
+```
+
+### Update Insight
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/update" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INSIGHT_ID", {"name": "Updated Report", "sql": "SELECT name, created FROM activities"}]'
+```
+
+### List Insights
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/list" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID"]'
+```
+
+### Copy Insight
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/copy" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INSIGHT_ID", {"name": "Copy of Report"}]'
+```
+
+### Remove Insight
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INSIGHT_ID"]'
+```
+
+---
+
+## Execute Insights
+
+### Get Insight Data
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/data" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INSIGHT_ID", {"params": {"workflowId": "WF_ID"}, "limit": 100, "offset": 0}]'
+```
+
+### Preview Insight (test SQL without saving)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/preview" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["WORKSPACE_ID", {"sql": "SELECT COUNT(*) as total FROM activities", "params": {}}]'
+```
+
+---
+
+## Public Insights
+
+### Get Public Insight Data (no auth required)
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/public" \
+  -H "Content-Type: application/json" \
+  -d '["PUBLIC_INSIGHT_KEY"]'
+```
+
+Note: Public insights use a special key, not the insight ID. The key is generated when making an insight public.
+
+---
+
+## Insight Members
+
+### Add Member
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/member/add" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INSIGHT_ID", {"userId": "USER_ID"}]'
+# Also supports: {"teamId": "TEAM_ID"}, {"groupId": "GROUP_ID"}, {"networkId": "WORKSPACE_ID"}
+```
+
+### Remove Member
+```bash
+curl -X POST "https://api.hailer.com/api/v3/insight/member/remove" \
+  -H "Content-Type: application/json" \
+  -H "hlrkey: YOUR_SESSION_KEY" \
+  -d '["INSIGHT_ID", {"userId": "USER_ID"}]'
+```
+
+---
+
+## SQL Reference
+
+Hailer insights use a SQL-like syntax with these tables:
+
+### Available Tables
+- `activities` - All activities (rows) across workflows
+- `workflows` - Workflow definitions
+- `phases` - Phase definitions
+- `users` - Workspace users
+- `teams` - Teams in workspace
+
+### Common Columns (activities)
+- `_id` - Activity ID
+- `name` - Activity name
+- `workflow_id` - Parent workflow
+- `phase_id` - Current phase
+- `created` - Creation timestamp
+- `modified` - Last modified timestamp
+- `created_by` - Creator user ID
+- `fields.FIELD_ID` - Custom field values
+
+### Example Queries
+
+**Count by phase:**
+```sql
+SELECT phase_id, COUNT(*) as count
+FROM activities
+WHERE workflow_id = :workflowId
+GROUP BY phase_id
+```
+
+**Recent activities:**
+```sql
+SELECT name, created, phase_id
+FROM activities
+WHERE workflow_id = :workflowId
+ORDER BY created DESC
+LIMIT 10
+```
+
+**Activities with field filter:**
+```sql
+SELECT * FROM activities
+WHERE workflow_id = :workflowId
+AND fields.status = 'active'
+```
+
+**Join with users:**
+```sql
+SELECT a.name, u.firstname, u.lastname
+FROM activities a
+JOIN users u ON a.created_by = u._id
+WHERE a.workflow_id = :workflowId
+```
+
+---
+
+## Insight Object Structure
+
+```json
+{
+  "_id": "insight_id",
+  "name": "Report Name",
+  "sql": "SELECT * FROM activities",
+  "cid": "workspace_id",
+  "public": false,
+  "publicKey": null,
+  "members": [
+    {"type": "user", "id": "user_id"},
+    {"type": "team", "id": "team_id"}
+  ],
+  "created": 1705123456789,
+  "modified": 1705123456789
+}
+```
+
+---
+
+## Notes
+- Parameters in SQL use `:paramName` syntax
+- Pass params via options object when calling data endpoint
+- Public insights can be accessed without authentication
+- Insights are scoped to a workspace (networkId/cid)
+- Member types: `user_<id>`, `team_<id>`, `group_<id>`, `network_<id>`