@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 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**: Tools that return large content use in-memory buffering with pagination support. See the Buffer Tools section for content retrieval.
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 (up to 5000).
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- **Response includes**: `worklogCount`, `totalTimeSpentSeconds`, `totalTimeSpent`, `worklogs`
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
- **Response includes**: Breakdown by issue and grand total including:
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 (up to 5000).
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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, after=ID, content/plantuml/fromBufferId)` → `confluence_draft_create(pageId, bufferId)` → user publishes
340
- > - **Create new**: `confluence_draft_create(spaceKey, title, content)` → user review → user publishes
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- Large responses are automatically buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- **Response includes**: `drafts` array with `draftId`, `title`, `spaceKey`, `spaceName`, `created`, `url`
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
- | content/bufferId | string | ✓ | Content (storage format) or buffer ID |
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 editing existing page**:
514
+ **Workflow for new page (buffer-first)**:
508
515
  ```
509
- 1. confluence_get_page(pageId) → bufferId, structure
510
- 2. buffer_edit(bufferId, ...) modify content
511
- 3. confluence_draft_create(pageId=..., bufferId=...) → draft for review
512
- 4. User reviews and publishes in Confluence UI (updates original page)
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 new page**:
525
+ **Workflow for editing existing page**:
516
526
  ```
517
- 1. confluence_draft_create(spaceKey, title, content) → draftId, bufferId, url
518
- 2. User clicks URL to preview
519
- 3. buffer_edit(bufferId, ...) → modify if needed
520
- 4. confluence_draft_save(draftId, bufferId) → checkpoint
521
- 5. User publishes via Confluence UI
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. Large responses are buffered.
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
- Large responses are buffered - use `buffer_get_chunk` or `buffer_grep` to access.
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
- **Response includes**: `totalTimeSpent`, `totalWorklogCount`, `issueCount`, breakdown by issue, and full worklog list.
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
- Tools that return large content (Confluence pages, Jira issues, Tempo worklogs) use an in-memory buffering system for efficient content pagination.
1429
-
1430
- **How It Works:**
1431
- 1. **Initial Call**: When you call a tool like `confluence_get_page`, it fetches the full content and stores it in a buffer
1432
- 2. **Chunked Response**: The response includes a `bufferId`, the first chunk of content (default 5000 chars), and pagination info
1433
- 3. **Retrieve More**: Use `buffer_get_chunk` with the `bufferId` to get subsequent chunks
1434
-
1435
- **Buffered Response Format:**
1436
- - `bufferId`: Unique identifier for retrieving more content
1437
- - `content`: The current chunk of content
1438
- - `offset`: Starting position of this chunk
1439
- - `limit`: Maximum characters returned
1440
- - `totalSize`: Total size of buffered content
1441
- - `hasMore`: Whether more content is available
1442
-
1443
- **Auto-Buffered Tools:**
1444
- - `confluence_get_page`, `confluence_get_page_by_title`
1445
- - `jira_get_issue`, `jira_search_issues`
1446
- - `tempo_get_worklogs`, `tempo_get_team_worklogs`
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
- content: z.ZodOptional<z.ZodString>;
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
- content?: string | undefined;
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
- content?: string | undefined;
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
- content?: string;
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":"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"}
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/confluence/tools.ts"],"names":[],"mappings":"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"}