@intangle/mcp-server 2.5.6 → 2.6.1

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.
@@ -49,50 +49,404 @@ const TOOL_DEFINITIONS = [
49
49
  }
50
50
  }
51
51
  },
52
- // PROJECTS DISABLED - Projects have been disabled. May be re-enabled later.
53
- // {
54
- // name: "view_projects",
55
- // title: "View Projects",
56
- // description:
57
- // "List all projects in a space. Projects are user-created canvases that organize context, tasks, documents, and skills. Use this to discover available projects before viewing their contents.",
58
- // inputSchema: {
59
- // type: "object",
60
- // properties: {
61
- // space_id: {
62
- // type: "string",
63
- // description:
64
- // "REQUIRED: Space to list projects from (use view_spaces to see available options)"
65
- // }
66
- // },
67
- // required: ["space_id"]
68
- // }
69
- // },
70
- // {
71
- // name: "view_project",
72
- // title: "View Project",
73
- // description:
74
- // "View a specific project with all its items (context, tasks, documents, skills). Returns item metadata (IDs, titles, types, status) for each item in the project. Use fetch_items to get full content of specific items.",
75
- // inputSchema: {
76
- // type: "object",
77
- // properties: {
78
- // project_id: {
79
- // type: "string",
80
- // description:
81
- // "Project ID to view (e.g., 'proj_123...'). Get project IDs from view_projects."
82
- // },
83
- // space_id: {
84
- // type: "string",
85
- // description:
86
- // "Optional: Space ID (required if using slug instead of project_id)"
87
- // },
88
- // slug: {
89
- // type: "string",
90
- // description:
91
- // "Optional: Project slug (URL-friendly name). Requires space_id if used."
92
- // }
93
- // }
94
- // }
95
- // },
52
+ {
53
+ name: "fetch_conversation_messages",
54
+ title: "Fetch Conversation Messages",
55
+ description:
56
+ "Read persisted messages from a conversation/chat summary. Useful for polling shared threads after async `message` calls or when multiple participants are collaborating in the same conversation. Returns stable message IDs and timestamps so callers can dedupe and continue from `next_cursor`.",
57
+ inputSchema: {
58
+ type: "object",
59
+ properties: {
60
+ space_id: {
61
+ type: "string",
62
+ description:
63
+ "REQUIRED: Space containing the conversation (use view_spaces first)."
64
+ },
65
+ conversation_id: {
66
+ type: "string",
67
+ description:
68
+ "REQUIRED: Chat summary / conversation ID to read (e.g. 'summary_123...')."
69
+ },
70
+ organization_id: {
71
+ type: "string",
72
+ description:
73
+ "Optional Clerk org ID when the space belongs to an organization graph."
74
+ },
75
+ since_timestamp: {
76
+ type: "integer",
77
+ description:
78
+ "Optional millisecond cursor. Only messages newer than this timestamp are returned."
79
+ },
80
+ limit: {
81
+ type: "integer",
82
+ description:
83
+ "Optional page size from 1 to 200 (default 50)."
84
+ }
85
+ },
86
+ required: ["space_id", "conversation_id"]
87
+ }
88
+ },
89
+ {
90
+ name: "subscribe_conversation",
91
+ title: "Subscribe Conversation",
92
+ description:
93
+ "Register a participant in a shared conversation so it can use inbox and read-cursor tools without first sending a message. By default the subscription starts caught up at the latest message.",
94
+ inputSchema: {
95
+ type: "object",
96
+ properties: {
97
+ space_id: {
98
+ type: "string",
99
+ description:
100
+ "REQUIRED: Space containing the conversation (use view_spaces first)."
101
+ },
102
+ conversation_id: {
103
+ type: "string",
104
+ description:
105
+ "REQUIRED: Chat summary / conversation ID to subscribe to."
106
+ },
107
+ organization_id: {
108
+ type: "string",
109
+ description:
110
+ "Optional Clerk org ID when the space belongs to an organization graph."
111
+ },
112
+ participant_id: {
113
+ type: "string",
114
+ description:
115
+ "Optional stable participant ID. Use an explicit `user_*` or `agent_*` style ID when you want the same participant identity reused across calls."
116
+ },
117
+ participant_type: {
118
+ type: "string",
119
+ description:
120
+ "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
121
+ },
122
+ participant_label: {
123
+ type: "string",
124
+ description:
125
+ "Optional display label for the participant in collaborative chat UIs."
126
+ },
127
+ mark_read: {
128
+ type: "boolean",
129
+ description:
130
+ "Optional. Defaults to true. When true, the subscription starts caught up at the current latest message."
131
+ }
132
+ },
133
+ required: ["space_id", "conversation_id"]
134
+ }
135
+ },
136
+ {
137
+ name: "list_conversation_inbox",
138
+ title: "List Conversation Inbox",
139
+ description:
140
+ "List the conversations a participant is subscribed to in one space, with unread counts and read cursors. Use this to poll multiple shared threads efficiently.",
141
+ inputSchema: {
142
+ type: "object",
143
+ properties: {
144
+ space_id: {
145
+ type: "string",
146
+ description:
147
+ "REQUIRED: Space to list inbox conversations from (use view_spaces first)."
148
+ },
149
+ organization_id: {
150
+ type: "string",
151
+ description:
152
+ "Optional Clerk org ID when the space belongs to an organization graph."
153
+ },
154
+ participant_id: {
155
+ type: "string",
156
+ description:
157
+ "Optional stable participant ID. Use the same value you used for message/subscribe calls to read the same inbox."
158
+ },
159
+ participant_type: {
160
+ type: "string",
161
+ description:
162
+ "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
163
+ },
164
+ participant_label: {
165
+ type: "string",
166
+ description:
167
+ "Optional display label used when the participant identity is being created for the first time."
168
+ },
169
+ unread_only: {
170
+ type: "boolean",
171
+ description:
172
+ "Optional. When true, only return conversations that currently have unread messages."
173
+ },
174
+ since_timestamp: {
175
+ type: "integer",
176
+ description:
177
+ "Optional millisecond cursor. Only conversations updated after this timestamp are returned."
178
+ },
179
+ limit: {
180
+ type: "integer",
181
+ description:
182
+ "Optional page size from 1 to 200 (default 50)."
183
+ }
184
+ },
185
+ required: ["space_id"]
186
+ }
187
+ },
188
+ {
189
+ name: "mark_conversation_read",
190
+ title: "Mark Conversation Read",
191
+ description:
192
+ "Advance a participant's read cursor for a shared conversation. Use this after processing messages returned from fetch_conversation_messages.",
193
+ inputSchema: {
194
+ type: "object",
195
+ properties: {
196
+ space_id: {
197
+ type: "string",
198
+ description:
199
+ "REQUIRED: Space containing the conversation (use view_spaces first)."
200
+ },
201
+ conversation_id: {
202
+ type: "string",
203
+ description:
204
+ "REQUIRED: Chat summary / conversation ID to mark as read."
205
+ },
206
+ organization_id: {
207
+ type: "string",
208
+ description:
209
+ "Optional Clerk org ID when the space belongs to an organization graph."
210
+ },
211
+ participant_id: {
212
+ type: "string",
213
+ description:
214
+ "Optional stable participant ID. Use the same value you used for message/subscribe calls."
215
+ },
216
+ participant_type: {
217
+ type: "string",
218
+ description:
219
+ "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
220
+ },
221
+ participant_label: {
222
+ type: "string",
223
+ description:
224
+ "Optional display label used when the participant identity is being created for the first time."
225
+ },
226
+ read_at: {
227
+ type: "integer",
228
+ description:
229
+ "Optional millisecond cursor to advance to. If omitted, the conversation is marked read through its latest message."
230
+ }
231
+ },
232
+ required: ["space_id", "conversation_id"]
233
+ }
234
+ },
235
+ {
236
+ name: "view_groups",
237
+ title: "View Groups",
238
+ description:
239
+ "List all groups in a space, including the projects currently inside each group plus any ungrouped projects.",
240
+ inputSchema: {
241
+ type: "object",
242
+ properties: {
243
+ space_id: {
244
+ type: "string",
245
+ description:
246
+ "REQUIRED: Space to list groups from (use view_spaces to see available options)"
247
+ }
248
+ },
249
+ required: ["space_id"]
250
+ }
251
+ },
252
+ {
253
+ name: "create_group",
254
+ title: "Create Group",
255
+ description: "Create a new group inside a space.",
256
+ inputSchema: {
257
+ type: "object",
258
+ properties: {
259
+ space_id: {
260
+ type: "string",
261
+ description:
262
+ "REQUIRED: Space to create the group in."
263
+ },
264
+ name: {
265
+ type: "string",
266
+ description: "Name for the new group."
267
+ }
268
+ },
269
+ required: ["space_id", "name"]
270
+ }
271
+ },
272
+ {
273
+ name: "rename_group",
274
+ title: "Rename Group",
275
+ description: "Rename an existing group.",
276
+ inputSchema: {
277
+ type: "object",
278
+ properties: {
279
+ space_id: {
280
+ type: "string",
281
+ description: "REQUIRED: Space containing the group."
282
+ },
283
+ group_id: {
284
+ type: "string",
285
+ description: "REQUIRED: Group ID to rename."
286
+ },
287
+ name: {
288
+ type: "string",
289
+ description: "REQUIRED: New group name."
290
+ }
291
+ },
292
+ required: ["space_id", "group_id", "name"]
293
+ }
294
+ },
295
+ {
296
+ name: "delete_group",
297
+ title: "Delete Group",
298
+ description:
299
+ "Delete a group. Projects inside it are preserved and become ungrouped.",
300
+ inputSchema: {
301
+ type: "object",
302
+ properties: {
303
+ space_id: {
304
+ type: "string",
305
+ description: "REQUIRED: Space containing the group."
306
+ },
307
+ group_id: {
308
+ type: "string",
309
+ description: "REQUIRED: Group ID to delete."
310
+ }
311
+ },
312
+ required: ["space_id", "group_id"]
313
+ }
314
+ },
315
+ {
316
+ name: "view_projects",
317
+ title: "View Projects",
318
+ description:
319
+ "List all projects in a space, including which group each project belongs to.",
320
+ inputSchema: {
321
+ type: "object",
322
+ properties: {
323
+ space_id: {
324
+ type: "string",
325
+ description:
326
+ "REQUIRED: Space to list projects from (use view_spaces to see available options)"
327
+ }
328
+ },
329
+ required: ["space_id"]
330
+ }
331
+ },
332
+ {
333
+ name: "view_project",
334
+ title: "View Project",
335
+ description:
336
+ "View a specific project with all its items. Use fetch_items to retrieve full content for specific item IDs.",
337
+ inputSchema: {
338
+ type: "object",
339
+ properties: {
340
+ project_id: {
341
+ type: "string",
342
+ description:
343
+ "Project ID to view (e.g., 'proj_123...'). Get project IDs from view_projects."
344
+ },
345
+ space_id: {
346
+ type: "string",
347
+ description:
348
+ "REQUIRED: Space containing the project."
349
+ },
350
+ slug: {
351
+ type: "string",
352
+ description:
353
+ "Optional: Project slug (URL-friendly name)."
354
+ }
355
+ },
356
+ required: ["space_id"]
357
+ }
358
+ },
359
+ {
360
+ name: "create_project",
361
+ title: "Create Project",
362
+ description:
363
+ "Create a new project in a space. Optionally place it inside a group immediately.",
364
+ inputSchema: {
365
+ type: "object",
366
+ properties: {
367
+ space_id: {
368
+ type: "string",
369
+ description: "REQUIRED: Space to create the project in."
370
+ },
371
+ name: {
372
+ type: "string",
373
+ description: "REQUIRED: Project name."
374
+ },
375
+ group_id: {
376
+ type: "string",
377
+ description: "Optional: Group ID to place the project inside."
378
+ }
379
+ },
380
+ required: ["space_id", "name"]
381
+ }
382
+ },
383
+ {
384
+ name: "rename_project",
385
+ title: "Rename Project",
386
+ description: "Rename an existing project.",
387
+ inputSchema: {
388
+ type: "object",
389
+ properties: {
390
+ space_id: {
391
+ type: "string",
392
+ description: "REQUIRED: Space containing the project."
393
+ },
394
+ project_id: {
395
+ type: "string",
396
+ description: "REQUIRED: Project ID to rename."
397
+ },
398
+ name: {
399
+ type: "string",
400
+ description: "REQUIRED: New project name."
401
+ }
402
+ },
403
+ required: ["space_id", "project_id", "name"]
404
+ }
405
+ },
406
+ {
407
+ name: "delete_project",
408
+ title: "Delete Project",
409
+ description: "Delete an existing project from a space.",
410
+ inputSchema: {
411
+ type: "object",
412
+ properties: {
413
+ space_id: {
414
+ type: "string",
415
+ description: "REQUIRED: Space containing the project."
416
+ },
417
+ project_id: {
418
+ type: "string",
419
+ description: "REQUIRED: Project ID to delete."
420
+ }
421
+ },
422
+ required: ["space_id", "project_id"]
423
+ }
424
+ },
425
+ {
426
+ name: "assign_project_to_group",
427
+ title: "Assign Project To Group",
428
+ description:
429
+ "Move a project into a group. Omit group_id to make the project ungrouped.",
430
+ inputSchema: {
431
+ type: "object",
432
+ properties: {
433
+ space_id: {
434
+ type: "string",
435
+ description: "REQUIRED: Space containing the project."
436
+ },
437
+ project_id: {
438
+ type: "string",
439
+ description: "REQUIRED: Project ID to move."
440
+ },
441
+ group_id: {
442
+ type: "string",
443
+ description:
444
+ "Optional: Target group ID. Omit this to ungroup the project."
445
+ }
446
+ },
447
+ required: ["space_id", "project_id"]
448
+ }
449
+ },
96
450
  {
97
451
  name: "start",
98
452
  title: "Start Space Session",
@@ -339,8 +693,7 @@ const TOOL_DEFINITIONS = [
339
693
  }
340
694
  }
341
695
  },
342
- required: ["space_id"],
343
- anyOf: [{ required: ["add"] }, { required: ["update"] }, { required: ["delete"] }]
696
+ required: ["space_id"]
344
697
  }
345
698
  },
346
699
  {
@@ -440,21 +793,14 @@ const TOOL_DEFINITIONS = [
440
793
  items: { type: "string" }
441
794
  }
442
795
  },
443
- required: ["space_id"],
444
- anyOf: [
445
- { required: ["list"] },
446
- { required: ["create"] },
447
- { required: ["rename"] },
448
- { required: ["move_items"] },
449
- { required: ["delete"] }
450
- ]
796
+ required: ["space_id"]
451
797
  }
452
798
  },
453
799
  {
454
800
  name: "message",
455
801
  title: "Message Assistant",
456
802
  description:
457
- "Primary orchestration tool. Send a request to the Intangle assistant and wait for one assistant turn to complete. Returns assistant text plus continuity IDs (`session_id`, `conversation_id`) so callers can continue the same thread reliably across turns.",
803
+ "Primary orchestration tool. Send a request to the Intangle assistant and either wait for one assistant turn to complete or submit asynchronously for later polling. Returns assistant text plus continuity IDs (`session_id`, `conversation_id`) so callers can continue the same thread reliably across turns.",
458
804
  inputSchema: {
459
805
  type: "object",
460
806
  properties: {
@@ -476,6 +822,11 @@ const TOOL_DEFINITIONS = [
476
822
  description:
477
823
  "Optional existing conversation/chat summary ID to resume a specific conversation. If omitted, Intangle uses/creates the active conversation for this space."
478
824
  },
825
+ new_conversation: {
826
+ type: "boolean",
827
+ description:
828
+ "Optional. When true, force a fresh conversation instead of reusing the current active thread."
829
+ },
479
830
  session_id: {
480
831
  type: "string",
481
832
  description:
@@ -495,6 +846,26 @@ const TOOL_DEFINITIONS = [
495
846
  description:
496
847
  "Optional timeout in milliseconds (10,000 to 300,000; default 120,000)."
497
848
  },
849
+ wait_for_response: {
850
+ type: "boolean",
851
+ description:
852
+ "Optional. Defaults to true. Set false to submit the turn asynchronously and poll the conversation later with fetch_conversation_messages."
853
+ },
854
+ participant_id: {
855
+ type: "string",
856
+ description:
857
+ "Optional stable participant ID for collaborative/shared chats. Use an explicit `user_*` or `agent_*` style ID when you want the same participant identity reused across calls."
858
+ },
859
+ participant_type: {
860
+ type: "string",
861
+ description:
862
+ "Optional participant type. Defaults to `user`. Supported values: `user`, `agent`, `assistant`, `connector`."
863
+ },
864
+ participant_label: {
865
+ type: "string",
866
+ description:
867
+ "Optional display label for the participant in collaborative chat UIs."
868
+ },
498
869
  timezone: {
499
870
  type: "string",
500
871
  description: "Optional IANA timezone for assistant context."
@@ -531,6 +902,8 @@ const TOOL_DEFINITIONS = [
531
902
  const READ_ONLY_TOOLS = new Set([
532
903
  "search",
533
904
  "fetch_items",
905
+ "fetch_conversation_messages",
906
+ "list_conversation_inbox",
534
907
  "start",
535
908
  "view_spaces",
536
909
  "view_space"
@@ -545,6 +918,8 @@ const DESTRUCTIVE_TOOLS = new Set([
545
918
  const IDEMPOTENT_TOOLS = new Set([
546
919
  "search",
547
920
  "fetch_items",
921
+ "fetch_conversation_messages",
922
+ "list_conversation_inbox",
548
923
  "start",
549
924
  "view_spaces",
550
925
  "view_space"