@bike4mind/cli 0.2.29-feat-quantum-optimize-architecture.18865 → 0.2.29-feat-quantum-optimize-architecture.18869

package/dist/{artifactExtractor-YXCWF7C7.js → artifactExtractor-IYOLLKMT.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/artifactExtractor.js
 var ARTIFACT_TAG_REGEX = /<artifact\s+(.*?)>([\s\S]*?)<\/artifact>/gi;

package/dist/{chunk-KE4B2ZGF.js → chunk-37LP5TEX.js}

@@ -2,7 +2,7 @@
 import {
   BadRequestError,
   secureParameters
-} from "./chunk-ZFLZILSJ.js";
+} from "./chunk-XOFV7PRQ.js";
 import {
   CompletionApiUsageTransaction,
   GenericCreditDeductTransaction,
@@ -12,7 +12,7 @@ import {
   TextGenerationUsageTransaction,
   TransferCreditTransaction,
   VideoGenerationUsageTransaction
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 
 // ../../b4m-core/packages/services/dist/src/creditService/subtractCredits.js
 import { z } from "zod";

package/dist/{chunk-ONMTYHC2.js → chunk-DYLBOIMW.js}

@@ -311,6 +311,7 @@ var b4mLLMTools = z5.enum([
   "planet_visibility",
   // Knowledge base search
   "search_knowledge_base",
+  "retrieve_knowledge_content",
   // Quantum optimization tools
   "quantum_schedule",
   "quantum_formulate"

package/dist/{chunk-O5LNKJED.js → chunk-EAPDBTJW.js}

@@ -6,12 +6,12 @@ import {
   getSettingsByNames,
   obfuscateApiKey,
   secureParameters
-} from "./chunk-ZFLZILSJ.js";
+} from "./chunk-XOFV7PRQ.js";
 import {
   ApiKeyType,
   MementoTier,
   isSupportedEmbeddingModel
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 
 // ../../b4m-core/packages/services/dist/src/apiKeyService/get.js
 import { z } from "zod";

package/dist/{chunk-MXMR4O3A.js → chunk-RAFO24PB.js}

@@ -7,11 +7,11 @@ import {
   getSettingsMap,
   getSettingsValue,
   secureParameters
-} from "./chunk-ZFLZILSJ.js";
+} from "./chunk-XOFV7PRQ.js";
 import {
   KnowledgeType,
   SupportedFabFileMimeTypes
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 
 // ../../b4m-core/packages/services/dist/src/fabFileService/create.js
 import { z } from "zod";

package/dist/{chunk-ZFLZILSJ.js → chunk-XOFV7PRQ.js}

@@ -15,7 +15,7 @@ import {
   dayjsConfig_default,
   extractSnippetMeta,
   settingsMap
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 import {
   Logger
 } from "./chunk-OCYRD7D6.js";

package/dist/{create-2UZMTRWL.js → create-6W6R35C3.js}

@@ -2,9 +2,9 @@
 import {
   createFabFile,
   createFabFileSchema
-} from "./chunk-MXMR4O3A.js";
-import "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-RAFO24PB.js";
+import "./chunk-XOFV7PRQ.js";
+import "./chunk-DYLBOIMW.js";
 import "./chunk-OCYRD7D6.js";
 export {
   createFabFile,

package/dist/index.js

@@ -5,7 +5,7 @@ import {
   getEffectiveApiKey,
   getOpenWeatherKey,
   getSerperKey
-} from "./chunk-O5LNKJED.js";
+} from "./chunk-EAPDBTJW.js";
 import {
   ConfigStore,
   logger
@@ -14,8 +14,8 @@ import {
   selectActiveBackgroundAgents,
   useCliStore
 } from "./chunk-TVW4ZESU.js";
-import "./chunk-KE4B2ZGF.js";
-import "./chunk-MXMR4O3A.js";
+import "./chunk-37LP5TEX.js";
+import "./chunk-RAFO24PB.js";
 import {
   BFLImageService,
   BaseStorage,
@@ -27,7 +27,7 @@ import {
   OpenAIBackend,
   OpenAIImageService,
   XAIImageService
-} from "./chunk-ZFLZILSJ.js";
+} from "./chunk-XOFV7PRQ.js";
 import {
   AiEvents,
   ApiKeyEvents,
@@ -83,7 +83,7 @@ import {
   XAI_IMAGE_MODELS,
   b4mLLMTools,
   getMcpProviderMetadata
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 import {
   Logger
 } from "./chunk-OCYRD7D6.js";
@@ -9664,13 +9664,13 @@ function formatSearchResults(files) {
     const notes = file.notes ? `
    Notes: ${file.notes}` : "";
     const fileType = file.type || "FILE";
-    return `${index + 1}. **${file.fileName}**
+    return `${index + 1}. **${file.fileName}** (ID: ${file.id})
    Type: ${fileType} | MIME: ${file.mimeType}
    Tags: ${tags}${notes}`;
   });
   return `Found ${files.length} document(s) in your knowledge base:
 
-` + formattedFiles.join("\n\n") + "\n\n*To use these documents in your conversation, you can ask me to reference specific files by name.*";
+` + formattedFiles.join("\n\n") + "\n\n*Use retrieve_knowledge_content with a file ID or tags to read the actual document content.*";
 }
 var knowledgeBaseSearchTool = {
   name: "search_knowledge_base",
@@ -9744,6 +9744,120 @@ var knowledgeBaseSearchTool = {
   })
 };
 
+// ../../b4m-core/packages/services/dist/src/llm/tools/implementation/knowledgeBaseRetrieve/index.js
+var DEFAULT_MAX_CHARS = 8e3;
+var ABSOLUTE_MAX_CHARS = 16e3;
+var knowledgeBaseRetrieveTool = {
+  name: "retrieve_knowledge_content",
+  implementation: (context) => ({
+    toolFn: async (value) => {
+      const params = value;
+      const { file_id, tags, query, max_chars } = params;
+      const charBudget = Math.min(max_chars ?? DEFAULT_MAX_CHARS, ABSOLUTE_MAX_CHARS);
+      context.logger.log("\u{1F4D6} Knowledge Retrieve: params", { file_id, tags, query, max_chars: charBudget });
+      if (!file_id && !tags?.length && !query) {
+        return "Error: You must provide at least one of file_id, tags, or query.";
+      }
+      if (!context.db.fabfiles) {
+        context.logger.error("\u274C Knowledge Retrieve: fabfiles repository not available");
+        return "Knowledge base retrieval is not available at this time.";
+      }
+      if (!context.db.fabfilechunks) {
+        context.logger.error("\u274C Knowledge Retrieve: fabfilechunks repository not available");
+        return "Knowledge base retrieval is not available at this time (chunk reader unavailable).";
+      }
+      try {
+        let files = [];
+        if (file_id) {
+          const file = await context.db.fabfiles.findByIdAndUserId(file_id, context.userId);
+          if (file) {
+            files = [file];
+          } else {
+            const searchResults = await context.db.fabfiles.search(context.userId, file_id, { tags: [], shared: false }, { page: 1, limit: 1 }, { by: "fileName", direction: "asc" }, { textSearch: true, includeShared: true, userGroups: context.user.groups || [] });
+            files = searchResults.data;
+          }
+          if (files.length === 0) {
+            return `No document found with ID "${file_id}". The file may not exist or you may not have access to it. Try using search_knowledge_base to find the correct file ID.`;
+          }
+        }
+        if (files.length === 0 && (tags?.length || query)) {
+          const searchResults = await context.db.fabfiles.search(context.userId, query || "", { tags: tags || [], shared: false }, { page: 1, limit: 5 }, { by: "fileName", direction: "asc" }, { textSearch: true, includeShared: true, userGroups: context.user.groups || [] });
+          files = searchResults.data;
+          if (files.length === 0) {
+            const searchDesc = [
+              query && `query "${query}"`,
+              tags?.length && `tags [${tags.join(", ")}]`
+            ].filter(Boolean).join(" and ");
+            return `No documents found matching ${searchDesc}. Try broadening your search with search_knowledge_base.`;
+          }
+        }
+        let totalCharsUsed = 0;
+        const sections = [];
+        let filesRetrieved = 0;
+        for (const file of files) {
+          if (totalCharsUsed >= charBudget)
+            break;
+          const chunks = await context.db.fabfilechunks.findByFabFileId(file.id);
+          if (chunks.length === 0) {
+            context.logger.log(`\u{1F4D6} Knowledge Retrieve: No chunks for file ${file.fileName} (${file.id})`);
+            continue;
+          }
+          const fullText = chunks.map((c) => c.text).join("\n");
+          const remainingBudget = charBudget - totalCharsUsed;
+          const truncated = fullText.length > remainingBudget;
+          const content = truncated ? fullText.slice(0, remainingBudget) : fullText;
+          const fileTags = file.tags?.map((t) => t.name).join(", ") || "none";
+          const charLabel = truncated ? `${content.length} (truncated from ${fullText.length})` : `${content.length}`;
+          sections.push(`### ${file.fileName} (ID: ${file.id})
+Tags: ${fileTags}
+Chunks: ${chunks.length} | Characters: ${charLabel}
+---
+` + content);
+          totalCharsUsed += content.length;
+          filesRetrieved++;
+        }
+        if (filesRetrieved === 0) {
+          return "Found matching documents but they have no indexed content. The files may not have been processed yet.";
+        }
+        const header = `Retrieved content from ${filesRetrieved} of ${files.length} document(s):
+`;
+        return header + "\n" + sections.join("\n\n---\n\n");
+      } catch (error) {
+        context.logger.error("\u274C Knowledge Retrieve: Error during retrieval:", error);
+        return "An error occurred while retrieving document content. Please try again.";
+      }
+    },
+    toolSchema: {
+      name: "retrieve_knowledge_content",
+      description: "Read the actual text content of knowledge base documents. Use this after search_knowledge_base to read documents by file ID, or provide tags/query to find and read documents in one step. Returns the full text content (up to the character budget) for grounding your responses in the user's curated knowledge.",
+      parameters: {
+        type: "object",
+        properties: {
+          file_id: {
+            type: "string",
+            description: "The file ID to retrieve (from search_knowledge_base results). Most efficient for single-document retrieval."
+          },
+          tags: {
+            type: "array",
+            items: { type: "string" },
+            description: 'Filter documents by tags. For optimization docs, use tags like "opti:family:scheduling", "opti:solver:highs", etc.'
+          },
+          query: {
+            type: "string",
+            description: "Search query to find documents. Can be combined with tags for more targeted retrieval."
+          },
+          max_chars: {
+            type: "number",
+            description: "Maximum characters of content to return (default: 8000, max: 16000). Lower values for quick lookups, higher for detailed reading.",
+            minimum: 500,
+            maximum: 16e3
+          }
+        }
+      }
+    }
+  })
+};
+
 // ../../b4m-core/packages/quantum/dist/src/types.js
 import { z as z139 } from "zod";
 var OperationSchema = z139.object({
@@ -11630,8 +11744,9 @@ var b4mTools = {
   sunrise_sunset: sunriseSunsetTool,
   iss_tracker: issTrackerTool,
   planet_visibility: planetVisibilityTool,
-  // Knowledge base search
+  // Knowledge base tools
   search_knowledge_base: knowledgeBaseSearchTool,
+  retrieve_knowledge_content: knowledgeBaseRetrieveTool,
   // Quantum optimization tools
   quantum_schedule: quantumScheduleTool,
   quantum_formulate: quantumFormulateTool
@@ -14620,7 +14735,7 @@ import { isAxiosError as isAxiosError2 } from "axios";
 // package.json
 var package_default = {
   name: "@bike4mind/cli",
-  version: "0.2.29-feat-quantum-optimize-architecture.18865+86fb26d20",
+  version: "0.2.29-feat-quantum-optimize-architecture.18869+3e839a2c8",
   type: "module",
   description: "Interactive CLI tool for Bike4Mind with ReAct agents",
   license: "UNLICENSED",
@@ -14730,10 +14845,10 @@ var package_default = {
   },
   devDependencies: {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.50.1-feat-quantum-optimize-architecture.18865+86fb26d20",
-    "@bike4mind/mcp": "1.29.1-feat-quantum-optimize-architecture.18865+86fb26d20",
-    "@bike4mind/services": "2.48.1-feat-quantum-optimize-architecture.18865+86fb26d20",
-    "@bike4mind/utils": "2.5.1-feat-quantum-optimize-architecture.18865+86fb26d20",
+    "@bike4mind/common": "2.50.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
+    "@bike4mind/mcp": "1.29.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
+    "@bike4mind/services": "2.48.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
+    "@bike4mind/utils": "2.5.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -14750,7 +14865,7 @@ var package_default = {
   optionalDependencies: {
     "@vscode/ripgrep": "^1.17.0"
   },
-  gitHead: "86fb26d20672d55c847e46af21d02899d08329ca"
+  gitHead: "3e839a2c8a21d5d1c2682e9bdb97dff3fbaaff4e"
 };
 
 // src/config/constants.ts

package/dist/{llmMarkdownGenerator-DZSVGJTA.js → llmMarkdownGenerator-A3CINLZN.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/llmMarkdownGenerator.js
 var DEFAULT_OPTIONS = {

package/dist/{markdownGenerator-JQGXHXXU.js → markdownGenerator-OKTMUYNY.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CurationArtifactType
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 
 // ../../b4m-core/packages/services/dist/src/notebookCurationService/markdownGenerator.js
 var DEFAULT_OPTIONS = {

package/dist/{mementoService-CX3ID5C7.js → mementoService-QAP4FVAF.js}

@@ -2,9 +2,9 @@
 import {
   findMostSimilarMemento,
   getRelevantMementos
-} from "./chunk-O5LNKJED.js";
-import "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-EAPDBTJW.js";
+import "./chunk-XOFV7PRQ.js";
+import "./chunk-DYLBOIMW.js";
 import "./chunk-OCYRD7D6.js";
 export {
   findMostSimilarMemento,

package/dist/{src-XL5LD7DM.js → src-XDUIA23H.js}

@@ -134,8 +134,8 @@ import {
   validateMermaidSyntax,
   warmUpSettingsCache,
   withRetry
-} from "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-XOFV7PRQ.js";
+import "./chunk-DYLBOIMW.js";
 import {
   Logger,
   NotificationDeduplicator,

package/dist/{src-IRF6HQ4C.js → src-ZK4FDRJT.js}

@@ -340,7 +340,7 @@ import {
   validateReactArtifactV2,
   validateSvgArtifactV2,
   wikiMarkupToAdf
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-DYLBOIMW.js";
 export {
   ALL_IMAGE_MODELS,
   ALL_IMAGE_SIZES,

package/dist/{subtractCredits-SEKKZNZI.js → subtractCredits-F4ERHRDC.js}

@@ -2,9 +2,9 @@
 import {
   SubtractCreditsSchema,
   subtractCredits
-} from "./chunk-KE4B2ZGF.js";
-import "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-37LP5TEX.js";
+import "./chunk-XOFV7PRQ.js";
+import "./chunk-DYLBOIMW.js";
 import "./chunk-OCYRD7D6.js";
 export {
   SubtractCreditsSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bike4mind/cli",
-  "version": "0.2.29-feat-quantum-optimize-architecture.18865+86fb26d20",
+  "version": "0.2.29-feat-quantum-optimize-architecture.18869+3e839a2c8",
   "type": "module",
   "description": "Interactive CLI tool for Bike4Mind with ReAct agents",
   "license": "UNLICENSED",
@@ -110,10 +110,10 @@
   },
   "devDependencies": {
     "@bike4mind/agents": "0.1.0",
-    "@bike4mind/common": "2.50.1-feat-quantum-optimize-architecture.18865+86fb26d20",
-    "@bike4mind/mcp": "1.29.1-feat-quantum-optimize-architecture.18865+86fb26d20",
-    "@bike4mind/services": "2.48.1-feat-quantum-optimize-architecture.18865+86fb26d20",
-    "@bike4mind/utils": "2.5.1-feat-quantum-optimize-architecture.18865+86fb26d20",
+    "@bike4mind/common": "2.50.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
+    "@bike4mind/mcp": "1.29.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
+    "@bike4mind/services": "2.48.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
+    "@bike4mind/utils": "2.5.1-feat-quantum-optimize-architecture.18869+3e839a2c8",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -130,5 +130,5 @@
   "optionalDependencies": {
     "@vscode/ripgrep": "^1.17.0"
   },
-  "gitHead": "86fb26d20672d55c847e46af21d02899d08329ca"
+  "gitHead": "3e839a2c8a21d5d1c2682e9bdb97dff3fbaaff4e"
 }