@tacitai/mcp-server 0.6.20 → 0.6.22

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/dist/prompts.d.ts CHANGED
@@ -20,7 +20,7 @@ export declare const GM_WORKFLOW: {
20
20
  readonly steps: readonly [{
21
21
  readonly id: "ingest";
22
22
  readonly name: "Ingest";
23
- readonly action: "Call tacit_gm_ingest with a title and the content (inline text via \"content\", or a local file via \"file_path\" — never both). Do NOT set domain_id. The response includes a placement_proposal with suggested_surface (\"kb\" or \"pyramid\") and a confidence score. The suggested_surface is the GM's decision about WHICH surface: keep it. Step 3 picks the specific location within that surface. Never switch surfaces (for example to a KB collection whose name looks relevant) unless the user asks for that surface.";
23
+ readonly action: "Call tacit_gm_ingest with a title and the content (inline text via \"content\", or a local file via \"file_path\" — never both). Do NOT set domain_id. The response includes a placement_proposal with suggested_surface (\"kb\" or \"pyramid\") and a confidence score — use this as a starting hint for step 2, but let the user choose the final surface.";
24
24
  readonly tools: readonly ["tacit_gm_ingest"];
25
25
  readonly signal: "You receive a catalog_id, artifact_id, content_type, and is_duplicate flag. Save the catalog_id — you will need it for placement.";
26
26
  readonly on_duplicate: "If is_duplicate is true, tell the user this content already exists and ask how to proceed: update, skip, or ingest as a new version.";
@@ -46,7 +46,7 @@ export declare const GM_WORKFLOW: {
46
46
  }, {
47
47
  readonly id: "place";
48
48
  readonly name: "Execute approved placement";
49
- readonly action: "ONLY after the user explicitly approved the proposal in step 4: For pyramid — if a new dossier is needed, call tacit_pyramid_create_dossier first to get the dossier_id. Then call tacit_gm_approve with the catalog_id from step 1, surface=\"pyramid\", collection_or_program set to the program UUID, and dossier_id set to the dossier UUID. NEVER call tacit_gm_approve without a dossier_id for pyramid placement. For KB: call tacit_kb_promote_from_artifact with the artifact_id from step 1 and the collection UUID (tacit_gm_approve does not place KB content). For both: pyramid first, then KB (two separate calls). For lake-only: no call needed. Pass title and location_label (the plain-language location you proposed) on each placement call; clients that support it show the user a confirmation, and if the user declines, nothing is placed and you return to step 4.";
49
+ readonly action: "ONLY after the user explicitly approved the proposal in step 4: For pyramid — if a new dossier is needed, call tacit_pyramid_create_dossier first to get the dossier_id. Then call tacit_gm_approve with the catalog_id from step 1, surface=\"pyramid\", collection_or_program set to the program UUID, and dossier_id set to the dossier UUID. NEVER call tacit_gm_approve without a dossier_id for pyramid placement. For KB: call tacit_kb_promote_from_artifact with the artifact_id from step 1 and the collection UUID (tacit_gm_approve does not place KB content). For both: pyramid first, then KB (two separate calls). For lake-only: no call needed.";
50
50
  readonly tools: readonly ["tacit_gm_approve", "tacit_kb_promote_from_artifact", "tacit_pyramid_create_dossier"];
51
51
  readonly signal: "tacit_gm_approve or tacit_kb_promote_from_artifact returns success.";
52
52
  readonly skip_when: "User chose lake-only.";
package/dist/prompts.js CHANGED
@@ -127,7 +127,7 @@ export const GM_WORKFLOW = {
127
127
  {
128
128
  id: 'ingest',
129
129
  name: 'Ingest',
130
- action: 'Call tacit_gm_ingest with a title and the content (inline text via "content", or a local file via "file_path" — never both). Do NOT set domain_id. The response includes a placement_proposal with suggested_surface ("kb" or "pyramid") and a confidence score. The suggested_surface is the GM\'s decision about WHICH surface: keep it. Step 3 picks the specific location within that surface. Never switch surfaces (for example to a KB collection whose name looks relevant) unless the user asks for that surface.',
130
+ action: 'Call tacit_gm_ingest with a title and the content (inline text via "content", or a local file via "file_path" — never both). Do NOT set domain_id. The response includes a placement_proposal with suggested_surface ("kb" or "pyramid") and a confidence score — use this as a starting hint for step 2, but let the user choose the final surface.',
131
131
  tools: ['tacit_gm_ingest'],
132
132
  signal: 'You receive a catalog_id, artifact_id, content_type, and is_duplicate flag. Save the catalog_id — you will need it for placement.',
133
133
  on_duplicate: 'If is_duplicate is true, tell the user this content already exists and ask how to proceed: update, skip, or ingest as a new version.',
@@ -157,7 +157,7 @@ export const GM_WORKFLOW = {
157
157
  {
158
158
  id: 'place',
159
159
  name: 'Execute approved placement',
160
- action: 'ONLY after the user explicitly approved the proposal in step 4: For pyramid — if a new dossier is needed, call tacit_pyramid_create_dossier first to get the dossier_id. Then call tacit_gm_approve with the catalog_id from step 1, surface="pyramid", collection_or_program set to the program UUID, and dossier_id set to the dossier UUID. NEVER call tacit_gm_approve without a dossier_id for pyramid placement. For KB: call tacit_kb_promote_from_artifact with the artifact_id from step 1 and the collection UUID (tacit_gm_approve does not place KB content). For both: pyramid first, then KB (two separate calls). For lake-only: no call needed. Pass title and location_label (the plain-language location you proposed) on each placement call; clients that support it show the user a confirmation, and if the user declines, nothing is placed and you return to step 4.',
160
+ action: 'ONLY after the user explicitly approved the proposal in step 4: For pyramid — if a new dossier is needed, call tacit_pyramid_create_dossier first to get the dossier_id. Then call tacit_gm_approve with the catalog_id from step 1, surface="pyramid", collection_or_program set to the program UUID, and dossier_id set to the dossier UUID. NEVER call tacit_gm_approve without a dossier_id for pyramid placement. For KB: call tacit_kb_promote_from_artifact with the artifact_id from step 1 and the collection UUID (tacit_gm_approve does not place KB content). For both: pyramid first, then KB (two separate calls). For lake-only: no call needed.',
161
161
  tools: ['tacit_gm_approve', 'tacit_kb_promote_from_artifact', 'tacit_pyramid_create_dossier'],
162
162
  signal: 'tacit_gm_approve or tacit_kb_promote_from_artifact returns success.',
163
163
  skip_when: 'User chose lake-only.',
@@ -18,16 +18,6 @@ export interface ToolRequest {
18
18
  isError?: boolean;
19
19
  }>;
20
20
  }
21
- export type PlacementConfirmation = 'approved' | 'declined' | 'unsupported';
22
- export declare function confirmPlacement(server: McpServer, message: string): Promise<PlacementConfirmation>;
23
- export declare function placementMessage(title: string | undefined, locationLabel: string | undefined, fallback: string): string;
24
- export declare function placementDeclinedResult(locationLabel: string | undefined): {
25
- content: Array<{
26
- type: 'text';
27
- text: string;
28
- }>;
29
- isError: boolean;
30
- };
31
21
  export declare const GM_INGEST_NEXT_STEP: string;
32
22
  /** Largest file `file_path` will read (10 MiB). */
33
23
  export declare const GM_INGEST_MAX_FILE_BYTES: number;
@@ -63,9 +53,9 @@ export declare const gmIngestInputSchema: z.ZodObject<{
63
53
  }, "strip", z.ZodTypeAny, {
64
54
  title: string;
65
55
  content?: string | undefined;
66
- file_path?: string | undefined;
67
56
  source_uri?: string | undefined;
68
57
  content_type?: string | undefined;
58
+ file_path?: string | undefined;
69
59
  classification_hints?: {
70
60
  domain?: string | undefined;
71
61
  content_type?: string | undefined;
@@ -73,9 +63,9 @@ export declare const gmIngestInputSchema: z.ZodObject<{
73
63
  }, {
74
64
  title: string;
75
65
  content?: string | undefined;
76
- file_path?: string | undefined;
77
66
  source_uri?: string | undefined;
78
67
  content_type?: string | undefined;
68
+ file_path?: string | undefined;
79
69
  classification_hints?: {
80
70
  domain?: string | undefined;
81
71
  content_type?: string | undefined;
@@ -157,8 +147,6 @@ export declare const gmApproveInputSchema: z.ZodObject<{
157
147
  surface: string;
158
148
  reason?: string | undefined;
159
149
  }>, "many">>>;
160
- title: z.ZodOptional<z.ZodString>;
161
- location_label: z.ZodOptional<z.ZodString>;
162
150
  }, "strict", z.ZodTypeAny, {
163
151
  catalog_id: string;
164
152
  approved_targets: {
@@ -170,8 +158,6 @@ export declare const gmApproveInputSchema: z.ZodObject<{
170
158
  surface: string;
171
159
  reason?: string | undefined;
172
160
  }[];
173
- title?: string | undefined;
174
- location_label?: string | undefined;
175
161
  }, {
176
162
  catalog_id: string;
177
163
  approved_targets: {
@@ -179,12 +165,10 @@ export declare const gmApproveInputSchema: z.ZodObject<{
179
165
  collection_or_program: string;
180
166
  dossier_id?: string | undefined;
181
167
  }[];
182
- title?: string | undefined;
183
168
  rejected_targets?: {
184
169
  surface: string;
185
170
  reason?: string | undefined;
186
171
  }[] | undefined;
187
- location_label?: string | undefined;
188
172
  }>;
189
173
  export type GmApproveInput = z.infer<typeof gmApproveInputSchema>;
190
174
  export declare const GM_APPROVE_TOOL_DEF: {
@@ -243,14 +227,6 @@ export declare const GM_APPROVE_TOOL_DEF: {
243
227
  };
244
228
  description: string;
245
229
  };
246
- title: {
247
- type: string;
248
- description: string;
249
- };
250
- location_label: {
251
- type: string;
252
- description: string;
253
- };
254
230
  };
255
231
  required: string[];
256
232
  };
package/dist/tools/gm.js CHANGED
@@ -27,35 +27,10 @@ function apiErrorResult(err, toolName) {
27
27
  const msg = err instanceof Error ? err.message : String(err);
28
28
  return { content: [{ type: 'text', text: `Error: ${msg}` }], isError: true };
29
29
  }
30
- export async function confirmPlacement(server, message) {
31
- const inner = server.server;
32
- if (!inner?.getClientCapabilities?.()?.elicitation)
33
- return 'unsupported';
34
- try {
35
- const res = await inner.elicitInput({ message, requestedSchema: { type: 'object', properties: {} } });
36
- return res.action === 'accept' ? 'approved' : 'declined';
37
- }
38
- catch {
39
- // Fail closed: a client that advertised elicitation but could not ask is not an approval.
40
- return 'declined';
41
- }
42
- }
43
- export function placementMessage(title, locationLabel, fallback) {
44
- const what = title ? `"${title}"` : 'this content';
45
- return `Place ${what} in ${locationLabel || fallback}?`;
46
- }
47
- export function placementDeclinedResult(locationLabel) {
48
- return {
49
- content: [{
50
- type: 'text',
51
- text: `The user did not approve placing this${locationLabel ? ` in ${locationLabel}` : ''}. Nothing was placed; the content stays in the data lake. Ask the user where it should go instead.`,
52
- }],
53
- isError: true,
54
- };
55
- }
56
30
  export const GM_INGEST_NEXT_STEP = 'NEXT STEP: nothing has been placed yet. Tell the user in plain language what this was classified as and propose ONE specific ' +
57
31
  'location on the surface in placement_proposal.suggested_surface (pyramid: portfolio → program → dossier; kb: a collection). ' +
58
- 'Do not switch surfaces unless the user asks. Then stop and wait for the user to approve that location in a new message. ' +
32
+ 'Do not switch surfaces unless the user asks. If suggested_surface is "lake", say it is saved in the data lake and ask whether ' +
33
+ 'to file it in the workspace structure or the knowledge base; do not pick one yourself. Then stop and wait for the user to approve that location in a new message. ' +
59
34
  'The user asking to "add it to the workspace" or "you decide" is not approval of a location.';
60
35
  // ─── tacit_gm_ingest ────────────────────────────────────────────────────────
61
36
  /** Largest file `file_path` will read (10 MiB). */
@@ -300,13 +275,10 @@ export const gmApproveInputSchema = z.object({
300
275
  surface: z.string(),
301
276
  reason: z.string().optional(),
302
277
  }).strict()).optional().default([]).describe('Targets to explicitly reject'),
303
- title: z.string().optional().describe('Content title, shown to the user in the approval prompt'),
304
- location_label: z.string().optional().describe('Plain-language location shown to the user, e.g. "GoodOps → GoodOps Site → Research"'),
305
278
  }).strict();
306
279
  export const GM_APPROVE_TOOL_DEF = {
307
280
  name: 'tacit_gm_approve',
308
- description: 'APPROVAL-TIER: call only after the user approved this specific location in their latest message; ' +
309
- 'when the client supports it, the server also asks the user to confirm before placing. ' +
281
+ description: 'APPROVAL-TIER: call only after the user approved this specific location in their latest message. ' +
310
282
  'Place an artifact created by tacit_gm_ingest in the pyramid: sets its program (and portfolio) home and, ' +
311
283
  'if dossier_id is given, adds it to that dossier, in one transaction. Exactly one pyramid target per call. ' +
312
284
  'Does NOT place KB content; use tacit_kb_promote_from_artifact (SOP-03). ' +
@@ -347,8 +319,6 @@ export const GM_APPROVE_TOOL_DEF = {
347
319
  },
348
320
  description: 'Targets to explicitly reject',
349
321
  },
350
- title: { type: 'string', description: 'Content title, shown to the user in the approval prompt' },
351
- location_label: { type: 'string', description: 'Plain-language location shown to the user, e.g. "GoodOps → GoodOps Site → Research"' },
352
322
  },
353
323
  required: ['catalog_id', 'approved_targets'],
354
324
  },
@@ -387,11 +357,7 @@ export function registerGmTools(server, getClientFn) {
387
357
  return buildGmIngestRequest(client, args).execute();
388
358
  });
389
359
  server.tool('tacit_gm_approve', GM_APPROVE_TOOL_DEF.description, gmApproveInputSchema.shape, async (args) => {
390
- const input = args;
391
- const ok = await confirmPlacement(server, placementMessage(input.title, input.location_label, 'the proposed workspace program and dossier'));
392
- if (ok === 'declined')
393
- return placementDeclinedResult(input.location_label);
394
360
  const client = await getClientFn();
395
- return buildGmApproveRequest(client, input).execute();
361
+ return buildGmApproveRequest(client, args).execute();
396
362
  });
397
363
  }
@@ -396,18 +396,12 @@ export declare function handleBrowseTree(args: unknown): Promise<{
396
396
  export declare const promoteFromArtifactInputSchema: z.ZodObject<{
397
397
  artifact_id: z.ZodString;
398
398
  collection_id: z.ZodString;
399
- title: z.ZodOptional<z.ZodString>;
400
- location_label: z.ZodOptional<z.ZodString>;
401
399
  }, "strip", z.ZodTypeAny, {
402
400
  artifact_id: string;
403
401
  collection_id: string;
404
- title?: string | undefined;
405
- location_label?: string | undefined;
406
402
  }, {
407
403
  artifact_id: string;
408
404
  collection_id: string;
409
- title?: string | undefined;
410
- location_label?: string | undefined;
411
405
  }>;
412
406
  export type PromoteFromArtifactInput = z.infer<typeof promoteFromArtifactInputSchema>;
413
407
  export declare const PROMOTE_FROM_ARTIFACT_TOOL_DEF: {
@@ -424,14 +418,6 @@ export declare const PROMOTE_FROM_ARTIFACT_TOOL_DEF: {
424
418
  type: string;
425
419
  description: string;
426
420
  };
427
- title: {
428
- type: string;
429
- description: string;
430
- };
431
- location_label: {
432
- type: string;
433
- description: string;
434
- };
435
421
  };
436
422
  required: string[];
437
423
  };
package/dist/tools/kb.js CHANGED
@@ -14,7 +14,6 @@
14
14
  import { z } from 'zod';
15
15
  import { getClient, TacitApiError, TokenExpiredError } from '../client.js';
16
16
  import { apiErrorResult as sharedApiErrorResult, featureDisabledResult } from './errors.js';
17
- import { confirmPlacement, placementDeclinedResult, placementMessage } from './gm.js';
18
17
  function apiErrorResult(err, toolName) {
19
18
  if (err instanceof TokenExpiredError) {
20
19
  return {
@@ -283,7 +282,7 @@ export const createArticleInputSchema = z.object({
283
282
  });
284
283
  export const CREATE_ARTICLE_TOOL_DEF = {
285
284
  name: 'tacit_kb_create_article',
286
- description: 'APPROVAL-TIER: call only after the user approved this collection in their latest message. For new content, prefer tacit_gm_ingest (lake-first). This tool creates a KB article directly without a data lake catalog entry. Create a new KB article within a collection. Status defaults to DRAFT.',
285
+ description: 'APPROVAL-TIER: call only after the user approved this placement. For new content, prefer tacit_gm_ingest (lake-first). This tool creates a KB article directly without a data lake catalog entry. Create a new KB article within a collection. Status defaults to DRAFT.',
287
286
  inputSchema: {
288
287
  type: 'object',
289
288
  properties: {
@@ -417,13 +416,10 @@ export async function handleBrowseTree(args) {
417
416
  export const promoteFromArtifactInputSchema = z.object({
418
417
  artifact_id: z.string().min(1).describe('UUID of the artifact to promote into the KB'),
419
418
  collection_id: z.string().min(1).describe('UUID of an existing collection to place the promoted article in'),
420
- title: z.string().optional().describe('Content title, shown to the user in the approval prompt'),
421
- location_label: z.string().optional().describe('Plain-language collection name shown to the user'),
422
419
  });
423
420
  export const PROMOTE_FROM_ARTIFACT_TOOL_DEF = {
424
421
  name: 'tacit_kb_promote_from_artifact',
425
- description: 'APPROVAL-TIER: call only after the user approved this specific collection in their latest message; ' +
426
- 'when the client supports it, the server also asks the user to confirm before placing. ' +
422
+ description: 'APPROVAL-TIER: call only after the user approved this specific collection. ' +
427
423
  'This is the KB placement step after tacit_gm_ingest (use the artifact_id it returned). ' +
428
424
  'Promote an existing artifact into a published KB article, placing it in the given collection. ' +
429
425
  'Idempotent — re-promoting an already-promoted artifact only applies the new placement.',
@@ -432,8 +428,6 @@ export const PROMOTE_FROM_ARTIFACT_TOOL_DEF = {
432
428
  properties: {
433
429
  artifact_id: { type: 'string', description: 'UUID of the artifact to promote' },
434
430
  collection_id: { type: 'string', description: 'UUID of an existing collection' },
435
- title: { type: 'string', description: 'Content title, shown to the user in the approval prompt' },
436
- location_label: { type: 'string', description: 'Plain-language collection name shown to the user' },
437
431
  },
438
432
  required: ['artifact_id', 'collection_id'],
439
433
  },
@@ -633,12 +627,8 @@ export function registerKbTools(server, getClientFn) {
633
627
  return buildBrowseTreeRequest(client, args).execute();
634
628
  });
635
629
  server.tool('tacit_kb_promote_from_artifact', PROMOTE_FROM_ARTIFACT_TOOL_DEF.description, promoteFromArtifactInputSchema.shape, async (args) => {
636
- const input = args;
637
- const ok = await confirmPlacement(server, placementMessage(input.title, input.location_label, 'the proposed knowledge base collection') + ' It will be published there.');
638
- if (ok === 'declined')
639
- return placementDeclinedResult(input.location_label);
640
630
  const client = await getClientFn();
641
- return buildPromoteFromArtifactRequest(client, input).execute();
631
+ return buildPromoteFromArtifactRequest(client, args).execute();
642
632
  });
643
633
  server.tool('tacit_kb_promote_from_catalog', PROMOTE_FROM_CATALOG_TOOL_DEF.description, promoteFromCatalogInputSchema.shape, async (args) => {
644
634
  const client = await getClientFn();
@@ -486,9 +486,9 @@ export declare const browseCatalogInputSchema: z.ZodObject<{
486
486
  origin?: string | undefined;
487
487
  q?: string | undefined;
488
488
  offset?: number | undefined;
489
- content_type?: string | undefined;
490
489
  source_id?: string | undefined;
491
490
  catalog_status?: string | undefined;
491
+ content_type?: string | undefined;
492
492
  subject_id?: string | undefined;
493
493
  subject_needs_review?: boolean | undefined;
494
494
  subject_layer?: string | undefined;
@@ -497,9 +497,9 @@ export declare const browseCatalogInputSchema: z.ZodObject<{
497
497
  origin?: string | undefined;
498
498
  q?: string | undefined;
499
499
  offset?: number | undefined;
500
- content_type?: string | undefined;
501
500
  source_id?: string | undefined;
502
501
  catalog_status?: string | undefined;
502
+ content_type?: string | undefined;
503
503
  subject_id?: string | undefined;
504
504
  subject_needs_review?: boolean | undefined;
505
505
  subject_layer?: string | undefined;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tacitai/mcp-server",
3
- "version": "0.6.20",
3
+ "version": "0.6.22",
4
4
  "private": false,
5
5
  "description": "stdio MCP server wrapping Tacit /api/v1 REST/SSE API",
6
6
  "license": "UNLICENSED",