@astra-cli/cli 1.2.2 → 1.2.3

package/dist/astra.js

@@ -974,6 +974,10 @@ async function apiCall(method, path7, body, agentName, retryOpts) {
     "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) {
@@ -1009,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";
@@ -1829,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";
@@ -1922,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}`,
@@ -1974,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("", "---", "");
@@ -2464,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;
@@ -2569,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();
@@ -2624,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) {
@@ -2641,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")}`);
@@ -2829,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)) {
@@ -2912,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();
@@ -3369,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);
@@ -4198,11 +4234,31 @@ function writeFileSecure2(filePath, data) {
   fs10.writeFileSync(tmpPath, data, { encoding: "utf-8", mode: 384 });
   fs10.renameSync(tmpPath, filePath);
 }
-function buildPluginMap(pluginName, manifest, sections) {
+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());
@@ -4212,6 +4268,7 @@ function buildPluginMap(pluginName, manifest, sections) {
     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"];
@@ -4223,6 +4280,40 @@ function buildPluginMap(pluginName, manifest, sections) {
       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) {
@@ -4238,7 +4329,7 @@ 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);
+  const pluginMap = buildPluginMap(manifest.name, manifest, sections, skillMdContent);
   writeFileSecure2(pluginMapPath(manifest.name), JSON.stringify(pluginMap, null, 2));
 }
 async function addPlugin(manifestUrl) {
@@ -4445,7 +4536,8 @@ var StatusBar = React.memo(function StatusBar2({
       setPluginData(result.data);
     };
     void fetchPlugin();
-    const interval = setInterval(() => void fetchPlugin(), POLL_INTERVAL_MS);
+    const pollInterval = pluginMap?.status?.intervalMs ?? POLL_INTERVAL_MS;
+    const interval = setInterval(() => void fetchPlugin(), pollInterval);
     return () => {
       mountedPlugin.current = false;
       clearInterval(interval);
@@ -5074,7 +5166,8 @@ function App({
             } : () => {
             }
           },
-          memoryContent
+          memoryContent,
+          pluginMap
         );
         const baseCoreMessages = result.compactedMessages ?? newCoreMessages;
         const updatedCore = [...baseCoreMessages, ...result.responseMessages];
@@ -5419,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];

package/package.json

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