agent-plugkit 0.1.0

package/dist/schema/plugin-yaml.js

@@ -0,0 +1,241 @@
+/**
+ * plugin.yaml JSON Schema 定义
+ *
+ * 这是 marketplace 的核心数据模型。所有 plugin.yaml 都必须符合此 schema。
+ * 生成 Agent Plugins portable 与平台原生产物时，也基于此 schema 做字段映射。
+ */
+// ── JSON Schema ──────────────────────────────────────────
+export const pluginYamlSchema = {
+    type: 'object',
+    required: ['name', 'version', 'description', 'author', 'components'],
+    additionalProperties: false,
+    properties: {
+        name: {
+            type: 'string',
+            pattern: '^(?!.*--)[a-z0-9][a-z0-9-]*[a-z0-9]$',
+            minLength: 2,
+            maxLength: 64,
+        },
+        version: {
+            type: 'string',
+            pattern: '^\\d+\\.\\d+\\.\\d+',
+        },
+        description: {
+            type: 'string',
+            minLength: 1,
+            maxLength: 500,
+        },
+        author: {
+            type: 'object',
+            required: ['name'],
+            additionalProperties: false,
+            properties: {
+                name: { type: 'string' },
+                email: { type: 'string', nullable: true },
+                url: { type: 'string', nullable: true },
+            },
+        },
+        homepage: {
+            type: 'string',
+            nullable: true,
+        },
+        repository: {
+            type: 'string',
+            nullable: true,
+        },
+        license: {
+            type: 'string',
+            nullable: true,
+        },
+        category: {
+            type: 'string',
+            nullable: true,
+        },
+        tags: {
+            type: 'array',
+            items: { type: 'string' },
+            nullable: true,
+        },
+        components: {
+            type: 'object',
+            required: [],
+            additionalProperties: false,
+            properties: {
+                skills: {
+                    type: 'array',
+                    nullable: true,
+                    items: {
+                        type: 'object',
+                        required: ['name', 'path'],
+                        additionalProperties: false,
+                        properties: {
+                            name: { type: 'string' },
+                            path: { type: 'string' },
+                            description: { type: 'string', nullable: true },
+                            'argument-hint': { type: 'string', nullable: true },
+                        },
+                    },
+                },
+                mcp: {
+                    type: 'array',
+                    nullable: true,
+                    items: {
+                        oneOf: [
+                            {
+                                type: 'object',
+                                required: ['name', 'command'],
+                                additionalProperties: false,
+                                properties: {
+                                    name: { type: 'string' },
+                                    type: {
+                                        type: 'string',
+                                        enum: ['stdio'],
+                                        nullable: true,
+                                    },
+                                    command: { type: 'string' },
+                                    args: {
+                                        type: 'array',
+                                        items: { type: 'string' },
+                                        nullable: true,
+                                    },
+                                    env: {
+                                        type: 'object',
+                                        nullable: true,
+                                        required: [],
+                                        additionalProperties: { type: 'string' },
+                                    },
+                                    cwd: { type: 'string', nullable: true },
+                                    description: { type: 'string', nullable: true },
+                                },
+                            },
+                            {
+                                type: 'object',
+                                required: ['name', 'type', 'url'],
+                                additionalProperties: false,
+                                properties: {
+                                    name: { type: 'string' },
+                                    type: {
+                                        type: 'string',
+                                        enum: ['streamable-http', 'sse'],
+                                    },
+                                    url: { type: 'string' },
+                                    headers: {
+                                        type: 'object',
+                                        nullable: true,
+                                        required: [],
+                                        additionalProperties: { type: 'string' },
+                                    },
+                                    description: { type: 'string', nullable: true },
+                                },
+                            },
+                        ],
+                    },
+                },
+                lsp: {
+                    type: 'array',
+                    nullable: true,
+                    items: {
+                        type: 'object',
+                        required: ['name', 'command', 'extensionToLanguage'],
+                        additionalProperties: false,
+                        properties: {
+                            name: { type: 'string' },
+                            command: { type: 'string' },
+                            args: {
+                                type: 'array',
+                                items: { type: 'string' },
+                                nullable: true,
+                            },
+                            env: {
+                                type: 'object',
+                                nullable: true,
+                                required: [],
+                                additionalProperties: { type: 'string' },
+                            },
+                            transport: {
+                                type: 'string',
+                                enum: ['stdio', 'socket', null],
+                                nullable: true,
+                            },
+                            extensionToLanguage: {
+                                type: 'object',
+                                required: [],
+                                additionalProperties: { type: 'string' },
+                            },
+                            workspaceFolder: { type: 'string', nullable: true },
+                            startupTimeout: { type: 'number', nullable: true },
+                            maxRestarts: { type: 'number', nullable: true },
+                            diagnostics: { type: 'boolean', nullable: true },
+                        },
+                    },
+                },
+                hooks: {
+                    type: 'array',
+                    nullable: true,
+                    items: {
+                        type: 'object',
+                        required: ['event', 'command'],
+                        additionalProperties: false,
+                        properties: {
+                            event: { type: 'string' },
+                            pattern: { type: 'string', nullable: true },
+                            command: { type: 'string' },
+                            timeout: { type: 'number', nullable: true },
+                        },
+                    },
+                },
+            },
+        },
+        platform: {
+            type: 'object',
+            nullable: true,
+            required: [],
+            additionalProperties: false,
+            properties: {
+                codex: {
+                    type: 'object',
+                    nullable: true,
+                    required: [],
+                    additionalProperties: false,
+                    properties: {
+                        interface: {
+                            type: 'object',
+                            nullable: true,
+                            required: [],
+                            additionalProperties: false,
+                            properties: {
+                                displayName: { type: 'string', nullable: true },
+                                shortDescription: { type: 'string', nullable: true },
+                                longDescription: { type: 'string', nullable: true },
+                                category: { type: 'string', nullable: true },
+                                developerName: { type: 'string', nullable: true },
+                                capabilities: {
+                                    type: 'array',
+                                    nullable: true,
+                                    items: {
+                                        type: 'string',
+                                        minLength: 1,
+                                        pattern: '\\S',
+                                    },
+                                },
+                                defaultPrompt: {
+                                    type: 'array',
+                                    nullable: true,
+                                    minItems: 1,
+                                    maxItems: 3,
+                                    items: {
+                                        type: 'string',
+                                        minLength: 1,
+                                        maxLength: 128,
+                                        pattern: '\\S',
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=plugin-yaml.js.map

package/dist/schema/plugin-yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-yaml.js","sourceRoot":"","sources":["../../src/schema/plugin-yaml.ts"],"names":[],"mappings":"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"}

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Markdown frontmatter 最小解析器
+ *
+ * 不为 frontmatter 解析引入 gray-matter 之类的额外第三方库。这里只解析 SKILL.md 的 `---`
+ * YAML 头块，用现有 js-yaml 处理块内容。
+ *
+ * 与 utils/ 层其余文件一样：不引入 chalk/console，不抛业务错误。调用方（命令层）拥有文件路径
+ * 上下文，应由它拼出面向用户的中文错误文案。
+ *
+ * 已知取舍：frontmatter 块内若使用 YAML 块标量（| 或 >）且块内容含独立的 `---` 行，会被
+ * 提前当作闭合分隔符截断，退化为 invalid-yaml。这是刻意的最小实现，不做 YAML 流式扫描。
+ */
+export type FrontmatterFailure = {
+    kind: 'unterminated';
+} | {
+    kind: 'invalid-yaml';
+    message: string;
+} | {
+    kind: 'not-object';
+};
+export type FrontmatterResult = {
+    ok: true;
+    present: boolean;
+    data: Record<string, unknown>;
+} | {
+    ok: false;
+    failure: FrontmatterFailure;
+};
+export declare function parseFrontmatter(raw: string): FrontmatterResult;
+export declare function frontmatterString(data: Record<string, unknown>, key: string): string | undefined;

package/dist/utils/frontmatter.js

@@ -0,0 +1,60 @@
+/**
+ * Markdown frontmatter 最小解析器
+ *
+ * 不为 frontmatter 解析引入 gray-matter 之类的额外第三方库。这里只解析 SKILL.md 的 `---`
+ * YAML 头块，用现有 js-yaml 处理块内容。
+ *
+ * 与 utils/ 层其余文件一样：不引入 chalk/console，不抛业务错误。调用方（命令层）拥有文件路径
+ * 上下文，应由它拼出面向用户的中文错误文案。
+ *
+ * 已知取舍：frontmatter 块内若使用 YAML 块标量（| 或 >）且块内容含独立的 `---` 行，会被
+ * 提前当作闭合分隔符截断，退化为 invalid-yaml。这是刻意的最小实现，不做 YAML 流式扫描。
+ */
+import yaml from 'js-yaml';
+const DELIMITER = '---';
+function stripBom(raw) {
+    return raw.charCodeAt(0) === 0xfeff ? raw.slice(1) : raw;
+}
+export function parseFrontmatter(raw) {
+    const normalized = stripBom(raw);
+    const lines = normalized.split('\n').map((line) => line.replace(/\r$/, ''));
+    if (lines.length === 0 || lines[0].trimEnd() !== DELIMITER) {
+        return { ok: true, present: false, data: {} };
+    }
+    let closingIndex = -1;
+    for (let i = 1; i < lines.length; i += 1) {
+        if (lines[i].trimEnd() === DELIMITER) {
+            closingIndex = i;
+            break;
+        }
+    }
+    if (closingIndex === -1) {
+        return { ok: false, failure: { kind: 'unterminated' } };
+    }
+    const block = lines.slice(1, closingIndex).join('\n');
+    let parsed;
+    try {
+        parsed = yaml.load(block);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            failure: { kind: 'invalid-yaml', message: err.message },
+        };
+    }
+    if (parsed === undefined || parsed === null) {
+        return { ok: true, present: true, data: {} };
+    }
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return { ok: false, failure: { kind: 'not-object' } };
+    }
+    return { ok: true, present: true, data: parsed };
+}
+export function frontmatterString(data, key) {
+    const value = data[key];
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"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"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 共享工具函数
+ *
+ * 提供 plugin.yaml 加载、校验、路径解析等通用能力。
+ */
+import type { PluginYaml } from '../schema/plugin-yaml.js';
+import { type MarketplaceMetadata } from '../application/marketplace.js';
+export type { MarketplaceMetadata } from '../application/marketplace.js';
+export interface PluginRepoContext {
+    rootDir: string;
+    pluginsDir: string;
+    marketplaceYamlPath: string;
+    distDir: string;
+}
+export declare function resolveInvocationPath(pathArg: string): string;
+export declare function findMarketplaceRoot(startDir?: string): string | undefined;
+export declare function resolveRepoContext(rootArg?: string, options?: {
+    allowMissingMarketplace?: boolean;
+}): PluginRepoContext;
+/**
+ * 加载并校验一个 plugin.yaml
+ */
+export declare function loadPluginYaml(pluginDir: string): PluginYaml;
+/**
+ * 加载 marketplace.yaml。该文件是所有客户端 marketplace index 的元数据来源。
+ */
+export declare function loadMarketplaceMetadata(context: PluginRepoContext): MarketplaceMetadata;
+/**
+ * 获取所有插件目录名
+ */
+export declare function listPluginNames(context: PluginRepoContext): string[];
+/**
+ * 加载所有插件
+ */
+export declare function loadAllPlugins(context: PluginRepoContext): Array<{
+    name: string;
+    dir: string;
+    config: PluginYaml;
+}>;
+/**
+ * 将 kebab-case 名称转为 Title Case
+ * 例如 "plugkit-maintain" → "Plugkit Maintain"
+ */
+export declare function toTitleCase(kebab: string): string;

package/dist/utils/helpers.js

@@ -0,0 +1,94 @@
+/**
+ * 共享工具函数
+ *
+ * 提供 plugin.yaml 加载、校验、路径解析等通用能力。
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { parsePluginYamlSource } from '../application/plugin-source.js';
+import { readMarketplaceMetadata, } from '../application/marketplace.js';
+export function resolveInvocationPath(pathArg) {
+    return resolve(process.env.INIT_CWD || process.cwd(), pathArg);
+}
+export function findMarketplaceRoot(startDir = process.cwd()) {
+    let current = resolve(startDir);
+    while (true) {
+        if (existsSync(join(current, 'marketplace.yaml'))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+export function resolveRepoContext(rootArg, options = {}) {
+    const rootDir = rootArg ? resolveInvocationPath(rootArg) : findMarketplaceRoot();
+    if (!rootDir) {
+        throw new Error('marketplace.yaml not found. Run `agent-plugkit init-repo` first or pass `--root <dir>`.');
+    }
+    const marketplaceYamlPath = join(rootDir, 'marketplace.yaml');
+    if (!options.allowMissingMarketplace && !existsSync(marketplaceYamlPath)) {
+        throw new Error(`marketplace.yaml not found: ${marketplaceYamlPath}. Run \`agent-plugkit --root ${rootDir} init-repo\` first.`);
+    }
+    return {
+        rootDir,
+        pluginsDir: join(rootDir, 'plugins'),
+        marketplaceYamlPath,
+        distDir: join(rootDir, 'dist'),
+    };
+}
+/**
+ * 加载并校验一个 plugin.yaml
+ */
+export function loadPluginYaml(pluginDir) {
+    const yamlPath = join(pluginDir, 'plugin.yaml');
+    if (!existsSync(yamlPath)) {
+        throw new Error(`plugin.yaml not found: ${yamlPath}`);
+    }
+    const raw = readFileSync(yamlPath, 'utf-8');
+    const parsed = parsePluginYamlSource(raw);
+    if (parsed.status !== 'valid') {
+        throw new Error(parsed.message);
+    }
+    return parsed.value;
+}
+/**
+ * 加载 marketplace.yaml。该文件是所有客户端 marketplace index 的元数据来源。
+ */
+export function loadMarketplaceMetadata(context) {
+    return readMarketplaceMetadata(context.rootDir);
+}
+/**
+ * 获取所有插件目录名
+ */
+export function listPluginNames(context) {
+    if (!existsSync(context.pluginsDir)) {
+        return [];
+    }
+    return readdirSync(context.pluginsDir, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .filter((d) => existsSync(join(context.pluginsDir, d.name, 'plugin.yaml')))
+        .map((d) => d.name);
+}
+/**
+ * 加载所有插件
+ */
+export function loadAllPlugins(context) {
+    return listPluginNames(context).map((name) => {
+        const dir = join(context.pluginsDir, name);
+        return { name, dir, config: loadPluginYaml(dir) };
+    });
+}
+/**
+ * 将 kebab-case 名称转为 Title Case
+ * 例如 "plugkit-maintain" → "Plugkit Maintain"
+ */
+export function toTitleCase(kebab) {
+    return kebab
+        .split('-')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "agent-plugkit",
+  "version": "0.1.0",
+  "private": false,
+  "description": "CLI toolkit for building and maintaining AI agent plugin marketplaces",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "agent-plugkit": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-plugkit/agent-plugkit.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-plugkit/agent-plugkit/issues"
+  },
+  "homepage": "https://github.com/agent-plugkit/agent-plugkit#readme",
+  "scripts": {
+    "clean": "rm -rf dist src/generated tsconfig.tsbuildinfo",
+    "generate:skill": "tsx scripts/generate-skill.ts",
+    "build": "npm run clean && npm run generate:skill && tsc && cp scripts/npm-dist.npmignore dist/.npmignore && chmod +x dist/cli.js",
+    "prepack": "npm run build",
+    "test": "npm run test:cli && npm run test:package",
+    "test:cli": "npm run test:install-repo && tsx scripts/test-cli.ts",
+    "test:install-repo": "tsx scripts/test-install-repo.ts",
+    "test:package": "npm run build && tsx scripts/test-package.ts",
+    "preagent-plugkit": "npm run generate:skill",
+    "agent-plugkit": "tsx src/cli.ts",
+    "predev": "npm run generate:skill",
+    "dev": "tsx watch src/cli.ts"
+  },
+  "dependencies": {
+    "ajv": "^8.17.0",
+    "chalk": "^5.4.0",
+    "commander": "^13.0.0",
+    "js-yaml": "^4.3.1",
+    "jsonc-parser": "^3.3.1",
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}