{"_id":"@aaplugin/kit","_rev":"2-ac5416359f820fd7362462fe9b625d47","name":"@aaplugin/kit","dist-tags":{"latest":"1.0.0-beta.2"},"versions":{"1.0.0-beta.1":{"name":"@aaplugin/kit","version":"1.0.0-beta.1","author":{"url":"https://github.com/wh1teAlter","name":"wh1teAlter"},"license":"MIT","_id":"@aaplugin/kit@1.0.0-beta.1","maintainers":[{"name":"wh1t3alter","email":"2369332823@qq.com"}],"homepage":"https://github.com/wh1teAlter/aaplugin#readme","bugs":{"url":"https://github.com/wh1teAlter/aaplugin/issues"},"bin":{"aaplugin":"dist/cli.mjs"},"dist":{"shasum":"419d03d50ddc5a55a9d0561d784468f3b467c02a","tarball":"https://registry.npmjs.org/@aaplugin/kit/-/kit-1.0.0-beta.1.tgz","fileCount":12,"integrity":"sha512-/YSjpy27TYLAsVuALWzEQBzynedwBHr7tdcPsXvLv4JP2IwlXAniN5EXAH5Bchu8f/IJIPavqX90AmmUy2LytQ==","signatures":[{"sig":"MEUCIQCEGuq9u2nzAFiWyB80qjdbrhKEFcS8/Lb1FYsXjO2+OAIgD6dMY2UjZxDN7seQbKt90Kp31E5b54ebbJ7Zy6CuiQQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":859952},"type":"module","_from":"file:aaplugin-kit-1.0.0-beta.1.tgz","engines":{"node":"^20.19.0 || ^22.13.0 || >=23.5.0"},"exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs"},"./sdk":{"types":"./dist/sdk.d.mts","import":"./dist/sdk.mjs"}},"scripts":{"dev":"tsdown --watch","test":"vitest run --passWithNoTests","build":"tsdown","pretest":"pnpm --filter @aaplugin/core run build","typecheck":"tsc -p tsconfig.json"},"_npmUser":{"name":"wh1t3alter","email":"2369332823@qq.com"},"_resolved":"/private/var/folders/07/ymy0fnqn20d7p_4hkrf8z97c0000gn/T/d4f91cda8b343ea02d9d0f037790d0ff/aaplugin-kit-1.0.0-beta.1.tgz","_integrity":"sha512-/YSjpy27TYLAsVuALWzEQBzynedwBHr7tdcPsXvLv4JP2IwlXAniN5EXAH5Bchu8f/IJIPavqX90AmmUy2LytQ==","repository":{"url":"git+https://github.com/wh1teAlter/aaplugin.git","type":"git","directory":"packages/aaplugin"},"_npmVersion":"10.9.4","description":"Canonical AI Plugin framework and CLI.","directories":{},"sideEffects":false,"_nodeVersion":"22.21.1","dependencies":{"semver":"^7.8.5","rolldown":"1.2.2","commander":"14.0.1","@inquirer/prompts":"^8.3.2","spdx-expression-parse":"^5.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsdown":"^0.22.14","vitest":"^4.1.10","typescript":"^6.0.3","@types/node":"^20.19.0","@types/semver":"^7.7.1","@aaplugin/core":"0.0.0-private","@types/spdx-expression-parse":"^4.0.0"},"_npmOperationalInternal":{"tmp":"tmp/kit_1.0.0-beta.1_1787753732851_0.6036015595282094","host":"s3://npm-registry-packages-npm-production"}},"1.0.0-beta.2":{"name":"@aaplugin/kit","version":"1.0.0-beta.2","description":"Canonical AI Plugin framework and CLI.","type":"module","license":"MIT","author":{"name":"wh1teAlter","url":"https://github.com/wh1teAlter"},"homepage":"https://github.com/wh1teAlter/aaplugin#readme","repository":{"type":"git","url":"git+https://github.com/wh1teAlter/aaplugin.git","directory":"packages/aaplugin"},"bugs":{"url":"https://github.com/wh1teAlter/aaplugin/issues"},"sideEffects":false,"engines":{"node":"^20.19.0 || ^22.13.0 || >=23.5.0"},"bin":{"aaplugin":"dist/cli.mjs"},"exports":{".":{"types":"./dist/index.d.mts","import":"./dist/index.mjs"},"./sdk":{"types":"./dist/sdk.d.mts","import":"./dist/sdk.mjs"}},"publishConfig":{"access":"public"},"dependencies":{"@inquirer/prompts":"^8.3.2","commander":"14.0.1","rolldown":"1.2.2","semver":"^7.8.5","spdx-expression-parse":"^5.0.0"},"devDependencies":{"@types/node":"^20.19.43","@types/semver":"^7.7.1","@types/spdx-expression-parse":"^4.0.0","tsdown":"^0.22.14","typescript":"^6.0.3","vitest":"^4.1.11","@aaplugin/core":"0.0.0-private"},"scripts":{"build":"tsdown","dev":"tsdown --watch","pretest":"pnpm --filter @aaplugin/core run build","test":"vitest run --passWithNoTests","typecheck":"tsc -p tsconfig.json"},"_id":"@aaplugin/kit@1.0.0-beta.2","_integrity":"sha512-pBGY+peyu5Sso17MUsKZSipAQl/flHMalLrvge5bTz8wkPip2dVq8KzeoJu8lzJA6n4Nn+05Ptf3AAIRrOWHOg==","_resolved":"/private/var/folders/07/ymy0fnqn20d7p_4hkrf8z97c0000gn/T/281882c33a7ddea9d62392be4daaf314/aaplugin-kit-1.0.0-beta.2.tgz","_from":"file:aaplugin-kit-1.0.0-beta.2.tgz","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-pBGY+peyu5Sso17MUsKZSipAQl/flHMalLrvge5bTz8wkPip2dVq8KzeoJu8lzJA6n4Nn+05Ptf3AAIRrOWHOg==","shasum":"3ca6e7d6df2d512efb05c304fb76fed05a0f5693","tarball":"https://registry.npmjs.org/@aaplugin/kit/-/kit-1.0.0-beta.2.tgz","fileCount":12,"unpackedSize":857149,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEDc13rN7NAGJqY/OdOrWZ2BUEIBogvdRzyBsoU48deoAiAVW4fySS3ZMEZXX+Np8jDbp0RsL8ru7oL0VvKFeCDYng=="}]},"_npmUser":{"name":"wh1t3alter","email":"2369332823@qq.com"},"directories":{},"maintainers":[{"name":"wh1t3alter","email":"2369332823@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kit_1.0.0-beta.2_1788859402856_0.7566919613835836"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-26T14:15:32.615Z","modified":"2026-09-08T09:23:23.187Z","1.0.0-beta.1":"2026-08-26T14:15:33.022Z","1.0.0-beta.2":"2026-09-08T09:23:23.004Z"},"bugs":{"url":"https://github.com/wh1teAlter/aaplugin/issues"},"author":{"name":"wh1teAlter","url":"https://github.com/wh1teAlter"},"license":"MIT","homepage":"https://github.com/wh1teAlter/aaplugin#readme","repository":{"type":"git","url":"git+https://github.com/wh1teAlter/aaplugin.git","directory":"packages/aaplugin"},"description":"Canonical AI Plugin framework and CLI.","maintainers":[{"name":"wh1t3alter","email":"2369332823@qq.com"}],"readme":"# @aaplugin/kit\n\nRolldown-based AI Plugin framework, public lifecycle SDK, and CLI. Platform and Extension implementations are independently installed peer packages.\n\nRequires Node.js `^20.19.0 || ^22.13.0 || >=23.5.0`.\n\n```bash\npnpm add -D @aaplugin/kit \\\n  @aaplugin/platform-claude-code \\\n  @aaplugin/platform-codex\n```\n\n```ts\n// aaplugin.config.ts\nimport { defineConfig } from '@aaplugin/kit';\nimport claudeCode from '@aaplugin/platform-claude-code';\nimport codex from '@aaplugin/platform-codex';\n\nexport default defineConfig({\n  name: 'my-plugin',\n  version: '1.0.0',\n  description: 'Reusable AI workflows.',\n  platforms: [claudeCode(), codex()],\n});\n```\n\n```text\nsrc/\n├── commands/*.md\n├── skills/*/SKILL.md\n└── agents/*.md\npublic/\naaplugin.config.ts\n```\n\n`platforms` is required and there is no runtime default. `init` selects Claude Code and Codex only as a scaffolding default, writing their dependencies and imports explicitly. Select all six during scaffolding with:\n\n```bash\npnpm exec aaplugin init my-plugin --yes \\\n  --platform claude-code codex cursor antigravity opencode pi\n```\n\nOr install and configure the independent packages directly:\n\n```ts\nimport { defineConfig } from '@aaplugin/kit';\nimport antigravity from '@aaplugin/platform-antigravity';\nimport claudeCode from '@aaplugin/platform-claude-code';\nimport codex from '@aaplugin/platform-codex';\nimport cursor from '@aaplugin/platform-cursor';\nimport openCode from '@aaplugin/platform-opencode';\nimport pi from '@aaplugin/platform-pi';\n\nexport default defineConfig({\n  name: 'my-plugin',\n  version: '1.0.0',\n  description: 'Reusable AI workflows.',\n  platforms: [claudeCode(), codex(), cursor(), antigravity(), openCode(), pi()],\n  build: { strict: false },\n});\n```\n\nClaude Code, Codex, Cursor, and Antigravity produce Plugin Packages. OpenCode produces a workspace overlay; Pi produces an npm Package. The compatibility report records native, transformed, degraded, and unsupported behavior before any managed output is committed.\n\nThe main package does not re-export official Platforms or Extensions and has no `platforms/*` subpath. Official and third-party integrations use the same `definePlatform()`, `defineExtension()`, Session, and Contributor contracts from `@aaplugin/kit/sdk`, so the framework needs no registry or source change to accept another implementation.\n\nClaude Code can be configured as an explicit Platform. Omitting `marketplace` builds only the installable Plugin; `marketplace: {}` additionally creates a self-contained single-Plugin Marketplace from the top-level metadata.\n\nClaude Code 可以作为显式 Platform 配置。省略 `marketplace` 时只构建可安装 Plugin；配置 `marketplace: {}` 时，会从顶层元数据推导并额外生成一个自包含的单 Plugin Marketplace。\n\n```ts\nimport { defineConfig } from '@aaplugin/kit';\nimport claudeCode from '@aaplugin/platform-claude-code';\n\nexport default defineConfig({\n  name: 'my-plugin',\n  version: '1.0.0',\n  description: 'Reusable AI workflows.',\n  author: { name: 'wh1teAlter' },\n  platforms: [\n    claudeCode({\n      marketplace: {\n        owner: { name: 'wh1teAlter' },\n        category: 'Developer Tools',\n        tags: ['workflow'],\n      },\n    }),\n  ],\n});\n```\n\nThe Claude Code output uses `.claude-plugin/plugin.json`, `commands/`, `skills/`, and `agents/`. Hooks and MCP remain independent Extensions: the Platform only exposes validated `hooks` and `mcpServers` manifest extension points and never imports those Extension packages.\n\nClaude Code 产物使用 `.claude-plugin/plugin.json`、`commands/`、`skills/` 与 `agents/`。Hooks 和 MCP 仍是独立 Extension：Platform 只提供经过校验的 `hooks` 与 `mcpServers` 清单扩展点，不依赖对应 Extension 包。\n\n```bash\npnpm exec aaplugin validate\npnpm exec aaplugin inspect\npnpm exec aaplugin build\n```\n\nHooks and MCP are optional official Extensions（Hooks 与 MCP 通过可选的官方 Extension 启用）. Their Platform Contributors are included in the Extension packages, while each Platform remains independent of them:\n\n```bash\npnpm add -D @aaplugin/extension-hooks @aaplugin/extension-mcp\n```\n\nNode Runtime is built into Core: direct TypeScript/JavaScript files under `src/runtime/` are compiled once through the Core-owned Rolldown Compiler and delivered only to Platforms that declare a stable Plugin-local Node 20 ESM capability. It does not require another package or factory.\n\nSee the [repository documentation](https://github.com/wh1teAlter/aaplugin#readme) for the complete authoring schema, compatibility rules, and security model.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}