@ampcode/plugin 0.0.0-20260812002050-g3d0e2fc → 0.0.0-20260814002157-gcdc06ea

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.
 		 *
@@ -529,14 +543,19 @@ declare module '@ampcode/plugin' {
 		reason: string
 	}
 
+	/**
+	 * A model provider namespace. New definitions use models.dev provider IDs or Amp's private
+	 * namespace.
+	 */
 	export type PluginAIModelProvider =
 		| 'amp'
 		| 'anthropic'
 		| 'baseten'
-		| 'fireworks'
+		| 'fireworks-ai'
+		| 'google-vertex'
 		| 'openai'
-		| 'vertexai'
 		| 'xai'
+		| 'zhipuai'
 
 	/** Model identifier in `provider/model` format, such as `openai/gpt-5.6-sol`. */
 	export type PluginAIModel = `${PluginAIModelProvider}/${string}`
@@ -1659,4 +1678,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-20260812002050-g3d0e2fc",
+	"version": "0.0.0-20260814002157-gcdc06ea",
 	"description": "Amp Plugin API",
 	"homepage": "https://ampcode.com/manual/plugin-api",
 	"author": {