@iinm/plain-agent 1.9.0 → 1.9.2

package/README.md

@@ -1,26 +1,68 @@
-<p align="center">
-  <img src="https://pub-0bb49aa929f242d49c89ed8c297932b5.r2.dev/plain-agent/plain-agent-logo.png" alt="plain-agent logo" width="320">
-</p>
-
 # Plain Agent
 
-A lightweight CLI-based coding agent.
+A lightweight, capable coding agent for the terminal.
 
 - **Multi-provider** — Use Claude, GPT, Gemini, or any OpenAI-compatible model.
-- **Compact system prompt** — Under 3.5 KB, keeping per-request overhead and cost low ([src/prompt.mjs](https://github.com/iinm/plain-agent/blob/main/src/prompt.mjs)).
-- **Fine-grained approval rules** — Auto-approve commands by name, arguments,
-  and file paths using regex patterns
-  ([config.predefined.json#autoApproval](https://github.com/iinm/plain-agent/blob/main/config/config.predefined.json)).
-- **Path validation** — Restricts access to the working directory.
-  Git-ignored and untracked files require explicit approval.
-- **Sandboxed execution** — Run the agent's shell commands inside a Docker
-  container with network access restricted to allowlisted destinations
-  (e.g., `registry.npmjs.org` only for `npm install`).
+  <details>
+  <summary>Predefined models</summary>
+  
+  ```
+  # Model+Variant (Platform+Variant)
+  claude-haiku-4-5+thinking-16k (platform: anthropic+default)
+  claude-haiku-4-5+thinking-32k (platform: anthropic+default)
+  claude-sonnet-4-6+thinking-high (platform: anthropic+default)
+  claude-sonnet-4-6+thinking-max (platform: anthropic+default)
+  claude-opus-4-7+thinking-high (platform: anthropic+default)
+  claude-opus-4-7+thinking-max (platform: anthropic+default)
+  claude-haiku-4-5+thinking-16k-bedrock (platform: bedrock+default)
+  claude-haiku-4-5+thinking-32k-bedrock (platform: bedrock+default)
+  claude-sonnet-4-6+thinking-high-bedrock (platform: bedrock+default)
+  claude-sonnet-4-6+thinking-max-bedrock (platform: bedrock+default)
+  claude-opus-4-7+thinking-high-bedrock (platform: bedrock+default)
+  claude-opus-4-7+thinking-max-bedrock (platform: bedrock+default)
+  gemini-3-flash-preview+thinking-medium (platform: gemini+default)
+  gemini-3-flash-preview+thinking-high (platform: gemini+default)
+  gemini-3.1-pro-preview+thinking-medium (platform: gemini+default)
+  gemini-3.1-pro-preview+thinking-high (platform: gemini+default)
+  gemini-3-flash-preview+thinking-medium-vertex-ai (platform: vertex-ai+default)
+  gemini-3-flash-preview+thinking-high-vertex-ai (platform: vertex-ai+default)
+  gemini-3.1-pro-preview+thinking-medium-vertex-ai (platform: vertex-ai+default)
+  gemini-3.1-pro-preview+thinking-high-vertex-ai (platform: vertex-ai+default)
+  gpt-5.4-mini+thinking-medium (platform: openai+default)
+  gpt-5.4-mini+thinking-high (platform: openai+default)
+  gpt-5.4-mini+thinking-xhigh (platform: openai+default)
+  gpt-5.5+thinking-medium (platform: openai+default)
+  gpt-5.5+thinking-high (platform: openai+default)
+  gpt-5.5+thinking-xhigh (platform: openai+default)
+  gpt-5.2-chat+thinking-medium-azure (platform: azure+openai)
+  gpt-oss-120b+fireworks (platform: openai-compatible+fireworks)
+  glm-5+vertex-ai (platform: vertex-ai+default)
+  glm-5.1+fireworks (platform: openai-compatible+fireworks)
+  glm-5.1+novita (platform: openai-compatible+novita)
+  kimi-k2.6+fireworks (platform: openai-compatible+fireworks)
+  kimi-k2.6+novita (platform: openai-compatible+novita)
+  deepseek-v4-pro+novita (platform: openai-compatible+novita)
+  deepseek-v4-pro+fireworks (platform: openai-compatible+fireworks)
+  minimax-m2.7+fireworks (platform: openai-compatible+fireworks)
+  minimax-m2.7+novita (platform: openai-compatible+novita)
+  qwen3.6-plus+fireworks (platform: openai-compatible+fireworks)
+  qwen3.6-27b+novita (platform: openai-compatible+novita)
+  nova-2-lite+bedrock (platform: bedrock+default)
+  claude-haiku-4-5+thinking-16k-bedrock-converse (platform: bedrock+default)
+  ```
+  </details>
+
+
+- **Approval rules & path validation** — Auto-approve tool uses by name and arguments using regex patterns ([config.predefined.json#autoApproval](https://github.com/iinm/plain-agent/blob/main/config/config.predefined.json)); restrict file access to the working directory — git-ignored and untracked files require explicit approval ([src/toolInputValidator.mjs](https://github.com/iinm/plain-agent/blob/main/src/toolInputValidator.mjs)).
+- **Sandboxed execution** — Run agent commands in a Docker container with a read-only project root and no network; writable mode and allowlisted network destinations can be enabled as needed.
+- **Plain-text memory** — Task state is saved as Markdown files under `.plain-agent/memory/` for easy review.
 - **Extensible** — Define prompts and subagents in Markdown. Connect MCP servers.
   Supports Claude Code plugins and `.claude/` commands, subagents, and skills.
 
 ## Limitations
 
+- **Path validation only covers tool arguments** — Path validation restricts only paths explicitly passed as tool-use arguments; it cannot control file access inside arbitrary scripts. Always use sandboxed execution when allowing arbitrary script execution.
+- **No session persistence** — Sessions are not persisted. Start a fresh session and use memory files (`.plain-agent/memory/`) instead.
 - **Sequential subagent execution** — Subagents run one at a time rather than
   in parallel. The trade-off is full visibility: every step is streamed to
   your terminal so you can follow exactly what each subagent is doing.
@@ -154,7 +196,7 @@ Create the configuration.
 ```
 
 ```js
-// OpenAI-compatible provider (Ollama) example with a custom model
+// Ollama example with a custom model
 {
   "platforms": [
     {
@@ -181,7 +223,6 @@ Create the configuration.
     }
   ]
 }
-
 ```
 </details>
 
@@ -324,9 +365,7 @@ Files are loaded in the following order. Settings in later files override earlie
         ├── (4) config.local.json  # Project-specific local configuration (including secrets)
         ├── prompts/               # Project-specific prompts
         ├── agents/                # Project-specific agent roles
-        ├── memory/                # Task-specific memory files
-        ├── sandbox/               # Sandbox runner scripts
-        └── tmp/                   # Agent scratch space
+        └── sandbox/               # Sandbox runner scripts
 ```
 
 ### Example
@@ -495,6 +534,7 @@ Files are loaded in the following order. Settings in later files override earlie
 
 The agent can use the following tools to assist with tasks:
 
+- **read_file**: Read a file with line numbers (1-indexed). Supports `offset` and `limit` to read a specific range.
 - **write_file**: Write a file.
 - **patch_file**: Patch a file.
 - **exec_command**: Run a command without shell interpretation.

package/config/config.predefined.json

@@ -914,6 +914,30 @@
       }
     },
 
+    {
+      "name": "gpt-oss-120b",
+      "variant": "fireworks",
+      "platform": {
+        "name": "openai-compatible",
+        "variant": "fireworks"
+      },
+      "model": {
+        "format": "openai-messages",
+        "config": {
+          "model": "accounts/fireworks/models/gpt-oss-120b"
+        }
+      },
+      "cost": {
+        "currency": "USD",
+        "unit": "1M",
+        "costs": {
+          "prompt_tokens": 0.15,
+          "prompt_tokens_details.cached_tokens": -0.14,
+          "completion_tokens": 0.6 
+        }
+      }
+    },
+
     {
       "name": "glm-5",
       "variant": "vertex-ai",

package/package.json

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

package/src/cliCommands.mjs

@@ -12,6 +12,7 @@ import { loadUserMessageContext } from "./context/loadUserMessageContext.mjs";
 import { CLAUDE_CODE_COMPATIBILITY_NOTES } from "./prompt.mjs";
 import { parseFileRange } from "./utils/parseFileRange.mjs";
 import { readFileRange } from "./utils/readFileRange.mjs";
+import { toOneLine } from "./utils/toOneLine.mjs";
 
 /**
  * @typedef {"prompt" | "continue"} CommandResult
@@ -172,7 +173,8 @@ export function createCommandHandler({
       } else {
         for (const role of agentRoles.values()) {
           const maxLength = process.stdout.columns ?? 100;
-          const line = `  ${styleText("cyan", role.id.padEnd(20))} - ${role.description}`;
+          const desc = toOneLine(role.description);
+          const line = `  ${styleText("cyan", role.id.padEnd(20))} - ${desc}`;
           console.log(
             line.length > maxLength ? `${line.slice(0, maxLength)}...` : line,
           );
@@ -201,7 +203,8 @@ export function createCommandHandler({
         } else {
           for (const prompt of prompts.values()) {
             const maxLength = process.stdout.columns ?? 100;
-            const line = `  ${styleText("cyan", prompt.id.padEnd(20))} - ${prompt.description}`;
+            const desc = toOneLine(prompt.description);
+            const line = `  ${styleText("cyan", prompt.id.padEnd(20))} - ${desc}`;
             console.log(
               line.length > maxLength ? `${line.slice(0, maxLength)}...` : line,
             );

package/src/cliCompleter.mjs

@@ -5,6 +5,7 @@
 import { styleText } from "node:util";
 import { loadAgentRoles } from "./context/loadAgentRoles.mjs";
 import { loadPrompts } from "./context/loadPrompts.mjs";
+import { toOneLine } from "./utils/toOneLine.mjs";
 
 // Define available slash commands for tab completion
 export const SLASH_COMMANDS = [
@@ -129,7 +130,7 @@ function showCompletions(rl, candidates, line, callback) {
         if (typeof c === "string") return c;
         const nameText = c.name.padEnd(25);
         const separator = " - ";
-        const descText = c.description;
+        const descText = toOneLine(c.description);
 
         // 画面幅に合わせて説明文をカット（色を付ける前に計算）
         const availableWidth =

package/src/prompt.mjs

@@ -1,3 +1,5 @@
+import { toOneLine } from "./utils/toOneLine.mjs";
+
 /**
  * @typedef {object} PromptConfig
  * @property {string} username
@@ -28,37 +30,27 @@ export function createPrompt({
 }) {
   const agentRoleDescriptions = Array.from(agentRoles.entries())
     .map(([id, role]) => {
-      const desc =
-        role.description.length > 100
-          ? `${role.description.substring(0, 100)}...`
-          : role.description;
+      const flat = toOneLine(role.description);
+      const desc = flat.length > 100 ? `${flat.substring(0, 100)}...` : flat;
       return `- ${id}: ${desc}`;
     })
     .join("\n");
 
   const skillDescriptions = skills
     .map((skill) => {
-      const desc =
-        skill.description.length > 100
-          ? `${skill.description.substring(0, 100)}...`
-          : skill.description;
+      const flat = toOneLine(skill.description);
+      const desc = flat.length > 100 ? `${flat.substring(0, 100)}...` : flat;
       return `- ${skill.filePath}\n  ${desc}`;
     })
     .join("\n");
 
   return `
-# Communication Style
-
-- Respond in the user's language.
-- Address the user by their name, rather than "user".
-- Use emojis sparingly to highlight key points.
-
 # Memory Files
 
 - Create/Update memory files after creating/updating a plan, completing milestones, encountering issues, or making decisions.
 - Update existing task memory when continuing the same task.
-- Write the memory content in the user's language.
 - Ensure self-containment: The file must be standalone. A reader should fully understand the task context, logic and progress without any other references.
+- Write the memory content in the user's language.
 
 Memory files should include:
 - Task overview: What the task is, why it's being done, requirements and constraints
@@ -88,7 +80,6 @@ Examples:
 
 - Only use when the user explicitly requests it.
 - Create a new session with the given tmux session id.
-- Use relative paths.
 
 Examples:
 - Start session: new-session ["-d", "-s", "<tmux-session-id>"]

package/src/utils/parseFrontmatter.mjs

@@ -1,6 +1,9 @@
 /**
  * Parse simple key-value frontmatter using regex.
- * Only supports `key: value` format. No multiline strings.
+ * Supports `key: value` and YAML block scalars (`key: |` literal,
+ * `key: >` folded), with optional chomping indicators (`-`, `+`).
+ * Block scalar lines are read while indented further than column 0,
+ * using the first non-empty block line's indentation as the base.
  * @param {string} frontmatter - The YAML frontmatter content (without --- delimiters)
  * @returns {Record<string, string>} Parsed key-value pairs
  */
@@ -8,12 +11,72 @@ export function parseFrontmatter(frontmatter) {
   /** @type {Record<string, string>} */
   const result = {};
 
-  for (const line of frontmatter.split(/\r?\n/)) {
+  const lines = frontmatter.split(/\r?\n/);
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
+
+    const blockMatch = line.match(/^(\w[\w-]*):\s*([|>])[+-]?\s*$/);
+    if (blockMatch) {
+      const key = blockMatch[1];
+      const style = blockMatch[2];
+      i++;
+
+      /** @type {string[]} */
+      const blockLines = [];
+      let indent = -1;
+      while (i < lines.length) {
+        const blockLine = lines[i];
+        if (blockLine.trim() === "") {
+          blockLines.push("");
+          i++;
+          continue;
+        }
+        const leadingSpaces = (blockLine.match(/^( *)/)?.[1] ?? "").length;
+        if (indent === -1) {
+          if (leadingSpaces === 0) break;
+          indent = leadingSpaces;
+        } else if (leadingSpaces < indent) {
+          break;
+        }
+        blockLines.push(blockLine.slice(indent));
+        i++;
+      }
+
+      while (blockLines.at(-1) === "") {
+        blockLines.pop();
+      }
+
+      result[key] =
+        style === "|" ? blockLines.join("\n") : foldFolded(blockLines);
+      continue;
+    }
+
     const match = line.match(/^(\w[\w-]*):\s?(.*)$/);
     if (match) {
       result[match[1]] = match[2].trimEnd();
     }
+    i++;
   }
 
   return result;
 }
+
+/**
+ * @param {string[]} blockLines
+ * @returns {string}
+ */
+function foldFolded(blockLines) {
+  const paragraphs = [];
+  let current = [];
+  for (const line of blockLines) {
+    if (line === "") {
+      paragraphs.push(current.join(" "));
+      current = [];
+    } else {
+      current.push(line);
+    }
+  }
+  paragraphs.push(current.join(" "));
+  return paragraphs.join("\n");
+}

package/src/utils/toOneLine.mjs

@@ -0,0 +1,11 @@
+/**
+ * Collapse newlines (and any whitespace adjacent to them) into a single space
+ * and trim. Used for rendering frontmatter values such as `description` in
+ * single-line UI contexts (bullet lists, completer rows, console output).
+ *
+ * @param {string} s
+ * @returns {string}
+ */
+export function toOneLine(s) {
+  return s.replace(/\s*\n\s*/g, " ").trim();
+}