map_network

Instructions

Implementation Reference

• packages/core/src/mcp/opencore-tools.ts:171-175 (handler)

  Primary handler (OpenCore MCP): retrieves the module store index and returns it as JSON. This is the most minimal handler – it just delegates to store.getIndex().

  const handleMapNetwork: McpToolHandler = async (_args, ctx) => {
    const store = getModuleStore(ctx);
    const idx = await store.getIndex();
    return okJson(idx);
  };

• packages/knowledge/src/tools/registry.ts:363-385 (handler)

  Secondary handler (ToolRegistry): browses knowledge network by category. Supports optional domain filter. If domain given, returns modules in that category; otherwise returns all categories with module counts.

  private async handleMapNetwork(args: Record<string, unknown>): Promise<ToolResult> {
    const domain = args.domain as string | undefined;
    const index = await this.store.getIndex();
  
    if (domain) {
      const count = index.categories[domain] ?? 0;
      if (count === 0) {
        return this.textResult(`No modules found in category "${domain}".`);
      }
      const modules = await this.store.getByCategory(domain);
      const list = modules.map((m) => `- **${m.name}** — ${m.description?.slice(0, 80) || ""}`).join("\n");
      return this.textResult(`**${domain}** (${count} modules):\n\n${list}`);
    }
  
    const categories = Object.entries(index.categories)
      .sort(([, a], [, b]) => b - a)
      .map(([cat, count]) => `- **${cat}**: ${count} modules`)
      .join("\n");
  
    return this.textResult(
      `**Celiums Knowledge Network** — ${index.totalModules.toLocaleString()} modules\n\n${categories}`
    );
  }

• packages/knowledge/src/tools/registry.ts:96-107 (schema)

  Registration and schema for map_network in ToolRegistry (knowledge package). Takes optional 'domain' string parameter.

  this.register({
    name: "map_network",
    description: "Browse all available modules organized by category. Discover what knowledge domains are available.",
    inputSchema: {
      type: "object",
      properties: {
        domain: { type: "string", description: "Filter by specific domain/category (optional)" },
      },
    },
    requiresInference: false,
    category: "discovery",
  }, this.handleMapNetwork.bind(this));

• packages/core/src/mcp/opencore-tools.ts:328-336 (registration)

  Registration and schema for map_network in the OpenCore MCP tools array. No input parameters required; returns full network overview as JSON.

  {
    group: 'opencore',
    definition: {
      name: 'map_network',
      description: 'Browse the entire Celiums knowledge network organized by category. Returns all categories with module counts, top modules per category, and total statistics. Use to explore what knowledge is available, discover categories, or get an overview of the knowledge base. Behavior: queries the module index, groups by category, returns a structured map with counts. No parameters needed — returns the full network overview.',
      inputSchema: { type: 'object', properties: {} },
    },
    handler: handleMapNetwork,
  },

• packages/dashboard/src/lib/server/engine.ts:170-172 (helper)

  Dashboard server-side helper that calls the map_network MCP tool via mcpCall, optionally passing a category filter.

  export async function mapNetwork(category?: string) {
    return mcpCall('map_network', category ? { category } : {});
  }