promptspeak-mcp-server 0.1.0

package/dist/swarm/tools.d.ts

@@ -0,0 +1,451 @@
+/**
+ * Swarm MCP Tool Definitions
+ *
+ * Exposes swarm functionality through the MCP protocol.
+ * These tools allow LLM agents to create and manage market swarms.
+ */
+import { z } from 'zod';
+import type { BiddingStrategy } from './types.js';
+export declare const SwarmCreateSchema: z.ZodObject<{
+    totalBudget: z.ZodNumber;
+    agentCount: z.ZodOptional<z.ZodNumber>;
+    searchTerms: z.ZodArray<z.ZodString, "many">;
+    maxPricePerItem: z.ZodOptional<z.ZodNumber>;
+    minPricePerItem: z.ZodOptional<z.ZodNumber>;
+    conditions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    durationHours: z.ZodOptional<z.ZodNumber>;
+    strategyDistribution: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    totalBudget: number;
+    searchTerms: string[];
+    agentCount?: number | undefined;
+    strategyDistribution?: Record<string, number> | undefined;
+    maxPricePerItem?: number | undefined;
+    minPricePerItem?: number | undefined;
+    conditions?: string[] | undefined;
+    durationHours?: number | undefined;
+}, {
+    totalBudget: number;
+    searchTerms: string[];
+    agentCount?: number | undefined;
+    strategyDistribution?: Record<string, number> | undefined;
+    maxPricePerItem?: number | undefined;
+    minPricePerItem?: number | undefined;
+    conditions?: string[] | undefined;
+    durationHours?: number | undefined;
+}>;
+export declare const SwarmStatusSchema: z.ZodObject<{
+    swarmId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    swarmId: string;
+}, {
+    swarmId: string;
+}>;
+export declare const SwarmAgentStatusSchema: z.ZodObject<{
+    swarmId: z.ZodString;
+    agentId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    agentId: string;
+    swarmId: string;
+}, {
+    agentId: string;
+    swarmId: string;
+}>;
+export declare const SwarmReallocateSchema: z.ZodObject<{
+    swarmId: z.ZodString;
+    fromAgentId: z.ZodString;
+    toAgentId: z.ZodString;
+    amount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    amount: number;
+    swarmId: string;
+    fromAgentId: string;
+    toAgentId: string;
+}, {
+    amount: number;
+    swarmId: string;
+    fromAgentId: string;
+    toAgentId: string;
+}>;
+export declare const SwarmEventsSchema: z.ZodObject<{
+    swarmId: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    eventTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    agentId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    swarmId: string;
+    limit?: number | undefined;
+    agentId?: string | undefined;
+    eventTypes?: string[] | undefined;
+}, {
+    swarmId: string;
+    limit?: number | undefined;
+    agentId?: string | undefined;
+    eventTypes?: string[] | undefined;
+}>;
+export declare const swarmTools: {
+    ps_swarm_create: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{
+            totalBudget: z.ZodNumber;
+            agentCount: z.ZodOptional<z.ZodNumber>;
+            searchTerms: z.ZodArray<z.ZodString, "many">;
+            maxPricePerItem: z.ZodOptional<z.ZodNumber>;
+            minPricePerItem: z.ZodOptional<z.ZodNumber>;
+            conditions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            durationHours: z.ZodOptional<z.ZodNumber>;
+            strategyDistribution: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            totalBudget: number;
+            searchTerms: string[];
+            agentCount?: number | undefined;
+            strategyDistribution?: Record<string, number> | undefined;
+            maxPricePerItem?: number | undefined;
+            minPricePerItem?: number | undefined;
+            conditions?: string[] | undefined;
+            durationHours?: number | undefined;
+        }, {
+            totalBudget: number;
+            searchTerms: string[];
+            agentCount?: number | undefined;
+            strategyDistribution?: Record<string, number> | undefined;
+            maxPricePerItem?: number | undefined;
+            minPricePerItem?: number | undefined;
+            conditions?: string[] | undefined;
+            durationHours?: number | undefined;
+        }>;
+        handler: (input: z.infer<typeof SwarmCreateSchema>) => Promise<{
+            success: boolean;
+            swarmId: string;
+            message: string;
+            strategyDistribution: {
+                [k: string]: number;
+            };
+        }>;
+    };
+    ps_swarm_start: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            success: boolean;
+            message: string;
+        }>;
+    };
+    ps_swarm_pause: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            success: boolean;
+            message: string;
+        }>;
+    };
+    ps_swarm_terminate: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{
+            reason: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            reason?: string | undefined;
+        }, {
+            reason?: string | undefined;
+        }>;
+        handler: (input: {
+            reason?: string;
+        }) => Promise<{
+            success: boolean;
+            message: string;
+        }>;
+    };
+    ps_swarm_status: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        handler: () => Promise<{
+            success: boolean;
+            error: string;
+            status?: undefined;
+            agents?: undefined;
+        } | {
+            success: boolean;
+            status: {
+                swarmId: string;
+                status: import("./types.js").SwarmStatus;
+                activeAgents: number;
+                budget: {
+                    total: number;
+                    spent: number;
+                    available: number;
+                    currency: import("./types.js").Currency;
+                };
+                activity: {
+                    totalBids: number;
+                    totalOffers: number;
+                    wonAuctions: number;
+                    acceptedOffers: number;
+                    itemsAcquired: number;
+                };
+                timeRemaining: string;
+                lastActivity: Date | undefined;
+            };
+            agents: {
+                agentId: string;
+                strategy: BiddingStrategy;
+                status: string;
+                budget: number;
+                spent: number;
+                wins: number;
+                losses: number;
+            }[];
+            error?: undefined;
+        }>;
+    };
+    ps_swarm_agent_status: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{
+            swarmId: z.ZodString;
+            agentId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            agentId: string;
+            swarmId: string;
+        }, {
+            agentId: string;
+            swarmId: string;
+        }>;
+        handler: (input: z.infer<typeof SwarmAgentStatusSchema>) => Promise<{
+            success: boolean;
+            error: string;
+            agent?: undefined;
+        } | {
+            success: boolean;
+            agent: {
+                agentId: string;
+                status: import("./types.js").MarketAgentStatus;
+                budget: {
+                    remaining: number;
+                    spent: number;
+                    currency: import("./types.js").Currency;
+                };
+                activity: {
+                    activeBids: number;
+                    activeOffers: number;
+                    wins: number;
+                    losses: number;
+                };
+                activeBids: import("./types.js").ActiveBid[];
+                activeOffers: import("./types.js").ActiveOffer[];
+            };
+            error?: undefined;
+        }>;
+    };
+    ps_swarm_reallocate_budget: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{
+            swarmId: z.ZodString;
+            fromAgentId: z.ZodString;
+            toAgentId: z.ZodString;
+            amount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            amount: number;
+            swarmId: string;
+            fromAgentId: string;
+            toAgentId: string;
+        }, {
+            amount: number;
+            swarmId: string;
+            fromAgentId: string;
+            toAgentId: string;
+        }>;
+        handler: (input: z.infer<typeof SwarmReallocateSchema>) => Promise<{
+            success: boolean;
+            error: string;
+            note: string;
+        }>;
+    };
+    ps_swarm_insights: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{
+            swarmId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            swarmId: string;
+        }, {
+            swarmId: string;
+        }>;
+        handler: (input: {
+            swarmId: string;
+        }) => Promise<{
+            success: boolean;
+            insights: {
+                strategyRanking: {
+                    symbol: string;
+                    rankings: {
+                        strategy: BiddingStrategy;
+                        successRate: number;
+                        costEfficiency: number;
+                        overallScore: number;
+                    }[];
+                    computedAt: Date;
+                };
+                costEfficiency: {
+                    symbol: string;
+                    totalSpent: number;
+                    itemsAcquired: number;
+                    avgCostPerItem: number;
+                    computedAt: Date;
+                };
+                concentrationRisk: {
+                    symbol: string;
+                    riskLevel: "HIGH" | "MEDIUM" | "LOW" | "CRITICAL";
+                    hhi: number;
+                    recommendation: string;
+                    computedAt: Date;
+                };
+                dataIntegrity: {
+                    hasAnomalies: boolean;
+                    severity: "HIGH" | "MEDIUM" | "LOW" | "NONE";
+                    patterns: string[];
+                };
+                performance: Record<string, unknown>;
+            };
+            error?: undefined;
+        } | {
+            success: boolean;
+            error: string;
+            insights?: undefined;
+        }>;
+    };
+    ps_swarm_events: {
+        name: string;
+        description: string;
+        inputSchema: z.ZodObject<{
+            swarmId: z.ZodString;
+            limit: z.ZodOptional<z.ZodNumber>;
+            eventTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            agentId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            swarmId: string;
+            limit?: number | undefined;
+            agentId?: string | undefined;
+            eventTypes?: string[] | undefined;
+        }, {
+            swarmId: string;
+            limit?: number | undefined;
+            agentId?: string | undefined;
+            eventTypes?: string[] | undefined;
+        }>;
+        handler: (input: z.infer<typeof SwarmEventsSchema>) => Promise<{
+            success: boolean;
+            count: number;
+            events: {
+                eventId: string;
+                type: import("./types.js").SwarmEventType;
+                agentId: string | undefined;
+                timestamp: string | Date;
+                data: Record<string, unknown>;
+            }[];
+        }>;
+    };
+};
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Swarm tool definitions in MCP Tool[] format.
+ * Used by the central registry for tool listing.
+ */
+export declare const swarmToolDefinitions: Tool[];
+/**
+ * Get all swarm tool definitions for MCP registration.
+ * @deprecated Use swarmToolDefinitions directly
+ */
+export declare function getSwarmToolDefinitions(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        totalBudget: z.ZodNumber;
+        agentCount: z.ZodOptional<z.ZodNumber>;
+        searchTerms: z.ZodArray<z.ZodString, "many">;
+        maxPricePerItem: z.ZodOptional<z.ZodNumber>;
+        minPricePerItem: z.ZodOptional<z.ZodNumber>;
+        conditions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        durationHours: z.ZodOptional<z.ZodNumber>;
+        strategyDistribution: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        totalBudget: number;
+        searchTerms: string[];
+        agentCount?: number | undefined;
+        strategyDistribution?: Record<string, number> | undefined;
+        maxPricePerItem?: number | undefined;
+        minPricePerItem?: number | undefined;
+        conditions?: string[] | undefined;
+        durationHours?: number | undefined;
+    }, {
+        totalBudget: number;
+        searchTerms: string[];
+        agentCount?: number | undefined;
+        strategyDistribution?: Record<string, number> | undefined;
+        maxPricePerItem?: number | undefined;
+        minPricePerItem?: number | undefined;
+        conditions?: string[] | undefined;
+        durationHours?: number | undefined;
+    }> | z.ZodObject<{
+        swarmId: z.ZodString;
+        agentId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        agentId: string;
+        swarmId: string;
+    }, {
+        agentId: string;
+        swarmId: string;
+    }> | z.ZodObject<{
+        swarmId: z.ZodString;
+        fromAgentId: z.ZodString;
+        toAgentId: z.ZodString;
+        amount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        amount: number;
+        swarmId: string;
+        fromAgentId: string;
+        toAgentId: string;
+    }, {
+        amount: number;
+        swarmId: string;
+        fromAgentId: string;
+        toAgentId: string;
+    }> | z.ZodObject<{
+        swarmId: z.ZodString;
+        limit: z.ZodOptional<z.ZodNumber>;
+        eventTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        agentId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        swarmId: string;
+        limit?: number | undefined;
+        agentId?: string | undefined;
+        eventTypes?: string[] | undefined;
+    }, {
+        swarmId: string;
+        limit?: number | undefined;
+        agentId?: string | undefined;
+        eventTypes?: string[] | undefined;
+    }> | z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}> | z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}> | z.ZodObject<{
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason?: string | undefined;
+    }, {
+        reason?: string | undefined;
+    }> | z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}> | z.ZodObject<{
+        swarmId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        swarmId: string;
+    }, {
+        swarmId: string;
+    }>;
+}[];
+/**
+ * Execute a swarm tool by name.
+ */
+export declare function executeSwarmTool(toolName: string, input: unknown): Promise<unknown>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/swarm/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/swarm/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AAMH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAiBI,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAsFjC;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA+DnB,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAyCtC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;;;;;;;;;;;yBAyBrC;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA0DnB,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;;;;;;;CAsB3D,CAAC;AAMF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,IAAI,EA+FtC,CAAC;AAMF;;;GAGG;AACH,wBAAgB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMtC;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAYlB"}