openfleet 0.3.13 → 0.3.15

package/dist/index.js

@@ -59,6 +59,7 @@ var models = {
 var defaultModel = models.anthropic.sonnet;
 var bigModel = defaultModel;
 var smallModel = defaultModel;
+var fallbackModel = models.freeModels.minimaxM25Free;
 
 // src/agents/names.ts
 var AGENT_NAMES = {
@@ -1125,6 +1126,83 @@ import { tool } from "@opencode-ai/plugin";
 import { existsSync as existsSync3, readFileSync } from "fs";
 import path3 from "path";
 
+// src/lib/fallback.ts
+var CREDIT_BALANCE_PATTERNS = [
+  "credit balance is too low",
+  "insufficient credits",
+  "please go to plans & billing",
+  "purchase credits"
+];
+var fallbackInProgress = new Set;
+var fallbackSessions = new Set;
+var lastFallbackTime = new Map;
+var COOLDOWN_MS = 30000;
+function isCreditBalanceError(message) {
+  const lower = message.toLowerCase();
+  return CREDIT_BALANCE_PATTERNS.some((p) => lower.includes(p));
+}
+function isSessionInFallback(sessionID) {
+  return fallbackSessions.has(sessionID);
+}
+function markSessionFallback(sessionID) {
+  fallbackSessions.add(sessionID);
+}
+function getFallbackModelOverride() {
+  const [providerID, modelID] = fallbackModel.split("/");
+  return { providerID, modelID };
+}
+async function handleCreditBalanceFallback(client, sessionID) {
+  if (fallbackInProgress.has(sessionID))
+    return;
+  const last = lastFallbackTime.get(sessionID);
+  if (last && Date.now() - last < COOLDOWN_MS)
+    return;
+  fallbackInProgress.add(sessionID);
+  fallbackSessions.add(sessionID);
+  lastFallbackTime.set(sessionID, Date.now());
+  try {
+    await client.session.abort({ path: { id: sessionID } });
+    const { data: messages } = await client.session.messages({
+      path: { id: sessionID }
+    });
+    if (!messages || messages.length === 0) {
+      throw new Error("No messages found after abort");
+    }
+    const lastUserMsg = [...messages].reverse().find((m) => m.info.role === "user");
+    if (!lastUserMsg) {
+      throw new Error("No user message found to revert to");
+    }
+    const textPart = lastUserMsg.parts.find((p) => p.type === "text");
+    if (!textPart || textPart.type !== "text")
+      return;
+    const messageID = lastUserMsg.info.id;
+    const text = textPart.text;
+    await client.session.revert({
+      path: { id: sessionID },
+      body: { messageID }
+    });
+    const [providerID, modelID] = fallbackModel.split("/");
+    await client.session.prompt({
+      path: { id: sessionID },
+      body: {
+        model: { providerID, modelID },
+        parts: [{ type: "text", text }]
+      }
+    });
+    logger.info("Credit balance fallback triggered", { sessionID, fallbackModel });
+    await client.tui.showToast({
+      body: {
+        message: "\u26A0\uFE0F Anthropic credit balance low \u2014 switched to Minimax M2.5 Free",
+        variant: "warning"
+      }
+    });
+  } catch (err) {
+    logger.error("Credit balance fallback failed", { sessionID, err });
+  } finally {
+    fallbackInProgress.delete(sessionID);
+  }
+}
+
 // src/transcript/writer.ts
 import { existsSync as existsSync2 } from "fs";
 import { appendFile, mkdir } from "fs/promises";
@@ -1329,6 +1407,11 @@ function createTranscriptHooks(ctx) {
       const session = await getSessionInfo(ctx, input.sessionID);
       await recordUserMessage(session, output.message, output.parts);
     },
+    "chat.model": async (input, output) => {
+      if (isSessionInFallback(input.sessionID)) {
+        output.model = getFallbackModelOverride();
+      }
+    },
     "tool.execute.before": async (input, output) => {
       const session = await getSessionInfo(ctx, input.sessionID);
       await recordToolUse(session, input.tool, input.callID, output.args);
@@ -1358,6 +1441,34 @@ function createTranscriptHooks(ctx) {
           err
         });
       }
+    },
+    event: async ({ event }) => {
+      if (event.type === "session.created") {
+        const { info } = event.properties;
+        if (info.parentID && isSessionInFallback(info.parentID)) {
+          markSessionFallback(info.id);
+        }
+      }
+      if (event.type === "session.status") {
+        const { sessionID, status } = event.properties;
+        if (status.type === "retry" && isCreditBalanceError(status.message)) {
+          await handleCreditBalanceFallback(ctx.client, sessionID);
+        }
+      }
+      if (event.type === "session.error") {
+        const { sessionID, error } = event.properties;
+        if (sessionID && error && "message" in error.data && isCreditBalanceError(String(error.data.message))) {
+          await handleCreditBalanceFallback(ctx.client, sessionID);
+        }
+      }
+      if (event.type === "message.updated") {
+        const { info } = event.properties;
+        if (info.role === "assistant" && info.error) {
+          if ("message" in info.error.data && isCreditBalanceError(String(info.error.data.message))) {
+            await handleCreditBalanceFallback(ctx.client, info.sessionID);
+          }
+        }
+      }
     }
   };
 }
@@ -1788,6 +1899,7 @@ var OpenfleetPlugin = async (ctx) => {
   logger.info("Plugin loaded");
   const saveConversation = createSaveConversationTool(ctx);
   const transcriptHooks = createTranscriptHooks(ctx);
+  const { event: transcriptEvent, ...otherTranscriptHooks } = transcriptHooks;
   return {
     tool: {
       save_conversation: saveConversation
@@ -1796,16 +1908,17 @@ var OpenfleetPlugin = async (ctx) => {
       configureAgents(config);
     },
     event: async ({ event }) => {
-      if (event.type !== "session.created")
-        return;
-      const props = event.properties;
-      if (props?.info?.parentID)
-        return;
-      setTimeout(async () => {
-        await showFleetToast(ctx);
-      }, 0);
+      if (event.type === "session.created") {
+        const props = event.properties;
+        if (!props?.info?.parentID) {
+          setTimeout(async () => {
+            await showFleetToast(ctx);
+          }, 0);
+        }
+      }
+      await transcriptEvent({ event });
     },
-    ...transcriptHooks
+    ...otherTranscriptHooks
   };
 };
 async function showFleetToast(ctx) {

package/dist/lib/fallback.d.ts

@@ -0,0 +1,23 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+/** Returns true if the message contains a known Anthropic credit balance error pattern. */
+export declare function isCreditBalanceError(message: string): boolean;
+/** Returns true if the given session or any ancestor has fallen back to the free model. */
+export declare function isSessionInFallback(sessionID: string): boolean;
+/** Marks a session as requiring fallback (used for child session propagation). */
+export declare function markSessionFallback(sessionID: string): void;
+/** Returns the fallback model split into providerID and modelID. */
+export declare function getFallbackModelOverride(): {
+    providerID: string;
+    modelID: string;
+};
+/**
+ * Handles automatic fallback to free model when Anthropic credit balance is low.
+ *
+ * This function:
+ * 1. Guards against re-entrant or rapid repeated fallbacks via in-progress set and cooldown
+ * 2. Aborts the current retry loop for the session
+ * 3. Finds and reverts to before the last user message
+ * 4. Re-sends that message using the fallback model
+ * 5. Shows a warning toast to the user
+ */
+export declare function handleCreditBalanceFallback(client: PluginInput["client"], sessionID: string): Promise<void>;

package/dist/models.d.ts

@@ -28,3 +28,4 @@ export declare const models: {
 export declare const defaultModel: "anthropic/claude-sonnet-4-6";
 export declare const bigModel: "anthropic/claude-sonnet-4-6";
 export declare const smallModel: "anthropic/claude-sonnet-4-6";
+export declare const fallbackModel: "opencode/minimax-m2.5-free";

package/dist/transcript/hooks.d.ts

@@ -1,4 +1,5 @@
 import type { PluginInput } from "@opencode-ai/plugin";
+import type { Event } from "@opencode-ai/sdk";
 export declare function createTranscriptHooks(ctx: PluginInput): {
     "chat.message": (input: {
         sessionID: string;
@@ -7,6 +8,19 @@ export declare function createTranscriptHooks(ctx: PluginInput): {
         message: unknown;
         parts: unknown[];
     }) => Promise<void>;
+    "chat.model": (input: {
+        sessionID: string;
+        agent: string;
+        model: {
+            providerID: string;
+            modelID: string;
+        };
+    }, output: {
+        model: {
+            providerID: string;
+            modelID: string;
+        };
+    }) => Promise<void>;
     "tool.execute.before": (input: {
         sessionID: string;
         tool: string;
@@ -26,4 +40,7 @@ export declare function createTranscriptHooks(ctx: PluginInput): {
     "experimental.chat.system.transform": (input: {}, output: {
         system: string[];
     }) => Promise<void>;
+    event: ({ event }: {
+        event: Event;
+    }) => Promise<void>;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfleet",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "description": "SPARR framework agents + infinite context for OpenCode",
   "type": "module",
   "main": "./dist/index.js",