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

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"}