@astra-cli/cli 1.2.0 → 1.2.3

package/dist/astra.js

@@ -139,6 +139,9 @@ function pluginManifestPath(pluginName) {
 function pluginSkillPath(pluginName) {
   return path.join(pluginDir(pluginName), "skill.md");
 }
+function pluginMapPath(pluginName) {
+  return path.join(pluginDir(pluginName), "plugin-map.json");
+}
 function ensureDir(dirPath) {
   if (!fs.existsSync(dirPath)) {
     fs.mkdirSync(dirPath, { recursive: true });
@@ -967,12 +970,19 @@ var FETCH_TIMEOUT_MS = 3e4;
 var FETCH_TIMEOUT_RETRY_MS = 15e3;
 async function apiCall(method, path7, body, agentName, retryOpts) {
   const config = loadConfig();
-  const baseUrl = config?.apiBase ?? "https://agents.astranova.live";
   const headers = {
     "Content-Type": "application/json"
   };
+  let baseUrl = config?.apiBase ?? "https://agents.astranova.live";
+  try {
+    baseUrl = getActiveManifest().apiBase;
+  } catch {
+  }
   if (agentName) {
     const creds = loadCredentials(agentName);
+    if (creds?.api_base) {
+      baseUrl = creds.api_base;
+    }
     if (creds?.api_key) {
       headers["Authorization"] = `Bearer ${creds.api_key}`;
     }
@@ -1003,7 +1013,7 @@ async function apiCall(method, path7, body, agentName, retryOpts) {
           ok: false,
           status: 0,
           error: `Request to ${path7} timed out after ${timeoutMs / 1e3}s`,
-          hint: "The AstraNova API may be slow or unreachable. Try again."
+          hint: "The API server may be slow or unreachable. Try again."
         };
       }
       const message = error instanceof Error ? error.message : "Unknown network error";
@@ -1823,10 +1833,10 @@ function createModelFromConfig(config) {
 }
 
 // src/agent/system-prompt.ts
-function buildSystemPrompt(skillContext, tradingContext, walletContext, rewardsContext, onboardingContext, apiContext, profile, memoryContent) {
+function buildSystemPrompt(skillContext, tradingContext, walletContext, rewardsContext, onboardingContext, apiContext, profile, memoryContent, pluginMap) {
   const manifest = getActiveManifest();
   if (!manifest.extensions?.journeyStages) {
-    return buildGenericSystemPrompt(skillContext, manifest.name, manifest.description, profile, memoryContent);
+    return buildGenericSystemPrompt(skillContext, manifest.name, manifest.description, profile, memoryContent, pluginMap);
   }
   const stage = profile.journeyStage ?? "full";
   const isPending = stage === "fresh" || stage === "pending";
@@ -1916,7 +1926,7 @@ Specific triggers to save memory:
   parts.push(buildJourneyGuidance(stage, profile));
   return parts.join("\n");
 }
-function buildGenericSystemPrompt(skillContext, pluginName, pluginDescription, profile, memoryContent) {
+function buildGenericSystemPrompt(skillContext, pluginName, pluginDescription, profile, memoryContent, pluginMap) {
   const workingSpace = `~/.config/astra/spaces/${pluginName}`;
   const parts = [
     `You are an autonomous agent assistant for ${pluginName}. ${pluginDescription}`,
@@ -1968,6 +1978,38 @@ function buildGenericSystemPrompt(skillContext, pluginName, pluginDescription, p
       "---",
       ""
     );
+    if (pluginMap?.routes && pluginMap.routes.length > 0) {
+      parts.push("## Available API Routes", "");
+      parts.push("Quick reference \u2014 use `api_call` with these relative paths:", "");
+      parts.push("```");
+      for (const r of pluginMap.routes) {
+        const line = r.summary ? `${r.method.padEnd(7)} ${r.path.padEnd(45)} ${r.summary}` : `${r.method.padEnd(7)} ${r.path}`;
+        parts.push(line);
+      }
+      parts.push("```");
+      parts.push("", "---", "");
+    }
+    if (pluginMap?.workflows) {
+      parts.push("## Workflows", "");
+      for (const [name, steps] of Object.entries(pluginMap.workflows)) {
+        parts.push(`**${name}:**`);
+        steps.forEach((step, i) => parts.push(`${i + 1}. ${step}`));
+        parts.push("");
+      }
+      parts.push("---", "");
+    }
+    if (pluginMap?.capabilities) {
+      const cap = pluginMap.capabilities;
+      const notes = [];
+      if (cap.requiresWallet === false) notes.push("This plugin does NOT use wallets \u2014 do not suggest wallet setup.");
+      if (cap.requiresVerification) notes.push("Content may require verification challenges \u2014 handle them automatically.");
+      if (cap.supportsFileUpload === false) notes.push("File upload is not supported \u2014 do not attempt multipart requests.");
+      if (notes.length > 0) {
+        parts.push("## Plugin Notes", "");
+        notes.forEach((n) => parts.push(`- ${n}`));
+        parts.push("", "---", "");
+      }
+    }
     parts.push(`## ${pluginName} \u2014 Skill Documentation`, "");
     parts.push(sanitizedSkill);
     parts.push("", "---", "");
@@ -2458,7 +2500,7 @@ function resolveBody(body, rest, method) {
   return void 0;
 }
 var apiCallTool = tool3({
-  description: "Call the AstraNova Agent API. Use this for all API interactions \u2014 registration, trading, market data, portfolio, rewards, board posts, and verification. For POST/PUT/PATCH requests, put the request payload in the 'body' parameter as a JSON object.",
+  description: "Call the plugin's Agent API. Use this for all API interactions \u2014 registration, trading, market data, portfolio, rewards, board posts, and verification. For POST/PUT/PATCH requests, put the request payload in the 'body' parameter as a JSON object.",
   parameters: apiCallSchema,
   execute: async (args) => {
     const { method, path: path7, body, ...rest } = args;
@@ -2563,7 +2605,7 @@ import fs8 from "fs";
 import path5 from "path";
 import crypto2 from "crypto";
 var readConfigTool = tool4({
-  description: "Read local AstraNova configuration or credentials. Returns public information only \u2014 private keys and API keys are never included.",
+  description: "Read local agent configuration or credentials. Returns public information only \u2014 private keys and API keys are never included.",
   parameters: readConfigSchema,
   execute: async ({ key, agentName }) => {
     const resolvedAgent = agentName ?? getActiveAgent();
@@ -2618,7 +2660,7 @@ var readConfigTool = tool4({
   }
 });
 var writeConfigTool = tool4({
-  description: "Write local AstraNova configuration. Used to save agent credentials after registration or update profile data. Cannot write wallet files \u2014 use wallet tools instead.",
+  description: "Write local agent configuration. Used to save agent credentials after registration or update profile data. Cannot write wallet files \u2014 use wallet tools instead.",
   parameters: writeConfigSchema,
   execute: async ({ agentName, data, file }) => {
     if (file === "credentials" && data && "secretKey" in data) {
@@ -2635,7 +2677,7 @@ var writeConfigTool = tool4({
       saveCredentials(agentName, {
         agent_name: merged.agent_name ?? agentName,
         api_key: merged.api_key ?? "",
-        api_base: merged.api_base ?? "https://agents.astranova.live"
+        api_base: merged.api_base ?? getActiveManifest().apiBase
       });
     } else {
       const tmpPath = path5.join(dir, `.tmp-${crypto2.randomBytes(6).toString("hex")}`);
@@ -2823,7 +2865,7 @@ function stopDaemon(agentName) {
 
 // src/tools/agent-management.ts
 var registerAgentTool = tool6({
-  description: "Register a new AstraNova agent. Calls the API, saves credentials locally, and sets the new agent as active. The CLI will need to restart after this to load the new agent's context.",
+  description: "Register a new agent. Calls the API, saves credentials locally, and sets the new agent as active. The CLI will need to restart after this to load the new agent's context.",
   parameters: registerAgentSchema,
   execute: async ({ name, description }) => {
     if (!/^[a-z0-9_-]{2,32}$/.test(name)) {
@@ -2906,7 +2948,7 @@ var switchAgentTool = tool6({
   }
 });
 var listAgentsTool = tool6({
-  description: "List all AstraNova agents registered on this machine, showing which one is active.",
+  description: "List all agents registered on this machine, showing which one is active.",
   parameters: z6.object({}),
   execute: async () => {
     const agents = listAgents();
@@ -3363,8 +3405,8 @@ function debugLog3(msg) {
   if (DEBUG3) process.stderr.write(`[astra] ${msg}
 `);
 }
-async function runAgentTurn(messages, skillContext, tradingContext, walletContext, rewardsContext, onboardingContext, apiContext, profile, callbacks, memoryContent) {
-  const systemPrompt = buildSystemPrompt(skillContext, tradingContext, walletContext, rewardsContext, onboardingContext, apiContext, profile, memoryContent);
+async function runAgentTurn(messages, skillContext, tradingContext, walletContext, rewardsContext, onboardingContext, apiContext, profile, callbacks, memoryContent, pluginMap) {
+  const systemPrompt = buildSystemPrompt(skillContext, tradingContext, walletContext, rewardsContext, onboardingContext, apiContext, profile, memoryContent, pluginMap);
   const config = loadConfig();
   const provider = config?.provider ?? "openai";
   const systemPromptTokens = estimateTokens(systemPrompt);
@@ -4192,10 +4234,103 @@ function writeFileSecure2(filePath, data) {
   fs10.writeFileSync(tmpPath, data, { encoding: "utf-8", mode: 384 });
   fs10.renameSync(tmpPath, filePath);
 }
-function savePluginToDisk(manifest, skillMdContent) {
+function extractRoutes(narrative) {
+  const routes = [];
+  const seen = /* @__PURE__ */ new Set();
+  const curlPattern = /curl\s+(?:-X\s+(GET|POST|PUT|PATCH|DELETE)\s+)?["']?https?:\/\/[^/\s]+(\S+?)["']?\s/g;
+  let match;
+  while ((match = curlPattern.exec(narrative)) !== null) {
+    const method = match[1] ?? "GET";
+    const rawPath = match[2].split("?")[0].replace(/["']/g, "");
+    const key = `${method} ${rawPath}`;
+    if (!seen.has(key)) {
+      seen.add(key);
+      routes.push({ method, path: rawPath });
+    }
+  }
+  return routes;
+}
+function buildPluginMap(pluginName, manifest, sections, skillMd) {
+  const map = { version: 1, pluginName };
+  if (manifest.description) {
+    map.description = manifest.description;
+  }
+  const statusSection = sections["STATUS"];
+  if (statusSection) {
+    const poll = typeof statusSection.poll === "string" ? statusSection.poll.trim() : null;
+    const intervalMs = typeof statusSection.intervalMs === "string" ? parseInt(statusSection.intervalMs, 10) || void 0 : void 0;
+    const rawFields = Array.isArray(statusSection.fields) ? statusSection.fields : [];
+    const fields = rawFields.flatMap((raw) => {
+      const parts = raw.split("|").map((s) => s.trim());
+      if (parts.length === 3) return [{ path: parts[0], label: parts[1], color: parts[2] }];
+      return [];
+    });
+    const pollAllowed = poll && manifest.allowedPaths.some((ap) => poll.startsWith(ap));
+    if (poll && pollAllowed && fields.length > 0) {
+      map.status = { poll, fields };
+      if (intervalMs) map.status.intervalMs = intervalMs;
+    }
+  }
+  const cmdSection = sections["COMMANDS"];
+  if (cmdSection) {
+    const rawCmds = Array.isArray(cmdSection.commands) ? cmdSection.commands : [];
+    map.commands = rawCmds.flatMap((raw) => {
+      const match = raw.match(/^(\S+)\s{2,}(.+)$/);
+      if (match) return [{ command: match[1], description: match[2].trim() }];
+      return [];
+    });
+  }
+  const routesSection = sections["ROUTES"];
+  if (routesSection && Array.isArray(routesSection.routes)) {
+    map.routes = routesSection.routes.flatMap((raw) => {
+      const m = raw.match(/^(GET|POST|PUT|PATCH|DELETE)\s+(\S+)(?:\s{2,}(.+))?$/);
+      if (m) return [{ method: m[1], path: m[2], summary: m[3]?.trim() }];
+      return [];
+    });
+  } else {
+    const narrative = extractNarrativeContent(skillMd);
+    const routes = extractRoutes(narrative);
+    if (routes.length > 0) map.routes = routes;
+  }
+  const workflowSection = sections["WORKFLOWS"];
+  if (workflowSection) {
+    const workflows = {};
+    for (const [key, value] of Object.entries(workflowSection)) {
+      if (Array.isArray(value)) {
+        workflows[key] = value;
+      }
+    }
+    if (Object.keys(workflows).length > 0) map.workflows = workflows;
+  }
+  const capSection = sections["CAPABILITIES"];
+  if (capSection) {
+    map.capabilities = {};
+    if (typeof capSection.requiresWallet === "string")
+      map.capabilities.requiresWallet = capSection.requiresWallet === "true";
+    if (typeof capSection.requiresVerification === "string")
+      map.capabilities.requiresVerification = capSection.requiresVerification === "true";
+    if (typeof capSection.supportsFileUpload === "string")
+      map.capabilities.supportsFileUpload = capSection.supportsFileUpload === "true";
+    if (typeof capSection.authType === "string")
+      map.capabilities.authType = capSection.authType;
+  }
+  return map;
+}
+function loadPluginMap(pluginName) {
+  const p = pluginMapPath(pluginName);
+  if (!fs10.existsSync(p)) return null;
+  try {
+    return JSON.parse(fs10.readFileSync(p, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function savePluginToDisk(manifest, skillMdContent, sections) {
   ensureDir(pluginDir(manifest.name));
   writeFileSecure2(pluginManifestPath(manifest.name), JSON.stringify(manifest, null, 2));
   writeFileSecure2(pluginSkillPath(manifest.name), skillMdContent);
+  const pluginMap = buildPluginMap(manifest.name, manifest, sections, skillMdContent);
+  writeFileSecure2(pluginMapPath(manifest.name), JSON.stringify(pluginMap, null, 2));
 }
 async function addPlugin(manifestUrl) {
   clack5.intro(" astra add ");
@@ -4286,7 +4421,7 @@ async function addPlugin(manifestUrl) {
   }
   const manifestWithSkillUrl = { ...manifest, skillUrl: urlResult.url.toString() };
   try {
-    savePluginToDisk(manifestWithSkillUrl, skillMdContent);
+    savePluginToDisk(manifestWithSkillUrl, skillMdContent, sections);
   } catch (err) {
     clack5.log.error(
       `Failed to save plugin: ${err instanceof Error ? err.message : String(err)}`
@@ -4384,11 +4519,30 @@ var StatusBar = React.memo(function StatusBar2({
   journeyStage,
   autopilotMode = "off",
   autopilotIntervalMs = 3e5,
-  onEpochChange
+  onEpochChange,
+  pluginMap
 }) {
   const [data, setData] = useState({ market: null, portfolio: null });
   const mounted = useRef(true);
   const canFetchData = isAstraNova && journeyStage !== "fresh" && journeyStage !== "pending";
+  const [pluginData, setPluginData] = useState(null);
+  const mountedPlugin = useRef(true);
+  useEffect(() => {
+    if (isAstraNova || !pluginMap?.status) return;
+    mountedPlugin.current = true;
+    const fetchPlugin = async () => {
+      const result = await apiCall("GET", pluginMap.status.poll, void 0, agentName);
+      if (!result.ok || !mountedPlugin.current) return;
+      setPluginData(result.data);
+    };
+    void fetchPlugin();
+    const pollInterval = pluginMap?.status?.intervalMs ?? POLL_INTERVAL_MS;
+    const interval = setInterval(() => void fetchPlugin(), pollInterval);
+    return () => {
+      mountedPlugin.current = false;
+      clearInterval(interval);
+    };
+  }, [isAstraNova, pluginMap, agentName]);
   const poll = useCallback(async () => {
     const [marketRes, portfolioRes] = await Promise.all([
       fetchMarket(agentName),
@@ -4420,6 +4574,22 @@ var StatusBar = React.memo(function StatusBar2({
       /* @__PURE__ */ jsx(Text, { bold: true, color: "#00ff00", children: pluginName }),
       /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \u2502 " }),
       /* @__PURE__ */ jsx(Text, { color: "#ff8800", children: agentName }),
+      !isAstraNova && pluginData && pluginMap?.status?.fields.map((field) => {
+        const value = getNestedValue(pluginData, field.path);
+        if (value == null) return null;
+        return /* @__PURE__ */ jsxs(React.Fragment, { children: [
+          /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \u2502 " }),
+          /* @__PURE__ */ jsxs(Text, { color: field.color, children: [
+            field.label,
+            ": ",
+            String(value)
+          ] })
+        ] }, field.path);
+      }),
+      !isAstraNova && !pluginData && pluginMap?.status && /* @__PURE__ */ jsxs(Fragment, { children: [
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \u2502 " }),
+        /* @__PURE__ */ jsx(Text, { dimColor: true, children: "loading..." })
+      ] }),
       canFetchData && market && /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \u2502 " }),
         /* @__PURE__ */ jsx(Text, { color: "#ffff00", children: "$NOVA " }),
@@ -4500,6 +4670,12 @@ function moodColor(mood) {
       return "white";
   }
 }
+function getNestedValue(obj, path7) {
+  return path7.split(".").reduce(
+    (cur, key) => cur && typeof cur === "object" ? cur[key] : void 0,
+    obj
+  );
+}
 async function fetchMarket(agentName) {
   const result = await apiCall("GET", "/api/v1/market/state", void 0, agentName);
   if (!result.ok) return null;
@@ -4888,7 +5064,8 @@ function App({
   initialChatMessages,
   initialAutopilotConfig,
   initialPendingTrades = 0,
-  debug
+  debug,
+  pluginMap
 }) {
   const { exit } = useApp();
   const manifest = getActiveManifest();
@@ -4989,7 +5166,8 @@ function App({
             } : () => {
             }
           },
-          memoryContent
+          memoryContent,
+          pluginMap
         );
         const baseCoreMessages = result.compactedMessages ?? newCoreMessages;
         const updatedCore = [...baseCoreMessages, ...result.responseMessages];
@@ -5334,7 +5512,8 @@ Let's go through it and improve or replace it.` : "I want to create a trading st
               setToolName(void 0);
             }
           },
-          memoryContent
+          memoryContent,
+          pluginMap
         );
         const baseCoreMessages = result.compactedMessages ?? newCoreMessages;
         const updatedCore = [...baseCoreMessages, ...result.responseMessages];
@@ -5414,14 +5593,15 @@ ${stack}
         journeyStage: profile.journeyStage ?? "full",
         autopilotMode,
         autopilotIntervalMs,
-        onEpochChange: handleEpochChange
+        onEpochChange: handleEpochChange,
+        pluginMap
       }
     ) }),
     /* @__PURE__ */ jsx7(Box7, { flexShrink: 0, width: "100%", paddingX: 2, marginTop: 1, justifyContent: "space-between", children: hasJourneyStages ? /* @__PURE__ */ jsxs8(Fragment3, { children: [
       /* @__PURE__ */ jsx7(Text8, { dimColor: true, children: "/help \xB7 /portfolio \xB7 /market \xB7 /strategy \xB7 /exit" }),
       /* @__PURE__ */ jsx7(Text8, { dimColor: true, children: "/auto on\xB7off\xB7set \xB7 Ctrl+C quit" })
     ] }) : /* @__PURE__ */ jsxs8(Fragment3, { children: [
-      /* @__PURE__ */ jsx7(Text8, { dimColor: true, children: "/help \xB7 /exit \xB7 Ctrl+C quit" }),
+      /* @__PURE__ */ jsx7(Text8, { dimColor: true, children: (pluginMap?.commands?.map((c) => c.command).join(" \xB7 ") ?? "/help") + " \xB7 /exit" }),
       /* @__PURE__ */ jsx7(Text8, { dimColor: true, children: manifest.name })
     ] }) })
   ] });
@@ -5491,6 +5671,7 @@ async function main() {
     manifest = ASTRANOVA_MANIFEST;
   }
   setActiveManifest(manifest);
+  const pluginMap = activePluginName === "astranova" ? null : loadPluginMap(activePluginName);
   if (isDaemonMode) {
     await runDaemon();
     return;
@@ -5637,7 +5818,8 @@ async function main() {
       initialChatMessages,
       initialAutopilotConfig,
       initialPendingTrades,
-      debug
+      debug,
+      pluginMap
     })
   );
   await waitUntilExit();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astra-cli/cli",
-  "version": "1.2.0",
+  "version": "1.2.3",
   "description": "The terminal for autonomous agents. Powered by AstraNova.",
   "type": "module",
   "bin": {