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

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

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

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

@@ -311,9 +311,12 @@ var b4mLLMTools = z5.enum([
   "planet_visibility",
   // Knowledge base search
   "search_knowledge_base",
+  "retrieve_knowledge_content",
   // Quantum optimization tools
   "quantum_schedule",
-  "quantum_formulate"
+  "quantum_formulate",
+  // Navigation tool
+  "navigate_view"
 ]);
 var B4MLLMToolsList = b4mLLMTools.options.map((tool) => tool);
 var RechartsChartTypeSchema = z5.enum([
@@ -7816,6 +7819,592 @@ function serializeSSEEvent(event) {
 }
 var SSE_DONE_SIGNAL = "data: [DONE]\n\n";
 
+// ../../b4m-core/packages/common/dist/src/navigation/viewRegistry.js
+var VIEW_REGISTRY = [
+  // ── Opti (Optimization Canvasser) ──────────────────────────────────────
+  {
+    id: "opti.root",
+    section: "opti",
+    label: "Optimization Home",
+    description: "The Optimization Canvasser landing page showing all 8 pattern family cards",
+    navigationType: "route",
+    target: "/opti",
+    keywords: ["optimization", "canvasser", "home", "patterns", "families"]
+  },
+  {
+    id: "opti.scheduling",
+    section: "opti",
+    label: "Scheduling",
+    description: "Scheduling optimization: job-shop, flow-shop, shift scheduling, makespan minimization",
+    navigationType: "action",
+    target: "scheduling",
+    keywords: ["scheduling", "job-shop", "flow-shop", "shifts", "makespan", "gantt", "calendar"]
+  },
+  {
+    id: "opti.routing",
+    section: "opti",
+    label: "Routing",
+    description: "Vehicle routing, TSP, logistics, delivery routes, fleet management",
+    navigationType: "action",
+    target: "routing",
+    keywords: ["routing", "TSP", "vehicle", "logistics", "delivery", "fleet", "path"]
+  },
+  {
+    id: "opti.packing",
+    section: "opti",
+    label: "Packing",
+    description: "Bin packing, knapsack, container loading, space optimization",
+    navigationType: "action",
+    target: "packing",
+    keywords: ["packing", "bin", "knapsack", "container", "loading", "space"]
+  },
+  {
+    id: "opti.network",
+    section: "opti",
+    label: "Network Design",
+    description: "Network flow, facility location, supply chain network design",
+    navigationType: "action",
+    target: "network",
+    keywords: ["network", "flow", "facility", "location", "supply chain", "graph"]
+  },
+  {
+    id: "opti.selection",
+    section: "opti",
+    label: "Selection",
+    description: "Portfolio selection, feature selection, subset optimization",
+    navigationType: "action",
+    target: "selection",
+    keywords: ["selection", "portfolio", "feature", "subset", "pick", "choose"]
+  },
+  {
+    id: "opti.economic",
+    section: "opti",
+    label: "Economic",
+    description: "Resource allocation, pricing, budgeting, economic optimization",
+    navigationType: "action",
+    target: "economic",
+    keywords: ["economic", "resource", "allocation", "pricing", "budget", "cost"]
+  },
+  {
+    id: "opti.assignment",
+    section: "opti",
+    label: "Assignment",
+    description: "Task assignment, matching, workforce allocation, team formation",
+    navigationType: "action",
+    target: "assignment",
+    keywords: ["assignment", "matching", "workforce", "team", "allocate", "assign"]
+  },
+  {
+    id: "opti.partitioning",
+    section: "opti",
+    label: "Partitioning",
+    description: "Graph partitioning, clustering, load balancing, data partitioning",
+    navigationType: "action",
+    target: "partitioning",
+    keywords: ["partitioning", "clustering", "balancing", "partition", "divide", "split"]
+  },
+  // ── Admin ──────────────────────────────────────────────────────────────
+  {
+    id: "admin.users",
+    section: "admin",
+    label: "User Management",
+    description: "View and manage user accounts, roles, and permissions",
+    navigationType: "tab",
+    target: "0",
+    // AdminTab.Users
+    keywords: ["users", "accounts", "roles", "permissions", "manage users"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.credit_analytics",
+    section: "admin",
+    label: "Credit Analytics",
+    description: "View credit usage, add credits to users, billing analytics",
+    navigationType: "tab",
+    target: "15",
+    // AdminTab.CreditAnalytics
+    keywords: ["credits", "billing", "usage", "add credits", "balance", "cost"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.settings",
+    section: "admin",
+    label: "Admin Settings",
+    description: "System-wide administration settings and configuration",
+    navigationType: "tab",
+    target: "1",
+    // AdminTab.AdminSettings
+    keywords: ["settings", "configuration", "admin", "system settings"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.system_health",
+    section: "admin",
+    label: "System Health",
+    description: "Monitor system health, uptime, and performance metrics",
+    navigationType: "tab",
+    target: "29",
+    // AdminTab.SystemHealth
+    keywords: ["health", "uptime", "monitoring", "performance", "status"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.llm_dashboard",
+    section: "admin",
+    label: "LLM Dashboard",
+    description: "LLM model usage, costs, and performance monitoring",
+    navigationType: "tab",
+    target: "24",
+    // AdminTab.LLMDashboard
+    keywords: ["llm", "model", "ai", "costs", "tokens", "dashboard"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.tool_definitions",
+    section: "admin",
+    label: "Tool Definitions",
+    description: "Manage LLM tool definitions and configurations",
+    navigationType: "tab",
+    target: "31",
+    // AdminTab.ToolDefinitions
+    keywords: ["tools", "tool definitions", "functions", "capabilities"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.organizations",
+    section: "admin",
+    label: "Organizations",
+    description: "Manage organizations, teams, and multi-tenant settings",
+    navigationType: "tab",
+    target: "14",
+    // AdminTab.Organizations
+    keywords: ["organizations", "teams", "tenants", "companies"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.analytics",
+    section: "admin",
+    label: "Analytics",
+    description: "User activity analytics, engagement metrics, and reports",
+    navigationType: "tab",
+    target: "3",
+    // AdminTab.Analytics
+    keywords: ["analytics", "metrics", "reports", "engagement", "activity"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.subscribers",
+    section: "admin",
+    label: "Subscribers",
+    description: "Manage subscriber waitlist and access approvals",
+    navigationType: "tab",
+    target: "12",
+    // AdminTab.Subscribers
+    keywords: ["subscribers", "waitlist", "approvals", "signups"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.subscriptions",
+    section: "admin",
+    label: "Subscriptions",
+    description: "Manage subscription plans, tiers, and billing",
+    navigationType: "tab",
+    target: "13",
+    // AdminTab.Subscriptions
+    keywords: ["subscriptions", "plans", "tiers", "billing", "pricing"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.invite_codes",
+    section: "admin",
+    label: "Invite Codes",
+    description: "Create and manage registration invite codes",
+    navigationType: "tab",
+    target: "5",
+    // AdminTab.RegistrationInvites
+    keywords: ["invite", "codes", "registration", "invitations"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.agent_ops",
+    section: "admin",
+    label: "Agent Operations",
+    description: "Monitor and manage AI agent operations and tasks",
+    navigationType: "tab",
+    target: "23",
+    // AdminTab.AgentOps
+    keywords: ["agents", "operations", "tasks", "agent ops"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.security_dashboard",
+    section: "admin",
+    label: "Security Dashboard",
+    description: "Security monitoring, threat detection, and audit logs",
+    navigationType: "tab",
+    target: "26",
+    // AdminTab.SecurityDashboard
+    keywords: ["security", "threats", "audit", "logs", "vulnerabilities"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.system_prompts",
+    section: "admin",
+    label: "System Prompts",
+    description: "Edit and manage system prompts for AI models",
+    navigationType: "tab",
+    target: "21",
+    // AdminTab.SystemPrompts
+    keywords: ["prompts", "system prompts", "instructions", "AI prompts"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.modals",
+    section: "admin",
+    label: "Modals",
+    description: "Manage modal dialogs and popup configurations",
+    navigationType: "tab",
+    target: "7",
+    // AdminTab.Modals
+    keywords: ["modals", "dialogs", "popups", "announcements"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.whats_new",
+    section: "admin",
+    label: "What's New",
+    description: "Manage What's New release notes and changelogs",
+    navigationType: "tab",
+    target: "32",
+    // AdminTab.WhatsNewModals
+    keywords: ["whats new", "release notes", "changelog", "updates"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.rapid_reply",
+    section: "admin",
+    label: "Rapid Reply",
+    description: "Configure rapid reply templates and shortcuts",
+    navigationType: "tab",
+    target: "25",
+    // AdminTab.RapidReply
+    keywords: ["rapid reply", "templates", "shortcuts", "quick responses"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.slack_workspaces",
+    section: "admin",
+    label: "Slack Workspaces",
+    description: "Manage connected Slack workspace integrations",
+    navigationType: "tab",
+    target: "30",
+    // AdminTab.SlackWorkspaces
+    keywords: ["slack", "workspaces", "integrations", "messaging"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.secrets_rotation",
+    section: "admin",
+    label: "Secrets Rotation",
+    description: "Manage API key rotation and secret lifecycle",
+    navigationType: "tab",
+    target: "16",
+    // AdminTab.SecretsRotation
+    keywords: ["secrets", "rotation", "API keys", "credentials"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.bulk_import",
+    section: "admin",
+    label: "Bulk Import",
+    description: "Bulk import users and data from CSV or other formats",
+    navigationType: "tab",
+    target: "17",
+    // AdminTab.BulkImport
+    keywords: ["bulk", "import", "CSV", "migration", "data import"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.feedbacks",
+    section: "admin",
+    label: "Feedbacks",
+    description: "View and manage user feedback, bug reports, and feature requests",
+    navigationType: "tab",
+    target: "2",
+    // AdminTab.Feedbacks
+    keywords: ["feedback", "bug reports", "feature requests", "user feedback", "complaints"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.files",
+    section: "admin",
+    label: "Files",
+    description: "Manage uploaded files across all users, storage analytics",
+    navigationType: "tab",
+    target: "8",
+    // AdminTab.Files
+    keywords: ["files", "uploads", "storage", "documents", "file management"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.documentation",
+    section: "admin",
+    label: "Documentation",
+    description: "System documentation and internal reference guides",
+    navigationType: "tab",
+    target: "9",
+    // AdminTab.Documentation
+    keywords: ["documentation", "docs", "guides", "reference", "help docs"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.world_time",
+    section: "admin",
+    label: "World Time",
+    description: "View current time across multiple time zones",
+    navigationType: "tab",
+    target: "10",
+    // AdminTab.WorldTime
+    keywords: ["world time", "time zones", "clocks", "UTC", "international time"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.model_logs",
+    section: "admin",
+    label: "Model Logs",
+    description: "View LLM model request/response logs and debugging information",
+    navigationType: "tab",
+    target: "18",
+    // AdminTab.ModelLogs
+    keywords: ["model logs", "LLM logs", "request logs", "debugging", "API logs"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.model_metrics",
+    section: "admin",
+    label: "Model Metrics",
+    description: "LLM model performance metrics, latency, and usage statistics",
+    navigationType: "tab",
+    target: "19",
+    // AdminTab.ModelMetrics
+    keywords: ["model metrics", "performance", "latency", "tokens", "model usage"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.event_metrics",
+    section: "admin",
+    label: "Event Metrics",
+    description: "Track system events, user activity events, and event analytics",
+    navigationType: "tab",
+    target: "20",
+    // AdminTab.EventMetrics
+    keywords: ["event metrics", "events", "activity tracking", "event analytics"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.identity_providers",
+    section: "admin",
+    label: "Identity Providers",
+    description: "Configure SSO, SAML, and identity provider integrations",
+    navigationType: "tab",
+    target: "22",
+    // AdminTab.IdentityProviders
+    keywords: ["identity", "SSO", "SAML", "providers", "authentication", "login providers"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.email_verification",
+    section: "admin",
+    label: "Email Verification",
+    description: "Manage email verification status and send verification emails",
+    navigationType: "tab",
+    target: "27",
+    // AdminTab.EmailVerification
+    keywords: ["email", "verification", "verify email", "email status"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.team",
+    section: "admin",
+    label: "Team",
+    description: "Manage team members, roles, and team settings",
+    navigationType: "tab",
+    target: "28",
+    // AdminTab.Team
+    keywords: ["team", "members", "roles", "team management", "staff"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.slack_metrics",
+    section: "admin",
+    label: "Slack Metrics",
+    description: "Slack integration usage metrics and message analytics",
+    navigationType: "tab",
+    target: "33",
+    // AdminTab.SlackMetrics
+    keywords: ["slack metrics", "slack usage", "message analytics", "slack stats"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.system_secrets",
+    section: "admin",
+    label: "System Secrets",
+    description: "View and manage system-level secrets and environment variables",
+    navigationType: "tab",
+    target: "34",
+    // AdminTab.SystemSecrets
+    keywords: ["system secrets", "environment variables", "env vars", "secrets", "configuration"],
+    requiresAdmin: true
+  },
+  {
+    id: "admin.liveops_triage",
+    section: "admin",
+    label: "LiveOps Triage",
+    description: "Real-time error triage, production issue monitoring, and incident response",
+    navigationType: "tab",
+    target: "35",
+    // AdminTab.LiveOpsTriage
+    keywords: ["liveops", "triage", "errors", "incidents", "production issues", "monitoring"],
+    requiresAdmin: true
+  },
+  // ── Global ─────────────────────────────────────────────────────────────
+  {
+    id: "global.chat",
+    section: "global",
+    label: "Chat",
+    description: "Main AI chat interface for conversations",
+    navigationType: "route",
+    target: "/",
+    keywords: ["chat", "conversation", "talk", "message", "ask"]
+  },
+  {
+    id: "global.projects",
+    section: "global",
+    label: "Projects",
+    description: "View and manage projects and workspaces",
+    navigationType: "route",
+    target: "/projects",
+    keywords: ["projects", "workspaces", "organize", "folders"]
+  },
+  {
+    id: "global.agents",
+    section: "global",
+    label: "Agents",
+    description: "Browse and configure AI agents",
+    navigationType: "route",
+    target: "/agents",
+    keywords: ["agents", "AI assistants", "bots", "configure agents"]
+  },
+  {
+    id: "global.profile",
+    section: "global",
+    label: "Profile",
+    description: "User profile settings and preferences",
+    navigationType: "route",
+    target: "/profile",
+    keywords: ["profile", "account", "preferences", "personal settings"]
+  },
+  {
+    id: "global.profile_security",
+    section: "global",
+    label: "Security Settings",
+    description: "MFA, password, and security settings for your account",
+    navigationType: "route",
+    target: "/profile/security",
+    keywords: ["security", "MFA", "password", "two-factor", "2FA"]
+  },
+  {
+    id: "global.profile_api_keys",
+    section: "global",
+    label: "API Keys",
+    description: "Manage your personal API keys for integrations",
+    navigationType: "route",
+    target: "/profile/api-keys",
+    keywords: ["API keys", "tokens", "integrations", "developer"]
+  },
+  {
+    id: "global.admin",
+    section: "global",
+    label: "Admin Panel",
+    description: "Admin dashboard for system management",
+    navigationType: "route",
+    target: "/admin",
+    keywords: ["admin", "dashboard", "management", "administration"],
+    requiresAdmin: true
+  },
+  {
+    id: "global.help",
+    section: "global",
+    label: "Help",
+    description: "Help documentation and support resources",
+    navigationType: "route",
+    target: "/help",
+    keywords: ["help", "support", "documentation", "FAQ", "guide"]
+  },
+  {
+    id: "global.knowledge_base",
+    section: "global",
+    label: "Knowledge Base",
+    description: "Browse uploaded files and documents in your knowledge base",
+    navigationType: "route",
+    target: "/knowledge",
+    keywords: ["knowledge", "files", "documents", "uploads", "library"]
+  },
+  {
+    id: "global.settings",
+    section: "global",
+    label: "Settings",
+    description: "Application settings and preferences",
+    navigationType: "route",
+    target: "/settings",
+    keywords: ["settings", "preferences", "configuration", "options"]
+  }
+];
+function getViewById(viewId) {
+  return VIEW_REGISTRY.find((v) => v.id === viewId);
+}
+function getFilteredViews(options) {
+  return VIEW_REGISTRY.filter((v) => {
+    if (options?.section && v.section !== options.section)
+      return false;
+    if (v.requiresAdmin && !options?.isAdmin)
+      return false;
+    return true;
+  });
+}
+function getViewSummaryForLLM(options) {
+  const views = getFilteredViews(options);
+  const grouped = {};
+  for (const v of views) {
+    const key = v.section.toUpperCase();
+    if (!grouped[key])
+      grouped[key] = [];
+    grouped[key].push(`- ${v.id}: ${v.label} \u2014 ${v.description}`);
+  }
+  const sections = Object.entries(grouped).map(([section, lines]) => `[${section}]
+${lines.join("\n")}`).join("\n\n");
+  return `Available navigation views (use navigate_view tool to suggest these):
+
+${sections}`;
+}
+function resolveNavigationIntents(suggestions, isAdmin) {
+  return suggestions.map((s) => {
+    const view = getViewById(s.viewId);
+    if (!view)
+      return null;
+    if (view.requiresAdmin && !isAdmin)
+      return null;
+    return {
+      viewId: view.id,
+      label: view.label,
+      description: view.description,
+      navigationType: view.navigationType,
+      target: view.target,
+      reason: s.reason
+    };
+  }).filter((intent) => intent !== null);
+}
+
 // ../../b4m-core/packages/common/dist/src/utils/dayjsConfig.js
 import dayjs from "dayjs";
 import timezone from "dayjs/plugin/timezone.js";
@@ -8168,5 +8757,10 @@ export {
   formatSSEError,
   serializeSSEEvent,
   SSE_DONE_SIGNAL,
+  VIEW_REGISTRY,
+  getViewById,
+  getFilteredViews,
+  getViewSummaryForLLM,
+  resolveNavigationIntents,
   dayjsConfig_default
 };

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

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

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

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

package/dist/{chunk-KE4B2ZGF.js → chunk-SZ243CHW.js}

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

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

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

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

@@ -2,9 +2,9 @@
 import {
   createFabFile,
   createFabFileSchema
-} from "./chunk-MXMR4O3A.js";
-import "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-PY7XRQ25.js";
+import "./chunk-LNXAJTXS.js";
+import "./chunk-KWFQVBM5.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-TAEL5CAS.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-SZ243CHW.js";
+import "./chunk-PY7XRQ25.js";
 import {
   BFLImageService,
   BaseStorage,
@@ -27,7 +27,7 @@ import {
   OpenAIBackend,
   OpenAIImageService,
   XAIImageService
-} from "./chunk-ZFLZILSJ.js";
+} from "./chunk-LNXAJTXS.js";
 import {
   AiEvents,
   ApiKeyEvents,
@@ -82,8 +82,10 @@ import {
   VideoModels,
   XAI_IMAGE_MODELS,
   b4mLLMTools,
-  getMcpProviderMetadata
-} from "./chunk-ONMTYHC2.js";
+  getMcpProviderMetadata,
+  getViewById,
+  resolveNavigationIntents
+} from "./chunk-KWFQVBM5.js";
 import {
   Logger
 } from "./chunk-OCYRD7D6.js";
@@ -9664,13 +9666,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 +9746,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({
@@ -10798,6 +10914,67 @@ Examples:
   })
 };
 
+// ../../b4m-core/packages/services/dist/src/llm/tools/implementation/navigateView/index.js
+var navigateViewTool = {
+  name: "navigate_view",
+  implementation: (context) => ({
+    toolFn: async (value) => {
+      const params = value;
+      const { suggestions } = params;
+      context.logger.log("\u{1F9ED} navigate_view: Received suggestions:", JSON.stringify(suggestions));
+      if (!suggestions || !Array.isArray(suggestions) || suggestions.length === 0) {
+        return "No navigation suggestions provided.";
+      }
+      const capped = suggestions.slice(0, 3);
+      const invalid = capped.filter((s) => !getViewById(s.viewId));
+      if (invalid.length > 0) {
+        context.logger.log("\u{1F9ED} navigate_view: Unknown viewIds:", invalid.map((s) => s.viewId));
+      }
+      const isAdmin = context.user?.isAdmin === true;
+      const intents = resolveNavigationIntents(capped, isAdmin);
+      if (intents.length === 0) {
+        return "No valid navigation views matched the provided viewIds.";
+      }
+      context.logger.log("\u{1F9ED} navigate_view: Resolved intents:", intents.map((i) => i.viewId));
+      return JSON.stringify({
+        __navigationIntents: true,
+        intents,
+        message: `Suggested ${intents.length} navigation option(s): ${intents.map((i) => i.label).join(", ")}`
+      });
+    },
+    toolSchema: {
+      name: "navigate_view",
+      description: "Suggest navigation to relevant app views based on the conversation context. Returns inline action buttons the user can click to navigate. Use when the user asks about a topic that has a dedicated view, or when showing them where to go would be helpful. Do NOT use for every response \u2014 only when navigation adds value.",
+      parameters: {
+        type: "object",
+        properties: {
+          suggestions: {
+            type: "array",
+            description: "Navigation suggestions (1-3 items). Each suggests a view the user might want to visit.",
+            items: {
+              type: "object",
+              properties: {
+                viewId: {
+                  type: "string",
+                  description: 'The view ID from the available views list (e.g., "opti.scheduling", "admin.users")'
+                },
+                reason: {
+                  type: "string",
+                  description: "Brief reason why this view is relevant (max 80 chars, shown as tooltip)"
+                }
+              },
+              required: ["viewId", "reason"]
+            },
+            maxItems: 3,
+            minItems: 1
+          }
+        },
+        required: ["suggestions"]
+      }
+    }
+  })
+};
+
 // ../../b4m-core/packages/services/dist/src/llm/tools/implementation/bashExecute/index.js
 import { spawn } from "child_process";
 import path11 from "path";
@@ -11630,11 +11807,14 @@ 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
+  quantum_formulate: quantumFormulateTool,
+  // Navigation tool
+  navigate_view: navigateViewTool
 };
 var cliOnlyTools = {
   // File operation tools
@@ -14620,7 +14800,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.18870+b55c38ee4",
   type: "module",
   description: "Interactive CLI tool for Bike4Mind with ReAct agents",
   license: "UNLICENSED",
@@ -14730,10 +14910,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.18870+b55c38ee4",
+    "@bike4mind/mcp": "1.29.1-feat-quantum-optimize-architecture.18870+b55c38ee4",
+    "@bike4mind/services": "2.48.1-feat-quantum-optimize-architecture.18870+b55c38ee4",
+    "@bike4mind/utils": "2.5.1-feat-quantum-optimize-architecture.18870+b55c38ee4",
     "@types/better-sqlite3": "^7.6.13",
     "@types/diff": "^5.0.9",
     "@types/jsonwebtoken": "^9.0.4",
@@ -14750,7 +14930,7 @@ var package_default = {
   optionalDependencies: {
     "@vscode/ripgrep": "^1.17.0"
   },
-  gitHead: "86fb26d20672d55c847e46af21d02899d08329ca"
+  gitHead: "b55c38ee4eeb208483b2c6dec5a6a78cdf2cda37"
 };
 
 // src/config/constants.ts

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

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

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

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

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

@@ -2,9 +2,9 @@
 import {
   findMostSimilarMemento,
   getRelevantMementos
-} from "./chunk-O5LNKJED.js";
-import "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-TAEL5CAS.js";
+import "./chunk-LNXAJTXS.js";
+import "./chunk-KWFQVBM5.js";
 import "./chunk-OCYRD7D6.js";
 export {
   findMostSimilarMemento,

package/dist/{src-XL5LD7DM.js → src-5WN7WYJ3.js}

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

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

@@ -236,6 +236,7 @@ import {
   VALID_USER_TAGS,
   VIDEO_MODELS,
   VIDEO_SIZE_CONSTRAINTS,
+  VIEW_REGISTRY,
   VideoGenerationUsageTransaction,
   VideoModels,
   VisibilitySchema,
@@ -290,9 +291,12 @@ import {
   getAtlassianConfig,
   getErrorMessage,
   getFileTypeEmoji,
+  getFilteredViews,
   getMcpProviderMetadata,
   getPredefinedTags,
   getTextModelCost,
+  getViewById,
+  getViewSummaryForLLM,
   getVisibilityLevel,
   getWebsiteUrl,
   groupShareSchema,
@@ -312,6 +316,7 @@ import {
   mergeArtifactMetadata,
   parallelLimit,
   passwordSchema,
+  resolveNavigationIntents,
   safeParseQuest,
   safeParseQuestMasterArtifactV2,
   searchSchema,
@@ -340,7 +345,7 @@ import {
   validateReactArtifactV2,
   validateSvgArtifactV2,
   wikiMarkupToAdf
-} from "./chunk-ONMTYHC2.js";
+} from "./chunk-KWFQVBM5.js";
 export {
   ALL_IMAGE_MODELS,
   ALL_IMAGE_SIZES,
@@ -579,6 +584,7 @@ export {
   VALID_USER_TAGS,
   VIDEO_MODELS,
   VIDEO_SIZE_CONSTRAINTS,
+  VIEW_REGISTRY,
   VideoGenerationUsageTransaction,
   VideoModels,
   VisibilitySchema,
@@ -634,9 +640,12 @@ export {
   getAtlassianConfig,
   getErrorMessage,
   getFileTypeEmoji,
+  getFilteredViews,
   getMcpProviderMetadata,
   getPredefinedTags,
   getTextModelCost,
+  getViewById,
+  getViewSummaryForLLM,
   getVisibilityLevel,
   getWebsiteUrl,
   groupShareSchema,
@@ -656,6 +665,7 @@ export {
   mergeArtifactMetadata,
   parallelLimit,
   passwordSchema,
+  resolveNavigationIntents,
   safeParseQuest,
   safeParseQuestMasterArtifactV2,
   searchSchema,

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

@@ -2,9 +2,9 @@
 import {
   SubtractCreditsSchema,
   subtractCredits
-} from "./chunk-KE4B2ZGF.js";
-import "./chunk-ZFLZILSJ.js";
-import "./chunk-ONMTYHC2.js";
+} from "./chunk-SZ243CHW.js";
+import "./chunk-LNXAJTXS.js";
+import "./chunk-KWFQVBM5.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.18870+b55c38ee4",
   "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.18870+b55c38ee4",
+    "@bike4mind/mcp": "1.29.1-feat-quantum-optimize-architecture.18870+b55c38ee4",
+    "@bike4mind/services": "2.48.1-feat-quantum-optimize-architecture.18870+b55c38ee4",
+    "@bike4mind/utils": "2.5.1-feat-quantum-optimize-architecture.18870+b55c38ee4",
     "@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": "b55c38ee4eeb208483b2c6dec5a6a78cdf2cda37"
 }