@formthefog/stratus 2026.3.19 → 2026.3.20

package/index.ts

@@ -4,7 +4,7 @@ import type { StratusPluginConfig } from "./src/types.js";
 import { createStratusClient } from "./src/client.js";
 import { StratusConfigSchema } from "./src/config.js";
 import { setupStratus } from "./src/setup.js";
-import { readFileSync, writeFileSync, existsSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
 
@@ -232,6 +232,32 @@ const stratusPlugin = {
       } catch {
         // Silent fail — don't disrupt gateway startup
       }
+
+      if (apiKey) {
+        try {
+          const authPath = join(homedir(), ".openclaw", "agents", "main", "agent", "auth-profiles.json");
+          let authConfig: any = { version: 1, profiles: {}, lastGood: {}, usageStats: {} };
+          if (existsSync(authPath)) {
+            authConfig = JSON.parse(readFileSync(authPath, "utf-8"));
+          }
+          const existingProfile = authConfig.profiles["stratus:default"];
+          if (!existingProfile || existingProfile.key !== apiKey) {
+            authConfig.profiles["stratus:default"] = {
+              type: "api_key",
+              provider: "stratus",
+              key: apiKey,
+            };
+            authConfig.lastGood.stratus = "stratus:default";
+            const authDir = join(homedir(), ".openclaw", "agents", "main", "agent");
+            if (!existsSync(authDir)) {
+              mkdirSync(authDir, { recursive: true });
+            }
+            writeFileSync(authPath, JSON.stringify(authConfig, null, 2));
+          }
+        } catch {
+          // Silent fail — don't disrupt gateway startup
+        }
+      }
     });
 
     if (!pluginConfig.tools?.embeddings?.enabled && !pluginConfig.tools?.rollout?.enabled) {
@@ -385,8 +411,10 @@ const stratusPlugin = {
           const subcommand = (tokens[0] || "help").toLowerCase();
 
           if (subcommand === "setup") {
-            // Run setup
-            const result = await setupStratus(ctx.prompter);
+            const keyArg = tokens[1];
+            const result = keyArg
+              ? await setupStratus({ apiKey: keyArg, silent: true })
+              : await setupStratus(ctx.prompter);
 
             if (result.success) {
               console.log(`\n✅ ${result.message}\n`);
@@ -400,7 +428,7 @@ const stratusPlugin = {
               }
               process.exit(1);
             }
-            return { text: "" }; // Return empty to avoid double output
+            return { text: "" };
           } else if (subcommand === "models") {
             const apiKey = pluginConfig.apiKey || process.env.STRATUS_API_KEY;
             const models = await generateAllModels(apiKey, pluginConfig.baseUrl);
@@ -475,14 +503,17 @@ const stratusPlugin = {
             console.log("   openclaw agent 'Hello Stratus!' --model stratus\n");
             return { text: "" };
           } else {
-            // Show help
             return {
               text:
                 "🌊 Stratus X1-AC Plugin\n\n" +
                 "Commands:\n" +
-                "  /stratus setup   - Interactive setup wizard\n" +
-                "  /stratus verify  - Verify configuration\n" +
-                "  /stratus models  - List all available models (fetches live from API)\n\n" +
+                "  /stratus setup                    - Interactive setup wizard (Formation pool)\n" +
+                "  /stratus setup <stratus_sk_...>   - Non-interactive setup with API key\n" +
+                "  /stratus verify                   - Verify configuration & connectivity\n" +
+                "  /stratus models                   - List all available models (live from API)\n\n" +
+                "Agent/programmatic setup:\n" +
+                "  /stratus setup stratus_sk_your_key_here\n" +
+                "  # Or: set STRATUS_API_KEY env var → gateway auto-configures on start\n\n" +
                 "Get your API key: https://stratus.run\n" +
                 "Docs: https://stratus.run/docs\n" +
                 "Issues: https://github.com/formthefog/openclaw-stratus-x1-plugin/issues",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formthefog/stratus",
-  "version": "2026.3.19",
+  "version": "2026.3.20",
   "description": "Stratus API integration for OpenClaw - action-conditioned JEPA for autonomous agent planning",
   "keywords": [
     "agent",

package/src/setup.ts

@@ -14,18 +14,29 @@ interface SetupResult {
   details?: string[];
 }
 
-export async function setupStratus(prompter?: any): Promise<SetupResult> {
+interface SetupOptions {
+  apiKey?: string;
+  silent?: boolean;
+}
+
+export async function setupStratus(prompterOrOptions?: any, options?: SetupOptions): Promise<SetupResult> {
+  const opts: SetupOptions = options ?? (
+    prompterOrOptions && typeof prompterOrOptions === "object" && ("apiKey" in prompterOrOptions || "silent" in prompterOrOptions)
+      ? prompterOrOptions as SetupOptions
+      : {}
+  );
+
   const details: string[] = [];
 
   try {
-    const apiKey = process.env.STRATUS_API_KEY;
+    const apiKey = opts.apiKey || process.env.STRATUS_API_KEY;
     const usingFormationPool = !apiKey;
 
     if (apiKey) {
       if (!apiKey.startsWith("stratus_sk_")) {
         return {
           success: false,
-          message: "Invalid STRATUS_API_KEY format",
+          message: "Invalid API key format",
           details: [
             "API key must start with 'stratus_sk_'",
             "",
@@ -33,7 +44,7 @@ export async function setupStratus(prompter?: any): Promise<SetupResult> {
           ],
         };
       }
-      details.push("✓ Using STRATUS_API_KEY from environment (BYOK — no markup)");
+      details.push(`✓ Using Stratus API key (BYOK — no markup)${opts.apiKey ? " [provided via arg]" : " [from environment]"}`);
     } else {
       details.push("✓ No API key found — using Formation pooled keys (zero-config)");
       details.push("  ℹ  Formation pool applies a 25% markup on usage");
@@ -66,6 +77,7 @@ export async function setupStratus(prompter?: any): Promise<SetupResult> {
       if (!config.models.providers.stratus) {
         config.models.providers.stratus = {
           baseUrl: "https://api.stratus.run/v1",
+          ...(apiKey ? { apiKey } : {}),
           api: "openai-completions",
           models: [
             {
@@ -81,9 +93,26 @@ export async function setupStratus(prompter?: any): Promise<SetupResult> {
         };
         details.push("  ✓ Added Stratus provider configuration");
       } else {
+        if (apiKey && config.models.providers.stratus.apiKey !== apiKey) {
+          config.models.providers.stratus.apiKey = apiKey;
+          details.push("  ✓ Updated API key in provider config");
+        }
         details.push("  ✓ Stratus provider already configured");
       }
 
+      if (!config.plugins) config.plugins = {};
+      if (!config.plugins.entries) config.plugins.entries = {};
+      if (!config.plugins.entries.stratus) {
+        config.plugins.entries.stratus = { enabled: true, config: {} };
+      }
+      if (apiKey) {
+        config.plugins.entries.stratus.config = {
+          ...config.plugins.entries.stratus.config,
+          apiKey,
+        };
+        details.push("  ✓ Persisted API key in plugin config");
+      }
+
       if (config.agents?.defaults?.models?.["stratus/stratus-x1ac-base-claude-sonnet-4-5"]) {
         delete config.agents.defaults.models["stratus/stratus-x1ac-base-claude-sonnet-4-5"];
         details.push("  ✓ Removed restrictive model alias (allows all Stratus models)");