@bike4mind/cli 0.2.5-fix-github-issue-type.17095 → 0.2.6-fix-cli-mcp-type-mismatch.17119

package/README.md

@@ -172,13 +172,15 @@ export SERPER_API_KEY="your-key-here"
 
 MCP (Model Context Protocol) servers provide additional tools and capabilities. Configure them in `~/.bike4mind/config.json`:
 
+#### Internal MCP Servers (Node.js)
+
+For MCP servers bundled with the monorepo, you can omit `command` and `args` - the CLI will automatically discover them:
+
 ```json
 {
   "mcpServers": [
     {
       "name": "github",
-      "command": "node",
-      "args": ["path/to/mcp/server.js"],
       "env": {
         "GITHUB_ACCESS_TOKEN": "ghp_..."
       },
@@ -188,12 +190,56 @@ MCP (Model Context Protocol) servers provide additional tools and capabilities.
 }
 ```
 
-**Available MCP Servers:**
+#### External MCP Servers (Docker)
+
+You can run MCP servers in Docker containers for isolation and portability:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "github",
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "GITHUB_TOKEN", "ghcr.io/github/github-mcp-server"],
+      "env": {
+        "GITHUB_TOKEN": "ghp_..."
+      },
+      "enabled": true
+    }
+  ]
+}
+```
+
+**Docker Configuration Notes:**
+- The `-i` flag is required for stdin communication with the MCP server
+- Use `-e VAR_NAME` (without value) to pass environment variables from the host
+- The `--rm` flag ensures containers are cleaned up after use
+- Requires Docker to be installed and running
+
+#### External MCP Servers (npx/Custom Commands)
+
+You can also run any MCP server via npx or custom executables:
+
+```json
+{
+  "mcpServers": [
+    {
+      "name": "filesystem",
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"],
+      "env": {},
+      "enabled": true
+    }
+  ]
+}
+```
+
+**Available Built-in MCP Servers:**
 - 🔧 **GitHub** - Repository management, issues, PRs (requires `GITHUB_ACCESS_TOKEN`)
 - 🔧 **LinkedIn** - Post management, analytics (requires `LINKEDIN_ACCESS_TOKEN`, `COMPANY_NAME`)
 - 🔧 **Atlassian** - Jira/Confluence integration (requires `ATLASSIAN_ACCESS_TOKEN`, `ATLASSIAN_CLOUD_ID`, `ATLASSIAN_SITE_URL`)
 
-**Note:** MCP servers must be built and available in the `b4m-core/packages/mcp/dist/src/` directory. The CLI will automatically find them if you're running from the monorepo.
+**Note:** Internal MCP servers must be built and available in the `b4m-core/packages/mcp/dist/src/` directory. The CLI will automatically find them if you're running from the monorepo. For Docker-based servers, ensure Docker is installed and the image is accessible.
 
 ## Session Storage
 

package/dist/{artifactExtractor-XKSGESLB.js → artifactExtractor-DNE5C6DY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-7Y3E4OY6.js";
+} from "./chunk-H6SHASMZ.js";
 import "./chunk-PDX44BCA.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/artifactExtractor.js

package/dist/{chunk-MPZQL3KY.js → chunk-3CCBDIFR.js}

@@ -6,12 +6,12 @@ import {
   getSettingsByNames,
   obfuscateApiKey,
   secureParameters
-} from "./chunk-KH2C4VVX.js";
+} from "./chunk-DNSBC3LO.js";
 import {
   ApiKeyType,
   MementoTier,
   isSupportedEmbeddingModel
-} from "./chunk-7Y3E4OY6.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/services/dist/src/apiKeyService/get.js
 import { z } from "zod";

package/dist/{chunk-KH2C4VVX.js → chunk-DNSBC3LO.js}

@@ -16,7 +16,7 @@ import {
   dayjsConfig_default,
   extractSnippetMeta,
   settingsMap
-} from "./chunk-7Y3E4OY6.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/utils/dist/src/storage/S3Storage.js
 import { S3Client, PutObjectCommand, DeleteObjectCommand, GetObjectCommand, HeadObjectCommand } from "@aws-sdk/client-s3";

package/dist/{chunk-7Y3E4OY6.js → chunk-H6SHASMZ.js}

@@ -3745,6 +3745,35 @@ var ToolHealthSchema = z21.object({
   lastExecutionTime: z21.number().optional(),
   successRate: z21.number().optional()
 });
+var CitableSourceSchema = z21.object({
+  /** Unique identifier - can be URL, UUID, or composite key */
+  id: z21.string(),
+  /** Source classification for UI rendering */
+  type: z21.enum(["web_url", "document", "dataset", "mcp"]),
+  /** Human-readable title/name */
+  title: z21.string(),
+  /** Navigation target (external URL, deep link, or hash route) */
+  url: z21.string().optional(),
+  /** Brief description or excerpt (1-2 sentences) */
+  description: z21.string().optional(),
+  /** ISO 8601 timestamp for freshness indication */
+  timestamp: z21.string().optional(),
+  /** Attribution for non-report sources */
+  author: z21.string().optional(),
+  /** Processing status for real-time updates */
+  status: z21.enum(["pending", "processing", "complete", "error"]).optional(),
+  /** Extensibility metadata */
+  metadata: z21.object({
+    sourceSystem: z21.string().optional(),
+    icon: z21.string().optional(),
+    tags: z21.array(z21.string()).optional(),
+    confidence: z21.number().optional(),
+    practiceAreas: z21.array(z21.string()).optional(),
+    chunkId: z21.string().optional(),
+    relevanceScore: z21.number().optional(),
+    fullContext: z21.string().optional()
+  }).passthrough().optional()
+});
 var PromptMetaZodSchema = z21.object({
   model: PromptMetaModelSchema.optional(),
   tokenUsage: PromptMetaTokenUsageSchema.optional(),
@@ -3787,7 +3816,9 @@ var PromptMetaZodSchema = z21.object({
     failedSteps: z21.array(z21.string()).optional()
   }).optional(),
   // Phase 2: Tool health tracking
-  toolHealth: z21.array(ToolHealthSchema).optional()
+  toolHealth: z21.array(ToolHealthSchema).optional(),
+  // Citable sources referenced in AI responses (from web_search, deep_research, RAG, MCP)
+  citables: z21.array(CitableSourceSchema).optional()
 });
 
 // ../../b4m-core/packages/common/dist/src/schemas/analytics/events/ai.js
@@ -6060,6 +6091,7 @@ export {
   API_SERVICE_GROUPS,
   settingsMap,
   StringBooleanSchema,
+  CitableSourceSchema,
   PromptMetaZodSchema,
   AiEvents,
   ApiKeyEvents,

package/dist/{chunk-PKOGN2ZZ.js → chunk-LIRY24M5.js}

@@ -2,7 +2,7 @@
 import {
   BadRequestError,
   secureParameters
-} from "./chunk-KH2C4VVX.js";
+} from "./chunk-DNSBC3LO.js";
 import {
   GenericCreditDeductTransaction,
   ImageEditUsageTransaction,
@@ -10,7 +10,7 @@ import {
   RealtimeVoiceUsageTransaction,
   TextGenerationUsageTransaction,
   TransferCreditTransaction
-} from "./chunk-7Y3E4OY6.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/services/dist/src/creditService/subtractCredits.js
 import { z } from "zod";

package/dist/{chunk-TPWKBMIZ.js → chunk-YXHQN7SK.js}

@@ -7,11 +7,11 @@ import {
   getSettingsMap,
   getSettingsValue,
   secureParameters
-} from "./chunk-KH2C4VVX.js";
+} from "./chunk-DNSBC3LO.js";
 import {
   KnowledgeType,
   SupportedFabFileMimeTypes
-} from "./chunk-7Y3E4OY6.js";
+} from "./chunk-H6SHASMZ.js";
 
 // ../../b4m-core/packages/services/dist/src/fabFileService/create.js
 import { z } from "zod";

package/dist/{create-VQAEHGW2.js → create-PNU64QSF.js}

@@ -2,10 +2,10 @@
 import {
   createFabFile,
   createFabFileSchema
-} from "./chunk-TPWKBMIZ.js";
-import "./chunk-KH2C4VVX.js";
+} from "./chunk-YXHQN7SK.js";
+import "./chunk-DNSBC3LO.js";
 import "./chunk-AMDXHL6S.js";
-import "./chunk-7Y3E4OY6.js";
+import "./chunk-H6SHASMZ.js";
 import "./chunk-PDX44BCA.js";
 export {
   createFabFile,