@pgnio/helios-mcp 0.2.1 → 0.2.2

package/dist/cli.js

@@ -2835,7 +2835,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.2"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({
@@ -2928,6 +2928,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 +2945,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-XE6HRID3.mjs";
 
 // src/cli.ts
 async function main() {

package/dist/index.d.mts

@@ -1042,6 +1042,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<{
@@ -2135,4 +2147,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

@@ -1042,6 +1042,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<{
@@ -2135,4 +2147,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);
 
@@ -2903,7 +2904,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.2"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({
@@ -2996,6 +2997,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 +3014,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 +3045,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-XE6HRID3.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.2",
   "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",