@ampcode/plugin 0.0.0-20260813002147-g5c34dee → 0.0.0-20260815001113-g5bf5f5d

package/README.md

@@ -8,6 +8,7 @@ Plugins can:
 
 - **Handle events** — `amp.on(...)` for tool calls, tool results, and agent lifecycle events
 - **Add tools** — `amp.registerTool(...)` for custom tools the agent can call
+- **Bundle skills** — `await amp.registerSkill(...)` to register skill directories
 - **Add commands** — `amp.registerCommand(...)` for command palette actions
 - **Show UI** — `ctx.ui.notify(...)`, `ctx.ui.confirm(...)`, `ctx.ui.input(...)`, and `ctx.ui.select(...)`
 - **Use AI** — `amp.ai.ask(...)` for thread-scoped yes/no classification that defaults to no

package/index.d.ts

@@ -113,6 +113,20 @@ declare module '@ampcode/plugin' {
 		 */
 		registerTool(definition: PluginToolDefinition): Subscription
 
+		/**
+		 * Register an Agent Skill from this plugin's directory.
+		 *
+		 * The path must be relative to a directory plugin's root and name a directory that contains
+		 * `SKILL.md`. Amp validates the package and makes it available under the qualified name
+		 * `<plugin-name>:<skill-name>`.
+		 *
+		 * @example
+		 * ```ts
+		 * await amp.registerSkill({ path: 'skills/simulator' })
+		 * ```
+		 */
+		registerSkill(definition: PluginSkillDefinition): Promise<Subscription>
+
 		/**
 		 * Register a callback that runs before this plugin instance is stopped.
 		 *
@@ -308,7 +322,7 @@ declare module '@ampcode/plugin' {
 		| readonly string[]
 		| 'all'
 		| {
-				/** Tool names to include. Defaults to all tools. */
+				/** Tool names to include. Defaults to the agent's standard and external tools. */
 				include?: readonly string[] | 'all'
 				/** Tool names to exclude after applying include. */
 				exclude?: readonly string[]
@@ -331,7 +345,8 @@ declare module '@ampcode/plugin' {
 		/** Instructions appended to Amp's base agent prompt. */
 		instructions: string
 		/**
-		 * Tools available to this agent. Use 'all' for all tools available in its runtime.
+		 * Tools available to this agent. Use 'all' for its provider-appropriate built-in tools
+		 * plus plugin, MCP, and remote tools available in its runtime.
 		 *
 		 * Run `amp plugins show-agent-options --json` for built-in tool names intended for
 		 * plugin agents.
@@ -541,6 +556,7 @@ declare module '@ampcode/plugin' {
 		| 'google-vertex'
 		| 'openai'
 		| 'xai'
+		| 'zhipuai'
 
 	/** Model identifier in `provider/model` format, such as `openai/gpt-5.6-sol`. */
 	export type PluginAIModel = `${PluginAIModelProvider}/${string}`
@@ -1663,4 +1679,12 @@ declare module '@ampcode/plugin' {
 			ctx: PluginToolContext,
 		) => Promise<PluginToolResult | void>
 	}
+
+	/**
+	 * An Agent Skill directory contributed by a plugin.
+	 */
+	export interface PluginSkillDefinition {
+		/** Path to the skill directory, relative to the directory plugin's root. */
+		path: string
+	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ampcode/plugin",
-	"version": "0.0.0-20260813002147-g5c34dee",
+	"version": "0.0.0-20260815001113-g5bf5f5d",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {