@crypto512/jicon-mcp 1.2.0 → 1.3.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.
- package/README.md +23 -0
- package/TOOL_LIST.md +95 -60
- package/crypto512-jicon-mcp-1.3.0.tgz +0 -0
- package/dist/confluence/tools.d.ts +4 -12
- package/dist/confluence/tools.d.ts.map +1 -1
- package/dist/confluence/tools.js +137 -140
- package/dist/confluence/tools.js.map +1 -1
- package/dist/jira/tools.d.ts.map +1 -1
- package/dist/jira/tools.js +76 -25
- package/dist/jira/tools.js.map +1 -1
- package/dist/tempo/tools.d.ts.map +1 -1
- package/dist/tempo/tools.js +74 -22
- package/dist/tempo/tools.js.map +1 -1
- package/dist/utils/jicon-help.d.ts +1 -1
- package/dist/utils/jicon-help.d.ts.map +1 -1
- package/dist/utils/jicon-help.js +93 -72
- package/dist/utils/jicon-help.js.map +1 -1
- package/dist/utils/response-formatter.d.ts +13 -0
- package/dist/utils/response-formatter.d.ts.map +1 -1
- package/dist/utils/response-formatter.js +25 -0
- package/dist/utils/response-formatter.js.map +1 -1
- package/dist/utils/xhtml/types.d.ts +1 -0
- package/dist/utils/xhtml/types.d.ts.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -296,6 +296,29 @@ This achieves "draft before publish" semantics within API constraints.
|
|
|
296
296
|
|
|
297
297
|
Plus utility tools for content buffering, time calculations, URL generation, and built-in help.
|
|
298
298
|
|
|
299
|
+
### Buffered Responses
|
|
300
|
+
|
|
301
|
+
All data-heavy tools (search, list, get) return **buffered responses** for efficient handling of large datasets. Instead of returning raw data, tools return a `bufferId` with metadata:
|
|
302
|
+
|
|
303
|
+
```json
|
|
304
|
+
{
|
|
305
|
+
"bufferId": "buf_abc123",
|
|
306
|
+
"metadata": {
|
|
307
|
+
"resourceType": "jira_search",
|
|
308
|
+
"title": "JQL: project = PROJ AND status = 'In Progress'"
|
|
309
|
+
},
|
|
310
|
+
"totalSize": 125000,
|
|
311
|
+
"hint": "Use buffer_get_chunk(bufferId) to read, buffer_grep(bufferId, pattern) to search"
|
|
312
|
+
}
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
**Working with buffers:**
|
|
316
|
+
- `buffer_get_chunk(bufferId, offset, limit)` - Read data in chunks
|
|
317
|
+
- `buffer_grep(bufferId, pattern)` - Search within buffered data
|
|
318
|
+
- `buffer_list()` - List all active buffers with metadata
|
|
319
|
+
|
|
320
|
+
The buffer metadata includes `resourceType` and `title` to track origin (e.g., which query or resource the data came from).
|
|
321
|
+
|
|
299
322
|
### Safe Confluence Editing (Review Workflow)
|
|
300
323
|
|
|
301
324
|
Confluence write operations use a **review workflow** for safety:
|
package/TOOL_LIST.md
CHANGED
|
@@ -15,14 +15,14 @@ This document provides a comprehensive reference of all available tools in the J
|
|
|
15
15
|
- **Jicon Help Tools**: 1
|
|
16
16
|
- **PlantUML Tools**: 3
|
|
17
17
|
|
|
18
|
-
**Note**:
|
|
18
|
+
**Note**: All data-heavy tools (search, list, get) **always** return buffered responses with metadata for origin tracking. Use `buffer_get_chunk` to read and `buffer_grep` to search. See the Buffer Tools section for details.
|
|
19
19
|
|
|
20
20
|
---
|
|
21
21
|
|
|
22
22
|
## Jira Tools (18)
|
|
23
23
|
|
|
24
24
|
### 1. jira_search_issues
|
|
25
|
-
**Description**: Search for Jira issues using JQL. Auto-fetches all results
|
|
25
|
+
**Description**: Search for Jira issues using JQL. Auto-fetches all results.
|
|
26
26
|
**Use Cases**: Find bugs, filter by status, search by assignee, complex queries
|
|
27
27
|
|
|
28
28
|
| Parameter | Type | Required | Description |
|
|
@@ -30,7 +30,7 @@ This document provides a comprehensive reference of all available tools in the J
|
|
|
30
30
|
| jql | string | ✓ | JQL query string |
|
|
31
31
|
| fields | string[] | ✗ | Specific fields to return |
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_search", title: "JQL: ..."}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
@@ -44,7 +44,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
44
44
|
| fields | string[] | ✗ | Specific fields to return |
|
|
45
45
|
| expand | string[] | ✗ | Additional data (e.g., "changelog", "renderedFields") |
|
|
46
46
|
|
|
47
|
-
|
|
47
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_issue", title: "PROJ-123: Summary", issueId, projectKey}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
48
48
|
|
|
49
49
|
---
|
|
50
50
|
|
|
@@ -112,7 +112,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
112
112
|
| issueKey | string | ✓ | Issue key |
|
|
113
113
|
| orderBy | string | ✗ | Sort order ("created" or "-created") |
|
|
114
114
|
|
|
115
|
-
|
|
115
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_comments", title: "PROJ-123 comments", issueKey}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
116
116
|
|
|
117
117
|
---
|
|
118
118
|
|
|
@@ -125,6 +125,8 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
125
125
|
| recent | boolean | ✗ | Only recent projects |
|
|
126
126
|
| expand | string[] | ✗ | Additional data to expand |
|
|
127
127
|
|
|
128
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_projects", title: "All Projects"}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
129
|
+
|
|
128
130
|
---
|
|
129
131
|
|
|
130
132
|
### 9. jira_get_project
|
|
@@ -136,6 +138,8 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
136
138
|
| projectKey | string | ✓ | Project key |
|
|
137
139
|
| expand | string[] | ✗ | Additional data to expand |
|
|
138
140
|
|
|
141
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_project", title: "Project Name", projectKey}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
142
|
+
|
|
139
143
|
---
|
|
140
144
|
|
|
141
145
|
### 10. jira_get_issue_types
|
|
@@ -181,6 +185,8 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
181
185
|
|-----------|------|----------|-------------|
|
|
182
186
|
| boardId | number | ✓ | Board ID |
|
|
183
187
|
|
|
188
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_board", title: "Board Name", boardId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
189
|
+
|
|
184
190
|
---
|
|
185
191
|
|
|
186
192
|
### 14. jira_get_sprints
|
|
@@ -192,7 +198,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
192
198
|
| boardId | number | ✓ | Board ID |
|
|
193
199
|
| state | string | ✗ | Sprint state ("active", "future", "closed") |
|
|
194
200
|
|
|
195
|
-
|
|
201
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_sprints", title: "Board #123 sprints", boardId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
196
202
|
|
|
197
203
|
---
|
|
198
204
|
|
|
@@ -204,7 +210,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
204
210
|
|-----------|------|----------|-------------|
|
|
205
211
|
| sprintId | number | ✓ | Sprint ID |
|
|
206
212
|
|
|
207
|
-
|
|
213
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_sprint_issues", title: "Sprint #456 issues", sprintId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
208
214
|
|
|
209
215
|
---
|
|
210
216
|
|
|
@@ -226,9 +232,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
226
232
|
|-----------|------|----------|-------------|
|
|
227
233
|
| issueKey | string | ✓ | Issue key (e.g., PROJ-123) |
|
|
228
234
|
|
|
229
|
-
**
|
|
230
|
-
|
|
231
|
-
Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
|
|
235
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_worklogs", title: "PROJ-123 worklogs", issueKey}`. Includes `worklogCount`, `totalTimeSpentSeconds`, `totalTimeSpent`, `worklogs`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
232
236
|
|
|
233
237
|
---
|
|
234
238
|
|
|
@@ -240,17 +244,14 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
240
244
|
|-----------|------|----------|-------------|
|
|
241
245
|
| issueKey | string | ✓ | Issue key (e.g., PROJ-123) |
|
|
242
246
|
|
|
243
|
-
**
|
|
244
|
-
- The specified issue
|
|
245
|
-
- All sub-tasks
|
|
246
|
-
- All issues in the Epic (if the issue is an Epic)
|
|
247
|
+
**Returns**: `bufferId` with metadata `{resourceType: "jira_worklogs_total", title: "PROJ-123 total worklogs (recursive)", issueKey}`. Includes breakdown by issue and grand total for the issue, sub-tasks, and Epic children.
|
|
247
248
|
|
|
248
249
|
---
|
|
249
250
|
|
|
250
251
|
## Confluence Tools (21)
|
|
251
252
|
|
|
252
253
|
### 1. confluence_search_content
|
|
253
|
-
**Description**: Search Confluence content using CQL. Auto-fetches all results
|
|
254
|
+
**Description**: Search Confluence content using CQL. Auto-fetches all results.
|
|
254
255
|
**Use Cases**: Find pages, search by keyword, filter by space
|
|
255
256
|
|
|
256
257
|
| Parameter | Type | Required | Description |
|
|
@@ -258,7 +259,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
258
259
|
| cql | string | ✓ | CQL query string |
|
|
259
260
|
| expand | string[] | ✗ | Additional data to expand |
|
|
260
261
|
|
|
261
|
-
|
|
262
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_search", title: "CQL: ..."}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
262
263
|
|
|
263
264
|
---
|
|
264
265
|
|
|
@@ -336,9 +337,10 @@ buffer_edit(bufferId=pageBuffer, after=5, fromBufferId=newContentBuffer)
|
|
|
336
337
|
|
|
337
338
|
> **Note**: All page content changes go through the draft workflow.
|
|
338
339
|
> AI creates/edits drafts; user publishes manually via Confluence UI:
|
|
339
|
-
> - **Edit existing**: `confluence_edit(input)` → `buffer_edit(bufferId,
|
|
340
|
-
> - **Create new**: `confluence_draft_create(spaceKey, title,
|
|
340
|
+
> - **Edit existing**: `confluence_edit(input)` → `buffer_edit(bufferId, ...)` → `buffer_validate_xhtml(bufferId)` → `confluence_draft_create(pageId, bufferId)` → user publishes
|
|
341
|
+
> - **Create new**: `buffer_create(content, contentType="xhtml")` → `buffer_validate_xhtml(bufferId)` → `confluence_draft_create(spaceKey, title, bufferId)` → user publishes
|
|
341
342
|
> - **After publish**: Draft ID becomes invalid; use `confluence_edit("SPACE/Title")` to edit again
|
|
343
|
+
> - **XHTML syntax**: Call `help(topic="storage")` for HTML vs XHTML differences
|
|
342
344
|
|
|
343
345
|
---
|
|
344
346
|
|
|
@@ -360,7 +362,7 @@ buffer_edit(bufferId=pageBuffer, after=5, fromBufferId=newContentBuffer)
|
|
|
360
362
|
|-----------|------|----------|-------------|
|
|
361
363
|
| type | string | ✗ | Space type filter ("global" or "personal") |
|
|
362
364
|
|
|
363
|
-
|
|
365
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_spaces", title: "All Spaces"}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
364
366
|
|
|
365
367
|
---
|
|
366
368
|
|
|
@@ -373,6 +375,8 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
373
375
|
| spaceKey | string | ✓ | Space key |
|
|
374
376
|
| expand | string[] | ✗ | Additional data to expand |
|
|
375
377
|
|
|
378
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_space", title: "Space Name", spaceKey}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
379
|
+
|
|
376
380
|
---
|
|
377
381
|
|
|
378
382
|
### 8. confluence_get_page_children
|
|
@@ -384,7 +388,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
384
388
|
| pageId | string | ✓ | Parent page ID (accepts string or number) |
|
|
385
389
|
| expand | string[] | ✗ | Additional data to expand |
|
|
386
390
|
|
|
387
|
-
|
|
391
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_page_children", title: "Page 123 children", pageId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
388
392
|
|
|
389
393
|
---
|
|
390
394
|
|
|
@@ -407,7 +411,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
407
411
|
|-----------|------|----------|-------------|
|
|
408
412
|
| pageId | string | ✓ | Page ID (accepts string or number) |
|
|
409
413
|
|
|
410
|
-
|
|
414
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_comments", title: "Page 123 comments", pageId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
411
415
|
|
|
412
416
|
---
|
|
413
417
|
|
|
@@ -431,7 +435,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
431
435
|
|-----------|------|----------|-------------|
|
|
432
436
|
| pageId | string | ✓ | Page ID (accepts string or number) |
|
|
433
437
|
|
|
434
|
-
|
|
438
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_attachments", title: "Page 123 attachments", pageId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
435
439
|
|
|
436
440
|
---
|
|
437
441
|
|
|
@@ -456,9 +460,8 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
456
460
|
| Parameter | Type | Required | Description |
|
|
457
461
|
|-----------|------|----------|-------------|
|
|
458
462
|
| spaceKey | string | ✗ | Filter by space key |
|
|
459
|
-
| limit | number | ✗ | Maximum results (default: 25) |
|
|
460
463
|
|
|
461
|
-
**
|
|
464
|
+
**Returns**: `bufferId` with metadata `{resourceType: "confluence_drafts", title: "All Drafts"}`. Includes `drafts` array with `draftId`, `title`, `spaceKey`, `spaceName`, `created`, `url`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
462
465
|
|
|
463
466
|
---
|
|
464
467
|
|
|
@@ -480,6 +483,8 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
480
483
|
**Description**: Create a draft for user review - either a new page or as an edit to an existing page
|
|
481
484
|
**Use Cases**: Start new page as draft, edit existing page through draft workflow
|
|
482
485
|
|
|
486
|
+
**REQUIRES `bufferId`** - content must be in a buffer for validation and error recovery.
|
|
487
|
+
|
|
483
488
|
**Two Modes:**
|
|
484
489
|
|
|
485
490
|
1. **NEW PAGE**: Create a standalone draft
|
|
@@ -487,7 +492,7 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
487
492
|
|-----------|------|----------|-------------|
|
|
488
493
|
| spaceKey | string | ✓ | Space key |
|
|
489
494
|
| title | string | ✓ | Draft title |
|
|
490
|
-
|
|
|
495
|
+
| bufferId | string | ✓ | Buffer ID from `buffer_create(contentType="xhtml")` |
|
|
491
496
|
| parentId | string | ✗ | Parent page ID |
|
|
492
497
|
| labels | string[] | ✗ | Array of labels |
|
|
493
498
|
|
|
@@ -502,25 +507,36 @@ Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_g
|
|
|
502
507
|
|
|
503
508
|
**Response includes**: `draftId`, `bufferId`, `structure` (element IDs), `title`, `spaceKey`, `version`, `url` (clickable to preview), `contentSummary`, `editingExistingPage` (when editing)
|
|
504
509
|
|
|
510
|
+
**On validation error**: Returns `bufferId`, `errorElementId`, and `errorContext` for surgical fix with `buffer_edit`.
|
|
511
|
+
|
|
505
512
|
**PlantUML**: Raw @startuml blocks are not supported. Use `buffer_edit` with `plantuml` parameter.
|
|
506
513
|
|
|
507
|
-
**Workflow for
|
|
514
|
+
**Workflow for new page (buffer-first)**:
|
|
508
515
|
```
|
|
509
|
-
1.
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
516
|
+
1. buffer_create(content="<h1>Title</h1><p>Content</p>", contentType="xhtml")
|
|
517
|
+
→ bufferId, structure (element IDs)
|
|
518
|
+
2. buffer_validate_xhtml(bufferId)
|
|
519
|
+
→ If errors: buffer_edit(bufferId, replace=errorElementId, content="<fixed>")
|
|
520
|
+
3. confluence_draft_create(spaceKey, title, bufferId)
|
|
521
|
+
→ draftId, url for preview
|
|
522
|
+
4. User reviews and publishes via Confluence UI
|
|
513
523
|
```
|
|
514
524
|
|
|
515
|
-
**Workflow for
|
|
525
|
+
**Workflow for editing existing page**:
|
|
516
526
|
```
|
|
517
|
-
1.
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
527
|
+
1. confluence_get_page(pageId) or confluence_edit(input)
|
|
528
|
+
→ bufferId, structure
|
|
529
|
+
2. buffer_edit(bufferId, after=ID, content/plantuml)
|
|
530
|
+
→ modify content
|
|
531
|
+
3. buffer_validate_xhtml(bufferId)
|
|
532
|
+
→ check for errors
|
|
533
|
+
4. confluence_draft_create(pageId=..., bufferId=...)
|
|
534
|
+
→ draft for review
|
|
535
|
+
5. User reviews and publishes in Confluence UI (updates original page)
|
|
522
536
|
```
|
|
523
537
|
|
|
538
|
+
**Why buffer-first?** Enables validation with element IDs for surgical error fixing. Call `help(topic="storage")` for XHTML syntax (HTML vs XHTML differences).
|
|
539
|
+
|
|
524
540
|
---
|
|
525
541
|
|
|
526
542
|
### 17. confluence_draft_save
|
|
@@ -717,7 +733,9 @@ AND lastModified >= now("-30d")
|
|
|
717
733
|
| issueKey | string | ✗ | Filter by issue key (e.g., PROJ-123) |
|
|
718
734
|
| workerKey | string | ✗ | Filter by worker username (get from tempo_get_user_info). Leave empty for ALL worklogs. |
|
|
719
735
|
|
|
720
|
-
**WARNING**: No workerKey = returns ALL worklogs.
|
|
736
|
+
**WARNING**: No workerKey = returns ALL worklogs.
|
|
737
|
+
|
|
738
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_worklogs", title: "Worklogs 2024-01-01 to 2024-01-31"}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
721
739
|
|
|
722
740
|
---
|
|
723
741
|
|
|
@@ -729,6 +747,8 @@ AND lastModified >= now("-30d")
|
|
|
729
747
|
|-----------|------|----------|-------------|
|
|
730
748
|
| worklogId | number | ✓ | Tempo worklog ID |
|
|
731
749
|
|
|
750
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_worklog", title: "PROJ-123 worklog #456", resourceId, issueKey}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
751
|
+
|
|
732
752
|
---
|
|
733
753
|
|
|
734
754
|
### 3. tempo_log_work
|
|
@@ -777,6 +797,8 @@ AND lastModified >= now("-30d")
|
|
|
777
797
|
|-----------|------|----------|-------------|
|
|
778
798
|
| (none) | | | |
|
|
779
799
|
|
|
800
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_accounts", title: "All Tempo Accounts"}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
801
|
+
|
|
780
802
|
---
|
|
781
803
|
|
|
782
804
|
### 7. tempo_get_account
|
|
@@ -787,6 +809,8 @@ AND lastModified >= now("-30d")
|
|
|
787
809
|
|-----------|------|----------|-------------|
|
|
788
810
|
| accountKey | string | ✓ | Account key |
|
|
789
811
|
|
|
812
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_account", title: "Account Name", accountKey}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
813
|
+
|
|
790
814
|
---
|
|
791
815
|
|
|
792
816
|
### 8. tempo_get_teams
|
|
@@ -797,6 +821,8 @@ AND lastModified >= now("-30d")
|
|
|
797
821
|
|-----------|------|----------|-------------|
|
|
798
822
|
| (none) | | | |
|
|
799
823
|
|
|
824
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_teams", title: "All Tempo Teams"}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
825
|
+
|
|
800
826
|
---
|
|
801
827
|
|
|
802
828
|
### 9. tempo_get_team
|
|
@@ -807,6 +833,8 @@ AND lastModified >= now("-30d")
|
|
|
807
833
|
|-----------|------|----------|-------------|
|
|
808
834
|
| teamId | number | ✓ | Team ID |
|
|
809
835
|
|
|
836
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_team", title: "Team Name", teamId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
837
|
+
|
|
810
838
|
---
|
|
811
839
|
|
|
812
840
|
### 10. tempo_get_team_worklogs
|
|
@@ -819,7 +847,7 @@ AND lastModified >= now("-30d")
|
|
|
819
847
|
| dateFrom | string | ✓ | Start date (YYYY-MM-DD) |
|
|
820
848
|
| dateTo | string | ✓ | End date (YYYY-MM-DD) |
|
|
821
849
|
|
|
822
|
-
|
|
850
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_team_worklogs", title: "Team #123 worklogs 2024-01-01 to 2024-01-31", teamId}`. Use `buffer_get_chunk` to read, `buffer_grep` to search.
|
|
823
851
|
|
|
824
852
|
---
|
|
825
853
|
|
|
@@ -845,9 +873,7 @@ Large responses are buffered - use `buffer_get_chunk` or `buffer_grep` to access
|
|
|
845
873
|
| dateFrom | string | ✗ | Start date filter (YYYY-MM-DD) |
|
|
846
874
|
| dateTo | string | ✗ | End date filter (YYYY-MM-DD) |
|
|
847
875
|
|
|
848
|
-
**
|
|
849
|
-
|
|
850
|
-
More efficient than `jira_get_total_worklogs` for Tempo instances. Large responses are buffered.
|
|
876
|
+
**Returns**: `bufferId` with metadata `{resourceType: "tempo_epic_worklogs", title: "PROJ-100 epic worklogs", epicKey}`. Includes `totalTimeSpent`, `totalWorklogCount`, `issueCount`, breakdown by issue, and full worklog list. Use `buffer_get_chunk` to read, `buffer_grep` to search. More efficient than `jira_get_total_worklogs` for Tempo instances.
|
|
851
877
|
|
|
852
878
|
---
|
|
853
879
|
|
|
@@ -1425,25 +1451,34 @@ When using Jicon with AI assistants (Claude, GPT, etc.), follow these patterns f
|
|
|
1425
1451
|
|
|
1426
1452
|
### Content Buffering
|
|
1427
1453
|
|
|
1428
|
-
|
|
1429
|
-
|
|
1430
|
-
**
|
|
1431
|
-
|
|
1432
|
-
|
|
1433
|
-
|
|
1434
|
-
|
|
1435
|
-
|
|
1436
|
-
|
|
1437
|
-
|
|
1438
|
-
|
|
1439
|
-
|
|
1440
|
-
|
|
1441
|
-
|
|
1442
|
-
|
|
1443
|
-
**
|
|
1444
|
-
- `
|
|
1445
|
-
- `
|
|
1446
|
-
|
|
1454
|
+
All data-heavy tools (search, list, get) **always** return buffered responses with metadata for origin tracking.
|
|
1455
|
+
|
|
1456
|
+
**Response Format:**
|
|
1457
|
+
```json
|
|
1458
|
+
{
|
|
1459
|
+
"bufferId": "buf_abc123",
|
|
1460
|
+
"metadata": {
|
|
1461
|
+
"resourceType": "jira_search",
|
|
1462
|
+
"title": "JQL: project = PROJ AND status = 'In Progress'"
|
|
1463
|
+
},
|
|
1464
|
+
"totalSize": 125000,
|
|
1465
|
+
"hint": "Use buffer_get_chunk(bufferId) to read, buffer_grep(bufferId, pattern) to search"
|
|
1466
|
+
}
|
|
1467
|
+
```
|
|
1468
|
+
|
|
1469
|
+
**Metadata Fields:**
|
|
1470
|
+
- `resourceType`: Type of resource (e.g., `jira_issue`, `confluence_page`, `tempo_worklogs`)
|
|
1471
|
+
- `title`: Human-readable description of the buffered content origin
|
|
1472
|
+
|
|
1473
|
+
**Working with Buffers:**
|
|
1474
|
+
- `buffer_get_chunk(bufferId, offset, limit)` - Read data in chunks
|
|
1475
|
+
- `buffer_grep(bufferId, pattern)` - Search within buffered data
|
|
1476
|
+
- `buffer_list()` - List all active buffers with their metadata
|
|
1477
|
+
|
|
1478
|
+
**Always-Buffered Tools:**
|
|
1479
|
+
- **Jira**: `jira_search_issues`, `jira_get_issue`, `jira_list_projects`, `jira_get_project`, `jira_get_board`, `jira_get_sprints`, `jira_get_sprint_issues`, `jira_get_issue_comments`, `jira_get_issue_worklogs`, `jira_get_total_worklogs`
|
|
1480
|
+
- **Confluence**: `confluence_search_content`, `confluence_list_spaces`, `confluence_get_space`, `confluence_get_page_children`, `confluence_get_comments`, `confluence_list_attachments`, `confluence_draft_list`
|
|
1481
|
+
- **Tempo**: `tempo_get_worklogs`, `tempo_get_worklog`, `tempo_get_accounts`, `tempo_get_account`, `tempo_get_teams`, `tempo_get_team`, `tempo_get_team_worklogs`, `tempo_get_epic_worklogs`
|
|
1447
1482
|
|
|
1448
1483
|
**Buffer Management:**
|
|
1449
1484
|
- **TTL**: Buffers expire after 1 hour by default; edited buffers reset to 1 day TTL
|
|
Binary file
|
|
@@ -208,22 +208,19 @@ export declare function createConfluenceTools(client: ConfluenceClient): {
|
|
|
208
208
|
pageId: z.ZodOptional<z.ZodString>;
|
|
209
209
|
spaceKey: z.ZodOptional<z.ZodString>;
|
|
210
210
|
title: z.ZodOptional<z.ZodString>;
|
|
211
|
-
|
|
212
|
-
bufferId: z.ZodOptional<z.ZodString>;
|
|
211
|
+
bufferId: z.ZodString;
|
|
213
212
|
parentId: z.ZodOptional<z.ZodString>;
|
|
214
213
|
labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
|
|
215
214
|
}, "strip", z.ZodTypeAny, {
|
|
216
|
-
|
|
215
|
+
bufferId: string;
|
|
217
216
|
labels?: string[] | undefined;
|
|
218
|
-
bufferId?: string | undefined;
|
|
219
217
|
spaceKey?: string | undefined;
|
|
220
218
|
title?: string | undefined;
|
|
221
219
|
pageId?: string | undefined;
|
|
222
220
|
parentId?: string | undefined;
|
|
223
221
|
}, {
|
|
224
|
-
|
|
222
|
+
bufferId: string;
|
|
225
223
|
labels?: string[] | undefined;
|
|
226
|
-
bufferId?: string | undefined;
|
|
227
224
|
spaceKey?: string | undefined;
|
|
228
225
|
title?: string | undefined;
|
|
229
226
|
pageId?: string | undefined;
|
|
@@ -233,8 +230,7 @@ export declare function createConfluenceTools(client: ConfluenceClient): {
|
|
|
233
230
|
pageId?: string;
|
|
234
231
|
spaceKey?: string;
|
|
235
232
|
title?: string;
|
|
236
|
-
|
|
237
|
-
bufferId?: string;
|
|
233
|
+
bufferId: string;
|
|
238
234
|
parentId?: string;
|
|
239
235
|
labels?: string[];
|
|
240
236
|
}) => Promise<ToolResult>;
|
|
@@ -256,17 +252,13 @@ export declare function createConfluenceTools(client: ConfluenceClient): {
|
|
|
256
252
|
description: string;
|
|
257
253
|
inputSchema: z.ZodObject<{
|
|
258
254
|
spaceKey: z.ZodOptional<z.ZodString>;
|
|
259
|
-
limit: z.ZodOptional<z.ZodNumber>;
|
|
260
255
|
}, "strip", z.ZodTypeAny, {
|
|
261
256
|
spaceKey?: string | undefined;
|
|
262
|
-
limit?: number | undefined;
|
|
263
257
|
}, {
|
|
264
258
|
spaceKey?: string | undefined;
|
|
265
|
-
limit?: number | undefined;
|
|
266
259
|
}>;
|
|
267
260
|
handler: (args: {
|
|
268
261
|
spaceKey?: string;
|
|
269
|
-
limit?: number;
|
|
270
262
|
}) => Promise<ToolResult>;
|
|
271
263
|
};
|
|
272
264
|
confluence_draft_save: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/confluence/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAS/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/confluence/tools.ts"],"names":[],"mappings":"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"}
|