@reeledge/agent-tools 0.1.6 → 0.1.7

package/dist/apps/codex-plugin.js

@@ -0,0 +1,152 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { writeSkillTree } from '../skills.js';
+import { CONNECTOR_NAME } from './types.js';
+/**
+ * Self-contained local Codex **app-UI plugin** built from the fetched skills and
+ * registered in the user's personal marketplace, so the Reel Edge skills surface
+ * in the Codex / ChatGPT app plugins panel (in addition to the loose
+ * `~/.codex/skills/` CLI skills + the `[mcp_servers.reel-edge]` connector the
+ * codex adapter already writes).
+ *
+ * The plugin is fully self-contained — no remote source. The exact shapes here
+ * were validated against Codex's own plugin validator and installed successfully
+ * in the app:
+ *   - `<homeDir>/plugins/reel-edge/.codex-plugin/plugin.json` (manifest + app-UI `interface`)
+ *   - `<homeDir>/plugins/reel-edge/skills/<slug>/…` (the fetched skill trees)
+ *   - `<homeDir>/.agents/plugins/marketplace.json` (a personal marketplace whose
+ *     `source.path` is the home-relative `./plugins/reel-edge`).
+ *
+ * The marketplace `source` stays the LITERAL home-relative `./plugins/reel-edge`
+ * — Codex resolves it relative to the agents home, so it must NOT be absolutised.
+ */
+/** Plugin `name` (also the marketplace entry name + skills namespace). */
+export const CODEX_PLUGIN_NAME = CONNECTOR_NAME;
+/** Plugin `version` — bump to push skill-content updates to installed users. */
+export const CODEX_PLUGIN_VERSION = '0.1.0';
+/** Absolute plugin directory: `<homeDir>/plugins/reel-edge`. */
+export function codexPluginDir(env) {
+    return path.join(env.homeDir, 'plugins', CODEX_PLUGIN_NAME);
+}
+/** Absolute personal-marketplace path: `<homeDir>/.agents/plugins/marketplace.json`. */
+export function codexMarketplacePath(env) {
+    return path.join(env.homeDir, '.agents', 'plugins', 'marketplace.json');
+}
+/**
+ * `.codex-plugin/plugin.json` body — the exact shape Codex's plugin validator
+ * accepts. `skills: "./skills/"` points at the skill trees; `interface` drives
+ * the app plugins-panel card. Pretty-printed with a trailing newline.
+ */
+export function codexPluginManifest() {
+    const body = {
+        name: CODEX_PLUGIN_NAME,
+        version: CODEX_PLUGIN_VERSION,
+        description: 'Reel Edge read-only data skills: Reel Explorer (Xano database), Inbox Scout (player emails), and HubSpot CRM.',
+        author: { name: 'Reel Edge' },
+        skills: './skills/',
+        interface: {
+            displayName: 'Reel Edge',
+            shortDescription: 'Reel Edge read-only data skills for Codex.',
+            longDescription: 'Adds the Reel Edge domain skills — Reel Explorer (read-only Xano SQL), Inbox Scout (player emails), and HubSpot CRM — used alongside the reel-edge MCP connector.',
+            developerName: 'Reel Edge',
+            category: 'Productivity',
+            capabilities: [],
+            defaultPrompt: 'Query the Reel Edge database.',
+        },
+    };
+    return `${JSON.stringify(body, null, 2)}\n`;
+}
+/**
+ * The reel-edge plugin entry for the personal marketplace. `source.path` is the
+ * literal home-relative `./plugins/reel-edge` (Codex resolves it against the
+ * agents home); `INSTALLED_BY_DEFAULT` makes it show up installed in the panel.
+ */
+export function codexMarketplaceEntry() {
+    return {
+        name: CODEX_PLUGIN_NAME,
+        source: { source: 'local', path: `./plugins/${CODEX_PLUGIN_NAME}` },
+        policy: { installation: 'INSTALLED_BY_DEFAULT', authentication: 'ON_INSTALL' },
+        category: 'Productivity',
+    };
+}
+/** The fresh personal-marketplace root wrapping a single plugin entry. */
+function freshMarketplace(entry) {
+    return {
+        name: 'personal',
+        interface: { displayName: 'Personal' },
+        plugins: [entry],
+    };
+}
+/**
+ * Merge the reel-edge plugin entry into an existing `marketplace.json` body (or
+ * `undefined`/malformed → a fresh personal-marketplace root). Mirrors
+ * `mergeDroidConfig`/`mergeClaudeDesktopConfig`: PRESERVE the user's top-level
+ * keys (incl. their marketplace `name`/`interface`) and any OTHER plugins;
+ * REPLACE an existing reel-edge entry in `plugins[]` (matched by `name`) or
+ * APPEND it. Returns pretty-printed JSON with a trailing newline.
+ */
+export function mergeCodexMarketplace(existing, entry) {
+    let root = null;
+    if (existing && existing.trim() !== '') {
+        try {
+            const parsed = JSON.parse(existing);
+            if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                root = parsed;
+            }
+        }
+        catch {
+            root = null;
+        }
+    }
+    if (root === null) {
+        return `${JSON.stringify(freshMarketplace(entry), null, 2)}\n`;
+    }
+    const plugins = Array.isArray(root.plugins) ? [...root.plugins] : [];
+    const idx = plugins.findIndex((p) => p !== null &&
+        typeof p === 'object' &&
+        p.name === entry.name);
+    if (idx >= 0)
+        plugins[idx] = entry;
+    else
+        plugins.push(entry);
+    root.plugins = plugins;
+    // Don't clobber a user's marketplace name/interface; only default them when
+    // absent so the merged file is still a valid personal marketplace.
+    if (root.name === undefined)
+        root.name = 'personal';
+    if (root.interface === undefined)
+        root.interface = { displayName: 'Personal' };
+    return `${JSON.stringify(root, null, 2)}\n`;
+}
+/**
+ * Build the Codex plugin at `dir`:
+ *   dir/.codex-plugin/plugin.json
+ *   dir/skills/<slug>/SKILL.md (+ references/**)
+ * Copies the fetched `SkillFile[]` verbatim (frontmatter carried through) via
+ * {@link writeSkillTree}, so the same path-traversal guards apply. Returns the
+ * written absolute file paths (the manifest first, then the skill files).
+ */
+export function buildCodexPlugin(dir, skills) {
+    const metaDir = path.join(dir, '.codex-plugin');
+    fs.mkdirSync(metaDir, { recursive: true });
+    const pluginPath = path.join(metaDir, 'plugin.json');
+    fs.writeFileSync(pluginPath, codexPluginManifest(), 'utf8');
+    const written = [pluginPath];
+    const skillsRoot = path.join(dir, 'skills');
+    for (const s of skills) {
+        written.push(...writeSkillTree(skillsRoot, s.slug, s.files));
+    }
+    return written;
+}
+/** `--dry-run` lines describing the plugin build + the marketplace merge. */
+export function codexPluginDryRunLines(dir, marketplacePath, skills) {
+    const lines = [`would write ${path.join(dir, '.codex-plugin', 'plugin.json')}`];
+    const skillsRoot = path.join(dir, 'skills');
+    for (const s of skills) {
+        for (const file of s.files) {
+            lines.push(`would write ${path.join(skillsRoot, s.slug, file.path)}`);
+        }
+    }
+    lines.push(`would merge ${marketplacePath} with plugin entry "${CODEX_PLUGIN_NAME}" (INSTALLED_BY_DEFAULT)`);
+    return lines;
+}

package/dist/apps/codex.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { mcpEndpoint } from '../mcp.js';
 import { writeSkillTree } from '../skills.js';
+import { buildCodexPlugin, codexMarketplaceEntry, codexMarketplacePath, codexPluginDir, codexPluginDryRunLines, mergeCodexMarketplace, } from './codex-plugin.js';
 import { APP_LABELS, CONNECTOR_NAME, } from './types.js';
 /**
  * OpenAI Codex CLI adapter. Codex reads `~/.codex/config.toml` and registers
@@ -24,6 +25,12 @@ import { APP_LABELS, CONNECTOR_NAME, } from './types.js';
  *
  * MCP config verified against https://developers.openai.com/codex/mcp and
  * https://developers.openai.com/codex/config-reference (Jun 2026).
+ *
+ * On top of the loose CLI skills + the MCP connector, this adapter also builds a
+ * Codex app-UI **plugin** (see `./codex-plugin.ts`) — a self-contained plugin
+ * under `<home>/plugins/reel-edge/` registered in the personal marketplace
+ * (`<home>/.agents/plugins/marketplace.json`) so the skills show in the
+ * Codex/ChatGPT app plugins panel.
  */
 /** Absolute path to the Codex skills tree (`~/.codex/skills`). */
 function codexSkillsDir(env) {
@@ -106,15 +113,29 @@ export function makeCodexAdapter(env) {
         label: APP_LABELS.codex,
         skillsDir,
         writeSkills(skills) {
-            return skills.flatMap((s) => writeSkillTree(skillsDir(), s.slug, s.files));
+            // 1. Loose CLI skills under ~/.codex/skills/<slug>/ (existing behaviour).
+            const cliSkills = skills.flatMap((s) => writeSkillTree(skillsDir(), s.slug, s.files));
+            // 2. The Codex app-UI plugin under <home>/plugins/reel-edge/ so the skills
+            //    also surface in the Codex/ChatGPT app plugins panel.
+            const plugin = buildCodexPlugin(codexPluginDir(env), skills);
+            return [...cliSkills, ...plugin];
         },
         async configureMcp(serverUrl, token) {
+            // 1. MCP connector: ~/.codex/config.toml [mcp_servers.reel-edge] (existing).
             const block = codexConfigBlock(CONNECTOR_NAME, mcpEndpoint(serverUrl), token);
             const cfgPath = codexConfigPath(env);
             const existing = fs.existsSync(cfgPath) ? fs.readFileSync(cfgPath, 'utf8') : '';
             const merged = mergeCodexToml(existing, CONNECTOR_NAME, block);
             fs.mkdirSync(path.dirname(cfgPath), { recursive: true });
             fs.writeFileSync(cfgPath, merged, 'utf8');
+            // 2. Register the app-UI plugin in the personal marketplace so it installs
+            //    in the Codex app plugins panel.
+            const mpPath = codexMarketplacePath(env);
+            const existingMp = fs.existsSync(mpPath) ? fs.readFileSync(mpPath, 'utf8') : undefined;
+            const mergedMp = mergeCodexMarketplace(existingMp, codexMarketplaceEntry());
+            fs.mkdirSync(path.dirname(mpPath), { recursive: true });
+            fs.writeFileSync(mpPath, mergedMp, 'utf8');
+            env.log?.(`Registered Codex plugin (${CONNECTOR_NAME}) — installs in the Codex app plugins panel`);
         },
         dryRunPlan(serverUrl, token, skills) {
             const lines = [];
@@ -127,6 +148,8 @@ export function makeCodexAdapter(env) {
             for (const l of codexConfigBlock(CONNECTOR_NAME, mcpEndpoint(serverUrl), token).trimEnd().split('\n')) {
                 lines.push(`    ${l}`);
             }
+            // The Codex app-UI plugin build + the personal-marketplace registration.
+            lines.push(...codexPluginDryRunLines(codexPluginDir(env), codexMarketplacePath(env), skills));
             return lines;
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reeledge/agent-tools",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "private": false,
   "description": "Reel Edge agent-tools installer CLI — installs/updates the Reel Edge MCP connector + skills for Claude Code / Codex / Droid.",
   "type": "module",