@iinm/plain-agent 1.9.0 → 1.9.1

package/README.md

@@ -16,6 +16,8 @@ A lightweight CLI-based coding agent.
 - **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`).
+- **Plain-text memory** — Task state is persisted as Markdown files under
+  `.plain-agent/memory/`, easy to review.
 - **Extensible** — Define prompts and subagents in Markdown. Connect MCP servers.
   Supports Claude Code plugins and `.claude/` commands, subagents, and skills.
 
@@ -24,6 +26,7 @@ A lightweight CLI-based coding agent.
 - **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.
+- **No session persistence** — Sessions are not persisted. Start a fresh session and use memory files (`.plain-agent/memory/`) instead.
 
 ## Requirements
 
@@ -495,6 +498,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iinm/plain-agent",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "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();
+}