codex-marketplace 0.1.0

package/dist/manifest.js

@@ -0,0 +1,146 @@
+import path from "node:path";
+import { readFile, stat } from "node:fs/promises";
+import { marketplaceConfigSchema, pluginManifestSchema } from "./schema.js";
+import { isSubpath } from "./utils.js";
+const ALLOWED_CATEGORIES = new Set([
+    "Coding",
+    "Development",
+    "Design",
+    "Productivity",
+    "Communication",
+    "DevOps",
+    "Data",
+    "Finance",
+    "Writing",
+    "AI & Agents",
+    "Utilities",
+]);
+async function fileExists(targetPath) {
+    try {
+        await stat(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function loadPluginManifest(pluginRoot) {
+    const manifestPath = path.join(pluginRoot, ".codex-plugin", "plugin.json");
+    if (!(await fileExists(manifestPath))) {
+        throw new Error(`Missing plugin manifest at ${manifestPath}`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(manifestPath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Failed to parse plugin manifest at ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return pluginManifestSchema.parse(raw);
+}
+function normalizeCategory(category) {
+    if (!category)
+        return undefined;
+    if (ALLOWED_CATEGORIES.has(category)) {
+        return category;
+    }
+    return undefined;
+}
+function inferCategory(manifest) {
+    const direct = normalizeCategory(manifest.interface?.category);
+    if (direct) {
+        return direct;
+    }
+    const keywords = [
+        manifest.name,
+        manifest.description,
+        ...(manifest.keywords ?? []),
+    ]
+        .join(" ")
+        .toLowerCase();
+    if (/(figma|design|canva)/.test(keywords))
+        return "Design";
+    if (/(github|git|review|lint|test|deploy|vercel|cloudflare|ios|android|web)/.test(keywords)) {
+        return "Coding";
+    }
+    if (/(linear|notion|calendar|drive|teams|slack|gmail|outlook|sharepoint|box)/.test(keywords)) {
+        return "Productivity";
+    }
+    if (/(data|analytics|model|hugging|dataset)/.test(keywords))
+        return "Data";
+    if (/(agent|ai|workflow|orchestr)/.test(keywords))
+        return "AI & Agents";
+    return "Utilities";
+}
+function defaultPolicy() {
+    return {
+        installation: "AVAILABLE",
+        authentication: "ON_INSTALL",
+    };
+}
+async function loadMarketplaceConfig(checkoutRoot) {
+    const marketplacePath = path.join(checkoutRoot, ".agents", "plugins", "marketplace.json");
+    if (!(await fileExists(marketplacePath))) {
+        return null;
+    }
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(marketplacePath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Failed to parse marketplace file at ${marketplacePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return marketplaceConfigSchema.parse(raw);
+}
+function resolveMarketplacePluginPath(checkoutRoot, relativePath) {
+    const resolved = path.resolve(checkoutRoot, relativePath);
+    if (!isSubpath(checkoutRoot, resolved)) {
+        throw new Error(`Marketplace entry points outside the repository: ${relativePath}`);
+    }
+    return resolved;
+}
+export async function discoverPluginSources(checkoutRoot, pluginName) {
+    const marketplace = await loadMarketplaceConfig(checkoutRoot);
+    if (marketplace) {
+        const pluginEntries = pluginName
+            ? marketplace.plugins.filter((plugin) => plugin.name === pluginName)
+            : marketplace.plugins;
+        if (pluginName && pluginEntries.length === 0) {
+            throw new Error(`Marketplace repository does not expose a plugin named ${pluginName}.`);
+        }
+        const discovered = [];
+        for (const plugin of pluginEntries) {
+            if (plugin.source.source !== "local") {
+                throw new Error(`Unsupported marketplace source for ${plugin.name}. Only local sources are supported.`);
+            }
+            const sourcePath = resolveMarketplacePluginPath(checkoutRoot, plugin.source.path);
+            const manifest = await loadPluginManifest(sourcePath);
+            if (manifest.name !== plugin.name) {
+                throw new Error(`Marketplace entry ${plugin.name} points to a plugin manifest named ${manifest.name}.`);
+            }
+            discovered.push({
+                manifest,
+                sourcePath,
+                category: normalizeCategory(plugin.category) ?? inferCategory(manifest),
+                policy: plugin.policy ?? defaultPolicy(),
+            });
+        }
+        if (discovered.length === 0) {
+            throw new Error("Marketplace repository does not contain any installable plugins.");
+        }
+        return discovered;
+    }
+    const manifest = await loadPluginManifest(checkoutRoot);
+    if (pluginName && manifest.name !== pluginName) {
+        throw new Error(`Repository root plugin is named ${manifest.name}, not ${pluginName}.`);
+    }
+    return [
+        {
+            manifest,
+            sourcePath: checkoutRoot,
+            category: inferCategory(manifest),
+            policy: defaultPolicy(),
+        },
+    ];
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/marketplace.d.ts

@@ -0,0 +1,6 @@
+import { InstallScope, MarketplaceConfig, MarketplacePlugin, MutableMarketplace, ScopeLayout } from "./types.js";
+export declare function resolveScopeLayout(scope: InstallScope, cwd: string, homeDir: string): ScopeLayout;
+export declare function loadMarketplace(layout: ScopeLayout): Promise<MutableMarketplace>;
+export declare function upsertMarketplacePlugin(config: MarketplaceConfig, pluginName: string, sourcePath: string, marketplaceRoot: string, category?: string, policy?: MarketplacePlugin["policy"]): MarketplaceConfig;
+export declare function writeMarketplace(layout: ScopeLayout, config: MarketplaceConfig): Promise<void>;
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../src/marketplace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAqBjH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAsBjG;AAYD,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAyBtF;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GACnC,iBAAiB,CAuBnB;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpG"}

package/dist/marketplace.js

@@ -0,0 +1,100 @@
+import path from "node:path";
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { marketplaceConfigSchema } from "./schema.js";
+import { relativePathForMarketplace, sanitizeSegment, stableHash } from "./utils.js";
+async function fileExists(targetPath) {
+    try {
+        await stat(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function validateMarketplaceName(name) {
+    if (!/^[A-Za-z0-9_-]+$/.test(name)) {
+        throw new Error(`Marketplace name \`${name}\` is invalid. Only ASCII letters, digits, \`_\`, and \`-\` are allowed.`);
+    }
+    return name;
+}
+export function resolveScopeLayout(scope, cwd, homeDir) {
+    if (scope === "global") {
+        return {
+            scope,
+            marketplaceRoot: homeDir,
+            marketplacePath: path.join(homeDir, ".agents", "plugins", "marketplace.json"),
+            pluginSourceRoot: path.join(homeDir, ".codex", "plugins"),
+            defaultMarketplaceName: "codex-marketplace-global",
+            defaultMarketplaceDisplayName: "Codex Plugins (Global)",
+        };
+    }
+    const projectName = sanitizeSegment(path.basename(cwd), "project");
+    const projectHash = stableHash(path.resolve(cwd));
+    return {
+        scope,
+        marketplaceRoot: cwd,
+        marketplacePath: path.join(cwd, ".agents", "plugins", "marketplace.json"),
+        pluginSourceRoot: path.join(cwd, "plugins"),
+        defaultMarketplaceName: `codex-marketplace-${projectName}-${projectHash}`,
+        defaultMarketplaceDisplayName: `Codex Plugins (${path.basename(cwd) || "Project"})`,
+    };
+}
+function createDefaultMarketplace(layout) {
+    return {
+        name: layout.defaultMarketplaceName,
+        interface: {
+            displayName: layout.defaultMarketplaceDisplayName,
+        },
+        plugins: [],
+    };
+}
+export async function loadMarketplace(layout) {
+    if (!(await fileExists(layout.marketplacePath))) {
+        return {
+            config: createDefaultMarketplace(layout),
+            existed: false,
+        };
+    }
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(layout.marketplacePath, "utf8"));
+    }
+    catch (error) {
+        throw new Error(`Failed to parse marketplace file at ${layout.marketplacePath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const config = marketplaceConfigSchema.parse(raw);
+    validateMarketplaceName(config.name);
+    return {
+        config,
+        existed: true,
+    };
+}
+export function upsertMarketplacePlugin(config, pluginName, sourcePath, marketplaceRoot, category, policy) {
+    const entry = {
+        name: pluginName,
+        source: {
+            source: "local",
+            path: relativePathForMarketplace(marketplaceRoot, sourcePath),
+        },
+        policy,
+        category,
+    };
+    const existingIndex = config.plugins.findIndex((plugin) => plugin.name === pluginName);
+    const plugins = [...config.plugins];
+    if (existingIndex >= 0) {
+        plugins.splice(existingIndex, 1, entry);
+    }
+    else {
+        plugins.push(entry);
+    }
+    return {
+        ...config,
+        plugins,
+    };
+}
+export async function writeMarketplace(layout, config) {
+    validateMarketplaceName(config.name);
+    await mkdir(path.dirname(layout.marketplacePath), { recursive: true });
+    await writeFile(layout.marketplacePath, JSON.stringify(config, null, 2) + "\n", "utf8");
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/marketplace.js.map

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

package/dist/repository.d.ts

@@ -0,0 +1,3 @@
+import { GitHubRepoSpec } from "./types.js";
+export declare function parseRepositoryInput(input: string): GitHubRepoSpec;
+//# sourceMappingURL=repository.d.ts.map

package/dist/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI5C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CA8ClE"}

package/dist/repository.js

@@ -0,0 +1,44 @@
+const REPO_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+export function parseRepositoryInput(input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("Repository is required. Use `owner/repo` or a GitHub repository URL.");
+    }
+    if (REPO_PATTERN.test(trimmed)) {
+        const [owner, repo] = trimmed.split("/");
+        return {
+            owner,
+            repo,
+            fullName: `${owner}/${repo}`,
+            url: `https://github.com/${owner}/${repo}`,
+        };
+    }
+    try {
+        const url = new URL(trimmed);
+        if (url.hostname !== "github.com") {
+            throw new Error("Only github.com repositories are supported.");
+        }
+        const parts = url.pathname.replace(/\/+$/, "").split("/").filter(Boolean);
+        if (parts.length !== 2) {
+            throw new Error("GitHub repository URLs must look like https://github.com/owner/repo.");
+        }
+        const [owner, rawRepo] = parts;
+        const repo = rawRepo.endsWith(".git") ? rawRepo.slice(0, -4) : rawRepo;
+        if (!REPO_PATTERN.test(`${owner}/${repo}`)) {
+            throw new Error("Repository must look like `owner/repo`.");
+        }
+        return {
+            owner,
+            repo,
+            fullName: `${owner}/${repo}`,
+            url: `https://github.com/${owner}/${repo}`,
+        };
+    }
+    catch (error) {
+        if (error instanceof TypeError) {
+            throw new Error("Repository must look like `owner/repo` or a GitHub URL.");
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAG,oCAAoC,CAAC;AAE1D,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO;YACL,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;YAC5B,GAAG,EAAE,sBAAsB,KAAK,IAAI,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QAED,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACvE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO;YACL,KAAK;YACL,IAAI;YACJ,QAAQ,EAAE,GAAG,KAAK,IAAI,IAAI,EAAE;YAC5B,GAAG,EAAE,sBAAsB,KAAK,IAAI,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}