simmer-automaton 0.6.1 → 0.6.3

package/dist/api.d.ts

@@ -35,6 +35,37 @@ export interface Skill {
     config?: Record<string, number | string | boolean>;
     pinned?: string[];
 }
+export interface BriefingPosition {
+    market_id: string;
+    question: string;
+    side: string;
+    shares: number;
+    avg_entry: number;
+    current_price: number;
+    pnl: number;
+    resolves_at: string | null;
+    source: string | null;
+}
+export interface BriefingResponse {
+    portfolio: {
+        total_pnl: number;
+        pnl_percent: number;
+        win_rate: number;
+        rank: number | null;
+        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;
+    }>;
+}
 export interface SkillOutcome {
     skill_slug: string;
     trades: number;
@@ -90,6 +121,7 @@ export declare class SimmerApi {
         outcomes: SkillOutcome[];
         since: string;
     }>;
+    getBriefing(): Promise<BriefingResponse>;
     postCycle(data: {
         active_skills: string[];
         cycle_number: number;

package/dist/api.js

@@ -70,6 +70,9 @@ export class SimmerApi {
         const params = new URLSearchParams({ since });
         return this.request(`/api/sdk/automaton/outcomes?${params}`);
     }
+    async getBriefing() {
+        return this.request("/api/sdk/briefing");
+    }
     async postCycle(data) {
         return this.request("/api/sdk/automaton/cycle", {
             method: "POST",

package/dist/index.js

@@ -19,6 +19,8 @@ let banditState = [];
 let currentTier = "normal";
 let cycleCount = 0;
 let currentSelectedMeta = [];
+let lastExecutionResults = [];
+let cachedPortfolio = null;
 let serviceRunning = false;
 let cycleTimer = null;
 let lastCycleTimestamp = new Date().toISOString();
@@ -163,6 +165,31 @@ function buildPromptContext() {
             lines.push(`- [${h.skill}] ${h.issue}: ${h.suggestion}`);
         }
     }
+    // --- Last execution results ---
+    if (lastExecutionResults.length > 0) {
+        lines.push("");
+        lines.push("**Last execution:**");
+        for (const r of lastExecutionResults) {
+            lines.push(`- ${r.ok ? "✓" : "✗"} ${r.slug}: ${r.detail}`);
+        }
+    }
+    // --- Portfolio snapshot ---
+    if (cachedPortfolio) {
+        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);
+            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)`);
+            }
+        }
+    }
     // --- Tier warnings ---
     if (currentTier === "critical") {
         lines.push("");
@@ -170,7 +197,7 @@ function buildPromptContext() {
     }
     // --- Instructions for human-facing queries ---
     lines.push("");
-    lines.push("**When your human asks about the automaton:** Report tier, budget, burn rate, which skills are running, and any tuning hints. Use `/simmer history` for recent cycle decisions. Don't dump raw data — summarize.");
+    lines.push("**When your human asks about the automaton:** Report tier, budget, positions, P&L, and which skills ran last cycle. Use `/simmer portfolio` for full position details. Don't dump raw data — summarize.");
     lines.push("");
     lines.push("**Currency formatting:** $SIM amounts must be written as `XXX $SIM` (e.g. `25.00 $SIM`, `100.00 $SIM`). NEVER write `$SIM25` or `$SIMxx` — the `$SIM` suffix goes AFTER the number. Real USDC uses `$` prefix (e.g. `$25.00`).");
     return lines.join("\n");
@@ -197,10 +224,10 @@ function formatStatus() {
 // =============================================================================
 async function executeSkills(selectedSlugs, workspaceDir, logger) {
     if (selectedSlugs.length === 0)
-        return;
+        return [];
     if (!runtime) {
         logger.error(`[simmer] runtime not initialized — skipping skill execution`);
-        return;
+        return [];
     }
     // Build execution plan from cached skills with entrypoints
     const tasks = [];
@@ -217,7 +244,7 @@ async function executeSkills(selectedSlugs, workspaceDir, logger) {
         tasks.push({ slug, entrypoint: skill.entrypoint });
     }
     if (tasks.length === 0)
-        return;
+        return [];
     const cwd = workspaceDir || process.cwd();
     const env = {
         ...process.env,
@@ -248,11 +275,23 @@ async function executeSkills(selectedSlugs, workspaceDir, logger) {
             throw e;
         }
     }));
-    const succeeded = results.filter((r) => r.status === "fulfilled").length;
-    const failed = results.filter((r) => r.status === "rejected").length;
+    const execResults = [];
+    for (let i = 0; i < tasks.length; i++) {
+        const r = results[i];
+        if (r.status === "fulfilled") {
+            const v = r.value;
+            execResults.push({ slug: v.slug, ok: v.code === 0, detail: v.code === 0 ? "ok" : `exit ${v.code}: ${v.stderr.slice(0, 100)}` });
+        }
+        else {
+            execResults.push({ slug: tasks[i].slug, ok: false, detail: `spawn error: ${r.reason}` });
+        }
+    }
+    const succeeded = execResults.filter((r) => r.ok).length;
+    const failed = execResults.filter((r) => !r.ok).length;
     if (failed > 0) {
         logger.warn(`[simmer] Skill execution: ${succeeded} succeeded, ${failed} failed`);
     }
+    return execResults;
 }
 // =============================================================================
 // Plugin registration
@@ -291,6 +330,7 @@ export default function register(pluginApi) {
                 if (!serviceRunning)
                     return;
                 cycleCount++;
+                const thisCycleNumber = cycleCount; // capture before refreshState may reset on re-init
                 const cycleStarted = lastCycleTimestamp;
                 lastCycleTimestamp = new Date().toISOString();
                 await refreshState(ctx.logger);
@@ -359,7 +399,7 @@ export default function register(pluginApi) {
                 try {
                     await api.postCycle({
                         active_skills: selected,
-                        cycle_number: cycleCount,
+                        cycle_number: thisCycleNumber,
                         selection_meta: meta.map((m) => ({ slug: m.slug, reason: m.reason, score: m.score })),
                         config_changes: configChangesPayload,
                     });
@@ -370,12 +410,30 @@ export default function register(pluginApi) {
                 // Execute selected skills deterministically
                 if (!cachedState?.halted && currentTier !== "dead" && selected.length > 0) {
                     try {
-                        await executeSkills(selected, ctx.workspaceDir, ctx.logger);
+                        lastExecutionResults = await executeSkills(selected, ctx.workspaceDir, ctx.logger);
                     }
                     catch (e) {
                         ctx.logger.error(`[simmer] Skill execution error: ${e}`);
+                        lastExecutionResults = [];
                     }
                 }
+                else {
+                    lastExecutionResults = [];
+                }
+                // Fetch portfolio snapshot for prompt context
+                try {
+                    const briefing = await api.getBriefing();
+                    const positions = briefing.positions || [];
+                    cachedPortfolio = {
+                        totalPnl: briefing.portfolio?.total_pnl ?? 0,
+                        positionCount: positions.length,
+                        positions,
+                        recentTradeCount: briefing.recent_trades?.length ?? 0,
+                    };
+                }
+                catch (e) {
+                    ctx.logger.warn(`[simmer] Failed to fetch briefing: ${e}`);
+                }
                 // Also record cycle history (fire-and-forget)
                 const cycleData = {
                     cycle_num: cycleCount,
@@ -561,8 +619,28 @@ export default function register(pluginApi) {
                     return { text: `Failed to reset config: ${e}` };
                 }
             }
+            if (subcommand === "portfolio") {
+                try {
+                    const briefing = await api.getBriefing();
+                    const positions = briefing.positions || [];
+                    if (positions.length === 0) {
+                        return { text: "No open positions." };
+                    }
+                    const lines = positions.map((p) => {
+                        const pnlStr = p.pnl >= 0 ? `+${fmtCurrency(p.pnl)}` : fmtCurrency(p.pnl);
+                        return `${p.question.slice(0, 55)} | ${p.side} ${p.shares}sh @ ${p.avg_entry.toFixed(2)} → ${p.current_price.toFixed(2)} | ${pnlStr}${p.source ? ` [${p.source}]` : ""}`;
+                    });
+                    const totalPnl = positions.reduce((sum, p) => sum + p.pnl, 0);
+                    return {
+                        text: `Positions (${positions.length}) | Total P&L: ${fmtCurrency(totalPnl)}\n\n${lines.join("\n")}`,
+                    };
+                }
+                catch (e) {
+                    return { text: `Failed to fetch portfolio: ${e}` };
+                }
+            }
             return {
-                text: "Usage: /simmer [status|halt|resume|skills|history [N]|disable <slug>|enable <slug>|config <slug>|tune <slug> <ENV> <val>|reset <slug>]",
+                text: "Usage: /simmer [status|halt|resume|skills|history [N]|portfolio|disable <slug>|enable <slug>|config <slug>|tune <slug> <ENV> <val>|reset <slug>]",
             };
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simmer-automaton",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Simmer Automaton plugin for OpenClaw — autonomous trading skill orchestration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,9 +9,17 @@
     "dev": "tsc --watch"
   },
   "openclaw": {
-    "extensions": ["./dist/index.js"]
+    "extensions": [
+      "./dist/index.js"
+    ]
   },
-  "keywords": ["openclaw", "plugin", "simmer", "prediction-markets", "trading"],
+  "keywords": [
+    "openclaw",
+    "plugin",
+    "simmer",
+    "prediction-markets",
+    "trading"
+  ],
   "license": "MIT",
   "devDependencies": {
     "typescript": "^5.4.0"

package/src/api.ts

@@ -39,6 +39,39 @@ export interface Skill {
   pinned?: string[];
 }
 
+export interface BriefingPosition {
+  market_id: string;
+  question: string;
+  side: string;
+  shares: number;
+  avg_entry: number;
+  current_price: number;
+  pnl: number;
+  resolves_at: string | null;
+  source: string | null;
+}
+
+export interface BriefingResponse {
+  portfolio: {
+    total_pnl: number;
+    pnl_percent: number;
+    win_rate: number;
+    rank: number | null;
+    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;
+  }>;
+}
+
 export interface SkillOutcome {
   skill_slug: string;
   trades: number;
@@ -139,6 +172,10 @@ export class SimmerApi {
     return this.request(`/api/sdk/automaton/outcomes?${params}`);
   }
 
+  async getBriefing(): Promise<BriefingResponse> {
+    return this.request("/api/sdk/briefing");
+  }
+
   async postCycle(data: {
     active_skills: string[];
     cycle_number: number;

package/src/index.ts

@@ -8,7 +8,7 @@
  */
 
 import { SimmerApi } from "./api.js";
-import type { AutomatonState, Skill, SkillOutcome } from "./api.js";
+import type { AutomatonState, Skill, SkillOutcome, BriefingPosition } from "./api.js";
 import { selectSkills, tierMaxSkills, type SkillState } from "./bandit.js";
 import { computeTier, type Tier } from "./tiers.js";
 import { generateTuningHints, computeTuningChanges, type ConfigChange } from "./tuning.js";
@@ -57,6 +57,8 @@ let banditState: SkillState[] = [];
 let currentTier: Tier = "normal";
 let cycleCount = 0;
 let currentSelectedMeta: Array<{ slug: string; reason: string; score: number | null }> = [];
+let lastExecutionResults: Array<{ slug: string; ok: boolean; detail: string }> = [];
+let cachedPortfolio: { totalPnl: number; positionCount: number; positions: BriefingPosition[]; recentTradeCount: number } | null = null;
 let serviceRunning = false;
 let cycleTimer: ReturnType<typeof setInterval> | null = null;
 let lastCycleTimestamp: string = new Date().toISOString();
@@ -203,6 +205,33 @@ function buildPromptContext(): string {
     }
   }
 
+  // --- Last execution results ---
+  if (lastExecutionResults.length > 0) {
+    lines.push("");
+    lines.push("**Last execution:**");
+    for (const r of lastExecutionResults) {
+      lines.push(`- ${r.ok ? "✓" : "✗"} ${r.slug}: ${r.detail}`);
+    }
+  }
+
+  // --- Portfolio snapshot ---
+  if (cachedPortfolio) {
+    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);
+      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)`);
+      }
+    }
+  }
+
   // --- Tier warnings ---
   if (currentTier === "critical") {
     lines.push("");
@@ -211,7 +240,7 @@ function buildPromptContext(): string {
 
   // --- Instructions for human-facing queries ---
   lines.push("");
-  lines.push("**When your human asks about the automaton:** Report tier, budget, burn rate, which skills are running, and any tuning hints. Use `/simmer history` for recent cycle decisions. Don't dump raw data — summarize.");
+  lines.push("**When your human asks about the automaton:** Report tier, budget, positions, P&L, and which skills ran last cycle. Use `/simmer portfolio` for full position details. Don't dump raw data — summarize.");
   lines.push("");
   lines.push("**Currency formatting:** $SIM amounts must be written as `XXX $SIM` (e.g. `25.00 $SIM`, `100.00 $SIM`). NEVER write `$SIM25` or `$SIMxx` — the `$SIM` suffix goes AFTER the number. Real USDC uses `$` prefix (e.g. `$25.00`).");
 
@@ -245,11 +274,11 @@ async function executeSkills(
   selectedSlugs: string[],
   workspaceDir: string | undefined,
   logger: { info: (m: string) => void; warn: (m: string) => void; error: (m: string) => void },
-): Promise<void> {
-  if (selectedSlugs.length === 0) return;
+): Promise<Array<{ slug: string; ok: boolean; detail: string }>> {
+  if (selectedSlugs.length === 0) return [];
   if (!runtime) {
     logger.error(`[simmer] runtime not initialized — skipping skill execution`);
-    return;
+    return [];
   }
 
   // Build execution plan from cached skills with entrypoints
@@ -267,7 +296,7 @@ async function executeSkills(
     tasks.push({ slug, entrypoint: skill.entrypoint });
   }
 
-  if (tasks.length === 0) return;
+  if (tasks.length === 0) return [];
 
   const cwd = workspaceDir || process.cwd();
   const env: NodeJS.ProcessEnv = {
@@ -303,11 +332,23 @@ async function executeSkills(
     }),
   );
 
-  const succeeded = results.filter((r) => r.status === "fulfilled").length;
-  const failed = results.filter((r) => r.status === "rejected").length;
+  const execResults: Array<{ slug: string; ok: boolean; detail: string }> = [];
+  for (let i = 0; i < tasks.length; i++) {
+    const r = results[i];
+    if (r.status === "fulfilled") {
+      const v = r.value;
+      execResults.push({ slug: v.slug, ok: v.code === 0, detail: v.code === 0 ? "ok" : `exit ${v.code}: ${v.stderr.slice(0, 100)}` });
+    } else {
+      execResults.push({ slug: tasks[i].slug, ok: false, detail: `spawn error: ${r.reason}` });
+    }
+  }
+
+  const succeeded = execResults.filter((r) => r.ok).length;
+  const failed = execResults.filter((r) => !r.ok).length;
   if (failed > 0) {
     logger.warn(`[simmer] Skill execution: ${succeeded} succeeded, ${failed} failed`);
   }
+  return execResults;
 }
 
 // =============================================================================
@@ -354,6 +395,7 @@ export default function register(pluginApi: PluginApi) {
       cycleTimer = setInterval(async () => {
         if (!serviceRunning) return;
         cycleCount++;
+        const thisCycleNumber = cycleCount; // capture before refreshState may reset on re-init
         const cycleStarted = lastCycleTimestamp;
         lastCycleTimestamp = new Date().toISOString();
 
@@ -430,7 +472,7 @@ export default function register(pluginApi: PluginApi) {
         try {
           await api.postCycle({
             active_skills: selected,
-            cycle_number: cycleCount,
+            cycle_number: thisCycleNumber,
             selection_meta: meta.map((m) => ({ slug: m.slug, reason: m.reason, score: m.score })),
             config_changes: configChangesPayload,
           });
@@ -441,10 +483,27 @@ export default function register(pluginApi: PluginApi) {
         // Execute selected skills deterministically
         if (!cachedState?.halted && currentTier !== "dead" && selected.length > 0) {
           try {
-            await executeSkills(selected, ctx.workspaceDir, ctx.logger);
+            lastExecutionResults = await executeSkills(selected, ctx.workspaceDir, ctx.logger);
           } catch (e) {
             ctx.logger.error(`[simmer] Skill execution error: ${e}`);
+            lastExecutionResults = [];
           }
+        } else {
+          lastExecutionResults = [];
+        }
+
+        // Fetch portfolio snapshot for prompt context
+        try {
+          const briefing = await api.getBriefing();
+          const positions = briefing.positions || [];
+          cachedPortfolio = {
+            totalPnl: briefing.portfolio?.total_pnl ?? 0,
+            positionCount: positions.length,
+            positions,
+            recentTradeCount: briefing.recent_trades?.length ?? 0,
+          };
+        } catch (e) {
+          ctx.logger.warn(`[simmer] Failed to fetch briefing: ${e}`);
         }
 
         // Also record cycle history (fire-and-forget)
@@ -640,8 +699,28 @@ export default function register(pluginApi: PluginApi) {
         }
       }
 
+      if (subcommand === "portfolio") {
+        try {
+          const briefing = await api.getBriefing();
+          const positions = briefing.positions || [];
+          if (positions.length === 0) {
+            return { text: "No open positions." };
+          }
+          const lines = positions.map((p: BriefingPosition) => {
+            const pnlStr = p.pnl >= 0 ? `+${fmtCurrency(p.pnl)}` : fmtCurrency(p.pnl);
+            return `${p.question.slice(0, 55)} | ${p.side} ${p.shares}sh @ ${p.avg_entry.toFixed(2)} → ${p.current_price.toFixed(2)} | ${pnlStr}${p.source ? ` [${p.source}]` : ""}`;
+          });
+          const totalPnl = positions.reduce((sum: number, p: BriefingPosition) => sum + p.pnl, 0);
+          return {
+            text: `Positions (${positions.length}) | Total P&L: ${fmtCurrency(totalPnl)}\n\n${lines.join("\n")}`,
+          };
+        } catch (e) {
+          return { text: `Failed to fetch portfolio: ${e}` };
+        }
+      }
+
       return {
-        text: "Usage: /simmer [status|halt|resume|skills|history [N]|disable <slug>|enable <slug>|config <slug>|tune <slug> <ENV> <val>|reset <slug>]",
+        text: "Usage: /simmer [status|halt|resume|skills|history [N]|portfolio|disable <slug>|enable <slug>|config <slug>|tune <slug> <ENV> <val>|reset <slug>]",
       };
     },
   });