@pgnio/helios-mcp 0.2.5 → 0.2.6

package/dist/cli.js

@@ -273,7 +273,8 @@ var marketSnapshotChunkSchema = import_zod.z.object({
   legend: import_zod.z.record(import_zod.z.string(), import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.string())]))
 });
 var marketSymbolDetailInputSchema = import_zod.z.object({
-  symbol: import_zod.z.string().min(1)
+  symbol: import_zod.z.string().min(1),
+  full: import_zod.z.boolean().optional().describe("true adds every raw indicator and the price history (large, ~25 KB). Omit for the compact row and market context.")
 });
 var marketSymbolDetailSchema = import_zod.z.object({
   schema: import_zod.z.literal("helios.market_symbol_detail.v1"),
@@ -1469,6 +1470,10 @@ function topOfSnapshot(snapshot, input, top = DEFAULT_SNAPSHOT_TOP) {
   const returnedSymbols = baseIndex === -1 ? snapshot.returnedSymbols.slice(0, top) : rows.map((row) => String(row[baseIndex]));
   return { ...snapshot, symbolCount: rows.length, returnedSymbols, table: { ...snapshot.table, rows } };
 }
+function compactSymbolDetail(detail, full) {
+  if (full) return detail;
+  return { ...detail, changeMap: {}, metrics: null };
+}
 var HeliosAgentMcpMarketService = class {
   constructor(options) {
     __publicField(this, "authService");
@@ -1573,7 +1578,7 @@ var HeliosAgentMcpMarketService = class {
     }
     const session = await this.authService.requireSession();
     try {
-      const detail = await this.dataBridgeClient.getMarketSymbolDetail(session.accessToken, input);
+      const detail = compactSymbolDetail(await this.dataBridgeClient.getMarketSymbolDetail(session.accessToken, { symbol: input.symbol }), input.full);
       return {
         status: "connected",
         connected: true,
@@ -1585,7 +1590,7 @@ var HeliosAgentMcpMarketService = class {
         error,
         loginOptions,
         retry: async (accessToken) => {
-          const detail = await this.dataBridgeClient.getMarketSymbolDetail(accessToken, input);
+          const detail = compactSymbolDetail(await this.dataBridgeClient.getMarketSymbolDetail(accessToken, { symbol: input.symbol }), input.full);
           return {
             status: "connected",
             connected: true,
@@ -2657,7 +2662,7 @@ function createHeliosMarketToolDefinitions(service) {
     {
       name: "helios_market_get_symbol_detail",
       title: "Get Helios Symbol Detail",
-      description: "Returns expanded market detail for one symbol from the current Helios market snapshot.",
+      description: "Returns one coin: every snapshot column plus Hyperliquid context (funding, open interest, max leverage, mark price). For several coins, use helios_market_get_snapshot with symbols instead; pass full only when you need raw indicators.",
       inputSchema: marketSymbolDetailInputSchema,
       async execute(input) {
         const result = marketSymbolDetailToolOutputSchema.parse(await service.getSymbolDetail(input));
@@ -2881,7 +2886,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.5"
+    version: "0.2.6"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   createHeliosAgentMcpServer
-} from "./chunk-7EDI4KLD.mjs";
+} from "./chunk-WLCFIWFP.mjs";
 
 // src/cli.ts
 async function main() {

package/dist/index.d.mts

@@ -287,6 +287,7 @@ declare const marketSnapshotChunkSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const marketSymbolDetailInputSchema: z.ZodObject<{
     symbol: z.ZodString;
+    full: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const marketSymbolDetailSchema: z.ZodObject<{
     schema: z.ZodLiteral<"helios.market_symbol_detail.v1">;
@@ -964,6 +965,11 @@ declare const DEFAULT_SNAPSHOT_FIELDS: readonly string[];
 declare function withSnapshotDefaults<T extends MarketSnapshotInput>(input: T): T;
 /** A ranked snapshot cut to its top coins, unless the agent named its symbols. */
 declare function topOfSnapshot(snapshot: MarketSnapshot, input: MarketSnapshotInput, top?: number): MarketSnapshot;
+/**
+ * A symbol detail without the raw indicator objects and price history unless the agent asked for `full`. Those are
+ * ~25 KB a coin; the row already carries every snapshot column, and changeMap repeats the row's returns.
+ */
+declare function compactSymbolDetail(detail: MarketSymbolDetail, full: boolean | undefined): MarketSymbolDetail;
 declare class HeliosAgentMcpMarketService {
     private readonly authService;
     private readonly dataBridgeClient;
@@ -1568,9 +1574,11 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
     description: string;
     inputSchema: z.ZodObject<{
         symbol: z.ZodString;
+        full: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     execute(input: {
         symbol: string;
+        full?: boolean | undefined;
     }): Promise<{
         content: {
             type: "text";
@@ -2178,4 +2186,4 @@ declare function createHeliosTradingToolDefinitions(service: HeliosAgentMcpTradi
     }>;
 }];
 
-export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, DEFAULT_SNAPSHOT_FIELDS, DEFAULT_SNAPSHOT_TOP, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, topOfSnapshot, withDataText, withSnapshotDefaults };
+export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, DEFAULT_SNAPSHOT_FIELDS, DEFAULT_SNAPSHOT_TOP, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, compactSymbolDetail, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, topOfSnapshot, withDataText, withSnapshotDefaults };

package/dist/index.d.ts

@@ -287,6 +287,7 @@ declare const marketSnapshotChunkSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const marketSymbolDetailInputSchema: z.ZodObject<{
     symbol: z.ZodString;
+    full: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 declare const marketSymbolDetailSchema: z.ZodObject<{
     schema: z.ZodLiteral<"helios.market_symbol_detail.v1">;
@@ -964,6 +965,11 @@ declare const DEFAULT_SNAPSHOT_FIELDS: readonly string[];
 declare function withSnapshotDefaults<T extends MarketSnapshotInput>(input: T): T;
 /** A ranked snapshot cut to its top coins, unless the agent named its symbols. */
 declare function topOfSnapshot(snapshot: MarketSnapshot, input: MarketSnapshotInput, top?: number): MarketSnapshot;
+/**
+ * A symbol detail without the raw indicator objects and price history unless the agent asked for `full`. Those are
+ * ~25 KB a coin; the row already carries every snapshot column, and changeMap repeats the row's returns.
+ */
+declare function compactSymbolDetail(detail: MarketSymbolDetail, full: boolean | undefined): MarketSymbolDetail;
 declare class HeliosAgentMcpMarketService {
     private readonly authService;
     private readonly dataBridgeClient;
@@ -1568,9 +1574,11 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
     description: string;
     inputSchema: z.ZodObject<{
         symbol: z.ZodString;
+        full: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     execute(input: {
         symbol: string;
+        full?: boolean | undefined;
     }): Promise<{
         content: {
             type: "text";
@@ -2178,4 +2186,4 @@ declare function createHeliosTradingToolDefinitions(service: HeliosAgentMcpTradi
     }>;
 }];
 
-export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, DEFAULT_SNAPSHOT_FIELDS, DEFAULT_SNAPSHOT_TOP, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, topOfSnapshot, withDataText, withSnapshotDefaults };
+export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, DEFAULT_SNAPSHOT_FIELDS, DEFAULT_SNAPSHOT_TOP, type DeleteTpSlToolResult, type EnsureLoginOptions, type EnsureLoginResult, FileAgentSessionStore, type GetHeliosAgentMcpDocumentInput, HOSTED_RECONNECT_MESSAGE, HeliosAgentMcpAccountService, type HeliosAgentMcpAccountServiceOptions, HeliosAgentMcpAuthService, type HeliosAgentMcpAuthServiceOptions, type HeliosAgentMcpDocsIndex, type HeliosAgentMcpDocsIndexEntry, HeliosAgentMcpDocsService, type HeliosAgentMcpDocsServiceOptions, type HeliosAgentMcpDocument, HeliosAgentMcpLedgerService, type HeliosAgentMcpLedgerServiceOptions, HeliosAgentMcpMarketService, type HeliosAgentMcpMarketServiceOptions, HeliosAgentMcpProviderService, type HeliosAgentMcpProviderServiceOptions, HeliosAgentMcpTradingService, type HeliosAgentMcpTradingServiceOptions, type HeliosMcpToolDefinition, type HeliosMcpToolResult, type LedgerFillsResult, type LedgerSummaryResult, type MarketSnapshotChunkResult, type MarketSnapshotResult, type MarketSymbolDetailResult, MemoryAgentMcpSessionStore, type OpenOrdersToolResult, type OpenPositionsResult, type PendingAgentLogin, type PendingLoginResult, type PollLoginResult, type PortfolioResult, type SetTpSlToolResult, type StartLoginResult, type TradeIntentAction, type TradeIntentActionInput, type TradeIntentActionResult, type WalletStateResult, compactSymbolDetail, createHeliosAccountToolDefinitions, createHeliosAgentMcpServer, createHeliosAuthToolDefinitions, createHeliosDocsToolDefinitions, createHeliosLedgerToolDefinitions, createHeliosMarketToolDefinitions, createHeliosProviderToolDefinitions, createHeliosTradingToolDefinitions, formatHeliosLoginPrompt, getDefaultHeliosAgentMcpDocsRoot, getDefaultHeliosAgentMcpSessionPath, pendingAgentLoginSchema, retryAfterUnauthorizedRefresh, toolAnnotations, topOfSnapshot, withDataText, withSnapshotDefaults };

package/dist/index.js

@@ -44,6 +44,7 @@ __export(index_exports, {
   HeliosAgentMcpProviderService: () => HeliosAgentMcpProviderService,
   HeliosAgentMcpTradingService: () => HeliosAgentMcpTradingService,
   MemoryAgentMcpSessionStore: () => MemoryAgentMcpSessionStore,
+  compactSymbolDetail: () => compactSymbolDetail,
   createHeliosAccountToolDefinitions: () => createHeliosAccountToolDefinitions,
   createHeliosAgentMcpServer: () => createHeliosAgentMcpServer,
   createHeliosAuthToolDefinitions: () => createHeliosAuthToolDefinitions,
@@ -312,7 +313,8 @@ var marketSnapshotChunkSchema = import_zod.z.object({
   legend: import_zod.z.record(import_zod.z.string(), import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.string())]))
 });
 var marketSymbolDetailInputSchema = import_zod.z.object({
-  symbol: import_zod.z.string().min(1)
+  symbol: import_zod.z.string().min(1),
+  full: import_zod.z.boolean().optional().describe("true adds every raw indicator and the price history (large, ~25 KB). Omit for the compact row and market context.")
 });
 var marketSymbolDetailSchema = import_zod.z.object({
   schema: import_zod.z.literal("helios.market_symbol_detail.v1"),
@@ -1508,6 +1510,10 @@ function topOfSnapshot(snapshot, input, top = DEFAULT_SNAPSHOT_TOP) {
   const returnedSymbols = baseIndex === -1 ? snapshot.returnedSymbols.slice(0, top) : rows.map((row) => String(row[baseIndex]));
   return { ...snapshot, symbolCount: rows.length, returnedSymbols, table: { ...snapshot.table, rows } };
 }
+function compactSymbolDetail(detail, full) {
+  if (full) return detail;
+  return { ...detail, changeMap: {}, metrics: null };
+}
 var HeliosAgentMcpMarketService = class {
   constructor(options) {
     __publicField(this, "authService");
@@ -1612,7 +1618,7 @@ var HeliosAgentMcpMarketService = class {
     }
     const session = await this.authService.requireSession();
     try {
-      const detail = await this.dataBridgeClient.getMarketSymbolDetail(session.accessToken, input);
+      const detail = compactSymbolDetail(await this.dataBridgeClient.getMarketSymbolDetail(session.accessToken, { symbol: input.symbol }), input.full);
       return {
         status: "connected",
         connected: true,
@@ -1624,7 +1630,7 @@ var HeliosAgentMcpMarketService = class {
         error,
         loginOptions,
         retry: async (accessToken) => {
-          const detail = await this.dataBridgeClient.getMarketSymbolDetail(accessToken, input);
+          const detail = compactSymbolDetail(await this.dataBridgeClient.getMarketSymbolDetail(accessToken, { symbol: input.symbol }), input.full);
           return {
             status: "connected",
             connected: true,
@@ -2730,7 +2736,7 @@ function createHeliosMarketToolDefinitions(service) {
     {
       name: "helios_market_get_symbol_detail",
       title: "Get Helios Symbol Detail",
-      description: "Returns expanded market detail for one symbol from the current Helios market snapshot.",
+      description: "Returns one coin: every snapshot column plus Hyperliquid context (funding, open interest, max leverage, mark price). For several coins, use helios_market_get_snapshot with symbols instead; pass full only when you need raw indicators.",
       inputSchema: marketSymbolDetailInputSchema,
       async execute(input) {
         const result = marketSymbolDetailToolOutputSchema.parse(await service.getSymbolDetail(input));
@@ -2954,7 +2960,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.5"
+    version: "0.2.6"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({
@@ -3084,6 +3090,7 @@ function registerTool(server, tool) {
   HeliosAgentMcpProviderService,
   HeliosAgentMcpTradingService,
   MemoryAgentMcpSessionStore,
+  compactSymbolDetail,
   createHeliosAccountToolDefinitions,
   createHeliosAgentMcpServer,
   createHeliosAuthToolDefinitions,

package/dist/index.mjs

@@ -11,6 +11,7 @@ import {
   HeliosAgentMcpProviderService,
   HeliosAgentMcpTradingService,
   MemoryAgentMcpSessionStore,
+  compactSymbolDetail,
   createHeliosAccountToolDefinitions,
   createHeliosAgentMcpServer,
   createHeliosAuthToolDefinitions,
@@ -28,7 +29,7 @@ import {
   topOfSnapshot,
   withDataText,
   withSnapshotDefaults
-} from "./chunk-7EDI4KLD.mjs";
+} from "./chunk-WLCFIWFP.mjs";
 export {
   DEFAULT_SNAPSHOT_FIELDS,
   DEFAULT_SNAPSHOT_TOP,
@@ -42,6 +43,7 @@ export {
   HeliosAgentMcpProviderService,
   HeliosAgentMcpTradingService,
   MemoryAgentMcpSessionStore,
+  compactSymbolDetail,
   createHeliosAccountToolDefinitions,
   createHeliosAgentMcpServer,
   createHeliosAuthToolDefinitions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgnio/helios-mcp",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Helios MCP server: connect an AI agent to your Helios account to read markets and your portfolio and to trade on Hyperliquid. Most apps can use the hosted URL https://helios.pgn.io/mcp instead.",
   "license": "UNLICENSED",
   "homepage": "https://helios.pgn.io/?connect=ai",