@ampcode/plugin 0.0.0-20260904001652-g2bd7889 → 0.0.0-20260906001924-ga3e743b

package/index.d.ts

@@ -1917,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-20260904001652-g2bd7889",
+	"version": "0.0.0-20260906001924-ga3e743b",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/docs/plugin-api",
 	"author": {