@hailer/mcp 1.1.16 → 1.1.17-beta.0

package/dist/mcp/tool-registry.d.ts

@@ -1,23 +1,10 @@
 /**
- * Clean Tool Registry with Dependency Injection
- *
- * No singletons, no statics - just clean, explicit tool registration
- * with per-agent access control via dependency injection.
- *
- * Supports workspace-specific schema overrides for structured outputs:
- * - Load schemas from WORKSPACE_SCHEMAS_PATH environment variable
- * - Schemas contain enum constraints (valid IDs, phase options, etc.)
- * - Enables Claude's strict mode validation with actual workspace values
+ * Tool Registry — register, list, validate, execute MCP tools.
  */
 import { z } from 'zod';
 import { McpResponse } from './utils/types';
 /**
  * Tool groups for access control
- * READ: Safe read operations (workflows, activities, schemas)
- * WRITE: Create/update operations (activities, discussions)
- * PLAYGROUND: Admin/dev tools (workflow/app management)
- * NUCLEAR: Destructive operations (remove workflows, apps, insights, templates)
- * BOT_INTERNAL: Tools for autonomous bots only (not exposed to MCP clients by default)
  */
 export declare enum ToolGroup {
     READ = "read",
@@ -28,145 +15,53 @@ export declare enum ToolGroup {
 }
 /**
  * Context type for tool execution
- * - 'hailer': Requires Hailer authentication via UserContextCache (default)
- * - 'none': No authentication needed (e.g., Weaviate tools with their own auth)
+ * - 'hailer': Requires Hailer authentication (default)
+ * - 'none': No Hailer auth needed (e.g., Vipunen tools)
  */
 export type ToolContextType = 'hailer' | 'none';
-/**
- * Tool definition interface
- */
 export interface Tool<TSchema extends z.ZodType = z.ZodType> {
     name: string;
     group: ToolGroup;
     description: string;
     schema: TSchema;
-    /** What authentication context this tool needs. Defaults to 'hailer'. */
     contextType?: ToolContextType;
-    /** Context is UserContext for Hailer tools, VipunenContext for contextType:'none' tools.
-     *  Type safety is enforced at the mcp-server dispatch boundary, not here. */
     execute: (args: z.infer<TSchema>, context: any) => Promise<McpResponse>;
 }
-/**
- * Tool definition for MCP protocol (JSON-RPC)
- */
 export interface ToolDefinition {
     name: string;
     description: string;
     inputSchema: any;
 }
-/**
- * ToolRegistry - Clean, testable, dependency-injected tool registry
- *
- * NO SINGLETON PATTERN - instantiated explicitly and passed through DI
- *
- * Workspace Schema Support:
- * Set WORKSPACE_SCHEMAS_PATH env var to load Claude-compatible schemas
- * with enum constraints for workflow IDs, phase IDs, field options, etc.
- */
 export declare class ToolRegistry {
     private tools;
+    private jsonSchemas;
     private _lazyGuard?;
     private enableNuclearTools;
-    private workspaceSchemas;
-    private workspaceSchemasLoaded;
     constructor(options?: {
         enableNuclearTools?: boolean;
     });
-    /**
-     * Load workspace-specific schemas from configured path
-     * Schemas provide enum constraints for Claude's strict mode
-     */
-    private loadWorkspaceSchemas;
-    /**
-     * Get workspace schema for a workflow (if available)
-     */
-    getWorkspaceSchema(workflowName: string): any | null;
-    /**
-     * Check if workspace schemas are available
-     */
-    hasWorkspaceSchemas(): boolean;
-    /**
-     * Add a tool to the registry
-     */
     addTool(tool: Tool): void;
-    /**
-     * Get tool definitions filtered by contextType — single-pass, no secondary lookups
-     */
+    /** Filter tools by contextType */
     getToolDefinitionsByContextType(contextType: ToolContextType): ToolDefinition[];
-    /**
-     * Get tool definitions with optional filtering
-     *
-     * @param filter - Optional filter configuration
-     * @param filter.allowedGroups - Filter by tool groups
-     * @param filter.allowedTools - Explicit whitelist of tool names
-     */
+    /** Get tool definitions with optional group/name filtering */
     getToolDefinitions(filter?: {
         allowedGroups?: ToolGroup[];
         allowedTools?: string[];
     }): ToolDefinition[];
-    /**
-     * Get specific tool schema on-demand
-     * Token-efficient: ~200 tokens per tool vs loading all tools upfront
-     *
-     * For activity tools (create_activity, update_activity), returns the master
-     * workspace schema with ALL valid IDs as enums. This enables Claude's strict
-     * mode to constrain outputs to valid values without needing them in the prompt.
-     */
-    getToolSchema(toolName: string, workflowName?: string): ToolDefinition | null;
-    /**
-     * Get all workflow-specific tool schemas
-     * Returns schemas with enum constraints for each workflow
-     */
-    getAllWorkflowSchemas(): Map<string, ToolDefinition>;
-    /**
-     * Execute tool with validation
-     */
+    /** Get specific tool schema on-demand */
+    getToolSchema(toolName: string): ToolDefinition | null;
+    /** Execute tool with Zod validation */
     executeTool(name: string, args: any, context: any): Promise<any>;
-    /**
-     * Pre-transform install_workflow args to fix common LLM mistakes BEFORE validation
-     */
+    /** Fix common LLM mistakes in install_workflow before validation */
     private preTransformInstallWorkflow;
-    /**
-     * Get tool metadata (for access control checks)
-     */
     getTool(name: string): Tool | undefined;
-    /**
-     * Get total tool count
-     */
     getToolCount(): number;
-    /**
-     * Get statistics for monitoring/debugging
-     */
     getCacheStats(): {
         totalTools: number;
         toolNames: string[];
         byGroup: Record<ToolGroup, number>;
-        workspaceSchemas: {
-            loaded: boolean;
-            count: number;
-            workflows: string[];
-        };
     };
-    /**
-     * Get all available workspace schemas (for listing available workflows)
-     */
-    getAvailableWorkflowSchemas(): Array<{
-        name: string;
-        workflowId: string;
-        description: string;
-    }>;
-    /**
-     * Get workflow-specific create tool definition
-     * Returns schema with enum constraints for valid phase IDs, field options, etc.
-     */
-    getWorkflowCreateToolDefinition(workflowName: string): ToolDefinition | null;
-    /**
-     * Convert Zod schema to JSON Schema format (required by MCP protocol)
-     */
     private convertZodSchemaToJsonSchema;
-    /**
-     * Convert a single Zod type to JSON Schema
-     */
     private convertZodTypeToJsonSchema;
 }
 //# sourceMappingURL=tool-registry.d.ts.map

package/dist/mcp/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/mcp/tool-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAI5C;;GAEG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,YAAY,iBAAiB;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEhD,MAAM,WAAW,IAAI,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,UAAU,CAAC,CAAW;IAC9B,OAAO,CAAC,kBAAkB,CAAU;gBAExB,OAAO,GAAE;QAAE,kBAAkB,CAAC,EAAE,OAAO,CAAA;KAAO;IAI1D,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAMzB,kCAAkC;IAClC,+BAA+B,CAAC,WAAW,EAAE,eAAe,GAAG,cAAc,EAAE;IAU/E,8DAA8D;IAC9D,kBAAkB,CAAC,MAAM,CAAC,EAAE;QAC1B,aAAa,CAAC,EAAE,SAAS,EAAE,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,GAAG,cAAc,EAAE;IAkBpB,yCAAyC;IACzC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAUtD,uCAAuC;IACjC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IA6CtE,oEAAoE;IACpE,OAAO,CAAC,2BAA2B;IA8DnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIvC,YAAY,IAAI,MAAM;IAItB,aAAa,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;KAAE;IAWhG,OAAO,CAAC,4BAA4B;IA4BpC,OAAO,CAAC,0BAA0B;CA6DnC"}