@pgnio/helios-mcp 0.2.8 → 0.2.9

package/dist/{chunk-V453JYRN.mjs → chunk-7TMDGB6C.mjs}

@@ -2,6 +2,13 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_tsx@4.20.6_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path.dirname(getFilename());
+var __dirname = /* @__PURE__ */ getDirname();
+
 // ../agent/dist/index.mjs
 import { z } from "zod";
 import { z as z2 } from "zod";
@@ -116,19 +123,21 @@ var protectiveOrderKindSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"]);
 var protectiveOrderSideSchema = z.enum(["BUY", "SELL"]);
 var protectiveOrderPositionSideSchema = z.enum(["BOTH", "LONG", "SHORT"]);
 var protectiveOrderSchema = z.object({
+  /** Helios's record id: what helios_positions_delete_tp_sl takes (the Hyperliquid order id works there too). */
   id: z.string(),
-  binanceOrderId: z.number().int().nonnegative().optional(),
-  clientOrderId: z.string().optional(),
+  /** The Hyperliquid order id (named after the retired Binance field). */
+  binanceOrderId: z.number().int().nonnegative().nullish(),
+  clientOrderId: z.string().nullish(),
   symbol: z.string(),
   side: protectiveOrderSideSchema,
-  positionSide: protectiveOrderPositionSideSchema,
+  positionSide: protectiveOrderPositionSideSchema.nullish().transform((value) => value ?? "BOTH"),
   status: z.string(),
   kind: protectiveOrderKindSchema,
-  groupId: z.string(),
-  stopPrice: z.string().optional(),
-  parentClientOrderId: z.string().optional(),
-  assetId: z.number().int().nonnegative().optional(),
-  createdAt: z.string().datetime()
+  groupId: z.string().nullish(),
+  stopPrice: z.union([z.string(), z.number()]).nullish().transform((value) => value == null ? value : String(value)),
+  parentClientOrderId: z.string().nullish(),
+  assetId: z.number().int().nonnegative().nullish(),
+  createdAt: z.string().nullish()
 });
 var hyperliquidPortfolioSnapshotSchema = z.object({
   provider: z.literal("hyperliquid"),
@@ -137,6 +146,7 @@ var hyperliquidPortfolioSnapshotSchema = z.object({
   totalMargin: z.number(),
   unrealizedPnl: z.number(),
   positions: z.array(openPositionSchema),
+  /** Unreadable entries are dropped (see readProtectiveOrders) rather than failing the read. */
   protectiveOrders: z.array(protectiveOrderSchema)
 });
 var portfolioInputSchema = z.object({
@@ -331,6 +341,8 @@ var closePositionInputSchema = z.object({
 });
 var closePositionResultSchema = z.object({
   status: z.literal("submitted"),
+  /** `no_position`: nothing was open on this coin, so no order was sent. Absent from older data-bridges. */
+  outcome: z.enum(["closed", "no_position"]).optional(),
   provider: providerSchema.optional(),
   symbol: z.string(),
   mode: z.literal("FULL"),
@@ -442,10 +454,10 @@ var HeliosAgentAuthClient = class {
     const parsed = agentRefreshInputSchema.parse({ refreshToken });
     return this.post("/api/agents/auth/refresh", parsed, agentTokenResponseSchema);
   }
-  async post(path3, body, schema) {
+  async post(path4, body, schema) {
     let response;
     try {
-      response = await this.fetchImpl(`${this.baseUrl}${path3}`, {
+      response = await this.fetchImpl(`${this.baseUrl}${path4}`, {
         method: "POST",
         headers: {
           Accept: "application/json",
@@ -521,7 +533,8 @@ var HeliosAgentDataBridgeClient = class {
     }
     return portfolioSnapshotSchema.parse({
       ...result,
-      provider: parsedInput.provider
+      provider: parsedInput.provider,
+      protectiveOrders: readProtectiveOrders(result.protectiveOrders)
     });
   }
   async getLedgerFills(accessToken, input = {}) {
@@ -574,7 +587,7 @@ var HeliosAgentDataBridgeClient = class {
   }
   async closePosition(accessToken, input) {
     const parsedInput = closePositionInputSchema.parse(input);
-    await this.request(
+    const payload = await this.request(
       accessToken,
       "positions.close",
       {
@@ -585,8 +598,10 @@ var HeliosAgentDataBridgeClient = class {
       },
       "POST"
     );
+    const outcome = this.tryUnwrapResult(payload)?.outcome;
     return closePositionResultSchema.parse({
       status: "submitted",
+      ...outcome === "closed" || outcome === "no_position" ? { outcome } : {},
       provider: parsedInput.provider,
       symbol: parsedInput.symbol,
       mode: "FULL",
@@ -684,6 +699,14 @@ var HeliosAgentDataBridgeClient = class {
       });
     }
   }
+  /** The result of a mutation older data-bridges answer with nothing; null when there is none. */
+  tryUnwrapResult(payload) {
+    try {
+      return this.unwrapResult(payload) ?? null;
+    } catch {
+      return null;
+    }
+  }
   unwrapResult(payload) {
     if (!payload || typeof payload !== "object") {
       throw new HeliosAgentApiError({
@@ -744,6 +767,13 @@ var HeliosAgentDataBridgeClient = class {
     return envelope;
   }
 };
+function readProtectiveOrders(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const parsed = protectiveOrderSchema.safeParse(entry);
+    return parsed.success ? [parsed.data] : [];
+  });
+}
 var DEFAULT_AGENT_REFRESH_WINDOW_MS = 60 * 1e3;
 var agentConnectionStatusSchema = z3.enum([
   "disconnected",
@@ -1181,8 +1211,8 @@ var HeliosAgentMcpAccountService = class {
 };
 
 // src/docs-service.ts
-import { readdirSync, readFileSync, statSync } from "fs";
-import path from "path";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import path2 from "path";
 var HeliosAgentMcpDocsService = class {
   constructor(options) {
     __publicField(this, "docsRoot");
@@ -1197,9 +1227,12 @@ var HeliosAgentMcpDocsService = class {
   }
   async getDocument(input) {
     const documentPath = resolveDocumentPath(this.docsRoot, input.path);
+    if (!existsSync(documentPath) || !statSync(documentPath).isFile()) {
+      throw new Error(`No document "${input.path}". helios_docs_get_index lists the documents.`);
+    }
     const body = readFileSync(documentPath, "utf8");
     const stats = statSync(documentPath);
-    const relativePath = toPosixPath(path.relative(this.docsRoot, documentPath));
+    const relativePath = toPosixPath(path2.relative(this.docsRoot, documentPath));
     return {
       path: relativePath,
       section: getDocumentSection(relativePath),
@@ -1211,7 +1244,7 @@ var HeliosAgentMcpDocsService = class {
   readDocumentMetadata(documentPath) {
     const body = readFileSync(documentPath, "utf8");
     const stats = statSync(documentPath);
-    const relativePath = toPosixPath(path.relative(this.docsRoot, documentPath));
+    const relativePath = toPosixPath(path2.relative(this.docsRoot, documentPath));
     return {
       path: relativePath,
       section: getDocumentSection(relativePath),
@@ -1221,7 +1254,7 @@ var HeliosAgentMcpDocsService = class {
   }
 };
 function getDefaultHeliosAgentMcpDocsRoot() {
-  return path.resolve(__dirname, "..", "docs");
+  return path2.resolve(__dirname, "..", "docs");
 }
 function listDocumentPaths(root) {
   return walk(root).filter((filePath) => filePath.endsWith(".txt")).sort((left, right) => left.localeCompare(right));
@@ -1230,7 +1263,7 @@ function walk(currentPath) {
   const entries = readdirSync(currentPath, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
-    const nextPath = path.join(currentPath, entry.name);
+    const nextPath = path2.join(currentPath, entry.name);
     if (entry.isDirectory()) {
       files.push(...walk(nextPath));
       continue;
@@ -1243,12 +1276,12 @@ function walk(currentPath) {
 }
 function resolveDocumentPath(root, relativeDocumentPath) {
   const normalizedPath = relativeDocumentPath.replace(/\\/g, "/").replace(/^\/+/, "");
-  const resolvedPath = path.resolve(root, normalizedPath);
-  const relativePath = path.relative(root, resolvedPath);
+  const resolvedPath = path2.resolve(root, normalizedPath);
+  const relativePath = path2.relative(root, resolvedPath);
   if (!normalizedPath) {
     throw new Error("Document path is required.");
   }
-  if (path.isAbsolute(normalizedPath) || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+  if (path2.isAbsolute(normalizedPath) || relativePath.startsWith("..") || path2.isAbsolute(relativePath)) {
     throw new Error(`Document path "${relativeDocumentPath}" is outside the docs root.`);
   }
   if (!resolvedPath.endsWith(".txt")) {
@@ -1268,13 +1301,13 @@ function extractDocumentTitle(body, relativePath) {
     }
     return trimmed;
   }
-  return path.basename(relativePath, ".txt");
+  return path2.basename(relativePath, ".txt");
 }
 function getDocumentSection(relativePath) {
   return relativePath.split("/")[0] ?? "docs";
 }
 function toPosixPath(value) {
-  return value.split(path.sep).join("/");
+  return value.split(path2.sep).join("/");
 }
 
 // src/ledger-service.ts
@@ -1624,10 +1657,10 @@ var HeliosAgentMcpProviderService = class {
 // src/session-store.ts
 import { chmod, mkdir, readFile, rm, writeFile } from "fs/promises";
 import { homedir } from "os";
-import path2 from "path";
+import path3 from "path";
 import { z as z4 } from "zod";
 function getDefaultHeliosAgentMcpSessionPath() {
-  return path2.join(homedir(), ".helios-agent-mcp", "session.json");
+  return path3.join(homedir(), ".helios-agent-mcp", "session.json");
 }
 var pendingAgentLoginSchema = z4.object({
   status: z4.literal("pending"),
@@ -1748,7 +1781,7 @@ var FileAgentSessionStore = class {
     }
   }
   async writeState(state) {
-    await mkdir(path2.dirname(this.filePath), { recursive: true });
+    await mkdir(path3.dirname(this.filePath), { recursive: true });
     await writeFile(this.filePath, `${JSON.stringify(state, null, 2)}
 `, { encoding: "utf8", mode: 384 });
     await chmod(this.filePath, 384).catch(() => void 0);
@@ -2533,7 +2566,7 @@ function createHeliosAccountToolDefinitions(service) {
     {
       name: "helios_portfolio_get",
       title: "Get Helios Portfolio",
-      description: "Returns a provider-specific portfolio snapshot. Provider may be omitted if one is already pinned with helios_provider_set_active.",
+      description: "Returns balances, open positions and their TP/SL (protectiveOrders, each with the id helios_positions_delete_tp_sl takes). Provider may be omitted if one is already pinned with helios_provider_set_active.",
       inputSchema: providerSelectionInputSchema,
       async execute(input) {
         const result = portfolioToolOutputSchema.parse(await service.getPortfolio(input));
@@ -2629,7 +2662,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. By default: the top 50 coins by market cap with the main columns; name symbols to get other coins, pass fields for other columns.",
+      description: "Returns a compact market snapshot for the selected, all, or explicitly requested symbols. By default: the top 50 coins by market cap with the main columns; name symbols to get other coins, pass fields for other columns. What each column means: helios_docs_get_document with path ai-agent-indicators/00_columns.txt (read it once).",
       inputSchema: marketSnapshotInputSchema,
       async execute(input) {
         const result = marketSnapshotToolOutputSchema.parse(await service.getSnapshot(input));
@@ -2770,7 +2803,7 @@ function createHeliosTradingToolDefinitions(service) {
           content: [
             {
               type: "text",
-              text: result.status === "connected" ? `Submitted Helios full close for ${result.closure.provider ?? input.provider} ${result.closure.symbol}.` : result.message
+              text: result.status !== "connected" ? result.message : result.closure.outcome === "no_position" ? `No open ${result.closure.symbol} position: nothing was closed and no order was sent.` : `Sent a market order closing the full ${result.closure.provider ?? input.provider ?? "hyperliquid"} ${result.closure.symbol} position. Check helios_positions_get_open to confirm.`
             }
           ],
           structuredContent: result.status === "connected" ? result : {
@@ -2804,7 +2837,7 @@ function createHeliosTradingToolDefinitions(service) {
     {
       name: "helios_positions_delete_tp_sl",
       title: "Delete Helios TP/SL",
-      description: "Deletes an existing Helios take-profit or stop-loss order by order id. Provider may be omitted if one is already pinned with helios_provider_set_active.",
+      description: "Deletes a take-profit or stop-loss. orderId is the id from helios_portfolio_get protectiveOrders, or the Hyperliquid order id of the TP/SL. Provider may be omitted if one is already pinned with helios_provider_set_active.",
       inputSchema: deleteTpSlInputSchema,
       async execute(input) {
         const result = deleteTpSlToolOutputSchema.parse(await service.deleteTpSl(input));
@@ -2897,7 +2930,7 @@ async function createHeliosAgentMcpServer(options) {
   const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
   const server = new McpServer({
     name: "helios",
-    version: "0.2.7"
+    version: "0.2.9"
   });
   const sessionStore = options.sessionStore ?? new FileAgentSessionStore(options.sessionPath ?? getDefaultHeliosAgentMcpSessionPath());
   const client = new HeliosAgentAuthClient({

package/dist/{chunk-UHFLF3UG.mjs → chunk-LMZEWQVW.mjs}

@@ -2,6 +2,13 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// ../../node_modules/.pnpm/tsup@8.5.1_jiti@2.6.1_postcss@8.5.6_tsx@4.20.6_typescript@5.9.3_yaml@2.8.2/node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path.dirname(getFilename());
+var __dirname = /* @__PURE__ */ getDirname();
+
 // ../agent/dist/index.mjs
 import { z } from "zod";
 import { z as z2 } from "zod";
@@ -116,19 +123,21 @@ var protectiveOrderKindSchema = z.enum(["STOP_LOSS", "TAKE_PROFIT"]);
 var protectiveOrderSideSchema = z.enum(["BUY", "SELL"]);
 var protectiveOrderPositionSideSchema = z.enum(["BOTH", "LONG", "SHORT"]);
 var protectiveOrderSchema = z.object({
+  /** Helios's record id: what helios_positions_delete_tp_sl takes (the Hyperliquid order id works there too). */
   id: z.string(),
-  binanceOrderId: z.number().int().nonnegative().optional(),
-  clientOrderId: z.string().optional(),
+  /** The Hyperliquid order id (named after the retired Binance field). */
+  binanceOrderId: z.number().int().nonnegative().nullish(),
+  clientOrderId: z.string().nullish(),
   symbol: z.string(),
   side: protectiveOrderSideSchema,
-  positionSide: protectiveOrderPositionSideSchema,
+  positionSide: protectiveOrderPositionSideSchema.nullish().transform((value) => value ?? "BOTH"),
   status: z.string(),
   kind: protectiveOrderKindSchema,
-  groupId: z.string(),
-  stopPrice: z.string().optional(),
-  parentClientOrderId: z.string().optional(),
-  assetId: z.number().int().nonnegative().optional(),
-  createdAt: z.string().datetime()
+  groupId: z.string().nullish(),
+  stopPrice: z.union([z.string(), z.number()]).nullish().transform((value) => value == null ? value : String(value)),
+  parentClientOrderId: z.string().nullish(),
+  assetId: z.number().int().nonnegative().nullish(),
+  createdAt: z.string().nullish()
 });
 var hyperliquidPortfolioSnapshotSchema = z.object({
   provider: z.literal("hyperliquid"),
@@ -137,6 +146,7 @@ var hyperliquidPortfolioSnapshotSchema = z.object({
   totalMargin: z.number(),
   unrealizedPnl: z.number(),
   positions: z.array(openPositionSchema),
+  /** Unreadable entries are dropped (see readProtectiveOrders) rather than failing the read. */
   protectiveOrders: z.array(protectiveOrderSchema)
 });
 var portfolioInputSchema = z.object({
@@ -331,6 +341,8 @@ var closePositionInputSchema = z.object({
 });
 var closePositionResultSchema = z.object({
   status: z.literal("submitted"),
+  /** `no_position`: nothing was open on this coin, so no order was sent. Absent from older data-bridges. */
+  outcome: z.enum(["closed", "no_position"]).optional(),
   provider: providerSchema.optional(),
   symbol: z.string(),
   mode: z.literal("FULL"),
@@ -442,10 +454,10 @@ var HeliosAgentAuthClient = class {
     const parsed = agentRefreshInputSchema.parse({ refreshToken });
     return this.post("/api/agents/auth/refresh", parsed, agentTokenResponseSchema);
   }
-  async post(path3, body, schema) {
+  async post(path4, body, schema) {
     let response;
     try {
-      response = await this.fetchImpl(`${this.baseUrl}${path3}`, {
+      response = await this.fetchImpl(`${this.baseUrl}${path4}`, {
         method: "POST",
         headers: {
           Accept: "application/json",
@@ -521,7 +533,8 @@ var HeliosAgentDataBridgeClient = class {
     }
     return portfolioSnapshotSchema.parse({
       ...result,
-      provider: parsedInput.provider
+      provider: parsedInput.provider,
+      protectiveOrders: readProtectiveOrders(result.protectiveOrders)
     });
   }
   async getLedgerFills(accessToken, input = {}) {
@@ -574,7 +587,7 @@ var HeliosAgentDataBridgeClient = class {
   }
   async closePosition(accessToken, input) {
     const parsedInput = closePositionInputSchema.parse(input);
-    await this.request(
+    const payload = await this.request(
       accessToken,
       "positions.close",
       {
@@ -585,8 +598,10 @@ var HeliosAgentDataBridgeClient = class {
       },
       "POST"
     );
+    const outcome = this.tryUnwrapResult(payload)?.outcome;
     return closePositionResultSchema.parse({
       status: "submitted",
+      ...outcome === "closed" || outcome === "no_position" ? { outcome } : {},
       provider: parsedInput.provider,
       symbol: parsedInput.symbol,
       mode: "FULL",
@@ -684,6 +699,14 @@ var HeliosAgentDataBridgeClient = class {
       });
     }
   }
+  /** The result of a mutation older data-bridges answer with nothing; null when there is none. */
+  tryUnwrapResult(payload) {
+    try {
+      return this.unwrapResult(payload) ?? null;
+    } catch {
+      return null;
+    }
+  }
   unwrapResult(payload) {
     if (!payload || typeof payload !== "object") {
       throw new HeliosAgentApiError({
@@ -744,6 +767,13 @@ var HeliosAgentDataBridgeClient = class {
     return envelope;
   }
 };
+function readProtectiveOrders(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((entry) => {
+    const parsed = protectiveOrderSchema.safeParse(entry);
+    return parsed.success ? [parsed.data] : [];
+  });
+}
 var DEFAULT_AGENT_REFRESH_WINDOW_MS = 60 * 1e3;
 var agentConnectionStatusSchema = z3.enum([
   "disconnected",
@@ -1181,8 +1211,8 @@ var HeliosAgentMcpAccountService = class {
 };
 
 // src/docs-service.ts
-import { readdirSync, readFileSync, statSync } from "fs";
-import path from "path";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import path2 from "path";
 var HeliosAgentMcpDocsService = class {
   constructor(options) {
     __publicField(this, "docsRoot");
@@ -1197,9 +1227,12 @@ var HeliosAgentMcpDocsService = class {
   }
   async getDocument(input) {
     const documentPath = resolveDocumentPath(this.docsRoot, input.path);
+    if (!existsSync(documentPath) || !statSync(documentPath).isFile()) {
+      throw new Error(`No document "${input.path}". helios_docs_get_index lists the documents.`);
+    }
     const body = readFileSync(documentPath, "utf8");
     const stats = statSync(documentPath);
-    const relativePath = toPosixPath(path.relative(this.docsRoot, documentPath));
+    const relativePath = toPosixPath(path2.relative(this.docsRoot, documentPath));
     return {
       path: relativePath,
       section: getDocumentSection(relativePath),
@@ -1211,7 +1244,7 @@ var HeliosAgentMcpDocsService = class {
   readDocumentMetadata(documentPath) {
     const body = readFileSync(documentPath, "utf8");
     const stats = statSync(documentPath);
-    const relativePath = toPosixPath(path.relative(this.docsRoot, documentPath));
+    const relativePath = toPosixPath(path2.relative(this.docsRoot, documentPath));
     return {
       path: relativePath,
       section: getDocumentSection(relativePath),
@@ -1221,7 +1254,7 @@ var HeliosAgentMcpDocsService = class {
   }
 };
 function getDefaultHeliosAgentMcpDocsRoot() {
-  return path.resolve(__dirname, "..", "docs");
+  return path2.resolve(__dirname, "..", "docs");
 }
 function listDocumentPaths(root) {
   return walk(root).filter((filePath) => filePath.endsWith(".txt")).sort((left, right) => left.localeCompare(right));
@@ -1230,7 +1263,7 @@ function walk(currentPath) {
   const entries = readdirSync(currentPath, { withFileTypes: true });
   const files = [];
   for (const entry of entries) {
-    const nextPath = path.join(currentPath, entry.name);
+    const nextPath = path2.join(currentPath, entry.name);
     if (entry.isDirectory()) {
       files.push(...walk(nextPath));
       continue;
@@ -1243,12 +1276,12 @@ function walk(currentPath) {
 }
 function resolveDocumentPath(root, relativeDocumentPath) {
   const normalizedPath = relativeDocumentPath.replace(/\\/g, "/").replace(/^\/+/, "");
-  const resolvedPath = path.resolve(root, normalizedPath);
-  const relativePath = path.relative(root, resolvedPath);
+  const resolvedPath = path2.resolve(root, normalizedPath);
+  const relativePath = path2.relative(root, resolvedPath);
   if (!normalizedPath) {
     throw new Error("Document path is required.");
   }
-  if (path.isAbsolute(normalizedPath) || relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+  if (path2.isAbsolute(normalizedPath) || relativePath.startsWith("..") || path2.isAbsolute(relativePath)) {
     throw new Error(`Document path "${relativeDocumentPath}" is outside the docs root.`);
   }
   if (!resolvedPath.endsWith(".txt")) {
@@ -1268,13 +1301,13 @@ function extractDocumentTitle(body, relativePath) {
     }
     return trimmed;
   }
-  return path.basename(relativePath, ".txt");
+  return path2.basename(relativePath, ".txt");
 }
 function getDocumentSection(relativePath) {
   return relativePath.split("/")[0] ?? "docs";
 }
 function toPosixPath(value) {
-  return value.split(path.sep).join("/");
+  return value.split(path2.sep).join("/");
 }
 
 // src/ledger-service.ts
@@ -1624,10 +1657,10 @@ var HeliosAgentMcpProviderService = class {
 // src/session-store.ts
 import { chmod, mkdir, readFile, rm, writeFile } from "fs/promises";
 import { homedir } from "os";
-import path2 from "path";
+import path3 from "path";
 import { z as z4 } from "zod";
 function getDefaultHeliosAgentMcpSessionPath() {
-  return path2.join(homedir(), ".helios-agent-mcp", "session.json");
+  return path3.join(homedir(), ".helios-agent-mcp", "session.json");
 }
 var pendingAgentLoginSchema = z4.object({
   status: z4.literal("pending"),
@@ -1748,7 +1781,7 @@ var FileAgentSessionStore = class {
     }
   }
   async writeState(state) {
-    await mkdir(path2.dirname(this.filePath), { recursive: true });
+    await mkdir(path3.dirname(this.filePath), { recursive: true });
     await writeFile(this.filePath, `${JSON.stringify(state, null, 2)}
 `, { encoding: "utf8", mode: 384 });
     await chmod(this.filePath, 384).catch(() => void 0);
@@ -2533,7 +2566,7 @@ function createHeliosAccountToolDefinitions(service) {
     {
       name: "helios_portfolio_get",
       title: "Get Helios Portfolio",
-      description: "Returns a provider-specific portfolio snapshot. Provider may be omitted if one is already pinned with helios_provider_set_active.",
+      description: "Returns balances, open positions and their TP/SL (protectiveOrders, each with the id helios_positions_delete_tp_sl takes). Provider may be omitted if one is already pinned with helios_provider_set_active.",
       inputSchema: providerSelectionInputSchema,
       async execute(input) {
         const result = portfolioToolOutputSchema.parse(await service.getPortfolio(input));
@@ -2770,7 +2803,7 @@ function createHeliosTradingToolDefinitions(service) {
           content: [
             {
               type: "text",
-              text: result.status === "connected" ? `Submitted Helios full close for ${result.closure.provider ?? input.provider} ${result.closure.symbol}.` : result.message
+              text: result.status !== "connected" ? result.message : result.closure.outcome === "no_position" ? `No open ${result.closure.symbol} position: nothing was closed and no order was sent.` : `Sent a market order closing the full ${result.closure.provider ?? input.provider ?? "hyperliquid"} ${result.closure.symbol} position. Check helios_positions_get_open to confirm.`
             }
           ],
           structuredContent: result.status === "connected" ? result : {
@@ -2804,7 +2837,7 @@ function createHeliosTradingToolDefinitions(service) {
     {
       name: "helios_positions_delete_tp_sl",
       title: "Delete Helios TP/SL",
-      description: "Deletes an existing Helios take-profit or stop-loss order by order id. Provider may be omitted if one is already pinned with helios_provider_set_active.",
+      description: "Deletes a take-profit or stop-loss. orderId is the id from helios_portfolio_get protectiveOrders, or the Hyperliquid order id of the TP/SL. Provider may be omitted if one is already pinned with helios_provider_set_active.",
       inputSchema: deleteTpSlInputSchema,
       async execute(input) {
         const result = deleteTpSlToolOutputSchema.parse(await service.deleteTpSl(input));