@crowley/rag-mcp 1.0.5 → 1.1.0

package/dist/types.d.ts

@@ -2,7 +2,9 @@
  * Shared types for the MCP server tool modules.
  */
 import type { AxiosInstance } from "axios";
-/** MCP tool input schema shape */
+import type { ZodObject, ZodRawShape } from "zod";
+import type { ToolAnnotations } from "./annotations.js";
+/** MCP tool input schema shape (raw JSON Schema) */
 export interface ToolInputSchema {
     type: "object";
     properties: Record<string, unknown>;
@@ -13,6 +15,7 @@ export interface ToolDefinition {
     name: string;
     description: string;
     inputSchema: ToolInputSchema;
+    annotations?: ToolAnnotations;
 }
 /** Context passed to every tool handler */
 export interface ToolContext {
@@ -23,10 +26,24 @@ export interface ToolContext {
     activeSessionId?: string;
     enrichmentEnabled: boolean;
 }
+/** A handler result: plain text OR text + structured data for outputSchema */
+export type ToolHandlerResult = string | {
+    text: string;
+    structured: Record<string, unknown>;
+};
 /** A tool handler function */
-export type ToolHandler = (args: Record<string, unknown>, ctx: ToolContext) => Promise<string>;
+export type ToolHandler = (args: Record<string, unknown>, ctx: ToolContext) => Promise<ToolHandlerResult>;
 /** A tool module exports definitions and handlers */
 export interface ToolModule {
     tools: ToolDefinition[];
     handlers: Record<string, ToolHandler>;
 }
+/** Phase 3 tool spec: schema + handler colocated per tool */
+export interface ToolSpec {
+    name: string;
+    description: string;
+    schema: ZodObject<ZodRawShape>;
+    outputSchema?: ZodObject<ZodRawShape>;
+    annotations?: ToolAnnotations;
+    handler: ToolHandler;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crowley/rag-mcp",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Universal RAG MCP Server for any project",
   "type": "module",
   "main": "dist/index.js",
@@ -32,7 +32,9 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "axios": "^1.6.0",
-    "glob": "^11.0.0"
+    "glob": "^11.0.0",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",