@tacitai/mcp-server 0.6.13 → 0.6.15

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
@@ -47,9 +47,9 @@ export declare const EXPERIENCES: readonly [{
47
47
  readonly name: "Feed It";
48
48
  readonly tier: 1;
49
49
  readonly tierName: "Orient & Equip";
50
- readonly action: "Turn your first answer into a workspace document. Say: \"Take what you just told me and add it to the workspace.\" TACIT will use the synthesis from your last question as the document body and ask your General Manager to propose where it belongs. If you know where you want it placed, say so — if not, just say \"you decide\" and the GM will recommend a spot. You approve before anything moves.";
51
- readonly signal: "First content ingested and placed via GM";
52
- readonly tip: "Your General Manager handles content placement and classification. Everything goes through a propose-then-approve flow — nothing moves without your say-so.";
50
+ readonly action: "Turn your first answer into a workspace document. Say: \"Take what you just told me and add it to the workspace.\" TACIT will use the synthesis from your last question as the document body and send it through the General Manager. The GM ingests it into the data lake, then reviews your workspace pyramid to propose where to place it — for example, \"I recommend placing this in Company Overview → Services.\" You approve or redirect before anything moves. If you know where you want it, say so — if not, say \"you decide\" and the GM proposes.";
51
+ readonly signal: "First content ingested via GM, pyramid placement proposed and approved";
52
+ readonly tip: "Your General Manager handles content placement in two steps: first it goes to the data lake (cataloged and classified), then the GM proposes where to file it in your workspace pyramid. You approve before anything moves — nothing is placed without your say-so.";
53
53
  }, {
54
54
  readonly id: "build_your_map";
55
55
  readonly num: 5;
package/dist/prompts.js CHANGED
@@ -54,6 +54,8 @@ function buildAssistantSystemPrompt(state) {
54
54
  lines.push('');
55
55
  lines.push('Prefer a single read tool for direct lookups, synthesis for open questions, and ask before any write or dispatch.');
56
56
  lines.push('- For all synthesis and research requests, use burst mode. Do not use crew_compose or orbit modes — they are under review and not reliable for the MCP experience. If a task seems to need multi-step agentic work, break it into sequential burst calls instead.');
57
+ lines.push('- For all content ingestion (adding documents, text, URLs, or files to the workspace), always use tacit_gm_ingest. Do not call tacit_artifact_create, tacit_import_artifact, tacit_ingest_file, tacit_ingest_url, tacit_ingest_url_general, or tacit_kb_create_article directly for new content — those bypass the data lake classification pipeline. The GM tool creates a catalog entry, classifies the content, and creates the artifact.');
58
+ lines.push('- After tacit_gm_ingest succeeds, ALWAYS propose pyramid placement before considering the task done. Steps: (1) Call tacit_pyramid_list_portfolios to see the workspace structure, then drill into programs and dossiers to find the best match for the content. (2) Present the user with a specific proposal: "I recommend placing this in [portfolio] → [program] → [dossier] because [reason]. Approve?" (3) If the user approves, call tacit_gm_approve with the catalog_id and the approved pyramid target. (4) If the user says lake-only or declines placement, that is fine — acknowledge it. Never skip the proposal step or treat lake ingestion alone as "done." The user expects a propose-then-approve flow for every piece of content.');
57
59
  return lines.join('\n');
58
60
  }
59
61
  export async function fetchWorkspaceState(client) {
@@ -106,7 +108,7 @@ export const EXPERIENCES = [
106
108
  { 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: '' },
107
109
  { 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: '' },
108
110
  { 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: '' },
109
- { id: 'feed_it', num: 4, name: 'Feed It', tier: 1, tierName: 'Orient & Equip', action: 'Turn your first answer into a workspace document. Say: "Take what you just told me and add it to the workspace." TACIT will use the synthesis from your last question as the document body and ask your General Manager to propose where it belongs. If you know where you want it placed, say so — if not, just say "you decide" and the GM will recommend a spot. You approve before anything moves.', signal: 'First content ingested and placed via GM', tip: 'Your General Manager handles content placement and classification. Everything goes through a propose-then-approve flow — nothing moves without your say-so.' },
111
+ { id: 'feed_it', num: 4, name: 'Feed It', tier: 1, tierName: 'Orient & Equip', action: 'Turn your first answer into a workspace document. Say: "Take what you just told me and add it to the workspace." TACIT will use the synthesis from your last question as the document body and send it through the General Manager. The GM ingests it into the data lake, then reviews your workspace pyramid to propose where to place it — for example, "I recommend placing this in Company Overview → Services." You approve or redirect before anything moves. If you know where you want it, say so — if not, say "you decide" and the GM proposes.', signal: 'First content ingested via GM, pyramid placement proposed and approved', tip: 'Your General Manager handles content placement in two steps: first it goes to the data lake (cataloged and classified), then the GM proposes where to file it in your workspace pyramid. You approve before anything moves — nothing is placed without your say-so.' },
110
112
  { id: 'build_your_map', num: 5, name: 'Build Your Map', tier: 1, tierName: 'Orient & Equip', action: 'Say: "Organize my workspace — suggest a structure based on what is here." TACIT will look at the content already in your workspace and propose collections, portfolios, or categories that make sense for your business. You review the suggestions and approve what fits. This is how your workspace becomes navigable — and you do not need to know the right terms, just say yes or no.', signal: 'First organizational structure created', tip: 'You can always reorganize later. Say "Move this to [collection]" or "Create a new collection for [topic]" anytime. Your General Manager proposes, you approve.' },
111
113
  { 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: '' },
112
114
  { id: 'research_publish', num: 7, name: 'Research & Publish', tier: 2, tierName: 'The Operating System', action: 'Research a topic and publish a report — try "Research [topic] using the web, academic sources, and our workspace knowledge, then publish it as a report." This takes a few minutes. TACIT searches the web, academic databases, and your workspace knowledge all at once, then produces a styled report with citations and proposes where to file it. Add a Gemini API key to unlock Google Deep Research for deeper web and academic sources.', signal: 'First research artifact published — combining workspace knowledge with web and academic sources into a single deliverable', tip: 'After publishing, your General Manager will propose where to place the report in your knowledge structure — you approve the placement.' },
@@ -98,7 +98,8 @@ export const artifactCreateInputSchema = z.object({
98
98
  });
99
99
  export const ARTIFACT_CREATE_TOOL_DEF = {
100
100
  name: 'tacit_artifact_create',
101
- description: 'Create an artifact in Tacit. ' +
101
+ description: 'For new content, prefer tacit_gm_ingest (lake-first). This tool creates an artifact directly without a data lake catalog entry or classification. ' +
102
+ 'Create an artifact in Tacit. ' +
102
103
  'Accepts a title, optional domain (CAREER, GENERAL, ENGINEERING, PRODUCT — defaults to GENERAL), ' +
103
104
  'and an optional structured_metadata object; portfolio_id is required. ' +
104
105
  'The artifact body is populated server-side from structured_metadata (e.g. full_posting_text), ' +
@@ -424,7 +425,7 @@ export function registerArtifactTools(server, getClientFn) {
424
425
  const client = await getClientFn();
425
426
  return buildArtifactListRequest(client, args).execute();
426
427
  });
427
- server.tool('tacit_artifact_create', 'Create an artifact. Route: POST /api/v1/artifacts.', {
428
+ server.tool('tacit_artifact_create', 'For new content, prefer tacit_gm_ingest (lake-first). This tool creates an artifact directly without a data lake catalog entry or classification. Create an artifact. Route: POST /api/v1/artifacts.', {
428
429
  title: z.string().min(1).describe('Artifact title'),
429
430
  domain: z.string().optional().describe('Domain tag (e.g. CAREER, GENERAL, ENGINEERING, PRODUCT). Defaults to GENERAL.'),
430
431
  portfolio_id: z.string().min(1).describe('Portfolio UUID (REQUIRED)'),
@@ -502,7 +503,7 @@ export function registerArtifactTools(server, getClientFn) {
502
503
  return apiErrorResult(err, `/api/v1/artifacts/${args.artifact_id}/html-token`);
503
504
  }
504
505
  });
505
- server.tool('tacit_import_artifact', 'Import an artifact from external content into a portfolio/program.', {
506
+ server.tool('tacit_import_artifact', 'For new content, prefer tacit_gm_ingest (lake-first). This tool imports directly without a data lake catalog entry. Import an artifact from external content into a portfolio/program.', {
506
507
  portfolio_id: z.string().uuid().describe('Target portfolio UUID'),
507
508
  program_id: z.string().uuid().describe('Target program UUID'),
508
509
  title: z.string().describe('Artifact title'),
@@ -108,7 +108,7 @@ export const ingestFileInputSchema = z.object({
108
108
  });
109
109
  export const INGEST_FILE_TOOL_DEF = {
110
110
  name: 'tacit_ingest_file',
111
- description: 'Ingest a local file into a Tacit portfolio. Route: POST /api/v1/portfolios/:id/ingest.',
111
+ description: 'For new content, prefer tacit_gm_ingest (lake-first). This tool ingests directly into a portfolio without a data lake catalog entry. Ingest a local file into a Tacit portfolio. Route: POST /api/v1/portfolios/:id/ingest.',
112
112
  inputSchema: {
113
113
  type: 'object',
114
114
  properties: {
@@ -163,7 +163,8 @@ export const ingestUrlGeneralInputSchema = z.object({
163
163
  });
164
164
  export const INGEST_URL_GENERAL_TOOL_DEF = {
165
165
  name: 'tacit_ingest_url_general',
166
- description: 'Ingest any public URL (PDF, HTML, text) into a Tacit portfolio. Not domain-restricted. ' +
166
+ description: 'For new content, prefer tacit_gm_ingest (lake-first). This tool ingests directly into a portfolio without a data lake catalog entry. ' +
167
+ 'Ingest any public URL (PDF, HTML, text) into a Tacit portfolio. Not domain-restricted. ' +
167
168
  'Route: POST /api/v1/portfolios/:id/ingest-url-general. ' +
168
169
  'URL must use https:// scheme and must not resolve to private/loopback addresses (SSRF protection).',
169
170
  inputSchema: {
@@ -218,7 +219,8 @@ export const ingestUrlInputSchema = z.object({
218
219
  });
219
220
  export const INGEST_URL_TOOL_DEF = {
220
221
  name: 'tacit_ingest_url',
221
- description: 'Ingest a public URL into a Tacit portfolio. Route: POST /api/v1/portfolios/:id/ingest-url. ' +
222
+ description: 'For new content, prefer tacit_gm_ingest (lake-first). This tool ingests directly into a portfolio without a data lake catalog entry. ' +
223
+ 'Ingest a public URL into a Tacit portfolio. Route: POST /api/v1/portfolios/:id/ingest-url. ' +
222
224
  'URL must use https:// scheme and must not resolve to private/loopback addresses (SSRF protection).',
223
225
  inputSchema: {
224
226
  type: 'object',
@@ -263,7 +265,7 @@ export async function handleIngestUrl(args) {
263
265
  return buildIngestUrlRequest(getClient(), parsed.data).execute();
264
266
  }
265
267
  export function registerIngestTools(server, getClientFn) {
266
- server.tool('tacit_ingest_file', 'Ingest a local file into a Tacit portfolio. Route: POST /api/v1/portfolios/:id/ingest.', {
268
+ server.tool('tacit_ingest_file', 'For new content, prefer tacit_gm_ingest (lake-first). This tool ingests directly into a portfolio without a data lake catalog entry. Ingest a local file into a Tacit portfolio. Route: POST /api/v1/portfolios/:id/ingest.', {
267
269
  portfolio_id: z.string().min(1).describe('Portfolio UUID to ingest into'),
268
270
  path: z.string().min(1).describe('Local file path to ingest'),
269
271
  title: z.string().optional().describe('Optional title override'),
@@ -271,7 +273,7 @@ export function registerIngestTools(server, getClientFn) {
271
273
  const client = await getClientFn();
272
274
  return buildIngestFileRequest(client, args).execute();
273
275
  });
274
- server.tool('tacit_ingest_url', 'Ingest a public URL into a Tacit portfolio (SSRF-guarded). Route: POST /api/v1/portfolios/:id/ingest-url.', {
276
+ server.tool('tacit_ingest_url', 'For new content, prefer tacit_gm_ingest (lake-first). This tool ingests directly into a portfolio without a data lake catalog entry. Ingest a public URL into a Tacit portfolio (SSRF-guarded). Route: POST /api/v1/portfolios/:id/ingest-url.', {
275
277
  portfolio_id: z.string().min(1).describe('Portfolio UUID to ingest into'),
276
278
  url: z.string().min(1).describe('Public HTTPS URL to ingest'),
277
279
  program_id: z.string().min(1).describe('Program UUID within the portfolio'),
@@ -279,7 +281,7 @@ export function registerIngestTools(server, getClientFn) {
279
281
  const client = await getClientFn();
280
282
  return buildIngestUrlRequest(client, args).execute();
281
283
  });
282
- server.tool('tacit_ingest_url_general', 'Ingest any public URL (PDF, HTML, text) into a Tacit portfolio — not domain-restricted. Route: POST /api/v1/portfolios/:id/ingest-url-general.', {
284
+ server.tool('tacit_ingest_url_general', 'For new content, prefer tacit_gm_ingest (lake-first). This tool ingests directly into a portfolio without a data lake catalog entry. Ingest any public URL (PDF, HTML, text) into a Tacit portfolio — not domain-restricted. Route: POST /api/v1/portfolios/:id/ingest-url-general.', {
283
285
  portfolio_id: z.string().min(1).describe('Portfolio UUID to ingest into'),
284
286
  url: z.string().min(1).describe('Public HTTPS URL to ingest (PDF, HTML, text)'),
285
287
  program_id: z.string().optional().describe('Optional program UUID within the portfolio'),
package/dist/tools/kb.js CHANGED
@@ -282,7 +282,7 @@ export const createArticleInputSchema = z.object({
282
282
  });
283
283
  export const CREATE_ARTICLE_TOOL_DEF = {
284
284
  name: 'tacit_kb_create_article',
285
- description: 'Create a new KB article within a collection. Status defaults to DRAFT.',
285
+ description: '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.',
286
286
  inputSchema: {
287
287
  type: 'object',
288
288
  properties: {
package/package.json CHANGED
@@ -1,6 +1,7 @@
1
1
  {
2
2
  "name": "@tacitai/mcp-server",
3
- "version": "0.6.13",
3
+ "version": "0.6.15",
4
+ "private": false,
4
5
  "description": "stdio MCP server wrapping Tacit /api/v1 REST/SSE API",
5
6
  "license": "UNLICENSED",
6
7
  "repository": {