simmer-automaton 0.6.5 → 0.6.7

package/dist/api.d.ts

@@ -46,8 +46,31 @@ export interface BriefingPosition {
     resolves_at: string | null;
     source: string | null;
 }
+export interface BriefingVenue {
+    currency: string;
+    balance: number | null;
+    pnl: number;
+    positions_count: number;
+    redeemable_count?: number;
+    positions_needing_attention: BriefingPosition[];
+    actions: string[];
+    by_skill?: Record<string, {
+        count: number;
+        pnl: number;
+    }>;
+}
 export interface BriefingResponse {
-    portfolio: {
+    venues: {
+        simmer: BriefingVenue | null;
+        polymarket: BriefingVenue | null;
+        kalshi: BriefingVenue | null;
+    };
+    opportunities: {
+        new_markets: Array<Record<string, unknown>>;
+        recommended_skills: Array<Record<string, unknown>>;
+    };
+    risk_alerts: string[];
+    performance: {
         total_pnl: number;
         pnl_percent: number;
         win_rate: number;
@@ -55,16 +78,12 @@ export interface BriefingResponse {
         total_agents: number;
         settled_pnl: number;
     };
-    positions: BriefingPosition[];
-    recent_trades: Array<{
-        market_question: string;
-        action: string;
-        side: string;
-        shares: number;
-        cost: number;
-        source: string | null;
-        created_at: string;
-    }>;
+    checked_at: string;
+    sdk_update: {
+        current: string;
+        latest: string;
+        message: string;
+    } | null;
 }
 export interface SkillOutcome {
     skill_slug: string;
@@ -122,6 +141,9 @@ export declare class SimmerApi {
         since: string;
     }>;
     getBriefing(): Promise<BriefingResponse>;
+    getPositions(): Promise<{
+        positions: BriefingPosition[];
+    }>;
     postCycle(data: {
         active_skills: string[];
         cycle_number: number;

package/dist/api.js

@@ -73,6 +73,9 @@ export class SimmerApi {
     async getBriefing() {
         return this.request("/api/sdk/briefing");
     }
+    async getPositions() {
+        return this.request("/api/sdk/positions");
+    }
     async postCycle(data) {
         return this.request("/api/sdk/automaton/cycle", {
             method: "POST",

package/dist/index.js

@@ -85,8 +85,7 @@ async function refreshState(logger) {
             if (cachedState.venue) {
                 config.venue = cachedState.venue;
             }
-            // Compute tier (totalPnl = 0 for now, will be enriched when P&L tracking is added)
-            currentTier = computeTier(cachedState, 0);
+            currentTier = computeTier(cachedState, cachedPortfolio?.totalPnl ?? 0);
             // Sync banditState from fetched skills — preserve memory for existing, seed new ones
             const existingBySlug = new Map(banditState.map((s) => [s.slug, s]));
             banditState = cachedSkills.map((skill) => {
@@ -178,15 +177,15 @@ function buildPromptContext() {
         lines.push("");
         lines.push(`**Portfolio:** ${cachedPortfolio.positionCount} positions | P&L: ${fmtCurrency(cachedPortfolio.totalPnl)} | Recent trades: ${cachedPortfolio.recentTradeCount}`);
         if (cachedPortfolio.positions.length > 0) {
-            // Show top 3 by absolute PnL
-            const sorted = [...cachedPortfolio.positions].sort((a, b) => Math.abs(b.pnl) - Math.abs(a.pnl));
-            const top = sorted.slice(0, 3);
+            // Show positions needing attention (significant moves or nearing expiry)
+            lines.push("  Needing attention:");
+            const top = cachedPortfolio.positions.slice(0, 3);
             for (const p of top) {
                 const pnlStr = p.pnl >= 0 ? `+${fmtCurrency(p.pnl)}` : fmtCurrency(p.pnl);
                 lines.push(`  - ${p.question.slice(0, 60)} | ${p.side} ${p.shares} shares @ ${p.avg_entry.toFixed(2)} → ${p.current_price.toFixed(2)} | ${pnlStr}`);
             }
-            if (sorted.length > 3) {
-                lines.push(`  - ...and ${sorted.length - 3} more (use /simmer portfolio for full list)`);
+            if (cachedPortfolio.positions.length > 3) {
+                lines.push(`  - ...and ${cachedPortfolio.positions.length - 3} more needing attention`);
             }
         }
     }
@@ -298,9 +297,11 @@ async function executeSkills(selectedSlugs, workspaceDir, logger) {
 // =============================================================================
 export default function register(pluginApi) {
     loadConfig(pluginApi.pluginConfig);
-    // Fall back to SIMMER_API_KEY env var if no plugin config apiKey
-    if (!config.apiKey) {
-        config.apiKey = process.env.SIMMER_API_KEY || "";
+    // Env var takes priority; fall back to plugin config only if env var is absent.
+    // This prevents placeholder values in openclaw.json from shadowing the real key.
+    const envKey = process.env.SIMMER_API_KEY || "";
+    if (envKey) {
+        config.apiKey = envKey;
     }
     if (!config.apiKey) {
         pluginApi.logger.error("[simmer] No apiKey in plugin config or SIMMER_API_KEY env var — plugin disabled");
@@ -423,12 +424,13 @@ export default function register(pluginApi) {
                 // Fetch portfolio snapshot for prompt context
                 try {
                     const briefing = await api.getBriefing();
-                    const positions = briefing.positions || [];
+                    const venue = briefing.venues?.simmer;
+                    const attentionPositions = venue?.positions_needing_attention || [];
                     cachedPortfolio = {
-                        totalPnl: briefing.portfolio?.total_pnl ?? 0,
-                        positionCount: positions.length,
-                        positions,
-                        recentTradeCount: briefing.recent_trades?.length ?? 0,
+                        totalPnl: briefing.performance?.total_pnl ?? 0,
+                        positionCount: venue?.positions_count ?? 0,
+                        positions: attentionPositions,
+                        recentTradeCount: 0,
                     };
                 }
                 catch (e) {
@@ -621,8 +623,8 @@ export default function register(pluginApi) {
             }
             if (subcommand === "portfolio") {
                 try {
-                    const briefing = await api.getBriefing();
-                    const positions = briefing.positions || [];
+                    const res = await api.getPositions();
+                    const positions = res.positions || [];
                     if (positions.length === 0) {
                         return { text: "No open positions." };
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simmer-automaton",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Simmer Automaton plugin for OpenClaw — autonomous trading skill orchestration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/api.ts

@@ -51,8 +51,29 @@ export interface BriefingPosition {
   source: string | null;
 }
 
+export interface BriefingVenue {
+  currency: string;
+  balance: number | null;
+  pnl: number;
+  positions_count: number;
+  redeemable_count?: number;
+  positions_needing_attention: BriefingPosition[];
+  actions: string[];
+  by_skill?: Record<string, { count: number; pnl: number }>;
+}
+
 export interface BriefingResponse {
-  portfolio: {
+  venues: {
+    simmer: BriefingVenue | null;
+    polymarket: BriefingVenue | null;
+    kalshi: BriefingVenue | null;
+  };
+  opportunities: {
+    new_markets: Array<Record<string, unknown>>;
+    recommended_skills: Array<Record<string, unknown>>;
+  };
+  risk_alerts: string[];
+  performance: {
     total_pnl: number;
     pnl_percent: number;
     win_rate: number;
@@ -60,16 +81,8 @@ export interface BriefingResponse {
     total_agents: number;
     settled_pnl: number;
   };
-  positions: BriefingPosition[];
-  recent_trades: Array<{
-    market_question: string;
-    action: string;
-    side: string;
-    shares: number;
-    cost: number;
-    source: string | null;
-    created_at: string;
-  }>;
+  checked_at: string;
+  sdk_update: { current: string; latest: string; message: string } | null;
 }
 
 export interface SkillOutcome {
@@ -176,6 +189,10 @@ export class SimmerApi {
     return this.request("/api/sdk/briefing");
   }
 
+  async getPositions(): Promise<{ positions: BriefingPosition[] }> {
+    return this.request("/api/sdk/positions");
+  }
+
   async postCycle(data: {
     active_skills: string[];
     cycle_number: number;

package/src/index.ts

@@ -117,8 +117,7 @@ async function refreshState(logger: { info: (m: string) => void; error: (m: stri
       if (cachedState.venue) {
         config.venue = cachedState.venue;
       }
-      // Compute tier (totalPnl = 0 for now, will be enriched when P&L tracking is added)
-      currentTier = computeTier(cachedState, 0);
+      currentTier = computeTier(cachedState, cachedPortfolio?.totalPnl ?? 0);
 
       // Sync banditState from fetched skills — preserve memory for existing, seed new ones
       const existingBySlug = new Map(banditState.map((s) => [s.slug, s]));
@@ -219,15 +218,15 @@ function buildPromptContext(): string {
     lines.push("");
     lines.push(`**Portfolio:** ${cachedPortfolio.positionCount} positions | P&L: ${fmtCurrency(cachedPortfolio.totalPnl)} | Recent trades: ${cachedPortfolio.recentTradeCount}`);
     if (cachedPortfolio.positions.length > 0) {
-      // Show top 3 by absolute PnL
-      const sorted = [...cachedPortfolio.positions].sort((a, b) => Math.abs(b.pnl) - Math.abs(a.pnl));
-      const top = sorted.slice(0, 3);
+      // Show positions needing attention (significant moves or nearing expiry)
+      lines.push("  Needing attention:");
+      const top = cachedPortfolio.positions.slice(0, 3);
       for (const p of top) {
         const pnlStr = p.pnl >= 0 ? `+${fmtCurrency(p.pnl)}` : fmtCurrency(p.pnl);
         lines.push(`  - ${p.question.slice(0, 60)} | ${p.side} ${p.shares} shares @ ${p.avg_entry.toFixed(2)} → ${p.current_price.toFixed(2)} | ${pnlStr}`);
       }
-      if (sorted.length > 3) {
-        lines.push(`  - ...and ${sorted.length - 3} more (use /simmer portfolio for full list)`);
+      if (cachedPortfolio.positions.length > 3) {
+        lines.push(`  - ...and ${cachedPortfolio.positions.length - 3} more needing attention`);
       }
     }
   }
@@ -358,9 +357,11 @@ async function executeSkills(
 export default function register(pluginApi: PluginApi) {
   loadConfig(pluginApi.pluginConfig);
 
-  // Fall back to SIMMER_API_KEY env var if no plugin config apiKey
-  if (!config.apiKey) {
-    config.apiKey = process.env.SIMMER_API_KEY || "";
+  // Env var takes priority; fall back to plugin config only if env var is absent.
+  // This prevents placeholder values in openclaw.json from shadowing the real key.
+  const envKey = process.env.SIMMER_API_KEY || "";
+  if (envKey) {
+    config.apiKey = envKey;
   }
 
   if (!config.apiKey) {
@@ -495,12 +496,13 @@ export default function register(pluginApi: PluginApi) {
         // Fetch portfolio snapshot for prompt context
         try {
           const briefing = await api.getBriefing();
-          const positions = briefing.positions || [];
+          const venue = briefing.venues?.simmer;
+          const attentionPositions = venue?.positions_needing_attention || [];
           cachedPortfolio = {
-            totalPnl: briefing.portfolio?.total_pnl ?? 0,
-            positionCount: positions.length,
-            positions,
-            recentTradeCount: briefing.recent_trades?.length ?? 0,
+            totalPnl: briefing.performance?.total_pnl ?? 0,
+            positionCount: venue?.positions_count ?? 0,
+            positions: attentionPositions,
+            recentTradeCount: 0,
           };
         } catch (e) {
           ctx.logger.warn(`[simmer] Failed to fetch briefing: ${e}`);
@@ -701,8 +703,8 @@ export default function register(pluginApi: PluginApi) {
 
       if (subcommand === "portfolio") {
         try {
-          const briefing = await api.getBriefing();
-          const positions = briefing.positions || [];
+          const res = await api.getPositions();
+          const positions = res.positions || [];
           if (positions.length === 0) {
             return { text: "No open positions." };
           }