@hivemind-os/collective-mcp-server 0.2.0

package/.turbo/turbo-build.log

@@ -0,0 +1,14 @@
+$ tsup
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /home/runner/work/collective/collective/packages/mcp-server/tsup.config.ts
+CLI Target: es2022
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js     74.28 KB
+ESM dist/index.js.map 142.69 KB
+ESM ⚡️ Build success in 125ms
+DTS Build start
+DTS ⚡️ Build success in 6780ms
+DTS dist/index.d.ts 13.40 KB

package/dist/index.d.ts

@@ -0,0 +1,493 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { MeshSuiClient, RegistryClient, TaskClient, AgentCache, BlobStore, SpendingPolicyEngine, StakingClient, RelayRegistryClient, DisputeClient, MarketplaceClient, AuthProvider, X402Client, PaymentRailSelector, ReputationEventPublisher, ReputationStore } from '@hivemind-os/collective-core';
+import * as _hivemind_os_collective_types from '@hivemind-os/collective-types';
+import { DID, NetworkConfig, ProviderSelectionStrategy, AggregationMode, PaymentRail, PaymentScheme } from '@hivemind-os/collective-types';
+import { Signer } from '@mysten/sui/cryptography';
+
+interface MeshToolContext {
+    did: DID;
+    keypair: Signer;
+    suiClient: MeshSuiClient;
+    registryClient: RegistryClient;
+    taskClient: TaskClient;
+    agentCache: AgentCache;
+    blobStore: BlobStore;
+    spendingPolicy: SpendingPolicyEngine;
+    networkConfig: NetworkConfig;
+    /** The name of the MCP client app invoking the tool (for per-app spending). */
+    originAppName?: string;
+    stakingClient?: StakingClient;
+    relayRegistryClient?: RelayRegistryClient;
+    disputeClient?: DisputeClient;
+    marketplaceClient?: MarketplaceClient;
+    encryption?: {
+        enabled: boolean;
+        requireEncryption: boolean;
+        publicKey?: string;
+    };
+    relayAuthProvider?: AuthProvider;
+    authProvider?: AuthProvider;
+    x402Client?: X402Client;
+    paymentRailSelector?: PaymentRailSelector;
+    logger?: {
+        info?: (payload: unknown, message?: string) => void;
+        warn?: (payload: unknown, message?: string) => void;
+    };
+    indexer?: {
+        enabled?: boolean;
+        graphqlUrl?: string;
+        fetch?: typeof fetch;
+    };
+    reputationPublisher?: ReputationEventPublisher;
+    reputationStore?: ReputationStore;
+    taskHistoryDb?: unknown;
+}
+
+type MeshToolHandler = (params: never, context: MeshToolContext) => Promise<unknown>;
+declare const meshToolHandlers: Record<string, MeshToolHandler>;
+declare const meshToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            view: {
+                type: string;
+                enum: string[];
+            };
+            period: {
+                type: string;
+                enum: string[];
+            };
+            buckets: {
+                type: string;
+            };
+            limit: {
+                type: string;
+            };
+            sort_by: {
+                type: string;
+                enum: string[];
+            };
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            agent_card_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            capability: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            sort_by: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            useIndexer: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            capability: {
+                type: string;
+                description: string;
+            };
+            provider_did: {
+                type: string;
+                description: string;
+            };
+            input: {
+                type: string;
+                description: string;
+            };
+            max_price_mist: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            task_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            capability: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                description: string;
+            };
+            price_mist: {
+                type: string;
+                description: string;
+            };
+            input: {
+                type: string;
+                description: string;
+            };
+            input_blob_id: {
+                type: string;
+                description: string;
+            };
+            agreement_hash: {
+                type: string;
+                description: string;
+            };
+            dispute_window_ms: {
+                type: string;
+                description: string;
+            };
+            expiry_hours: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            capability: {
+                type: string;
+                description: string;
+            };
+            input: {
+                description: string;
+            };
+            fanOutCount: {
+                type: string;
+                description: string;
+            };
+            strategy: {
+                type: string;
+                enum: _hivemind_os_collective_types.ProviderSelectionStrategy[];
+                description: string;
+            };
+            aggregation: {
+                type: string;
+                enum: _hivemind_os_collective_types.AggregationMode[];
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+            maxPricePerProvider: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            capabilities: {
+                type: "array";
+                items: {
+                    type: "object";
+                    properties: {
+                        name: {
+                            type: string;
+                        };
+                        description: {
+                            type: string;
+                        };
+                        version: {
+                            type: string;
+                        };
+                        price_mist: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+            };
+            endpoint: {
+                type: string;
+                description: string;
+            };
+            stake_id: {
+                type: string;
+                description: string;
+            };
+            region: {
+                type: string;
+                description: string;
+            };
+            routing_fee_bps: {
+                type: string;
+                description: string;
+            };
+            capabilities: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+            };
+            amount_sui: {
+                type: string;
+                description: string;
+            };
+            stake_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+
+declare function registerResourceHandlers(server: Server, context: MeshToolContext): void;
+
+interface MeshMultiExecuteParams {
+    capability: string;
+    input: unknown;
+    fanOutCount?: number;
+    strategy?: ProviderSelectionStrategy | `${ProviderSelectionStrategy}`;
+    aggregation?: AggregationMode | `${AggregationMode}`;
+    timeout?: number;
+    maxPricePerProvider?: number;
+}
+declare const meshMultiExecuteTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            capability: {
+                type: string;
+                description: string;
+            };
+            input: {
+                description: string;
+            };
+            fanOutCount: {
+                type: string;
+                description: string;
+            };
+            strategy: {
+                type: string;
+                enum: ProviderSelectionStrategy[];
+                description: string;
+            };
+            aggregation: {
+                type: string;
+                enum: AggregationMode[];
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+            };
+            maxPricePerProvider: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+interface MeshMultiExecuteResult {
+    capability: string;
+    strategy: ProviderSelectionStrategy;
+    aggregation: AggregationMode;
+    providers: Array<{
+        did: string;
+        price_mist: string;
+        reputation: number;
+        estimated_latency_ms?: number;
+        composite_score: number;
+    }>;
+    results: Array<{
+        provider: string;
+        status: 'success' | 'failure' | 'timeout';
+        result?: unknown;
+        duration_ms: number;
+        error?: string;
+    }>;
+    aggregated_result?: unknown;
+    total_cost_mist: string;
+}
+declare function runMeshMultiExecute(params: MeshMultiExecuteParams, context: MeshToolContext): Promise<MeshMultiExecuteResult>;
+
+interface MeshMeteredExecuteParams {
+    capability: string;
+    provider_did?: string;
+    input: string;
+    max_price_mist: number;
+    unit_price_mist: number;
+    timeout_seconds?: number;
+}
+interface MeshVerifyResultParams {
+    task_id: string;
+}
+declare const meshMeteredExecuteTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            capability: {
+                type: string;
+                description: string;
+            };
+            provider_did: {
+                type: string;
+                description: string;
+            };
+            input: {
+                type: string;
+                description: string;
+            };
+            max_price_mist: {
+                type: string;
+                description: string;
+            };
+            unit_price_mist: {
+                type: string;
+                description: string;
+            };
+            timeout_seconds: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare const meshVerifyResultTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            task_id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+declare function runMeshMeteredExecute(params: MeshMeteredExecuteParams, context: MeshToolContext): Promise<{
+    task_id: string;
+    provider_did: string;
+    result: string;
+    status: string;
+    payment_rail: PaymentRail;
+    payment_scheme: PaymentScheme.UPTO;
+    max_price_mist: string;
+    actual_price_mist: string;
+    unit_price_mist: string;
+    metered_units: number;
+    verification_hash: string;
+    verified: boolean;
+}>;
+declare function runMeshVerifyResult(params: MeshVerifyResultParams, context: MeshToolContext): Promise<{
+    task_id: string;
+    verified: boolean;
+    verification_hash: string;
+    metered_units: number;
+    result: string;
+}>;
+
+declare function registerMeshTools(server: Server, context: MeshToolContext): void;
+declare function createMeshMcpServer(context: MeshToolContext): Server;
+
+export { type MeshMeteredExecuteParams, type MeshMultiExecuteParams, type MeshMultiExecuteResult, type MeshToolContext, type MeshToolHandler, type MeshVerifyResultParams, createMeshMcpServer, meshMeteredExecuteTool, meshMultiExecuteTool, meshToolDefinitions, meshToolHandlers, meshVerifyResultTool, registerMeshTools, registerResourceHandlers, runMeshMeteredExecute, runMeshMultiExecute, runMeshVerifyResult };