refactor: rename @aictrl/plugin → @aictrl/plugin-sdk

.github/workflows/publish.yml

@@ -55,9 +55,9 @@ jobs:
         working-directory: packages/util
         run: ${{ github.workspace }}/.github/scripts/publish-if-new.sh "@aictrl/util"
 
-      - name: Publish @aictrl/plugin
+      - name: Publish @aictrl/plugin-sdk
         working-directory: packages/plugin
-        run: ${{ github.workspace }}/.github/scripts/publish-if-new.sh "@aictrl/plugin"
+        run: ${{ github.workspace }}/.github/scripts/publish-if-new.sh "@aictrl/plugin-sdk"
 
       - name: Publish @aictrl/sdk
         working-directory: packages/sdk

.opencode/agent/translator.md

@@ -608,7 +608,7 @@ XDG_CONFIG_HOME
 ```text
 ../../../config.mjs
 @astrojs/starlight/components
-@aictrl/plugin
+@aictrl/plugin-sdk
 @aictrl/sdk
 path
 shescape

.opencode/tool/github-comment.ts

@@ -1,5 +1,5 @@
 /// <reference path="../env.d.ts" />
-import { tool } from "@aictrl/plugin"
+import { tool } from "@aictrl/plugin-sdk"
 
 function getPRNumber(): number {
   const pr = parseInt(process.env.PR_NUMBER ?? "", 10)

.opencode/tool/github-pr-search.ts

@@ -1,5 +1,5 @@
 /// <reference path="../env.d.ts" />
-import { tool } from "@aictrl/plugin"
+import { tool } from "@aictrl/plugin-sdk"
 import DESCRIPTION from "./github-pr-search.txt"
 
 async function githubFetch(endpoint: string, options: RequestInit = {}) {

.opencode/tool/github-triage.ts

@@ -1,5 +1,5 @@
 /// <reference path="../env.d.ts" />
-import { tool } from "@aictrl/plugin"
+import { tool } from "@aictrl/plugin-sdk"
 import DESCRIPTION from "./github-triage.txt"
 
 const TEAM = {

CONTRIBUTING.md

@@ -74,7 +74,7 @@ Replace `<platform>` with your platform (e.g., `darwin-arm64`, `linux-x64`).
   - `packages/aictrl/src/cli/cmd/tui/`: The TUI code, written in SolidJS with [opentui](https://github.com/sst/opentui)
   - `packages/app`: The shared web UI components, written in SolidJS
   - `packages/desktop`: The native desktop app, built with Tauri (wraps `packages/app`)
-  - `packages/plugin`: Source for `@aictrl/plugin`
+  - `packages/plugin`: Source for `@aictrl/plugin-sdk` (plugin-author SDK — types and helpers for writing CLI plugins)
 
 ### Understanding bun dev vs aictrl
 

package.json

@@ -74,7 +74,7 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "3.933.0",
-    "@aictrl/plugin": "workspace:*",
+    "@aictrl/plugin-sdk": "workspace:*",
     "@aictrl/script": "workspace:*",
     "@aictrl/sdk": "workspace:*",
     "typescript": "catalog:"

packages/cli/package.json

@@ -87,7 +87,7 @@
     "@agentclientprotocol/sdk": "0.14.1",
     "@ai-sdk/provider": "2.0.1",
     "@ai-sdk/provider-utils": "3.0.21",
-    "@aictrl/plugin": "workspace:*",
+    "@aictrl/plugin-sdk": "workspace:*",
     "@aictrl/sdk": "workspace:*",
     "@aictrl/util": "workspace:*",
     "@clack/prompts": "1.0.0-alpha.1",

packages/cli/src/cli/cmd/auth.ts

@@ -10,7 +10,7 @@ import { Config } from "../../config/config"
 import { Global } from "../../global"
 import { Plugin } from "../../plugin"
 import { Instance } from "../../project/instance"
-import type { Hooks } from "@aictrl/plugin"
+import type { Hooks } from "@aictrl/plugin-sdk"
 import { Process } from "../../util/process"
 import { text } from "node:stream/consumers"
 

packages/cli/src/config/config.ts

@@ -254,7 +254,7 @@ export namespace Config {
     }))
     json.dependencies = {
       ...json.dependencies,
-      "@aictrl/plugin": targetVersion,
+      "@aictrl/plugin-sdk": targetVersion,
     }
     await Filesystem.writeJson(pkg, json)
 
@@ -304,15 +304,15 @@ export namespace Config {
 
     const parsed = await Filesystem.readJson<{ dependencies?: Record<string, string> }>(pkg).catch(() => null)
     const dependencies = parsed?.dependencies ?? {}
-    const depVersion = dependencies["@aictrl/plugin"]
+    const depVersion = dependencies["@aictrl/plugin-sdk"]
     if (!depVersion) return true
 
     const targetVersion = Installation.isLocal() ? "latest" : Installation.VERSION
     if (targetVersion === "latest") {
-      const isOutdated = await PackageRegistry.isOutdated("@aictrl/plugin", depVersion, dir)
+      const isOutdated = await PackageRegistry.isOutdated("@aictrl/plugin-sdk", depVersion, dir)
       if (!isOutdated) return false
       log.info("Cached version is outdated, proceeding with install", {
-        pkg: "@aictrl/plugin",
+        pkg: "@aictrl/plugin-sdk",
         cachedVersion: depVersion,
       })
       return true

packages/cli/src/plugin/codex.ts

@@ -1,4 +1,4 @@
-import type { Hooks, PluginInput } from "@aictrl/plugin"
+import type { Hooks, PluginInput } from "@aictrl/plugin-sdk"
 import { Log } from "../util/log"
 import { Installation } from "../installation"
 import { Auth, OAUTH_DUMMY_KEY } from "../auth"

packages/cli/src/plugin/copilot.ts

@@ -1,4 +1,4 @@
-import type { Hooks, PluginInput } from "@aictrl/plugin"
+import type { Hooks, PluginInput } from "@aictrl/plugin-sdk"
 import { Installation } from "@/installation"
 import { iife } from "@/util/iife"
 

packages/cli/src/plugin/index.ts

@@ -1,4 +1,4 @@
-import type { Hooks, PluginInput, Plugin as PluginInstance } from "@aictrl/plugin"
+import type { Hooks, PluginInput, Plugin as PluginInstance } from "@aictrl/plugin-sdk"
 import { Config } from "../config/config"
 import { Bus } from "../bus"
 import { Log } from "../util/log"

packages/cli/src/provider/auth.ts

@@ -3,7 +3,7 @@ import { Plugin } from "../plugin"
 import { map, filter, pipe, fromEntries, mapValues } from "remeda"
 import z from "zod"
 import { fn } from "@/util/fn"
-import type { AuthOuathResult, Hooks } from "@aictrl/plugin"
+import type { AuthOuathResult, Hooks } from "@aictrl/plugin-sdk"
 import { NamedError } from "@aictrl/util/error"
 import { Auth } from "@/auth"
 

packages/cli/src/tool/registry.ts

@@ -17,7 +17,7 @@ import { Tool } from "./tool"
 import { Instance } from "../project/instance"
 import { Config } from "../config/config"
 import path from "path"
-import { type ToolContext as PluginToolContext, type ToolDefinition } from "@aictrl/plugin"
+import { type ToolContext as PluginToolContext, type ToolDefinition } from "@aictrl/plugin-sdk"
 import z from "zod"
 import { Plugin } from "../plugin"
 import { WebSearchTool } from "./websearch"

packages/cli/test/cli/plugin-auth-picker.test.ts

@@ -1,6 +1,6 @@
 import { test, expect, describe } from "bun:test"
 import { resolvePluginProviders } from "../../src/cli/cmd/auth"
-import type { Hooks } from "@aictrl/plugin"
+import type { Hooks } from "@aictrl/plugin-sdk"
 
 function hookWithAuth(provider: string): Hooks {
   return {

packages/cli/test/config/config.test.ts

@@ -1550,7 +1550,7 @@ describe("getPluginName", () => {
 
   test("extracts name from scoped npm package", () => {
     expect(Config.getPluginName("@scope/pkg@1.0.0")).toBe("@scope/pkg")
-    expect(Config.getPluginName("@aictrl/plugin@2.0.0")).toBe("@aictrl/plugin")
+    expect(Config.getPluginName("@aictrl/plugin-sdk@2.0.0")).toBe("@aictrl/plugin-sdk")
   })
 
   test("returns full string for package without version", () => {

packages/cli/test/tool/registry.test.ts

@@ -90,7 +90,7 @@ describe("tool.registry", () => {
           JSON.stringify({
             name: "custom-tools",
             dependencies: {
-              "@aictrl/plugin": "0.1.0",
+              "@aictrl/plugin-sdk": "0.1.0",
               cowsay: "^1.6.0",
             },
           }),

packages/plugin/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "name": "@aictrl/plugin",
-  "version": "1.2.16",
+  "name": "@aictrl/plugin-sdk",
+  "version": "0.1.0",
   "type": "module",
   "license": "MIT",
   "repository": {