@iinm/plain-agent 1.7.16 → 1.7.18

package/README.md

@@ -60,19 +60,19 @@ Create the configuration.
     {
       "name": "anthropic",
       "variant": "default",
-      "apiKey": "FIXME"
+      "apiKey": "<ANTHROPIC_API_KEY>"
       // Or
       // "apiKey": { "$env": "ANTHROPIC_API_KEY" }
     },
     {
       "name": "gemini",
       "variant": "default",
-      "apiKey": "FIXME"
+      "apiKey": "<GEMINI_API_KEY>"
     },
     {
       "name": "openai",
       "variant": "default",
-      "apiKey": "FIXME"
+      "apiKey": "<OPENAI_API_KEY>"
     },
   ],
 
@@ -81,7 +81,7 @@ Create the configuration.
     // askWeb: Searches the web to answer questions requiring up-to-date information or external sources.
     "askWeb": {
       "provider": "gemini",
-      "apiKey": "FIXME",
+      "apiKey": "<GEMINI_API_KEY>",
       "model": "gemini-3-flash-preview"
       // Optional
       // "baseURL": "<proxy_url>"
@@ -98,7 +98,7 @@ Create the configuration.
     //         Directly injecting URL content into context is not supported to prevent prompt injection.
     "askURL": {
       "provider": "gemini",
-      "apiKey": "FIXME"
+      "apiKey": "<GEMINI_API_KEY>"
       "model": "gemini-3-flash-preview"
       // Optional
       // "baseURL": "<proxy_url>"
@@ -134,7 +134,7 @@ Create the configuration.
       "name": "bedrock",
       "variant": "default",
       "baseURL": "https://bedrock-runtime.<region>.amazonaws.com",
-      "awsProfile": "FIXME"
+      "awsProfile": "<AWS_PROFILE>"
     },
     {
       // Requires gcloud CLI to get authentication token
@@ -157,24 +157,42 @@ Create the configuration.
   "platforms": [
     {
       "name": "openai-compatible",
-      "variant": "ollama",
-      "baseURL": "https://ollama.com",
-      "apiKey": "FIXME"
-    },
+      "variant": "fireworks",
+      "baseURL": "https://api.fireworks.ai/inference",
+      "apiKey": "<FIREWORKS_API_KEY>"
+    }
+  ]
+}
+```
+
+```js
+{
+  "platforms": [
     {
       "name": "openai-compatible",
-      "variant": "huggingface",
-      "baseURL": "https://router.huggingface.co",
-      "apiKey": "FIXME"
-    },
+      "variant": "ollama",
+      "baseURL": "https://ollama.com",
+      "apiKey": "<API_KEY>"
+    }
+  ],
+  "models": [
     {
-      "name": "openai-compatible",
-      "variant": "fireworks",
-      "baseURL": "https://api.fireworks.ai/inference",
-      "apiKey": "FIXME"
+      "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": "FIXME"
-    }
   ]
 }
 ```
@@ -307,7 +325,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 +343,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
 
@@ -463,7 +479,7 @@ The agent loads configuration files in the following order. Settings in later fi
     // ⚠️ Add this to config.local.json to avoid committing secrets to Git
     "slack": {
       "command": "npx",
-      "args": ["-y", "mcp-remote", "https://mcp.slack.com/mcp", "--header", "Authorization:Bearer FIXME"],
+      "args": ["-y", "mcp-remote", "https://mcp.slack.com/mcp", "--header", "Authorization:Bearer <SLACK_TOKEN>"],
     },
     "notion": {
       "command": "npx",
@@ -480,12 +496,18 @@ The agent loads configuration files in the following order. Settings in later fi
     // ⚠️ Add this to config.local.json to avoid committing secrets to Git
     "google_developer-knowledge": {
       "command": "npx",
-      "args": ["-y", "mcp-remote", "https://developerknowledge.googleapis.com/mcp", "--header", "X-Goog-Api-Key:FIXME"]
+      "args": ["-y", "mcp-remote", "https://developerknowledge.googleapis.com/mcp", "--header", "X-Goog-Api-Key:<GOOGLE_API_KEY>"]
     }
   },
 
   // Override default notification command
   // "notifyCmd": "/path/to/notification-command"
+
+  // (Optional) Voice input. See "Voice Input" below.
+  // "voiceInput": {
+  //   "provider": "openai",
+  //   "apiKey": "<OPENAI_API_KEY>"
+  // }
 }
 ```
 </details>
@@ -606,6 +628,53 @@ Example:
 plain install-claude-code-plugins
 ```
 
+## Voice Input
+
+Press **Ctrl-O** to start recording, press it again to stop. Partial
+transcripts are inserted into the prompt as you speak so you can edit
+and send them like regular text.
+
+### Requirements
+
+- A recording command on `PATH`: `arecord`, `sox`, or `ffmpeg`.
+- An API key for the chosen provider.
+- Your host must have microphone access. The sandbox does not need to.
+
+### Providers
+
+**OpenAI Realtime** (default, recommended):
+
+```js
+{
+  "voiceInput": {
+    "provider": "openai",
+    "apiKey": "<OPENAI_API_KEY>"
+    // "model": "gpt-4o-transcribe",  // or "gpt-4o-mini-transcribe", "whisper-1"
+    // "language": "ja"               // ISO-639-1 code. Improves accuracy and latency.
+  }
+}
+```
+
+**Gemini Live** (preview API; model names and pricing may change):
+
+```js
+{
+  "voiceInput": {
+    "provider": "gemini",
+    "apiKey": "<GEMINI_API_KEY>"
+    // "model": "gemini-3.1-flash-live-preview",
+    // "language": "ja"
+  }
+}
+```
+
+### Options
+
+- `toggleKey` — Rebind the toggle. Accepts `"ctrl-<char>"` where `<char>`
+  is a letter (a-z) or one of `[ \ ] ^ _`. Defaults to `"ctrl-o"`.
+- `recorder` — Override recorder auto-detection. Must write raw 16-bit
+  little-endian mono PCM to stdout at 24 kHz (OpenAI) or 16 kHz (Gemini).
+
 ## Development
 
 ```sh
@@ -644,9 +713,9 @@ npm publish --access public
 
 ```sh
 # IAM Identity Center 
-identity_center_instance_arn="FIXME" # e.g., arn:aws:sso:::instance/ssoins-xxxxxxxxxxxxxxxx"
-identity_store_id=FIXME
-aws_account_id=FIXME
+identity_center_instance_arn="<IDENTITY_CENTER_INSTANCE_ARN>" # e.g., arn:aws:sso:::instance/ssoins-xxxxxxxxxxxxxxxx"
+identity_store_id=<IDENTITY_STORE_ID>
+aws_account_id=<AWS_ACCOUNT_ID>
 
 # Create a permission set
 permission_set_arn=$(aws sso-admin create-permission-set \
@@ -681,10 +750,10 @@ aws sso-admin put-inline-policy-to-permission-set \
   --inline-policy "$policy"
 
 # Create an SSO user
-sso_user_name=FIXME
-sso_user_email=FIXME
-sso_user_family_name=FIXME
-sso_user_given_name=FIXME
+sso_user_name=<SSO_USER_NAME>
+sso_user_email=<SSO_USER_EMAIL>
+sso_user_family_name=<SSO_USER_FAMILY_NAME>
+sso_user_given_name=<SSO_USER_GIVEN_NAME>
 
 user_id=$(aws identitystore create-user \
   --identity-store-id "$identity_store_id" \
@@ -725,8 +794,8 @@ aws bedrock-runtime invoke-model \
 <summary><b>Azure - Microsoft Foundry</b></summary>
 
 ```sh
-resource_group=FIXME
-account_name=FIXME # resource name
+resource_group=<RESOURCE_GROUP>
+account_name=<ACCOUNT_NAME> # resource name
 
 # Create a service principal
 service_principal=$(az ad sp create-for-rbac --name "CodingAgentServicePrincipal" --skip-assignment)
@@ -758,10 +827,10 @@ az login --service-principal -u "$app_id" -p "$app_secret" --tenant "$tenant_id"
 <summary><b>Google Cloud Vertex AI</b></summary>
 
 ```sh
-project_id=FIXME
-service_account_name=FIXME
+project_id=<PROJECT_ID>
+service_account_name=<SERVICE_ACCOUNT_NAME>
 service_account_email="${service_account_name}@${project_id}.iam.gserviceaccount.com"
-your_account_email=FIXME
+your_account_email=<YOUR_ACCOUNT_EMAIL>
 
 # Create a service account
 gcloud iam service-accounts create "$service_account_name" \

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.16",
+  "version": "1.7.18",
   "description": "A lightweight CLI-based coding agent",
   "license": "MIT",
   "type": "module",