@tacitai/mcp-server 0.6.12 → 0.6.14

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,18 +47,18 @@ 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: "Create your first piece of content — try \"Write a short summary of what our business does and add it to the workspace.\" TACIT will draft, ingest, and classify it automatically. You now have something you made in the system.";
51
- readonly signal: "First successful content creation and ingestion";
52
- readonly tip: "You can bring in content from anywhere — URLs, documents, files. Say \"Add this to the workspace\" and your General Manager handles the rest.";
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.";
53
53
  }, {
54
54
  readonly id: "build_your_map";
55
55
  readonly num: 5;
56
56
  readonly name: "Build Your Map";
57
57
  readonly tier: 1;
58
58
  readonly tierName: "Orient & Equip";
59
- readonly action: "Organize your workspace — ask to create a collection for a topic, build a portfolio for a project, or structure your business knowledge. This is how content finds its home. You can also ask to remove the item you created in Experience 4 if it was just for practice — say \"Remove the summary I just added.\"";
60
- readonly signal: "First organizational write operation";
61
- readonly tip: "Your General Manager handles content placement and classification. Say \"Organize our knowledge on [topic]\" and it will propose where things belong — you approve before anything moves.";
59
+ readonly 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.";
60
+ readonly signal: "First organizational structure created";
61
+ readonly 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.";
62
62
  }, {
63
63
  readonly id: "connect_your_tools";
64
64
  readonly num: 6;
@@ -83,9 +83,9 @@ export declare const EXPERIENCES: readonly [{
83
83
  readonly name: "Run Sales";
84
84
  readonly tier: 2;
85
85
  readonly tierName: "The Operating System";
86
- readonly action: "Ask to prepare a proposal, run discovery on a prospect, or build a quote — try \"Prepare a discovery brief for [prospect name] in [industry].\" Then compose the follow-up email in your voice — \"Draft an intro email to them 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. Your Chief Operating Officer handles business operations and sales — say \"Have COO plan a proposal for [client].\"";
86
+ readonly action: "Say: \"Prepare a discovery brief for a potential client.\" TACIT will use what it knows about your business from the workspace to build a discovery framework — the kind of questions you would ask a prospect, the value propositions that fit your offering, and a structured brief template. You do not need to name a specific prospect; TACIT builds the framework from your business context. After the brief, try: \"Now draft an intro email for this prospect, in my voice.\"";
87
+ readonly signal: "First sales deliverable built from workspace knowledge, 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.";
89
89
  }, {
90
90
  readonly id: "morning_brief";
91
91
  readonly num: 9;
package/dist/prompts.js CHANGED
@@ -16,6 +16,7 @@ function buildAssistantSystemPrompt(state) {
16
16
  lines.push('- NEVER expose tool names, function names, API endpoints, artifact IDs, SHA hashes, or technical identifiers in your responses. Translate everything into plain language the user would understand. Instead of "tacit_gm_approve" say "approve the placement." Instead of "tacit_kb_promote_from_artifact" say "promote it to the knowledge base." Instead of "crew_compose" say "draft." Instead of "kb_create_collection" say "create a new collection." If a tool returns technical fields (catalog entry IDs, SHA256 fingerprints, confidence scores), summarize the outcome in human terms — "Your content is now in the workspace" not a list of UUIDs.');
17
17
  lines.push('- When something works, say what happened in plain language and name the collection or source — not the tool that did it.');
18
18
  lines.push('- Never narrate internal routing decisions, retrieval path choices, or fallback strategies. If one approach does not return results, silently try another. The user should see the answer, not the search process.');
19
+ lines.push('- When a capability is unavailable (missing API key, unconnected service, feature not configured), be kind and reassuring. Say what you CAN do, not what is broken. For example: "Deep research works best with a Gemini API key — I do not see one set up yet, but that is no problem. I have great research tools built in, so let me use those today." Never announce a limitation bluntly or make the user feel their setup is wrong.');
19
20
  lines.push('');
20
21
  lines.push('## How you work');
21
22
  lines.push('');
@@ -41,6 +42,8 @@ function buildAssistantSystemPrompt(state) {
41
42
  lines.push('');
42
43
  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.');
43
44
  lines.push('');
45
+ lines.push('During onboarding experiences, minimize what you ask from the user. Each experience should require at most one short sentence from the user — you do the heavy lifting. Never ask the user to provide details, pick topics, or name entities before you start working. Use what is already in the workspace, make reasonable defaults, and let the user correct you if needed. The goal is delight through effortless demonstration, not a task list.');
46
+ lines.push('');
44
47
  lines.push('## Safety');
45
48
  lines.push('');
46
49
  lines.push('- Never modify or delete content without explicit approval.');
@@ -51,6 +54,7 @@ function buildAssistantSystemPrompt(state) {
51
54
  lines.push('');
52
55
  lines.push('Prefer a single read tool for direct lookups, synthesis for open questions, and ask before any write or dispatch.');
53
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, creates the artifact, and proposes where to place it. After GM proposes placement, use tacit_gm_approve to confirm.');
54
58
  return lines.join('\n');
55
59
  }
56
60
  export async function fetchWorkspaceState(client) {
@@ -103,11 +107,11 @@ export const EXPERIENCES = [
103
107
  { 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: '' },
104
108
  { 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: '' },
105
109
  { 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: '' },
106
- { id: 'feed_it', num: 4, name: 'Feed It', tier: 1, tierName: 'Orient & Equip', action: 'Create your first piece of content — try "Write a short summary of what our business does and add it to the workspace." TACIT will draft, ingest, and classify it automatically. You now have something you made in the system.', signal: 'First successful content creation and ingestion', tip: 'You can bring in content from anywhere — URLs, documents, files. Say "Add this to the workspace" and your General Manager handles the rest.' },
107
- { id: 'build_your_map', num: 5, name: 'Build Your Map', tier: 1, tierName: 'Orient & Equip', action: 'Organize your workspace — ask to create a collection for a topic, build a portfolio for a project, or structure your business knowledge. This is how content finds its home. You can also ask to remove the item you created in Experience 4 if it was just for practice — say "Remove the summary I just added."', signal: 'First organizational write operation', tip: 'Your General Manager handles content placement and classification. Say "Organize our knowledge on [topic]" and it will propose where things belong — you approve before anything moves.' },
110
+ { 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: '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.' },
108
112
  { 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: '' },
109
113
  { 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.' },
110
- { 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 — try "Prepare a discovery brief for [prospect name] in [industry]." Then compose the follow-up email in your voice — "Draft an intro email to them 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. Your Chief Operating Officer handles business operations and sales — say "Have COO plan a proposal for [client]."' },
114
+ { id: 'run_sales', num: 8, name: 'Run Sales', tier: 2, tierName: 'The Operating System', action: 'Say: "Prepare a discovery brief for a potential client." TACIT will use what it knows about your business from the workspace to build a discovery framework — the kind of questions you would ask a prospect, the value propositions that fit your offering, and a structured brief template. You do not need to name a specific prospect; TACIT builds the framework from your business context. After the brief, try: "Now draft an intro email for this prospect, in my voice."', signal: 'First sales deliverable built from workspace knowledge, 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.' },
111
115
  { 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).' },
112
116
  { 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.' },
113
117
  { 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.' },
@@ -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,6 @@
1
1
  {
2
2
  "name": "@tacitai/mcp-server",
3
- "version": "0.6.12",
3
+ "version": "0.6.14",
4
4
  "description": "stdio MCP server wrapping Tacit /api/v1 REST/SSE API",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {