@firfi/huly-mcp 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/README.md +17 -5
  2. package/dist/index.cjs +25992 -25310
  3. package/package.json +31 -19
  4. package/dist/index.js +0 -116694
  5. package/dist/src/config/config.d.ts +0 -94
  6. package/dist/src/config/config.d.ts.map +0 -1
  7. package/dist/src/config/config.js +0 -247
  8. package/dist/src/config/config.js.map +0 -1
  9. package/dist/src/domain/schemas.d.ts +0 -256
  10. package/dist/src/domain/schemas.d.ts.map +0 -1
  11. package/dist/src/domain/schemas.js +0 -275
  12. package/dist/src/domain/schemas.js.map +0 -1
  13. package/dist/src/huly/client.d.ts +0 -63
  14. package/dist/src/huly/client.d.ts.map +0 -1
  15. package/dist/src/huly/client.js +0 -149
  16. package/dist/src/huly/client.js.map +0 -1
  17. package/dist/src/huly/errors.d.ts +0 -133
  18. package/dist/src/huly/errors.d.ts.map +0 -1
  19. package/dist/src/huly/errors.js +0 -108
  20. package/dist/src/huly/errors.js.map +0 -1
  21. package/dist/src/huly/operations/issues.d.ts +0 -122
  22. package/dist/src/huly/operations/issues.d.ts.map +0 -1
  23. package/dist/src/huly/operations/issues.js +0 -627
  24. package/dist/src/huly/operations/issues.js.map +0 -1
  25. package/dist/src/index.d.ts +0 -43
  26. package/dist/src/index.d.ts.map +0 -1
  27. package/dist/src/index.js +0 -154
  28. package/dist/src/index.js.map +0 -1
  29. package/dist/src/mcp/error-mapping.d.ts +0 -67
  30. package/dist/src/mcp/error-mapping.d.ts.map +0 -1
  31. package/dist/src/mcp/error-mapping.js +0 -195
  32. package/dist/src/mcp/error-mapping.js.map +0 -1
  33. package/dist/src/mcp/server.d.ts +0 -86
  34. package/dist/src/mcp/server.d.ts.map +0 -1
  35. package/dist/src/mcp/server.js +0 -216
  36. package/dist/src/mcp/server.js.map +0 -1
  37. package/dist/tsconfig.tsbuildinfo +0 -1
package/README.md CHANGED
@@ -147,7 +147,7 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
147
147
  <!-- AUTO-GENERATED from src/mcp/tools/ descriptions. Do not edit manually. Run `pnpm update-readme` to regenerate. -->
148
148
  ## Available Tools
149
149
 
150
- **`TOOLSETS` categories:** `projects`, `issues`, `comments`, `milestones`, `documents`, `storage`, `attachments`, `contacts`, `channels`, `calendar`, `time tracking`, `search`, `activity`, `notifications`, `workspace`, `cards`, `custom-fields`, `labels`, `leads`, `tag-categories`, `test-management`
150
+ **`TOOLSETS` categories:** `projects`, `issues`, `comments`, `milestones`, `documents`, `storage`, `attachments`, `contacts`, `channels`, `calendar`, `time tracking`, `search`, `activity`, `notifications`, `workspace`, `cards`, `custom-fields`, `labels`, `leads`, `tag-categories`, `task-management`, `test-management`
151
151
 
152
152
  ### Projects
153
153
 
@@ -222,10 +222,10 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
222
222
  | `create_teamspace` | Create a new Huly document teamspace. Idempotent: returns existing teamspace if one with the same name exists. |
223
223
  | `update_teamspace` | Update fields on an existing Huly document teamspace. Only provided fields are modified. Set description to null to clear it. |
224
224
  | `delete_teamspace` | Permanently delete a Huly document teamspace. This action cannot be undone. |
225
- | `list_documents` | List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Supports searching by title substring (titleSearch) and content (contentSearch). |
226
- | `get_document` | Retrieve full details for a Huly document including markdown content. Use this to view document content and metadata. |
227
- | `create_document` | Create a new document in a Huly teamspace. Content supports full markdown including native Mermaid diagrams (```mermaid blocks render interactively in Huly UI). Returns the created document id. Use link_document_to_issue to associate the document with a tracker issue. |
228
- | `edit_document` | Edit an existing Huly document. Two content modes (mutually exclusive): (1) 'content' for full replace, (2) 'old_text' + 'new_text' for targeted search-and-replace. Multiple matches error unless replace_all is true. Empty new_text deletes matched text. Also supports renaming via 'title'. Content supports full markdown including native Mermaid diagrams. |
225
+ | `list_documents` | List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Each result includes a 'url' field pointing to the document in the Huly web app. Supports searching by title substring (titleSearch) and content (contentSearch). |
226
+ | `get_document` | Retrieve full details for a Huly document including markdown content and a 'url' field pointing to the document in the Huly web app. Use this to view document content and metadata. |
227
+ | `create_document` | Create a new document in a Huly teamspace. Content supports full markdown including native Mermaid diagrams (```mermaid blocks render interactively in Huly UI). Returns the created document id and a 'url' field pointing to the document in the Huly web app. Use link_document_to_issue to associate the document with a tracker issue. |
228
+ | `edit_document` | Edit an existing Huly document. Two content modes (mutually exclusive): (1) 'content' for full replace, (2) 'old_text' + 'new_text' for targeted search-and-replace. Multiple matches error unless replace_all is true. Empty new_text deletes matched text. Also supports renaming via 'title'. Content supports full markdown including native Mermaid diagrams. Returns a 'url' field pointing to the document in the Huly web app. |
229
229
  | `list_inline_comments` | List inline comment threads from a Huly document. Extracts comments embedded in document content as ProseMirror marks. Each comment includes the highlighted text and thread ID. Set includeReplies=true to also fetch thread reply messages with sender names. |
230
230
  | `delete_document` | Permanently delete a Huly document. This action cannot be undone. |
231
231
 
@@ -282,6 +282,8 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
282
282
  | `delete_channel` | Permanently delete a Huly channel. This action cannot be undone. |
283
283
  | `list_channel_messages` | List messages in a Huly channel. Returns messages sorted by date (newest first). |
284
284
  | `send_channel_message` | Send a message to a Huly channel. Message body supports markdown formatting. |
285
+ | `update_channel_message` | Update a channel message. Only the body can be modified. |
286
+ | `delete_channel_message` | Permanently delete a channel message. This action cannot be undone. |
285
287
  | `list_direct_messages` | List direct message conversations in Huly. Returns conversations sorted by date (newest first). |
286
288
  | `list_thread_replies` | List replies in a message thread. Returns replies sorted by date (oldest first). |
287
289
  | `add_thread_reply` | Add a reply to a message thread. Reply body supports markdown formatting. |
@@ -412,6 +414,16 @@ MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-m
412
414
  | `update_tag_category` | Update a tag/label category. Accepts category ID or label name. Only provided fields are modified. |
413
415
  | `delete_tag_category` | Permanently delete a tag/label category. Accepts category ID or label name. Labels in this category will be orphaned (not deleted). This action cannot be undone. |
414
416
 
417
+ ### Task-Management
418
+
419
+ | Tool | Description |
420
+ |------|-------------|
421
+ | `list_project_types` | List Huly tracker project types/workflow templates. Returns ID, display name, descriptor, task type count, status count, and whether the type appears to be the default Classic tracker type. |
422
+ | `get_project_type` | Inspect one Huly tracker project type in a single call. Accepts projectType as ID or display name; when omitted, uses the unambiguous Classic tracker type. Returns task types, statuses, categories, and task-type-to-status mappings. |
423
+ | `list_task_types` | List Huly issue/task types. Optionally filter by projectType ID or display name. Returns task type identity, parent project type, kind, issue class, and available status count. |
424
+ | `create_task_type` | Add a Huly issue/task type to a project type idempotently by normalized name. Copies required workflow configuration from an existing template task type unless templateTaskType is supplied. Returns created, IDs, affected task type IDs, and a workspace-level workflow warning. |
425
+ | `create_issue_status` | Add a Huly issue workflow status idempotently by normalized name within a project type and task type scope. Accepts category as backlog, todo, active, done, or canceled; taskType may be ID or display name, and omission applies the status to every task type in the project type. |
426
+
415
427
  ### Test-Management
416
428
 
417
429
  | Tool | Description |