@pgnio/helios-mcp 0.2.1 → 0.2.3

package/dist/cli.js

@@ -220,7 +220,9 @@ var marketSnapshotResolvedScopeSchema = import_zod.z.enum(["selected", "all", "e
 var marketSnapshotValueSchema = import_zod.z.union([import_zod.z.string(), import_zod.z.number(), import_zod.z.boolean(), import_zod.z.null()]);
 var marketSnapshotInputSchema = import_zod.z.object({
   scope: marketSnapshotScopeSchema.optional(),
-  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional()
+  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional(),
+  fields: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional().describe('Table columns to return, e.g. ["lp","r1h","r24h","hmi","reg","hs"]; sym and base always come back. Omit for all columns.'),
+  sort: import_zod.z.enum(["rank"]).optional().describe('"rank" orders rows by market cap rank, unranked last.')
 });
 var marketSnapshotChunkInputSchema = marketSnapshotInputSchema.extend({
   offset: import_zod.z.number().int().nonnegative().optional(),
@@ -2567,7 +2569,7 @@ function createHeliosMarketToolDefinitions(service) {
     {
       name: "helios_market_get_snapshot",
       title: "Get Helios Market Snapshot",
-      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols.",
+      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols. The full table is large; pass fields to get only the columns you need.",
       inputSchema: marketSnapshotInputSchema,
       async execute(input) {
         const result = marketSnapshotToolOutputSchema.parse(await service.getSnapshot(input));
@@ -2835,7 +2837,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.1"
+    version: "0.2.3"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({
@@ -2928,6 +2930,11 @@ function toolAnnotations(name) {
   if (CHANGES_SESSION.test(name)) return { readOnlyHint: false, destructiveHint: false, openWorldHint: false };
   return { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 }
+var TEXT_IS_RESULT = /* @__PURE__ */ new Set(["helios_docs_get_document"]);
+function withDataText(name, content, structuredContent) {
+  if (TEXT_IS_RESULT.has(name)) return content;
+  return [...content, { type: "text", text: JSON.stringify(structuredContent) }];
+}
 function registerTool(server, tool) {
   server.registerTool(
     tool.name,
@@ -2940,7 +2947,7 @@ function registerTool(server, tool) {
     async (input) => {
       const result = await tool.execute(tool.inputSchema.parse(input));
       return {
-        ...result,
+        content: withDataText(tool.name, result.content, result.structuredContent),
         structuredContent: result.structuredContent
       };
     }

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -206,6 +206,10 @@ declare const marketSnapshotInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
 }, z.core.$strip>;
 declare const marketSnapshotChunkInputSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodEnum<{
@@ -213,6 +217,10 @@ declare const marketSnapshotChunkInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -1042,6 +1050,18 @@ declare function toolAnnotations(name: string): {
     destructiveHint: boolean;
     openWorldHint: boolean;
 };
+/**
+ * The tool's text plus its data as JSON. Many AI apps (Qwen Code, Cursor, older clients) only hand the model the text
+ * content and drop structuredContent, so without this the agent sees the one-line summary and none of the data. The
+ * MCP spec asks servers to send the JSON as text alongside structured results for exactly this reason.
+ */
+declare function withDataText(name: string, content: Array<{
+    type: 'text';
+    text: string;
+}>, structuredContent: object): Array<{
+    type: 'text';
+    text: string;
+}>;
 
 interface HeliosMcpToolResult<TStructuredContent extends object> {
     content: Array<{
@@ -1445,10 +1465,16 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
     }): Promise<{
         content: {
             type: "text";
@@ -1485,12 +1511,18 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
         offset: z.ZodOptional<z.ZodNumber>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
         offset?: number | undefined;
         limit?: number | undefined;
     }): Promise<{
@@ -2135,4 +2167,4 @@ declare function createHeliosTradingToolDefinitions(service: HeliosAgentMcpTradi
     }>;
 }];
 
-export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, 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 };
+export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, 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, withDataText };

package/dist/index.d.ts

@@ -206,6 +206,10 @@ declare const marketSnapshotInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
 }, z.core.$strip>;
 declare const marketSnapshotChunkInputSchema: z.ZodObject<{
     scope: z.ZodOptional<z.ZodEnum<{
@@ -213,6 +217,10 @@ declare const marketSnapshotChunkInputSchema: z.ZodObject<{
         all: "all";
     }>>;
     symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        rank: "rank";
+    }>>;
     offset: z.ZodOptional<z.ZodNumber>;
     limit: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -1042,6 +1050,18 @@ declare function toolAnnotations(name: string): {
     destructiveHint: boolean;
     openWorldHint: boolean;
 };
+/**
+ * The tool's text plus its data as JSON. Many AI apps (Qwen Code, Cursor, older clients) only hand the model the text
+ * content and drop structuredContent, so without this the agent sees the one-line summary and none of the data. The
+ * MCP spec asks servers to send the JSON as text alongside structured results for exactly this reason.
+ */
+declare function withDataText(name: string, content: Array<{
+    type: 'text';
+    text: string;
+}>, structuredContent: object): Array<{
+    type: 'text';
+    text: string;
+}>;
 
 interface HeliosMcpToolResult<TStructuredContent extends object> {
     content: Array<{
@@ -1445,10 +1465,16 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
     }): Promise<{
         content: {
             type: "text";
@@ -1485,12 +1511,18 @@ declare function createHeliosMarketToolDefinitions(service: HeliosAgentMcpMarket
             all: "all";
         }>>;
         symbols: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        sort: z.ZodOptional<z.ZodEnum<{
+            rank: "rank";
+        }>>;
         offset: z.ZodOptional<z.ZodNumber>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     execute(input: {
         scope?: "selected" | "all" | undefined;
         symbols?: string[] | undefined;
+        fields?: string[] | undefined;
+        sort?: "rank" | undefined;
         offset?: number | undefined;
         limit?: number | undefined;
     }): Promise<{
@@ -2135,4 +2167,4 @@ declare function createHeliosTradingToolDefinitions(service: HeliosAgentMcpTradi
     }>;
 }];
 
-export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, 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 };
+export { type ActiveProviderView, type AgentMcpSessionStore, type CancelOrderToolResult, type ClosePositionToolResult, type CreateHeliosAgentMcpServerOptions, 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, withDataText };

package/dist/index.js

@@ -55,7 +55,8 @@ __export(index_exports, {
   getDefaultHeliosAgentMcpSessionPath: () => getDefaultHeliosAgentMcpSessionPath,
   pendingAgentLoginSchema: () => pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh: () => retryAfterUnauthorizedRefresh,
-  toolAnnotations: () => toolAnnotations
+  toolAnnotations: () => toolAnnotations,
+  withDataText: () => withDataText
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -254,7 +255,9 @@ var marketSnapshotResolvedScopeSchema = import_zod.z.enum(["selected", "all", "e
 var marketSnapshotValueSchema = import_zod.z.union([import_zod.z.string(), import_zod.z.number(), import_zod.z.boolean(), import_zod.z.null()]);
 var marketSnapshotInputSchema = import_zod.z.object({
   scope: marketSnapshotScopeSchema.optional(),
-  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional()
+  symbols: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional(),
+  fields: import_zod.z.array(import_zod.z.string().min(1)).min(1).optional().describe('Table columns to return, e.g. ["lp","r1h","r24h","hmi","reg","hs"]; sym and base always come back. Omit for all columns.'),
+  sort: import_zod.z.enum(["rank"]).optional().describe('"rank" orders rows by market cap rank, unranked last.')
 });
 var marketSnapshotChunkInputSchema = marketSnapshotInputSchema.extend({
   offset: import_zod.z.number().int().nonnegative().optional(),
@@ -2635,7 +2638,7 @@ function createHeliosMarketToolDefinitions(service) {
     {
       name: "helios_market_get_snapshot",
       title: "Get Helios Market Snapshot",
-      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols.",
+      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols. The full table is large; pass fields to get only the columns you need.",
       inputSchema: marketSnapshotInputSchema,
       async execute(input) {
         const result = marketSnapshotToolOutputSchema.parse(await service.getSnapshot(input));
@@ -2903,7 +2906,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.1"
+    version: "0.2.3"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({
@@ -2996,6 +2999,11 @@ function toolAnnotations(name) {
   if (CHANGES_SESSION.test(name)) return { readOnlyHint: false, destructiveHint: false, openWorldHint: false };
   return { readOnlyHint: true, destructiveHint: false, openWorldHint: true };
 }
+var TEXT_IS_RESULT = /* @__PURE__ */ new Set(["helios_docs_get_document"]);
+function withDataText(name, content, structuredContent) {
+  if (TEXT_IS_RESULT.has(name)) return content;
+  return [...content, { type: "text", text: JSON.stringify(structuredContent) }];
+}
 function registerTool(server, tool) {
   server.registerTool(
     tool.name,
@@ -3008,7 +3016,7 @@ function registerTool(server, tool) {
     async (input) => {
       const result = await tool.execute(tool.inputSchema.parse(input));
       return {
-        ...result,
+        content: withDataText(tool.name, result.content, result.structuredContent),
         structuredContent: result.structuredContent
       };
     }
@@ -3039,5 +3047,6 @@ function registerTool(server, tool) {
   getDefaultHeliosAgentMcpSessionPath,
   pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh,
-  toolAnnotations
+  toolAnnotations,
+  withDataText
 });

package/dist/index.mjs

@@ -22,8 +22,9 @@ import {
   getDefaultHeliosAgentMcpSessionPath,
   pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh,
-  toolAnnotations
-} from "./chunk-NCF7ASJB.mjs";
+  toolAnnotations,
+  withDataText
+} from "./chunk-UYCUR7QV.mjs";
 export {
   FileAgentSessionStore,
   HOSTED_RECONNECT_MESSAGE,
@@ -48,5 +49,6 @@ export {
   getDefaultHeliosAgentMcpSessionPath,
   pendingAgentLoginSchema,
   retryAfterUnauthorizedRefresh,
-  toolAnnotations
+  toolAnnotations,
+  withDataText
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pgnio/helios-mcp",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "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",