the-citadel 0.4.4 → 0.4.5

package/dist/config/schema.d.ts

@@ -25,6 +25,7 @@ export declare const ConfigSchema: z.ZodObject<{
             }>;
             model: z.ZodString;
             mcpTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mcpResources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         worker: z.ZodObject<{
             provider: z.ZodEnum<{
@@ -34,6 +35,7 @@ export declare const ConfigSchema: z.ZodObject<{
             }>;
             model: z.ZodString;
             mcpTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mcpResources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
         gatekeeper: z.ZodObject<{
             provider: z.ZodEnum<{
@@ -43,6 +45,7 @@ export declare const ConfigSchema: z.ZodObject<{
             }>;
             model: z.ZodString;
             mcpTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mcpResources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
         }, z.core.$strip>;
     }, z.core.$strip>;
     mcpServers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{

package/dist/core/formula.d.ts

@@ -27,6 +27,7 @@ export declare const FormulaSchema: z.ZodObject<{
         default: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
     prompts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    mcp_resources: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
     steps: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         title: z.ZodString;

package/dist/core/mcp-resource-provider.d.ts

@@ -0,0 +1,7 @@
+import type { InstructionContext, InstructionProvider } from "./instruction";
+export declare class MCPResourceProvider implements InstructionProvider {
+    name: string;
+    priority: number;
+    getInstructions(ctx: InstructionContext): Promise<string | null>;
+    private mergeResources;
+}

package/dist/index.js

@@ -64994,17 +64994,20 @@ var ConfigSchema = exports_external.object({
     router: exports_external.object({
       provider: exports_external.enum(["openai", "anthropic", "ollama"]),
       model: exports_external.string(),
-      mcpTools: exports_external.array(exports_external.string()).optional()
+      mcpTools: exports_external.array(exports_external.string()).optional(),
+      mcpResources: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional()
     }),
     worker: exports_external.object({
       provider: exports_external.enum(["openai", "anthropic", "ollama"]),
       model: exports_external.string(),
-      mcpTools: exports_external.array(exports_external.string()).optional()
+      mcpTools: exports_external.array(exports_external.string()).optional(),
+      mcpResources: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional()
     }),
     gatekeeper: exports_external.object({
       provider: exports_external.enum(["openai", "anthropic", "ollama"]),
       model: exports_external.string(),
-      mcpTools: exports_external.array(exports_external.string()).optional()
+      mcpTools: exports_external.array(exports_external.string()).optional(),
+      mcpResources: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional()
     })
   }),
   mcpServers: exports_external.record(exports_external.string(), exports_external.object({
@@ -81464,6 +81467,48 @@ class MCPService {
       arguments: args
     });
   }
+  async readResource(serverName, uri) {
+    const client = this.clients.get(serverName);
+    if (!client) {
+      logger.warn(`[MCP] Server ${serverName} not connected for resource ${uri}`);
+      return [];
+    }
+    try {
+      logger.info(`[MCP] Reading resource ${serverName}:${uri}`);
+      const result = await client.request({
+        method: "resources/read",
+        params: { uri }
+      }, ReadResourceRequestSchema);
+      return result.contents.map((content) => {
+        if ("text" in content && content.text) {
+          return content.text;
+        }
+        if ("blob" in content) {
+          logger.warn(`[MCP] Skipping binary resource content for ${uri}`);
+        }
+        return null;
+      }).filter((text2) => text2 !== null);
+    } catch (error48) {
+      logger.error(`[MCP] Failed to read resource ${serverName}:${uri}:`, error48);
+      return [];
+    }
+  }
+  async listResources(serverName) {
+    const client = this.clients.get(serverName);
+    if (!client) {
+      logger.warn(`[MCP] Server ${serverName} not connected for listResources`);
+      return [];
+    }
+    try {
+      const result = await client.request({
+        method: "resources/list"
+      }, ListResourcesRequestSchema);
+      return result.resources;
+    } catch (error48) {
+      logger.error(`[MCP] Failed to list resources for ${serverName}:`, error48);
+      return [];
+    }
+  }
   async shutdown() {
     for (const [name18, client] of this.clients) {
       try {
@@ -84763,6 +84808,7 @@ var FormulaSchema = exports_external.object({
   description: exports_external.string(),
   vars: exports_external.record(exports_external.string(), FormulaVariableSchema).optional(),
   prompts: exports_external.record(exports_external.string(), exports_external.string()).optional(),
+  mcp_resources: exports_external.record(exports_external.string(), exports_external.array(exports_external.string())).optional(),
   steps: exports_external.array(FormulaStepSchema)
 });
 
@@ -84809,6 +84855,81 @@ function getFormulaRegistry(basePath) {
   return _registry;
 }
 
+// src/core/mcp-resource-provider.ts
+class MCPResourceProvider {
+  name = "mcp-resources";
+  priority = 25;
+  async getInstructions(ctx) {
+    const resourcesToFetch = {};
+    const config2 = getConfig();
+    const roleConfig = config2.agents[ctx.role];
+    if (roleConfig && "mcpResources" in roleConfig && roleConfig.mcpResources) {
+      this.mergeResources(resourcesToFetch, roleConfig.mcpResources);
+    }
+    if (ctx.beadId) {
+      try {
+        const bead = await getBeads().get(ctx.beadId);
+        const formulaLabel = bead.labels?.find((l) => l.startsWith("formula:"));
+        if (formulaLabel) {
+          const formulaName = formulaLabel.split(":")[1];
+          if (formulaName) {
+            const formula = getFormulaRegistry().get(formulaName);
+            if (formula?.mcp_resources) {
+              this.mergeResources(resourcesToFetch, formula.mcp_resources);
+            }
+          }
+        }
+        if (bead.context?.mcp_resources) {
+          this.mergeResources(resourcesToFetch, bead.context.mcp_resources);
+        }
+      } catch (err) {
+        logger.debug(`[MCPResourceProvider] Error fetching resources from bead/formula: ${err}`);
+      }
+    }
+    if (Object.keys(resourcesToFetch).length === 0)
+      return null;
+    const mcpService = getMCPService();
+    const results = [];
+    for (const [serverName, uris] of Object.entries(resourcesToFetch)) {
+      for (const uri of uris) {
+        try {
+          const contents = await mcpService.readResource(serverName, uri);
+          if (contents.length > 0) {
+            results.push(`## RESOURCE: ${serverName}:${uri}
+${contents.join(`
+
+`)}`);
+          }
+        } catch (err) {
+          logger.warn(`[MCPResourceProvider] Failed to fetch resource ${serverName}:${uri}: ${err}`);
+        }
+      }
+    }
+    if (results.length === 0)
+      return null;
+    return `
+# CONTEXT RESOURCES
+The following resources have been injected into your context for this task:
+
+${results.join(`
+
+--- 
+
+`)}
+`;
+  }
+  mergeResources(target, source) {
+    for (const [server, uris] of Object.entries(source)) {
+      if (!target[server]) {
+        target[server] = new Set;
+      }
+      for (const uri of uris) {
+        target[server].add(uri);
+      }
+    }
+  }
+}
+
 // src/core/instruction.ts
 class GlobalProvider {
   name = "global";
@@ -84961,6 +85082,7 @@ class InstructionService {
       new GlobalProvider,
       new BuiltinProvider,
       new RoleProvider,
+      new MCPResourceProvider,
       new FormulaProvider,
       new TagProvider,
       new ContextProvider

package/dist/services/mcp.d.ts

@@ -13,6 +13,8 @@ export declare class MCPService {
     initialize(): Promise<void>;
     getToolsForAgent(assignedTools?: string[]): Promise<MCPTool[]>;
     callTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    readResource(serverName: string, uri: string): Promise<string[]>;
+    listResources(serverName: string): Promise<unknown[]>;
     shutdown(): Promise<void>;
 }
 export declare function getMCPService(): MCPService;

package/dist/tools/worker.d.ts

@@ -20,7 +20,7 @@ export declare const createReportProgressTool: (_context: AgentContext) => impor
 }>;
 export declare const createDelegateTaskTool: (_context: AgentContext) => import("ai").Tool<{
     title: string;
-    priority: "low" | "normal" | "high" | "critical";
+    priority: "critical" | "low" | "normal" | "high";
     parentBeadId?: string | undefined;
     tags?: string[] | undefined;
     description?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-citadel",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "A deterministic agent orchestration system for Knowledge Work",
   "module": "src/index.ts",
   "type": "module",