@formthefog/stratus 2026.2.17

package/src/config.ts

@@ -0,0 +1,70 @@
+import type { OpenClawPluginConfigSchema } from "openclaw/plugin-sdk";
+import type { StratusPluginConfig } from "./types.js";
+
+export const StratusConfigSchema: OpenClawPluginConfigSchema = {
+  parse(value: unknown): StratusPluginConfig {
+    const raw =
+      value && typeof value === "object" && !Array.isArray(value)
+        ? (value as Record<string, unknown>)
+        : {};
+
+    const enabled = typeof raw.enabled === "boolean" ? raw.enabled : true;
+    const apiKey = typeof raw.apiKey === "string" ? raw.apiKey : process.env.STRATUS_API_KEY;
+    const baseUrl = typeof raw.baseUrl === "string" ? raw.baseUrl : "https://dev.api.stratus.run";
+
+    const provider =
+      raw.provider && typeof raw.provider === "object" && !Array.isArray(raw.provider)
+        ? (raw.provider as Record<string, unknown>)
+        : {};
+
+    const providerEnabled = typeof provider.enabled === "boolean" ? provider.enabled : true;
+    const defaultModel =
+      typeof provider.defaultModel === "string"
+        ? provider.defaultModel
+        : "stratus-x1ac-base-claude-sonnet-4-5";
+
+    const tools =
+      raw.tools && typeof raw.tools === "object" && !Array.isArray(raw.tools)
+        ? (raw.tools as Record<string, unknown>)
+        : {};
+
+    const embeddings =
+      tools.embeddings && typeof tools.embeddings === "object"
+        ? (tools.embeddings as Record<string, unknown>)
+        : {};
+    const rollout =
+      tools.rollout && typeof tools.rollout === "object"
+        ? (tools.rollout as Record<string, unknown>)
+        : {};
+
+    return {
+      enabled,
+      apiKey,
+      baseUrl,
+      provider: {
+        enabled: providerEnabled,
+        defaultModel,
+      },
+      tools: {
+        embeddings: {
+          enabled: typeof embeddings.enabled === "boolean" ? embeddings.enabled : true,
+        },
+        rollout: {
+          enabled: typeof rollout.enabled === "boolean" ? rollout.enabled : true,
+        },
+      },
+    };
+  },
+  uiHints: {
+    enabled: { label: "Enabled" },
+    apiKey: { label: "API Key", sensitive: true },
+    baseUrl: { label: "Base URL", placeholder: "https://dev.api.stratus.run" },
+    "provider.enabled": { label: "Provider Enabled" },
+    "provider.defaultModel": {
+      label: "Default Model",
+      placeholder: "stratus-x1ac-base-claude-sonnet-4-5",
+    },
+    "tools.embeddings.enabled": { label: "Embeddings Tool Enabled" },
+    "tools.rollout.enabled": { label: "Rollout Tool Enabled" },
+  },
+};

package/src/setup.ts

@@ -0,0 +1,210 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+
+/**
+ * Interactive setup command for Stratus plugin
+ *
+ * @purpose Handles automated configuration of Stratus plugin including OpenClaw config, auth profiles, and environment setup
+ */
+
+interface SetupResult {
+  success: boolean;
+  message: string;
+  details?: string[];
+}
+
+export async function setupStratus(prompter?: any): Promise<SetupResult> {
+  const details: string[] = [];
+
+  try {
+    // Step 1: Check for existing API key
+    const apiKey = process.env.STRATUS_API_KEY;
+
+    if (!apiKey) {
+      return {
+        success: false,
+        message: "STRATUS_API_KEY not found",
+        details: [
+          "Please set your Stratus API key as an environment variable:",
+          "",
+          "  export STRATUS_API_KEY=stratus_sk_your_key_here",
+          "",
+          "Or add to your shell config (~/.zshrc or ~/.bashrc):",
+          "",
+          "  echo 'export STRATUS_API_KEY=stratus_sk_your_key_here' >> ~/.zshrc",
+          "  source ~/.zshrc",
+          "",
+          "Get your API key at: https://stratus.run",
+        ],
+      };
+    }
+
+    details.push("✓ Using STRATUS_API_KEY from environment");
+
+    // Paths
+    const homeDir = os.homedir();
+    const openclawConfig = path.join(homeDir, ".openclaw", "openclaw.json");
+    const authProfiles = path.join(
+      homeDir,
+      ".openclaw",
+      "agents",
+      "main",
+      "agent",
+      "auth-profiles.json"
+    );
+
+    // Step 2: Update OpenClaw config
+    details.push("🔧 Updating OpenClaw configuration...");
+
+    if (fs.existsSync(openclawConfig)) {
+      // Backup
+      const backupPath = `${openclawConfig}.backup-${Date.now()}`;
+      fs.copyFileSync(openclawConfig, backupPath);
+      details.push(`  📦 Created backup: ${path.basename(backupPath)}`);
+
+      // Read and update config
+      const config = JSON.parse(fs.readFileSync(openclawConfig, "utf-8"));
+
+      // Add models.providers.stratus if not present
+      if (!config.models) {
+        config.models = {};
+      }
+      if (!config.models.providers) {
+        config.models.providers = {};
+      }
+      if (!config.models.providers.stratus) {
+        config.models.providers.stratus = {
+          baseUrl: "https://dev.api.stratus.run/v1",
+          api: "openai-completions",
+          models: [
+            {
+              id: "stratus-x1ac-base-claude-sonnet-4-5",
+              name: "Stratus X1AC Base (Claude 4.5 Sonnet)",
+              reasoning: true,
+              input: ["text", "image"],
+              cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+              contextWindow: 200000,
+              maxTokens: 8192,
+            },
+          ],
+        };
+        details.push("  ✓ Added Stratus provider configuration");
+      } else {
+        details.push("  ✓ Stratus provider already configured");
+      }
+
+      // Add model alias
+      if (!config.agents?.defaults?.models) {
+        if (!config.agents) config.agents = {};
+        if (!config.agents.defaults) config.agents.defaults = {};
+        if (!config.agents.defaults.models) config.agents.defaults.models = {};
+      }
+
+      if (!config.agents.defaults.models["stratus/stratus-x1ac-base-claude-sonnet-4-5"]) {
+        config.agents.defaults.models["stratus/stratus-x1ac-base-claude-sonnet-4-5"] = {
+          alias: "stratus",
+          params: {},
+        };
+        details.push("  ✓ Added model alias 'stratus'");
+      } else {
+        details.push("  ✓ Model alias already configured");
+      }
+
+      // Write updated config
+      fs.writeFileSync(openclawConfig, JSON.stringify(config, null, 2));
+    } else {
+      return {
+        success: false,
+        message: "OpenClaw config not found",
+        details: [
+          "Run 'openclaw setup' first to initialize OpenClaw",
+          "",
+          "Need help? Check the docs: https://docs.openclaw.ai",
+        ],
+      };
+    }
+
+    // Step 3: Update auth profiles
+    details.push("🔑 Configuring authentication...");
+
+    const authDir = path.dirname(authProfiles);
+    if (!fs.existsSync(authDir)) {
+      fs.mkdirSync(authDir, { recursive: true });
+    }
+
+    let authConfig: any;
+    if (fs.existsSync(authProfiles)) {
+      // Backup
+      const backupPath = `${authProfiles}.backup-${Date.now()}`;
+      fs.copyFileSync(authProfiles, backupPath);
+
+      // Update existing
+      authConfig = JSON.parse(fs.readFileSync(authProfiles, "utf-8"));
+    } else {
+      // Create new
+      authConfig = {
+        version: 1,
+        profiles: {},
+        lastGood: {},
+        usageStats: {},
+      };
+    }
+
+    // Add Stratus profile
+    authConfig.profiles["stratus:default"] = {
+      type: "api_key",
+      provider: "stratus",
+      key: apiKey,
+    };
+    authConfig.lastGood.stratus = "stratus:default";
+
+    fs.writeFileSync(authProfiles, JSON.stringify(authConfig, null, 2));
+    details.push("  ✓ Updated auth profile");
+
+    return {
+      success: true,
+      message: "Setup complete! 🎉",
+      details: [
+        ...details,
+        "",
+        "🎯 Next steps:",
+        "  1. Restart gateway: openclaw gateway stop && openclaw gateway install",
+        "  2. Verify: openclaw models list | grep stratus",
+        "  3. Test: openclaw agent 'Hello Stratus!' --model stratus",
+        "",
+        "📚 Available tools:",
+        "  • stratus_embeddings - Generate semantic embeddings",
+        "  • stratus_rollout - Multi-step task planning",
+      ],
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: "Setup failed",
+      details: [
+        error instanceof Error ? error.message : String(error),
+        "",
+        "Need help? Visit: https://stratus.run/docs",
+        "Report issues: https://github.com/formthefog/openclaw-stratus-x1-plugin/issues",
+      ],
+    };
+  }
+}
+
+function detectShellConfig(): string | null {
+  const homeDir = os.homedir();
+  const shell = process.env.SHELL || "";
+
+  if (shell.includes("zsh")) {
+    return path.join(homeDir, ".zshrc");
+  } else if (shell.includes("bash")) {
+    if (process.platform === "darwin") {
+      return path.join(homeDir, ".bash_profile");
+    } else {
+      return path.join(homeDir, ".bashrc");
+    }
+  }
+
+  return null;
+}

package/src/types.ts

@@ -0,0 +1,56 @@
+export interface StratusEmbeddingsRequest {
+  input: string | string[];
+  model?: string;
+  encoding_format?: "float" | "base64";
+}
+
+export interface StratusEmbeddingsResponse {
+  object: "list";
+  data: Array<{
+    object: "embedding";
+    index: number;
+    embedding: number[] | string;
+  }>;
+  model: string;
+  usage: {
+    prompt_tokens: number;
+    total_tokens: number;
+  };
+}
+
+export interface StratusRolloutRequest {
+  goal: string;
+  initial_state?: string;
+  max_steps?: number;
+  return_intermediate?: boolean;
+}
+
+export interface StratusRolloutStep {
+  action?: string;
+  description?: string;
+  state?: string;
+}
+
+export interface StratusRolloutResponse {
+  goal: string;
+  steps: StratusRolloutStep[];
+  success: boolean;
+  metadata?: {
+    model: string;
+    duration_ms?: number;
+  };
+}
+
+export interface StratusPluginConfig {
+  enabled?: boolean;
+  apiKey?: string;
+  baseUrl?: string;
+  provider?: {
+    enabled?: boolean;
+    defaultModel?: string;
+  };
+  tools?: {
+    embeddings?: { enabled?: boolean };
+    rollout?: { enabled?: boolean };
+  };
+}

package/verify.sh

@@ -0,0 +1,110 @@
+#!/bin/bash
+
+# Stratus OpenClaw Plugin Verification
+# Checks that everything is configured correctly
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  🔍 Stratus Plugin Verification"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+ERRORS=0
+
+# Check 1: Environment variable
+echo "1️⃣  Checking STRATUS_API_KEY..."
+if [[ -n "$STRATUS_API_KEY" ]]; then
+    echo "   ✓ STRATUS_API_KEY is set"
+else
+    echo "   ❌ STRATUS_API_KEY not found in environment"
+    ERRORS=$((ERRORS + 1))
+fi
+
+# Check 2: OpenClaw config
+echo ""
+echo "2️⃣  Checking OpenClaw configuration..."
+OPENCLAW_CONFIG="$HOME/.openclaw/openclaw.json"
+if [[ -f "$OPENCLAW_CONFIG" ]]; then
+    if jq -e '.models.providers.stratus' "$OPENCLAW_CONFIG" > /dev/null 2>&1; then
+        echo "   ✓ Stratus provider configured"
+    else
+        echo "   ❌ Stratus provider not in config"
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    if jq -e '.agents.defaults.models["stratus/stratus-x1ac-base-claude-sonnet-4-5"]' "$OPENCLAW_CONFIG" > /dev/null 2>&1; then
+        echo "   ✓ Stratus model alias configured"
+    else
+        echo "   ❌ Stratus model alias not configured"
+        ERRORS=$((ERRORS + 1))
+    fi
+else
+    echo "   ❌ OpenClaw config not found"
+    ERRORS=$((ERRORS + 1))
+fi
+
+# Check 3: Auth profile
+echo ""
+echo "3️⃣  Checking authentication profile..."
+AUTH_PROFILES="$HOME/.openclaw/agents/main/agent/auth-profiles.json"
+if [[ -f "$AUTH_PROFILES" ]]; then
+    if jq -e '.profiles["stratus:default"]' "$AUTH_PROFILES" > /dev/null 2>&1; then
+        echo "   ✓ Stratus auth profile exists"
+    else
+        echo "   ❌ Stratus auth profile not found"
+        ERRORS=$((ERRORS + 1))
+    fi
+else
+    echo "   ❌ Auth profiles file not found"
+    ERRORS=$((ERRORS + 1))
+fi
+
+# Check 4: Plugin loaded
+echo ""
+echo "4️⃣  Checking plugin status..."
+if command -v openclaw > /dev/null 2>&1; then
+    if openclaw plugins info stratus 2>&1 | grep -q "Status: loaded"; then
+        echo "   ✓ Plugin loaded successfully"
+    else
+        echo "   ⚠️  Plugin not loaded (restart gateway)"
+    fi
+
+    # Check 5: Models available
+    echo ""
+    echo "5️⃣  Checking model availability..."
+    if openclaw models list 2>&1 | grep -q "stratus"; then
+        echo "   ✓ Stratus model available"
+    else
+        echo "   ❌ Stratus model not in model list"
+        ERRORS=$((ERRORS + 1))
+    fi
+
+    # Check 6: Gateway status
+    echo ""
+    echo "6️⃣  Checking gateway..."
+    if openclaw gateway status 2>&1 | grep -q "RPC probe: ok"; then
+        echo "   ✓ Gateway operational"
+    else
+        echo "   ⚠️  Gateway not responding"
+    fi
+else
+    echo "   ⚠️  OpenClaw CLI not found (install OpenClaw first)"
+fi
+
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+if [[ $ERRORS -eq 0 ]]; then
+    echo "  ✅ All checks passed!"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "🎯 Try it out:"
+    echo "   openclaw agent 'Hello Stratus!' --model stratus"
+    echo ""
+    exit 0
+else
+    echo "  ❌ $ERRORS issue(s) found"
+    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+    echo ""
+    echo "💡 Try running: ./install.sh"
+    echo ""
+    exit 1
+fi