forgebadger 0.1.1 → 0.1.2

package/dist/gateway/src/services/skill-install-service.js

@@ -0,0 +1,346 @@
+import { randomUUID } from "node:crypto";
+import { CliSkillRevisionRepository } from "../db/repositories/cli-skill-revision-repository.js";
+import { ProjectRepository } from "../db/repositories/project-repository.js";
+import { ProjectSkillRepository } from "../db/repositories/project-skill-repository.js";
+import { SkillRepository, } from "../db/repositories/skill-repository.js";
+import { UserRepository } from "../db/repositories/user-repository.js";
+import { computeContentHash, parseSkillRemoteProvenance, } from "./github-skill-source.js";
+import { packageResourceManifest, parseSkillPackage, skillPackageHash, storedSkillFiles, validateSkillFiles, } from "./skill-package.js";
+import { resolveRegistryPackage, skillLocatorSchema, } from "./skill-registry-package.js";
+export class SkillLifecycleError extends Error {
+    status;
+    constructor(message, status = 409) {
+        super(message);
+        this.status = status;
+    }
+}
+const MAX_PREVIEWS = 32;
+export class SkillInstallService {
+    db;
+    options;
+    now;
+    pending = new Map();
+    inflight = new Set();
+    constructor(db, options = {}, now = Date.now) {
+        this.db = db;
+        this.options = options;
+        this.now = now;
+    }
+    async preview(userId, input) {
+        this.assertActive(userId);
+        this.prune();
+        if (this.inflight.has(userId) || this.inflight.size >= 8)
+            throw new SkillLifecycleError("Another Skill preview is running; retry shortly", 429);
+        this.inflight.add(userId);
+        try {
+            const skill = input.skillId
+                ? this.ownedSkill(userId, input.skillId)
+                : undefined;
+            if (input.revisionId && !skill)
+                throw new SkillLifecycleError("A Skill is required for rollback", 400);
+            const before = skill ? storedSkillFiles(skill) : [];
+            if (skill && !input.revisionId)
+                this.assertUnmodified(skill);
+            const operation = input.revisionId
+                ? "rollback"
+                : skill
+                    ? "update"
+                    : "install";
+            const resolved = input.revisionId && skill
+                ? this.revisionPackage(userId, skill, input.revisionId)
+                : await resolveRegistryPackage(skill
+                    ? this.locator(skill)
+                    : skillLocatorSchema.parse(input.locator), this.options);
+            this.assertActive(userId);
+            if (skill && resolved.package.name !== skill.name)
+                throw new SkillLifecycleError("Upstream renamed this Skill; install it separately");
+            const expiresAt = this.now() + 5 * 60_000;
+            const preview = {
+                ...resolved,
+                token: randomUUID(),
+                expiresAt: new Date(expiresAt).toISOString(),
+                operation,
+                ...(skill ? { skillId: skill.id } : {}),
+                changes: diffFiles(before, resolved.package.files),
+            };
+            for (const [token, item] of this.pending)
+                if (item.userId === userId)
+                    this.pending.delete(token);
+            while (this.pending.size >= MAX_PREVIEWS)
+                this.pending.delete(this.pending.keys().next().value);
+            this.pending.set(preview.token, {
+                userId,
+                preview,
+                expiresAt,
+                ...(skill ? { baseHash: this.baseHash(skill) } : {}),
+            });
+            return preview;
+        }
+        finally {
+            this.inflight.delete(userId);
+        }
+    }
+    consume(userId, token, options = {}) {
+        this.assertActive(userId);
+        this.prune();
+        const pending = this.pending.get(token);
+        if (!pending || pending.userId !== userId)
+            throw new SkillLifecycleError("Preview expired or unavailable; preview this Skill again");
+        const preview = pending.preview;
+        if (preview.skillId !== options.skillId ||
+            (options.operation && options.operation !== preview.operation))
+            throw new SkillLifecycleError("Preview does not match this operation");
+        const result = this.db.transaction(() => {
+            this.assertActive(userId);
+            const repo = new SkillRepository(this.db, userId);
+            const existing = preview.skillId
+                ? this.ownedSkill(userId, preview.skillId)
+                : undefined;
+            if (existing && this.baseHash(existing) !== pending.baseHash)
+                throw new SkillLifecycleError("Skill changed after preview; review it again");
+            if (!existing && repo.getByName(preview.package.name))
+                throw new SkillLifecycleError("A Skill with this name already exists");
+            if (options.projectId &&
+                !new ProjectRepository(this.db, userId).getById(options.projectId))
+                throw new SkillLifecycleError("Project not found", 404);
+            const revisions = new CliSkillRevisionRepository(this.db, userId);
+            if (existing && !revisions.list(existing.id).length)
+                revisions.create(existing.id, "legacy", this.snapshot(existing), skillPackageHash(storedSkillFiles(existing)));
+            const pkg = preview.package;
+            const main = pkg.files.find((file) => file.path === "SKILL.md").content;
+            const provenance = this.provenance(preview, existing);
+            const data = {
+                name: pkg.name,
+                description: pkg.description,
+                version: pkg.version,
+                content: main,
+                resourceManifest: packageResourceManifest(pkg, preview.canonicalId),
+                remoteProvenance: JSON.stringify(provenance),
+                source: `${preview.locator.kind}:${preview.canonicalId.replace(/^[^:]+:/u, "")}`,
+            };
+            const skill = existing
+                ? repo.update(existing.id, data)
+                : repo.create({ ...data, isEnabled: false });
+            revisions.create(skill.id, preview.operation, this.snapshot(skill), pkg.packageHash);
+            if (options.projectId)
+                new ProjectSkillRepository(this.db, userId).setSkill(options.projectId, skill.id, true);
+            return {
+                skill,
+                ...(options.projectId ? { projectId: options.projectId } : {}),
+            };
+        })();
+        this.pending.delete(token);
+        return result;
+    }
+    async checkUpdate(userId, skillId) {
+        if (this.inflight.has(userId) || this.inflight.size >= 8)
+            throw new SkillLifecycleError("Another Skill request is running; retry shortly", 429);
+        this.inflight.add(userId);
+        try {
+            return await this.checkUpdatePackage(userId, skillId);
+        }
+        finally {
+            this.inflight.delete(userId);
+        }
+    }
+    async checkUpdatePackage(userId, skillId) {
+        this.assertActive(userId);
+        const skill = this.ownedSkill(userId, skillId);
+        const provenance = parseSkillRemoteProvenance(skill.remoteProvenance);
+        const resolved = await resolveRegistryPackage(this.locator(skill), this.options);
+        this.assertActive(userId);
+        const current = this.ownedSkill(userId, skillId);
+        if (this.baseHash(current) !== this.baseHash(skill))
+            throw new SkillLifecycleError("Skill changed while checking updates");
+        const updateAvailable = resolved.package.packageHash !==
+            (provenance.packageHash ?? skillPackageHash(storedSkillFiles(skill)));
+        const checkedAt = new Date(this.now()).toISOString();
+        new SkillRepository(this.db, userId).update(skill.id, {
+            remoteProvenance: JSON.stringify({
+                ...provenance,
+                lastCheck: {
+                    checkedAt,
+                    latestCommitSha: resolved.revision,
+                    updateAvailable,
+                },
+            }),
+        });
+        return {
+            skillId: skill.id,
+            name: skill.name,
+            kind: provenance.kind,
+            currentSha: provenance.resolvedCommitSha,
+            latestSha: resolved.revision,
+            updateAvailable,
+            checkedAt,
+        };
+    }
+    history(userId, skillId) {
+        this.ownedSkill(userId, skillId);
+        return new CliSkillRevisionRepository(this.db, userId)
+            .list(skillId)
+            .map(({ snapshotJson, ...revision }) => revision);
+    }
+    assertActive(userId) {
+        if (new UserRepository(this.db).findById(userId)?.status !== "active")
+            throw new SkillLifecycleError("Skill owner is inactive", 403);
+    }
+    ownedSkill(userId, id) {
+        const skill = new SkillRepository(this.db, userId).getOwnedById(id);
+        if (!skill)
+            throw new SkillLifecycleError("Skill not found", 404);
+        return skill;
+    }
+    locator(skill) {
+        const provenance = parseSkillRemoteProvenance(skill.remoteProvenance);
+        if (!provenance)
+            throw new SkillLifecycleError("This Skill has no remote origin", 400);
+        if (provenance.locator)
+            return skillLocatorSchema.parse(provenance.locator);
+        if (provenance.kind !== "github" && provenance.kind !== "marketplace")
+            throw new SkillLifecycleError("Remote origin is unsupported", 400);
+        return {
+            kind: "github",
+            repo: provenance.repo,
+            path: provenance.path,
+            ...(provenance.ref ? { ref: provenance.ref } : {}),
+        };
+    }
+    assertUnmodified(skill) {
+        const origin = parseSkillRemoteProvenance(skill.remoteProvenance);
+        if (!origin)
+            return;
+        const changed = origin.packageHash
+            ? origin.packageHash !== skillPackageHash(storedSkillFiles(skill))
+            : origin.contentHash !== computeContentHash(skill.content);
+        if (changed)
+            throw new SkillLifecycleError("Local edits detected; save a separate Skill or restore a retained revision before updating");
+    }
+    baseHash(skill) {
+        const origin = parseSkillRemoteProvenance(skill.remoteProvenance);
+        return computeContentHash(JSON.stringify([
+            skill.name,
+            skill.description,
+            skill.version,
+            skill.source,
+            skill.content,
+            skill.resourceManifest,
+            origin?.resolvedCommitSha,
+            origin?.packageHash,
+        ]));
+    }
+    snapshot(skill) {
+        let metadataMode = "standard";
+        try {
+            parseSkillPackage(storedSkillFiles(skill));
+        }
+        catch {
+            metadataMode = "legacy";
+        }
+        return {
+            metadataMode,
+            name: skill.name,
+            description: skill.description,
+            version: skill.version,
+            content: skill.content,
+            resourceManifest: skill.resourceManifest,
+            remoteProvenance: skill.remoteProvenance,
+        };
+    }
+    revisionPackage(userId, skill, revisionId) {
+        const revision = new CliSkillRevisionRepository(this.db, userId).get(skill.id, revisionId);
+        if (!revision)
+            throw new SkillLifecycleError("Revision not found", 404);
+        const snapshot = JSON.parse(revision.snapshotJson);
+        const origin = parseSkillRemoteProvenance(snapshot.remoteProvenance);
+        if (!origin)
+            throw new SkillLifecycleError("Revision has no remote origin", 400);
+        const files = validateSkillFiles(storedSkillFiles(snapshot));
+        // Historical installs permitted plain Markdown. Restore its exact bytes and stored metadata.
+        const pkg = snapshot.metadataMode === "legacy"
+            ? {
+                name: snapshot.name,
+                description: snapshot.description ?? "",
+                version: snapshot.version ?? "1.0.0",
+                warnings: ["legacy-metadata"],
+                files,
+                packageHash: skillPackageHash(files),
+                sizeBytes: files.reduce((sum, file) => sum + Buffer.byteLength(file.content), 0),
+            }
+            : parseSkillPackage(files);
+        if (pkg.packageHash !== revision.packageHash)
+            throw new SkillLifecycleError("Revision integrity check failed");
+        const locator = origin.locator ?? {
+            kind: "github",
+            repo: origin.repo,
+            path: origin.path,
+            ...(origin.ref ? { ref: origin.ref } : {}),
+        };
+        return {
+            package: pkg,
+            locator,
+            revision: origin.resolvedCommitSha,
+            canonicalId: origin.canonicalId ?? `github:${origin.repo}/${origin.path}`,
+            sourceUrl: origin.sourceUrl ?? `https://github.com/${origin.repo}`,
+        };
+    }
+    provenance(preview, existing) {
+        const old = parseSkillRemoteProvenance(existing?.remoteProvenance);
+        return {
+            kind: preview.locator.kind,
+            repo: preview.locator.kind === "github" ? preview.locator.repo : "",
+            path: preview.locator.kind === "github"
+                ? (preview.locator.path ?? "SKILL.md")
+                : "SKILL.md",
+            ...(preview.locator.kind === "github" && preview.locator.ref
+                ? { ref: preview.locator.ref }
+                : {}),
+            resolvedCommitSha: preview.revision,
+            contentHash: computeContentHash(preview.package.files.find((file) => file.path === "SKILL.md").content),
+            packageHash: preview.package.packageHash,
+            installedAt: old?.installedAt ?? new Date(this.now()).toISOString(),
+            storage: "database",
+            legacyGlobalMirror: old
+                ? old.legacyGlobalMirror === true || old.storage !== "database"
+                : false,
+            locator: preview.locator,
+            canonicalId: preview.canonicalId,
+            sourceUrl: preview.sourceUrl,
+        };
+    }
+    prune() {
+        for (const [token, item] of this.pending)
+            if (item.expiresAt <= this.now())
+                this.pending.delete(token);
+    }
+}
+export function diffFiles(before, after) {
+    const a = new Map(before.map((file) => [file.path, file.content]));
+    const b = new Map(after.map((file) => [file.path, file.content]));
+    return [...new Set([...a.keys(), ...b.keys()])]
+        .sort()
+        .flatMap((path) => a.get(path) === b.get(path)
+        ? []
+        : [
+            {
+                path,
+                kind: !a.has(path)
+                    ? "added"
+                    : !b.has(path)
+                        ? "removed"
+                        : "modified",
+                before: a.get(path),
+                after: b.get(path),
+            },
+        ]);
+}
+const services = new WeakMap();
+export function skillInstallService(db, options = {}) {
+    let service = services.get(db);
+    if (!service) {
+        service = new SkillInstallService(db, options);
+        services.set(db, service);
+    }
+    return service;
+}
+//# sourceMappingURL=skill-install-service.js.map

package/dist/gateway/src/services/skill-install-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-install-service.js","sourceRoot":"","sources":["../../../src/services/skill-install-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AACxF,OAAO,EACL,eAAe,GAEhB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEvE,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAG3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,kBAAkB,GAGnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAGjC;IAFX,YACE,OAAe,EACN,SAAS,GAAG;QAErB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,WAAM,GAAN,MAAM,CAAM;IAGvB,CAAC;CACF;AAoBD,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB,MAAM,OAAO,mBAAmB;IAIX;IACA;IACA;IALF,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9C,YACmB,EAAY,EACZ,UAAgC,EAAE,EAClC,MAAoB,IAAI,CAAC,GAAG;QAF5B,OAAE,GAAF,EAAE,CAAU;QACZ,YAAO,GAAP,OAAO,CAA2B;QAClC,QAAG,GAAH,GAAG,CAAyB;IAC5C,CAAC;IAEJ,KAAK,CAAC,OAAO,CACX,MAAc,EACd,KAIC;QAED,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;YACtD,MAAM,IAAI,mBAAmB,CAC3B,iDAAiD,EACjD,GAAG,CACJ,CAAC;QACJ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO;gBACzB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;gBACxC,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK;gBAC5B,MAAM,IAAI,mBAAmB,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,UAAU;gBAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU;gBAChC,CAAC,CAAC,UAAU;gBACZ,CAAC,CAAC,KAAK;oBACL,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,SAAS,CAAC;YAChB,MAAM,QAAQ,GACZ,KAAK,CAAC,UAAU,IAAI,KAAK;gBACvB,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC;gBACvD,CAAC,CAAC,MAAM,sBAAsB,CAC1B,KAAK;oBACH,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;oBACrB,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAC3C,IAAI,CAAC,OAAO,CACb,CAAC;YACR,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI;gBAC/C,MAAM,IAAI,mBAAmB,CAC3B,oDAAoD,CACrD,CAAC;YACJ,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;YAC1C,MAAM,OAAO,GAAwB;gBACnC,GAAG,QAAQ;gBACX,KAAK,EAAE,UAAU,EAAE;gBACnB,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;gBAC5C,SAAS;gBACT,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvC,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;aACnD,CAAC;YACF,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;gBACtC,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,YAAY;gBACtC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAC;YACzD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE;gBAC9B,MAAM;gBACN,OAAO;gBACP,SAAS;gBACT,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,CACL,MAAc,EACd,KAAa,EACb,UAII,EAAE;QAEN,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YACvC,MAAM,IAAI,mBAAmB,CAC3B,0DAA0D,CAC3D,CAAC;QACJ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IACE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO;YACnC,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CAAC;YAE9D,MAAM,IAAI,mBAAmB,CAAC,uCAAuC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO;gBAC9B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;gBAC1C,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ;gBAC1D,MAAM,IAAI,mBAAmB,CAC3B,8CAA8C,CAC/C,CAAC;YACJ,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;gBACnD,MAAM,IAAI,mBAAmB,CAAC,uCAAuC,CAAC,CAAC;YACzE,IACE,OAAO,CAAC,SAAS;gBACjB,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;gBAElE,MAAM,IAAI,mBAAmB,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClE,IAAI,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM;gBACjD,SAAS,CAAC,MAAM,CACd,QAAQ,CAAC,EAAE,EACX,QAAQ,EACR,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACvB,gBAAgB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAC7C,CAAC;YACJ,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;YAC5B,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAE,CAAC,OAAO,CAAC;YACzE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG;gBACX,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,OAAO,EAAE,IAAI;gBACb,gBAAgB,EAAE,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,CAAC;gBACnE,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;gBAC5C,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE;aACjF,CAAC;YACF,MAAM,KAAK,GAAG,QAAQ;gBACpB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAE;gBACjC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,SAAS,CAAC,MAAM,CACd,KAAK,CAAC,EAAE,EACR,OAAO,CAAC,SAAS,EACjB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EACpB,GAAG,CAAC,WAAW,CAChB,CAAC;YACF,IAAI,OAAO,CAAC,SAAS;gBACnB,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,QAAQ,CAClD,OAAO,CAAC,SAAS,EACjB,KAAK,CAAC,EAAE,EACR,IAAI,CACL,CAAC;YACJ,OAAO;gBACL,KAAK;gBACL,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;QACL,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,OAAe;QAC/C,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;YACtD,MAAM,IAAI,mBAAmB,CAC3B,iDAAiD,EACjD,GAAG,CACJ,CAAC;QACJ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,MAAc,EAAE,OAAe;QAC9D,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAC3C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EACnB,IAAI,CAAC,OAAO,CACb,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjD,MAAM,IAAI,mBAAmB,CAAC,sCAAsC,CAAC,CAAC;QACxE,MAAM,eAAe,GACnB,QAAQ,CAAC,OAAO,CAAC,WAAW;YAC5B,CAAC,UAAU,CAAC,WAAW,IAAI,gBAAgB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACrD,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE;YACpD,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC;gBAC/B,GAAG,UAAU;gBACb,SAAS,EAAE;oBACT,SAAS;oBACT,eAAe,EAAE,QAAQ,CAAC,QAAQ;oBAClC,eAAe;iBAChB;aACF,CAAC;SACH,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,UAAU,EAAE,UAAU,CAAC,iBAAiB;YACxC,SAAS,EAAE,QAAQ,CAAC,QAAQ;YAC5B,eAAe;YACf,SAAS;SACV,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,OAAe;QACrC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC;aACnD,IAAI,CAAC,OAAO,CAAC;aACb,GAAG,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IACO,YAAY,CAAC,MAAc;QACjC,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,QAAQ;YACnE,MAAM,IAAI,mBAAmB,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IACO,UAAU,CAAC,MAAc,EAAE,EAAU;QAC3C,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,mBAAmB,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IACO,OAAO,CAAC,KAAY;QAC1B,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtE,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;QACxE,IAAI,UAAU,CAAC,OAAO;YAAE,OAAO,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC5E,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,KAAK,aAAa;YACnE,MAAM,IAAI,mBAAmB,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACrE,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC;IACO,gBAAgB,CAAC,KAAY;QACnC,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW;YAChC,CAAC,CAAC,MAAM,CAAC,WAAW,KAAK,gBAAgB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAClE,CAAC,CAAC,MAAM,CAAC,WAAW,KAAK,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7D,IAAI,OAAO;YACT,MAAM,IAAI,mBAAmB,CAC3B,4FAA4F,CAC7F,CAAC;IACN,CAAC;IACO,QAAQ,CAAC,KAAY;QAC3B,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAClE,OAAO,kBAAkB,CACvB,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,CAAC,IAAI;YACV,KAAK,CAAC,WAAW;YACjB,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,MAAM;YACZ,KAAK,CAAC,OAAO;YACb,KAAK,CAAC,gBAAgB;YACtB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,WAAW;SACpB,CAAC,CACH,CAAC;IACJ,CAAC;IACO,QAAQ,CAAC,KAAY;QAC3B,IAAI,YAAY,GAA0B,UAAU,CAAC;QACrD,IAAI,CAAC;YACH,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,YAAY,GAAG,QAAQ,CAAC;QAC1B,CAAC;QACD,OAAO;YACL,YAAY;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;YACxC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;SACzC,CAAC;IACJ,CAAC;IACO,eAAe,CACrB,MAAc,EACd,KAAY,EACZ,UAAkB;QAElB,MAAM,QAAQ,GAAG,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,GAAG,CAClE,KAAK,CAAC,EAAE,EACR,UAAU,CACX,CAAC;QACF,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,mBAAmB,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,YAAY,CAQL,CAAC;QAC7C,MAAM,MAAM,GAAG,0BAA0B,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;QACrE,IAAI,CAAC,MAAM;YACT,MAAM,IAAI,mBAAmB,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,kBAAkB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7D,6FAA6F;QAC7F,MAAM,GAAG,GACP,QAAQ,CAAC,YAAY,KAAK,QAAQ;YAChC,CAAC,CAAC;gBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;gBACvC,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,OAAO;gBACpC,QAAQ,EAAE,CAAC,iBAAiB,CAAC;gBAC7B,KAAK;gBACL,WAAW,EAAE,gBAAgB,CAAC,KAAK,CAAC;gBACpC,SAAS,EAAE,KAAK,CAAC,MAAM,CACrB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EACpD,CAAC,CACF;aACF;YACH,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;YAC1C,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI;YAChC,IAAI,EAAE,QAAiB;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3C,CAAC;QACF,OAAO;YACL,OAAO,EAAE,GAAG;YACZ,OAAO;YACP,QAAQ,EAAE,MAAM,CAAC,iBAAiB;YAClC,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,UAAU,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE;YACzE,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,sBAAsB,MAAM,CAAC,IAAI,EAAE;SACnE,CAAC;IACJ,CAAC;IACO,UAAU,CAChB,OAA4B,EAC5B,QAAgB;QAEhB,MAAM,GAAG,GAAG,0BAA0B,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;QACnE,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;YAC1B,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACnE,IAAI,EACF,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAC/B,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;gBACtC,CAAC,CAAC,UAAU;YAChB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG;gBAC1D,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC9B,CAAC,CAAC,EAAE,CAAC;YACP,iBAAiB,EAAE,OAAO,CAAC,QAAQ;YACnC,WAAW,EAAE,kBAAkB,CAC7B,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAE,CAAC,OAAO,CACxE;YACD,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;YACxC,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;YACnE,OAAO,EAAE,UAAU;YACnB,kBAAkB,EAAE,GAAG;gBACrB,CAAC,CAAC,GAAG,CAAC,kBAAkB,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU;gBAC/D,CAAC,CAAC,KAAK;YACT,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;IACJ,CAAC;IACO,KAAK;QACX,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;YACtC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CACvB,MAA0B,EAC1B,KAAyB;IAEzB,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SAC5C,IAAI,EAAE;SACN,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAChB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QACzB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC;YACE;gBACE,IAAI;gBACJ,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;oBAChB,CAAC,CAAE,OAAiB;oBACpB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;wBACZ,CAAC,CAAE,SAAmB;wBACtB,CAAC,CAAE,UAAoB;gBAC3B,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;gBACnB,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;aACnB;SACF,CACN,CAAC;AACN,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAiC,CAAC;AAC9D,MAAM,UAAU,mBAAmB,CACjC,EAAY,EACZ,UAAgC,EAAE;IAElC,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,mBAAmB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/gateway/src/services/skill-marketplaces.d.ts

@@ -0,0 +1,59 @@
+import { type CatalogItem, type CatalogSource } from "../db/repositories/catalog-repository.js";
+import type { Database } from "../db/types.js";
+import { type GitHubRequestOptions } from "./github-skill-source.js";
+/**
+ * Claude Code plugin marketplace (`.claude-plugin/marketplace.json`) support.
+ * A GitHub repo either publishes a marketplace manifest (plugins array) or is
+ * treated as a plain Skill repository whose SKILL.md files become catalog
+ * items. Items carry `marketplace` metadata instead of inline content; install
+ * re-fetches the SKILL.md from the pinned commit SHA on demand.
+ *
+ * Plugins with a relative string `source` may declare a `skills` array of
+ * skill directories (the format used by anthropics/skills, where every
+ * plugin points at the repo root with `source: "./"`); each entry expands
+ * into its own catalog item.
+ */
+export declare const MARKETPLACE_SEEDS: readonly ["anthropics/skills", "vercel-labs/agent-skills", "openai/skills"];
+export interface MarketplacePluginOrigin {
+    /** GitHub repo that hosts the plugin content. */
+    repo: string;
+    ref?: string | undefined;
+    sha?: string | undefined;
+    /** Directory inside the repo that holds the plugin (and its SKILL.md). */
+    path?: string | undefined;
+}
+export interface NormalizedMarketplacePlugin {
+    /** Display name of the catalog item (skill basename for expanded entries). */
+    name: string;
+    description?: string | undefined;
+    version?: string | undefined;
+    /** Original plugin name in the manifest (differs from `name` when expanded). */
+    pluginName?: string | undefined;
+    /** Stable dedupe key; defaults to the item name. */
+    externalId?: string | undefined;
+    origin: MarketplacePluginOrigin;
+}
+export interface SkippedMarketplacePlugin {
+    name: string;
+    reason: string;
+}
+export interface ParseMarketplaceResult {
+    marketplaceName: string;
+    plugins: NormalizedMarketplacePlugin[];
+    skipped: SkippedMarketplacePlugin[];
+}
+export interface RefreshGitHubMarketplaceInput extends GitHubRequestOptions {
+    db: Database;
+    userId: string;
+    repo: string;
+    label?: string | undefined;
+}
+export interface RefreshGitHubMarketplaceResult {
+    source: CatalogSource;
+    items: CatalogItem[];
+    skipped: SkippedMarketplacePlugin[];
+    sha: string;
+    marketplaceName?: string | undefined;
+}
+export declare function parseMarketplaceManifest(json: unknown, hostRepo: string): ParseMarketplaceResult;
+export declare function refreshGitHubMarketplace(input: RefreshGitHubMarketplaceInput): Promise<RefreshGitHubMarketplaceResult>;