@ampcode/plugin 0.0.0-20260903001817-g400a7f3 → 0.0.0-20260905001706-g303364c

package/index.d.ts

@@ -647,6 +647,7 @@ declare module '@ampcode/plugin' {
 		| 'deepseek'
 		| 'fireworks-ai'
 		| 'google-vertex'
+		| 'meta'
 		| 'minimax'
 		| 'openai'
 		| 'xai'
@@ -1916,22 +1917,27 @@ declare module '@ampcode/plugin' {
 
 	/**
 	 * A custom tool declared in an agent directory's `tools/<name>.ts` file, the argument to
-	 * {@link defineTool}. The tool's name is the filename. The `description` and `execution`
-	 * fields must be static literals; `inputSchema` and `execute` are real code that is not
-	 * statically parsed and runs where `execution` places it.
+	 * {@link defineTool}. The tool's name is the filename. The `description`, `execution`, and
+	 * `inputSchema` fields must be static literals written directly in the file; only `execute`
+	 * is real code, and it runs where `execution` places it.
 	 */
 	export interface AgentToolConfig {
 		/** Description shown to the LLM explaining what the tool does */
 		description?: string
 
 		/**
-		 * Where the tool executes. `server` tools run where the agent runs (its sandbox, no
-		 * repository checkout needed); `executor` tools are dispatched to the attached executor
-		 * at the repository checkout. Defaults to `server`.
+		 * Where the tool executes. `executor` tools (the default) are dispatched to the attached
+		 * executor at the repository checkout. `server` tools run this file in a small detached
+		 * sandbox with no repository checkout, kept warm per thread. On `serverOnly` agents the
+		 * default is `server` and `executor` is a validation error.
 		 */
 		execution?: 'server' | 'executor'
 
-		/** JSON Schema for the tool's input parameters */
+		/**
+		 * JSON Schema for the tool's input parameters. Must be a JSON literal written directly
+		 * in the `defineTool` call (it is statically extracted, never evaluated) and must
+		 * describe an object (`type: 'object'`).
+		 */
 		inputSchema: PluginToolDefinition['inputSchema']
 
 		/** Execute the tool with the given input and return a result */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260903001817-g400a7f3",
+	"version": "0.0.0-20260905001706-g303364c",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {