@iinm/plain-agent 1.7.17 → 1.7.19

package/README.md

@@ -152,6 +152,19 @@ Create the configuration.
 <details>
 <summary><b>OpenAI compatible provider examples</b></summary>
 
+```js
+{
+  "platforms": [
+    {
+      "name": "openai-compatible",
+      "variant": "fireworks",
+      "baseURL": "https://api.fireworks.ai/inference",
+      "apiKey": "<FIREWORKS_API_KEY>"
+    }
+  ]
+}
+```
+
 ```js
 {
   "platforms": [
@@ -160,21 +173,26 @@ Create the configuration.
       "variant": "ollama",
       "baseURL": "https://ollama.com",
       "apiKey": "<API_KEY>"
-    },
-    {
-      "name": "openai-compatible",
-      "variant": "huggingface",
-      "baseURL": "https://router.huggingface.co",
-      "apiKey": "<HUGGINGFACE_API_KEY>"
-    },
+    }
+  ],
+  "models": [
     {
-      "name": "openai-compatible",
-      "variant": "fireworks",
-      "baseURL": "https://api.fireworks.ai/inference",
-      "apiKey": "<FIREWORKS_API_KEY>"
+      "name": "gpt-oss",
+      "variant": "ollama",
+      "platform": {
+        "name": "openai-compatible",
+        "variant": "ollama"
+      },
+      "model": {
+        "format": "openai-responses",
+        "config": {
+          "model": "gpt-oss:120b-cloud"
+        }
+      }
     }
   ]
 }
+
 ```
 </details>
 
@@ -183,6 +201,14 @@ Create the configuration.
 
 ```js
 {
+  "platforms": [
+    {
+      "name": "bedrock",
+      "variant": "jp",
+      "baseURL": "https://bedrock-runtime.ap-northeast-1.amazonaws.com",
+      "awsProfile": "<AWS_PROFILE>"
+    }
+  ],
   "models": [
     {
       "name": "claude-haiku-4-5",
@@ -237,14 +263,6 @@ Create the configuration.
         }
       }
     }
-  ],
-  "platforms": [
-    {
-      "name": "bedrock",
-      "variant": "jp",
-      "baseURL": "https://bedrock-runtime.ap-northeast-1.amazonaws.com",
-      "awsProfile": "<AWS_PROFILE>"
-    }
   ]
 }
 ```
@@ -289,6 +307,17 @@ Display the help message.
 /help
 ```
 
+Show aggregated token cost per day across sessions.
+Each finished session appends a record to `~/.local/share/plain-agent/usage.jsonl`,
+and `plain cost` reads that log. The period defaults to the first day of the
+current month through today; override it with `--from` / `--to`. Multiple
+currencies (e.g., USD and JPY) are aggregated separately.
+
+```sh
+plain cost
+plain cost --from 2026-04-01 --to 2026-04-30
+```
+
 Interrupt the agent while it's running:
 
 Press **Ctrl-C** to pause auto-approve. The agent will finish the current tool call, then return to the prompt.
@@ -307,7 +336,7 @@ The agent can use the following tools to assist with tasks:
 - **report_as_subagent**: Report completion and return to the main agent. Used by subagents to communicate results and restore the main agent role. After reporting, the subagent's conversation history is removed from the context.
 - **compact_context**: Compact the conversation context by discarding prior messages and reloading task state from a memory file. Use when the context has grown large but the task is not yet complete. Can also be invoked via the `/compact` slash command.
 
-## Directory Structure
+## Configuration
 
 ```
 ~/.config/plain-agent/
@@ -325,14 +354,12 @@ The agent can use the following tools to assist with tasks:
         \__ agents/                # Project-specific agent roles
 ```
 
-## Configuration
-
 The agent loads configuration files in the following order. Settings in later files will override those in earlier files.
 
-- `~/.config/plain-agent/config.json`: User configuration for all projects.
-- `~/.config/plain-agent/config.local.json`: User local configuration, typically for API keys.
-- `.plain-agent/config.json`: Project-specific configuration.
-- `.plain-agent/config.local.json`: Project-specific local configuration, typically for API keys or local development overrides.
+- `~/.config/plain-agent/config.json`
+- `~/.config/plain-agent/config.local.json`
+- `.plain-agent/config.json`
+- `.plain-agent/config.local.json`
 
 ### Example
 

package/config/config.predefined.json

@@ -910,37 +910,6 @@
       }
     },
 
-    {
-      "name": "grok-4-1-fast-reasoning",
-      "variant": "default",
-      "platform": {
-        "name": "openai",
-        "variant": "xai",
-        "baseURL": "https://api.x.ai"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "grok-4-1-fast-reasoning"
-        }
-      }
-    },
-    {
-      "name": "grok-4.20-0309-reasoning",
-      "variant": "default",
-      "platform": {
-        "name": "openai",
-        "variant": "xai",
-        "baseURL": "https://api.x.ai"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "grok-4.20-0309-reasoning"
-        }
-      }
-    },
-
     {
       "name": "glm-5",
       "variant": "vertex-ai",
@@ -964,21 +933,6 @@
         }
       }
     },
-    {
-      "name": "glm-5",
-      "variant": "bedrock",
-      "platform": {
-        "name": "bedrock",
-        "variant": "default"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "zai.glm-5",
-          "reasoning_effort": "high"
-        }
-      }
-    },
     {
       "name": "glm-5.1",
       "variant": "fireworks",
@@ -1002,52 +956,9 @@
         }
       }
     },
-    {
-      "name": "glm-5.1",
-      "variant": "ollama",
-      "platform": {
-        "name": "openai-compatible",
-        "variant": "ollama"
-      },
-      "model": {
-        "format": "openai-responses",
-        "config": {
-          "model": "glm-5:cloud"
-        }
-      }
-    },
-    {
-      "name": "glm-5.1",
-      "variant": "huggingface",
-      "platform": {
-        "name": "openai-compatible",
-        "variant": "huggingface"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "zai-org/GLM-5.1:together"
-        }
-      }
-    },
 
     {
-      "name": "kimi-k2.5",
-      "variant": "bedrock",
-      "platform": {
-        "name": "bedrock",
-        "variant": "default"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "moonshotai.kimi-k2.5",
-          "reasoning_effort": "high"
-        }
-      }
-    },
-    {
-      "name": "kimi-k2.5",
+      "name": "kimi-k2.6",
       "variant": "fireworks",
       "platform": {
         "name": "openai-compatible",
@@ -1056,16 +967,16 @@
       "model": {
         "format": "openai-messages",
         "config": {
-          "model": "accounts/fireworks/models/kimi-k2p5"
+          "model": "accounts/fireworks/models/kimi-k2p6"
         }
       },
       "cost": {
         "currency": "USD",
         "unit": "1M",
         "costs": {
-          "prompt_tokens": 0.6,
-          "prompt_tokens_details.cached_tokens": -0.5,
-          "completion_tokens": 3
+          "prompt_tokens": 0.95,
+          "prompt_tokens_details.cached_tokens": -0.79,
+          "completion_tokens": 4
         }
       }
     },
@@ -1085,21 +996,6 @@
         }
       }
     },
-    {
-      "name": "deepseek-v3.2",
-      "variant": "bedrock",
-      "platform": {
-        "name": "bedrock",
-        "variant": "default"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "deepseek.v3.2",
-          "reasoning_effort": "high"
-        }
-      }
-    },
     {
       "name": "deepseek-v3.2",
       "variant": "fireworks",
@@ -1123,23 +1019,9 @@
         }
       }
     },
+
     {
-      "name": "minimax-m2.1",
-      "variant": "bedrock",
-      "platform": {
-        "name": "bedrock",
-        "variant": "default"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "minimax.minimax-m2.1",
-          "reasoning_effort": "high"
-        }
-      }
-    },
-    {
-      "name": "minimax-m2.5",
+      "name": "minimax-m2.7",
       "variant": "fireworks",
       "platform": {
         "name": "openai-compatible",
@@ -1148,7 +1030,7 @@
       "model": {
         "format": "openai-messages",
         "config": {
-          "model": "accounts/fireworks/models/minimax-m2p5"
+          "model": "accounts/fireworks/models/minimax-m2p7"
         }
       },
       "cost": {
@@ -1162,21 +1044,6 @@
       }
     },
 
-    {
-      "name": "minimax-m2.7",
-      "variant": "ollama",
-      "platform": {
-        "name": "openai-compatible",
-        "variant": "ollama"
-      },
-      "model": {
-        "format": "openai-responses",
-        "config": {
-          "model": "minimax-m2.7:cloud"
-        }
-      }
-    },
-
     {
       "name": "qwen3-next",
       "variant": "vertex-ai",
@@ -1215,35 +1082,6 @@
       }
     },
 
-    {
-      "name": "gemma4",
-      "variant": "ollama",
-      "platform": {
-        "name": "openai-compatible",
-        "variant": "ollama"
-      },
-      "model": {
-        "format": "openai-responses",
-        "config": {
-          "model": "gemma4:31b-cloud"
-        }
-      }
-    },
-    {
-      "name": "gemma4",
-      "variant": "huggingface",
-      "platform": {
-        "name": "openai-compatible",
-        "variant": "huggingface"
-      },
-      "model": {
-        "format": "openai-messages",
-        "config": {
-          "model": "google/gemma-4-31B-it:together"
-        }
-      }
-    },
-
     {
       "name": "nova-2-lite",
       "variant": "bedrock",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iinm/plain-agent",
-  "version": "1.7.17",
+  "version": "1.7.19",
   "description": "A lightweight CLI-based coding agent",
   "license": "MIT",
   "type": "module",

package/src/cliArgs.mjs

@@ -1,5 +1,5 @@
 /**
- * @typedef {HelpSubcommand | InteractiveSubcommand | BatchSubcommand | ListModelsSubcommand | InstallClaudeCodePluginsSubcommand} Subcommand
+ * @typedef {HelpSubcommand | InteractiveSubcommand | BatchSubcommand | ListModelsSubcommand | InstallClaudeCodePluginsSubcommand | CostSubcommand} Subcommand
  */
 
 /**
@@ -22,6 +22,10 @@
  * @typedef {{ type: 'install-claude-code-plugins' }} InstallClaudeCodePluginsSubcommand
  */
 
+/**
+ * @typedef {{ type: 'cost', from: string | null, to: string | null }} CostSubcommand
+ */
+
 /**
  * @typedef {Object} CliArgs
  * @property {Subcommand} subcommand - The subcommand to execute
@@ -106,6 +110,28 @@ export function parseCliArgs(argv) {
     };
   }
 
+  if (subcommandName === "cost") {
+    const costArgs = args.slice(1);
+    let from = null;
+    let to = null;
+    for (let i = 0; i < costArgs.length; i++) {
+      if (costArgs[i] === "--from") {
+        if (costArgs[i + 1]) {
+          from = costArgs[i + 1];
+          i++;
+        }
+      } else if (costArgs[i] === "--to") {
+        if (costArgs[i + 1]) {
+          to = costArgs[i + 1];
+          i++;
+        }
+      }
+    }
+    return {
+      subcommand: { type: "cost", from, to },
+    };
+  }
+
   return {
     subcommand: { type: "help" },
   };
@@ -119,6 +145,7 @@ export function printHelp(exitCode = 0) {
   console.log(`
 Usage: plain [options]
        plain batch [options] <task>
+       plain cost [--from YYYY-MM-DD] [--to YYYY-MM-DD]
        plain list-models
        plain install-claude-code-plugins
 
@@ -131,6 +158,9 @@ Subcommands:
   batch <task>                 Run in batch mode with the given task instruction.
                                Config files are NOT auto-loaded in batch mode;
                                use -c to specify config files explicitly.
+  cost                         Show aggregated token cost per day for a period.
+                               Defaults to the first day of the current month
+                               through today.
   list-models                  List available models
   install-claude-code-plugins  Install Claude Code plugins
 

package/src/cliBatch.mjs

@@ -3,6 +3,7 @@
  */
 
 import { formatCostForBatch } from "./cliFormatter.mjs";
+import { appendUsageRecord, buildUsageRecord } from "./usageStore.mjs";
 
 /**
  * @typedef {object} BatchSessionOptions
@@ -46,6 +47,27 @@ export async function startBatchSession({
         timestamp: new Date().toISOString(),
         cost: formatCostForBatch(costSummary),
       });
+
+      try {
+        const record = buildUsageRecord({
+          sessionId,
+          mode: "batch",
+          modelName,
+          workingDir: process.cwd(),
+          costSummary,
+        });
+        if (record) {
+          await appendUsageRecord(record);
+        }
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        outputEvent({
+          type: "error",
+          error: { message: `failed to record usage: ${message}` },
+          timestamp: new Date().toISOString(),
+        });
+      }
+
       await onStop();
       resolve();
     });