openfleet 0.3.12 → 0.3.14

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 = {
@@ -1121,6 +1122,84 @@ var logger = {
 // src/tools/save-conversation/index.ts
 import { tool } from "@opencode-ai/plugin";
 
+// src/transcript/hooks.ts
+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 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";
@@ -1292,6 +1371,9 @@ function extractContentFromParts(parts) {
 
 // src/transcript/hooks.ts
 var sessionInfoCache = new Map;
+var sessionAgentMap = new Map;
+var WORKSPACE_DIR = process.env.WORKSPACE_DIR ?? process.cwd();
+var AGENT_OVERRIDE_DIR = path3.join(WORKSPACE_DIR, ".opencode", "agents");
 async function getSessionInfo(ctx, sessionID) {
   const cached = sessionInfoCache.get(sessionID);
   if (cached)
@@ -1316,9 +1398,17 @@ async function getSessionInfo(ctx, sessionID) {
 function createTranscriptHooks(ctx) {
   return {
     "chat.message": async (input, output) => {
+      if (input.agent) {
+        sessionAgentMap.set(input.sessionID, input.agent);
+      }
       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);
@@ -1326,18 +1416,62 @@ function createTranscriptHooks(ctx) {
     "tool.execute.after": async (input, output) => {
       const session = await getSessionInfo(ctx, input.sessionID);
       await recordToolResult(session, input.tool, input.callID, output);
+    },
+    "experimental.chat.system.transform": async (input, output) => {
+      const agentName = input.sessionID ? sessionAgentMap.get(input.sessionID) : undefined;
+      if (!agentName)
+        return;
+      const overridePath = path3.join(AGENT_OVERRIDE_DIR, agentName, "system_prompt.md");
+      if (!overridePath.startsWith(AGENT_OVERRIDE_DIR + path3.sep))
+        return;
+      if (!existsSync3(overridePath))
+        return;
+      try {
+        const content = readFileSync(overridePath, "utf-8").trim();
+        if (content) {
+          output.system.push(content);
+        }
+      } catch (err) {
+        logger.error("Failed to read agent system prompt override", {
+          agentName,
+          overridePath,
+          err
+        });
+      }
+    },
+    event: async ({ event }) => {
+      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);
+          }
+        }
+      }
     }
   };
 }
 // src/tools/save-conversation/counter.ts
 import * as fs from "fs";
-import * as path3 from "path";
+import * as path4 from "path";
 var SESSIONS_DIR = PATHS.sessions;
 var MAX_COUNTER = 999;
 var FILENAME_PATTERN = /^(\d{3})_(.+)\.md$/;
 async function getNextCounter(date) {
   try {
-    const dateDir = path3.join(SESSIONS_DIR, date);
+    const dateDir = path4.join(SESSIONS_DIR, date);
     ensureDateDir(dateDir);
     const files = fs.readdirSync(dateDir);
     const counters = files.map((file) => parseFilename(file)).filter((parsed) => parsed !== null).map((parsed) => parsed.counter);
@@ -1380,13 +1514,13 @@ function getCurrentDate() {
 
 // src/tools/save-conversation/session-writer.ts
 import * as fs2 from "fs";
-import * as path4 from "path";
+import * as path5 from "path";
 var SESSIONS_DIR2 = PATHS.sessions;
 function writeSession(entry) {
-  const dateDir = path4.join(SESSIONS_DIR2, entry.date);
+  const dateDir = path5.join(SESSIONS_DIR2, entry.date);
   ensureDateDir2(dateDir);
   const filename = `${entry.counter}_${entry.slug}.md`;
-  const filepath = path4.join(dateDir, filename);
+  const filepath = path5.join(dateDir, filename);
   const content = buildSessionContent(entry);
   try {
     fs2.writeFileSync(filepath, content, { encoding: "utf8" });
@@ -1698,9 +1832,9 @@ function buildContextString(messages, note) {
 
 // src/utils/directory-init.ts
 import * as fs3 from "fs";
-import * as path5 from "path";
+import * as path6 from "path";
 import { fileURLToPath } from "url";
-var TEMPLATES_DIR = path5.join(path5.dirname(fileURLToPath(import.meta.url)), "templates", ".openfleet");
+var TEMPLATES_DIR = path6.join(path6.dirname(fileURLToPath(import.meta.url)), "templates", ".openfleet");
 function initializeDirectories() {
   if (fs3.existsSync(OPENFLEET_DIR)) {
     return;
@@ -1712,9 +1846,9 @@ function copyDirectorySync(src, dest) {
   fs3.mkdirSync(dest, { recursive: true });
   const entries = fs3.readdirSync(src, { withFileTypes: true });
   for (const entry of entries) {
-    const srcPath = path5.join(src, entry.name);
+    const srcPath = path6.join(src, entry.name);
     const destName = entry.name === "gitignore.template" ? ".gitignore" : entry.name;
-    const destPath = path5.join(dest, destName);
+    const destPath = path6.join(dest, destName);
     if (entry.isDirectory()) {
       copyDirectorySync(srcPath, destPath);
     } else {
@@ -1756,6 +1890,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
@@ -1764,16 +1899,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,21 @@
+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 has previously fallen back to the free model. */
+export declare function isSessionInFallback(sessionID: string): boolean;
+/** 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,11 +1,26 @@
 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;
+        agent?: string;
     }, output: {
         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;
@@ -22,4 +37,10 @@ export declare function createTranscriptHooks(ctx: PluginInput): {
         output: string;
         metadata?: unknown;
     }) => Promise<void>;
+    "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.12",
+  "version": "0.3.14",
   "description": "SPARR framework agents + infinite context for OpenCode",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,6 +22,8 @@
     "build": "rm -rf dist && bun build src/index.ts --outdir dist --target bun --format esm --external @opencode-ai/plugin --external @opencode-ai/sdk --external @anthropic-ai/sdk && tsc --emitDeclarationOnly && cp -r src/templates dist/",
     "dev": "tsup src/index.ts --format esm --dts --watch",
     "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "prepare": "husky"
@@ -36,9 +38,10 @@
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
+    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
     "@opencode-ai/plugin": "~1.0.224",
     "@opencode-ai/sdk": "~1.0.224",
-    "@ianvs/prettier-plugin-sort-imports": "^4.7.0",
+    "@types/bun": "^1.3.10",
     "@types/node": "^22",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",