agent-plugkit 0.1.0

package/dist/application/marketplace-registration.js

@@ -0,0 +1,304 @@
+import { existsSync, lstatSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { isAbsolute, resolve, sep } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { getMarketplaceRegistrationAdapter, MARKETPLACE_REGISTRATION_ADAPTERS, } from '../adapters/marketplace-registration.js';
+import { CommandError } from '../core/errors.js';
+import { AGENT_TARGET_IDS, isAgentTargetId, } from './marketplace-registration-contract.js';
+const GITHUB_SHORTHAND = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/;
+const SCP_SSH_URL = /^[A-Za-z0-9._-]+@[A-Za-z0-9.-]+:[^\s:][^\s]*$/;
+const TERMINAL_CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/u;
+function assertNoTerminalControlCharacters(value, label) {
+    if (TERMINAL_CONTROL_CHARACTERS.test(value)) {
+        throw new CommandError(`${label}不能包含 C0、C1 或 DEL 控制字符。`);
+    }
+}
+function assertNoEncodedTerminalControlCharacters(value, label) {
+    let decoded;
+    try {
+        decoded = decodeURIComponent(value);
+    }
+    catch {
+        throw new CommandError(`${label}包含无效的百分号编码。`);
+    }
+    assertNoTerminalControlCharacters(decoded, `解码后的${label}`);
+}
+function appendPathWithoutNormalizing(baseDir, relativePath) {
+    return `${baseDir}${baseDir.endsWith(sep) ? '' : sep}${relativePath}`;
+}
+function expandHomePath(value, homeDir) {
+    if (value === '~') {
+        return resolve(homeDir);
+    }
+    if (value.startsWith('~/') || value.startsWith('~\\')) {
+        return appendPathWithoutNormalizing(resolve(homeDir), value.slice(2));
+    }
+    return value;
+}
+function looksLikeLocalPath(value) {
+    return (value === '.' ||
+        value === '..' ||
+        value === '~' ||
+        value.startsWith('./') ||
+        value.startsWith('../') ||
+        value.startsWith('~/') ||
+        value.startsWith('.\\') ||
+        value.startsWith('..\\') ||
+        value.startsWith('~\\') ||
+        isAbsolute(value) ||
+        /^[A-Za-z]:[\\/]/.test(value));
+}
+function normalizeLocalSource(input, candidatePath) {
+    const stat = lstatSync(candidatePath);
+    if (!stat.isDirectory() && !stat.isSymbolicLink()) {
+        throw new CommandError(`Marketplace 本地来源不是目录: ${candidatePath}`);
+    }
+    const localPath = realpathSync(candidatePath);
+    assertNoTerminalControlCharacters(localPath, '解析后的 Marketplace 本地路径');
+    if (!lstatSync(localPath).isDirectory()) {
+        throw new CommandError(`Marketplace 本地来源不是目录: ${candidatePath}`);
+    }
+    return {
+        kind: 'local',
+        input,
+        displayValue: localPath,
+        clientValue: localPath,
+        vscodeValue: pathToFileURL(localPath).href,
+        localPath,
+    };
+}
+function normalizeHttpsSource(input, parsed) {
+    if (parsed.protocol !== 'https:') {
+        throw new CommandError(`Git URL 只接受 HTTPS 或 SSH: ${parsed.protocol}`);
+    }
+    if (parsed.username || parsed.password) {
+        throw new CommandError('Git URL 不能包含内嵌凭据；请使用客户端已有的认证配置。');
+    }
+    if (!parsed.hostname || parsed.pathname.split('/').filter(Boolean).length < 2) {
+        throw new CommandError('HTTPS Git URL 必须包含主机、owner 与 repository 路径。');
+    }
+    if (parsed.search || parsed.hash) {
+        throw new CommandError('Git URL 不能包含 query 或 fragment。');
+    }
+    return {
+        kind: 'git',
+        input,
+        displayValue: input,
+        clientValue: input,
+        vscodeValue: input,
+    };
+}
+function normalizeSshSource(input, parsed) {
+    if (parsed.password) {
+        throw new CommandError('SSH Git URL 不能包含内嵌密码。');
+    }
+    if (!parsed.hostname || parsed.pathname.split('/').filter(Boolean).length < 2) {
+        throw new CommandError('SSH Git URL 必须包含主机、owner 与 repository 路径。');
+    }
+    if (parsed.search || parsed.hash) {
+        throw new CommandError('SSH Git URL 不能包含 query 或 fragment。');
+    }
+    return {
+        kind: 'git',
+        input,
+        displayValue: input,
+        clientValue: input,
+        vscodeValue: input,
+    };
+}
+export function normalizeMarketplaceSource(sourceInput, options = {}) {
+    assertNoTerminalControlCharacters(sourceInput, 'Marketplace 来源');
+    if (sourceInput.length === 0 || sourceInput !== sourceInput.trim()) {
+        throw new CommandError('Marketplace 来源不能为空，也不能包含首尾空白。');
+    }
+    if (sourceInput.startsWith('-')) {
+        throw new CommandError('Marketplace 来源不能以 - 开头。');
+    }
+    const baseDir = resolve(options.baseDir ?? process.env.INIT_CWD ?? process.cwd());
+    const expanded = expandHomePath(sourceInput, options.homeDir ?? homedir());
+    const localCandidate = isAbsolute(expanded)
+        ? expanded
+        : appendPathWithoutNormalizing(baseDir, expanded);
+    assertNoTerminalControlCharacters(localCandidate, '解析后的 Marketplace 本地路径');
+    if (existsSync(localCandidate)) {
+        return normalizeLocalSource(sourceInput, localCandidate);
+    }
+    if (looksLikeLocalPath(sourceInput)) {
+        throw new CommandError(`Marketplace 本地路径不存在: ${localCandidate}`);
+    }
+    const shorthand = GITHUB_SHORTHAND.exec(sourceInput);
+    if (shorthand) {
+        if (shorthand[1] === '.' || shorthand[1] === '..' || shorthand[2] === '.' || shorthand[2] === '..') {
+            throw new CommandError('GitHub owner/repo 的 owner 与 repository 不能是 . 或 ..。');
+        }
+        return {
+            kind: 'git',
+            input: sourceInput,
+            displayValue: sourceInput,
+            clientValue: sourceInput,
+            vscodeValue: sourceInput,
+        };
+    }
+    if (SCP_SSH_URL.test(sourceInput)) {
+        assertNoEncodedTerminalControlCharacters(sourceInput, 'SCP SSH Git URL');
+        return {
+            kind: 'git',
+            input: sourceInput,
+            displayValue: sourceInput,
+            clientValue: sourceInput,
+            vscodeValue: sourceInput,
+        };
+    }
+    if (sourceInput.includes('://')) {
+        assertNoEncodedTerminalControlCharacters(sourceInput, 'Marketplace Git URL');
+        let parsed;
+        try {
+            parsed = new URL(sourceInput);
+        }
+        catch {
+            throw new CommandError('Marketplace Git URL 格式无效。');
+        }
+        if (parsed.protocol === 'ssh:') {
+            return normalizeSshSource(sourceInput, parsed);
+        }
+        return normalizeHttpsSource(sourceInput, parsed);
+    }
+    throw new CommandError('无法识别来源；请传入已存在的本地目录、owner/repo、HTTPS Git URL 或 SSH Git URL。');
+}
+export function normalizeTargetIds(values) {
+    const requested = new Set();
+    for (const value of values) {
+        if (!isAgentTargetId(value)) {
+            throw new CommandError(`未知 agent: ${value}。可选值: ${AGENT_TARGET_IDS.join(', ')}`);
+        }
+        requested.add(value);
+    }
+    const normalized = AGENT_TARGET_IDS.filter((id) => requested.has(id));
+    if (normalized.length === 0) {
+        throw new CommandError('至少选择一个 agent。');
+    }
+    return normalized;
+}
+export async function inspectMarketplaceRegistration(sourceInput, options = {}) {
+    const source = normalizeMarketplaceSource(sourceInput, options);
+    const targetIds = normalizeTargetIds(options.targetIds ?? AGENT_TARGET_IDS);
+    const selected = new Set(targetIds);
+    const targets = [];
+    let interrupted = false;
+    for (const adapter of MARKETPLACE_REGISTRATION_ADAPTERS) {
+        if (!selected.has(adapter.id)) {
+            continue;
+        }
+        if (!interrupted && options.runtime?.signal?.aborted) {
+            targets.push({
+                id: adapter.id,
+                label: adapter.label,
+                status: 'interrupted',
+                message: '因用户中断未执行能力探测或注册。',
+                recovery: '确认客户端状态后重新运行命令。',
+            });
+            interrupted = true;
+            continue;
+        }
+        if (interrupted) {
+            targets.push({
+                id: adapter.id,
+                label: adapter.label,
+                status: 'interrupted',
+                message: '因前序目标中断未执行能力探测或注册。',
+                recovery: '确认中断目标的客户端状态后重新运行命令。',
+            });
+            continue;
+        }
+        const inspection = await adapter.inspect(source, options.runtime);
+        targets.push(inspection);
+        if (inspection.status === 'interrupted') {
+            interrupted = true;
+        }
+    }
+    return { source, targets };
+}
+function resultFromInspection(target) {
+    return {
+        id: target.id,
+        label: target.label,
+        status: target.status === 'ready' ? 'failed' : target.status,
+        message: target.message,
+        recovery: target.recovery,
+        ...(target.invocation ? { invocation: target.invocation } : {}),
+    };
+}
+function interruptedBeforeRegistrationResult(target, message) {
+    return {
+        id: target.id,
+        label: target.label,
+        status: 'interrupted',
+        message,
+        recovery: '确认中断目标的客户端状态后重新运行命令。',
+        ...(target.invocation ? { invocation: target.invocation } : {}),
+    };
+}
+export function marketplaceRegistrationExitCode(results) {
+    if (results.some((result) => result.status === 'interrupted')) {
+        return 130;
+    }
+    const completed = results.filter((result) => result.status === 'completed').length;
+    if (completed === results.length && results.length > 0) {
+        return 0;
+    }
+    if (completed > 0) {
+        return 2;
+    }
+    return 1;
+}
+export async function executeMarketplaceRegistration(inspection, options = {}) {
+    const preflightInterruptedIndex = inspection.targets.findIndex((target) => target.status === 'interrupted');
+    if (preflightInterruptedIndex >= 0) {
+        const results = inspection.targets.map((target, index) => {
+            if (index < preflightInterruptedIndex && target.status === 'ready') {
+                return interruptedBeforeRegistrationResult(target, `因能力探测阶段中断未执行注册。预检状态：${target.message}`);
+            }
+            return resultFromInspection(target);
+        });
+        results.forEach((result) => options.onTargetResult?.(result));
+        return {
+            source: inspection.source,
+            results,
+            exitCode: 130,
+        };
+    }
+    const results = [];
+    for (const [index, target] of inspection.targets.entries()) {
+        if (options.runtime?.signal?.aborted) {
+            for (const remaining of inspection.targets.slice(index)) {
+                const skipped = remaining.status === 'ready'
+                    ? interruptedBeforeRegistrationResult(remaining, `因用户中断未执行注册。预检状态：${remaining.message}`)
+                    : resultFromInspection(remaining);
+                results.push(skipped);
+                options.onTargetResult?.(skipped);
+            }
+            break;
+        }
+        options.onTargetStart?.(target);
+        const adapter = getMarketplaceRegistrationAdapter(target.id);
+        const result = await adapter.execute(inspection.source, target, options.runtime);
+        results.push(result);
+        options.onTargetResult?.(result);
+        if (result.status === 'interrupted') {
+            for (const remaining of inspection.targets.slice(index + 1)) {
+                const skipped = remaining.status === 'ready'
+                    ? interruptedBeforeRegistrationResult(remaining, `因前序目标中断未执行注册。预检状态：${remaining.message}`)
+                    : resultFromInspection(remaining);
+                results.push(skipped);
+                options.onTargetResult?.(skipped);
+            }
+            break;
+        }
+    }
+    return {
+        source: inspection.source,
+        results,
+        exitCode: marketplaceRegistrationExitCode(results),
+    };
+}
+//# sourceMappingURL=marketplace-registration.js.map

package/dist/application/marketplace-registration.js.map

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

package/dist/application/marketplace.d.ts

@@ -0,0 +1,9 @@
+import { type MarketplaceMetadata } from './marketplace-document-contract.js';
+export { MARKETPLACE_FILENAME, type MarketplaceMetadata, } from './marketplace-document-contract.js';
+/**
+ * Compatibility reader for existing CLI and health consumers. Document
+ * interpretation is owned by marketplace-document; callers keep their current
+ * throw-on-invalid behavior and optional-field compatibility without a
+ * parallel YAML parser.
+ */
+export declare function readMarketplaceMetadata(rootDirectory: string): MarketplaceMetadata;

package/dist/application/marketplace.js

@@ -0,0 +1,32 @@
+import { join } from 'node:path';
+import { readMarketplaceCompatibilityView } from './marketplace-document.js';
+import { MARKETPLACE_FILENAME, } from './marketplace-document-contract.js';
+export { MARKETPLACE_FILENAME, } from './marketplace-document-contract.js';
+/**
+ * Compatibility reader for existing CLI and health consumers. Document
+ * interpretation is owned by marketplace-document; callers keep their current
+ * throw-on-invalid behavior and optional-field compatibility without a
+ * parallel YAML parser.
+ */
+export function readMarketplaceMetadata(rootDirectory) {
+    const result = readMarketplaceCompatibilityView(rootDirectory);
+    if (result.status === 'loaded')
+        return result.metadata;
+    if (result.status === 'unavailable' &&
+        result.problem.code === 'MARKETPLACE_MISSING') {
+        throw new Error(`marketplace.yaml not found: ${join(rootDirectory, MARKETPLACE_FILENAME)}`);
+    }
+    if (result.status === 'invalid' &&
+        result.compatibilityFailure === 'non-object') {
+        throw new Error('marketplace.yaml must contain an object');
+    }
+    if (result.status === 'invalid' &&
+        result.compatibilityFailure === 'invalid-name') {
+        throw new Error('marketplace.yaml field `name` must be a non-empty string');
+    }
+    const detail = result.problem.technicalDetail === undefined
+        ? result.problem.message
+        : `${result.problem.message}: ${result.problem.technicalDetail}`;
+    throw new Error(`${MARKETPLACE_FILENAME}: ${detail}`);
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/application/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../../src/application/marketplace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EACL,oBAAoB,GAErB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,oBAAoB,GAErB,MAAM,oCAAoC,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,aAAqB;IAC3D,MAAM,MAAM,GAAG,gCAAgC,CAAC,aAAa,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC;IACvD,IACE,MAAM,CAAC,MAAM,KAAK,aAAa;QAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,qBAAqB,EAC7C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,EAAE,CAC3E,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,MAAM,KAAK,SAAS;QAC3B,MAAM,CAAC,oBAAoB,KAAK,YAAY,EAC5C,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,IACE,MAAM,CAAC,MAAM,KAAK,SAAS;QAC3B,MAAM,CAAC,oBAAoB,KAAK,cAAc,EAC9C,CAAC;QACD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,MAAM,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;QAC1C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO;QACxB,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;IACrE,MAAM,IAAI,KAAK,CAAC,GAAG,oBAAoB,KAAK,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/application/plugin-components-contract.d.ts

@@ -0,0 +1,135 @@
+import type { PluginHook, PluginLsp, PluginMcp, PluginSkill } from "../schema/plugin-yaml.js";
+import type { ComponentType } from "./plugin-scaffold.js";
+export type PluginComponentKind = ComponentType;
+export interface PluginComponentCollections {
+    readonly skill: readonly PluginSkill[];
+    readonly mcp: readonly PluginMcp[];
+    readonly hook: readonly PluginHook[];
+    readonly lsp: readonly PluginLsp[];
+}
+export type PluginComponentValue = PluginSkill | PluginMcp | PluginHook | PluginLsp;
+export type PluginComponentMutation = {
+    readonly operation: "add";
+    readonly kind: PluginComponentKind;
+    readonly value: PluginComponentValue;
+    readonly createScaffold: boolean;
+} | {
+    readonly operation: "edit";
+    readonly kind: PluginComponentKind;
+    readonly index: number;
+    readonly value: PluginComponentValue;
+} | {
+    readonly operation: "remove";
+    readonly kind: PluginComponentKind;
+    readonly index: number;
+};
+export interface PluginComponentIssue {
+    readonly id: string;
+    readonly severity: "blocking" | "attention";
+    readonly kind: PluginComponentKind;
+    readonly index?: number;
+    readonly field: string;
+    readonly title: string;
+    readonly message: string;
+    readonly impact: string;
+    readonly nextAction: string;
+    readonly technicalPath: string;
+}
+export interface PluginComponentPermissions {
+    readonly readable: boolean;
+    readonly writable: boolean;
+    readonly executable: boolean;
+}
+export type PluginComponentFileState = "present" | "missing" | "unsafe" | "wrong-type" | "unavailable" | "external-command";
+export interface PluginComponentFileFact {
+    readonly kind: PluginComponentKind;
+    readonly componentIndex: number;
+    readonly role: "skill-directory" | "skill-document" | "hook-script" | "command" | "argument" | "workspace-folder";
+    readonly configuredPath: string;
+    readonly state: PluginComponentFileState;
+    readonly objectType: "file" | "directory" | "other" | "unknown";
+    readonly permissions: PluginComponentPermissions;
+    readonly canReveal: boolean;
+    readonly canOpenExternally: boolean;
+    readonly message: string;
+}
+export interface PluginComponentImpactPreview {
+    readonly operation: PluginComponentMutation["operation"];
+    readonly kind: PluginComponentKind;
+    readonly title: string;
+    readonly summary: string;
+    readonly canonicalChanges: readonly string[];
+    readonly generatedResults: readonly string[];
+    readonly retainedUserFiles: readonly string[];
+    readonly scaffoldFiles: readonly string[];
+    readonly generatedAction: "none";
+}
+export interface PluginComponentPlan {
+    readonly workspaceCanonicalPath: string;
+    readonly pluginDirectoryName: string;
+    readonly expectedRevision: string;
+    readonly fingerprint: string;
+    readonly nextBytes: Buffer;
+    readonly createFiles: readonly {
+        readonly relativePath: string;
+        readonly bytes: Buffer;
+        readonly mode: number;
+    }[];
+    readonly impact: PluginComponentImpactPreview;
+}
+export interface PluginComponentTransactionFacts {
+    readonly canonical: "unchanged" | "committed" | "restored" | "uncertain";
+    readonly scaffolds: "none" | "committed" | "rolled-back" | "residual";
+    readonly cleanupComplete: boolean;
+}
+export type ReadPluginComponentsResult = {
+    readonly status: "loaded";
+    readonly canonicalName: string;
+    readonly revision: string;
+    readonly collections: PluginComponentCollections;
+    readonly issues: readonly PluginComponentIssue[];
+    readonly files: readonly PluginComponentFileFact[];
+} | {
+    readonly status: "invalid" | "unavailable";
+    readonly message: string;
+    readonly impact: string;
+    readonly nextAction: string;
+    readonly revision?: string;
+};
+export type PlanPluginComponentMutationResult = {
+    readonly status: "planned";
+    readonly plan: PluginComponentPlan;
+    readonly issues: readonly PluginComponentIssue[];
+} | {
+    readonly status: "conflict";
+    readonly currentRevision: string;
+    readonly message: string;
+} | {
+    readonly status: "invalid" | "unavailable";
+    readonly message: string;
+    readonly impact: string;
+    readonly nextAction: string;
+    readonly issues: readonly PluginComponentIssue[];
+};
+export type ExecutePluginComponentPlanResult = {
+    readonly status: "saved";
+    readonly revision: string;
+    readonly changedPaths: readonly string[];
+    readonly diskChanged: boolean;
+    readonly cleanupComplete: true;
+    readonly transaction: PluginComponentTransactionFacts;
+} | {
+    readonly status: "conflict";
+    readonly currentRevision: string;
+    readonly diskChanged: false;
+    readonly changedPaths: readonly [];
+    readonly cleanupComplete: true;
+    readonly transaction: PluginComponentTransactionFacts;
+} | {
+    readonly status: "busy" | "failed";
+    readonly message: string;
+    readonly diskChanged: boolean;
+    readonly changedPaths: readonly string[];
+    readonly cleanupComplete: boolean;
+    readonly transaction: PluginComponentTransactionFacts;
+};

package/dist/application/plugin-components-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-components-contract.js.map

package/dist/application/plugin-components-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-components-contract.js","sourceRoot":"","sources":["../../src/application/plugin-components-contract.ts"],"names":[],"mappings":""}

package/dist/application/plugin-components.d.ts

@@ -0,0 +1,17 @@
+import { type AtomicDocumentAndFilesCommitDependencies } from "../infrastructure/document-commit.js";
+import { type PluginDocumentReadDependencies } from "./plugin-document.js";
+import { type ExecutePluginComponentPlanResult, type PlanPluginComponentMutationResult, type PluginComponentMutation, type PluginComponentPlan, type ReadPluginComponentsResult } from "./plugin-components-contract.js";
+export interface PluginComponentsRequest {
+    readonly directory: string;
+    readonly pluginDirectoryName: string;
+}
+export interface PlanPluginComponentMutationRequest extends PluginComponentsRequest {
+    readonly expectedRevision: string;
+    readonly mutation: PluginComponentMutation;
+}
+export interface PluginComponentDependencies extends PluginDocumentReadDependencies {
+    readonly commitDependencies?: AtomicDocumentAndFilesCommitDependencies;
+}
+export declare function readPluginComponents(request: PluginComponentsRequest, dependencies?: PluginDocumentReadDependencies): ReadPluginComponentsResult;
+export declare function planPluginComponentMutation(request: PlanPluginComponentMutationRequest, dependencies?: PluginDocumentReadDependencies): PlanPluginComponentMutationResult;
+export declare function executePluginComponentPlan(plan: PluginComponentPlan, dependencies?: PluginComponentDependencies): ExecutePluginComponentPlanResult;