@kadi.build/core 0.0.1-alpha.1 → 0.0.1-alpha.10

package/dist/index.js

@@ -0,0 +1,63 @@
+/**
+ * KADI Core V2
+ *
+ * Main entry point for the KADI framework.
+ * Provides a clean, typed, and intuitive API for building distributed systems.
+ *
+ * **Breaking Changes (v2.0.0)**:
+ * - Replaced Zod schemas with MCP (Model Context Protocol) JSON Schemas
+ * - Full MCP compliance with KADI extensions
+ * - See migration guide for upgrading from v1.x
+ *
+ * @packageDocumentation
+ */
+// Main client
+export { KadiClient } from './client/index.js';
+// Simplified API (user-friendly wrapper)
+export * as Kadi from './api/index.js';
+// Error types and class
+export { KadiError, isKadiError, isError, ErrorCode } from './errors/index.js';
+// Abilities
+export { AbilityLoader, AbilityProxy } from './abilities/index.js';
+export { SchemaValidator } from './validation/index.js';
+/**
+ * Broker-specific error code subset
+ */
+export const BrokerErrorCodes = {
+    SCHEMA_VALIDATION_FAILED: 'SCHEMA_VALIDATION_FAILED',
+    TOOL_VALIDATION_FAILED: 'TOOL_VALIDATION_FAILED',
+    BROKER_RESPONSE_ERROR: 'BROKER_RESPONSE_ERROR',
+    BROKER_TIMEOUT: 'BROKER_TIMEOUT',
+    BROKER_SCHEMA_COMPILATION_ERROR: 'BROKER_SCHEMA_COMPILATION_ERROR',
+    TOOL_NOT_FOUND: 'TOOL_NOT_FOUND',
+    TOOL_INVOCATION_FAILED: 'TOOL_INVOCATION_FAILED',
+    INVALID_INPUT: 'INVALID_INPUT',
+    INTERNAL_ERROR: 'INTERNAL_ERROR'
+};
+/**
+ * Validate tool schemas for MCP compliance
+ *
+ * @param inputSchema - Input schema
+ * @param outputSchema - Output schema (optional)
+ * @param toolName - Tool name for error messages
+ * @returns Validation result
+ */
+export function validateToolSchemas(inputSchema, outputSchema, toolName) {
+    const errors = [];
+    if (!inputSchema || typeof inputSchema !== 'object') {
+        errors.push(`Tool '${toolName}': inputSchema must be an object`);
+    }
+    else if (inputSchema.type !== 'object') {
+        errors.push(`Tool '${toolName}': inputSchema.type must be 'object' (MCP requirement)`);
+    }
+    if (outputSchema && outputSchema.type && outputSchema.type !== 'object') {
+        errors.push(`Tool '${toolName}': outputSchema.type should be 'object'`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+export { 
+// MCP version
+MCP_SCHEMA_VERSION, MCP_SPEC_URL, getMcpVersionInfo, 
+// Schema builders (DX helpers)
+buildTool, stringProp, numberProp, integerProp, booleanProp, arrayProp, objectProp, enumProp, optional } from './schemas/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,yCAAyC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AAyCvC,wBAAwB;AACxB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE/E,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AASnE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,wBAAwB,EAAE,0BAA0B;IACpD,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,cAAc,EAAE,gBAAgB;IAChC,+BAA+B,EAAE,iCAAiC;IAClE,cAAc,EAAE,gBAAgB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAoC,EACpC,YAAiD,EACjD,QAAgB;IAEhB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,kCAAkC,CAAC,CAAC;IACnE,CAAC;SAAM,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,wDAAwD,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,YAAY,IAAI,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,SAAS,QAAQ,yCAAyC,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,OAAO;AACL,cAAc;AACd,kBAAkB,EAClB,YAAY,EACZ,iBAAiB;AAEjB,+BAA+B;AAC/B,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACT,MAAM,oBAAoB,CAAC"}

package/dist/messages/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * KADI Protocol Messages
+ * =======================
+ *
+ * Protocol message constants used by kadi-broker and agents.
+ *
+ * @module messages
+ */
+/**
+ * KADI Protocol Message Constants
+ *
+ * These define the method names for KADI broker protocol messages.
+ */
+export declare const KadiMessages: {
+    readonly SESSION_HELLO: "kadi.session.hello";
+    readonly SESSION_AUTHENTICATE: "kadi.session.authenticate";
+    readonly SESSION_PING: "kadi.session.ping";
+    readonly SESSION_GOODBYE: "kadi.session.goodbye";
+    readonly AGENT_REGISTER: "kadi.agent.register";
+    readonly ABILITY_REQUEST: "kadi.ability.request";
+    readonly ABILITY_RESULT: "kadi.ability.result";
+    readonly ABILITY_LIST: "kadi.ability.list";
+    readonly ABILITY_PENDING: "kadi.ability.pending";
+    readonly EVENT_SUBSCRIBE: "kadi.event.subscribe";
+    readonly EVENT_UNSUBSCRIBE: "kadi.event.unsubscribe";
+    readonly EVENT_PUBLISH: "kadi.event.publish";
+    readonly EVENT_DELIVERY: "kadi.event.delivery";
+};
+/**
+ * Type representing all valid KADI message method names
+ */
+export type KadiMessageMethod = typeof KadiMessages[keyof typeof KadiMessages];
+//# sourceMappingURL=index.d.ts.map

package/dist/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;CAqBf,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/messages/index.js

@@ -0,0 +1,33 @@
+/**
+ * KADI Protocol Messages
+ * =======================
+ *
+ * Protocol message constants used by kadi-broker and agents.
+ *
+ * @module messages
+ */
+/**
+ * KADI Protocol Message Constants
+ *
+ * These define the method names for KADI broker protocol messages.
+ */
+export const KadiMessages = {
+    // Session lifecycle
+    SESSION_HELLO: 'kadi.session.hello',
+    SESSION_AUTHENTICATE: 'kadi.session.authenticate',
+    SESSION_PING: 'kadi.session.ping',
+    SESSION_GOODBYE: 'kadi.session.goodbye',
+    // Agent registration
+    AGENT_REGISTER: 'kadi.agent.register',
+    // Ability/Tool operations
+    ABILITY_REQUEST: 'kadi.ability.request',
+    ABILITY_RESULT: 'kadi.ability.result',
+    ABILITY_LIST: 'kadi.ability.list',
+    ABILITY_PENDING: 'kadi.ability.pending',
+    // Event system
+    EVENT_SUBSCRIBE: 'kadi.event.subscribe',
+    EVENT_UNSUBSCRIBE: 'kadi.event.unsubscribe',
+    EVENT_PUBLISH: 'kadi.event.publish',
+    EVENT_DELIVERY: 'kadi.event.delivery'
+};
+//# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oBAAoB;IACpB,aAAa,EAAE,oBAAoB;IACnC,oBAAoB,EAAE,2BAA2B;IACjD,YAAY,EAAE,mBAAmB;IACjC,eAAe,EAAE,sBAAsB;IAEvC,qBAAqB;IACrB,cAAc,EAAE,qBAAqB;IAErC,0BAA0B;IAC1B,eAAe,EAAE,sBAAsB;IACvC,cAAc,EAAE,qBAAqB;IACrC,YAAY,EAAE,mBAAmB;IACjC,eAAe,EAAE,sBAAsB;IAEvC,eAAe;IACf,eAAe,EAAE,sBAAsB;IACvC,iBAAiB,EAAE,wBAAwB;IAC3C,aAAa,EAAE,oBAAoB;IACnC,cAAc,EAAE,qBAAqB;CAC7B,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * KADI Schemas Module
+ * ====================
+ *
+ * This module provides MCP (Model Context Protocol) schemas and KADI extensions.
+ *
+ * **Architecture**:
+ * - `mcp/` - Official MCP schemas (verbatim copy from spec)
+ * - `kadi-extensions.ts` - KADI-specific extensions to MCP
+ * - `schema-builders.ts` - Developer-friendly schema builders
+ *
+ * @module schemas
+ */
+export type { JSONRPCMessage, JSONRPCRequest, JSONRPCNotification, JSONRPCResponse, JSONRPCError, RequestId, Request, Notification, Result, EmptyResult, Tool as McpTool, ToolAnnotations, ListToolsRequest, ListToolsResult, CallToolRequest, CallToolResult as McpCallToolResult, ToolListChangedNotification, InitializeRequest, InitializeResult, InitializedNotification, ClientCapabilities, ServerCapabilities, ContentBlock, TextContent, ImageContent, AudioContent, Resource, ResourceTemplate, ResourceContents, TextResourceContents, BlobResourceContents, ListResourcesRequest, ListResourcesResult, ReadResourceRequest, ReadResourceResult, Prompt, PromptMessage, ListPromptsRequest, ListPromptsResult, GetPromptRequest, GetPromptResult, ProgressToken, ProgressNotification, Cursor, PaginatedRequest, PaginatedResult, LoggingLevel, LoggingMessageNotification, BaseMetadata, Implementation, Annotations } from './mcp/schema.js';
+export { LATEST_PROTOCOL_VERSION, JSONRPC_VERSION, PARSE_ERROR, INVALID_REQUEST, METHOD_NOT_FOUND, INVALID_PARAMS, INTERNAL_ERROR } from './mcp/schema.js';
+export { MCP_SCHEMA_VERSION, MCP_SPEC_URL, MCP_LICENSE, MCP_COPYRIGHT, getMcpVersionInfo } from './mcp/version.js';
+export type { NetworkId, ToolTag, KadiTool, KadiToolResult, ToolDefinition, ToolHandler, RegisteredTool, NetworkMetadata, ToolDiscoveryQuery, ToolDiscoveryResult } from './kadi-extensions.js';
+export { buildTool, stringProp, numberProp, integerProp, booleanProp, arrayProp, objectProp, enumProp, optional, exampleMathTool, exampleFileTool, exampleBatchTool } from './schema-builders.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,YAAY,EAEV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,YAAY,EACZ,SAAS,EAGT,OAAO,EACP,YAAY,EACZ,MAAM,EACN,WAAW,EAGX,IAAI,IAAI,OAAO,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,IAAI,iBAAiB,EACnC,2BAA2B,EAG3B,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EAGvB,kBAAkB,EAClB,kBAAkB,EAGlB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EAGZ,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAGlB,MAAM,EACN,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAGf,aAAa,EACb,oBAAoB,EACpB,MAAM,EACN,gBAAgB,EAChB,eAAe,EAGf,YAAY,EACZ,0BAA0B,EAG1B,YAAY,EACZ,cAAc,EACd,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAM1B,YAAY,EAEV,SAAS,EACT,OAAO,EACP,QAAQ,EACR,cAAc,EACd,cAAc,EACd,WAAW,EACX,cAAc,EAGd,eAAe,EAGf,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EAGR,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,25 @@
+/**
+ * KADI Schemas Module
+ * ====================
+ *
+ * This module provides MCP (Model Context Protocol) schemas and KADI extensions.
+ *
+ * **Architecture**:
+ * - `mcp/` - Official MCP schemas (verbatim copy from spec)
+ * - `kadi-extensions.ts` - KADI-specific extensions to MCP
+ * - `schema-builders.ts` - Developer-friendly schema builders
+ *
+ * @module schemas
+ */
+export { LATEST_PROTOCOL_VERSION, JSONRPC_VERSION, PARSE_ERROR, INVALID_REQUEST, METHOD_NOT_FOUND, INVALID_PARAMS, INTERNAL_ERROR } from './mcp/schema.js';
+// ============================================================================
+// MCP Version Information
+// ============================================================================
+export { MCP_SCHEMA_VERSION, MCP_SPEC_URL, MCP_LICENSE, MCP_COPYRIGHT, getMcpVersionInfo } from './mcp/version.js';
+// ============================================================================
+// Schema Builders (Developer Experience)
+// ============================================================================
+export { buildTool, stringProp, numberProp, integerProp, booleanProp, arrayProp, objectProp, enumProp, optional, 
+// Example tools for reference
+exampleMathTool, exampleFileTool, exampleBatchTool } from './schema-builders.js';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAiFH,OAAO,EACL,uBAAuB,EACvB,eAAe,EACf,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAwB1B,+EAA+E;AAC/E,yCAAyC;AACzC,+EAA+E;AAE/E,OAAO,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ;AAER,8BAA8B;AAC9B,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,sBAAsB,CAAC"}

package/dist/schemas/kadi-extensions.d.ts

@@ -0,0 +1,231 @@
+/**
+ * KADI Extensions for MCP Schemas
+ * =================================
+ *
+ * This file defines KADI-specific extensions to the Model Context Protocol (MCP)
+ * schemas. These extensions add functionality needed for the KADI ecosystem while
+ * maintaining compatibility with the core MCP specification.
+ *
+ * **Philosophy**: Keep MCP schemas pure, add KADI extensions separately.
+ *
+ * @module schemas/kadi-extensions
+ */
+import type { Tool as McpTool, CallToolResult as McpCallToolResult } from './mcp/schema.js';
+/**
+ * Network identifier in KADI ecosystem
+ *
+ * Networks provide logical isolation for tools, agents, and events.
+ * Examples: 'global', 'local', 'trading', 'development'
+ */
+export type NetworkId = string;
+/**
+ * Tool tags for routing and selection hints
+ *
+ * Tags help with intelligent tool selection and routing.
+ * Examples: 'cpu-intensive', 'batch', 'real-time', 'gpu', 'distributed'
+ */
+export type ToolTag = string;
+/**
+ * KADI Tool - Extends MCP Tool with KADI-specific metadata
+ *
+ * This interface adds KADI-specific features while maintaining full
+ * compatibility with the MCP Tool specification.
+ *
+ * **Extensions**:
+ * - `version`: Semantic versioning for tools
+ * - `tags`: Routing and selection hints
+ * - `networks`: Network isolation for tools
+ *
+ * @example
+ * ```typescript
+ * const tool: KadiTool = {
+ *   name: 'calculator.add',
+ *   description: 'Add two numbers',
+ *   version: '1.0.0',
+ *   tags: ['math', 'basic'],
+ *   networks: ['global'],
+ *   inputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       a: { type: 'number' },
+ *       b: { type: 'number' }
+ *     },
+ *     required: ['a', 'b']
+ *   },
+ *   outputSchema: {
+ *     type: 'object',
+ *     properties: {
+ *       result: { type: 'number' }
+ *     }
+ *   }
+ * };
+ * ```
+ */
+export interface KadiTool extends McpTool {
+    /**
+     * Semantic version of the tool
+     *
+     * Format: MAJOR.MINOR.PATCH (e.g., "1.0.0", "2.3.1")
+     * Follows semver specification: https://semver.org/
+     */
+    version?: string;
+    /**
+     * Tags for routing and selection
+     *
+     * Hints for intelligent tool selection and routing.
+     * Examples:
+     * - Performance hints: 'cpu-intensive', 'memory-heavy', 'gpu-required'
+     * - Execution hints: 'batch', 'real-time', 'async'
+     * - Domain hints: 'math', 'crypto', 'file-ops', 'network'
+     */
+    tags?: ToolTag[];
+    /**
+     * Networks this tool is available on
+     *
+     * Tools can be scoped to specific networks for isolation and organization.
+     * If not specified, defaults to ['global'].
+     */
+    networks?: NetworkId[];
+}
+/**
+ * KADI Tool Result - Extends MCP CallToolResult
+ *
+ * Maintains compatibility with MCP while allowing for KADI-specific
+ * metadata in the `_meta` field.
+ */
+export interface KadiToolResult extends McpCallToolResult {
+    /**
+     * Extended metadata for KADI
+     *
+     * Can include execution metadata like:
+     * - `executionTime`: Time taken to execute (ms)
+     * - `agentId`: Agent that executed the tool
+     * - `networkId`: Network the tool was executed on
+     * - `cacheHit`: Whether result was cached
+     */
+    _meta?: {
+        executionTime?: number;
+        agentId?: string;
+        networkId?: string;
+        cacheHit?: boolean;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Tool definition for registration
+ *
+ * Simplified interface for registering tools. Omits the handler function
+ * which is stored separately in the ToolRegistry.
+ */
+export type ToolDefinition = Omit<KadiTool, 'annotations'> & {
+    /**
+     * Optional annotations from MCP spec
+     */
+    annotations?: McpTool['annotations'];
+};
+/**
+ * Tool handler function
+ *
+ * @template TInput - Input parameters type
+ * @template TOutput - Output/result type
+ * @param params - Input parameters (validated against inputSchema)
+ * @returns Tool result (validated against outputSchema if present)
+ */
+export type ToolHandler<TInput = unknown, TOutput = unknown> = (params: TInput) => Promise<TOutput> | TOutput;
+/**
+ * Registered tool with handler
+ *
+ * Internal representation of a registered tool, including its handler.
+ */
+export interface RegisteredTool<TInput = unknown, TOutput = unknown> {
+    /**
+     * Tool definition (MCP-compliant)
+     */
+    definition: KadiTool;
+    /**
+     * Tool handler function
+     */
+    handler: ToolHandler<TInput, TOutput>;
+    /**
+     * Registration timestamp
+     */
+    registeredAt: number;
+    /**
+     * Agent/service that registered this tool
+     */
+    registeredBy?: string;
+}
+/**
+ * Network metadata
+ *
+ * Information about a KADI network.
+ */
+export interface NetworkMetadata {
+    /**
+     * Network identifier
+     */
+    id: NetworkId;
+    /**
+     * Human-readable network name
+     */
+    name: string;
+    /**
+     * Network description
+     */
+    description?: string;
+    /**
+     * Whether this is a public or private network
+     */
+    public: boolean;
+    /**
+     * Network creation timestamp
+     */
+    createdAt: number;
+}
+/**
+ * Tool discovery query
+ *
+ * Used to search for tools across networks.
+ */
+export interface ToolDiscoveryQuery {
+    /**
+     * Tool name or pattern (supports wildcards)
+     */
+    name?: string;
+    /**
+     * Filter by tags (OR logic)
+     */
+    tags?: ToolTag[];
+    /**
+     * Filter by networks
+     */
+    networks?: NetworkId[];
+    /**
+     * Filter by version (exact match or range)
+     */
+    version?: string;
+    /**
+     * Maximum results to return
+     */
+    limit?: number;
+}
+/**
+ * Tool discovery result
+ *
+ * Result of a tool discovery query.
+ */
+export interface ToolDiscoveryResult {
+    /**
+     * Found tools
+     */
+    tools: KadiTool[];
+    /**
+     * Total number of tools matching query (may exceed returned tools)
+     */
+    total: number;
+    /**
+     * Pagination cursor (if more results available)
+     */
+    nextCursor?: string;
+}
+//# sourceMappingURL=kadi-extensions.d.ts.map

package/dist/schemas/kadi-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadi-extensions.d.ts","sourceRoot":"","sources":["../../src/schemas/kadi-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,QAAS,SAAQ,OAAO;IACvC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAe,SAAQ,iBAAiB;IACvD;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG;IAC3D;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,CAC7D,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAEhC;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACjE;;OAEG;IACH,UAAU,EAAE,QAAQ,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEtC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,SAAS,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IAEvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,QAAQ,EAAE,CAAC;IAElB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/schemas/kadi-extensions.js

@@ -0,0 +1,14 @@
+/**
+ * KADI Extensions for MCP Schemas
+ * =================================
+ *
+ * This file defines KADI-specific extensions to the Model Context Protocol (MCP)
+ * schemas. These extensions add functionality needed for the KADI ecosystem while
+ * maintaining compatibility with the core MCP specification.
+ *
+ * **Philosophy**: Keep MCP schemas pure, add KADI extensions separately.
+ *
+ * @module schemas/kadi-extensions
+ */
+export {};
+//# sourceMappingURL=kadi-extensions.js.map

package/dist/schemas/kadi-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kadi-extensions.js","sourceRoot":"","sources":["../../src/schemas/kadi-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}