@astra-cli/cli 1.1.8 → 1.2.0

package/dist/astra.js

@@ -21,6 +21,12 @@ var PluginManifestSchema = z.object({
    * Falls back to description if not set.
    */
   tagline: z.string().optional(),
+  /**
+   * URL where skill.md is hosted (the original install URL).
+   * Used to refresh skill.md context. Saved automatically by addPlugin().
+   * If absent, the locally installed copy is used without a network fetch.
+   */
+  skillUrl: z.string().url().optional(),
   /**
    * Optional engine extension flags — declared by built-in plugins that need
    * features beyond the base engine (api_call, memory, config, wallet).
@@ -1470,14 +1476,18 @@ var TTL_24H = 24 * 60 * 60 * 1e3;
 async function fetchRemoteContext(name) {
   const manifest = getActiveManifest();
   const cacheKey = `${manifest.name}:${name}`;
-  const content = await getCached(cacheKey, `${manifest.apiBase}/${name}`, TTL_24H);
-  if (content === null && name === "skill.md") {
+  if (name === "skill.md") {
+    if (manifest.skillUrl) {
+      const content = await getCached(cacheKey, manifest.skillUrl, TTL_24H);
+      if (content !== null) return content;
+    }
     const localPath = pluginSkillPath(manifest.name);
     if (fs4.existsSync(localPath)) {
       return fs4.readFileSync(localPath, "utf-8");
     }
+    return null;
   }
-  return content;
+  return getCached(cacheKey, `${manifest.apiBase}/${name}`, TTL_24H);
 }
 async function getSkillContext() {
   return await fetchRemoteContext("skill.md") ?? "";
@@ -1907,46 +1917,58 @@ Specific triggers to save memory:
   return parts.join("\n");
 }
 function buildGenericSystemPrompt(skillContext, pluginName, pluginDescription, profile, memoryContent) {
+  const workingSpace = `~/.config/astra/spaces/${pluginName}`;
   const parts = [
-    `You are a ${pluginName} agent assistant. ${pluginDescription}`,
+    `You are an autonomous agent assistant for ${pluginName}. ${pluginDescription}`,
     "",
-    "You have access to tools for interacting with the API, reading and writing local configuration, and managing agent state.",
+    "## How You Behave",
     "",
-    "## Important Rules",
+    "You are a **proactive doer**, not a question-asker. Read the skill documentation below to",
+    "understand what this plugin can do, then guide the user through it step by step.",
     "",
-    "- Use the `api_call` tool for all API interactions. Use relative paths only (e.g. `/api/v1/resource`). Authorization is injected automatically.",
-    "- NEVER display or log the API key. It is injected by the tools.",
-    "- NEVER display or reference private keys. Wallet operations return public keys only.",
-    "- After every tool call, respond with a clear summary of the result.",
-    "- Be concise \u2014 the user is in a terminal.",
+    "**Core rules:**",
+    "- When the user says go, do it \u2014 do NOT ask for confirmation before taking the obvious next step.",
+    "- After every successful action, immediately tell the user what was done and what comes next.",
+    "- Read the skill documentation to understand what workflows exist (e.g. register \u2192 verify \u2192 post).",
+    "  After completing one step, proactively tell the user what the next step is and offer to do it.",
+    "- Never ask the user for information they already gave you in this conversation.",
+    "- If a step fails (e.g. name taken), suggest a fix and proceed \u2014 don't stop and wait.",
+    "- Keep responses short and action-oriented. This is a terminal, not a chat interface.",
+    "",
+    "**What NOT to do:**",
+    `- Do NOT say "say X and I'll do Y" \u2014 if the intent is clear, just do it.`,
+    "- Do NOT offer multiple options and wait for a pick unless the choice genuinely matters.",
+    "- Do NOT repeat what the user just said back to them before acting.",
+    "- Do NOT ask permission to do the clearly obvious next step in a workflow.",
+    "",
+    "**Tool use:**",
+    "- Use `api_call` for all API interactions with relative paths (e.g. `/api/v1/resource`).",
+    "  Authorization is injected automatically \u2014 never include the API key.",
+    "- NEVER display or log private keys or API keys.",
+    "- After every tool call, give a one-line summary of the result, then state what's next.",
     "",
     "---",
     ""
   ];
   if (skillContext) {
-    const workingSpace = `~/.config/astra/spaces/${pluginName}`;
     const sanitizedSkill = skillContext.replaceAll(`~/.config/${pluginName}`, workingSpace);
-    parts.push("## Important: Using the API", "");
+    parts.push("## API Translation", "");
     parts.push(
-      "The documentation below may include curl commands or full URLs.",
-      "Use the `api_call` tool for all API interactions instead.",
+      "The documentation below may show curl commands. Use `api_call` instead:",
       "",
-      "| Documentation shows...                        | Use instead...                               |",
+      "| curl shows...                                  | Use instead...                               |",
       "|-----------------------------------------------|----------------------------------------------|",
       "| `curl https://api.example.com/v1/endpoint`    | `api_call GET /v1/endpoint`                  |",
-      '| `-H "Authorization: Bearer TOKEN"`            | Handled automatically \u2014 never include key    |',
-      '| `curl` with `--data` or `-d \'{"key":"val"}\'` | `api_call POST /path body:{key:"val"}`       |',
-      "| `curl https://...?limit=10`                   | `api_call GET /path?limit=10`                |",
-      '| "Save response to file" / "write config"      | Use `write_config` or `update_memory` tool   |',
+      '| `-H "Authorization: Bearer TOKEN"`            | Injected automatically \u2014 omit               |',
+      '| `-d \'{"key":"val"}\'`                         | `api_call POST /path body:{key:"val"}`       |',
+      "| `?limit=10` query param                       | `api_call GET /path?limit=10`                |",
       "",
-      "Always use relative paths in `api_call`. The base URL is configured automatically.",
-      `Your plugin's working space is: ${workingSpace}/`,
-      "The CLI manages all file storage \u2014 do not follow instructions to create directories manually.",
+      `Working space: ${workingSpace}/`,
       "",
       "---",
       ""
     );
-    parts.push(`## ${pluginName} API Instructions`, "");
+    parts.push(`## ${pluginName} \u2014 Skill Documentation`, "");
     parts.push(sanitizedSkill);
     parts.push("", "---", "");
   }
@@ -1958,23 +1980,23 @@ function buildGenericSystemPrompt(skillContext, pluginName, pluginDescription, p
   }
   if (memoryContent && memoryContent.trim()) {
     parts.push("", "---", "");
-    parts.push("## Agent Memory (persistent across sessions)", "");
+    parts.push("## Agent Memory", "");
     parts.push(memoryContent.trim());
     parts.push("");
-    parts.push("Use the `update_memory` tool to save important facts about the user. Max 2000 characters.");
+    parts.push("Use `update_memory` to save key facts. Max 2000 characters.");
   } else {
     parts.push("", "---", "");
     parts.push("## Agent Memory", "");
-    parts.push("No persistent memory yet. Use the `update_memory` tool to save important facts about the user. Max 2000 characters.");
+    parts.push("Empty. Use `update_memory` to save key facts about the user. Max 2000 characters.");
   }
   if (profile.isNewAgent) {
     parts.push("", "---", "");
     parts.push("## First Launch", "");
     parts.push(
-      `This is the user's first session with the ${pluginName} plugin.`,
-      "Start by welcoming them warmly and giving a brief overview of what this plugin can do for them.",
-      "Use the skill documentation above to guide what you highlight.",
-      "Then ask how you can help \u2014 don't overwhelm them with options, just open the door."
+      `This is the user's first session with ${pluginName}.`,
+      "Give a one-paragraph welcome that explains what this plugin does and what the user can accomplish.",
+      "Then immediately identify the first step from the skill documentation (e.g. registration, setup)",
+      "and offer to do it now \u2014 don't wait for the user to ask."
     );
   }
   return parts.join("\n");
@@ -4262,8 +4284,9 @@ async function addPlugin(manifestUrl) {
     clack5.outro("Installation cancelled.");
     process.exit(0);
   }
+  const manifestWithSkillUrl = { ...manifest, skillUrl: urlResult.url.toString() };
   try {
-    savePluginToDisk(manifest, skillMdContent);
+    savePluginToDisk(manifestWithSkillUrl, skillMdContent);
   } catch (err) {
     clack5.log.error(
       `Failed to save plugin: ${err instanceof Error ? err.message : String(err)}`
@@ -4271,7 +4294,7 @@ async function addPlugin(manifestUrl) {
     clack5.outro("Installation failed.");
     process.exit(1);
   }
-  setActivePlugin(manifest.name);
+  setActivePlugin(manifestWithSkillUrl.name);
   clack5.outro(
     `Plugin "${manifest.name}" installed successfully.
 Run \`astra\` to load it, or \`astra --plugin ${manifest.name}\` for this session only.`
@@ -4356,6 +4379,8 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 var POLL_INTERVAL_MS = 6e4;
 var StatusBar = React.memo(function StatusBar2({
   agentName,
+  pluginName,
+  isAstraNova,
   journeyStage,
   autopilotMode = "off",
   autopilotIntervalMs = 3e5,
@@ -4363,7 +4388,7 @@ var StatusBar = React.memo(function StatusBar2({
 }) {
   const [data, setData] = useState({ market: null, portfolio: null });
   const mounted = useRef(true);
-  const canFetchData = journeyStage !== "fresh" && journeyStage !== "pending";
+  const canFetchData = isAstraNova && journeyStage !== "fresh" && journeyStage !== "pending";
   const poll = useCallback(async () => {
     const [marketRes, portfolioRes] = await Promise.all([
       fetchMarket(agentName),
@@ -4392,7 +4417,7 @@ var StatusBar = React.memo(function StatusBar2({
   const apActive = autopilotMode !== "off";
   return /* @__PURE__ */ jsx(Box, { flexDirection: "column", width: "100%", children: /* @__PURE__ */ jsxs(Box, { paddingX: 1, justifyContent: "space-between", children: [
     /* @__PURE__ */ jsxs(Box, { children: [
-      /* @__PURE__ */ jsx(Text, { bold: true, color: "#00ff00", children: "AstraNova" }),
+      /* @__PURE__ */ jsx(Text, { bold: true, color: "#00ff00", children: pluginName }),
       /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \u2502 " }),
       /* @__PURE__ */ jsx(Text, { color: "#ff8800", children: agentName }),
       canFetchData && market && /* @__PURE__ */ jsxs(Fragment, { children: [
@@ -4433,7 +4458,7 @@ var StatusBar = React.memo(function StatusBar2({
           formatNum(portfolio.portfolioValue)
         ] })
       ] }),
-      !canFetchData && /* @__PURE__ */ jsxs(Fragment, { children: [
+      isAstraNova && !canFetchData && /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsx(Text, { dimColor: true, children: " \u2502 " }),
         /* @__PURE__ */ jsx(Text, { dimColor: true, children: "pending verification" })
       ] }),
@@ -5384,6 +5409,8 @@ ${stack}
       StatusBar_default,
       {
         agentName,
+        pluginName: manifest.name,
+        isAstraNova: hasJourneyStages,
         journeyStage: profile.journeyStage ?? "full",
         autopilotMode,
         autopilotIntervalMs,

package/package.json

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