@iinm/plain-agent 1.10.0 → 1.10.2

package/README.md

@@ -2,62 +2,11 @@
 
 A lightweight, capable coding agent for the terminal.
 
-- **Multi-provider** — Use Claude, GPT, Gemini, or any OpenAI-compatible model.
-  <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 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.
+- **Multi-provider** — Use Claude, GPT, Gemini, or any OpenAI-compatible model via Bedrock, Vertex AI, or direct APIs.
+- **Fine-grained auto-approval** — Auto-approve tool calls by name and arguments using regex patterns.
+- **Sandboxed execution** — Run commands in a Docker container with filesystem and network isolation.
+- **Claude Code compatible** — Use Claude Code plugins, commands, subagents, and skills from `.claude/`.
+- **Zero external dependencies** — Built with Node.js standard libraries only.
 
 ## Limitations
 
@@ -388,8 +337,7 @@ Files are loaded in the following order. Settings in later files override earlie
         ├── (3) config.json        # Project-specific configuration
         ├── (4) config.local.json  # Project-specific local configuration (including secrets)
         ├── prompts/               # Project-specific prompts
-        ├── agents/                # Project-specific agent roles
-        └── sandbox/               # Sandbox runner scripts
+        └── agents/                # Project-specific agent roles
 ```
 
 ### Example

package/package.json

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

package/src/claudeCodePlugin.mjs

@@ -32,7 +32,7 @@ export function resolvePluginPaths(repos) {
   for (const repo of repos) {
     const ownerRepo = extractOwnerRepo(repo.source);
     if (!ownerRepo) {
-      console.warn(`Invalid source URL: ${repo.source}`);
+      console.error(`Invalid source URL: ${repo.source}`);
       continue;
     }
 
@@ -43,7 +43,7 @@ export function resolvePluginPaths(repos) {
         try {
           only = new RegExp(plugin.only);
         } catch (err) {
-          console.warn(
+          console.error(
             `Invalid regex pattern "${plugin.only}" for plugin "${plugin.name}":`,
             err instanceof Error ? err.message : String(err),
           );

package/src/cliCommands.mjs

@@ -75,7 +75,7 @@ export function createCommandHandler({
     const prompt = prompts.get(id);
 
     if (!prompt) {
-      console.log(styleText("red", `\nPrompt not found: ${id}`));
+      console.error(styleText("red", `\nPrompt not found: ${id}`));
       return "prompt";
     }
 
@@ -116,13 +116,13 @@ export function createCommandHandler({
     if (inputTrimmed.startsWith("!")) {
       const fileRange = parseFileRange(inputTrimmed.slice(1));
       if (fileRange instanceof Error) {
-        console.log(styleText("red", `\n${fileRange.message}`));
+        console.error(styleText("red", `\n${fileRange.message}`));
         return "prompt";
       }
 
       const fileContent = await readFileRange(fileRange);
       if (fileContent instanceof Error) {
-        console.log(styleText("red", `\n${fileContent.message}`));
+        console.error(styleText("red", `\n${fileContent.message}`));
         return "prompt";
       }
 
@@ -174,7 +174,7 @@ export function createCommandHandler({
     if (inputTrimmed.startsWith("/agents:")) {
       const match = inputTrimmed.match(/^\/agents:([^ ]+)(?:\s+(.*))?$/s);
       if (!match) {
-        console.log(styleText("red", "\nInvalid agent invocation format."));
+        console.error(styleText("red", "\nInvalid agent invocation format."));
         return "prompt";
       }
       return await invokeAgent(match[1], match[2] || "");
@@ -204,7 +204,7 @@ export function createCommandHandler({
       if (inputTrimmed.startsWith("/prompts:")) {
         const match = inputTrimmed.match(/^\/prompts:([^ ]+)(?:\s+(.*))?$/s);
         if (!match) {
-          console.log(styleText("red", "\nInvalid prompt invocation format."));
+          console.error(styleText("red", "\nInvalid prompt invocation format."));
           return "prompt";
         }
         return await invokePrompt(

package/src/cliInteractive.mjs

@@ -17,6 +17,7 @@ import { createInterruptTransform } from "./cliInterruptTransform.mjs";
 import { createMuteTransform } from "./cliMuteTransform.mjs";
 import { createPasteHandler } from "./cliPasteTransform.mjs";
 import { appendUsageRecord, buildUsageRecord } from "./usageStore.mjs";
+import { createSequentialExecutor } from "./utils/createSequentialExecutor.mjs";
 import { notify } from "./utils/notify.mjs";
 import { parseVoiceToggleKey, startVoiceSession } from "./voiceInput.mjs";
 
@@ -280,7 +281,7 @@ export function startInteractiveSession({
     // Agent turn: pause auto-approve; do not clear input.
     if (!state.turn) {
       agentCommands.pauseAutoApprove();
-      console.log(
+      console.error(
         styleText(
           "yellow",
           "\n\n⚠️ Ctrl-C: Auto-approve paused. Finishing current tool...\nPress Ctrl-D twice to exit.\n",
@@ -327,7 +328,7 @@ export function startInteractiveSession({
       );
       cli.prompt();
     } else {
-      console.log(styleText("yellow", "\n\n⚠️ Press Ctrl-D again to exit.\n"));
+      console.error(styleText("yellow", "\n\n⚠️ Press Ctrl-D again to exit.\n"));
     }
   };
 
@@ -417,7 +418,7 @@ export function startInteractiveSession({
 
   cli.on("line", async (lineInput) => {
     if (!state.turn) {
-      console.warn(
+      console.error(
         styleText(
           "yellow",
           `\nAgent is working. Ignore input: ${lineInput.trim()}`,
@@ -473,12 +474,16 @@ export function startInteractiveSession({
     }
   });
 
+  const enqueueOutput = createSequentialExecutor();
+
   agentEventEmitter.on("message", (message) => {
-    printMessage(message).catch((err) => {
-      console.error(
-        styleText("red", `Error rendering message: ${err.message}`),
-      );
-    });
+    enqueueOutput(() =>
+      printMessage(message).catch((err) => {
+        console.error(
+          styleText("red", `Error rendering message: ${err.message}`),
+        );
+      }),
+    );
   });
 
   agentEventEmitter.on("toolUseRequest", () => {
@@ -500,11 +505,13 @@ export function startInteractiveSession({
   });
 
   agentEventEmitter.on("providerTokenUsage", (usage) => {
-    console.log(formatProviderTokenUsage(usage));
+    enqueueOutput(() => {
+      console.log(formatProviderTokenUsage(usage));
+    });
   });
 
   agentEventEmitter.on("error", (error) => {
-    console.log(
+    console.error(
       styleText(
         "red",
         `\nError: message=${error.message}, stack=${error.stack}`,
@@ -519,8 +526,12 @@ export function startInteractiveSession({
         styleText("yellow", `\nNotification error: ${err.message}`),
       );
     }
-    // 暫定対応: token usageのconsole出力を確実にflushするため、次のevent loop tickまで遅延
-    await new Promise((resolve) => setTimeout(resolve, 0));
+
+    // Wait for all output operations to complete
+    await enqueueOutput(() => {});
+
+    // Defer prompt rendering to ensure terminal output is visible
+    await new Promise((resolve) => setImmediate(resolve));
 
     state.turn = true;
     cli.prompt();

package/src/config.mjs

@@ -128,7 +128,7 @@ export async function loadConfigFile(filePath, skipTrustCheck = false) {
 
   if (!isTrusted) {
     if (!process.stdout.isTTY) {
-      console.warn(
+      console.error(
         styleText(
           "yellow",
           `WARNING: Config file found at '${filePath}' but cannot ask for approval without a TTY. Skipping.`,

package/src/context/loadAgentRoles.mjs

@@ -54,7 +54,7 @@ export async function loadAgentRoles(claudeCodePlugins) {
       agentDirs.map(async ({ dir, idPrefix, only }) => {
         const files = await getMarkdownFiles(dir).catch((err) => {
           if (err.code !== "ENOENT") {
-            console.warn(`Failed to list agent roles in ${dir}:`, err);
+            console.error(`Failed to list agent roles in ${dir}:`, err);
           }
           return /** @type {string[]} */ ([]);
         });
@@ -72,7 +72,7 @@ export async function loadAgentRoles(claudeCodePlugins) {
         files.map(async ({ dir, file, idPrefix }) => {
           const fullPath = path.join(dir, file);
           const content = await fs.readFile(fullPath, "utf-8").catch((err) => {
-            console.warn(`Failed to read agent role file ${fullPath}:`, err);
+            console.error(`Failed to read agent role file ${fullPath}:`, err);
             return null;
           });
 

package/src/context/loadPrompts.mjs

@@ -69,7 +69,7 @@ export async function loadPrompts(claudeCodePlugins) {
       promptDirs.map(async ({ dir, idPrefix, only }) => {
         const files = await getMarkdownFiles(dir).catch((err) => {
           if (err.code !== "ENOENT") {
-            console.warn(`Failed to list prompts in ${dir}:`, err);
+            console.error(`Failed to list prompts in ${dir}:`, err);
           }
           return /** @type {string[]} */ ([]);
         });
@@ -95,7 +95,7 @@ export async function loadPrompts(claudeCodePlugins) {
         files.map(async ({ dir, file, idPrefix }) => {
           const fullPath = path.join(dir, file);
           const content = await fs.readFile(fullPath, "utf-8").catch((err) => {
-            console.warn(`Failed to read prompt file ${fullPath}:`, err);
+            console.error(`Failed to read prompt file ${fullPath}:`, err);
             return null;
           });
 

package/src/context/loadUserMessageContext.mjs

@@ -143,5 +143,5 @@ function inferMimeType(filePath) {
  * @returns {void}
  */
 function warn(message) {
-  console.warn(styleText("yellow", message));
+  console.error(styleText("yellow", message));
 }

package/src/utils/createSequentialExecutor.mjs

@@ -0,0 +1,28 @@
+/**
+ * Create a sequential executor that enqueues async operations
+ * and executes them in order.
+ *
+ * @returns {(fn: () => Promise<void> | void) => Promise<void>}
+ *   A function that enqueues an operation and returns a promise
+ *   that resolves when all queued operations (including this one) complete.
+ *
+ * @example
+ * const enqueue = createSequentialExecutor();
+ *
+ * // These will execute in order, even if called from different event handlers
+ * enqueue(() => console.log("first"));
+ * enqueue(async () => { await something(); });
+ * enqueue(() => console.log("second"));
+ */
+export function createSequentialExecutor() {
+  /** @type {Promise<void>} */
+  let chain = Promise.resolve();
+
+  return (fn) => {
+    chain = chain.then(fn).catch((err) => {
+      // Prevent unhandled rejection, but log the error
+      console.error("Sequential executor error:", err);
+    });
+    return chain;
+  };
+}