@juspay/neurolink 9.26.2 → 9.28.0

package/dist/lib/utils/schemaConversion.js

@@ -93,50 +93,72 @@ export function inlineJsonSchema(schema, definitions, visited = new Set()) {
     return result;
 }
 /**
- * Convert Zod schema to JSON Schema format for Claude AI
+ * Convert Zod schema to JSON Schema format for provider APIs.
+ *
+ * Handles three input types:
+ * 1. Zod schemas (have `_def.typeName`) — converted via zod-to-json-schema
+ * 2. AI SDK `jsonSchema()` wrappers (have `.jsonSchema` property) — extracted directly
+ * 3. Plain JSON Schema objects (have `type`/`properties` but no `_def`) — returned as-is
  */
 export function convertZodToJsonSchema(zodSchema) {
+    const schema = zodSchema;
+    if (!schema || typeof schema !== "object") {
+        return { type: "object", properties: {} };
+    }
+    // AI SDK jsonSchema() wrapper — extract the inner JSON Schema directly
+    if ("jsonSchema" in schema &&
+        schema.jsonSchema !== null &&
+        typeof schema.jsonSchema === "object") {
+        const extracted = schema.jsonSchema;
+        return ensureTypeField(extracted);
+    }
+    // Plain JSON Schema object (from external MCP tools) — no Zod internals
+    if (!isZodSchema(schema)) {
+        return ensureTypeField(schema);
+    }
+    // Actual Zod schema — convert via zod-to-json-schema
     try {
-        // Use a type assertion that bypasses the infinite recursion check
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const jsonSchema = zodToJsonSchema(zodSchema, {
             name: "ToolParameters",
             target: "jsonSchema7",
             errorMessages: true,
         });
-        // CRITICAL FIX: Ensure schema always has a proper type field for Google Vertex AI
-        if (!jsonSchema.type) {
-            // Default to "object" type if not specified, as most tool schemas are objects
-            jsonSchema.type = "object";
-            // If no properties, ensure it's at least an empty object schema
-            if (!jsonSchema.properties) {
-                jsonSchema.properties = {};
-            }
-            logger.info(`[SCHEMA-TYPE-FIX] Added missing type field to JSON Schema`, {
-                originalType: undefined,
-                fixedType: jsonSchema.type,
-                hasProperties: !!jsonSchema.properties,
-                addedEmptyProperties: !jsonSchema.properties,
-            });
-        }
-        logger.debug("Converted Zod schema to JSON Schema", {
-            hasProperties: !!jsonSchema.properties,
-            propertiesCount: Object.keys(jsonSchema.properties || {}).length,
-            schemaType: jsonSchema.type,
-            hasTypeField: !!jsonSchema.type,
-        });
-        return jsonSchema;
+        // zodToJsonSchema with 'name' produces { $ref: "#/definitions/ToolParameters", definitions: {...} }
+        // Inline the $ref to produce a flat schema before passing to ensureTypeField
+        const inlined = inlineJsonSchema(jsonSchema);
+        return ensureTypeField(inlined);
     }
     catch (error) {
         logger.warn("Failed to convert Zod schema to JSON Schema", {
             error: error instanceof Error ? error.message : String(error),
         });
-        // Return a valid empty object schema instead of empty object
-        return {
+        return { type: "object", properties: {} };
+    }
+}
+/**
+ * Ensure a JSON Schema object has a `type` field (required by Vertex/Gemini).
+ */
+function ensureTypeField(schema) {
+    if (!schema.type) {
+        // Schemas using composition keywords (anyOf/oneOf/allOf) deliberately omit type
+        if (schema.anyOf || schema.oneOf || schema.allOf) {
+            return schema;
+        }
+        const hadProperties = !!schema.properties;
+        const result = {
+            ...schema,
             type: "object",
-            properties: {},
         };
+        if (!result.properties) {
+            result.properties = {};
+        }
+        logger.debug("[SCHEMA-TYPE-FIX] Added missing type field to JSON Schema", {
+            fixedType: "object",
+            addedProperties: !hadProperties,
+        });
+        return result;
     }
+    return schema;
 }
 /**
  * Check if a value is a Zod schema

package/dist/lib/workflow/config.d.ts

@@ -236,6 +236,7 @@ export declare const ModelGroupSchema: z.ZodObject<{
     timeout: z.ZodOptional<z.ZodNumber>;
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>>>;
 }, "strip", z.ZodTypeAny, {
+    id: string;
     models: {
         provider: AIProviderName;
         model: string;
@@ -251,7 +252,6 @@ export declare const ModelGroupSchema: z.ZodObject<{
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     executionStrategy: "parallel" | "sequential";
     continueOnFailure: boolean;
     minSuccessful: number;
@@ -261,6 +261,7 @@ export declare const ModelGroupSchema: z.ZodObject<{
     description?: string | undefined;
     parallelism?: number | undefined;
 }, {
+    id: string;
     models: {
         provider: string;
         model: string;
@@ -276,7 +277,6 @@ export declare const ModelGroupSchema: z.ZodObject<{
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     executionStrategy: "parallel" | "sequential";
     timeout?: number | undefined;
     metadata?: Record<string, JsonValue> | undefined;
@@ -438,6 +438,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         timeout: z.ZodOptional<z.ZodNumber>;
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<JsonValue, z.ZodTypeDef, JsonValue>>>;
     }, "strip", z.ZodTypeAny, {
+        id: string;
         models: {
             provider: AIProviderName;
             model: string;
@@ -453,7 +454,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         continueOnFailure: boolean;
         minSuccessful: number;
@@ -463,6 +463,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         description?: string | undefined;
         parallelism?: number | undefined;
     }, {
+        id: string;
         models: {
             provider: string;
             model: string;
@@ -478,7 +479,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -716,6 +716,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
 }, "strip", z.ZodTypeAny, {
     type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
+    id: string;
     models: {
         provider: AIProviderName;
         model: string;
@@ -731,7 +732,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     execution?: {
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -789,6 +789,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
+        id: string;
         models: {
             provider: AIProviderName;
             model: string;
@@ -804,7 +805,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         continueOnFailure: boolean;
         minSuccessful: number;
@@ -838,6 +838,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
 }, {
     type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
+    id: string;
     models: {
         provider: string;
         model: string;
@@ -853,7 +854,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     execution?: {
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -911,6 +911,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
+        id: string;
         models: {
             provider: string;
             model: string;
@@ -926,7 +927,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -960,6 +960,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
 }>, {
     type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
+    id: string;
     models: {
         provider: AIProviderName;
         model: string;
@@ -975,7 +976,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     execution?: {
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -1033,6 +1033,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
+        id: string;
         models: {
             provider: AIProviderName;
             model: string;
@@ -1048,7 +1049,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         continueOnFailure: boolean;
         minSuccessful: number;
@@ -1082,6 +1082,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
 }, {
     type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
+    id: string;
     models: {
         provider: string;
         model: string;
@@ -1097,7 +1098,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     execution?: {
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -1155,6 +1155,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
+        id: string;
         models: {
             provider: string;
             model: string;
@@ -1170,7 +1171,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -1204,6 +1204,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
 }>, {
     type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
+    id: string;
     models: {
         provider: AIProviderName;
         model: string;
@@ -1219,7 +1220,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     execution?: {
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -1277,6 +1277,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
+        id: string;
         models: {
             provider: AIProviderName;
             model: string;
@@ -1292,7 +1293,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         continueOnFailure: boolean;
         minSuccessful: number;
@@ -1326,6 +1326,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
 }, {
     type: "custom" | "chain" | "ensemble" | "adaptive";
     name: string;
+    id: string;
     models: {
         provider: string;
         model: string;
@@ -1341,7 +1342,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
         frequencyPenalty?: number | undefined;
         label?: string | undefined;
     }[];
-    id: string;
     execution?: {
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;
@@ -1399,6 +1399,7 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
     createdAt?: string | undefined;
     updatedAt?: string | undefined;
     modelGroups?: {
+        id: string;
         models: {
             provider: string;
             model: string;
@@ -1414,7 +1415,6 @@ export declare const WorkflowConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject
             frequencyPenalty?: number | undefined;
             label?: string | undefined;
         }[];
-        id: string;
         executionStrategy: "parallel" | "sequential";
         timeout?: number | undefined;
         metadata?: Record<string, JsonValue> | undefined;

package/dist/mcp/agentExposure.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Agent and Workflow Exposure as MCP Tools
+ *
+ * Enables exposing NeuroLink agents and workflows as MCP tools,
+ * allowing external MCP clients to invoke complex AI operations
+ * through the standardized MCP protocol.
+ *
+ * @module mcp/agentExposure
+ * @since 8.39.0
+ */
+import type { JsonObject } from "../types/common.js";
+import type { NeuroLinkExecutionContext } from "../types/mcpTypes.js";
+import type { MCPServerTool, MCPToolAnnotations } from "./toolAnnotations.js";
+/**
+ * Agent definition for MCP exposure
+ */
+export type ExposableAgent = {
+    /**
+     * Unique agent identifier
+     */
+    id: string;
+    /**
+     * Human-readable agent name
+     */
+    name: string;
+    /**
+     * Agent description for AI models
+     */
+    description: string;
+    /**
+     * Input schema for the agent
+     */
+    inputSchema?: JsonObject;
+    /**
+     * Output schema for the agent
+     */
+    outputSchema?: JsonObject;
+    /**
+     * Agent execution function
+     */
+    execute: (input: unknown, context?: NeuroLinkExecutionContext) => Promise<unknown>;
+    /**
+     * Additional agent metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        category?: string;
+        tags?: string[];
+        estimatedDuration?: number;
+        costHint?: number;
+    };
+};
+/**
+ * Workflow definition for MCP exposure
+ */
+export type ExposableWorkflow = {
+    /**
+     * Unique workflow identifier
+     */
+    id: string;
+    /**
+     * Human-readable workflow name
+     */
+    name: string;
+    /**
+     * Workflow description
+     */
+    description: string;
+    /**
+     * Workflow steps (for documentation)
+     */
+    steps?: Array<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+    /**
+     * Input schema for the workflow
+     */
+    inputSchema?: JsonObject;
+    /**
+     * Output schema for the workflow
+     */
+    outputSchema?: JsonObject;
+    /**
+     * Workflow execution function
+     */
+    execute: (input: unknown, context?: NeuroLinkExecutionContext) => Promise<unknown>;
+    /**
+     * Workflow metadata
+     */
+    metadata?: {
+        version?: string;
+        author?: string;
+        category?: string;
+        tags?: string[];
+        estimatedDuration?: number;
+        retriable?: boolean;
+        idempotent?: boolean;
+    };
+};
+/**
+ * Options for exposing agents/workflows as MCP tools
+ */
+export type ExposureOptions = {
+    /**
+     * Prefix for tool names
+     */
+    prefix?: string;
+    /**
+     * Default annotations for all exposed tools
+     */
+    defaultAnnotations?: MCPToolAnnotations;
+    /**
+     * Whether to include metadata in tool description
+     */
+    includeMetadataInDescription?: boolean;
+    /**
+     * Custom name transformer
+     */
+    nameTransformer?: (name: string) => string;
+    /**
+     * Add execution context wrapper
+     */
+    wrapWithContext?: boolean;
+    /**
+     * Timeout for agent/workflow execution (ms)
+     */
+    executionTimeout?: number;
+    /**
+     * Enable execution logging
+     */
+    enableLogging?: boolean;
+};
+/**
+ * Exposure result
+ */
+export type ExposureResult = {
+    /**
+     * Generated MCP tool
+     */
+    tool: MCPServerTool;
+    /**
+     * Original source type
+     */
+    sourceType: "agent" | "workflow";
+    /**
+     * Original source ID
+     */
+    sourceId: string;
+    /**
+     * Generated tool name
+     */
+    toolName: string;
+};
+/**
+ * Expose an agent as an MCP tool
+ */
+export declare function exposeAgentAsTool(agent: ExposableAgent, options?: ExposureOptions): ExposureResult;
+/**
+ * Expose a workflow as an MCP tool
+ */
+export declare function exposeWorkflowAsTool(workflow: ExposableWorkflow, options?: ExposureOptions): ExposureResult;
+/**
+ * Batch expose agents as MCP tools
+ */
+export declare function exposeAgentsAsTools(agents: ExposableAgent[], options?: ExposureOptions): ExposureResult[];
+/**
+ * Batch expose workflows as MCP tools
+ */
+export declare function exposeWorkflowsAsTools(workflows: ExposableWorkflow[], options?: ExposureOptions): ExposureResult[];
+/**
+ * Agent Exposure Manager
+ *
+ * Manages the lifecycle of exposed agents and workflows,
+ * providing registration, lookup, and invocation capabilities.
+ */
+export declare class AgentExposureManager {
+    private exposedTools;
+    private options;
+    constructor(options?: ExposureOptions);
+    /**
+     * Expose an agent and register it
+     */
+    exposeAgent(agent: ExposableAgent): MCPServerTool;
+    /**
+     * Expose a workflow and register it
+     */
+    exposeWorkflow(workflow: ExposableWorkflow): MCPServerTool;
+    /**
+     * Get all exposed tools
+     */
+    getExposedTools(): MCPServerTool[];
+    /**
+     * Get exposed tool by name
+     */
+    getExposedTool(toolName: string): MCPServerTool | undefined;
+    /**
+     * Get exposure result by tool name
+     */
+    getExposureResult(toolName: string): ExposureResult | undefined;
+    /**
+     * Get tools by source type
+     */
+    getToolsBySourceType(sourceType: "agent" | "workflow"): MCPServerTool[];
+    /**
+     * Remove exposed tool
+     */
+    unexpose(toolName: string): boolean;
+    /**
+     * Clear all exposed tools
+     */
+    clear(): void;
+    /**
+     * Get statistics
+     */
+    getStatistics(): {
+        totalExposed: number;
+        exposedAgents: number;
+        exposedWorkflows: number;
+        toolNames: string[];
+    };
+}
+/**
+ * Global agent exposure manager instance
+ */
+export declare const globalAgentExposureManager: AgentExposureManager;