@tacitai/mcp-server 0.6.9 → 0.6.11

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
@@ -15,8 +15,26 @@ export declare const CAPABILITY_DOMAINS: Array<{
15
15
  description: string;
16
16
  }>;
17
17
  export declare const EXPERIENCES: readonly [{
18
- readonly id: "first_light";
18
+ readonly id: "explore_workspace";
19
19
  readonly num: 1;
20
+ readonly name: "Explore Your Workspace";
21
+ readonly tier: 1;
22
+ readonly tierName: "Orient & Equip";
23
+ readonly action: "Type: \"What is in my workspace?\" — see what knowledge, collections, and structure are already here.";
24
+ readonly signal: "You can describe what is in your workspace";
25
+ readonly tip: "";
26
+ }, {
27
+ readonly id: "see_capabilities";
28
+ readonly num: 2;
29
+ readonly name: "See What's Possible";
30
+ readonly tier: 1;
31
+ readonly tierName: "Orient & Equip";
32
+ readonly action: "Type: \"What can TACIT do for me?\" — discover the full range of capabilities available to you.";
33
+ readonly signal: "You know what TACIT can do and are ready to try it";
34
+ readonly tip: "";
35
+ }, {
36
+ readonly id: "first_light";
37
+ readonly num: 3;
20
38
  readonly name: "First Light";
21
39
  readonly tier: 1;
22
40
  readonly tierName: "Orient & Equip";
@@ -25,7 +43,7 @@ export declare const EXPERIENCES: readonly [{
25
43
  readonly tip: "";
26
44
  }, {
27
45
  readonly id: "feed_it";
28
- readonly num: 2;
46
+ readonly num: 4;
29
47
  readonly name: "Feed It";
30
48
  readonly tier: 1;
31
49
  readonly tierName: "Orient & Equip";
@@ -34,7 +52,7 @@ export declare const EXPERIENCES: readonly [{
34
52
  readonly tip: "You can also say \"Have GM ingest this URL\" — GM is your General Manager for all content operations.";
35
53
  }, {
36
54
  readonly id: "build_your_map";
37
- readonly num: 3;
55
+ readonly num: 5;
38
56
  readonly name: "Build Your Map";
39
57
  readonly tier: 1;
40
58
  readonly tierName: "Orient & Equip";
@@ -43,7 +61,7 @@ export declare const EXPERIENCES: readonly [{
43
61
  readonly tip: "You can also say \"Have GM organize our knowledge on [topic]\" — GM handles content placement and classification.";
44
62
  }, {
45
63
  readonly id: "connect_your_tools";
46
- readonly num: 4;
64
+ readonly num: 6;
47
65
  readonly name: "Connect Your Tools";
48
66
  readonly tier: 1;
49
67
  readonly tierName: "Orient & Equip";
@@ -51,35 +69,35 @@ export declare const EXPERIENCES: readonly [{
51
69
  readonly signal: "Connectors active — email and Slack flowing into your workspace";
52
70
  readonly tip: "";
53
71
  }, {
54
- readonly id: "morning_brief";
55
- readonly num: 5;
56
- readonly name: "Morning Brief";
72
+ readonly id: "research_publish";
73
+ readonly num: 7;
74
+ readonly name: "Research & Publish";
57
75
  readonly tier: 2;
58
76
  readonly tierName: "The Operating System";
59
- readonly action: "Try \"Have COS brief me on today\" — COS is your Chief of Staff. Includes email triage, Slack synthesis, and calendar prep. You can also say \"COS, triage my email\" or \"COS, prep me for my next meeting.\"";
60
- readonly signal: "First daily operating picture with email triage, Slack synthesis, and calendar prep";
61
- readonly tip: "Meet your executive team. Addressing an exec by name routes your request through a specialized workflow that organizes the response. Available execs: COS (Chief of Staff — daily ops, email, meetings), COO (Chief Operating Officer — business ops, sales, audits), GM (General Manager — content ingestion, classification, pyramid placement).";
77
+ readonly action: "Research a topic using web, academic, and workspace sources — try \"Research [topic] and publish it.\" The full pipeline: research → /artifact-design creates a styled HTML report → published as a Claude Code artifact → GM proposes its location in your pyramid. Add a Gemini API key (GEMINI_API_KEY) to unlock Google Deep Research for web and academic sources.";
78
+ readonly signal: "First research artifact published and placed in your pyramid — combining workspace knowledge with external sources";
79
+ readonly tip: "After publishing, you can say \"Have GM place this in the pyramid\" to route it directly to your General Manager for classification and placement.";
62
80
  }, {
63
81
  readonly id: "run_sales";
64
- readonly num: 6;
82
+ readonly num: 8;
65
83
  readonly name: "Run Sales";
66
84
  readonly tier: 2;
67
85
  readonly tierName: "The Operating System";
68
- readonly action: "Ask to prepare a proposal, run discovery on a prospect, or build a quote.";
69
- readonly signal: "First compound business deliverable";
70
- readonly tip: "You can also say \"Have COO plan a proposal for [client]\" — COO is your Chief Operating Officer for all business operations and sales.";
86
+ readonly action: "Ask to prepare a proposal, run discovery on a prospect, or build a quote. Then compose the client email in your voice — try \"Draft an intro email to [client] about this proposal, in my voice.\" The proposal is structured and formal; your email sounds like you.";
87
+ readonly signal: "First compound business deliverable, then first voice-matched composition";
88
+ readonly tip: "Voice works anywhere you write. Say \"in my voice\" with any request — proposals, emails, status updates, Slack messages. Upload more writing samples to sharpen the match. You can also say \"Have COO plan a proposal for [client]\" — COO is your Chief Operating Officer for all business operations and sales.";
71
89
  }, {
72
- readonly id: "research_publish";
73
- readonly num: 7;
74
- readonly name: "Research & Publish";
90
+ readonly id: "morning_brief";
91
+ readonly num: 9;
92
+ readonly name: "Morning Brief";
75
93
  readonly tier: 2;
76
94
  readonly tierName: "The Operating System";
77
- readonly action: "Research a topic using web, academic, and workspace sources — try \"Research [topic] and publish it.\" The full pipeline: research → /artifact-design creates a styled HTML report → published as a Claude Code artifact → GM proposes its location in your pyramid. Add a Gemini API key (GEMINI_API_KEY) to unlock Google Deep Research for web and academic sources.";
78
- readonly signal: "First research artifact published and placed in your pyramid — combining workspace knowledge with external sources";
79
- readonly tip: "After publishing, you can say \"Have GM place this in the pyramid\" to route it directly to your General Manager for classification and placement.";
95
+ readonly action: "Try \"Have COS brief me on today\" — COS is your Chief of Staff. Includes email triage, Slack synthesis, and calendar prep. You can also say \"COS, triage my email\" or \"COS, prep me for my next meeting.\" After the brief, try \"Draft a message to the team about today in my voice\" — it writes as you, not an LLM.";
96
+ readonly signal: "First daily operating picture with email triage, Slack synthesis, and calendar prep";
97
+ readonly tip: "Meet your executive team. Addressing an exec by name routes your request through a specialized workflow that organizes the response. Available execs: COS (Chief of Staff — daily ops, email, meetings), COO (Chief Operating Officer — business ops, sales, audits), GM (General Manager — content ingestion, classification, pyramid placement).";
80
98
  }, {
81
99
  readonly id: "audit_business";
82
- readonly num: 8;
100
+ readonly num: 10;
83
101
  readonly name: "Audit Your Business";
84
102
  readonly tier: 2;
85
103
  readonly tierName: "The Operating System";
@@ -88,11 +106,11 @@ export declare const EXPERIENCES: readonly [{
88
106
  readonly tip: "You can also say \"Have COO review our operational health\" — COO coordinates cross-team status and health checks.";
89
107
  }, {
90
108
  readonly id: "operating_rhythm";
91
- readonly num: 9;
109
+ readonly num: 11;
92
110
  readonly name: "Your Operating Rhythm";
93
111
  readonly tier: 3;
94
112
  readonly tierName: "Agentic Mastery";
95
- readonly action: "Set up weekly reviews, delegate recurring work to crews, and build your voice profile.";
113
+ readonly action: "Set up weekly reviews, delegate recurring work to crews, and refine your voice. Upload writing samples from emails, memos, or documents you wrote yourself — the more samples, the sharper the match.";
96
114
  readonly signal: "Return for second session with intent; establish a routine";
97
115
  readonly tip: "By now you know the team: COS for daily ops, COO for business operations, GM for content. Address them directly anytime.";
98
116
  }];
package/dist/prompts.js CHANGED
@@ -34,6 +34,12 @@ function buildAssistantSystemPrompt(state) {
34
34
  lines.push('- After ingesting content: "Good — that is in your workspace now. Want to organize it into a collection?"');
35
35
  lines.push('- After connecting tools: "Your Slack and email are flowing in. Try asking for a morning brief."');
36
36
  lines.push('');
37
+ lines.push('When the user is in an onboarding flow, keep them moving forward — suggest ONE next step, not multiple branches or "I can also..." offers. Outside of onboarding, just answer the question without steering toward onboarding steps. Never launch the onboarding journey unless the user explicitly asks for it.');
38
+ lines.push('');
39
+ lines.push('## Onboarding');
40
+ lines.push('');
41
+ lines.push('When the user says "onboard me" or asks for the onboarding journey, ALWAYS call the `tacit_onboarding` tool. Do not attempt a generic onboarding by reading files or describing the environment — the tool handles the full flow. Present the tool\'s response exactly as returned — do not add, summarize, or list experiences beyond what the tool output contains.');
42
+ lines.push('');
37
43
  lines.push('## Safety');
38
44
  lines.push('');
39
45
  lines.push('- Never modify or delete content without explicit approval.');
@@ -92,15 +98,17 @@ export const CAPABILITY_DOMAINS = [
92
98
  { domain: 'Code & GitHub', triggers: ['Show my repo connections…', 'Sync from GitHub…'], description: 'Repository connections and code sync' },
93
99
  ];
94
100
  export const EXPERIENCES = [
95
- { id: 'first_light', num: 1, name: 'First Light', tier: 1, tierName: 'Orient & Equip', action: 'Ask a question about your business — try "What do we know about [topic]?"', signal: 'First grounded answer drawn from your workspace knowledge', tip: '' },
96
- { id: 'feed_it', num: 2, name: 'Feed It', tier: 1, tierName: 'Orient & Equip', action: 'Add something to your workspace — share a URL, document, or file.', signal: 'First successful content ingestion', tip: 'You can also say "Have GM ingest this URL" — GM is your General Manager for all content operations.' },
97
- { id: 'build_your_map', num: 3, name: 'Build Your Map', tier: 1, tierName: 'Orient & Equip', action: 'Organize your work — ask to create a collection, build a portfolio, or structure your business.', signal: 'First organizational write operation', tip: 'You can also say "Have GM organize our knowledge on [topic]" — GM handles content placement and classification.' },
98
- { id: 'connect_your_tools', num: 4, name: 'Connect Your Tools', tier: 1, tierName: 'Orient & Equip', action: 'Connect Slack and Gmail through claude.ai Integrations — type "How do I connect my tools?" for a walkthrough.', signal: 'Connectors active — email and Slack flowing into your workspace', tip: '' },
99
- { id: 'morning_brief', num: 5, name: 'Morning Brief', tier: 2, tierName: 'The Operating System', action: 'Try "Have COS brief me on today" — COS is your Chief of Staff. Includes email triage, Slack synthesis, and calendar prep. You can also say "COS, triage my email" or "COS, prep me for my next meeting."', signal: 'First daily operating picture with email triage, Slack synthesis, and calendar prep', tip: 'Meet your executive team. Addressing an exec by name routes your request through a specialized workflow that organizes the response. Available execs: COS (Chief of Staff — daily ops, email, meetings), COO (Chief Operating Officer — business ops, sales, audits), GM (General Manager — content ingestion, classification, pyramid placement).' },
100
- { id: 'run_sales', num: 6, name: 'Run Sales', tier: 2, tierName: 'The Operating System', action: 'Ask to prepare a proposal, run discovery on a prospect, or build a quote.', signal: 'First compound business deliverable', tip: 'You can also say "Have COO plan a proposal for [client]" — COO is your Chief Operating Officer for all business operations and sales.' },
101
+ { id: 'explore_workspace', num: 1, name: 'Explore Your Workspace', tier: 1, tierName: 'Orient & Equip', action: 'Type: "What is in my workspace?" — see what knowledge, collections, and structure are already here.', signal: 'You can describe what is in your workspace', tip: '' },
102
+ { id: 'see_capabilities', num: 2, name: 'See What\'s Possible', tier: 1, tierName: 'Orient & Equip', action: 'Type: "What can TACIT do for me?" — discover the full range of capabilities available to you.', signal: 'You know what TACIT can do and are ready to try it', tip: '' },
103
+ { id: 'first_light', num: 3, name: 'First Light', tier: 1, tierName: 'Orient & Equip', action: 'Ask a question about your business — try "What do we know about [topic]?"', signal: 'First grounded answer drawn from your workspace knowledge', tip: '' },
104
+ { id: 'feed_it', num: 4, name: 'Feed It', tier: 1, tierName: 'Orient & Equip', action: 'Add something to your workspace — share a URL, document, or file.', signal: 'First successful content ingestion', tip: 'You can also say "Have GM ingest this URL" — GM is your General Manager for all content operations.' },
105
+ { id: 'build_your_map', num: 5, name: 'Build Your Map', tier: 1, tierName: 'Orient & Equip', action: 'Organize your work — ask to create a collection, build a portfolio, or structure your business.', signal: 'First organizational write operation', tip: 'You can also say "Have GM organize our knowledge on [topic]" — GM handles content placement and classification.' },
106
+ { id: 'connect_your_tools', num: 6, name: 'Connect Your Tools', tier: 1, tierName: 'Orient & Equip', action: 'Connect Slack and Gmail through claude.ai Integrations — type "How do I connect my tools?" for a walkthrough.', signal: 'Connectors active — email and Slack flowing into your workspace', tip: '' },
101
107
  { id: 'research_publish', num: 7, name: 'Research & Publish', tier: 2, tierName: 'The Operating System', action: 'Research a topic using web, academic, and workspace sources — try "Research [topic] and publish it." The full pipeline: research → /artifact-design creates a styled HTML report → published as a Claude Code artifact → GM proposes its location in your pyramid. Add a Gemini API key (GEMINI_API_KEY) to unlock Google Deep Research for web and academic sources.', signal: 'First research artifact published and placed in your pyramid — combining workspace knowledge with external sources', tip: 'After publishing, you can say "Have GM place this in the pyramid" to route it directly to your General Manager for classification and placement.' },
102
- { id: 'audit_business', num: 8, name: 'Audit Your Business', tier: 2, tierName: 'The Operating System', action: 'Ask "How healthy is our business?" or request a pulse audit.', signal: 'First scored business health audit', tip: 'You can also say "Have COO review our operational health" — COO coordinates cross-team status and health checks.' },
103
- { id: 'operating_rhythm', num: 9, name: 'Your Operating Rhythm', tier: 3, tierName: 'Agentic Mastery', action: 'Set up weekly reviews, delegate recurring work to crews, and build your voice profile.', signal: 'Return for second session with intent; establish a routine', tip: 'By now you know the team: COS for daily ops, COO for business operations, GM for content. Address them directly anytime.' },
108
+ { id: 'run_sales', num: 8, name: 'Run Sales', tier: 2, tierName: 'The Operating System', action: 'Ask to prepare a proposal, run discovery on a prospect, or build a quote. Then compose the client email in your voice — try "Draft an intro email to [client] about this proposal, in my voice." The proposal is structured and formal; your email sounds like you.', signal: 'First compound business deliverable, then first voice-matched composition', tip: 'Voice works anywhere you write. Say "in my voice" with any request — proposals, emails, status updates, Slack messages. Upload more writing samples to sharpen the match. You can also say "Have COO plan a proposal for [client]" — COO is your Chief Operating Officer for all business operations and sales.' },
109
+ { id: 'morning_brief', num: 9, name: 'Morning Brief', tier: 2, tierName: 'The Operating System', action: 'Try "Have COS brief me on today" — COS is your Chief of Staff. Includes email triage, Slack synthesis, and calendar prep. You can also say "COS, triage my email" or "COS, prep me for my next meeting." After the brief, try "Draft a message to the team about today in my voice" — it writes as you, not an LLM.', signal: 'First daily operating picture with email triage, Slack synthesis, and calendar prep', tip: 'Meet your executive team. Addressing an exec by name routes your request through a specialized workflow that organizes the response. Available execs: COS (Chief of Staff — daily ops, email, meetings), COO (Chief Operating Officer — business ops, sales, audits), GM (General Manager — content ingestion, classification, pyramid placement).' },
110
+ { id: 'audit_business', num: 10, name: 'Audit Your Business', tier: 2, tierName: 'The Operating System', action: 'Ask "How healthy is our business?" or request a pulse audit.', signal: 'First scored business health audit', tip: 'You can also say "Have COO review our operational health" — COO coordinates cross-team status and health checks.' },
111
+ { id: 'operating_rhythm', num: 11, name: 'Your Operating Rhythm', tier: 3, tierName: 'Agentic Mastery', action: 'Set up weekly reviews, delegate recurring work to crews, and refine your voice. Upload writing samples from emails, memos, or documents you wrote yourself — the more samples, the sharper the match.', signal: 'Return for second session with intent; establish a routine', tip: 'By now you know the team: COS for daily ops, COO for business operations, GM for content. Address them directly anytime.' },
104
112
  ];
105
113
  export function registerPrompts(server, getClientFn) {
106
114
  server.prompt('assistant_system', 'System prompt for the TACIT workspace assistant — includes persona, progressive disclosure, and safety rules.', async () => {
@@ -287,7 +295,7 @@ export function registerPrompts(server, getClientFn) {
287
295
  lines.push(' Delete (discard), Do (act now), Delegate (forward), Defer (schedule).');
288
296
  lines.push('');
289
297
  }
290
- lines.push('After connecting, try Experience 5 — Morning Brief — to see everything synthesized into a daily operating picture.');
298
+ lines.push('After connecting, try Experience 7 — Morning Brief — to see everything synthesized into a daily operating picture.');
291
299
  return userText(lines.join('\n'));
292
300
  });
293
301
  }
@@ -11,6 +11,7 @@
11
11
  */
12
12
  import { z } from 'zod';
13
13
  import { getClient, TacitApiError, TokenExpiredError } from '../client.js';
14
+ import { featureDisabledResult } from './errors.js';
14
15
  function apiErrorResult(err, toolName) {
15
16
  if (err instanceof TokenExpiredError) {
16
17
  return {
@@ -19,6 +20,9 @@ function apiErrorResult(err, toolName) {
19
20
  };
20
21
  }
21
22
  if (err instanceof TacitApiError) {
23
+ const disabled = featureDisabledResult(err);
24
+ if (disabled)
25
+ return disabled;
22
26
  return { content: [{ type: 'text', text: `API error ${err.statusCode} on ${toolName}: ${err.body}` }], isError: true };
23
27
  }
24
28
  const msg = err instanceof Error ? err.message : String(err);
@@ -367,7 +367,11 @@ export const artifactDeleteInputSchema = z.object({
367
367
  });
368
368
  export const ARTIFACT_DELETE_TOOL_DEF = {
369
369
  name: 'tacit_artifact_delete',
370
- description: 'Soft-delete an artifact by id (sets deleted_at, cascades search_projections cleanup). ' +
370
+ description: 'Soft-delete an artifact by id (sets deleted_at). Removes the artifact\'s search_projections ' +
371
+ 'rows and, for content ingested through /gm (tacit_gm_ingest), the search rows of its data ' +
372
+ 'object, so that content leaves search (unless another active catalog entry still uses that ' +
373
+ 'data object). Lake-sync bridge content (catalog origin SOURCE) is ' +
374
+ 'NOT removed from search by this tool; use the DOC-8 lake content removal path. ' +
371
375
  'DRAFT / UNDER_REVIEW artifacts delete normally. PUBLISHED artifacts require force=true ' +
372
376
  'and MENTAT or TWIN autonomy. confirm must be true. Route: DELETE /api/v1/artifacts/editor/:id.',
373
377
  inputSchema: {
@@ -464,7 +468,9 @@ export function registerArtifactTools(server, getClientFn) {
464
468
  const client = await getClientFn();
465
469
  return buildArtifactVersionsRequest(client, args).execute();
466
470
  });
467
- server.tool('tacit_artifact_delete', 'Soft-delete an artifact. DRAFT/UNDER_REVIEW delete normally. PUBLISHED requires force=true and MENTAT/TWIN autonomy. Route: DELETE /api/v1/artifacts/editor/:id.', {
471
+ // Literal name kept for registry.test.ts's source scan; artifacts.test.ts asserts it equals
472
+ // ARTIFACT_DELETE_TOOL_DEF.name. The description comes only from the def (BUG-340).
473
+ server.tool('tacit_artifact_delete', ARTIFACT_DELETE_TOOL_DEF.description, {
468
474
  id: z.string().uuid().describe('Artifact UUID to delete'),
469
475
  confirm: z.boolean().describe('Must be true to execute — safety guard'),
470
476
  force: z.boolean().optional().describe('Set true to delete a PUBLISHED artifact (requires MENTAT/TWIN autonomy)'),
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { TacitApiError } from '../client.js';
3
- import { success, error } from './errors.js';
3
+ import { success, error, featureDisabledResult } from './errors.js';
4
4
  export function registerChronicleTools(server, getClient) {
5
5
  server.tool('tacit_chronicle_timeline', 'Query the Chronicle timeline with date range, scope, and text filters.', {
6
6
  from: z.string().optional().describe('RFC 3339 lower bound (inclusive)'),
@@ -40,7 +40,7 @@ export function registerChronicleTools(server, getClient) {
40
40
  }
41
41
  catch (e) {
42
42
  if (e instanceof TacitApiError)
43
- return error(e.message);
43
+ return featureDisabledResult(e) ?? error(e.message);
44
44
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
45
45
  }
46
46
  });
@@ -73,7 +73,7 @@ export function registerChronicleTools(server, getClient) {
73
73
  }
74
74
  catch (e) {
75
75
  if (e instanceof TacitApiError)
76
- return error(e.message);
76
+ return featureDisabledResult(e) ?? error(e.message);
77
77
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
78
78
  }
79
79
  });
@@ -99,7 +99,7 @@ export function registerChronicleTools(server, getClient) {
99
99
  }
100
100
  catch (e) {
101
101
  if (e instanceof TacitApiError)
102
- return error(e.message);
102
+ return featureDisabledResult(e) ?? error(e.message);
103
103
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
104
104
  }
105
105
  });
@@ -121,7 +121,7 @@ export function registerChronicleTools(server, getClient) {
121
121
  }
122
122
  catch (e) {
123
123
  if (e instanceof TacitApiError)
124
- return error(e.message);
124
+ return featureDisabledResult(e) ?? error(e.message);
125
125
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
126
126
  }
127
127
  });
@@ -144,7 +144,7 @@ export function registerChronicleTools(server, getClient) {
144
144
  }
145
145
  catch (e) {
146
146
  if (e instanceof TacitApiError)
147
- return error(e.message);
147
+ return featureDisabledResult(e) ?? error(e.message);
148
148
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
149
149
  }
150
150
  });
@@ -158,7 +158,7 @@ export function registerChronicleTools(server, getClient) {
158
158
  }
159
159
  catch (e) {
160
160
  if (e instanceof TacitApiError)
161
- return error(e.message);
161
+ return featureDisabledResult(e) ?? error(e.message);
162
162
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
163
163
  }
164
164
  });
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { TacitApiError } from '../client.js';
3
- import { success, error } from './errors.js';
3
+ import { success, error, featureDisabledResult } from './errors.js';
4
4
  export function registerCrewTools(server, getClient) {
5
5
  server.tool('tacit_dispatch_crew', 'Dispatch a crew for autonomous task execution.', {
6
6
  composition_type: z.string().describe('Crew composition type to dispatch'),
@@ -12,7 +12,7 @@ export function registerCrewTools(server, getClient) {
12
12
  }
13
13
  catch (e) {
14
14
  if (e instanceof TacitApiError)
15
- return error(e.message);
15
+ return featureDisabledResult(e) ?? error(e.message);
16
16
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
17
17
  }
18
18
  });
@@ -26,7 +26,7 @@ export function registerCrewTools(server, getClient) {
26
26
  }
27
27
  catch (e) {
28
28
  if (e instanceof TacitApiError)
29
- return error(e.message);
29
+ return featureDisabledResult(e) ?? error(e.message);
30
30
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
31
31
  }
32
32
  });
@@ -41,7 +41,7 @@ export function registerCrewTools(server, getClient) {
41
41
  }
42
42
  catch (e) {
43
43
  if (e instanceof TacitApiError)
44
- return error(e.message);
44
+ return featureDisabledResult(e) ?? error(e.message);
45
45
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
46
46
  }
47
47
  });
@@ -59,7 +59,7 @@ export function registerCrewTools(server, getClient) {
59
59
  }
60
60
  catch (e) {
61
61
  if (e instanceof TacitApiError)
62
- return error(e.message);
62
+ return featureDisabledResult(e) ?? error(e.message);
63
63
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
64
64
  }
65
65
  });
@@ -77,7 +77,7 @@ export function registerCrewTools(server, getClient) {
77
77
  }
78
78
  catch (e) {
79
79
  if (e instanceof TacitApiError)
80
- return error(e.message);
80
+ return featureDisabledResult(e) ?? error(e.message);
81
81
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
82
82
  }
83
83
  });
@@ -91,7 +91,7 @@ export function registerCrewTools(server, getClient) {
91
91
  }
92
92
  catch (e) {
93
93
  if (e instanceof TacitApiError)
94
- return error(e.message);
94
+ return featureDisabledResult(e) ?? error(e.message);
95
95
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
96
96
  }
97
97
  });
@@ -108,7 +108,7 @@ export function registerCrewTools(server, getClient) {
108
108
  }
109
109
  catch (e) {
110
110
  if (e instanceof TacitApiError)
111
- return error(e.message);
111
+ return featureDisabledResult(e) ?? error(e.message);
112
112
  return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
113
113
  }
114
114
  });
@@ -9,6 +9,9 @@ export declare function success(data: unknown): ToolResult;
9
9
  export declare function error(message: string): ToolResult & {
10
10
  isError: true;
11
11
  };
12
+ export declare function featureDisabledResult(err: unknown): (ToolResult & {
13
+ isError: true;
14
+ }) | null;
12
15
  export declare function apiErrorResult(err: unknown, endpoint: string): ToolResult & {
13
16
  isError: boolean;
14
17
  };
@@ -5,6 +5,22 @@ export function success(data) {
5
5
  export function error(message) {
6
6
  return { isError: true, content: [{ type: 'text', text: message }] };
7
7
  }
8
+ export function featureDisabledResult(err) {
9
+ if (!(err instanceof TacitApiError))
10
+ return null;
11
+ let parsed;
12
+ try {
13
+ parsed = JSON.parse(err.body);
14
+ }
15
+ catch {
16
+ return null;
17
+ }
18
+ if (parsed?.error?.code !== 'FEATURE_DISABLED')
19
+ return null;
20
+ const flagMatch = parsed.error.message?.match(/feature flag ([A-Z][A-Z0-9_]*) is off/);
21
+ const flag = flagMatch ? flagMatch[1] : 'unknown';
22
+ return error(`Feature flag ${flag} is disabled on this cell. Enable it in the flag registry and restart.`);
23
+ }
8
24
  export function apiErrorResult(err, endpoint) {
9
25
  if (err instanceof TokenExpiredError) {
10
26
  return {
@@ -13,6 +29,9 @@ export function apiErrorResult(err, endpoint) {
13
29
  };
14
30
  }
15
31
  if (err instanceof TacitApiError) {
32
+ const disabled = featureDisabledResult(err);
33
+ if (disabled)
34
+ return disabled;
16
35
  return { content: [{ type: 'text', text: `API error ${err.statusCode} on ${endpoint}: ${err.body}` }], isError: true };
17
36
  }
18
37
  const msg = err instanceof Error ? err.message : String(err);
@@ -9,11 +9,15 @@
9
9
  */
10
10
  import { z } from 'zod';
11
11
  import { TacitApiError, TokenExpiredError } from '../client.js';
12
+ import { featureDisabledResult } from './errors.js';
12
13
  function apiErrorResult(err, toolName) {
13
14
  if (err instanceof TokenExpiredError) {
14
15
  return { content: [{ type: 'text', text: err.message }], isError: true };
15
16
  }
16
17
  if (err instanceof TacitApiError) {
18
+ const disabled = featureDisabledResult(err);
19
+ if (disabled)
20
+ return disabled;
17
21
  return { content: [{ type: 'text', text: `API error ${err.statusCode} on ${toolName}: ${err.body}` }], isError: true };
18
22
  }
19
23
  const msg = err instanceof Error ? err.message : String(err);
@@ -18,8 +18,24 @@ export interface ToolRequest {
18
18
  isError?: boolean;
19
19
  }>;
20
20
  }
21
+ /** Largest file `file_path` will read (10 MiB). */
22
+ export declare const GM_INGEST_MAX_FILE_BYTES: number;
23
+ type FileReadResult = {
24
+ ok: true;
25
+ content: string;
26
+ } | {
27
+ ok: false;
28
+ reason: string;
29
+ };
30
+ /**
31
+ * Read a local file for tacit_gm_ingest (BUG-333). Only on the stdio transport, only
32
+ * inside the allowed roots (after resolving symlinks), only text formats, size-capped.
33
+ * A missing file is an error — never ingest the path string itself.
34
+ */
35
+ export declare function readGmIngestFile(filePath: string): FileReadResult;
21
36
  export declare const gmIngestInputSchema: z.ZodObject<{
22
- content: z.ZodString;
37
+ content: z.ZodOptional<z.ZodString>;
38
+ file_path: z.ZodOptional<z.ZodString>;
23
39
  title: z.ZodString;
24
40
  source_uri: z.ZodOptional<z.ZodString>;
25
41
  content_type: z.ZodOptional<z.ZodString>;
@@ -34,19 +50,21 @@ export declare const gmIngestInputSchema: z.ZodObject<{
34
50
  content_type?: string | undefined;
35
51
  }>>;
36
52
  }, "strip", z.ZodTypeAny, {
37
- content: string;
38
53
  title: string;
54
+ content?: string | undefined;
39
55
  source_uri?: string | undefined;
40
56
  content_type?: string | undefined;
57
+ file_path?: string | undefined;
41
58
  classification_hints?: {
42
59
  domain?: string | undefined;
43
60
  content_type?: string | undefined;
44
61
  } | undefined;
45
62
  }, {
46
- content: string;
47
63
  title: string;
64
+ content?: string | undefined;
48
65
  source_uri?: string | undefined;
49
66
  content_type?: string | undefined;
67
+ file_path?: string | undefined;
50
68
  classification_hints?: {
51
69
  domain?: string | undefined;
52
70
  content_type?: string | undefined;
@@ -63,6 +81,10 @@ export declare const GM_INGEST_TOOL_DEF: {
63
81
  type: string;
64
82
  description: string;
65
83
  };
84
+ file_path: {
85
+ type: string;
86
+ description: string;
87
+ };
66
88
  title: {
67
89
  type: string;
68
90
  description: string;
@@ -102,34 +124,34 @@ export declare function handleGmIngest(args: unknown): Promise<{
102
124
  export declare const gmApproveInputSchema: z.ZodObject<{
103
125
  catalog_id: z.ZodString;
104
126
  approved_targets: z.ZodArray<z.ZodObject<{
105
- surface: z.ZodEnum<["kb", "pyramid"]>;
106
- collection_or_program: z.ZodOptional<z.ZodString>;
127
+ surface: z.ZodLiteral<"pyramid">;
128
+ collection_or_program: z.ZodString;
107
129
  dossier_id: z.ZodOptional<z.ZodString>;
108
- }, "strip", z.ZodTypeAny, {
109
- surface: "kb" | "pyramid";
130
+ }, "strict", z.ZodTypeAny, {
131
+ surface: "pyramid";
132
+ collection_or_program: string;
110
133
  dossier_id?: string | undefined;
111
- collection_or_program?: string | undefined;
112
134
  }, {
113
- surface: "kb" | "pyramid";
135
+ surface: "pyramid";
136
+ collection_or_program: string;
114
137
  dossier_id?: string | undefined;
115
- collection_or_program?: string | undefined;
116
138
  }>, "many">;
117
139
  rejected_targets: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
118
140
  surface: z.ZodString;
119
141
  reason: z.ZodOptional<z.ZodString>;
120
- }, "strip", z.ZodTypeAny, {
142
+ }, "strict", z.ZodTypeAny, {
121
143
  surface: string;
122
144
  reason?: string | undefined;
123
145
  }, {
124
146
  surface: string;
125
147
  reason?: string | undefined;
126
148
  }>, "many">>>;
127
- }, "strip", z.ZodTypeAny, {
149
+ }, "strict", z.ZodTypeAny, {
128
150
  catalog_id: string;
129
151
  approved_targets: {
130
- surface: "kb" | "pyramid";
152
+ surface: "pyramid";
153
+ collection_or_program: string;
131
154
  dossier_id?: string | undefined;
132
- collection_or_program?: string | undefined;
133
155
  }[];
134
156
  rejected_targets: {
135
157
  surface: string;
@@ -138,9 +160,9 @@ export declare const gmApproveInputSchema: z.ZodObject<{
138
160
  }, {
139
161
  catalog_id: string;
140
162
  approved_targets: {
141
- surface: "kb" | "pyramid";
163
+ surface: "pyramid";
164
+ collection_or_program: string;
142
165
  dossier_id?: string | undefined;
143
- collection_or_program?: string | undefined;
144
166
  }[];
145
167
  rejected_targets?: {
146
168
  surface: string;
@@ -153,6 +175,7 @@ export declare const GM_APPROVE_TOOL_DEF: {
153
175
  description: string;
154
176
  inputSchema: {
155
177
  type: "object";
178
+ additionalProperties: boolean;
156
179
  properties: {
157
180
  catalog_id: {
158
181
  type: string;
@@ -160,8 +183,11 @@ export declare const GM_APPROVE_TOOL_DEF: {
160
183
  };
161
184
  approved_targets: {
162
185
  type: string;
186
+ minItems: number;
187
+ maxItems: number;
163
188
  items: {
164
189
  type: string;
190
+ additionalProperties: boolean;
165
191
  properties: {
166
192
  surface: {
167
193
  type: string;
@@ -185,6 +211,7 @@ export declare const GM_APPROVE_TOOL_DEF: {
185
211
  type: string;
186
212
  items: {
187
213
  type: string;
214
+ additionalProperties: boolean;
188
215
  properties: {
189
216
  surface: {
190
217
  type: string;
@@ -212,3 +239,4 @@ export declare function handleGmApprove(args: unknown): Promise<{
212
239
  isError?: boolean;
213
240
  }>;
214
241
  export declare function registerGmTools(server: McpServer, getClientFn: () => Promise<TacitClient>): void;
242
+ export {};